@modularizer/plat-client 0.4.0

package/dist/args/coerce.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Type coercion for incoming data (query strings, form data, etc.)
+ *
+ * Handles: string→number, string→boolean, string→Date, trim strings.
+ * Called before validation so that "42" passes an integer schema.
+ */
+export declare function parseRelativeDate(input: string, now?: Date): Date | null;
+export declare function parseDateish(value: unknown, now?: Date, dateOnly?: boolean): Date | null;
+export interface JsonSchema {
+    type?: string;
+    format?: string;
+    coerce?: string | boolean;
+    properties?: Record<string, JsonSchema>;
+    items?: JsonSchema;
+    [key: string]: unknown;
+}
+export type CoerceFn = (value: unknown) => unknown;
+/** Register a custom coercion function, usable via `// coerce: name` in types. */
+export declare function registerCoerce(name: string, fn: CoerceFn): void;
+/**
+ * Decorator that registers a function as a custom coercer.
+ * The function name becomes the coerce key.
+ *
+ *   @Coerce
+ *   function slug(v: unknown) {
+ *       return String(v).trim().toLowerCase().replace(/\s+/g, '-')
+ *   }
+ *
+ * Then use in types:
+ *   type Post = { url: string } // coerce: slug
+ */
+export declare function Coerce(target: CoerceFn, context?: {
+    name?: string;
+}): void;
+export declare function Coerce(target: any, propertyKey?: string, descriptor?: PropertyDescriptor): void;
+/**
+ * Coerce a value to match the expected schema type.
+ * Mutates objects in-place for performance.
+ *
+ * Coercion modes (set via comment or generic: coerce: <mode>):
+ *   false    — no coercion
+ *   trim     — trim whitespace (default for strings)
+ *   lower    — trim + lowercase
+ *   upper    — trim + uppercase
+ *   number   — string → number (default for number/integer types)
+ *   int      — string → integer (floors)
+ *   bool     — string/number → boolean (default for boolean type)
+ *   date     — string/number → ISO date string
+ *   datetime — string/number → ISO datetime string
+ *   json     — JSON.parse string → object/array
+ *   split    — comma-separated string → array
+ */
+export declare function coerce(value: unknown, schema: JsonSchema): unknown;
+//# sourceMappingURL=coerce.d.ts.map

package/dist/args/coerce.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"coerce.d.ts","sourceRoot":"","sources":["../../../typescript/src/args/coerce.ts"],"names":[],"mappings":"AACA;;;;;GAKG;AAkBH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAa,GAAG,IAAI,GAAG,IAAI,CA2B9E;AAED,wBAAgB,YAAY,CACxB,KAAK,EAAE,OAAO,EACd,GAAG,OAAa,EAChB,QAAQ,UAAQ,GACjB,IAAI,GAAG,IAAI,CAiBb;AAID,MAAM,WAAW,UAAU;IACvB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAA;IACvC,KAAK,CAAC,EAAE,UAAU,CAAA;IAClB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CACzB;AAID,MAAM,MAAM,QAAQ,GAAG,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAA;AAIlD,kFAAkF;AAClF,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,QAAQ,QAExD;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,MAAM,CAAC,MAAM,EAAE,QAAQ,EAAE,OAAO,CAAC,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAAA;AAC3E,wBAAgB,MAAM,CAAC,MAAM,EAAE,GAAG,EAAE,WAAW,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,kBAAkB,GAAG,IAAI,CAAA;AAahG;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,GAAG,OAAO,CAyBlE"}

package/dist/args/coerce.js

