@zintrust/core 0.1.28 → 0.1.30

package/src/tools/templates/MarkdownRenderer.js

@@ -0,0 +1,300 @@
+/**
+ * MarkdownRenderer - Minimal, safe Markdown -> HTML renderer
+ * - Plain functions only (no classes)
+ * - Designed for emails and notifications
+ * - Performs variable interpolation with HTML-escaping
+ * - Basic markdown features: headings, bold, italic, lists, links, code blocks, inline code
+ * - Safe link sanitization (only allow http(s), mailto, tel)
+ */
+import { ErrorFactory } from '../../exceptions/ZintrustError.js';
+import { XssProtection } from '../../security/XssProtection.js';
+const escapeHtml = (str) => XssProtection.escape(str);
+const sanitizeHref = (href) => {
+    const trimmed = String(href ?? '').trim();
+    if (trimmed === '')
+        return '#';
+    if (XssProtection.isSafeUrl(trimmed) === false)
+        return '#';
+    const encoded = XssProtection.encodeHref(trimmed);
+    if (encoded === '')
+        return '#';
+    return encoded;
+};
+const interpolate = (markdown, variables = {}) => {
+    return markdown.replaceAll(/{{\s*([a-zA-Z0-9_.-]+)\s*}}/g, (_m, key) => {
+        const val = variables[key];
+        if (val === undefined || val === null)
+            return '';
+        return String(val);
+    });
+};
+const renderInline = (text) => {
+    const BACKTICK = '__ZINTRUST_MD_BACKTICK__';
+    // 1) Escape *all* user-provided text for safety, but preserve backticks so we can parse inline-code.
+    // Backticks are not dangerous in HTML text context; they are only meaningful to our markdown parser.
+    let out = String(text).replaceAll('`', BACKTICK);
+    out = XssProtection.escape(out);
+    out = out.replaceAll(BACKTICK, '`');
+    // 2) Apply inline markdown transforms. Captured groups are already escaped.
+    // Inline code
+    out = out.replaceAll(/`([^`]+?)`/g, (_m, code) => `<code>${code}</code>`);
+    // Links [text](url) - use a linear parser to avoid regex backtracking (prevents ReDoS)
+    out = (() => {
+        const s = out;
+        let res = '';
+        let i = 0;
+        while (i < s.length) {
+            const open = s.indexOf('[', i);
+            if (open === -1) {
+                res += s.slice(i);
+                break;
+            }
+            const close = s.indexOf(']', open + 1);
+            if (close === -1) {
+                res += s.slice(i);
+                break;
+            }
+            // only treat as link if '(' immediately follows ']'
+            if (s[close + 1] !== '(') {
+                res += s.slice(i, close + 1);
+                i = close + 1;
+                continue;
+            }
+            const paren = close + 1;
+            const end = s.indexOf(')', paren + 1);
+            if (end === -1) {
+                res += s.slice(i);
+                break;
+            }
+            const txt = s.slice(open + 1, close);
+            const url = s.slice(paren + 1, end);
+            const safeHref = sanitizeHref(url);
+            res +=
+                s.slice(i, open) +
+                    `<a href="${safeHref}" rel="noopener noreferrer" target="_blank">${txt}</a>`;
+            i = end + 1;
+        }
+        return res;
+    })();
+    // Bold **text**
+    out = out.replaceAll(/\*\*([^*]+?)\*\*/g, (_m, t) => `<strong>${t}</strong>`);
+    // Italic *text* or _text_
+    out = out.replaceAll(/\*([^*]+?)\*/g, (_m, t) => `<em>${t}</em>`);
+    out = out.replaceAll(/_([^_]+?)_/g, (_m, t) => `<em>${t}</em>`);
+    return out;
+};
+// Top-level helpers to keep parseMarkdown small
+function handleHeading(line, out) {
+    // Parse headings without regex to avoid any possibility of super-linear backtracking (ReDoS).
+    if (line.length === 0 || !line.startsWith('#'))
+        return false;
+    let level = 0;
+    while (level < line.length && level < 6 && line[level] === '#')
+        level++;
+    // Not a heading if there are more than 6 leading hashes (e.g., ####### ...)
+    if (level === 0)
+        return false;
+    if (level < line.length && line[level] === '#')
+        return false;
+    // Require at least one whitespace after the hashes (Markdown-style "# Heading")
+    if (level >= line.length)
+        return false;
+    if (line[level] !== ' ' && line[level] !== '\t')
+        return false;
+    let i = level;
+    while (i < line.length && (line[i] === ' ' || line[i] === '\t'))
+        i++;
+    const content = renderInline(line.slice(i).trimEnd());
+    out.push(`<h${level}>${content}</h${level}>`);
+    return true;
+}
+function parseUnorderedListItemContent(line) {
+    // Parse without regex to guarantee linear runtime and avoid ReDoS/backtracking issues (sonarqube:S5852).
+    let i = 0;
+    while (i < line.length && (line[i] === ' ' || line[i] === '\t'))
+        i++;
+    if (i >= line.length)
+        return null;
+    const bullet = line[i];
+    if (bullet !== '-' && bullet !== '+' && bullet !== '*')
+        return null;
+    i++; // after bullet
+    if (i >= line.length)
+        return null;
+    // Require whitespace after bullet
+    if (line[i] !== ' ' && line[i] !== '\t')
+        return null;
+    while (i < line.length && (line[i] === ' ' || line[i] === '\t'))
+        i++;
+    const content = line.slice(i);
+    if (content.length === 0)
+        return null;
+    return content;
+}
+function ensureUnorderedListOpen(state, out) {
+    if (state.inUl)
+        return;
+    // close other lists
+    if (state.inOl) {
+        out.push('</ol>');
+        state.inOl = false;
+    }
+    state.inUl = true;
+    out.push('<ul>');
+}
+function handleUnordered(line, state, out) {
+    const content = parseUnorderedListItemContent(line);
+    if (content === null)
+        return false;
+    ensureUnorderedListOpen(state, out);
+    out.push(`<li>${renderInline(content.trim())}</li>`);
+    return true;
+}
+function skipSpacesAndTabs(line, start) {
+    let i = start;
+    while (i < line.length && (line[i] === ' ' || line[i] === '\t'))
+        i++;
+    return i;
+}
+function readAsciiDigitsEnd(line, start) {
+    let i = start;
+    while (i < line.length) {
+        const c = line.codePointAt(i) ?? 0;
+        if (c < 48 || c > 57)
+            break;
+        i++;
+    }
+    return i;
+}
+function parseOrderedListItemContent(line) {
+    // Parse without regex to guarantee linear runtime and avoid ReDoS/backtracking issues (sonarqube:S5852).
+    let i = skipSpacesAndTabs(line, 0);
+    const digitsEnd = readAsciiDigitsEnd(line, i);
+    if (digitsEnd === i)
+        return null; // no digits
+    i = digitsEnd;
+    if (i >= line.length || line[i] !== '.')
+        return null;
+    i++; // after '.'
+    // Require whitespace after "1."
+    if (i >= line.length || (line[i] !== ' ' && line[i] !== '\t'))
+        return null;
+    i = skipSpacesAndTabs(line, i);
+    const content = line.slice(i);
+    return content.length === 0 ? null : content;
+}
+function handleOrdered(line, state, out) {
+    const content = parseOrderedListItemContent(line);
+    if (content === null)
+        return false;
+    if (!state.inOl) {
+        if (state.inUl) {
+            out.push('</ul>');
+            state.inUl = false;
+        }
+        state.inOl = true;
+        out.push('<ol>');
+    }
+    out.push(`<li>${renderInline(content.trim())}</li>`);
+    return true;
+}
+function handleParagraph(line, state, out) {
+    if (/^\s*$/.test(line)) {
+        if (state.inUl) {
+            out.push('</ul>');
+            state.inUl = false;
+        }
+        if (state.inOl) {
+            out.push('</ol>');
+            state.inOl = false;
+        }
+        out.push('');
+        return;
+    }
+    const paragraph = `<p>${renderInline(line.trim())}</p>`;
+    out.push(paragraph);
+}
+function parseMarkdown(markdown) {
+    const lines = markdown.split(/\r?\n/);
+    const out = [];
+    const state = {
+        inCodeBlock: false,
+        codeLang: '',
+        codeBuffer: [],
+        inUl: false,
+        inOl: false,
+    };
+    function handleCodeFence(line) {
+        // Limit the length of the optional language identifier to avoid pathological inputs
+        const m = /^```\s*([a-zA-Z0-9_-]{0,20})$/.exec(line);
+        if (!m)
+            return false;
+        if (state.inCodeBlock) {
+            const codeHtml = escapeHtml(state.codeBuffer.join('\n'));
+            if (state.codeLang) {
+                out.push(`<pre><code class="language-${escapeHtml(state.codeLang)}">${codeHtml}</code></pre>`);
+            }
+            else {
+                out.push(`<pre><code>${codeHtml}</code></pre>`);
+            }
+            state.inCodeBlock = false;
+            state.codeLang = '';
+            state.codeBuffer = [];
+            return true;
+        }
+        // open code fence
+        state.inCodeBlock = true;
+        state.codeLang = m[1] || '';
+        state.codeBuffer = [];
+        return true;
+    }
+    for (const rawLine of lines) {
+        const line = rawLine;
+        if (handleCodeFence(line))
+            continue;
+        if (state.inCodeBlock) {
+            state.codeBuffer.push(line);
+            continue;
+        }
+        if (handleHeading(line, out))
+            continue;
+        if (handleUnordered(line, state, out))
+            continue;
+        if (handleOrdered(line, state, out))
+            continue;
+        handleParagraph(line, state, out);
+    }
+    // Close any remaining lists or code blocks
+    if (state.inCodeBlock) {
+        const codeHtml = escapeHtml(state.codeBuffer.join('\n'));
+        out.push(`<pre><code>${codeHtml}</code></pre>`);
+    }
+    if (state.inUl)
+        out.push('</ul>');
+    if (state.inOl)
+        out.push('</ol>');
+    return out.filter((l) => l !== '').join('\n');
+}
+export const MarkdownRenderer = Object.freeze({
+    render(markdown, variables = {}) {
+        if (typeof markdown !== 'string') {
+            throw ErrorFactory.createValidationError('Markdown must be a string', {
+                type: typeof markdown,
+            });
+        }
+        const interpolated = interpolate(markdown, variables);
+        return parseMarkdown(interpolated);
+    },
+    renderWithLayout(markdown, layout = 'email', variables = {}) {
+        const content = MarkdownRenderer.render(markdown, variables);
+        if (layout === 'notification') {
+            // Minimal wrapper for notifications
+            return `<div class="notification">${content}</div>`;
+        }
+        // Email layout
+        return `<!doctype html><html><head><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1">
+  <style>body{font-family: -apple-system,BlinkMacSystemFont,'Segoe UI',Roboto,'Helvetica Neue',Arial,'Noto Sans',sans-serif;font-size:16px;color:#111;margin:0;padding:0} .email{max-width:680px;margin:20px auto;padding:24px;border:1px solid #eee;background:#fff}</style>
+  </head><body><div class="email">${content}</div></body></html>`;
+    },
+});
+export default MarkdownRenderer;

