@naturalcycles/js-lib 14.128.1 → 14.129.0

package/dist/index.d.ts

@@ -59,7 +59,6 @@ export * from './is.util';
 export * from './typeFest';
 export * from './types';
 export * from './unit/size.util';
-import { is } from './vendor/is';
 export * from './log/commonLogger';
 export * from './string/safeJsonStringify';
 export * from './promise/pQueue';
@@ -77,4 +76,9 @@ export * from './datetime/timeInterval';
 export * from './http/http.model';
 export * from './http/fetcher';
 export * from './http/fetcher.model';
-export { is };
+export * from './zod/zod.util';
+export * from './zod/zod.shared.schemas';
+import { z, ZodSchema, ZodError, ZodIssue } from 'zod';
+import { is } from './vendor/is';
+export { is, z, ZodSchema, ZodError };
+export type { ZodIssue };

package/dist/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.is = void 0;
+exports.ZodError = exports.ZodSchema = exports.z = exports.is = void 0;
 const tslib_1 = require("tslib");
 tslib_1.__exportStar(require("./array/array.util"), exports);
 tslib_1.__exportStar(require("./lazy"), exports);
@@ -63,8 +63,6 @@ tslib_1.__exportStar(require("./is.util"), exports);
 tslib_1.__exportStar(require("./typeFest"), exports);
 tslib_1.__exportStar(require("./types"), exports);
 tslib_1.__exportStar(require("./unit/size.util"), exports);
-const is_1 = require("./vendor/is");
-Object.defineProperty(exports, "is", { enumerable: true, get: function () { return is_1.is; } });
 tslib_1.__exportStar(require("./log/commonLogger"), exports);
 tslib_1.__exportStar(require("./string/safeJsonStringify"), exports);
 tslib_1.__exportStar(require("./promise/pQueue"), exports);
@@ -82,3 +80,11 @@ tslib_1.__exportStar(require("./datetime/timeInterval"), exports);
 tslib_1.__exportStar(require("./http/http.model"), exports);
 tslib_1.__exportStar(require("./http/fetcher"), exports);
 tslib_1.__exportStar(require("./http/fetcher.model"), exports);
+tslib_1.__exportStar(require("./zod/zod.util"), exports);
+tslib_1.__exportStar(require("./zod/zod.shared.schemas"), exports);
+const zod_1 = require("zod");
+Object.defineProperty(exports, "z", { enumerable: true, get: function () { return zod_1.z; } });
+Object.defineProperty(exports, "ZodSchema", { enumerable: true, get: function () { return zod_1.ZodSchema; } });
+Object.defineProperty(exports, "ZodError", { enumerable: true, get: function () { return zod_1.ZodError; } });
+const is_1 = require("./vendor/is");
+Object.defineProperty(exports, "is", { enumerable: true, get: function () { return is_1.is; } });

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

@@ -0,0 +1,52 @@
+import { z } from 'zod';
+export declare const TS_2500 = 16725225600;
+export declare const TS_2000 = 946684800;
+export declare const zUnixTimestamp: z.ZodNumber;
+export declare const zUnixTimestamp2000: z.ZodNumber;
+export declare const zUnixTimestampMillis: z.ZodNumber;
+export declare const zUnixTimestampMillis2000: z.ZodNumber;
+export declare const zSemVer: z.ZodString;
+export declare const zIsoDateString: z.ZodEffects<z.ZodString, string, string>;
+export declare const zEmail: z.ZodEffects<z.ZodString, string, string>;
+export declare const BASE62_REGEX: RegExp;
+export declare const BASE64_REGEX: RegExp;
+export declare const BASE64URL_REGEX: RegExp;
+export declare const zBase62: z.ZodString;
+export declare const zBase64: z.ZodString;
+export declare const zBase64Url: z.ZodString;
+export declare const JWT_REGEX: RegExp;
+export declare const zJwt: z.ZodString;
+export declare const zId: z.ZodString;
+export declare const zIdBase62: z.ZodString;
+export declare const zIdBase64: z.ZodString;
+export declare const zIdBase64Url: z.ZodString;
+/**
+ * "Slug" - a valid URL, filename, etc.
+ */
+export declare const zSlug: z.ZodString;
+export declare const zBaseDBEntity: z.ZodObject<{
+    id: z.ZodOptional<z.ZodString>;
+    created: z.ZodOptional<z.ZodNumber>;
+    updated: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    id?: string | undefined;
+    created?: number | undefined;
+    updated?: number | undefined;
+}, {
+    id?: string | undefined;
+    created?: number | undefined;
+    updated?: number | undefined;
+}>;
+export declare const zSavedDBEntity: z.ZodObject<{
+    id: z.ZodString;
+    created: z.ZodNumber;
+    updated: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    created: number;
+    updated: number;
+}, {
+    id: string;
+    created: number;
+    updated: number;
+}>;

