@infra-blocks/zod-utils 0.20.0-alpha.3 → 0.21.0-alpha.0

package/lib/cjs/string/types.d.ts

@@ -1,2 +1,3 @@
 export { IntegerString } from "./integer.js";
+export { JsonString } from "./json.js";
 export { UrlString } from "./url.js";

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

@@ -1,9 +1,9 @@
-import { z } from "zod";
 /**
  * Returns a codec that takes in a CSV string and outputs a string array.
  *
- * The string is splitted on the "," character.
+ * The string is splitted on the "," character. It uses `stringSplit(",")`
+ * internally.
  *
  * @returns A CSV codec.
  */
-export declare const csv: () => z.ZodCodec<z.ZodString, z.ZodArray<z.ZodString>>;
+export declare const csv: () => import("zod").ZodCodec<import("zod").ZodString, import("zod").ZodArray<import("zod").ZodString>>;

package/lib/esm/codec/csv.js

@@ -1,12 +1,10 @@
-import { z } from "zod";
-const codec = z.codec(z.string(), z.array(z.string()), {
-    decode: (str) => str.split(","),
-    encode: (arr) => arr.join(","),
-});
+import { stringSplit } from "./string-split.js";
+const codec = stringSplit(",");
 /**
  * Returns a codec that takes in a CSV string and outputs a string array.
  *
- * The string is splitted on the "," character.
+ * The string is splitted on the "," character. It uses `stringSplit(",")`
+ * internally.
  *
  * @returns A CSV codec.
  */

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

@@ -1 +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"}
+{"version":3,"file":"csv.js","sourceRoot":"","sources":["../../../src/codec/csv.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;AAE/B;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,GAAG,GAAG,GAAG,EAAE,CAAC,KAAK,CAAC"}

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

@@ -1,6 +1,8 @@
 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>;
     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>>;
 };
 export { codec };

package/lib/esm/codec/index.js

@@ -1,9 +1,13 @@
 import { csv } from "./csv.js";
-import { stringtoInteger } from "./string-to-integer.js";
+import { jsonParse } from "./json-parse.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,
-    stringtoInteger,
+    jsonParse,
+    stringtoInteger: stringToInteger,
+    stringToJson,
     stringToUrl,
 };
 export { codec };

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,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"}
+{"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"}

package/lib/esm/codec/json-parse.d.ts

@@ -0,0 +1,10 @@
+import { z } from "zod";
+/**
+ * A codec factory that returns a codec that expects a valid JSON string
+ * as input, parses it using JSON.parse, then passes the result to the
+ * provided schema.
+ *
+ * @returns A codec where the first schema is {@link string.json}, and the
+ * second one is the provided input.
+ */
+export declare const jsonParse: <S extends z.ZodType>(schema: S) => z.ZodCodec<z.core.$ZodBranded<z.ZodString, "JsonString">, S>;

package/lib/esm/codec/json-parse.js

@@ -0,0 +1,16 @@
+import { z } from "zod";
+import { trusted } from "../lib.js";
+import { string } from "../string/index.js";
+/**
+ * A codec factory that returns a codec that expects a valid JSON string
+ * as input, parses it using JSON.parse, then passes the result to the
+ * provided schema.
+ *
+ * @returns A codec where the first schema is {@link string.json}, and the
+ * second one is the provided input.
+ */
+export const jsonParse = (schema) => z.codec(string.json(), schema, {
+    decode: (str) => JSON.parse(str),
+    encode: (json) => trusted(JSON.stringify(json)),
+});
+//# sourceMappingURL=json-parse.js.map

package/lib/esm/codec/json-parse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-parse.js","sourceRoot":"","sources":["../../../src/codec/json-parse.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;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,CAAsB,MAAS,EAAE,EAAE,CAC1D,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE;IAC7B,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC;IAChC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;CAChD,CAAC,CAAC"}

package/lib/esm/codec/string-split.d.ts