package/src/tools/templates/index.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Templates tools exports
+ */
+export { MarkdownRenderer } from './MarkdownRenderer';
+//# sourceMappingURL=index.d.ts.map

package/src/tools/templates/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/tools/templates/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC"}

package/src/tools/templates/index.js

@@ -0,0 +1,4 @@
+/**
+ * Templates tools exports
+ */
+export { MarkdownRenderer } from './MarkdownRenderer.js';

package/src/types/Queue.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Queue Types for Advanced Queue Patterns
+ * Defines all interfaces and types for deduplication and lock management
+ */
+export interface DeduplicationOptions {
+    id: string;
+    ttl?: number;
+    dontRelease?: boolean;
+    replace?: boolean;
+    releaseAfter?: string | number | ReleaseCondition;
+}
+export interface ReleaseCondition {
+    condition: string;
+    delay?: number;
+}
+export interface LockOptions {
+    ttl?: number;
+    autoExtend?: boolean;
+    retryDelay?: number;
+}
+export interface Lock {
+    key: string;
+    ttl: number;
+    acquired: boolean;
+    expires: Date;
+}
+export interface LockStatus {
+    exists: boolean;
+    ttl?: number;
+    expires?: Date;
+}
+export interface LockProviderConfig {
+    type: 'redis' | 'database' | 'memory';
+    connection?: unknown;
+    prefix?: string;
+    defaultTtl?: number;
+}
+export interface QueueConfig {
+    name: string;
+    connection?: unknown;
+    defaultDedupTtl?: number;
+    lockProvider?: string;
+}
+export interface AdvancedJobOptions {
+    uniqueId?: string;
+    uniqueVia?: string;
+    deduplication?: DeduplicationOptions;
+}
+export interface JobResult {
+    id: string;
+    deduplicated: boolean;
+    lockId?: string;
+    status: 'queued' | 'deduplicated' | 'failed';
+}
+export interface LockProvider {
+    acquire(key: string, options: LockOptions): Promise<Lock>;
+    release(lock: Lock): Promise<void>;
+    extend(lock: Lock, ttl: number): Promise<boolean>;
+    status(key: string): Promise<LockStatus>;
+    list(pattern?: string): Promise<string[]>;
+}
+//# sourceMappingURL=Queue.d.ts.map