package/dist/zod/zod.shared.schemas.js

@@ -0,0 +1,94 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.zSavedDBEntity = exports.zBaseDBEntity = exports.zSlug = exports.zIdBase64Url = exports.zIdBase64 = exports.zIdBase62 = exports.zId = exports.zJwt = exports.JWT_REGEX = exports.zBase64Url = exports.zBase64 = exports.zBase62 = exports.BASE64URL_REGEX = exports.BASE64_REGEX = exports.BASE62_REGEX = exports.zEmail = exports.zIsoDateString = exports.zSemVer = exports.zUnixTimestampMillis2000 = exports.zUnixTimestampMillis = exports.zUnixTimestamp2000 = exports.zUnixTimestamp = exports.TS_2000 = exports.TS_2500 = void 0;
+const zod_1 = require("zod");
+exports.TS_2500 = 16725225600; // 2500-01-01
+exports.TS_2000 = 946684800; // 2000-01-01
+exports.zUnixTimestamp = zod_1.z
+    .number()
+    .int()
+    .min(0)
+    .max(exports.TS_2500, 'Must be a UnixTimestamp number')
+    .describe('UnixTimestamp');
+exports.zUnixTimestamp2000 = zod_1.z
+    .number()
+    .int()
+    .min(exports.TS_2000)
+    .max(exports.TS_2500, 'Must be a UnixTimestamp number after 2000-01-01')
+    .describe('UnixTimestamp2000');
+exports.zUnixTimestampMillis = zod_1.z
+    .number()
+    .int()
+    .min(0)
+    .max(exports.TS_2500 * 1000, 'Must be a UnixTimestampMillis number')
+    .describe('UnixTimestampMillis');
+exports.zUnixTimestampMillis2000 = zod_1.z
+    .number()
+    .int()
+    .min(exports.TS_2000 * 1000)
+    .max(exports.TS_2500 * 1000, 'Must be a UnixTimestampMillis number after 2000-01-01')
+    .describe('UnixTimestampMillis2000');
+exports.zSemVer = zod_1.z
+    .string()
+    .regex(/^[0-9]+\.[0-9]+\.[0-9]+$/, 'Must be a SemVer string')
+    .describe('SemVer');
+exports.zIsoDateString = zod_1.z
+    .string()
+    .refine(v => {
+    return /^\d{4}-\d{2}-\d{2}$/.test(v);
+}, 'Must be an IsoDateString')
+    .describe('IsoDateString');
+exports.zEmail = zod_1.z
+    .string()
+    .trim()
+    .email()
+    .transform(s => s.toLowerCase())
+    .describe('Email');
+exports.BASE62_REGEX = /^[a-zA-Z0-9]+$/;
+exports.BASE64_REGEX = /^[A-Za-z0-9+/]+={0,2}$/;
+exports.BASE64URL_REGEX = /^[\w-/]+$/;
+exports.zBase62 = zod_1.z
+    .string()
+    .regex(exports.BASE62_REGEX, 'Must be a base62 string')
+    .describe('Base62String');
+exports.zBase64 = zod_1.z
+    .string()
+    .regex(exports.BASE64_REGEX, 'Must be a base64 string')
+    .describe('Base64String');
+exports.zBase64Url = zod_1.z
+    .string()
+    .regex(exports.BASE64URL_REGEX, 'Must be a base64url string')
+    .describe('Base64UrlString');
+exports.JWT_REGEX = /^[\w-]+\.[\w-]+\.[\w-]+$/;
+exports.zJwt = zod_1.z.string().regex(exports.JWT_REGEX, 'Must be a JWT string').describe('JWTString');
+exports.zId = zod_1.z
+    .string()
+    .regex(/^[a-zA-Z0-9_]{6,64}$/, 'Must be an id string')
+    .describe('IdString');
+exports.zIdBase62 = zod_1.z
+    .string()
+    .regex(/^[a-zA-Z0-9]{8,64}$/, 'Must be a base62 id string')
+    .describe('Base62Id');
+exports.zIdBase64 = zod_1.z
+    .string()
+    .regex(/^[A-Za-z0-9+/]{6,62}={0,2}$/, 'Must be a base64 id string')
+    .describe('Base64Id');
+exports.zIdBase64Url = zod_1.z
+    .string()
+    .regex(/^[\w-/]{8,64}$/, 'Must be a base64url id string')
+    .describe('Base64UrlId');
+/**
+ * "Slug" - a valid URL, filename, etc.
+ */
+exports.zSlug = zod_1.z
+    .string()
+    .regex(/^[a-z0-9-]{1,255}$/, 'Must be a slug string')
+    .describe('Slug');
+exports.zBaseDBEntity = zod_1.z
+    .object({
+    id: zod_1.z.string().optional(),
+    created: exports.zUnixTimestamp2000.optional(),
+    updated: exports.zUnixTimestamp2000.optional(),
+})
+    .describe('BaseDBEntity');
+exports.zSavedDBEntity = exports.zBaseDBEntity.required().describe('SavedDBEntity');

