zod-codecs 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Brandon Burrus
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,34 @@
+# zod-codecs
+
+A library of useful pre-built codecs for Zod validation.
+
+## Installation
+
+```bash
+npm install zod zod-codecs
+```
+
+## Usage
+
+Import codecs from the package and use them with Zod's `codec()` method:
+
+```typescript
+import { z } from 'zod';
+import { stringToInt } from 'zod-codecs';
+
+// Parse a string as an integer
+const result = stringToInt.parse('42');
+console.log(result); // 42 (number)
+
+// Encode back to string
+const encoded = stringToInt.encode(42);
+console.log(encoded); // '42' (string)
+```
+
+## Available Codecs
+
+- `stringToInt` - Converts string to integer number
+- `stringToNumber` - Converts string to number
+- `stringToBigint` - Converts string to bigint
+- `isoDateTimeToDate` - Converts ISO date-time string to Date object
+- `unixSecondsToDate` - Converts Unix timestamp (seconds) to Date object

package/dist/index.cjs

@@ -0,0 +1,45 @@
+'use strict';
+
+var zod = require('zod');
+
+const stringToIntCoder = {
+    decode: (value) => parseInt(value, 10),
+    encode: (value) => value.toString(),
+};
+const stringToInt = zod.z.codec(zod.z.string().regex(/^-?\d+$/), zod.z.number().int(), stringToIntCoder);
+
+const stringToNumberCoder = {
+    decode: (value) => parseFloat(value),
+    encode: (value) => value.toString(),
+};
+const stringToNumber = zod.z.codec(zod.z.string().regex(/^-?(\d+\.?\d*|\.\d+)$/), zod.z.number(), stringToNumberCoder);
+
+const stringToBigIntCoder = {
+    decode: (value) => BigInt(value),
+    encode: (value) => value.toString(),
+};
+const stringToBigInt = zod.z.codec(zod.z.string().regex(/^-?\d+$/), zod.z.bigint(), stringToBigIntCoder);
+
+const isoDateTimeToDateCoder = {
+    decode: (value) => new Date(value),
+    encode: (value) => value.toISOString(),
+};
+const isoDateTimeToDate = zod.z.codec(zod.z.string().datetime({ offset: true }), zod.z.date(), isoDateTimeToDateCoder);
+
+const unixSecondsToDateCoder = {
+    decode: (value) => new Date(value * 1000),
+    encode: (value) => Math.floor(value.getTime() / 1000),
+};
+const unixSecondsToDate = zod.z.codec(zod.z.number(), zod.z.date(), unixSecondsToDateCoder);
+
+exports.isoDateTimeToDate = isoDateTimeToDate;
+exports.isoDateTimeToDateCoder = isoDateTimeToDateCoder;
+exports.stringToBigInt = stringToBigInt;
+exports.stringToBigIntCoder = stringToBigIntCoder;
+exports.stringToInt = stringToInt;
+exports.stringToIntCoder = stringToIntCoder;
+exports.stringToNumber = stringToNumber;
+exports.stringToNumberCoder = stringToNumberCoder;
+exports.unixSecondsToDate = unixSecondsToDate;
+exports.unixSecondsToDateCoder = unixSecondsToDateCoder;
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","sources":["../src/string-to-int.ts","../src/string-to-number.ts","../src/string-to-bigint.ts","../src/iso-date-time-to-date.ts","../src/unix-seconds-to-date.ts"],"sourcesContent":[null,null,null,null,null],"names":["z"],"mappings":";;;;AAEO,MAAM,gBAAgB,GAAG;IAC9B,MAAM,EAAE,CAAC,KAAa,KAAa,QAAQ,CAAC,KAAK,EAAE,EAAE,CAAC;IACtD,MAAM,EAAE,CAAC,KAAa,KAAa,KAAK,CAAC,QAAQ,EAAE;;AAG9C,MAAM,WAAW,GAAGA,KAAC,CAAC,KAAK,CAChCA,KAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,SAAS,CAAC,EAC3BA,KAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,EAChB,gBAAgB;;ACRX,MAAM,mBAAmB,GAAG;IACjC,MAAM,EAAE,CAAC,KAAa,KAAa,UAAU,CAAC,KAAK,CAAC;IACpD,MAAM,EAAE,CAAC,KAAa,KAAa,KAAK,CAAC,QAAQ,EAAE;;AAG9C,MAAM,cAAc,GAAGA,KAAC,CAAC,KAAK,CACnCA,KAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,uBAAuB,CAAC,EACzCA,KAAC,CAAC,MAAM,EAAE,EACV,mBAAmB;;ACRd,MAAM,mBAAmB,GAAG;IACjC,MAAM,EAAE,CAAC,KAAa,KAAa,MAAM,CAAC,KAAK,CAAC;IAChD,MAAM,EAAE,CAAC,KAAa,KAAa,KAAK,CAAC,QAAQ,EAAE;;AAG9C,MAAM,cAAc,GAAGA,KAAC,CAAC,KAAK,CACnCA,KAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,SAAS,CAAC,EAC3BA,KAAC,CAAC,MAAM,EAAE,EACV,mBAAmB;;ACRd,MAAM,sBAAsB,GAAG;IACpC,MAAM,EAAE,CAAC,KAAa,KAAW,IAAI,IAAI,CAAC,KAAK,CAAC;IAChD,MAAM,EAAE,CAAC,KAAW,KAAa,KAAK,CAAC,WAAW,EAAE;;AAG/C,MAAM,iBAAiB,GAAGA,KAAC,CAAC,KAAK,CACtCA,KAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EACrCA,KAAC,CAAC,IAAI,EAAE,EACR,sBAAsB;;ACRjB,MAAM,sBAAsB,GAAG;AACpC,IAAA,MAAM,EAAE,CAAC,KAAa,KAAW,IAAI,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;AACvD,IAAA,MAAM,EAAE,CAAC,KAAW,KAAa,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC;;MAGxD,iBAAiB,GAAGA,KAAC,CAAC,KAAK,CACtCA,KAAC,CAAC,MAAM,EAAE,EACVA,KAAC,CAAC,IAAI,EAAE,EACR,sBAAsB;;;;;;;;;;;;;"}

