@infra-blocks/zod-utils 0.22.0 → 0.23.0

package/README.md

@@ -71,6 +71,20 @@ The `zu.codec.jsonParse(schema)` utility is a factory returning a codec where th
 `zu.string.json()` and the second one is the one provided as input. This is almost verbatim
 what is describe in [Zod's documentation](https://zod.dev/codecs#jsonschema).
 
+#### ms
+
+The `zu.codec.ms(options)` utility is a factory returning a codec where the schemas are
+`z.string()` and `z.number()`. The transformations in both directions are handled by the
+[ms](https://www.npmjs.com/package/ms) package. When encoding, the codec passes the options
+provided to `ms(number, options)`.
+
+```typescript
+import { zu } from "@infra-blocks/zod-utils";
+
+const item: number = zu.codec.ms().parse("1d"); // item is 86400000.
+zu.codec.ms({ long: true }).encode(item); // result is "1 day".
+```
+
 #### stringSplit
 
 The `zu.codec.stringSplit(separator)` utility is a factory returning a codec where the first schema is

package/lib/cjs/codec/index.d.ts

@@ -1,6 +1,9 @@
 declare const codec: {
     csv: () => import("zod").ZodCodec<import("zod").ZodString, import("zod").ZodArray<import("zod").ZodString>>;
     jsonParse: <S extends import("zod").ZodType>(schema: S) => import("zod").ZodCodec<import("zod/v4/core").$ZodBranded<import("zod").ZodString, "JsonString">, S>;
+    ms: (options?: {
+        long: boolean;
+    }) => import("zod").ZodCodec<import("zod").ZodString, import("zod").ZodNumber>;
     stringtoInteger: () => import("zod").ZodCodec<import("zod/v4/core").$ZodBranded<import("zod").ZodString, "IntegerString">, import("zod/v4/core").$ZodBranded<import("zod").ZodInt, "Integer">>;
     stringToJson: () => import("zod").ZodCodec<import("zod/v4/core").$ZodBranded<import("zod").ZodString, "JsonString">, import("zod").ZodType<import("../json/json.js").Json, unknown, import("zod/v4/core").$ZodTypeInternals<import("../json/json.js").Json, unknown>>>;
     stringToUrl: () => import("zod").ZodCodec<import("zod/v4/core").$ZodBranded<import("zod").ZodURL, "UrlString">, import("zod").ZodCustom<import("url").URL, import("url").URL>>;

package/lib/cjs/codec/index.js

@@ -3,12 +3,14 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.codec = void 0;
 const csv_js_1 = require("./csv.js");
 const json_parse_js_1 = require("./json-parse.js");
+const ms_js_1 = require("./ms.js");
 const string_to_integer_js_1 = require("./string-to-integer.js");
 const string_to_json_js_1 = require("./string-to-json.js");
 const string_to_url_js_1 = require("./string-to-url.js");
 const codec = {
     csv: csv_js_1.csv,
     jsonParse: json_parse_js_1.jsonParse,
+    ms: ms_js_1.ms,
     stringtoInteger: string_to_integer_js_1.stringToInteger,
     stringToJson: string_to_json_js_1.stringToJson,
     stringToUrl: string_to_url_js_1.stringToUrl,

package/lib/cjs/codec/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/codec/index.ts"],"names":[],"mappings":";;;AAAA,qCAA+B;AAC/B,mDAA4C;AAC5C,iEAAyD;AACzD,2DAAmD;AACnD,yDAAiD;AAEjD,MAAM,KAAK,GAAG;IACZ,GAAG,EAAH,YAAG;IACH,SAAS,EAAT,yBAAS;IACT,eAAe,EAAE,sCAAe;IAChC,YAAY,EAAZ,gCAAY;IACZ,WAAW,EAAX,8BAAW;CACZ,CAAC;AAEO,sBAAK"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/codec/index.ts"],"names":[],"mappings":";;;AAAA,qCAA+B;AAC/B,mDAA4C;AAC5C,mCAA6B;AAC7B,iEAAyD;AACzD,2DAAmD;AACnD,yDAAiD;AAEjD,MAAM,KAAK,GAAG;IACZ,GAAG,EAAH,YAAG;IACH,SAAS,EAAT,yBAAS;IACT,EAAE,EAAF,UAAE;IACF,eAAe,EAAE,sCAAe;IAChC,YAAY,EAAZ,gCAAY;IACZ,WAAW,EAAX,8BAAW;CACZ,CAAC;AAEO,sBAAK"}

package/lib/cjs/codec/ms.d.ts

@@ -0,0 +1,15 @@
+import { z } from "zod";
+/**
+ * A codec factory that returns codec parsing strings formatted
+ * as expected by the [ms](https://www.npmjs.com/package/ms) and turning them
+ * into their equivalent number in milliseconds.
+ *
+ * @param options - Those options are passed to `ms` when turning the milliseconds
+ * number into a formatted string.
+ *
+ * @returns A codec where the schemas are {@link z.string} and {@link z.number},
+ * and where the transforms between each are handled by the `ms` package.
+ */
+export declare const ms: (options?: {
+    long: boolean;
+}) => z.ZodCodec<z.ZodString, z.ZodNumber>;

package/lib/cjs/codec/ms.js

@@ -0,0 +1,25 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ms = void 0;
+const ms_1 = __importDefault(require("ms"));
+const zod_1 = require("zod");
+/**
+ * A codec factory that returns codec parsing strings formatted
+ * as expected by the [ms](https://www.npmjs.com/package/ms) and turning them
+ * into their equivalent number in milliseconds.
+ *
+ * @param options - Those options are passed to `ms` when turning the milliseconds
+ * number into a formatted string.
+ *
+ * @returns A codec where the schemas are {@link z.string} and {@link z.number},
+ * and where the transforms between each are handled by the `ms` package.
+ */
+const ms = (options) => zod_1.z.codec(zod_1.z.string(), zod_1.z.number(), {
+    decode: (str) => (0, ms_1.default)(str) ?? zod_1.z.NEVER,
+    encode: (millis) => (0, ms_1.default)(millis, options),
+});
+exports.ms = ms;
+//# sourceMappingURL=ms.js.map

package/lib/cjs/codec/ms.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ms.js","sourceRoot":"","sources":["../../../src/codec/ms.ts"],"names":[],"mappings":";;;;;;AAAA,4CAAsB;AACtB,6BAAwB;AAExB;;;;;;;;;;GAUG;AACI,MAAM,EAAE,GAAG,CAAC,OAA2B,EAAE,EAAE,CAChD,OAAC,CAAC,KAAK,CAAC,OAAC,CAAC,MAAM,EAAE,EAAE,OAAC,CAAC,MAAM,EAAE,EAAE;IAC9B,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,IAAA,YAAI,EAAC,GAAuB,CAAC,IAAI,OAAC,CAAC,KAAK;IACzD,MAAM,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,IAAA,YAAI,EAAC,MAAM,EAAE,OAAO,CAAC;CAC1C,CAAC,CAAC;AAJQ,QAAA,EAAE,MAIV"}

package/lib/cjs/index.d.ts

@@ -1,5 +1,6 @@
 import type { TypeGuard } from "@infra-blocks/types";
 import type { z } from "zod";
+import { isValid } from "./is-valid.js";
 /**
  * Returns a type guard function using the provided schema as the source of truth.
  *
@@ -16,19 +17,6 @@ import type { z } from "zod";
  * former case, that information is also carried with the type.
  */
 declare function typeGuard<S extends z.ZodType>(schema: S): TypeGuard<z.infer<S>>;
-/**
- * Validates that the value satisfies the provided schema.
- *
- * Upon success, the value's type is narrowed to the schema's output type.
- *
- * It uses `safeParse` internally.
- *
- * @param schema - The schema to validate against.
- * @param value - The value to validate.
- *
- * @returns Whether the value satisfies the schema.
- */
-declare function isValid<S extends z.ZodType>(schema: S, value: unknown): value is z.infer<S>;
 declare const zu: {
     aws: {
         accountId: typeof import("./aws/account-id.js").accountId;
@@ -39,6 +27,9 @@ declare const zu: {
     codec: {
         csv: () => z.ZodCodec<z.ZodString, z.ZodArray<z.ZodString>>;
         jsonParse: <S extends z.ZodType>(schema: S) => z.ZodCodec<z.core.$ZodBranded<z.ZodString, "JsonString">, S>;
+        ms: (options?: {
+            long: boolean;
+        }) => z.ZodCodec<z.ZodString, z.ZodNumber>;
         stringtoInteger: () => z.ZodCodec<z.core.$ZodBranded<z.ZodString, "IntegerString">, z.core.$ZodBranded<z.ZodInt, "Integer">>;
         stringToJson: () => z.ZodCodec<z.core.$ZodBranded<z.ZodString, "JsonString">, z.ZodType<import("./json/json.js").Json, unknown, z.core.$ZodTypeInternals<import("./json/json.js").Json, unknown>>>;
         stringToUrl: () => z.ZodCodec<z.core.$ZodBranded<z.ZodURL, "UrlString">, z.ZodCustom<import("url").URL, import("url").URL>>;

package/lib/cjs/index.js

@@ -4,6 +4,7 @@ exports.zu = void 0;
 const index_js_1 = require("./aws/index.js");
 const index_js_2 = require("./codec/index.js");
 const index_js_3 = require("./geojson/index.js");
+const is_valid_js_1 = require("./is-valid.js");
 const index_js_4 = require("./iso/index.js");
 const index_js_5 = require("./json/index.js");
 const index_js_6 = require("./number/index.js");
@@ -25,24 +26,9 @@ const index_js_7 = require("./string/index.js");
  */
 function typeGuard(schema) {
     return (value) => {
-        return isValid(schema, value);
+        return (0, is_valid_js_1.isValid)(schema, value);
     };
 }
-/**
- * Validates that the value satisfies the provided schema.
- *
- * Upon success, the value's type is narrowed to the schema's output type.
- *
- * It uses `safeParse` internally.
- *
- * @param schema - The schema to validate against.
- * @param value - The value to validate.
- *
- * @returns Whether the value satisfies the schema.
- */
-function isValid(schema, value) {
-    return schema.safeParse(value).success;
-}
 const zu = {
     aws: index_js_1.aws,
     codec: index_js_2.codec,
@@ -51,7 +37,7 @@ const zu = {
     json: index_js_5.json,
     number: index_js_6.number,
     string: index_js_7.string,
-    isValid,
+    isValid: is_valid_js_1.isValid,
     typeGuard,
 };
 exports.zu = zu;

package/lib/cjs/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;AAEA,6CAAqC;AACrC,+CAAyC;AACzC,iDAA6C;AAC7C,6CAAqC;AACrC,8CAAuC;AACvC,gDAA2C;AAC3C,gDAA2C;AAE3C;;;;;;;;;;;;;;GAcG;AACH,SAAS,SAAS,CAAsB,MAAS;IAC/C,OAAO,CAAC,KAAc,EAAuB,EAAE;QAC7C,OAAO,OAAO,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAChC,CAAC,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;GAWG;AACH,SAAS,OAAO,CACd,MAAS,EACT,KAAc;IAEd,OAAO,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC;AACzC,CAAC;AAED,MAAM,EAAE,GAAG;IACT,GAAG,EAAH,cAAG;IACH,KAAK,EAAL,gBAAK;IACL,OAAO,EAAP,kBAAO;IACP,GAAG,EAAH,cAAG;IACH,IAAI,EAAJ,eAAI;IACJ,MAAM,EAAN,iBAAM;IACN,MAAM,EAAN,iBAAM;IACN,OAAO;IACP,SAAS;CACV,CAAC;AAEO,gBAAE"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;AAEA,6CAAqC;AACrC,+CAAyC;AACzC,iDAA6C;AAC7C,+CAAwC;AACxC,6CAAqC;AACrC,8CAAuC;AACvC,gDAA2C;AAC3C,gDAA2C;AAE3C;;;;;;;;;;;;;;GAcG;AACH,SAAS,SAAS,CAAsB,MAAS;IAC/C,OAAO,CAAC,KAAc,EAAuB,EAAE;QAC7C,OAAO,IAAA,qBAAO,EAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAChC,CAAC,CAAC;AACJ,CAAC;AAED,MAAM,EAAE,GAAG;IACT,GAAG,EAAH,cAAG;IACH,KAAK,EAAL,gBAAK;IACL,OAAO,EAAP,kBAAO;IACP,GAAG,EAAH,cAAG;IACH,IAAI,EAAJ,eAAI;IACJ,MAAM,EAAN,iBAAM;IACN,MAAM,EAAN,iBAAM;IACN,OAAO,EAAP,qBAAO;IACP,SAAS;CACV,CAAC;AAEO,gBAAE"}

package/lib/cjs/is-valid.d.ts

@@ -0,0 +1,14 @@
+import type { z } from "zod";
+/**
+ * Validates that the value satisfies the provided schema.
+ *
+ * Upon success, the value's type is narrowed to the schema's output type.
+ *
+ * It uses `safeParse` internally.
+ *
+ * @param schema - The schema to validate against.
+ * @param value - The value to validate.
+ *
+ * @returns Whether the value satisfies the schema.
+ */
+export declare function isValid<S extends z.ZodType>(schema: S, value: unknown): value is z.infer<S>;

package/lib/cjs/is-valid.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isValid = isValid;
+/**
+ * Validates that the value satisfies the provided schema.
+ *
+ * Upon success, the value's type is narrowed to the schema's output type.
+ *
+ * It uses `safeParse` internally.
+ *
+ * @param schema - The schema to validate against.
+ * @param value - The value to validate.
+ *
+ * @returns Whether the value satisfies the schema.
+ */
+function isValid(schema, value) {
+    return schema.safeParse(value).success;
+}
+//# sourceMappingURL=is-valid.js.map

package/lib/cjs/is-valid.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-valid.js","sourceRoot":"","sources":["../../src/is-valid.ts"],"names":[],"mappings":";;AAcA,0BAKC;AAjBD;;;;;;;;;;;GAWG;AACH,SAAgB,OAAO,CACrB,MAAS,EACT,KAAc;IAEd,OAAO,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC;AACzC,CAAC"}

package/lib/cjs/iso/currency-code.js

@@ -1,7 +1,40 @@
 "use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.currencyCode = void 0;
-const currencyCodes = require("currency-codes");
+const currencyCodes = __importStar(require("currency-codes"));
 const zod_1 = require("zod");
 const ISO_CODES = currencyCodes.codes();
 const currencyCodeSchema = zod_1.z.enum(ISO_CODES).brand("IsoCurrencyCode");

package/lib/cjs/iso/currency-code.js.map

@@ -1 +1 @@
-{"version":3,"file":"currency-code.js","sourceRoot":"","sources":["../../../src/iso/currency-code.ts"],"names":[],"mappings":";;;AAAA,gDAAgD;AAChD,6BAAwB;AAExB,MAAM,SAAS,GAAG,aAAa,CAAC,KAAK,EAAE,CAAC;AAExC,MAAM,kBAAkB,GAAG,OAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC;AAItE;;;;;;;;;;;GAWG;AACI,MAAM,YAAY,GAAG,GAAG,EAAE,CAAC,kBAAkB,CAAC;AAAxC,QAAA,YAAY,gBAA4B"}
+{"version":3,"file":"currency-code.js","sourceRoot":"","sources":["../../../src/iso/currency-code.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,8DAAgD;AAChD,6BAAwB;AAExB,MAAM,SAAS,GAAG,aAAa,CAAC,KAAK,EAAE,CAAC;AAExC,MAAM,kBAAkB,GAAG,OAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC;AAItE;;;;;;;;;;;GAWG;AACI,MAAM,YAAY,GAAG,GAAG,EAAE,CAAC,kBAAkB,CAAC;AAAxC,QAAA,YAAY,gBAA4B"}

package/lib/cjs/number/integer.d.ts

@@ -1,5 +1,5 @@
 import { z } from "zod";
-export type Integer = z.infer<typeof integerSchema>;
-declare const integerSchema: z.core.$ZodBranded<z.ZodInt, "Integer">;
+declare const schema: z.core.$ZodBranded<z.ZodInt, "Integer">;
+export type Integer = z.infer<typeof schema>;
 export declare const integer: () => z.core.$ZodBranded<z.ZodInt, "Integer">;
 export {};

package/lib/cjs/number/integer.js

@@ -2,7 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.integer = void 0;
 const zod_1 = require("zod");
-const integerSchema = zod_1.z.int().brand("Integer");
-const integer = () => integerSchema;
+const schema = zod_1.z.int().brand("Integer");
+const integer = () => schema;
 exports.integer = integer;
 //# sourceMappingURL=integer.js.map

package/lib/cjs/number/integer.js.map

@@ -1 +1 @@
-{"version":3,"file":"integer.js","sourceRoot":"","sources":["../../../src/number/integer.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AAIxB,MAAM,aAAa,GAAG,OAAC,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;AAExC,MAAM,OAAO,GAAG,GAAG,EAAE,CAAC,aAAa,CAAC;AAA9B,QAAA,OAAO,WAAuB"}
+{"version":3,"file":"integer.js","sourceRoot":"","sources":["../../../src/number/integer.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AAExB,MAAM,MAAM,GAAG,OAAC,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;AAIjC,MAAM,OAAO,GAAG,GAAG,EAAE,CAAC,MAAM,CAAC;AAAvB,QAAA,OAAO,WAAgB"}

package/lib/esm/codec/index.d.ts

@@ -1,6 +1,9 @@
 declare const codec: {
     csv: () => import("zod").ZodCodec<import("zod").ZodString, import("zod").ZodArray<import("zod").ZodString>>;
     jsonParse: <S extends import("zod").ZodType>(schema: S) => import("zod").ZodCodec<import("zod/v4/core").$ZodBranded<import("zod").ZodString, "JsonString">, S>;
+    ms: (options?: {
+        long: boolean;
+    }) => import("zod").ZodCodec<import("zod").ZodString, import("zod").ZodNumber>;
     stringtoInteger: () => import("zod").ZodCodec<import("zod/v4/core").$ZodBranded<import("zod").ZodString, "IntegerString">, import("zod/v4/core").$ZodBranded<import("zod").ZodInt, "Integer">>;
     stringToJson: () => import("zod").ZodCodec<import("zod/v4/core").$ZodBranded<import("zod").ZodString, "JsonString">, import("zod").ZodType<import("../json/json.js").Json, unknown, import("zod/v4/core").$ZodTypeInternals<import("../json/json.js").Json, unknown>>>;
     stringToUrl: () => import("zod").ZodCodec<import("zod/v4/core").$ZodBranded<import("zod").ZodURL, "UrlString">, import("zod").ZodCustom<import("url").URL, import("url").URL>>;

package/lib/esm/codec/index.js

@@ -1,11 +1,13 @@
 import { csv } from "./csv.js";
 import { jsonParse } from "./json-parse.js";
+import { ms } from "./ms.js";
 import { stringToInteger } from "./string-to-integer.js";
 import { stringToJson } from "./string-to-json.js";
 import { stringToUrl } from "./string-to-url.js";
 const codec = {
     csv,
     jsonParse,
+    ms,
     stringtoInteger: stringToInteger,
     stringToJson,
     stringToUrl,

package/lib/esm/codec/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/codec/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAC/B,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD,MAAM,KAAK,GAAG;IACZ,GAAG;IACH,SAAS;IACT,eAAe,EAAE,eAAe;IAChC,YAAY;IACZ,WAAW;CACZ,CAAC;AAEF,OAAO,EAAE,KAAK,EAAE,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/codec/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAC/B,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,EAAE,EAAE,MAAM,SAAS,CAAC;AAC7B,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD,MAAM,KAAK,GAAG;IACZ,GAAG;IACH,SAAS;IACT,EAAE;IACF,eAAe,EAAE,eAAe;IAChC,YAAY;IACZ,WAAW;CACZ,CAAC;AAEF,OAAO,EAAE,KAAK,EAAE,CAAC"}

package/lib/esm/codec/ms.d.ts

@@ -0,0 +1,15 @@
+import { z } from "zod";
+/**
+ * A codec factory that returns codec parsing strings formatted
+ * as expected by the [ms](https://www.npmjs.com/package/ms) and turning them
+ * into their equivalent number in milliseconds.
+ *
+ * @param options - Those options are passed to `ms` when turning the milliseconds
+ * number into a formatted string.
+ *
+ * @returns A codec where the schemas are {@link z.string} and {@link z.number},
+ * and where the transforms between each are handled by the `ms` package.
+ */
+export declare const ms: (options?: {
+    long: boolean;
+}) => z.ZodCodec<z.ZodString, z.ZodNumber>;

package/lib/esm/codec/ms.js

@@ -0,0 +1,18 @@
+import impl from "ms";
+import { z } from "zod";
+/**
+ * A codec factory that returns codec parsing strings formatted
+ * as expected by the [ms](https://www.npmjs.com/package/ms) and turning them
+ * into their equivalent number in milliseconds.
+ *
+ * @param options - Those options are passed to `ms` when turning the milliseconds
+ * number into a formatted string.
+ *
+ * @returns A codec where the schemas are {@link z.string} and {@link z.number},
+ * and where the transforms between each are handled by the `ms` package.
+ */
+export const ms = (options) => z.codec(z.string(), z.number(), {
+    decode: (str) => impl(str) ?? z.NEVER,
+    encode: (millis) => impl(millis, options),
+});
+//# sourceMappingURL=ms.js.map

package/lib/esm/codec/ms.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ms.js","sourceRoot":"","sources":["../../../src/codec/ms.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,IAAI,CAAC;AACtB,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,OAA2B,EAAE,EAAE,CAChD,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE;IAC9B,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,GAAuB,CAAC,IAAI,CAAC,CAAC,KAAK;IACzD,MAAM,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC;CAC1C,CAAC,CAAC"}

package/lib/esm/index.d.ts

@@ -1,5 +1,6 @@
 import type { TypeGuard } from "@infra-blocks/types";
 import type { z } from "zod";
+import { isValid } from "./is-valid.js";
 /**
  * Returns a type guard function using the provided schema as the source of truth.
  *
@@ -16,19 +17,6 @@ import type { z } from "zod";
  * former case, that information is also carried with the type.
  */
 declare function typeGuard<S extends z.ZodType>(schema: S): TypeGuard<z.infer<S>>;
-/**
- * Validates that the value satisfies the provided schema.
- *
- * Upon success, the value's type is narrowed to the schema's output type.
- *
- * It uses `safeParse` internally.
- *
- * @param schema - The schema to validate against.
- * @param value - The value to validate.
- *
- * @returns Whether the value satisfies the schema.
- */
-declare function isValid<S extends z.ZodType>(schema: S, value: unknown): value is z.infer<S>;
 declare const zu: {
     aws: {
         accountId: typeof import("./aws/account-id.js").accountId;
@@ -39,6 +27,9 @@ declare const zu: {
     codec: {
         csv: () => z.ZodCodec<z.ZodString, z.ZodArray<z.ZodString>>;
         jsonParse: <S extends z.ZodType>(schema: S) => z.ZodCodec<z.core.$ZodBranded<z.ZodString, "JsonString">, S>;
+        ms: (options?: {
+            long: boolean;
+        }) => z.ZodCodec<z.ZodString, z.ZodNumber>;
         stringtoInteger: () => z.ZodCodec<z.core.$ZodBranded<z.ZodString, "IntegerString">, z.core.$ZodBranded<z.ZodInt, "Integer">>;
         stringToJson: () => z.ZodCodec<z.core.$ZodBranded<z.ZodString, "JsonString">, z.ZodType<import("./json/json.js").Json, unknown, z.core.$ZodTypeInternals<import("./json/json.js").Json, unknown>>>;
         stringToUrl: () => z.ZodCodec<z.core.$ZodBranded<z.ZodURL, "UrlString">, z.ZodCustom<import("url").URL, import("url").URL>>;

package/lib/esm/index.js

@@ -1,6 +1,7 @@
 import { aws } from "./aws/index.js";
 import { codec } from "./codec/index.js";
 import { geojson } from "./geojson/index.js";
+import { isValid } from "./is-valid.js";
 import { iso } from "./iso/index.js";
 import { json } from "./json/index.js";
 import { number } from "./number/index.js";
@@ -25,21 +26,6 @@ function typeGuard(schema) {
         return isValid(schema, value);
     };
 }
-/**
- * Validates that the value satisfies the provided schema.
- *
- * Upon success, the value's type is narrowed to the schema's output type.
- *
- * It uses `safeParse` internally.
- *
- * @param schema - The schema to validate against.
- * @param value - The value to validate.
- *
- * @returns Whether the value satisfies the schema.
- */
-function isValid(schema, value) {
-    return schema.safeParse(value).success;
-}
 const zu = {
     aws,
     codec,

package/lib/esm/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,GAAG,EAAE,MAAM,gBAAgB,CAAC;AACrC,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAC7C,OAAO,EAAE,GAAG,EAAE,MAAM,gBAAgB,CAAC;AACrC,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AACvC,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC3C,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAE3C;;;;;;;;;;;;;;GAcG;AACH,SAAS,SAAS,CAAsB,MAAS;IAC/C,OAAO,CAAC,KAAc,EAAuB,EAAE;QAC7C,OAAO,OAAO,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAChC,CAAC,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;GAWG;AACH,SAAS,OAAO,CACd,MAAS,EACT,KAAc;IAEd,OAAO,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC;AACzC,CAAC;AAED,MAAM,EAAE,GAAG;IACT,GAAG;IACH,KAAK;IACL,OAAO;IACP,GAAG;IACH,IAAI;IACJ,MAAM;IACN,MAAM;IACN,OAAO;IACP,SAAS;CACV,CAAC;AAEF,OAAO,EAAE,EAAE,EAAE,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,GAAG,EAAE,MAAM,gBAAgB,CAAC;AACrC,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAC7C,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,GAAG,EAAE,MAAM,gBAAgB,CAAC;AACrC,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AACvC,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC3C,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAE3C;;;;;;;;;;;;;;GAcG;AACH,SAAS,SAAS,CAAsB,MAAS;IAC/C,OAAO,CAAC,KAAc,EAAuB,EAAE;QAC7C,OAAO,OAAO,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAChC,CAAC,CAAC;AACJ,CAAC;AAED,MAAM,EAAE,GAAG;IACT,GAAG;IACH,KAAK;IACL,OAAO;IACP,GAAG;IACH,IAAI;IACJ,MAAM;IACN,MAAM;IACN,OAAO;IACP,SAAS;CACV,CAAC;AAEF,OAAO,EAAE,EAAE,EAAE,CAAC"}

package/lib/esm/is-valid.d.ts

@@ -0,0 +1,14 @@
+import type { z } from "zod";
+/**
+ * Validates that the value satisfies the provided schema.
+ *
+ * Upon success, the value's type is narrowed to the schema's output type.
+ *
+ * It uses `safeParse` internally.
+ *
+ * @param schema - The schema to validate against.
+ * @param value - The value to validate.
+ *
+ * @returns Whether the value satisfies the schema.
+ */
+export declare function isValid<S extends z.ZodType>(schema: S, value: unknown): value is z.infer<S>;

package/lib/esm/is-valid.js

@@ -0,0 +1,16 @@
+/**
+ * Validates that the value satisfies the provided schema.
+ *
+ * Upon success, the value's type is narrowed to the schema's output type.
+ *
+ * It uses `safeParse` internally.
+ *
+ * @param schema - The schema to validate against.
+ * @param value - The value to validate.
+ *
+ * @returns Whether the value satisfies the schema.
+ */
+export function isValid(schema, value) {
+    return schema.safeParse(value).success;
+}
+//# sourceMappingURL=is-valid.js.map

package/lib/esm/is-valid.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-valid.js","sourceRoot":"","sources":["../../src/is-valid.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,OAAO,CACrB,MAAS,EACT,KAAc;IAEd,OAAO,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC;AACzC,CAAC"}

package/lib/esm/number/integer.d.ts

@@ -1,5 +1,5 @@
 import { z } from "zod";
-export type Integer = z.infer<typeof integerSchema>;
-declare const integerSchema: z.core.$ZodBranded<z.ZodInt, "Integer">;
+declare const schema: z.core.$ZodBranded<z.ZodInt, "Integer">;
+export type Integer = z.infer<typeof schema>;
 export declare const integer: () => z.core.$ZodBranded<z.ZodInt, "Integer">;
 export {};

package/lib/esm/number/integer.js

@@ -1,4 +1,4 @@
 import { z } from "zod";
-const integerSchema = z.int().brand("Integer");
-export const integer = () => integerSchema;
+const schema = z.int().brand("Integer");
+export const integer = () => schema;
 //# sourceMappingURL=integer.js.map

package/lib/esm/number/integer.js.map

@@ -1 +1 @@
-{"version":3,"file":"integer.js","sourceRoot":"","sources":["../../../src/number/integer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,MAAM,aAAa,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;AAE/C,MAAM,CAAC,MAAM,OAAO,GAAG,GAAG,EAAE,CAAC,aAAa,CAAC"}
+{"version":3,"file":"integer.js","sourceRoot":"","sources":["../../../src/number/integer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,MAAM,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;AAIxC,MAAM,CAAC,MAAM,OAAO,GAAG,GAAG,EAAE,CAAC,MAAM,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@infra-blocks/zod-utils",
-  "version": "0.22.0",
+  "version": "0.23.0",
   "description": "Extensions to the zod package.",
   "keywords": [
     "zod",
@@ -69,12 +69,14 @@
     "@infra-blocks/types": "^0.24.0",
     "currency-codes": "^2.2.0",
     "iso-3166": "^4.4.0",
+    "ms": "^2.1.3",
     "zod": "^4.2.1"
   },
   "devDependencies": {
     "@biomejs/biome": "^2.3.10",
     "@infra-blocks/test": "^0.6.0",
     "@types/mocha": "^10.0.1",
+    "@types/ms": "^2.1.0",
     "@types/node": "^24.10.4",
     "c8": "^8.0.0",
     "lefthook": "^2.0.13",