package/src/types/Queue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Queue.d.ts","sourceRoot":"","sources":["../../../src/types/Queue.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,oBAAoB;IACnC,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,gBAAgB,CAAC;CACnD;AAED,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,WAAW;IAC1B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,IAAI;IACnB,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,EAAE,IAAI,CAAC;CACf;AAED,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,OAAO,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,IAAI,CAAC;CAChB;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,OAAO,GAAG,UAAU,GAAG,QAAQ,CAAC;IACtC,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,oBAAoB,CAAC;CACtC;AAED,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,YAAY,EAAE,OAAO,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,QAAQ,GAAG,cAAc,GAAG,QAAQ,CAAC;CAC9C;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1D,OAAO,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnC,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAClD,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IACzC,IAAI,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;CAC3C"}

package/src/types/Queue.js

@@ -0,0 +1,5 @@
+/**
+ * Queue Types for Advanced Queue Patterns
+ * Defines all interfaces and types for deduplication and lock management
+ */
+export {};

package/src/validation/ValidationError.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Validation Error
+ * Structured error response for validation failures with field-level details
+ */
+export interface FieldError {
+    field: string;
+    message: string;
+    rule: string;
+}
+export interface IValidationError extends Error {
+    errors: FieldError[];
+    toObject(): Record<string, string[]>;
+    getFieldError(field: string): string | undefined;
+    hasFieldError(field: string): boolean;
+}
+/**
+ * Convert errors array to field:errors object
+ */
+export declare const toObject: (errors: FieldError[]) => Record<string, string[]>;
+/**
+ * Get first error message for a field
+ */
+export declare const getFieldError: (errors: FieldError[], field: string) => string | undefined;
+/**
+ * Check if field has errors
+ */
+export declare const hasFieldError: (errors: FieldError[], field: string) => boolean;
+/**
+ * Create a validation error instance
+ */
+declare const createValidationError: (errors: FieldError[], message?: string) => IValidationError;
+/**
+ * ValidationError namespace - sealed for immutability
+ */
+export declare const ValidationError: Readonly<{
+    create: (errors: FieldError[], message?: string) => IValidationError;
+    toObject: (errors: FieldError[]) => Record<string, string[]>;
+    getFieldError: (errors: FieldError[], field: string) => string | undefined;
+    hasFieldError: (errors: FieldError[], field: string) => boolean;
+}>;
+export { createValidationError };
+//# sourceMappingURL=ValidationError.d.ts.map