package/dist/zod/zod.util.d.ts

@@ -0,0 +1,21 @@
+import { ZodError, ZodSchema, ZodIssue } from 'zod';
+export interface ZodErrorResult<T> {
+    success: false;
+    data?: T;
+    error: ZodValidationError<T>;
+}
+export interface ZodSuccessResult<T> {
+    success: true;
+    data: T;
+    error?: ZodValidationError<T>;
+}
+export declare function zIsValid<T>(value: T, schema: ZodSchema<T>): boolean;
+export declare function zValidate<T>(value: T, schema: ZodSchema<T>): T;
+export declare function zSafeValidate<T>(value: T, schema: ZodSchema<T>): ZodSuccessResult<T> | ZodErrorResult<T>;
+export declare class ZodValidationError<T> extends ZodError<T> {
+    value: T;
+    schema: ZodSchema<T>;
+    constructor(issues: ZodIssue[], value: T, schema: ZodSchema<T>);
+    get message(): string;
+    annotate(): string;
+}

package/dist/zod/zod.util.js

@@ -0,0 +1,59 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ZodValidationError = exports.zSafeValidate = exports.zValidate = exports.zIsValid = void 0;
+const zod_1 = require("zod");
+const stringifyAny_1 = require("../string/stringifyAny");
+function zIsValid(value, schema) {
+    const { success } = schema.safeParse(value);
+    return success;
+}
+exports.zIsValid = zIsValid;
+function zValidate(value, schema) {
+    const r = zSafeValidate(value, schema);
+    if (r.success) {
+        return r.data;
+    }
+    throw r.error;
+}
+exports.zValidate = zValidate;
+function zSafeValidate(value, schema) {
+    const r = schema.safeParse(value);
+    if (r.success) {
+        return r;
+    }
+    return {
+        success: false,
+        error: new ZodValidationError(r.error.issues, value, schema),
+    };
+}
+exports.zSafeValidate = zSafeValidate;
+class ZodValidationError extends zod_1.ZodError {
+    constructor(issues, value, schema) {
+        super(issues);
+        this.value = value;
+        this.schema = schema;
+    }
+    get message() {
+        return this.annotate();
+    }
+    annotate() {
+        let objectTitle = this.schema.description;
+        if (typeof this.value === 'object' && this.value) {
+            const objectName = this.schema.description || this.value.constructor?.name;
+            const objectId = this.value['id'];
+            objectTitle = [objectName, objectId].filter(Boolean).join('.');
+        }
+        objectTitle ||= 'data';
+        return [
+            `Invalid ${objectTitle}`,
+            '',
+            'Input:',
+            (0, stringifyAny_1._stringifyAny)(this.value),
+            this.issues.length > 1 ? `\n${this.issues.length} issues:` : '',
+            ...this.issues.slice(0, 100).map(i => {
+                return [i.path.join('.'), i.message].filter(Boolean).join(': ');
+            }),
+        ].join('\n');
+    }
+}
+exports.ZodValidationError = ZodValidationError;

package/dist-esm/index.js

@@ -59,7 +59,6 @@ export * from './is.util';
 export * from './typeFest';
 export * from './types';
 export * from './unit/size.util';
-import { is } from './vendor/is';
 export * from './log/commonLogger';
 export * from './string/safeJsonStringify';
 export * from './promise/pQueue';
@@ -77,4 +76,8 @@ export * from './datetime/timeInterval';
 export * from './http/http.model';
 export * from './http/fetcher';
 export * from './http/fetcher.model';