@@ -0,0 +1,236 @@
+/**
+ * Type coercion for incoming data (query strings, form data, etc.)
+ *
+ * Handles: string→number, string→boolean, string→Date, trim strings.
+ * Called before validation so that "42" passes an integer schema.
+ */
+// ── date helpers (kept from dateCoerce.ts) ──────────────────
+const startOfDay = (d) => { const c = new Date(d); c.setHours(0, 0, 0, 0); return c; };
+const isValidDate = (v) => v instanceof Date && !Number.isNaN(v.getTime());
+const addMs = (d, ms) => new Date(d.getTime() + ms);
+const addMonths = (d, months) => {
+    const c = new Date(d);
+    c.setMonth(c.getMonth() + months);
+    return c;
+};
+const addYears = (d, years) => {
+    const c = new Date(d);
+    c.setFullYear(c.getFullYear() + years);
+    return c;
+};
+const RELATIVE_RE = /^(\d+)\s*(ms|millisecond|milliseconds|s|sec|secs|second|seconds|m|min|mins|minute|minutes|h|hr|hrs|hour|hours|d|day|days|w|week|weeks|mo|month|months|y|yr|year|years)(?:\s+ago)?$/i;
+export function parseRelativeDate(input, now = new Date()) {
+    const s = input.trim().toLowerCase();
+    if (s === 'now' || s === 'today')
+        return new Date(now);
+    if (s === 'yesterday')
+        return addMs(now, -86_400_000);
+    if (s === 'tomorrow')
+        return addMs(now, 86_400_000);
+    const match = s.match(RELATIVE_RE);
+    if (!match)
+        return null;
+    const amount = Number(match[1]);
+    const unit = match[2];
+    const sign = s.includes('ago') ? -1 : 1;
+    const MS = {
+        ms: 1, millisecond: 1, milliseconds: 1,
+        s: 1000, sec: 1000, secs: 1000, second: 1000, seconds: 1000,
+        m: 60_000, min: 60_000, mins: 60_000, minute: 60_000, minutes: 60_000,
+        h: 3_600_000, hr: 3_600_000, hrs: 3_600_000, hour: 3_600_000, hours: 3_600_000,
+        d: 86_400_000, day: 86_400_000, days: 86_400_000,
+        w: 604_800_000, week: 604_800_000, weeks: 604_800_000,
+    };
+    if (unit in MS)
+        return addMs(now, sign * amount * MS[unit]);
+    if (/^(mo|month|months)$/.test(unit))
+        return addMonths(now, sign * amount);
+    if (/^(y|yr|year|years)$/.test(unit))
+        return addYears(now, sign * amount);
+    return null;
+}
+export function parseDateish(value, now = new Date(), dateOnly = false) {
+    if (value instanceof Date) {
+        return isValidDate(value) ? (dateOnly ? startOfDay(value) : new Date(value)) : null;
+    }
+    if (typeof value === 'number') {
+        const d = new Date(value);
+        return isValidDate(d) ? (dateOnly ? startOfDay(d) : d) : null;
+    }
+    if (typeof value !== 'string')
+        return null;
+    const s = value.trim();
+    if (!s)
+        return null;
+    const rel = parseRelativeDate(s, now);
+    if (rel)
+        return dateOnly ? startOfDay(rel) : rel;
+    const abs = new Date(s);
+    return isValidDate(abs) ? (dateOnly ? startOfDay(abs) : abs) : null;
+}
+const customCoercers = new Map();
+/** Register a custom coercion function, usable via `// coerce: name` in types. */
+export function registerCoerce(name, fn) {
+    customCoercers.set(name, fn);
+}
+export function Coerce(target, contextOrKey, descriptor) {
+    if (typeof target === 'function' && (contextOrKey === undefined || typeof contextOrKey === 'object')) {
+        // TC39 / standalone function decorator: @Coerce function slug() {}
+        const name = contextOrKey?.name ?? target.name;
+        if (name)
+            customCoercers.set(name, target);
+    }
+    else if (descriptor && typeof descriptor.value === 'function') {
+        // legacy method decorator: class Foo { @Coerce slug(v) {} }
+        const name = String(contextOrKey);
+        customCoercers.set(name, descriptor.value);
+    }
+}
+/**
+ * Coerce a value to match the expected schema type.
+ * Mutates objects in-place for performance.
+ *
+ * Coercion modes (set via comment or generic: coerce: <mode>):
+ *   false    — no coercion
+ *   trim     — trim whitespace (default for strings)
+ *   lower    — trim + lowercase
+ *   upper    — trim + uppercase
+ *   number   — string → number (default for number/integer types)
+ *   int      — string → integer (floors)
+ *   bool     — string/number → boolean (default for boolean type)
+ *   date     — string/number → ISO date string
+ *   datetime — string/number → ISO datetime string
+ *   json     — JSON.parse string → object/array
+ *   split    — comma-separated string → array
+ */
+export function coerce(value, schema) {
+    if (value === undefined || value === null)
+        return value;
+    // explicit coerce mode takes priority
+    if (schema.coerce !== undefined) {
+        if (schema.coerce === 'false' || schema.coerce === false)
+            return value;
+        return applyCoerce(value, String(schema.coerce));
+    }
+    // default coercion by type
+    switch (schema.type) {
+        case 'string':
+            return coerceTrim(value);
+        case 'number':
+        case 'integer':
+            return coerceNumber(value);
+        case 'boolean':
+            return coerceBoolean(value);
+        case 'object':
+            return coerceObject(value, schema);
+        case 'array':
+            return coerceArray(value, schema);
+        default:
+            return value;
+    }
+}
+function applyCoerce(value, mode) {
+    switch (mode) {
+        case 'trim': return coerceTrim(value);
+        case 'lower': return coerceLower(value);
+        case 'upper': return coerceUpper(value);
+        case 'number': return coerceNumber(value);
+        case 'int': return coerceInt(value);
+        case 'bool': return coerceBoolean(value);
+        case 'date':
+        case 'datetime': {
+            const d = parseDateish(value, new Date(), mode === 'date');
+            return d ? d.toISOString() : value;
+        }
+        case 'json': return coerceJson(value);
+        case 'split': return coerceSplit(value);
+        default: {
+            const custom = customCoercers.get(mode);
+            return custom ? custom(value) : value;
+        }
+    }
+}
+function coerceTrim(value) {
+    if (typeof value !== 'string')
+        return String(value);
+    return value.trim();
+}
+function coerceLower(value) {
+    if (typeof value !== 'string')
+        return String(value).toLowerCase();
+    return value.trim().toLowerCase();
+}
+function coerceUpper(value) {
+    if (typeof value !== 'string')
+        return String(value).toUpperCase();
+    return value.trim().toUpperCase();
+}
+function coerceNumber(value) {
+    if (typeof value === 'number')
+        return value;
+    if (typeof value === 'string') {
+        const n = Number(value);
+        if (!Number.isNaN(n) && value.trim() !== '')
+            return n;
+    }
+    return value;
+}
+function coerceInt(value) {
+    const n = coerceNumber(value);
+    return typeof n === 'number' ? Math.floor(n) : n;
+}
+const TRUTHY = new Set(['true', '1', 'yes', 'y', 'on']);
+const FALSY = new Set(['false', '0', 'no', 'n', 'off', '']);
+function coerceBoolean(value) {
+    if (typeof value === 'boolean')
+        return value;
+    if (typeof value === 'number')
+        return value !== 0;
+    if (typeof value === 'string') {
+        const s = value.trim().toLowerCase();
+        if (TRUTHY.has(s))
+            return true;
+        if (FALSY.has(s))
+            return false;
+    }
+    return value;
+}
+function coerceJson(value) {
+    if (typeof value !== 'string')
+        return value;
+    try {
+        return JSON.parse(value);
+    }
+    catch {
+        return value;
+    }
+}
+function coerceSplit(value) {
+    if (Array.isArray(value))
+        return value;
+    if (typeof value !== 'string')
+        return value;
+    return value.split(',').map(s => s.trim()).filter(Boolean);
+}
+function coerceObject(value, schema) {
+    if (typeof value !== 'object' || value === null || Array.isArray(value))
+        return value;
+    if (!schema.properties)
+        return value;
+    const obj = value;
+    for (const [key, propSchema] of Object.entries(schema.properties)) {
+        if (key in obj) {
+            obj[key] = coerce(obj[key], propSchema);
+        }
+    }
+    return obj;
+}
+function coerceArray(value, schema) {
+    if (!Array.isArray(value) || !schema.items)
+        return value;
+    for (let i = 0; i < value.length; i++) {
+        value[i] = coerce(value[i], schema.items);
+    }
+    return value;
+}
+//# sourceMappingURL=coerce.js.map