@@ -0,0 +1,13 @@
+import { z } from "zod";
+/**
+ * A codec factory that returns a codec that expects a string
+ * as input, splits it using {@link String.split} with the provided
+ * seperator, then passes the result to the provided schema.
+ *
+ * When encoding, the array is joined with the same separator provided.
+ *
+ * @returns A codec where the first schema is {@link z.string}, the
+ * second one is `z.array(z.string())`, and the transformations are
+ * done using {@link String.split} and {@link Array.join}
+ */
+export declare const stringSplit: (separator: string) => z.ZodCodec<z.ZodString, z.ZodArray<z.ZodString>>;

package/lib/esm/codec/string-split.js

@@ -0,0 +1,17 @@
+import { z } from "zod";
+/**
+ * A codec factory that returns a codec that expects a string
+ * as input, splits it using {@link String.split} with the provided
+ * seperator, then passes the result to the provided schema.
+ *
+ * When encoding, the array is joined with the same separator provided.
+ *
+ * @returns A codec where the first schema is {@link z.string}, the
+ * second one is `z.array(z.string())`, and the transformations are
+ * done using {@link String.split} and {@link Array.join}
+ */
+export const stringSplit = (separator) => z.codec(z.string(), z.array(z.string()), {
+    decode: (str) => str.split(separator),
+    encode: (arr) => arr.join(separator),
+});
+//# sourceMappingURL=string-split.js.map

package/lib/esm/codec/string-split.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"string-split.js","sourceRoot":"","sources":["../../../src/codec/string-split.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,SAAiB,EAAE,EAAE,CAC/C,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE;IACvC,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC;IACrC,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC;CACrC,CAAC,CAAC"}

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

@@ -10,4 +10,4 @@ import { z } from "zod";
  *
  * @see https://zod.dev/codecs#stringtoint
  */
-export declare const stringtoInteger: () => z.ZodCodec<z.core.$ZodBranded<z.ZodString, "IntegerString">, z.core.$ZodBranded<z.ZodInt, "Integer">>;
+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

@@ -2,7 +2,7 @@ import { z } from "zod";
 import { trusted } from "../lib.js";
 import { number } from "../number/index.js";
 import { string } from "../string/index.js";
