@infra-blocks/zod-utils 0.18.0 → 0.19.0

package/README.md

@@ -13,7 +13,7 @@ the documentation will highlight that fact. Otherwise, assume classical structur
 When branding is used, the brand is a string that's the same as the name of the type. For example, the `AwsAccountId`
 is an alias for `string & z.$brand<"AwsAccountId">`.
 
-One caveat while using branded types schema is that the default value must also be branded (as should be). So,
+One caveat of using branded types schema is that the default value must also be branded (as should be). So,
 for example, where you would write `z.int().default(5)`, you instead have to write `zu.integer().default(zu.integer().parse(5))`.
 This is, however, exactly correct. Indeed, with vanilla zod, you could write `z.int().default(123.456)`, which violates
 the schema and is accepted both at compile time and runtime at the time of this writing.
@@ -21,18 +21,18 @@ the schema and is accepted both at compile time and runtime at the time of this
 ## API
 
 - [aws](#aws)
+- [codec](#codec)
 - [geojson](#geojson)
 - [integer](#integer)
 - [iso](#iso)
 - [json](#json)
-- [csv](#csv)
 - [string](#string)
 - [typeGuard](#type-guard)
 - [isValid](#is-valid)
 
 ### AWS
 
-The `aws` module contains utilities to validate various AWS elements. All schemas return [branded types](#branded-types).
+The `zu.aws` module contains utilities to validate various AWS elements. All schemas return [branded types](#branded-types).
 
 ```typescript
 import { zu } from "@infra-blocks/zod-utils";
@@ -48,6 +48,45 @@ zu.aws.partition().parse("aws");
 zu.aws.region().parse("us-east-1");
 ```
 
+### codec
+
+The `zu.codec` module contains codecs.
+
+#### csv
+
+The `zu.codec.csv()` utility is a codec transforming a string into an array of string using the string `split` method
+to do so.
+
+```typescript
+import { zu } from "@infra-blocks/zod-utils";
+
+const items = zu.codec.csv().parse("one,two,three"); // items is ["one", "two", "three"]
+```
+
+#### stringToInteger
+
+The `zu.codec.stringToInteger()` codec is taken almost verbatim
+from [Zod's own documentation](https://zod.dev/codecs#stringtoint). The
+only difference is the final type is branded as it is using `zu.integer()` internally.
+
+```typescript
+import { zu } from "@infra-blocks/zod-utils";
+import { Integer } from "@infra-blocks/zod-utils";
+
+const item: Integer = zu.codec.stringToInteger().parse("1234");
+```
+
+#### stringToUrl
+
+The `zu.codec.stringToUrl()` codec is taken [Zod's own documentation](https://zod.dev/codecs#stringtourl).
+The result is a URL object. No branding here esé.
+
+```typescript
+import { zu } from "@infra-blocks/zod-utils";
+
+const item: URL = zu.codec.stringToUrl().parse("http://localhost:3000");
+```
+
 ### GeoJson
 
 The `geojson` module contains utilities to validate GeoJSON objects.
@@ -287,18 +326,6 @@ zu.json.object().parse(5); // Boom.
 zu.json.object().parse([]); // Boom.
 ```
 
-### CSV
-
-The `csv` utility is nothing but a shorthand for `z.string().transform(s => s.split(","))`, which
-is commonly written, in my experience. One can stop retyping all those letters and replace them
-with a simple `zu.csv()` call.
-
-```typescript
-import { zu } from "@infra-blocks/zod-utils";
-
-const items = zu.csv().parse("one,two,three"); // items is ["one", "two", "three"]
-```
-
 ### String
 
 The `zu.string` module exposes schemas for manipulating strings. All schemas return [branded types](#branded-types).

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

@@ -0,0 +1 @@
+{"version":3,"file":"csv.js","sourceRoot":"","sources":["../../../src/codec/csv.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AAExB,MAAM,KAAK,GAAG,OAAC,CAAC,KAAK,CAAC,OAAC,CAAC,MAAM,EAAE,EAAE,OAAC,CAAC,KAAK,CAAC,OAAC,CAAC,MAAM,EAAE,CAAC,EAAE;IACrD,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC;IAC/B,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC;CAC/B,CAAC,CAAC;AAEH;;;;;;GAMG;AACI,MAAM,GAAG,GAAG,GAAG,EAAE,CAAC,KAAK,CAAC;AAAlB,QAAA,GAAG,OAAe"}

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

@@ -0,0 +1,6 @@
+declare const codec: {
+    csv: () => import("zod").ZodCodec<import("zod").ZodString, import("zod").ZodArray<import("zod").ZodString>>;
+    stringtoInteger: () => import("zod").ZodCodec<import("zod/v4/core").$ZodBranded<import("zod").ZodString, "IntegerString">, import("zod/v4/core").$ZodBranded<import("zod").ZodInt, "Integer">>;
+    stringToUrl: () => import("zod").ZodCodec<import("zod/v4/core").$ZodBranded<import("zod").ZodURL, "UrlString">, import("zod").ZodCustom<import("url").URL, import("url").URL>>;
+};
+export { codec };

package/lib/cjs/codec/index.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.codec = void 0;
+const csv_js_1 = require("./csv.js");
+const string_to_integer_js_1 = require("./string-to-integer.js");
+const string_to_url_js_1 = require("./string-to-url.js");
+const codec = {
+    csv: csv_js_1.csv,
+    stringtoInteger: string_to_integer_js_1.stringtoInteger,
+    stringToUrl: string_to_url_js_1.stringToUrl,
+};
+exports.codec = codec;
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/codec/index.ts"],"names":[],"mappings":";;;AAAA,qCAA+B;AAC/B,iEAAyD;AACzD,yDAAiD;AAEjD,MAAM,KAAK,GAAG;IACZ,GAAG,EAAH,YAAG;IACH,eAAe,EAAf,sCAAe;IACf,WAAW,EAAX,8BAAW;CACZ,CAAC;AAEO,sBAAK"}

package/lib/cjs/codec/string-to-integer.d.ts

@@ -0,0 +1,13 @@
+import { z } from "zod";
+/**
+ * A string to integer codec.
+ *
+ * Same as defined in Zod's documentation, except branding is included using
+ * {@link zu.integer} in place of {@link z.int} and {@link zu.string.integer}
+ * in place of `z.string().regex(z.regexes.integer)`.
+ *
+ * @returns A string to integer codec.
+ *
+ * @see https://zod.dev/codecs#stringtoint
+ */
+export declare const stringtoInteger: () => z.ZodCodec<z.core.$ZodBranded<z.ZodString, "IntegerString">, z.core.$ZodBranded<z.ZodInt, "Integer">>;

package/lib/cjs/codec/string-to-integer.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.stringtoInteger = void 0;
+const zod_1 = require("zod");
+const integer_js_1 = require("../integer.js");
+const lib_js_1 = require("../lib.js");
+const index_js_1 = require("../string/index.js");
+const stringToIntegerCodec = zod_1.z.codec(index_js_1.string.integer(), (0, integer_js_1.integer)(), {
+    decode: (str) => Number.parseInt(str, 10),
+    encode: (num) => (0, lib_js_1.trusted)(num.toString()),
+});
+/**
+ * A string to integer codec.
+ *
+ * Same as defined in Zod's documentation, except branding is included using
+ * {@link zu.integer} in place of {@link z.int} and {@link zu.string.integer}
+ * in place of `z.string().regex(z.regexes.integer)`.
+ *
+ * @returns A string to integer codec.
+ *
+ * @see https://zod.dev/codecs#stringtoint
+ */
+const stringtoInteger = () => stringToIntegerCodec;
+exports.stringtoInteger = stringtoInteger;
+//# sourceMappingURL=string-to-integer.js.map

package/lib/cjs/codec/string-to-integer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"string-to-integer.js","sourceRoot":"","sources":["../../../src/codec/string-to-integer.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AAExB,8CAAwC;AACxC,sCAAoC;AACpC,iDAA4C;AAE5C,MAAM,oBAAoB,GAAG,OAAC,CAAC,KAAK,CAAC,iBAAM,CAAC,OAAO,EAAE,EAAE,IAAA,oBAAO,GAAE,EAAE;IAChE,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,EAAE,EAAE,CAAC;IACzC,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,IAAA,gBAAO,EAAC,GAAG,CAAC,QAAQ,EAAE,CAAC;CACzC,CAAC,CAAC;AAEH;;;;;;;;;;GAUG;AACI,MAAM,eAAe,GAAG,GAAG,EAAE,CAAC,oBAAoB,CAAC;AAA7C,QAAA,eAAe,mBAA8B"}

package/lib/cjs/codec/string-to-url.d.ts

@@ -0,0 +1,9 @@
+import { z } from "zod";
+/**
+ * A string to URL codec, as defined in Zod's documentation.
+ *
+ * @returns A string to URL codec.
+ *
+ * @see https://zod.dev/codecs#stringtourl
+ */
+export declare const stringToUrl: () => z.ZodCodec<z.core.$ZodBranded<z.ZodURL, "UrlString">, z.ZodCustom<import("url").URL, import("url").URL>>;

package/lib/cjs/codec/string-to-url.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.stringToUrl = void 0;
+const zod_1 = require("zod");
+const lib_js_1 = require("../lib.js");
+const index_js_1 = require("../string/index.js");
+const stringToURLCodec = zod_1.z.codec(index_js_1.string.url(), zod_1.z.instanceof(URL), {
+    decode: (urlString) => new URL(urlString),
+    encode: (url) => (0, lib_js_1.trusted)(url.href),
+});
+/**
+ * A string to URL codec, as defined in Zod's documentation.
+ *
+ * @returns A string to URL codec.
+ *
+ * @see https://zod.dev/codecs#stringtourl
+ */
+const stringToUrl = () => stringToURLCodec;
+exports.stringToUrl = stringToUrl;
+//# sourceMappingURL=string-to-url.js.map

package/lib/cjs/codec/string-to-url.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"string-to-url.js","sourceRoot":"","sources":["../../../src/codec/string-to-url.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,sCAAoC;AACpC,iDAA4C;AAE5C,MAAM,gBAAgB,GAAG,OAAC,CAAC,KAAK,CAAC,iBAAM,CAAC,GAAG,EAAE,EAAE,OAAC,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE;IAChE,MAAM,EAAE,CAAC,SAAS,EAAE,EAAE,CAAC,IAAI,GAAG,CAAC,SAAS,CAAC;IACzC,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,IAAA,gBAAO,EAAC,GAAG,CAAC,IAAI,CAAC;CACnC,CAAC,CAAC;AAEH;;;;;;GAMG;AACI,MAAM,WAAW,GAAG,GAAG,EAAE,CAAC,gBAAgB,CAAC;AAArC,QAAA,WAAW,eAA0B"}

package/lib/cjs/index.d.ts

@@ -1,25 +1,5 @@
 import type { TypeGuard } from "@infra-blocks/types";
-import { z } from "zod";
-/**
- * A string to integer codec.
- *
- * Same as defined in Zod's documentation, except branding is included using
- * {@link zu.integer} in place of {@link z.int} and {@link zu.string.integer}
- * in place of `z.string().regex(z.regexes.integer)`.
- *
- * @returns A string to integer codec.
- *
- * @see https://zod.dev/codecs#stringtoint
- */
-declare function stringtoInteger(): z.ZodCodec<z.core.$ZodBranded<z.ZodString, "IntegerString">, z.core.$ZodBranded<z.ZodInt, "Integer">>;
-/**
- * A string to URL codec, as defined in Zod's documentation.
- *
- * @returns A string to URL codec.
- *
- * @see https://zod.dev/codecs#stringtourl
- */
-declare function stringToUrl(): z.ZodCodec<z.core.$ZodBranded<z.ZodURL, "UrlString">, z.ZodCustom<import("url").URL, import("url").URL>>;
+import type { z } from "zod";
 /**
  * Returns a type guard function using the provided schema as the source of truth.
  *
@@ -56,6 +36,11 @@ declare const zu: {
         region: typeof import("./aws/region.js").region;
         partition: typeof import("./aws/partition.js").partition;
     };
+    codec: {
+        csv: () => z.ZodCodec<z.ZodString, z.ZodArray<z.ZodString>>;
+        stringtoInteger: () => z.ZodCodec<z.core.$ZodBranded<z.ZodString, "IntegerString">, z.core.$ZodBranded<z.ZodInt, "Integer">>;
+        stringToUrl: () => z.ZodCodec<z.core.$ZodBranded<z.ZodURL, "UrlString">, z.ZodCustom<import("url").URL, import("url").URL>>;
+    };
     geojson: typeof import("./geojson/geojson.js").geojson & {
         boundingBox: typeof import("./geojson/bounding-box.js").boundingBox;
         feature: typeof import("./geojson/feature.js").feature;
@@ -89,11 +74,8 @@ declare const zu: {
         integer: () => z.core.$ZodBranded<z.ZodString, "IntegerString">;
         url: () => z.core.$ZodBranded<z.ZodURL, "UrlString">;
     };
-    csv: () => z.ZodCodec<z.ZodString, z.ZodArray<z.ZodString>>;
     isValid: typeof isValid;
     integer: () => z.core.$ZodBranded<z.ZodInt, "Integer">;
-    stringtoInteger: typeof stringtoInteger;
-    stringToUrl: typeof stringToUrl;
     typeGuard: typeof typeGuard;
 };
 export type * from "./types.js";

package/lib/cjs/index.js

@@ -1,50 +1,13 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.zu = void 0;
-const zod_1 = require("zod");
 const index_js_1 = require("./aws/index.js");
-const csv_js_1 = require("./csv.js");
-const index_js_2 = require("./geojson/index.js");
+const index_js_2 = require("./codec/index.js");
+const index_js_3 = require("./geojson/index.js");
 const integer_js_1 = require("./integer.js");
-const index_js_3 = require("./iso/index.js");
-const index_js_4 = require("./json/index.js");
-const index_js_5 = require("./string/index.js");
-// TODO: ts-types.
-function trusted(value) {
-    return value;
-}
-const stringToIntegerCodec = zod_1.z.codec(index_js_5.string.integer(), (0, integer_js_1.integer)(), {
-    decode: (str) => Number.parseInt(str, 10),
-    encode: (num) => trusted(num.toString()),
-});
-/**
- * A string to integer codec.
- *
- * Same as defined in Zod's documentation, except branding is included using
- * {@link zu.integer} in place of {@link z.int} and {@link zu.string.integer}
- * in place of `z.string().regex(z.regexes.integer)`.
- *
- * @returns A string to integer codec.
- *
- * @see https://zod.dev/codecs#stringtoint
- */
-function stringtoInteger() {
-    return stringToIntegerCodec;
-}
-const stringToURLCodec = zod_1.z.codec(index_js_5.string.url(), zod_1.z.instanceof(URL), {
-    decode: (urlString) => new URL(urlString),
-    encode: (url) => trusted(url.href),
-});
-/**
- * A string to URL codec, as defined in Zod's documentation.
- *
- * @returns A string to URL codec.
- *
- * @see https://zod.dev/codecs#stringtourl
- */
-function stringToUrl() {
-    return stringToURLCodec;
-}
+const index_js_4 = require("./iso/index.js");
+const index_js_5 = require("./json/index.js");
+const index_js_6 = require("./string/index.js");
 /**
  * Returns a type guard function using the provided schema as the source of truth.
  *
@@ -82,15 +45,13 @@ function isValid(schema, value) {
 }
 const zu = {
     aws: index_js_1.aws,
-    geojson: index_js_2.geojson,
-    iso: index_js_3.iso,
-    json: index_js_4.json,
-    string: index_js_5.string,
-    csv: csv_js_1.csv,
+    codec: index_js_2.codec,
+    geojson: index_js_3.geojson,
+    iso: index_js_4.iso,
+    json: index_js_5.json,
+    string: index_js_6.string,
     isValid,
     integer: integer_js_1.integer,
-    stringtoInteger,
-    stringToUrl,
     typeGuard,
 };
 exports.zu = zu;

package/lib/cjs/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;AACA,6BAAwB;AACxB,6CAAqC;AACrC,qCAA+B;AAC/B,iDAA6C;AAC7C,6CAAuC;AACvC,6CAAqC;AACrC,8CAAuC;AACvC,gDAA2C;AAE3C,kBAAkB;AAClB,SAAS,OAAO,CAAI,KAAc;IAChC,OAAO,KAAU,CAAC;AACpB,CAAC;AAED,MAAM,oBAAoB,GAAG,OAAC,CAAC,KAAK,CAAC,iBAAM,CAAC,OAAO,EAAE,EAAE,IAAA,oBAAO,GAAE,EAAE;IAChE,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,EAAE,EAAE,CAAC;IACzC,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC;CACzC,CAAC,CAAC;AAEH;;;;;;;;;;GAUG;AACH,SAAS,eAAe;IACtB,OAAO,oBAAoB,CAAC;AAC9B,CAAC;AAED,MAAM,gBAAgB,GAAG,OAAC,CAAC,KAAK,CAAC,iBAAM,CAAC,GAAG,EAAE,EAAE,OAAC,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE;IAChE,MAAM,EAAE,CAAC,SAAS,EAAE,EAAE,CAAC,IAAI,GAAG,CAAC,SAAS,CAAC;IACzC,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC;CACnC,CAAC,CAAC;AAEH;;;;;;GAMG;AACH,SAAS,WAAW;IAClB,OAAO,gBAAgB,CAAC;AAC1B,CAAC;AAED;;;;;;;;;;;;;;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,OAAO,EAAP,kBAAO;IACP,GAAG,EAAH,cAAG;IACH,IAAI,EAAJ,eAAI;IACJ,MAAM,EAAN,iBAAM;IACN,GAAG,EAAH,YAAG;IACH,OAAO;IACP,OAAO,EAAP,oBAAO;IACP,eAAe;IACf,WAAW;IACX,SAAS;CACV,CAAC;AAGO,gBAAE"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;AAEA,6CAAqC;AACrC,+CAAyC;AACzC,iDAA6C;AAC7C,6CAAuC;AACvC,6CAAqC;AACrC,8CAAuC;AACvC,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,OAAO;IACP,OAAO,EAAP,oBAAO;IACP,SAAS;CACV,CAAC;AAGO,gBAAE"}

package/lib/cjs/lib.d.ts

@@ -0,0 +1,5 @@
+import type { z } from "zod";
+export declare function trusted<T>(value: unknown): T;
+type Brand<T> = T extends z.$brand<infer B> ? B : never;
+export type Unbranded<T> = T extends infer U & z.$brand<Brand<T>> ? Unbranded<U> : T;
+export {};

package/lib/cjs/lib.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.trusted = trusted;
+// TODO: ts-types.
+function trusted(value) {
+    return value;
+}
+//# sourceMappingURL=lib.js.map

package/lib/cjs/lib.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lib.js","sourceRoot":"","sources":["../../src/lib.ts"],"names":[],"mappings":";;AAIA,0BAEC;AAHD,kBAAkB;AAClB,SAAgB,OAAO,CAAI,KAAc;IACvC,OAAO,KAAU,CAAC;AACpB,CAAC"}

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

@@ -0,0 +1 @@
+{"version":3,"file":"csv.js","sourceRoot":"","sources":["../../../src/codec/csv.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE;IACrD,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC;IAC/B,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC;CAC/B,CAAC,CAAC;AAEH;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,GAAG,GAAG,GAAG,EAAE,CAAC,KAAK,CAAC"}

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

@@ -0,0 +1,6 @@
+declare const codec: {
+    csv: () => import("zod").ZodCodec<import("zod").ZodString, import("zod").ZodArray<import("zod").ZodString>>;
+    stringtoInteger: () => import("zod").ZodCodec<import("zod/v4/core").$ZodBranded<import("zod").ZodString, "IntegerString">, import("zod/v4/core").$ZodBranded<import("zod").ZodInt, "Integer">>;
+    stringToUrl: () => import("zod").ZodCodec<import("zod/v4/core").$ZodBranded<import("zod").ZodURL, "UrlString">, import("zod").ZodCustom<import("url").URL, import("url").URL>>;
+};
+export { codec };

package/lib/esm/codec/index.js

@@ -0,0 +1,10 @@
+import { csv } from "./csv.js";
+import { stringtoInteger } from "./string-to-integer.js";
+import { stringToUrl } from "./string-to-url.js";
+const codec = {
+    csv,
+    stringtoInteger,
+    stringToUrl,
+};
+export { codec };
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +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,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD,MAAM,KAAK,GAAG;IACZ,GAAG;IACH,eAAe;IACf,WAAW;CACZ,CAAC;AAEF,OAAO,EAAE,KAAK,EAAE,CAAC"}

package/lib/esm/codec/string-to-integer.d.ts

@@ -0,0 +1,13 @@
+import { z } from "zod";
+/**
+ * A string to integer codec.
+ *
+ * Same as defined in Zod's documentation, except branding is included using
+ * {@link zu.integer} in place of {@link z.int} and {@link zu.string.integer}
+ * in place of `z.string().regex(z.regexes.integer)`.
+ *
+ * @returns A string to integer codec.
+ *
+ * @see https://zod.dev/codecs#stringtoint
+ */
+export declare const stringtoInteger: () => z.ZodCodec<z.core.$ZodBranded<z.ZodString, "IntegerString">, z.core.$ZodBranded<z.ZodInt, "Integer">>;

package/lib/esm/codec/string-to-integer.js

@@ -0,0 +1,21 @@
+import { z } from "zod";
+import { integer } from "../integer.js";
+import { trusted } from "../lib.js";
+import { string } from "../string/index.js";
+const stringToIntegerCodec = z.codec(string.integer(), integer(), {
+    decode: (str) => Number.parseInt(str, 10),
+    encode: (num) => trusted(num.toString()),
+});
+/**
+ * A string to integer codec.
+ *
+ * Same as defined in Zod's documentation, except branding is included using
+ * {@link zu.integer} in place of {@link z.int} and {@link zu.string.integer}
+ * in place of `z.string().regex(z.regexes.integer)`.
+ *
+ * @returns A string to integer codec.
+ *
+ * @see https://zod.dev/codecs#stringtoint
+ */
+export const stringtoInteger = () => stringToIntegerCodec;
+//# sourceMappingURL=string-to-integer.js.map

package/lib/esm/codec/string-to-integer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"string-to-integer.js","sourceRoot":"","sources":["../../../src/codec/string-to-integer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAE5C,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,EAAE,EAAE,OAAO,EAAE,EAAE;IAChE,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,EAAE,EAAE,CAAC;IACzC,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC;CACzC,CAAC,CAAC;AAEH;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,GAAG,EAAE,CAAC,oBAAoB,CAAC"}

package/lib/esm/codec/string-to-url.d.ts

@@ -0,0 +1,9 @@
+import { z } from "zod";
+/**
+ * A string to URL codec, as defined in Zod's documentation.
+ *
+ * @returns A string to URL codec.
+ *
+ * @see https://zod.dev/codecs#stringtourl
+ */
+export declare const stringToUrl: () => z.ZodCodec<z.core.$ZodBranded<z.ZodURL, "UrlString">, z.ZodCustom<import("url").URL, import("url").URL>>;

package/lib/esm/codec/string-to-url.js

@@ -0,0 +1,16 @@
+import { z } from "zod";
+import { trusted } from "../lib.js";
+import { string } from "../string/index.js";
+const stringToURLCodec = z.codec(string.url(), z.instanceof(URL), {
+    decode: (urlString) => new URL(urlString),
+    encode: (url) => trusted(url.href),
+});
+/**
+ * A string to URL codec, as defined in Zod's documentation.
+ *
+ * @returns A string to URL codec.
+ *
+ * @see https://zod.dev/codecs#stringtourl
+ */
+export const stringToUrl = () => stringToURLCodec;
+//# sourceMappingURL=string-to-url.js.map

package/lib/esm/codec/string-to-url.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"string-to-url.js","sourceRoot":"","sources":["../../../src/codec/string-to-url.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAE5C,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE;IAChE,MAAM,EAAE,CAAC,SAAS,EAAE,EAAE,CAAC,IAAI,GAAG,CAAC,SAAS,CAAC;IACzC,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC;CACnC,CAAC,CAAC;AAEH;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,GAAG,EAAE,CAAC,gBAAgB,CAAC"}

package/lib/esm/index.d.ts

@@ -1,25 +1,5 @@
 import type { TypeGuard } from "@infra-blocks/types";
-import { z } from "zod";
-/**
- * A string to integer codec.
- *
- * Same as defined in Zod's documentation, except branding is included using
- * {@link zu.integer} in place of {@link z.int} and {@link zu.string.integer}
- * in place of `z.string().regex(z.regexes.integer)`.
- *
- * @returns A string to integer codec.
- *
- * @see https://zod.dev/codecs#stringtoint
- */
-declare function stringtoInteger(): z.ZodCodec<z.core.$ZodBranded<z.ZodString, "IntegerString">, z.core.$ZodBranded<z.ZodInt, "Integer">>;
-/**
- * A string to URL codec, as defined in Zod's documentation.
- *
- * @returns A string to URL codec.
- *
- * @see https://zod.dev/codecs#stringtourl
- */
-declare function stringToUrl(): z.ZodCodec<z.core.$ZodBranded<z.ZodURL, "UrlString">, z.ZodCustom<import("url").URL, import("url").URL>>;
+import type { z } from "zod";
 /**
  * Returns a type guard function using the provided schema as the source of truth.
  *
@@ -56,6 +36,11 @@ declare const zu: {
         region: typeof import("./aws/region.js").region;
         partition: typeof import("./aws/partition.js").partition;
     };
+    codec: {
+        csv: () => z.ZodCodec<z.ZodString, z.ZodArray<z.ZodString>>;
+        stringtoInteger: () => z.ZodCodec<z.core.$ZodBranded<z.ZodString, "IntegerString">, z.core.$ZodBranded<z.ZodInt, "Integer">>;
+        stringToUrl: () => z.ZodCodec<z.core.$ZodBranded<z.ZodURL, "UrlString">, z.ZodCustom<import("url").URL, import("url").URL>>;
+    };
     geojson: typeof import("./geojson/geojson.js").geojson & {
         boundingBox: typeof import("./geojson/bounding-box.js").boundingBox;
         feature: typeof import("./geojson/feature.js").feature;
@@ -89,11 +74,8 @@ declare const zu: {
         integer: () => z.core.$ZodBranded<z.ZodString, "IntegerString">;
         url: () => z.core.$ZodBranded<z.ZodURL, "UrlString">;
     };
-    csv: () => z.ZodCodec<z.ZodString, z.ZodArray<z.ZodString>>;
     isValid: typeof isValid;
     integer: () => z.core.$ZodBranded<z.ZodInt, "Integer">;
-    stringtoInteger: typeof stringtoInteger;
-    stringToUrl: typeof stringToUrl;
     typeGuard: typeof typeGuard;
 };
 export type * from "./types.js";

package/lib/esm/index.js

@@ -1,47 +1,10 @@
-import { z } from "zod";
 import { aws } from "./aws/index.js";
-import { csv } from "./csv.js";
+import { codec } from "./codec/index.js";
 import { geojson } from "./geojson/index.js";
 import { integer } from "./integer.js";
 import { iso } from "./iso/index.js";
 import { json } from "./json/index.js";
 import { string } from "./string/index.js";
-// TODO: ts-types.
-function trusted(value) {
-    return value;
-}
-const stringToIntegerCodec = z.codec(string.integer(), integer(), {
-    decode: (str) => Number.parseInt(str, 10),
-    encode: (num) => trusted(num.toString()),
-});
-/**
- * A string to integer codec.
- *
- * Same as defined in Zod's documentation, except branding is included using
- * {@link zu.integer} in place of {@link z.int} and {@link zu.string.integer}
- * in place of `z.string().regex(z.regexes.integer)`.
- *
- * @returns A string to integer codec.
- *
- * @see https://zod.dev/codecs#stringtoint
- */
-function stringtoInteger() {
-    return stringToIntegerCodec;
-}
-const stringToURLCodec = z.codec(string.url(), z.instanceof(URL), {
-    decode: (urlString) => new URL(urlString),
-    encode: (url) => trusted(url.href),
-});
-/**
- * A string to URL codec, as defined in Zod's documentation.
- *
- * @returns A string to URL codec.
- *
- * @see https://zod.dev/codecs#stringtourl
- */
-function stringToUrl() {
-    return stringToURLCodec;
-}
 /**
  * Returns a type guard function using the provided schema as the source of truth.
  *
@@ -79,15 +42,13 @@ function isValid(schema, value) {
 }
 const zu = {
     aws,
+    codec,
     geojson,
     iso,
     json,
     string,
-    csv,
     isValid,
     integer,
-    stringtoInteger,
-    stringToUrl,
     typeGuard,
 };
 export { zu };

package/lib/esm/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,GAAG,EAAE,MAAM,gBAAgB,CAAC;AACrC,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAC/B,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAC7C,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,GAAG,EAAE,MAAM,gBAAgB,CAAC;AACrC,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AACvC,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAE3C,kBAAkB;AAClB,SAAS,OAAO,CAAI,KAAc;IAChC,OAAO,KAAU,CAAC;AACpB,CAAC;AAED,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,EAAE,EAAE,OAAO,EAAE,EAAE;IAChE,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,EAAE,EAAE,CAAC;IACzC,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC;CACzC,CAAC,CAAC;AAEH;;;;;;;;;;GAUG;AACH,SAAS,eAAe;IACtB,OAAO,oBAAoB,CAAC;AAC9B,CAAC;AAED,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE;IAChE,MAAM,EAAE,CAAC,SAAS,EAAE,EAAE,CAAC,IAAI,GAAG,CAAC,SAAS,CAAC;IACzC,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC;CACnC,CAAC,CAAC;AAEH;;;;;;GAMG;AACH,SAAS,WAAW;IAClB,OAAO,gBAAgB,CAAC;AAC1B,CAAC;AAED;;;;;;;;;;;;;;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,OAAO;IACP,GAAG;IACH,IAAI;IACJ,MAAM;IACN,GAAG;IACH,OAAO;IACP,OAAO;IACP,eAAe;IACf,WAAW;IACX,SAAS;CACV,CAAC;AAGF,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,cAAc,CAAC;AACvC,OAAO,EAAE,GAAG,EAAE,MAAM,gBAAgB,CAAC;AACrC,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AACvC,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,OAAO;IACP,OAAO;IACP,SAAS;CACV,CAAC;AAGF,OAAO,EAAE,EAAE,EAAE,CAAC"}

package/lib/esm/lib.d.ts

@@ -0,0 +1,5 @@
+import type { z } from "zod";
+export declare function trusted<T>(value: unknown): T;
+type Brand<T> = T extends z.$brand<infer B> ? B : never;
+export type Unbranded<T> = T extends infer U & z.$brand<Brand<T>> ? Unbranded<U> : T;
+export {};

package/lib/esm/lib.js

@@ -0,0 +1,5 @@
+// TODO: ts-types.
+export function trusted(value) {
+    return value;
+}
+//# sourceMappingURL=lib.js.map

package/lib/esm/lib.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lib.js","sourceRoot":"","sources":["../../src/lib.ts"],"names":[],"mappings":"AAGA,kBAAkB;AAClB,MAAM,UAAU,OAAO,CAAI,KAAc;IACvC,OAAO,KAAU,CAAC;AACpB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@infra-blocks/zod-utils",
-  "version": "0.18.0",
+  "version": "0.19.0",
   "description": "Extensions to the zod package.",
   "keywords": [
     "zod",

package/lib/cjs/csv.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"csv.js","sourceRoot":"","sources":["../../src/csv.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AAExB,MAAM,KAAK,GAAG,OAAC,CAAC,KAAK,CAAC,OAAC,CAAC,MAAM,EAAE,EAAE,OAAC,CAAC,KAAK,CAAC,OAAC,CAAC,MAAM,EAAE,CAAC,EAAE;IACrD,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC;IAC/B,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC;CAC/B,CAAC,CAAC;AAEH;;;;;;GAMG;AACI,MAAM,GAAG,GAAG,GAAG,EAAE,CAAC,KAAK,CAAC;AAAlB,QAAA,GAAG,OAAe"}

package/lib/esm/csv.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"csv.js","sourceRoot":"","sources":["../../src/csv.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE;IACrD,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC;IAC/B,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC;CAC/B,CAAC,CAAC;AAEH;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,GAAG,GAAG,GAAG,EAAE,CAAC,KAAK,CAAC"}