-export { is };
+export * from './zod/zod.util';
+export * from './zod/zod.shared.schemas';
+import { z, ZodSchema, ZodError } from 'zod';
+import { is } from './vendor/is';
+export { is, z, ZodSchema, ZodError };

package/dist-esm/zod/zod.shared.schemas.js

@@ -0,0 +1,91 @@
+import { z } from 'zod';
+export const TS_2500 = 16725225600; // 2500-01-01
+export const TS_2000 = 946684800; // 2000-01-01
+export const zUnixTimestamp = z
+    .number()
+    .int()
+    .min(0)
+    .max(TS_2500, 'Must be a UnixTimestamp number')
+    .describe('UnixTimestamp');
+export const zUnixTimestamp2000 = z
+    .number()
+    .int()
+    .min(TS_2000)
+    .max(TS_2500, 'Must be a UnixTimestamp number after 2000-01-01')
+    .describe('UnixTimestamp2000');
+export const zUnixTimestampMillis = z
+    .number()
+    .int()
+    .min(0)
+    .max(TS_2500 * 1000, 'Must be a UnixTimestampMillis number')
+    .describe('UnixTimestampMillis');
+export const zUnixTimestampMillis2000 = z
+    .number()
+    .int()
+    .min(TS_2000 * 1000)
+    .max(TS_2500 * 1000, 'Must be a UnixTimestampMillis number after 2000-01-01')
+    .describe('UnixTimestampMillis2000');
+export const zSemVer = z
+    .string()
+    .regex(/^[0-9]+\.[0-9]+\.[0-9]+$/, 'Must be a SemVer string')
+    .describe('SemVer');
+export const zIsoDateString = z
+    .string()
+    .refine(v => {
+    return /^\d{4}-\d{2}-\d{2}$/.test(v);
+}, 'Must be an IsoDateString')
+    .describe('IsoDateString');
+export const zEmail = z
+    .string()
+    .trim()
+    .email()
+    .transform(s => s.toLowerCase())
+    .describe('Email');
+export const BASE62_REGEX = /^[a-zA-Z0-9]+$/;
+export const BASE64_REGEX = /^[A-Za-z0-9+/]+={0,2}$/;
+export const BASE64URL_REGEX = /^[\w-/]+$/;
+export const zBase62 = z
+    .string()
+    .regex(BASE62_REGEX, 'Must be a base62 string')
+    .describe('Base62String');
+export const zBase64 = z
+    .string()
+    .regex(BASE64_REGEX, 'Must be a base64 string')
+    .describe('Base64String');
+export const zBase64Url = z
+    .string()
+    .regex(BASE64URL_REGEX, 'Must be a base64url string')
+    .describe('Base64UrlString');
+export const JWT_REGEX = /^[\w-]+\.[\w-]+\.[\w-]+$/;
+export const zJwt = z.string().regex(JWT_REGEX, 'Must be a JWT string').describe('JWTString');
+export const zId = z
+    .string()
+    .regex(/^[a-zA-Z0-9_]{6,64}$/, 'Must be an id string')
+    .describe('IdString');
+export const zIdBase62 = z
+    .string()
+    .regex(/^[a-zA-Z0-9]{8,64}$/, 'Must be a base62 id string')
+    .describe('Base62Id');
+export const zIdBase64 = z
+    .string()
+    .regex(/^[A-Za-z0-9+/]{6,62}={0,2}$/, 'Must be a base64 id string')
+    .describe('Base64Id');
+export const zIdBase64Url = z
+    .string()
+    .regex(/^[\w-/]{8,64}$/, 'Must be a base64url id string')
+    .describe('Base64UrlId');
+/**
+ * "Slug" - a valid URL, filename, etc.
+ */
+export const zSlug = z
+    .string()
+    .regex(/^[a-z0-9-]{1,255}$/, 'Must be a slug string')
+    .describe('Slug');
+export const zBaseDBEntity = z
+    .object({
+    id: z.string().optional(),
+    created: zUnixTimestamp2000.optional(),
+    updated: zUnixTimestamp2000.optional(),
+})
+    .describe('BaseDBEntity');
+export const zSavedDBEntity = zBaseDBEntity.required().describe('SavedDBEntity');

package/dist-esm/zod/zod.util.js

