Fix optional + pipe handling. Closes #5002. v4.0.13

Author: colinhacks

packages/zod/jsr.json

@@ -1,6 +1,6 @@
 {
   "name": "@zod/zod",
-  "version": "4.0.12",
+  "version": "4.0.13",
   "exports": {
     "./package.json": "./package.json",
     ".": "./src/index.ts",

packages/zod/package.json

@@ -1,6 +1,6 @@
 {
   "name": "zod",
-  "version": "4.0.12",
+  "version": "4.0.13",
   "type": "module",
   "license": "MIT",
   "author": "Colin McDonnell <[email protected]>",

packages/zod/src/v4/classic/tests/optional.test.ts

@@ -121,3 +121,16 @@ test("pipe optionality inside objects", () => {
     e: string;
   }>();
 });
+
+test("optional prop with pipe", () => {
+  const schema = z.object({
+    id: z
+      .union([z.number(), z.string().nullish()])
+      .transform((val) => (val === null || val === undefined ? val : Number(val)))
+      .pipe(z.number())
+      .optional(),
+  });
+
+  schema.parse({});
+  schema.parse({}, { jitless: true });
+});

packages/zod/src/v4/core/schemas.ts

@@ -3007,6 +3007,13 @@ export interface $ZodOptional<T extends SomeType = $ZodType> extends $ZodType {
   _zod: $ZodOptionalInternals<T>;
 }
 
+function handleOptionalResult(result: ParsePayload, input: unknown) {
+  if (result.issues.length && input === undefined) {
+    return { issues: [], value: undefined };
+  }
+  return result;
+}
+
 export const $ZodOptional: core.$constructor<$ZodOptional> = /*@__PURE__*/ core.$constructor(
   "$ZodOptional",
   (inst, def) => {
@@ -3024,7 +3031,9 @@ export const $ZodOptional: core.$constructor<$ZodOptional> = /*@__PURE__*/ core.
 
     inst._zod.parse = (payload, ctx) => {
       if (def.innerType._zod.optin === "optional") {
-        return def.innerType._zod.run(payload, ctx);
+        const result = def.innerType._zod.run(payload, ctx);
+        if (result instanceof Promise) return result.then((r) => handleOptionalResult(r, payload.value));
+        return handleOptionalResult(result, payload.value);
       }
       if (payload.value === undefined) {
         return payload;

packages/zod/src/v4/core/versions.ts

@@ -1,5 +1,5 @@
 export const version = {
   major: 4,
   minor: 0,
-  patch: 12 as number,
+  patch: 13 as number,
 } as const;

play.ts

@@ -1,3 +1,13 @@
 import * as z from "zod";
 
 z;
+
+const schema = z.object({
+  id: z
+    .union([z.number(), z.string().nullish()])
+    .transform((val) => (val === null || val === undefined ? val : Number(val)))
+    .pipe(z.number())
+    .optional(),
+});
+
+console.log(schema.safeParse({}, { jitless: true }));