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

package/README.md

@@ -57,7 +57,7 @@ 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.
+to do so. It uses `zu.codec.stringSplit(",")` internally.
 
 ```typescript
 import { zu } from "@infra-blocks/zod-utils";
@@ -65,6 +65,18 @@ import { zu } from "@infra-blocks/zod-utils";
 const items = zu.codec.csv().parse("one,two,three"); // items is ["one", "two", "three"]
 ```
 
+#### jsonParse
+
+The `zu.codec.jsonParse(schema)` utility is a factory returning a codec where the first schema is
+`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).
+
+#### stringSplit
+
+The `zu.codec.stringSplit(separator)` utility is a factory returning a codec where the first schema is
+`z.string()`, the second schema is `z.array(z.string())`, and the transformations back and forth
+are accomplished using `String.split` and `Array.join` respectively, using the provided separator.
+
 #### stringToInteger
 
 The `zu.codec.stringToInteger()` codec is taken almost verbatim
@@ -78,6 +90,18 @@ import { Integer } from "@infra-blocks/zod-utils";
 const item: Integer = zu.codec.stringToInteger().parse("1234");
 ```
 
+#### stringToJson
+
+The `zu.codec.stringToJson()` codec transforms a string into JSON using JSON.parse.
+It uses `zu.codec.jsonParse(zu.json())` internally.
+
+```typescript
+import { zu } from "@infra-blocks/zod-utils";
+import type { Json } from "@infra-blocks/zod-utils/json";
+
+const item: Json = zu.codec.stringToJson().parse('[1, "word", null]');
+```
+
 #### stringToUrl
 
 The `zu.codec.stringToUrl()` codec is taken [Zod's own documentation](https://zod.dev/codecs#stringtourl).
@@ -253,7 +277,7 @@ zu.iso.countryCode.alpha3("CAN"); // Its communist little brother.
 
 ### json
 
-The `json` module contains utilities to validate JSON objects and stringified JSON objects.
+The `json` module contains utilities to validate JSON objects, arrays and primitives.
 
 ````typescript
 import { zu } from "@infra-blocks/zod-utils";
@@ -280,11 +304,6 @@ zu.json().parse(undefined); // Boom.
 zu.json().parse(Symbol("nope")); // Boom.
 zu.json().parse(new Set()); // Boom.
 // etc...
-
-// You can also parse stringified JSON!
-zu.json.stringified().parse("5"); // Returns the number 5.
-zu.json.stringified().parse('"JSON string"'); // Returns "JSON string". Note the quotes were removed.
-zu.json.stringified().parse(JSON.strinfify({ field: "value" })); // Returns {field: "value"}.
 ````
 
 #### Sub schemas & Types
@@ -350,6 +369,18 @@ expectTypeOf(result).toEqualTypeOf<IntegerString>();
 expect(result).to.equal("1234");
 ```
 
+#### json
+
+```typescript
+import { zu } from "@infra-blocks/zod-utils";
+import { JsonString } from "@infra-blocks/zod-utils/string";
+import { expectTypeOf } from "expect-type";
+
+const result = zu.string.json().parse('[1, "word", null]');
+expectTypeOf(result).toEqualTypeOf<UrlString>();
+expect(result).to.equal('[1, "word", null]');
+```
+
 ### Type Guard
 
 The `typeGuard` utility allows to obtain a function that will act as a type guard for the type

package/lib/cjs/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/cjs/codec/csv.js

@@ -1,15 +1,13 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.csv = void 0;
-const zod_1 = require("zod");
-const codec = zod_1.z.codec(zod_1.z.string(), zod_1.z.array(zod_1.z.string()), {
-    decode: (str) => str.split(","),
-    encode: (arr) => arr.join(","),
-});
+const string_split_js_1 = require("./string-split.js");
+const codec = (0, string_split_js_1.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/cjs/codec/csv.js.map

@@ -1 +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"}
+{"version":3,"file":"csv.js","sourceRoot":"","sources":["../../../src/codec/csv.ts"],"names":[],"mappings":";;;AAAA,uDAAgD;AAEhD,MAAM,KAAK,GAAG,IAAA,6BAAW,EAAC,GAAG,CAAC,CAAC;AAE/B;;;;;;;GAOG;AACI,MAAM,GAAG,GAAG,GAAG,EAAE,CAAC,KAAK,CAAC;AAAlB,QAAA,GAAG,OAAe"}

package/lib/cjs/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/cjs/codec/index.js

@@ -2,11 +2,15 @@
 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 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,
-    stringtoInteger: string_to_integer_js_1.stringtoInteger,
+    jsonParse: json_parse_js_1.jsonParse,
+    stringtoInteger: string_to_integer_js_1.stringToInteger,
+    stringToJson: string_to_json_js_1.stringToJson,
     stringToUrl: string_to_url_js_1.stringToUrl,
 };
 exports.codec = codec;

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,iEAAyD;AACzD,yDAAiD;AAEjD,MAAM,KAAK,GAAG;IACZ,GAAG,EAAH,YAAG;IACH,eAAe,EAAf,sCAAe;IACf,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,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"}

package/lib/cjs/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/cjs/codec/json-parse.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.jsonParse = void 0;
+const zod_1 = require("zod");
+const lib_js_1 = require("../lib.js");
+const index_js_1 = require("../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.
+ */
+const jsonParse = (schema) => zod_1.z.codec(index_js_1.string.json(), schema, {
+    decode: (str) => JSON.parse(str),
+    encode: (json) => (0, lib_js_1.trusted)(JSON.stringify(json)),
+});
+exports.jsonParse = jsonParse;
+//# sourceMappingURL=json-parse.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"json-parse.js","sourceRoot":"","sources":["../../../src/codec/json-parse.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,sCAAoC;AACpC,iDAA4C;AAE5C;;;;;;;GAOG;AACI,MAAM,SAAS,GAAG,CAAsB,MAAS,EAAE,EAAE,CAC1D,OAAC,CAAC,KAAK,CAAC,iBAAM,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,IAAA,gBAAO,EAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;CAChD,CAAC,CAAC;AAJQ,QAAA,SAAS,aAIjB"}

package/lib/cjs/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/cjs/codec/string-split.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.stringSplit = void 0;
+const zod_1 = require("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}
+ */
+const stringSplit = (separator) => zod_1.z.codec(zod_1.z.string(), zod_1.z.array(zod_1.z.string()), {
+    decode: (str) => str.split(separator),
+    encode: (arr) => arr.join(separator),
+});
+exports.stringSplit = stringSplit;
+//# sourceMappingURL=string-split.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"string-split.js","sourceRoot":"","sources":["../../../src/codec/string-split.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AAExB;;;;;;;;;;GAUG;AACI,MAAM,WAAW,GAAG,CAAC,SAAiB,EAAE,EAAE,CAC/C,OAAC,CAAC,KAAK,CAAC,OAAC,CAAC,MAAM,EAAE,EAAE,OAAC,CAAC,KAAK,CAAC,OAAC,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;AAJQ,QAAA,WAAW,eAInB"}

package/lib/cjs/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/cjs/codec/string-to-integer.js

@@ -1,11 +1,11 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.stringtoInteger = void 0;
+exports.stringToInteger = void 0;
 const zod_1 = require("zod");
 const lib_js_1 = require("../lib.js");
 const index_js_1 = require("../number/index.js");
 const index_js_2 = require("../string/index.js");
-const stringToIntegerCodec = zod_1.z.codec(index_js_2.string.integer(), index_js_1.number.integer(), {
+const codec = zod_1.z.codec(index_js_2.string.integer(), index_js_1.number.integer(), {
     decode: (str) => Number.parseInt(str, 10),
     encode: (num) => (0, lib_js_1.trusted)(num.toString()),
 });
@@ -20,6 +20,6 @@ const stringToIntegerCodec = zod_1.z.codec(index_js_2.string.integer(), index_js
  *
  * @see https://zod.dev/codecs#stringtoint
  */
-const stringtoInteger = () => stringToIntegerCodec;
-exports.stringtoInteger = stringtoInteger;
+const stringToInteger = () => codec;
+exports.stringToInteger = stringToInteger;
 //# sourceMappingURL=string-to-integer.js.map

package/lib/cjs/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,6BAAwB;AAExB,sCAAoC;AACpC,iDAA4C;AAC5C,iDAA4C;AAE5C,MAAM,oBAAoB,GAAG,OAAC,CAAC,KAAK,CAAC,iBAAM,CAAC,OAAO,EAAE,EAAE,iBAAM,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,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"}
+{"version":3,"file":"string-to-integer.js","sourceRoot":"","sources":["../../../src/codec/string-to-integer.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AAExB,sCAAoC;AACpC,iDAA4C;AAC5C,iDAA4C;AAE5C,MAAM,KAAK,GAAG,OAAC,CAAC,KAAK,CAAC,iBAAM,CAAC,OAAO,EAAE,EAAE,iBAAM,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,IAAA,gBAAO,EAAC,GAAG,CAAC,QAAQ,EAAE,CAAC;CACzC,CAAC,CAAC;AAEH;;;;;;;;;;GAUG;AACI,MAAM,eAAe,GAAG,GAAG,EAAE,CAAC,KAAK,CAAC;AAA9B,QAAA,eAAe,mBAAe"}

package/lib/cjs/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/cjs/codec/string-to-json.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.stringToJson = void 0;
+const index_js_1 = require("../json/index.js");
+const json_parse_js_1 = require("./json-parse.js");
+const codec = (0, json_parse_js_1.jsonParse)((0, index_js_1.json)());
+/**
+ * A string to JSON codec.
+ *
+ * @returns A string to JSON codec.
+ */
+const stringToJson = () => codec;
+exports.stringToJson = stringToJson;
+//# sourceMappingURL=string-to-json.js.map

package/lib/cjs/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,+CAAwC;AACxC,mDAA4C;AAE5C,MAAM,KAAK,GAAG,IAAA,yBAAS,EAAC,IAAA,eAAI,GAAE,CAAC,CAAC;AAEhC;;;;GAIG;AACI,MAAM,YAAY,GAAG,GAAG,EAAE,CAAC,KAAK,CAAC;AAA3B,QAAA,YAAY,gBAAe"}

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

@@ -4,7 +4,7 @@ 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), {
+const codec = 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),
 });
@@ -15,6 +15,6 @@ const stringToURLCodec = zod_1.z.codec(index_js_1.string.url(), zod_1.z.instance
  *
  * @see https://zod.dev/codecs#stringtourl
  */
-const stringToUrl = () => stringToURLCodec;
+const stringToUrl = () => codec;
 exports.stringToUrl = stringToUrl;
 //# sourceMappingURL=string-to-url.js.map

package/lib/cjs/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,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"}
+{"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,KAAK,GAAG,OAAC,CAAC,KAAK,CAAC,iBAAM,CAAC,GAAG,EAAE,EAAE,OAAC,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,IAAA,gBAAO,EAAC,GAAG,CAAC,IAAI,CAAC;CACnC,CAAC,CAAC;AAEH;;;;;;GAMG;AACI,MAAM,WAAW,GAAG,GAAG,EAAE,CAAC,KAAK,CAAC;AAA1B,QAAA,WAAW,eAAe"}

package/lib/cjs/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/cjs/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/cjs/json/array.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.array = void 0;
+const zod_1 = require("zod");
+const json_js_1 = require("./json.js");
+const schema = zod_1.z.array((0, json_js_1.json)());
+const array = () => schema;
+exports.array = array;
+//# sourceMappingURL=array.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"array.js","sourceRoot":"","sources":["../../../src/json/array.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,uCAA4C;AAE5C,MAAM,MAAM,GAAG,OAAC,CAAC,KAAK,CAAC,IAAA,cAAI,GAAE,CAAC,CAAC;AAIxB,MAAM,KAAK,GAAG,GAAG,EAAE,CAAC,MAAM,CAAC;AAArB,QAAA,KAAK,SAAgB"}

package/lib/cjs/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/cjs/json/index.js

@@ -1,12 +1,14 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.json = void 0;
+const array_js_1 = require("./array.js");
 const json_js_1 = require("./json.js");
+const object_js_1 = require("./object.js");
+const primitive_js_1 = require("./primitive.js");
 const module = Object.assign(json_js_1.json, {
-    array: json_js_1.array,
-    object: json_js_1.object,
-    primitive: json_js_1.primitive,
-    stringified: json_js_1.stringifiedJson,
+    array: array_js_1.array,
+    object: object_js_1.object,
+    primitive: primitive_js_1.primitive,
 });
 exports.json = module;
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/json/index.ts"],"names":[],"mappings":";;;AAAA,uCAA4E;AAE5E,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,cAAI,EAAE;IACjC,KAAK,EAAL,eAAK;IACL,MAAM,EAAN,gBAAM;IACN,SAAS,EAAT,mBAAS;IACT,WAAW,EAAE,yBAAe;CAC7B,CAAC,CAAC;AAEgB,sBAAI"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/json/index.ts"],"names":[],"mappings":";;;AAAA,yCAAmC;AACnC,uCAAiC;AACjC,2CAAqC;AACrC,iDAA2C;AAE3C,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,cAAI,EAAE;IACjC,KAAK,EAAL,gBAAK;IACL,MAAM,EAAN,kBAAM;IACN,SAAS,EAAT,wBAAS;CACV,CAAC,CAAC;AAEgB,sBAAI"}

package/lib/cjs/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/cjs/json/json.js

@@ -1,46 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.stringifiedJsonSchema = void 0;
-exports.primitive = primitive;
-exports.json = json;
-exports.object = object;
-exports.array = array;
-exports.stringifiedJson = stringifiedJson;
+exports.json = void 0;
 const zod_1 = require("zod");
-const primitiveSchema = zod_1.z.union([
-    zod_1.z.string(),
-    zod_1.z.number(),
-    zod_1.z.boolean(),
-    zod_1.z.null(),
-]);
-function primitive() {
-    return primitiveSchema;
-}
-const jsonSchema = zod_1.z.lazy(() => zod_1.z.union([primitive(), zod_1.z.array(jsonSchema), zod_1.z.record(zod_1.z.string(), jsonSchema)]));
-function json() {
-    return jsonSchema;
-}
-const objectSchema = zod_1.z.record(zod_1.z.string(), jsonSchema);
-function object() {
-    return objectSchema;
-}
-const arraySchema = zod_1.z.array(jsonSchema);
-function array() {
-    return arraySchema;
-}
-// TODO: codec stringToJson.
-exports.stringifiedJsonSchema = zod_1.z
-    .string()
-    .transform((str, ctx) => {
-    try {
-        return JSON.parse(str);
-    }
-    catch {
-        ctx.addIssue({ code: "custom", message: "Invalid JSON" });
-        return zod_1.z.NEVER;
-    }
-});
-function stringifiedJson() {
-    return exports.stringifiedJsonSchema;
-}
+const primitive_js_1 = require("./primitive.js");
+const schema = zod_1.z.lazy(() => zod_1.z.union([(0, primitive_js_1.primitive)(), zod_1.z.array(schema), zod_1.z.record(zod_1.z.string(), schema)]));
+const json = () => schema;
+exports.json = json;
 //# sourceMappingURL=json.js.map

package/lib/cjs/json/json.js.map

@@ -1 +1 @@
-{"version":3,"file":"json.js","sourceRoot":"","sources":["../../../src/json/json.ts"],"names":[],"mappings":";;;AASA,8BAEC;AASD,oBAEC;AAGD,wBAEC;AAGD,sBAEC;AAcD,0CAEC;AAhDD,6BAAwB;AAExB,MAAM,eAAe,GAAG,OAAC,CAAC,KAAK,CAAC;IAC9B,OAAC,CAAC,MAAM,EAAE;IACV,OAAC,CAAC,MAAM,EAAE;IACV,OAAC,CAAC,OAAO,EAAE;IACX,OAAC,CAAC,IAAI,EAAE;CACT,CAAC,CAAC;AAEH,SAAgB,SAAS;IACvB,OAAO,eAAe,CAAC;AACzB,CAAC;AAMD,MAAM,UAAU,GAAoB,OAAC,CAAC,IAAI,CAAC,GAAG,EAAE,CAC9C,OAAC,CAAC,KAAK,CAAC,CAAC,SAAS,EAAE,EAAE,OAAC,CAAC,KAAK,CAAC,UAAU,CAAC,EAAE,OAAC,CAAC,MAAM,CAAC,OAAC,CAAC,MAAM,EAAE,EAAE,UAAU,CAAC,CAAC,CAAC,CAC9E,CAAC;AACF,SAAgB,IAAI;IAClB,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,MAAM,YAAY,GAAG,OAAC,CAAC,MAAM,CAAC,OAAC,CAAC,MAAM,EAAE,EAAE,UAAU,CAAC,CAAC;AACtD,SAAgB,MAAM;IACpB,OAAO,YAAY,CAAC;AACtB,CAAC;AAED,MAAM,WAAW,GAAG,OAAC,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;AACxC,SAAgB,KAAK;IACnB,OAAO,WAAW,CAAC;AACrB,CAAC;AAED,4BAA4B;AACf,QAAA,qBAAqB,GAA4B,OAAC;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,OAAC,CAAC,KAAK,CAAC;IACjB,CAAC;AACH,CAAC,CAAC,CAAC;AAEL,SAAgB,eAAe;IAC7B,OAAO,6BAAqB,CAAC;AAC/B,CAAC"}
+{"version":3,"file":"json.js","sourceRoot":"","sources":["../../../src/json/json.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AAGxB,iDAA+D;AAE/D,MAAM,MAAM,GAAoB,OAAC,CAAC,IAAI,CAAC,GAAG,EAAE,CAC1C,OAAC,CAAC,KAAK,CAAC,CAAC,IAAA,wBAAS,GAAE,EAAE,OAAC,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,OAAC,CAAC,MAAM,CAAC,OAAC,CAAC,MAAM,EAAE,EAAE,MAAM,CAAC,CAAC,CAAC,CACtE,CAAC;AAIK,MAAM,IAAI,GAAG,GAAG,EAAE,CAAC,MAAM,CAAC;AAApB,QAAA,IAAI,QAAgB"}

package/lib/cjs/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/cjs/json/object.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.object = void 0;
+const zod_1 = require("zod");
+const json_js_1 = require("./json.js");
+const schema = zod_1.z.record(zod_1.z.string(), (0, json_js_1.json)());
+const object = () => schema;
+exports.object = object;
+//# sourceMappingURL=object.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"object.js","sourceRoot":"","sources":["../../../src/json/object.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,uCAA4C;AAE5C,MAAM,MAAM,GAAG,OAAC,CAAC,MAAM,CAAC,OAAC,CAAC,MAAM,EAAE,EAAE,IAAA,cAAI,GAAE,CAAC,CAAC;AAIrC,MAAM,MAAM,GAAG,GAAG,EAAE,CAAC,MAAM,CAAC;AAAtB,QAAA,MAAM,UAAgB"}

package/lib/cjs/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/cjs/json/primitive.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.primitive = void 0;
+const zod_1 = require("zod");
+const schema = zod_1.z.union([zod_1.z.string(), zod_1.z.number(), zod_1.z.boolean(), zod_1.z.null()]);
+const primitive = () => schema;
+exports.primitive = primitive;
+//# sourceMappingURL=primitive.js.map

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

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

package/lib/cjs/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/cjs/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/cjs/string/index.js

@@ -2,9 +2,11 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.string = void 0;
 const integer_js_1 = require("./integer.js");
+const json_js_1 = require("./json.js");
 const url_js_1 = require("./url.js");
 const string = {
     integer: integer_js_1.integer,
+    json: json_js_1.json,
     url: url_js_1.url,
 };
 exports.string = string;

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/string/index.ts"],"names":[],"mappings":";;;AAAA,6CAAuC;AACvC,qCAA+B;AAE/B,MAAM,MAAM,GAAG;IACb,OAAO,EAAP,oBAAO;IACP,GAAG,EAAH,YAAG;CACJ,CAAC;AAEO,wBAAM"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/string/index.ts"],"names":[],"mappings":";;;AAAA,6CAAuC;AACvC,uCAAiC;AACjC,qCAA+B;AAE/B,MAAM,MAAM,GAAG;IACb,OAAO,EAAP,oBAAO;IACP,IAAI,EAAJ,cAAI;IACJ,GAAG,EAAH,YAAG;CACJ,CAAC;AAEO,wBAAM"}

package/lib/cjs/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/cjs/string/json.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.json = void 0;
+const zod_1 = require("zod");
+const schema = zod_1.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.
+ */
+const json = () => schema;
+exports.json = json;
+//# sourceMappingURL=json.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"json.js","sourceRoot":"","sources":["../../../src/string/json.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AAExB,MAAM,MAAM,GAAG,OAAC;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;AACI,MAAM,IAAI,GAAG,GAAG,EAAE,CAAC,MAAM,CAAC;AAApB,QAAA,IAAI,QAAgB"}