@@ -0,0 +1,53 @@
+import { ZodError } from 'zod';
+import { _stringifyAny } from '../string/stringifyAny';
+export function zIsValid(value, schema) {
+    const { success } = schema.safeParse(value);
+    return success;
+}
+export function zValidate(value, schema) {
+    const r = zSafeValidate(value, schema);
+    if (r.success) {
+        return r.data;
+    }
+    throw r.error;
+}
+export function zSafeValidate(value, schema) {
+    const r = schema.safeParse(value);
+    if (r.success) {
+        return r;
+    }
+    return {
+        success: false,
+        error: new ZodValidationError(r.error.issues, value, schema),
+    };
+}
+export class ZodValidationError extends ZodError {
+    constructor(issues, value, schema) {
+        super(issues);
+        this.value = value;
+        this.schema = schema;
+    }
+    get message() {
+        return this.annotate();
+    }
+    annotate() {
+        var _a;
+        let objectTitle = this.schema.description;
+        if (typeof this.value === 'object' && this.value) {
+            const objectName = this.schema.description || ((_a = this.value.constructor) === null || _a === void 0 ? void 0 : _a.name);
+            const objectId = this.value['id'];
+            objectTitle = [objectName, objectId].filter(Boolean).join('.');
+        }
+        objectTitle || (objectTitle = 'data');
+        return [
+            `Invalid ${objectTitle}`,
+            '',
+            'Input:',
+            _stringifyAny(this.value),
+            this.issues.length > 1 ? `\n${this.issues.length} issues:` : '',
+            ...this.issues.slice(0, 100).map(i => {
+                return [i.path.join('.'), i.message].filter(Boolean).join(': ');
+            }),
+        ].join('\n');
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@naturalcycles/js-lib",
-  "version": "14.128.1",
+  "version": "14.129.0",
   "scripts": {
     "prepare": "husky install",
     "build-prod": "build-prod-esm-cjs",
@@ -8,7 +8,8 @@
     "docs-build": "NODE_OPTIONS=--openssl-legacy-provider vuepress build docs"
   },
   "dependencies": {
-    "tslib": "^2.0.0"
+    "tslib": "^2.0.0",
+    "zod": "^3.20.2"
   },
   "devDependencies": {
     "@naturalcycles/bench-lib": "^1.5.0",

package/src/index.ts

@@ -59,7 +59,6 @@ export * from './is.util'
 export * from './typeFest'
 export * from './types'
 export * from './unit/size.util'
-import { is } from './vendor/is'
 export * from './log/commonLogger'
 export * from './string/safeJsonStringify'
 export * from './promise/pQueue'
@@ -77,5 +76,10 @@ export * from './datetime/timeInterval'
 export * from './http/http.model'
 export * from './http/fetcher'
 export * from './http/fetcher.model'
+export * from './zod/zod.util'
+export * from './zod/zod.shared.schemas'
+import { z, ZodSchema, ZodError, ZodIssue } from 'zod'
+import { is } from './vendor/is'
 
-export { is }
+export { is, z, ZodSchema, ZodError }
+export type { ZodIssue }

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

@@ -0,0 +1,102 @@
+import { z } from 'zod'
+
+export const TS_2500 = 16725225600 // 2500-01-01
+export const TS_2000 = 946684800 // 2000-01-01
+
+export const zUnixTimestamp = z
+  .number()
+  .int()
+  .min(0)
+  .max(TS_2500, 'Must be a UnixTimestamp number')
+  .describe('UnixTimestamp')
+export const zUnixTimestamp2000 = z
+  .number()
+  .int()
+  .min(TS_2000)
+  .max(TS_2500, 'Must be a UnixTimestamp number after 2000-01-01')
+  .describe('UnixTimestamp2000')
+export const zUnixTimestampMillis = z
+  .number()
+  .int()
+  .min(0)
+  .max(TS_2500 * 1000, 'Must be a UnixTimestampMillis number')
+  .describe('UnixTimestampMillis')
+export const zUnixTimestampMillis2000 = z
+  .number()
+  .int()
+  .min(TS_2000 * 1000)
+  .max(TS_2500 * 1000, 'Must be a UnixTimestampMillis number after 2000-01-01')
+  .describe('UnixTimestampMillis2000')
+
+export const zSemVer = z
+  .string()
+  .regex(/^[0-9]+\.[0-9]+\.[0-9]+$/, 'Must be a SemVer string')
+  .describe('SemVer')
+
+export const zIsoDateString = z
+  .string()
+  .refine(v => {
+    return /^\d{4}-\d{2}-\d{2}$/.test(v)
+  }, 'Must be an IsoDateString')
+  .describe('IsoDateString')
+
+export const zEmail = z
+  .string()
+  .trim()
+  .email()
+  .transform(s => s.toLowerCase())
+  .describe('Email')
+
+export const BASE62_REGEX = /^[a-zA-Z0-9]+$/
+export const BASE64_REGEX = /^[A-Za-z0-9+/]+={0,2}$/
+export const BASE64URL_REGEX = /^[\w-/]+$/
+export const zBase62 = z
+  .string()
+  .regex(BASE62_REGEX, 'Must be a base62 string')
+  .describe('Base62String')
+export const zBase64 = z
+  .string()
+  .regex(BASE64_REGEX, 'Must be a base64 string')
+  .describe('Base64String')
+export const zBase64Url = z
+  .string()
+  .regex(BASE64URL_REGEX, 'Must be a base64url string')
+  .describe('Base64UrlString')
+
+export const JWT_REGEX = /^[\w-]+\.[\w-]+\.[\w-]+$/
+export const zJwt = z.string().regex(JWT_REGEX, 'Must be a JWT string').describe('JWTString')
+
+export const zId = z
+  .string()
+  .regex(/^[a-zA-Z0-9_]{6,64}$/, 'Must be an id string')
+  .describe('IdString')
+export const zIdBase62 = z
+  .string()
+  .regex(/^[a-zA-Z0-9]{8,64}$/, 'Must be a base62 id string')
+  .describe('Base62Id')
+export const zIdBase64 = z
+  .string()
+  .regex(/^[A-Za-z0-9+/]{6,62}={0,2}$/, 'Must be a base64 id string')
+  .describe('Base64Id')
+export const zIdBase64Url = z
+  .string()
+  .regex(/^[\w-/]{8,64}$/, 'Must be a base64url id string')
+  .describe('Base64UrlId')
+
+/**
+ * "Slug" - a valid URL, filename, etc.
+ */
+export const zSlug = z
+  .string()
+  .regex(/^[a-z0-9-]{1,255}$/, 'Must be a slug string')
+  .describe('Slug')
+
+export const zBaseDBEntity = z
+  .object({
+    id: z.string().optional(),
+    created: zUnixTimestamp2000.optional(),
+    updated: zUnixTimestamp2000.optional(),
+  })
+  .describe('BaseDBEntity')
+
+export const zSavedDBEntity = zBaseDBEntity.required().describe('SavedDBEntity')

package/src/zod/zod.util.ts

@@ -0,0 +1,77 @@
+import { ZodError, ZodSchema, ZodIssue } from 'zod'
+import { _stringifyAny } from '../string/stringifyAny'
+
+export interface ZodErrorResult<T> {
+  success: false
+  data?: T
+  error: ZodValidationError<T>
+}
+
+export interface ZodSuccessResult<T> {
+  success: true
+  data: T
+  error?: ZodValidationError<T>
+}
+
+export function zIsValid<T>(value: T, schema: ZodSchema<T>): boolean {
+  const { success } = schema.safeParse(value)
+  return success
+}
+
+export function zValidate<T>(value: T, schema: ZodSchema<T>): T {
+  const r = zSafeValidate(value, schema)
+  if (r.success) {
+    return r.data
+  }
+
+  throw r.error
+}
+
+export function zSafeValidate<T>(
+  value: T,
+  schema: ZodSchema<T>,
+  // objectName?: string,
+): ZodSuccessResult<T> | ZodErrorResult<T> {
+  const r = schema.safeParse(value)
+  if (r.success) {
+    return r
+  }
+
+  return {
+    success: false,
+    error: new ZodValidationError<T>(r.error.issues, value, schema),
+  }
+}
+
+export class ZodValidationError<T> extends ZodError<T> {
+  constructor(issues: ZodIssue[], public value: T, public schema: ZodSchema<T>) {
+    super(issues)
+  }
+
+  override get message(): string {
+    return this.annotate()
+  }
+
+  annotate(): string {
+    let objectTitle = this.schema.description
+
+    if (typeof this.value === 'object' && this.value) {
+      const objectName = this.schema.description || this.value.constructor?.name
+      const objectId = (this.value as any)['id'] as string
+      objectTitle = [objectName, objectId].filter(Boolean).join('.')
+    }
+
+    objectTitle ||= 'data'
+
+    return [
+      `Invalid ${objectTitle}`,
+      '',
+      'Input:',
+      _stringifyAny(this.value),
+      this.issues.length > 1 ? `\n${this.issues.length} issues:` : '',
+      ...this.issues.slice(0, 100).map(i => {
+        return [i.path.join('.'), i.message].filter(Boolean).join(': ')
+      }),
+    ].join('\n')
+  }
+}