package/dist/index.d.ts

@@ -0,0 +1,33 @@
+import { z } from 'zod';
+
+declare const stringToIntCoder: {
+    decode: (value: string) => number;
+    encode: (value: number) => string;
+};
+declare const stringToInt: z.ZodCodec<z.ZodString, z.ZodNumber>;
+
+declare const stringToNumberCoder: {
+    decode: (value: string) => number;
+    encode: (value: number) => string;
+};
+declare const stringToNumber: z.ZodCodec<z.ZodString, z.ZodNumber>;
+
+declare const stringToBigIntCoder: {
+    decode: (value: string) => bigint;
+    encode: (value: bigint) => string;
+};
+declare const stringToBigInt: z.ZodCodec<z.ZodString, z.ZodBigInt>;
+
+declare const isoDateTimeToDateCoder: {
+    decode: (value: string) => Date;
+    encode: (value: Date) => string;
+};
+declare const isoDateTimeToDate: z.ZodCodec<z.ZodString, z.ZodDate>;
+
+declare const unixSecondsToDateCoder: {
+    decode: (value: number) => Date;
+    encode: (value: Date) => number;
+};
+declare const unixSecondsToDate: z.ZodCodec<z.ZodNumber, z.ZodDate>;
+
+export { isoDateTimeToDate, isoDateTimeToDateCoder, stringToBigInt, stringToBigIntCoder, stringToInt, stringToIntCoder, stringToNumber, stringToNumberCoder, unixSecondsToDate, unixSecondsToDateCoder };

package/dist/index.js