package/src/validation/ValidationError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ValidationError.d.ts","sourceRoot":"","sources":["../../../src/validation/ValidationError.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,gBAAiB,SAAQ,KAAK;IAC7C,MAAM,EAAE,UAAU,EAAE,CAAC;IACrB,QAAQ,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IACrC,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;IACjD,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;CACvC;AAED;;GAEG;AACH,eAAO,MAAM,QAAQ,GAAI,QAAQ,UAAU,EAAE,KAAG,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAWtE,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,aAAa,GAAI,QAAQ,UAAU,EAAE,EAAE,OAAO,MAAM,KAAG,MAAM,GAAG,SAE5E,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,aAAa,GAAI,QAAQ,UAAU,EAAE,EAAE,OAAO,MAAM,KAAG,OAEnE,CAAC;AAEF;;GAEG;AACH,QAAA,MAAM,qBAAqB,GACzB,QAAQ,UAAU,EAAE,EACpB,UAAS,MAA4B,KACpC,gBASF,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,eAAe;qBAhBlB,UAAU,EAAE,YACX,MAAM,KACd,gBAAgB;uBAjCc,UAAU,EAAE,KAAG,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC;4BAgBlC,UAAU,EAAE,SAAS,MAAM,KAAG,MAAM,GAAG,SAAS;4BAOhD,UAAU,EAAE,SAAS,MAAM,KAAG,OAAO;EA6BzE,CAAC;AAGH,OAAO,EAAE,qBAAqB,EAAE,CAAC"}

package/src/validation/ValidationError.js

