@naturalcycles/js-lib 15.12.0 → 15.14.0

package/dist/zod/zod.shared.schemas.d.ts

@@ -1,13 +1,16 @@
 import { z } from 'zod/v4';
 import type { IsoDate, UnixTimestamp, UnixTimestampMillis } from '../types.js';
+type ZodBranded<T, B> = T & Record<'_zod', Record<'output', number & B>>;
+export type ZodBrandedString<B> = ZodBranded<z.ZodString, B>;
+export type ZodBrandedInt<B> = ZodBranded<z.ZodInt, B>;
 export declare const TS_2500 = 16725225600;
 export declare const TS_2000 = 946684800;
-export declare const zUnixTimestamp: () => z.ZodCustom<UnixTimestamp>;
-export declare const zUnixTimestamp2000: () => z.ZodCustom<UnixTimestamp>;
-export declare const zUnixTimestampMillis: () => z.ZodCustom<UnixTimestampMillis>;
-export declare const zUnixTimestampMillis2000: () => z.ZodCustom<UnixTimestampMillis>;
+export declare const zUnixTimestamp: () => ZodBrandedInt<UnixTimestamp>;
+export declare const zUnixTimestamp2000: () => ZodBrandedInt<UnixTimestamp>;
+export declare const zUnixTimestampMillis: () => ZodBranded<z.ZodNumber, UnixTimestampMillis>;
+export declare const zUnixTimestampMillis2000: () => ZodBrandedInt<UnixTimestampMillis>;
 export declare const zSemVer: () => z.ZodString;
-export declare const zIsoDate: () => z.ZodCustom<IsoDate>;
+export declare const zIsoDate: () => ZodBrandedString<IsoDate>;
 export declare const zEmail: () => z.ZodEmail;
 export declare const BASE62_REGEX: RegExp;
 export declare const BASE64_REGEX: RegExp;
@@ -28,12 +31,13 @@ export declare const customZodSchemas: {
     base64Url: () => z.ZodString;
     email: () => z.ZodEmail;
     ianaTimezone: () => z.ZodEnum;
-    isoDate: () => z.ZodCustom<IsoDate>;
+    isoDate: () => ZodBrandedString<IsoDate>;
     jwt: () => z.ZodString;
     slug: () => z.ZodString;
     semver: () => z.ZodString;
-    unixTimestamp: () => z.ZodCustom<UnixTimestamp>;
-    unixTimestamp2000: () => z.ZodCustom<UnixTimestamp>;
-    unixTimestampMillis: () => z.ZodCustom<UnixTimestampMillis>;
-    unixTimestampMillis2000: () => z.ZodCustom<UnixTimestampMillis>;
+    unixTimestamp: () => ZodBrandedInt<UnixTimestamp>;
+    unixTimestamp2000: () => ZodBrandedInt<UnixTimestamp>;
+    unixTimestampMillis: () => ZodBranded<z.ZodNumber, UnixTimestampMillis>;
+    unixTimestampMillis2000: () => ZodBrandedInt<UnixTimestampMillis>;
 };
+export {};

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@naturalcycles/js-lib",
   "type": "module",
-  "version": "15.12.0",
+  "version": "15.14.0",
   "dependencies": {
     "tslib": "^2",
     "zod": "^3"

package/src/zod/zod.shared.schemas.ts

@@ -1,40 +1,44 @@
 import { z } from 'zod/v4'
 import type { IsoDate, UnixTimestamp, UnixTimestampMillis } from '../types.js'
 
+type ZodBranded<T, B> = T & Record<'_zod', Record<'output', number & B>>
+export type ZodBrandedString<B> = ZodBranded<z.ZodString, B>
+export type ZodBrandedInt<B> = ZodBranded<z.ZodInt, B>
+
 export const TS_2500 = 16725225600 // 2500-01-01
 export const TS_2000 = 946684800 // 2000-01-01
 
-export const zUnixTimestamp = (): z.ZodCustom<UnixTimestamp> =>
+export const zUnixTimestamp = (): ZodBrandedInt<UnixTimestamp> =>
   z
     .number()
     .int()
     .min(0)
     .max(TS_2500, 'Must be a UnixTimestamp number')
-    .describe('UnixTimestamp') as unknown as z.ZodCustom<UnixTimestamp>
+    .describe('UnixTimestamp') as ZodBrandedInt<UnixTimestamp>
 
-export const zUnixTimestamp2000 = (): z.ZodCustom<UnixTimestamp> =>
+export const zUnixTimestamp2000 = (): ZodBrandedInt<UnixTimestamp> =>
   z
     .number()
     .int()
     .min(TS_2000)
     .max(TS_2500, 'Must be a UnixTimestamp number after 2000-01-01')
-    .describe('UnixTimestamp2000') as unknown as z.ZodCustom<UnixTimestamp>
+    .describe('UnixTimestamp2000') as ZodBrandedInt<UnixTimestamp>
 
-export const zUnixTimestampMillis = (): z.ZodCustom<UnixTimestampMillis> =>
+export const zUnixTimestampMillis = (): ZodBranded<z.ZodNumber, UnixTimestampMillis> =>
   z
     .number()
     .int()
     .min(0)
     .max(TS_2500 * 1000, 'Must be a UnixTimestampMillis number')
-    .describe('UnixTimestampMillis') as unknown as z.ZodCustom<UnixTimestampMillis>
+    .describe('UnixTimestampMillis') as ZodBrandedInt<UnixTimestampMillis>
 
-export const zUnixTimestampMillis2000 = (): z.ZodCustom<UnixTimestampMillis> =>
+export const zUnixTimestampMillis2000 = (): ZodBrandedInt<UnixTimestampMillis> =>
   z
     .number()
     .int()
     .min(TS_2000 * 1000)
     .max(TS_2500 * 1000, 'Must be a UnixTimestampMillis number after 2000-01-01')
-    .describe('UnixTimestampMillis2000') as unknown as z.ZodCustom<UnixTimestampMillis>
+    .describe('UnixTimestampMillis2000') as ZodBrandedInt<UnixTimestampMillis>
 
 export const zSemVer = (): z.ZodString =>
   z
@@ -42,13 +46,13 @@ export const zSemVer = (): z.ZodString =>
     .regex(/^[0-9]+\.[0-9]+\.[0-9]+$/, 'Must be a SemVer string')
     .describe('SemVer')
 
-export const zIsoDate = (): z.ZodCustom<IsoDate> =>
+export const zIsoDate = (): ZodBrandedString<IsoDate> =>
   z
     .string()
     .refine(v => {
       return /^\d{4}-\d{2}-\d{2}$/.test(v)
     }, 'Must be an IsoDateString')
-    .describe('IsoDateString') as unknown as z.ZodCustom<IsoDate>
+    .describe('IsoDateString') as ZodBrandedString<IsoDate>
 
 export const zEmail = (): z.ZodEmail => z.email().describe('Email')