package/dist/args/coerce.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"coerce.js","sourceRoot":"","sources":["../../../typescript/src/args/coerce.ts"],"names":[],"mappings":"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"}

package/dist/args/index.d.ts

@@ -0,0 +1,2 @@
+export * from './z2';
+//# sourceMappingURL=index.d.ts.map

package/dist/args/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../typescript/src/args/index.ts"],"names":[],"mappings":"AACA,cAAc,MAAM,CAAA"}

package/dist/args/index.js

@@ -0,0 +1,2 @@
+export * from './z2.js';
+//# sourceMappingURL=index.js.map

package/dist/args/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../typescript/src/args/index.ts"],"names":[],"mappings":"AACA,cAAc,MAAM,CAAA"}

package/dist/args/scalars.d.ts

@@ -0,0 +1,87 @@
+/**
+ * Scalar type aliases.
+ *
+ * These are plain TypeScript types. The codegen reads the alias name
+ * and maps it to a richer JSON Schema. At runtime they're just
+ * string / number / boolean.
+ *
+ * Generic params override min/max from the comment constraints.
+ *   int         → { type: integer, minimum: 0 }
+ *   int<5>      → { type: integer, minimum: 5 }
+ *   int<0, 100> → { type: integer, minimum: 0, maximum: 100 }
+ *
+ * Usage:
+ *   type CreatePost = {
+ *     author: email
+ *     priority: pint
+ *     title: str<1, 200>
+ *     age: int<0, 150>
+ *   }
+ */
+export type str<min = never, max = never> = string;
+export type varchar<max = never> = string;
+export type vc = varchar;
+export type char = str<1, 1>;
+export type text = str<0, 65535>;
+export type word = pattern<'[a-zA-Z]+'>;
+export type token = pattern<'[a-zA-Z0-9_]+'>;
+export type line = pattern<'[^\\n]+'>;
+export type email = string;
+export type url = string;
+export type uuid = string;
+export type ip = string;
+export type ipv6 = string;
+export type hostname = string;
+export type datestr = string;
+export type datetime = string;
+export type time = string;
+export type json = string;
+export type pattern<pattern = never> = string;
+export type grep<grep = never> = string;
+export type like<like = never> = string;
+export type ilike<ilike = never> = string;
+export type hex = pattern<'[0-9a-fA-F]+'>;
+export type digits = pattern<'[0-9]+'>;
+export type numeric = pattern<'-?[0-9]+(\\.[0-9]+)?'>;
+export type upper = pattern<'[A-Z ]+'>;
+export type lower = pattern<'[a-z ]+'>;
+export type alpha = pattern<'[a-zA-Z]+'>;
+export type alphanum = pattern<'[a-zA-Z0-9]+'>;
+export type title = pattern<'[A-Z][a-zA-Z ]*'>;
+export type slug = pattern<'[a-z0-9]+(-[a-z0-9]+)*'>;
+export type semver = pattern<'[0-9]+\\.[0-9]+\\.[0-9]+'>;
+export type base64 = pattern<'[A-Za-z0-9+/]+=*'>;
+export type base58 = pattern<'[123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz]+'>;
+export type phone = pattern<'\\+?[0-9\\- ()]+'>;
+export type color = pattern<'#[0-9a-fA-F]{3,8}'>;
+export type locale = pattern<'[a-z]{2}(-[A-Z]{2})?'>;
+export type mimetype = pattern<'[a-z]+/[a-z0-9.+-]+'>;
+export type filepath = pattern<'[^\\0]+'>;
+export type cuid = pattern<'c[a-z0-9]{24}'>;
+export type ulid = pattern<'[0-9A-HJKMNP-TV-Z]{26}'>;
+export type nanoid = pattern<'[A-Za-z0-9_-]{21}'>;
+export type jwt = pattern<'[A-Za-z0-9_-]+\\.[A-Za-z0-9_-]+\\.[A-Za-z0-9_-]+'>;
+export type countrycode = pattern<'[A-Z]{2}'>;
+export type currency = pattern<'[A-Z]{3}'>;
+export type lang = pattern<'[a-z]{2}'>;
+export type cron = pattern<'[0-9*,/-]+ [0-9*,/-]+ [0-9*,/-]+ [0-9*,/-]+ [0-9*,/-]+'>;
+export type num<min = never, max = never> = number;
+export type float<min = never, max = never> = number;
+export type double<min = never, max = never> = number;
+export type int<min = never, max = never> = number;
+export type pos = num<0>;
+export type neg = number;
+export type notneg = num<0>;
+export type posint<max = never> = int<1, max>;
+export type percent = num<0, 100>;
+export type limit = int<1>;
+export type offset = int<0>;
+export type port = int<0, 65535>;
+export type byte = int<0, 255>;
+export type timestamp = int<0>;
+export type age = int<0, 130>;
+export type cents = int<0>;
+export type lat = float<-90, 90>;
+export type lng = float<-180, 180>;
+export type flag = boolean;
+//# sourceMappingURL=scalars.d.ts.map