@@ -0,0 +1,55 @@
+/**
+ * Validation Error
+ * Structured error response for validation failures with field-level details
+ */
+import { ErrorFactory } from '../exceptions/ZintrustError.js';
+/**
+ * Convert errors array to field:errors object
+ */
+export const toObject = (errors) => {
+    const result = {};
+    const MAX_ERRORS_PER_FIELD = 10;
+    for (const error of errors) {
+        result[error.field] ??= [];
+        if (result[error.field].length < MAX_ERRORS_PER_FIELD) {
+            result[error.field].push(error.message);
+        }
+    }
+    return result;
+};
+/**
+ * Get first error message for a field
+ */
+export const getFieldError = (errors, field) => {
+    return errors.find((e) => e.field === field)?.message;
+};
+/**
+ * Check if field has errors
+ */
+export const hasFieldError = (errors, field) => {
+    return errors.some((e) => e.field === field);
+};
+/**
+ * Create a validation error instance
+ */
+const createValidationError = (errors, message = 'Validation failed') => {
+    const error = ErrorFactory.createValidationError(message, {
+        errors,
+    });
+    error.errors = errors;
+    error.toObject = () => toObject(errors);
+    error.getFieldError = (field) => getFieldError(errors, field);
+    error.hasFieldError = (field) => hasFieldError(errors, field);
+    return error;
+};
+/**
+ * ValidationError namespace - sealed for immutability
+ */
+export const ValidationError = Object.freeze({
+    create: createValidationError,
+    toObject,
+    getFieldError,
+    hasFieldError,
+});
+// For backward compatibility with existing imports
+export { createValidationError };

package/src/validation/Validator.d.ts

@@ -0,0 +1,93 @@
+/**
+ * Validator
+ * Schema-based input validation with fluent API matching QueryBuilder style
+ * Sealed namespace pattern - all exports through Validator namespace
+ */
+export type Rule = 'required' | 'email' | 'string' | 'number' | 'boolean' | 'array' | 'integer' | 'min' | 'max' | 'minLength' | 'maxLength' | 'regex' | 'in' | 'custom' | 'alphanumeric' | 'uuid' | 'token' | 'ipAddress' | 'positiveNumber' | 'digits' | 'decimal' | 'url' | 'phone' | 'date';
+export interface ValidationRule {
+    rule: Rule;
+    value?: unknown;
+    message?: string;
+}
+export type CustomValidatorFn = ((value: unknown) => boolean) | ((value: unknown, data: Record<string, unknown>) => boolean);
+export interface ISchemaBase<TReturn> {
+    required(field: string, message?: string): TReturn;
+    string(field: string, message?: string): TReturn;
+    number(field: string, message?: string): TReturn;
+    integer(field: string, message?: string): TReturn;
+    boolean(field: string, message?: string): TReturn;
+    array(field: string, message?: string): TReturn;
+    email(field: string, message?: string): TReturn;
+    min(field: string, value: number, message?: string): TReturn;
+    max(field: string, value: number, message?: string): TReturn;
+    minLength(field: string, value: number, message?: string): TReturn;
+    maxLength(field: string, value: number, message?: string): TReturn;
+    regex(field: string, pattern: RegExp, message?: string): TReturn;
+    in(field: string, values: unknown[], message?: string): TReturn;
+    custom(field: string, validator: CustomValidatorFn, message?: string): TReturn;
+    alphanumeric(field: string, message?: string): TReturn;
+    uuid(field: string, message?: string): TReturn;
+    token(field: string, message?: string): TReturn;
+    ipAddress(field: string, message?: string): TReturn;
+    positiveNumber(field: string, message?: string): TReturn;
+    digits(field: string, message?: string): TReturn;
+    decimal(field: string, message?: string): TReturn;
+    url(field: string, message?: string): TReturn;
+    phone(field: string, message?: string): TReturn;
+    date(field: string, message?: string): TReturn;
+    getRules(): Map<string, ValidationRule[]>;
+}
+export type ISchema = ISchemaBase<ISchema>;
+export type TypedSchema<T> = ISchemaBase<TypedSchema<T>> & {
+    readonly __type?: T;
+};
+export type InferSchema<TSchema> = TSchema extends {
+    readonly __type?: infer T;
+} ? unknown extends T ? never : T : never;
+export interface SchemaType {
+    create(): ISchema;
+}
+/**
+ * Schema builder for defining validation rules
+ * Sealed namespace for immutability
+ */
+export declare const Schema: Readonly<{
+    /**
+     * Create a new schema instance
+     */
+    create(): ISchema;
+    /**
+     * Create a schema instance carrying a declared TypeScript shape.
+     * This enables schema-inferred request typing when paired with validation middleware.
+     */
+    typed<T>(): TypedSchema<T>;
+}>;
+type RuleStringInput = string | string[];
+export type RuleStringMap = Record<string, RuleStringInput>;
+/**
+ * Validator validates data against a schema
+ */
+export declare const Validator: Readonly<{
+    Schema: Readonly<{
+        /**
+         * Create a new schema instance
+         */
+        create(): ISchema;
+        /**
+         * Create a schema instance carrying a declared TypeScript shape.
+         * This enables schema-inferred request typing when paired with validation middleware.
+         */
+        typed<T>(): TypedSchema<T>;
+    }>;
+    validate: (data: Record<string, unknown>, schema: ISchema) => Record<string, unknown>;
+    isValid: (data: Record<string, unknown>, schema: ISchema) => boolean;
+    rulesToSchema: (rules: RuleStringMap) => ISchema;
+    validateRules: (data: Record<string, unknown>, rules: RuleStringMap) => Record<string, unknown>;
+    isValidRules: (data: Record<string, unknown>, rules: RuleStringMap) => boolean;
+}>;
+/**
+ * Export ValidationError for use in tests and applications
+ */
+export { ValidationError } from './ValidationError';
+export type { FieldError } from './ValidationError';
+//# sourceMappingURL=Validator.d.ts.map

