Add methods

Author: colinhacks

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

@@ -55,6 +55,28 @@ export interface ZodType<
     params?: core.ParseContext<core.$ZodIssue>
   ) => Promise<parse.ZodSafeParseResult<core.output<this>>>;
 
+  // encoding/decoding
+  encode(data: core.output<this>, params?: core.ParseContext<core.$ZodIssue>): core.input<this>;
+  decode(data: core.input<this>, params?: core.ParseContext<core.$ZodIssue>): core.output<this>;
+  encodeAsync(data: core.output<this>, params?: core.ParseContext<core.$ZodIssue>): Promise<core.input<this>>;
+  decodeAsync(data: core.input<this>, params?: core.ParseContext<core.$ZodIssue>): Promise<core.output<this>>;
+  safeEncode(
+    data: core.output<this>,
+    params?: core.ParseContext<core.$ZodIssue>
+  ): parse.ZodSafeParseResult<core.input<this>>;
+  safeDecode(
+    data: core.input<this>,
+    params?: core.ParseContext<core.$ZodIssue>
+  ): parse.ZodSafeParseResult<core.output<this>>;
+  safeEncodeAsync(
+    data: core.output<this>,
+    params?: core.ParseContext<core.$ZodIssue>
+  ): Promise<parse.ZodSafeParseResult<core.input<this>>>;
+  safeDecodeAsync(
+    data: core.input<this>,
+    params?: core.ParseContext<core.$ZodIssue>
+  ): Promise<parse.ZodSafeParseResult<core.output<this>>>;
+
   // refinements
   refine(check: (arg: core.output<this>) => unknown | Promise<unknown>, params?: string | core.$ZodCustomParams): this;
   superRefine(
@@ -150,6 +172,16 @@ export const ZodType: core.$constructor<ZodType> = /*@__PURE__*/ core.$construct
   inst.safeParseAsync = async (data, params) => parse.safeParseAsync(inst, data, params);
   inst.spa = inst.safeParseAsync;
 
+  // encoding/decoding
+  inst.encode = (data, params) => parse.encode(inst, data, params);
+  inst.decode = (data, params) => parse.decode(inst, data, params);
+  inst.encodeAsync = async (data, params) => parse.encodeAsync(inst, data, params);
+  inst.decodeAsync = async (data, params) => parse.decodeAsync(inst, data, params);
+  inst.safeEncode = (data, params) => parse.safeEncode(inst, data, params);
+  inst.safeDecode = (data, params) => parse.safeDecode(inst, data, params);
+  inst.safeEncodeAsync = async (data, params) => parse.safeEncodeAsync(inst, data, params);
+  inst.safeDecodeAsync = async (data, params) => parse.safeDecodeAsync(inst, data, params);
+
   // refinements
   inst.refine = (check, params) => inst.check(refine(check, params));
   inst.superRefine = (refinement) => inst.check(superRefine(refinement));

play.ts

@@ -2,17 +2,46 @@ import * as z from "zod";
 
 z;
 
-export const Field1Schema = z.strictObject({
-  "field1.1": z.string(),
-  "field1.2": z.number(),
-});
-
-export const Field2Schema = z.strictObject({
-  "field2.1": z.boolean(),
-  "field2.2": z.date(),
-});
-
-export const SomeSchema = z.strictObject({
-  field1: Field1Schema as typeof Field1Schema,
-  field2: Field2Schema as typeof Field2Schema,
-});
+const stringToDate = z.codec(
+  z.iso.datetime(), // input schema: ISO date string
+  z.date(), // output schema: Date object
+  {
+    decode: (isoString) => new Date(isoString), // ISO string → Date
+    encode: (date) => date.toISOString(), // Date → ISO string
+  }
+);
+
+stringToDate.decode("2024-01-15T10:30:00.000Z");
+// => Date
+
+stringToDate.encode(new Date())
+// => string
+
+
+      stringToDate.decode(1234);
+      //                 ^ Argument of type 'number' is not assignable 
+      //                   to parameter of type 'string'.ts(2345)
+
+      stringToDate.encode(1234);
+      //                 ^ Argument of type 'number' is not assignable 
+      //                   to parameter of type 'Date'.ts(2345)
+
+
+
+including:
+
+✅ stringToNumber
+✅ stringToInt
+✅ stringToBigInt
+✅ numberToBigInt
+✅ isoDatetimeToDate
+✅ epochSecondsToDate
+✅ epochMillisToDate
+✅ jsonCodec
+✅ utf8ToBytes
+✅ bytesToUtf8
+✅ base64ToBytes
+✅ base64urlToBytes
+✅ hexToBytes
+✅ stringToURL
+✅ uriComponent