@infra-blocks/zod-utils 0.17.0 → 0.18.0-alpha.0

package/lib/cjs/index.d.ts

@@ -19,7 +19,7 @@ declare function stringtoInteger(): z.ZodCodec<z.core.$ZodBranded<z.ZodString, "
  *
  * @see https://zod.dev/codecs#stringtourl
  */
-declare function stringToUrl(): z.ZodCodec<z.ZodURL, z.ZodCustom<import("url").URL, import("url").URL>>;
+declare function stringToUrl(): z.ZodCodec<z.core.$ZodBranded<z.ZodURL, "UrlString">, z.ZodCustom<import("url").URL, import("url").URL>>;
 /**
  * Returns a type guard function using the provided schema as the source of truth.
  *
@@ -87,6 +87,7 @@ declare const zu: {
     };
     string: {
         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;

package/lib/cjs/index.js

@@ -9,9 +9,13 @@ 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) => num.toString(),
+    encode: (num) => trusted(num.toString()),
 });
 /**
  * A string to integer codec.
@@ -27,9 +31,9 @@ const stringToIntegerCodec = zod_1.z.codec(index_js_5.string.integer(), (0, inte
 function stringtoInteger() {
     return stringToIntegerCodec;
 }
-const stringToURLCodec = zod_1.z.codec(zod_1.z.url(), zod_1.z.instanceof(URL), {
+const stringToURLCodec = zod_1.z.codec(index_js_5.string.url(), zod_1.z.instanceof(URL), {
     decode: (urlString) => new URL(urlString),
-    encode: (url) => url.href,
+    encode: (url) => trusted(url.href),
 });
 /**
  * A string to URL codec, as defined in Zod's documentation.

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;AAG3C,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,GAAG,CAAC,QAAQ,EAAmB;CACjD,CAAC,CAAC;AAEH;;;;;;;;;;GAUG;AACH,SAAS,eAAe;IACtB,OAAO,oBAAoB,CAAC;AAC9B,CAAC;AAED,MAAM,gBAAgB,GAAG,OAAC,CAAC,KAAK,CAAC,OAAC,CAAC,GAAG,EAAE,EAAE,OAAC,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE;IAC3D,MAAM,EAAE,CAAC,SAAS,EAAE,EAAE,CAAC,IAAI,GAAG,CAAC,SAAS,CAAC;IACzC,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI;CAC1B,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":";;;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"}

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

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

package/lib/cjs/string/index.js

@@ -2,8 +2,10 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.string = void 0;
 const integer_js_1 = require("./integer.js");
+const url_js_1 = require("./url.js");
 const string = {
     integer: integer_js_1.integer,
+    url: url_js_1.url,
 };
 exports.string = string;
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/string/index.ts"],"names":[],"mappings":";;;AAAA,6CAAuC;AAEvC,MAAM,MAAM,GAAG;IACb,OAAO,EAAP,oBAAO;CACR,CAAC;AAEO,wBAAM"}
+{"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"}

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

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

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

@@ -0,0 +1,9 @@
+import { z } from "zod";
+declare const schema: z.core.$ZodBranded<z.ZodURL, "UrlString">;
+export type UrlString = z.infer<typeof schema>;
+/**
+ * @returns A schema that uses `z.string().regex(z.regexes.integer)` internally and returns an {@link UrlString}
+ * upon success.
+ */
+export declare const url: () => z.core.$ZodBranded<z.ZodURL, "UrlString">;
+export {};

package/lib/cjs/string/url.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.url = void 0;
+const zod_1 = require("zod");
+const schema = zod_1.z.url().brand("UrlString");
+/**
+ * @returns A schema that uses `z.string().regex(z.regexes.integer)` internally and returns an {@link UrlString}
+ * upon success.
+ */
+const url = () => schema;
+exports.url = url;
+//# sourceMappingURL=url.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"url.js","sourceRoot":"","sources":["../../../src/string/url.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AAExB,MAAM,MAAM,GAAG,OAAC,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;AAI1C;;;GAGG;AACI,MAAM,GAAG,GAAG,GAAG,EAAE,CAAC,MAAM,CAAC;AAAnB,QAAA,GAAG,OAAgB"}