@@ -0,0 +1,34 @@
+import { z } from 'zod';
+
+const stringToIntCoder = {
+    decode: (value) => parseInt(value, 10),
+    encode: (value) => value.toString(),
+};
+const stringToInt = z.codec(z.string().regex(/^-?\d+$/), z.number().int(), stringToIntCoder);
+
+const stringToNumberCoder = {
+    decode: (value) => parseFloat(value),
+    encode: (value) => value.toString(),
+};
+const stringToNumber = z.codec(z.string().regex(/^-?(\d+\.?\d*|\.\d+)$/), z.number(), stringToNumberCoder);
+
+const stringToBigIntCoder = {
+    decode: (value) => BigInt(value),
+    encode: (value) => value.toString(),
+};
+const stringToBigInt = z.codec(z.string().regex(/^-?\d+$/), z.bigint(), stringToBigIntCoder);
+
+const isoDateTimeToDateCoder = {
+    decode: (value) => new Date(value),
+    encode: (value) => value.toISOString(),
+};
+const isoDateTimeToDate = z.codec(z.string().datetime({ offset: true }), z.date(), isoDateTimeToDateCoder);
+
+const unixSecondsToDateCoder = {
+    decode: (value) => new Date(value * 1000),
+    encode: (value) => Math.floor(value.getTime() / 1000),
+};
+const unixSecondsToDate = z.codec(z.number(), z.date(), unixSecondsToDateCoder);
+
+export { isoDateTimeToDate, isoDateTimeToDateCoder, stringToBigInt, stringToBigIntCoder, stringToInt, stringToIntCoder, stringToNumber, stringToNumberCoder, unixSecondsToDate, unixSecondsToDateCoder };
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":["../src/string-to-int.ts","../src/string-to-number.ts","../src/string-to-bigint.ts","../src/iso-date-time-to-date.ts","../src/unix-seconds-to-date.ts"],"sourcesContent":[null,null,null,null,null],"names":[],"mappings":";;AAEO,MAAM,gBAAgB,GAAG;IAC9B,MAAM,EAAE,CAAC,KAAa,KAAa,QAAQ,CAAC,KAAK,EAAE,EAAE,CAAC;IACtD,MAAM,EAAE,CAAC,KAAa,KAAa,KAAK,CAAC,QAAQ,EAAE;;AAG9C,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAChC,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,SAAS,CAAC,EAC3B,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,EAChB,gBAAgB;;ACRX,MAAM,mBAAmB,GAAG;IACjC,MAAM,EAAE,CAAC,KAAa,KAAa,UAAU,CAAC,KAAK,CAAC;IACpD,MAAM,EAAE,CAAC,KAAa,KAAa,KAAK,CAAC,QAAQ,EAAE;;AAG9C,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CACnC,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,uBAAuB,CAAC,EACzC,CAAC,CAAC,MAAM,EAAE,EACV,mBAAmB;;ACRd,MAAM,mBAAmB,GAAG;IACjC,MAAM,EAAE,CAAC,KAAa,KAAa,MAAM,CAAC,KAAK,CAAC;IAChD,MAAM,EAAE,CAAC,KAAa,KAAa,KAAK,CAAC,QAAQ,EAAE;;AAG9C,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CACnC,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,SAAS,CAAC,EAC3B,CAAC,CAAC,MAAM,EAAE,EACV,mBAAmB;;ACRd,MAAM,sBAAsB,GAAG;IACpC,MAAM,EAAE,CAAC,KAAa,KAAW,IAAI,IAAI,CAAC,KAAK,CAAC;IAChD,MAAM,EAAE,CAAC,KAAW,KAAa,KAAK,CAAC,WAAW,EAAE;;AAG/C,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CACtC,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EACrC,CAAC,CAAC,IAAI,EAAE,EACR,sBAAsB;;ACRjB,MAAM,sBAAsB,GAAG;AACpC,IAAA,MAAM,EAAE,CAAC,KAAa,KAAW,IAAI,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;AACvD,IAAA,MAAM,EAAE,CAAC,KAAW,KAAa,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC;;MAGxD,iBAAiB,GAAG,CAAC,CAAC,KAAK,CACtC,CAAC,CAAC,MAAM,EAAE,EACV,CAAC,CAAC,IAAI,EAAE,EACR,sBAAsB;;;;"}

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "zod-codecs",
+  "version": "0.1.0",
+  "description": "Library of useful pre-build Codecs for Zod.",
+  "author": "Brandon Burrus",
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist",
+    "LICENSE",
+    "README.md"
+  ],
+  "homepage": "https://github.com/brandonburrus/zod-codecs#readme",
+  "keywords": [
+    "zod",
+    "codecs",
+    "validation"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/brandonburrus/zod-codecs.git"
+  },
+  "bugs": {
+    "url": "https://github.com/brandonburrus/zod-codecs/issues"
+  },
+  "scripts": {
+    "build": "rollup -c",
+    "test": "vitest",
+    "test:run": "vitest run",
+    "typecheck": "tsc --noEmit"
+  },
+  "peerDependencies": {
+    "zod": ">=4.1.0"
+  },
+  "devDependencies": {
+    "@rollup/plugin-node-resolve": "^16.0.3",
+    "@rollup/plugin-typescript": "^12.3.0",
+    "rollup": "^4.56.0",
+    "rollup-plugin-dts": "^6.3.0",
+    "tslib": "^2.8.1",
+    "typescript": "^5.9.3",
+    "vitest": "^4.0.18",
+    "zod": "^4.3.6"
+  }
+}