package/dist/args/scalars.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scalars.d.ts","sourceRoot":"","sources":["../../../typescript/src/args/scalars.ts"],"names":[],"mappings":"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"}

package/dist/args/scalars.js

@@ -0,0 +1,22 @@
+/**
+ * Scalar type aliases.
+ *
+ * These are plain TypeScript types. The codegen reads the alias name
+ * and maps it to a richer JSON Schema. At runtime they're just
+ * string / number / boolean.
+ *
+ * Generic params override min/max from the comment constraints.
+ *   int         → { type: integer, minimum: 0 }
+ *   int<5>      → { type: integer, minimum: 5 }
+ *   int<0, 100> → { type: integer, minimum: 0, maximum: 100 }
+ *
+ * Usage:
+ *   type CreatePost = {
+ *     author: email
+ *     priority: pint
+ *     title: str<1, 200>
+ *     age: int<0, 150>
+ *   }
+ */
+export {};
+//# sourceMappingURL=scalars.js.map

package/dist/args/scalars.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scalars.js","sourceRoot":"","sources":["../../../typescript/src/args/scalars.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG"}

package/dist/args/validate.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Runtime validation against JSON Schema objects.
+ *
+ * Lean validator covering the JSON Schema subset that gen-schema.ts produces.
+ * Coerces before validating (string→number, string→date, trim, etc.)
+ */
+import { type JsonSchema } from './coerce';
+export declare class ValidationError extends Error {
+    issues: string[];
+    constructor(issues: string[]);
+}
+export type ParseResult<T> = {
+    ok: true;
+    data: T;
+} | {
+    ok: false;
+    error: ValidationError;
+};
+/** Coerce + validate. Throws on failure. */
+export declare function parse<T = unknown>(schema: JsonSchema, value: unknown): T;
+/** Coerce + validate. Returns result object. */
+export declare function safeParse<T = unknown>(schema: JsonSchema, value: unknown): ParseResult<T>;
+//# sourceMappingURL=validate.d.ts.map