package/lib/esm/index.d.ts

@@ -19,7 +19,7 @@ declare function stringtoInteger(): z.ZodCodec<z.core.$ZodBranded<z.ZodString, "
  *
  * @see https://zod.dev/codecs#stringtourl
  */
-declare function stringToUrl(): z.ZodCodec<z.ZodURL, z.ZodCustom<import("url").URL, import("url").URL>>;
+declare function stringToUrl(): z.ZodCodec<z.core.$ZodBranded<z.ZodURL, "UrlString">, z.ZodCustom<import("url").URL, import("url").URL>>;
 /**
  * Returns a type guard function using the provided schema as the source of truth.
  *
@@ -87,6 +87,7 @@ declare const zu: {
     };
     string: {
         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;

package/lib/esm/index.js

@@ -6,9 +6,13 @@ 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) => num.toString(),
+    encode: (num) => trusted(num.toString()),
 });
 /**
  * A string to integer codec.
@@ -24,9 +28,9 @@ const stringToIntegerCodec = z.codec(string.integer(), integer(), {
 function stringtoInteger() {
     return stringToIntegerCodec;
 }
-const stringToURLCodec = z.codec(z.url(), z.instanceof(URL), {
+const stringToURLCodec = z.codec(string.url(), z.instanceof(URL), {
     decode: (urlString) => new URL(urlString),
-    encode: (url) => url.href,
+    encode: (url) => trusted(url.href),
 });
 /**
  * A string to URL codec, as defined in Zod's documentation.

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;AAG3C,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,GAAG,CAAC,QAAQ,EAAmB;CACjD,CAAC,CAAC;AAEH;;;;;;;;;;GAUG;AACH,SAAS,eAAe;IACtB,OAAO,oBAAoB,CAAC;AAC9B,CAAC;AAED,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE;IAC3D,MAAM,EAAE,CAAC,SAAS,EAAE,EAAE,CAAC,IAAI,GAAG,CAAC,SAAS,CAAC;IACzC,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI;CAC1B,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":"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"}

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

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

package/lib/esm/string/index.js

@@ -1,6 +1,8 @@
 import { integer } from "./integer.js";
+import { url } from "./url.js";
 const string = {
     integer,
+    url,
 };
 export { string };
 //# sourceMappingURL=index.js.map

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;AAEvC,MAAM,MAAM,GAAG;IACb,OAAO;CACR,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,GAAG,EAAE,MAAM,UAAU,CAAC;AAE/B,MAAM,MAAM,GAAG;IACb,OAAO;IACP,GAAG;CACJ,CAAC;AAEF,OAAO,EAAE,MAAM,EAAE,CAAC"}

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

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

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

@@ -0,0 +1,9 @@
+import { z } from "zod";
+declare const schema: z.core.$ZodBranded<z.ZodURL, "UrlString">;
+export type UrlString = z.infer<typeof schema>;
+/**
+ * @returns A schema that uses `z.string().regex(z.regexes.integer)` internally and returns an {@link UrlString}
+ * upon success.
+ */
+export declare const url: () => z.core.$ZodBranded<z.ZodURL, "UrlString">;
+export {};

package/lib/esm/string/url.js

@@ -0,0 +1,8 @@
+import { z } from "zod";
+const schema = z.url().brand("UrlString");
+/**
+ * @returns A schema that uses `z.string().regex(z.regexes.integer)` internally and returns an {@link UrlString}
+ * upon success.
+ */
+export const url = () => schema;
+//# sourceMappingURL=url.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"url.js","sourceRoot":"","sources":["../../../src/string/url.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,MAAM,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;AAI1C;;;GAGG;AACH,MAAM,CAAC,MAAM,GAAG,GAAG,GAAG,EAAE,CAAC,MAAM,CAAC"}

package/package.json

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