package/src/validation/Validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Validator.d.ts","sourceRoot":"","sources":["../../../src/validation/Validator.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,MAAM,MAAM,IAAI,GACZ,UAAU,GACV,OAAO,GACP,QAAQ,GACR,QAAQ,GACR,SAAS,GACT,OAAO,GACP,SAAS,GACT,KAAK,GACL,KAAK,GACL,WAAW,GACX,WAAW,GACX,OAAO,GACP,IAAI,GACJ,QAAQ,GACR,cAAc,GACd,MAAM,GACN,OAAO,GACP,WAAW,GACX,gBAAgB,GAChB,QAAQ,GACR,SAAS,GACT,KAAK,GACL,OAAO,GACP,MAAM,CAAC;AAEX,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,IAAI,CAAC;IACX,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,MAAM,iBAAiB,GACzB,CAAC,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC,GAC7B,CAAC,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,CAAC;AAEjE,MAAM,WAAW,WAAW,CAAC,OAAO;IAClC,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IACnD,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IACjD,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IACjD,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAClD,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAClD,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAChD,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAChD,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAC7D,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAC7D,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IACnE,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IACnE,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IACjE,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAChE,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,iBAAiB,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAC/E,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IACvD,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAC/C,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAChD,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IACpD,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IACzD,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IACjD,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAClD,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAC9C,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAChD,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAC/C,QAAQ,IAAI,GAAG,CAAC,MAAM,EAAE,cAAc,EAAE,CAAC,CAAC;CAC3C;AAED,MAAM,MAAM,OAAO,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC;AAE3C,MAAM,MAAM,WAAW,CAAC,CAAC,IAAI,WAAW,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,GAAG;IAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,CAAA;CAAE,CAAC;AAEnF,MAAM,MAAM,WAAW,CAAC,OAAO,IAAI,OAAO,SAAS;IAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,CAAA;CAAE,GAC5E,OAAO,SAAS,CAAC,GACf,KAAK,GACL,CAAC,GACH,KAAK,CAAC;AA2BV,MAAM,WAAW,UAAU;IACzB,MAAM,IAAI,OAAO,CAAC;CACnB;AAED;;;GAGG;AACH,eAAO,MAAM,MAAM;IACjB;;OAEG;cACO,OAAO;IAkCjB;;;OAGG;UACG,CAAC,KAAK,WAAW,CAAC,CAAC,CAAC;EAG1B,CAAC;AA8EH,KAAK,eAAe,GAAG,MAAM,GAAG,MAAM,EAAE,CAAC;AACzC,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;AAsa5D;;GAEG;AAEH,eAAO,MAAM,SAAS;;QAriBpB;;WAEG;kBACO,OAAO;QAkCjB;;;WAGG;cACG,CAAC,KAAK,WAAW,CAAC,CAAC,CAAC;;qBAQJ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,UAAU,OAAO,KAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;oBAyBnE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,UAAU,OAAO,KAAG,OAAO;2BAmN3C,aAAa,KAAG,OAAO;0BA6B7C,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,SACtB,aAAa,KACnB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;yBAIE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,SAAS,aAAa,KAAG,OAAO;EA4OjF,CAAC;AAEH;;GAEG;AACH,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAC9D,YAAY,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC"}