package/dist/args/validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../../typescript/src/args/validate.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAU,KAAK,UAAU,EAAE,MAAM,UAAU,CAAA;AAElD,qBAAa,eAAgB,SAAQ,KAAK;IACnB,MAAM,EAAE,MAAM,EAAE;gBAAhB,MAAM,EAAE,MAAM,EAAE;CAItC;AAED,MAAM,MAAM,WAAW,CAAC,CAAC,IACnB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,CAAC,CAAA;CAAE,GACrB;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,eAAe,CAAA;CAAE,CAAA;AAE3C,4CAA4C;AAC5C,wBAAgB,KAAK,CAAC,CAAC,GAAG,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,OAAO,GAAG,CAAC,CAMxE;AAED,gDAAgD;AAChD,wBAAgB,SAAS,CAAC,CAAC,GAAG,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,OAAO,GAAG,WAAW,CAAC,CAAC,CAAC,CAOzF"}

package/dist/args/validate.js

@@ -0,0 +1,185 @@
+/**
+ * Runtime validation against JSON Schema objects.
+ *
+ * Lean validator covering the JSON Schema subset that gen-schema.ts produces.
+ * Coerces before validating (string→number, string→date, trim, etc.)
+ */
+import { coerce } from './coerce.js';
+export class ValidationError extends Error {
+    issues;
+    constructor(issues) {
+        super(issues.join('; '));
+        this.issues = issues;
+        this.name = 'ValidationError';
+    }
+}
+/** Coerce + validate. Throws on failure. */
+export function parse(schema, value) {
+    const data = coerce(structuredClone(value), schema);
+    const issues = [];
+    validate(data, schema, '', issues);
+    if (issues.length > 0)
+        throw new ValidationError(issues);
+    return data;
+}
+/** Coerce + validate. Returns result object. */
+export function safeParse(schema, value) {
+    try {
+        return { ok: true, data: parse(schema, value) };
+    }
+    catch (e) {
+        if (e instanceof ValidationError)
+            return { ok: false, error: e };
+        throw e;
+    }
+}
+// ── validate recursively ────────────────────────────────────
+function validate(value, schema, path, issues) {
+    // nullable
+    if (value === null || value === undefined) {
+        if (schema.nullable)
+            return;
+        issues.push(`${path || '.'}: required`);
+        return;
+    }
+    // oneOf (used for nullable)
+    if (schema.oneOf) {
+        const sub = schema.oneOf;
+        for (const s of sub) {
+            const subIssues = [];
+            validate(value, s, path, subIssues);
+            if (subIssues.length === 0)
+                return;
+        }
+        issues.push(`${path || '.'}: does not match any variant`);
+        return;
+    }
+    switch (schema.type) {
+        case 'string': return validateString(value, schema, path, issues);
+        case 'number': return validateNumber(value, schema, path, issues);
+        case 'integer': return validateInteger(value, schema, path, issues);
+        case 'boolean': return validateBoolean(value, path, issues);
+        case 'object': return validateObject(value, schema, path, issues);
+        case 'array': return validateArray(value, schema, path, issues);
+    }
+}
+function validateString(value, schema, path, issues) {
+    if (typeof value !== 'string') {
+        issues.push(`${path || '.'}: expected string, got ${typeof value}`);
+        return;
+    }
+    const len = value.length;
+    if (schema.minLength !== undefined && len < schema.minLength)
+        issues.push(`${path || '.'}: string too short (min ${schema.minLength})`);
+    if (schema.maxLength !== undefined && len > schema.maxLength)
+        issues.push(`${path || '.'}: string too long (max ${schema.maxLength})`);
+    if (schema.pattern) {
+        const flags = schema.patternFlags || '';
+        if (!new RegExp(schema.pattern, flags).test(value))
+            issues.push(`${path || '.'}: does not match pattern ${schema.pattern}`);
+    }
+    if (schema.format)
+        validateFormat(value, schema.format, path, issues);
+    if (schema.enum && !schema.enum.includes(value))
+        issues.push(`${path || '.'}: must be one of ${schema.enum.join(', ')}`);
+}
+function validateFormat(value, format, path, issues) {
+    switch (format) {
+        case 'email':
+            if (!/^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(value))
+                issues.push(`${path || '.'}: invalid email`);
+            break;
+        case 'uri':
+            try {
+                new URL(value);
+            }
+            catch {
+                issues.push(`${path || '.'}: invalid URL`);
+            }
+            break;
+        case 'uuid':
+            if (!/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i.test(value))
+                issues.push(`${path || '.'}: invalid UUID`);
+            break;
+        case 'date':
+            if (!/^\d{4}-\d{2}-\d{2}$/.test(value) || Number.isNaN(Date.parse(value)))
+                issues.push(`${path || '.'}: invalid date`);
+            break;
+        case 'date-time':
+            if (Number.isNaN(Date.parse(value)))
+                issues.push(`${path || '.'}: invalid datetime`);
+            break;
+    }
+}
+function validateNumber(value, schema, path, issues) {
+    if (typeof value !== 'number' || Number.isNaN(value)) {
+        issues.push(`${path || '.'}: expected number, got ${typeof value}`);
+        return;
+    }
+    checkNumericConstraints(value, schema, path, issues);
+}
+function validateInteger(value, schema, path, issues) {
+    if (typeof value !== 'number' || Number.isNaN(value)) {
+        issues.push(`${path || '.'}: expected integer, got ${typeof value}`);
+        return;
+    }
+    if (!Number.isInteger(value))
+        issues.push(`${path || '.'}: expected integer, got float`);
+    checkNumericConstraints(value, schema, path, issues);
+}
+function checkNumericConstraints(value, schema, path, issues) {
+    if (schema.minimum !== undefined && value < schema.minimum)
+        issues.push(`${path || '.'}: must be >= ${schema.minimum}`);
+    if (schema.maximum !== undefined && value > schema.maximum)
+        issues.push(`${path || '.'}: must be <= ${schema.maximum}`);
+    if (schema.exclusiveMinimum !== undefined && value <= schema.exclusiveMinimum)
+        issues.push(`${path || '.'}: must be > ${schema.exclusiveMinimum}`);
+    if (schema.exclusiveMaximum !== undefined && value >= schema.exclusiveMaximum)
+        issues.push(`${path || '.'}: must be < ${schema.exclusiveMaximum}`);
+    if (schema.multipleOf !== undefined && value % schema.multipleOf !== 0)
+        issues.push(`${path || '.'}: must be multiple of ${schema.multipleOf}`);
+    if (schema.enum && !schema.enum.includes(value))
+        issues.push(`${path || '.'}: must be one of ${schema.enum.join(', ')}`);
+}
+function validateBoolean(value, path, issues) {
+    if (typeof value !== 'boolean')
+        issues.push(`${path || '.'}: expected boolean, got ${typeof value}`);
+}
+function validateObject(value, schema, path, issues) {
+    if (typeof value !== 'object' || value === null || Array.isArray(value)) {
+        issues.push(`${path || '.'}: expected object`);
+        return;
+    }
+    const obj = value;
+    const required = schema.required ?? [];
+    // check required fields
+    for (const key of required) {
+        if (!(key in obj) || obj[key] === undefined) {
+            issues.push(`${path ? path + '.' : ''}${key}: required`);
+        }
+    }
+    // validate each property
+    if (schema.properties) {
+        for (const [key, propSchema] of Object.entries(schema.properties)) {
+            if (key in obj && obj[key] !== undefined) {
+                validate(obj[key], propSchema, `${path ? path + '.' : ''}${key}`, issues);
+            }
+        }
+    }
+}
+function validateArray(value, schema, path, issues) {
+    if (!Array.isArray(value)) {
+        issues.push(`${path || '.'}: expected array`);
+        return;
+    }
+    if (schema.minItems !== undefined && value.length < schema.minItems)
+        issues.push(`${path || '.'}: too few items (min ${schema.minItems})`);
+    if (schema.maxItems !== undefined && value.length > schema.maxItems)
+        issues.push(`${path || '.'}: too many items (max ${schema.maxItems})`);
+    if (schema.items) {
+        for (let i = 0; i < value.length; i++) {
+            validate(value[i], schema.items, `${path}[${i}]`, issues);
+        }
+    }
+}
+//# sourceMappingURL=validate.js.map