-const stringToIntegerCodec = z.codec(string.integer(), number.integer(), {
+const codec = z.codec(string.integer(), number.integer(), {
     decode: (str) => Number.parseInt(str, 10),
     encode: (num) => trusted(num.toString()),
 });
@@ -17,5 +17,5 @@ const stringToIntegerCodec = z.codec(string.integer(), number.integer(), {
  *
  * @see https://zod.dev/codecs#stringtoint
  */
-export const stringtoInteger = () => stringToIntegerCodec;
+export const stringToInteger = () => codec;
 //# sourceMappingURL=string-to-integer.js.map

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

@@ -1 +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,WAAW,CAAC;AACpC,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC5C,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAE5C,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,EAAE,EAAE,MAAM,CAAC,OAAO,EAAE,EAAE;IACvE,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"}
+{"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,WAAW,CAAC;AACpC,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC5C,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAE5C,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,EAAE,EAAE,MAAM,CAAC,OAAO,EAAE,EAAE;IACxD,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,KAAK,CAAC"}

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

@@ -0,0 +1,6 @@
+/**
+ * A string to JSON codec.
+ *
+ * @returns A string to JSON codec.
+ */
+export declare const 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>>>;

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

@@ -0,0 +1,10 @@
+import { json } from "../json/index.js";
+import { jsonParse } from "./json-parse.js";
+const codec = jsonParse(json());
+/**
+ * A string to JSON codec.
+ *
+ * @returns A string to JSON codec.
+ */
+export const stringToJson = () => codec;
+//# sourceMappingURL=string-to-json.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"string-to-json.js","sourceRoot":"","sources":["../../../src/codec/string-to-json.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AACxC,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,MAAM,KAAK,GAAG,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC;AAEhC;;;;GAIG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,GAAG,EAAE,CAAC,KAAK,CAAC"}

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

@@ -1,7 +1,7 @@
 import { z } from "zod";
 import { trusted } from "../lib.js";
 import { string } from "../string/index.js";
-const stringToURLCodec = z.codec(string.url(), z.instanceof(URL), {
+const codec = z.codec(string.url(), z.instanceof(URL), {
     decode: (urlString) => new URL(urlString),
     encode: (url) => trusted(url.href),
 });
@@ -12,5 +12,5 @@ const stringToURLCodec = z.codec(string.url(), z.instanceof(URL), {
  *
  * @see https://zod.dev/codecs#stringtourl
  */
-export const stringToUrl = () => stringToURLCodec;
+export const stringToUrl = () => codec;
 //# sourceMappingURL=string-to-url.js.map

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

@@ -1 +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"}
+{"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,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE;IACrD,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,KAAK,CAAC"}

package/lib/esm/index.d.ts

@@ -38,7 +38,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>;
         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>>;
     };
     geojson: typeof import("./geojson/geojson.js").geojson & {
@@ -64,17 +66,17 @@ declare const zu: {
             }>, "IsoAlpha3CountryCode">;
         };
     };
-    json: typeof import("./json/json.js").json & {
-        array: typeof import("./json/json.js").array;
-        object: typeof import("./json/json.js").object;
-        primitive: typeof import("./json/json.js").primitive;
-        stringified: typeof import("./json/json.js").stringifiedJson;
+    json: (() => z.ZodType<import("./json/json.js").Json, unknown, z.core.$ZodTypeInternals<import("./json/json.js").Json, unknown>>) & {
+        array: () => z.ZodArray<z.ZodType<import("./json/json.js").Json, unknown, z.core.$ZodTypeInternals<import("./json/json.js").Json, unknown>>>;
+        object: () => z.ZodRecord<z.ZodString, z.ZodType<import("./json/json.js").Json, unknown, z.core.$ZodTypeInternals<import("./json/json.js").Json, unknown>>>;
+        primitive: () => z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>;
     };
     number: {
         integer: () => z.core.$ZodBranded<z.ZodInt, "Integer">;
     };
     string: {
         integer: () => z.core.$ZodBranded<z.ZodString, "IntegerString">;
+        json: () => z.core.$ZodBranded<z.ZodString, "JsonString">;
         url: () => z.core.$ZodBranded<z.ZodURL, "UrlString">;
     };
     isValid: typeof isValid;

package/lib/esm/json/array.d.ts

@@ -0,0 +1,4 @@
+import { z } from "zod";
+import { type Json } from "./json.js";
+export type JsonArray = Array<Json>;
+export declare const array: () => z.ZodArray<z.ZodType<Json, unknown, z.core.$ZodTypeInternals<Json, unknown>>>;

package/lib/esm/json/array.js

@@ -0,0 +1,5 @@
+import { z } from "zod";
+import { json } from "./json.js";
+const schema = z.array(json());
+export const array = () => schema;
+//# sourceMappingURL=array.js.map

package/lib/esm/json/array.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"array.js","sourceRoot":"","sources":["../../../src/json/array.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAa,IAAI,EAAE,MAAM,WAAW,CAAC;AAE5C,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;AAI/B,MAAM,CAAC,MAAM,KAAK,GAAG,GAAG,EAAE,CAAC,MAAM,CAAC"}

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

@@ -1,8 +1,6 @@
-import { array, json, object, primitive, stringifiedJson } from "./json.js";
-declare const module: typeof json & {
-    array: typeof array;
-    object: typeof object;
-    primitive: typeof primitive;
-    stringified: typeof stringifiedJson;
+declare const module: (() => import("zod").ZodType<import("./json.js").Json, unknown, import("zod/v4/core").$ZodTypeInternals<import("./json.js").Json, unknown>>) & {
+    array: () => import("zod").ZodArray<import("zod").ZodType<import("./json.js").Json, unknown, import("zod/v4/core").$ZodTypeInternals<import("./json.js").Json, unknown>>>;
+    object: () => import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodType<import("./json.js").Json, unknown, import("zod/v4/core").$ZodTypeInternals<import("./json.js").Json, unknown>>>;
+    primitive: () => import("zod").ZodUnion<readonly [import("zod").ZodString, import("zod").ZodNumber, import("zod").ZodBoolean, import("zod").ZodNull]>;
 };
 export { module as json };

package/lib/esm/json/index.js

@@ -1,9 +1,11 @@
-import { array, json, object, primitive, stringifiedJson } from "./json.js";
+import { array } from "./array.js";
+import { json } from "./json.js";
+import { object } from "./object.js";
+import { primitive } from "./primitive.js";
 const module = Object.assign(json, {
     array,
     object,
     primitive,
-    stringified: stringifiedJson,
 });
 export { module as json };
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/json/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAE5E,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE;IACjC,KAAK;IACL,MAAM;IACN,SAAS;IACT,WAAW,EAAE,eAAe;CAC7B,CAAC,CAAC;AAEH,OAAO,EAAE,MAAM,IAAI,IAAI,EAAE,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/json/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3C,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE;IACjC,KAAK;IACL,MAAM;IACN,SAAS;CACV,CAAC,CAAC;AAEH,OAAO,EAAE,MAAM,IAAI,IAAI,EAAE,CAAC"}

package/lib/esm/json/json.d.ts

@@ -1,15 +1,6 @@
 import { z } from "zod";
-declare const primitiveSchema: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>;
-export type JsonPrimitive = z.infer<typeof primitiveSchema>;
-export declare function primitive(): z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>;
-export type JsonObject = {
-    [key: string]: Json;
-};
-export type JsonArray = Array<Json>;
+import type { JsonArray } from "./array.js";
+import type { JsonObject } from "./object.js";
+import { type JsonPrimitive } from "./primitive.js";
 export type Json = JsonPrimitive | JsonObject | JsonArray;
-export declare function json(): z.ZodType<Json, unknown, z.core.$ZodTypeInternals<Json, unknown>>;
-export declare function object(): z.ZodRecord<z.ZodString, z.ZodType<Json, unknown, z.core.$ZodTypeInternals<Json, unknown>>>;
-export declare function array(): z.ZodArray<z.ZodType<Json, unknown, z.core.$ZodTypeInternals<Json, unknown>>>;
-export declare const stringifiedJsonSchema: z.ZodType<Json, string>;
-export declare function stringifiedJson(): z.ZodType<Json, string, z.core.$ZodTypeInternals<Json, string>>;
-export {};
+export declare const json: () => z.ZodType<Json, unknown, z.core.$ZodTypeInternals<Json, unknown>>;

package/lib/esm/json/json.js

@@ -1,38 +1,5 @@
 import { z } from "zod";
-const primitiveSchema = z.union([
-    z.string(),
-    z.number(),
-    z.boolean(),
-    z.null(),
-]);
-export function primitive() {
-    return primitiveSchema;
-}
-const jsonSchema = z.lazy(() => z.union([primitive(), z.array(jsonSchema), z.record(z.string(), jsonSchema)]));
-export function json() {
-    return jsonSchema;
-}
-const objectSchema = z.record(z.string(), jsonSchema);
-export function object() {
-    return objectSchema;
-}
-const arraySchema = z.array(jsonSchema);
-export function array() {
-    return arraySchema;
-}
-// TODO: codec stringToJson.
-export const stringifiedJsonSchema = z
-    .string()
-    .transform((str, ctx) => {
-    try {
-        return JSON.parse(str);
-    }
-    catch {
-        ctx.addIssue({ code: "custom", message: "Invalid JSON" });
-        return z.NEVER;
-    }
-});
-export function stringifiedJson() {
-    return stringifiedJsonSchema;
-}
+import { primitive } from "./primitive.js";
+const schema = z.lazy(() => z.union([primitive(), z.array(schema), z.record(z.string(), schema)]));
+export const json = () => schema;
 //# sourceMappingURL=json.js.map

package/lib/esm/json/json.js.map

@@ -1 +1 @@
-{"version":3,"file":"json.js","sourceRoot":"","sources":["../../../src/json/json.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC;IAC9B,CAAC,CAAC,MAAM,EAAE;IACV,CAAC,CAAC,MAAM,EAAE;IACV,CAAC,CAAC,OAAO,EAAE;IACX,CAAC,CAAC,IAAI,EAAE;CACT,CAAC,CAAC;AAEH,MAAM,UAAU,SAAS;IACvB,OAAO,eAAe,CAAC;AACzB,CAAC;AAMD,MAAM,UAAU,GAAoB,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,CAC9C,CAAC,CAAC,KAAK,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,UAAU,CAAC,CAAC,CAAC,CAC9E,CAAC;AACF,MAAM,UAAU,IAAI;IAClB,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,UAAU,CAAC,CAAC;AACtD,MAAM,UAAU,MAAM;IACpB,OAAO,YAAY,CAAC;AACtB,CAAC;AAED,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;AACxC,MAAM,UAAU,KAAK;IACnB,OAAO,WAAW,CAAC;AACrB,CAAC;AAED,4BAA4B;AAC5B,MAAM,CAAC,MAAM,qBAAqB,GAA4B,CAAC;KAC5D,MAAM,EAAE;KACR,SAAS,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE;IACtB,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAS,CAAC;IACjC,CAAC;IAAC,MAAM,CAAC;QACP,GAAG,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,cAAc,EAAE,CAAC,CAAC;QAC1D,OAAO,CAAC,CAAC,KAAK,CAAC;IACjB,CAAC;AACH,CAAC,CAAC,CAAC;AAEL,MAAM,UAAU,eAAe;IAC7B,OAAO,qBAAqB,CAAC;AAC/B,CAAC"}
+{"version":3,"file":"json.js","sourceRoot":"","sources":["../../../src/json/json.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAsB,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE/D,MAAM,MAAM,GAAoB,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,CAC1C,CAAC,CAAC,KAAK,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,MAAM,CAAC,CAAC,CAAC,CACtE,CAAC;AAIF,MAAM,CAAC,MAAM,IAAI,GAAG,GAAG,EAAE,CAAC,MAAM,CAAC"}

package/lib/esm/json/object.d.ts

@@ -0,0 +1,6 @@
+import { z } from "zod";
+import { type Json } from "./json.js";
+export type JsonObject = {
+    [key: string]: Json;
+};
+export declare const object: () => z.ZodRecord<z.ZodString, z.ZodType<Json, unknown, z.core.$ZodTypeInternals<Json, unknown>>>;

package/lib/esm/json/object.js

@@ -0,0 +1,5 @@
+import { z } from "zod";
+import { json } from "./json.js";
+const schema = z.record(z.string(), json());
+export const object = () => schema;
+//# sourceMappingURL=object.js.map

package/lib/esm/json/object.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"object.js","sourceRoot":"","sources":["../../../src/json/object.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAa,IAAI,EAAE,MAAM,WAAW,CAAC;AAE5C,MAAM,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;AAI5C,MAAM,CAAC,MAAM,MAAM,GAAG,GAAG,EAAE,CAAC,MAAM,CAAC"}

package/lib/esm/json/primitive.d.ts

@@ -0,0 +1,5 @@
+import { z } from "zod";
+declare const schema: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>;
+export type JsonPrimitive = z.infer<typeof schema>;
+export declare const primitive: () => z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>;
+export {};

package/lib/esm/json/primitive.js

@@ -0,0 +1,4 @@
+import { z } from "zod";
+const schema = z.union([z.string(), z.number(), z.boolean(), z.null()]);
+export const primitive = () => schema;
+//# sourceMappingURL=primitive.js.map

package/lib/esm/json/primitive.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"primitive.js","sourceRoot":"","sources":["../../../src/json/primitive.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;AAIxE,MAAM,CAAC,MAAM,SAAS,GAAG,GAAG,EAAE,CAAC,MAAM,CAAC"}

package/lib/esm/json/types.d.ts

@@ -1 +1,4 @@
-export type { Json, JsonArray, JsonObject, JsonPrimitive } from "./json.js";
+export type { JsonArray } from "./array.js";
+export type { Json } from "./json.js";
+export type { JsonObject } from "./object.js";
+export type { JsonPrimitive } from "./primitive.js";

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

@@ -1,5 +1,6 @@
 declare const string: {
     integer: () => import("zod/v4/core").$ZodBranded<import("zod").ZodString, "IntegerString">;
+    json: () => import("zod/v4/core").$ZodBranded<import("zod").ZodString, "JsonString">;
     url: () => import("zod/v4/core").$ZodBranded<import("zod").ZodURL, "UrlString">;
 };
 export { string };

package/lib/esm/string/index.js

@@ -1,7 +1,9 @@
 import { integer } from "./integer.js";
+import { json } from "./json.js";
 import { url } from "./url.js";
 const string = {
     integer,
+    json,
     url,
 };
 export { string };

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/string/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAE/B,MAAM,MAAM,GAAG;IACb,OAAO;IACP,GAAG;CACJ,CAAC;AAEF,OAAO,EAAE,MAAM,EAAE,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/string/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAE/B,MAAM,MAAM,GAAG;IACb,OAAO;IACP,IAAI;IACJ,GAAG;CACJ,CAAC;AAEF,OAAO,EAAE,MAAM,EAAE,CAAC"}

package/lib/esm/string/json.d.ts

@@ -0,0 +1,9 @@
+import { z } from "zod";
+declare const schema: z.core.$ZodBranded<z.ZodString, "JsonString">;
+export type JsonString = z.infer<typeof schema>;
+/**
+ * @returns A schema that validates its input as a JSON string and returns a {@link JsonString}
+ * upon success.
+ */
+export declare const json: () => z.core.$ZodBranded<z.ZodString, "JsonString">;
+export {};

package/lib/esm/string/json.js

@@ -0,0 +1,19 @@
+import { z } from "zod";
+const schema = z
+    .string()
+    .refine((s) => {
+    try {
+        JSON.parse(s);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}, { error: "invalid JSON string" })
+    .brand("JsonString");
+/**
+ * @returns A schema that validates its input as a JSON string and returns a {@link JsonString}
+ * upon success.
+ */
+export const json = () => schema;
+//# sourceMappingURL=json.js.map

package/lib/esm/string/json.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.js","sourceRoot":"","sources":["../../../src/string/json.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,MAAM,GAAG,CAAC;KACb,MAAM,EAAE;KACR,MAAM,CACL,CAAC,CAAC,EAAE,EAAE;IACJ,IAAI,CAAC;QACH,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QACd,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC,EACD,EAAE,KAAK,EAAE,qBAAqB,EAAE,CACjC;KACA,KAAK,CAAC,YAAY,CAAC,CAAC;AAIvB;;;GAGG;AACH,MAAM,CAAC,MAAM,IAAI,GAAG,GAAG,EAAE,CAAC,MAAM,CAAC"}

package/lib/esm/string/types.d.ts

@@ -1,2 +1,3 @@
 export { IntegerString } from "./integer.js";
+export { JsonString } from "./json.js";
 export { UrlString } from "./url.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@infra-blocks/zod-utils",
-  "version": "0.20.0-alpha.3",
+  "version": "0.21.0-alpha.0",
   "description": "Extensions to the zod package.",
   "keywords": [
     "zod",