exisjs 0.7.5 → 0.7.6

package/dist/validator/tex.js

@@ -8,7 +8,7 @@ const tex_types_1 = require("./tex-types");
 class TexBuilder {
     string(opts) {
         let base = 'string';
-        if (opts?.optional)
+        if (opts?.optional || opts?.default !== undefined)
             base += '?';
         if (opts?.nullable)
             base += ' | nullable';
@@ -38,11 +38,11 @@ class TexBuilder {
             base += ' | preventSql';
         if (opts?.preventTraversal)
             base += ' | preventTraversal';
-        return new tex_types_1.TexType(base);
+        return new tex_types_1.TexType(base, opts?.default);
     }
     number(opts) {
         let base = 'number';
-        if (opts?.optional)
+        if (opts?.optional || opts?.default !== undefined)
             base += '?';
         if (opts?.nullable)
             base += ' | nullable';
@@ -54,13 +54,11 @@ class TexBuilder {
             base += ` | min:${opts.min}`;
         if (opts?.max !== undefined)
             base += ` | max:${opts.max}`;
-        if (opts?.default !== undefined)
-            base += ` | default:${opts.default}`;
-        return new tex_types_1.TexType(base);
+        return new tex_types_1.TexType(base, opts?.default);
     }
     boolean(opts) {
         let base = 'boolean';
-        if (opts?.optional)
+        if (opts?.optional || opts?.default !== undefined)
             base += '?';
         if (opts?.nullable)
             base += ' | nullable';
@@ -68,11 +66,11 @@ class TexBuilder {
             base += ' | nullish';
         if (opts?.coerce)
             base += ' | coerce';
-        return new tex_types_1.TexType(base);
+        return new tex_types_1.TexType(base, opts?.default);
     }
     email(opts) {
         let base = 'email';
-        if (opts?.optional)
+        if (opts?.optional || opts?.default !== undefined)
             base += '?';
         if (opts?.nullable)
             base += ' | nullable';
@@ -84,11 +82,11 @@ class TexBuilder {
             base += ' | lowercase';
         if (opts?.mask)
             base += ' | mask';
-        return new tex_types_1.TexType(base);
+        return new tex_types_1.TexType(base, opts?.default);
     }
     uuid(opts) {
         let base = 'uuid';
-        if (opts?.optional)
+        if (opts?.optional || opts?.default !== undefined)
             base += '?';
         if (opts?.nullable)
             base += ' | nullable';
@@ -96,21 +94,21 @@ class TexBuilder {
             base += ' | nullish';
         if (opts?.version)
             base += ` | version:${opts.version}`;
-        return new tex_types_1.TexType(base);
+        return new tex_types_1.TexType(base, opts?.default);
     }
     cuid(opts) {
         let base = 'cuid';
-        if (opts?.optional)
+        if (opts?.optional || opts?.default !== undefined)
             base += '?';
         if (opts?.nullable)
             base += ' | nullable';
         if (opts?.nullish)
             base += ' | nullish';
-        return new tex_types_1.TexType(base);
+        return new tex_types_1.TexType(base, opts?.default);
     }
     creditCard(opts) {
         let base = 'creditcard';
-        if (opts?.optional)
+        if (opts?.optional || opts?.default !== undefined)
             base += '?';
         if (opts?.nullable)
             base += ' | nullable';
@@ -118,11 +116,11 @@ class TexBuilder {
             base += ' | nullish';
         if (opts?.mask)
             base += ' | mask';
-        return new tex_types_1.TexType(base);
+        return new tex_types_1.TexType(base, opts?.default);
     }
     password(opts) {
         let base = 'password';
-        if (opts?.optional)
+        if (opts?.optional || opts?.default !== undefined)
             base += '?';
         if (opts?.nullable)
             base += ' | nullable';
@@ -140,7 +138,7 @@ class TexBuilder {
             base += ' | requireUppercase';
         if (opts?.requireLowercase)
             base += ' | requireLowercase';
-        return new tex_types_1.TexType(base);
+        return new tex_types_1.TexType(base, opts?.default);
     }
     array(schema, opts) {
         let resolvedItem = schema;
@@ -156,7 +154,7 @@ class TexBuilder {
                 ? resolvedItem._raw
                 : resolvedItem;
         let base = `array<${itemSchema}>`;
-        if (opts?.optional)
+        if (opts?.optional || opts?.default !== undefined)
             base += '?';
         if (opts?.nullable)
             base += ' | nullable';
@@ -170,21 +168,19 @@ class TexBuilder {
             base += ' | dedupe';
         if (opts?.coerce)
             base += ' | coerce';
-        const res = new tex_types_1.TexType(base);
+        const res = new tex_types_1.TexType(base, opts?.default);
         res._item = resolvedItem;
         return res;
     }
     enum(values, opts) {
         let base = `enum:${values.join(',')}`;
-        if (opts?.optional)
+        if (opts?.optional || opts?.default !== undefined)
             base += '?';
         if (opts?.nullable)
             base += ' | nullable';
         if (opts?.nullish)
             base += ' | nullish';
-        if (opts?.default)
-            base += ` | default:${opts.default}`;
-        return new tex_types_1.TexType(base);
+        return new tex_types_1.TexType(base, opts?.default);
     }
     literal(value, opts) {
         let base = `literal:${value}`;
@@ -209,7 +205,7 @@ class TexBuilder {
     }
     date(opts) {
         let base = 'date';
-        if (opts?.optional)
+        if (opts?.optional || opts?.default !== undefined)
             base += '?';
         if (opts?.nullable)
             base += ' | nullable';
@@ -221,7 +217,7 @@ class TexBuilder {
             base += ` | minDate:${opts.minDate}`;
         if (opts?.maxDate)
             base += ` | maxDate:${opts.maxDate}`;
-        return new tex_types_1.TexType(base);
+        return new tex_types_1.TexType(base, opts?.default);
     }
     record(schema, opts) {
         const itemSchema = schema instanceof tex_types_1.TexType ? schema._raw : schema;
@@ -274,6 +270,53 @@ class TexBuilder {
         }
         return new TexEngine(compiledSchema, schema, opts?.strict);
     }
+    /**
+     * Dedicated Environment Schema parser (tex.env).
+     * Automatically coerces numbers, booleans, dates, and arrays from process.env string values,
+     * while preserving strict type validation and defaults.
+     */
+    env(schema, opts) {
+        const coercedSchema = {};
+        for (const [key, value] of Object.entries(schema)) {
+            if (value instanceof tex_types_1.TexType) {
+                let raw = value._raw;
+                // Auto-inject coercion if not already present
+                if ((raw.startsWith('number') ||
+                    raw.startsWith('boolean') ||
+                    raw.startsWith('date') ||
+                    raw.startsWith('array<')) &&
+                    !raw.includes('coerce')) {
+                    raw = `${raw} | coerce`;
+                }
+                const cloned = new tex_types_1.TexType(raw, value.defaultValue);
+                cloned.sanitizers = [...value.sanitizers];
+                cloned.refinements = [...value.refinements];
+                if (value._item) {
+                    ;
+                    cloned._item = value._item;
+                }
+                coercedSchema[key] = cloned;
+            }
+            else if (value instanceof TexEngine) {
+                coercedSchema[key] = value;
+            }
+            else if (typeof value === 'string') {
+                let raw = value;
+                if ((raw.startsWith('number') ||
+                    raw.startsWith('boolean') ||
+                    raw.startsWith('date') ||
+                    raw.startsWith('array<')) &&
+                    !raw.includes('coerce')) {
+                    raw = `${raw} | coerce`;
+                }
+                coercedSchema[key] = new tex_types_1.TexType(raw);
+            }
+            else {
+                coercedSchema[key] = value;
+            }
+        }
+        return this.object(coercedSchema, opts);
+    }
     pagination(options) {
         const defaultLimit = options?.defaultLimit ?? 10;
         const maxLimit = options?.maxLimit ?? 100;
@@ -292,12 +335,60 @@ class TexBuilder {
     }
 }
 exports.TexBuilder = TexBuilder;
+function getNestedValue(obj, path) {
+    if (!obj || typeof obj !== 'object' || !path)
+        return undefined;
+    if (path in obj)
+        return obj[path];
+    try {
+        const keys = path.replace(/\[(\w+)\]/g, '.$1').split('.');
+        let curr = obj;
+        for (const k of keys) {
+            if (curr === undefined || curr === null)
+                return undefined;
+            curr = curr[k];
+        }
+        return curr;
+    }
+    catch {
+        return undefined;
+    }
+}
+function formatReceivedValue(val) {
+    if (val === undefined)
+        return 'undefined';
+    if (val === null)
+        return 'null';
+    if (typeof val === 'string')
+        return JSON.stringify(val);
+    if (typeof val === 'number' || typeof val === 'boolean')
+        return String(val);
+    if (Array.isArray(val)) {
+        try {
+            const str = JSON.stringify(val);
+            return str.length > 30 ? `Array(${val.length})` : str;
+        }
+        catch {
+            return `Array(${val.length})`;
+        }
+    }
+    if (typeof val === 'object') {
+        try {
+            const str = JSON.stringify(val);
+            return str.length > 30 ? '[object Object]' : str;
+        }
+        catch {
+            return '[object Object]';
+        }
+    }
+    return String(val);
+}
 class ValidatorError extends Error {
     constructor(errors) {
         super('Validation Error: ' +
             errors.map((e) => `${e.path}: ${e.message}`).join(', '));
-        this.errors = errors;
         this.name = 'ValidatorError';
+        this.errors = errors;
     }
 }
 exports.ValidatorError = ValidatorError;
@@ -359,9 +450,18 @@ class TexEngine {
         return new TexEngine(newSchema, newRaw, this.strict, this._isOptional);
     }
     parse(data) {
-        // 1. Run pre-validation sanitizers on the raw payload (if it's an object)
+        // 1. Apply defaults and run pre-validation sanitizers on the raw payload (if it's an object)
         if (data && typeof data === 'object') {
             for (const [key, val] of Object.entries(this.rawSchema)) {
+                // Apply default value / lazy factory function if field is omitted or undefined
+                if (data[key] === undefined) {
+                    if (val instanceof tex_types_1.TexType && val.defaultValue !== undefined) {
+                        data[key] =
+                            typeof val.defaultValue === 'function'
+                                ? val.defaultValue()
+                                : val.defaultValue;
+                    }
+                }
                 if (typeof data[key] === 'string' && data[key].trim() === '') {
                     const raw = val instanceof tex_types_1.TexType ? val._raw : String(val);
                     if (raw.includes('optional') ||
@@ -376,6 +476,13 @@ class TexEngine {
                         }
                         else {
                             delete data[key];
+                            // If deleted but default is defined, apply default
+                            if (val instanceof tex_types_1.TexType && val.defaultValue !== undefined) {
+                                data[key] =
+                                    typeof val.defaultValue === 'function'
+                                        ? val.defaultValue()
+                                        : val.defaultValue;
+                            }
                         }
                     }
                 }
@@ -387,7 +494,13 @@ class TexEngine {
                                 const d = new Date(data[key]);
                                 if (isNaN(d.getTime())) {
                                     throw new ValidatorError([
-                                        { path: key, message: 'Must be a valid date' },
+                                        {
+                                            path: key,
+                                            message: 'Must be a valid date',
+                                            expected: 'valid date string or timestamp',
+                                            received: formatReceivedValue(data[key]),
+                                            code: 'INVALID_DATE',
+                                        },
                                     ]);
                                 }
                                 data[key] = d;
@@ -397,12 +510,24 @@ class TexEngine {
                             typeof data[key] !== 'string' &&
                             typeof data[key] !== 'number') {
                             throw new ValidatorError([
-                                { path: key, message: 'Must be a valid date' },
+                                {
+                                    path: key,
+                                    message: 'Must be a valid date',
+                                    expected: 'valid date or date string',
+                                    received: formatReceivedValue(data[key]),
+                                    code: 'INVALID_TYPE',
+                                },
                             ]);
                         }
                         if (data[key] instanceof Date && isNaN(data[key].getTime())) {
                             throw new ValidatorError([
-                                { path: key, message: 'Must be a valid date' },
+                                {
+                                    path: key,
+                                    message: 'Must be a valid date',
+                                    expected: 'valid date string or timestamp',
+                                    received: formatReceivedValue(data[key]),
+                                    code: 'INVALID_DATE',
+                                },
                             ]);
                         }
                         if (val._raw.includes('minDate:')) {
@@ -410,7 +535,13 @@ class TexEngine {
                             if (minStr &&
                                 new Date(data[key]).getTime() < new Date(minStr).getTime()) {
                                 throw new ValidatorError([
-                                    { path: key, message: `Date must be after ${minStr}` },
+                                    {
+                                        path: key,
+                                        message: `Date must be after ${minStr}`,
+                                        expected: `>= ${minStr}`,
+                                        received: formatReceivedValue(data[key]),
+                                        code: 'DATE_TOO_EARLY',
+                                    },
                                 ]);
                             }
                         }
@@ -419,7 +550,13 @@ class TexEngine {
                             if (maxStr &&
                                 new Date(data[key]).getTime() > new Date(maxStr).getTime()) {
                                 throw new ValidatorError([
-                                    { path: key, message: `Date must be before ${maxStr}` },
+                                    {
+                                        path: key,
+                                        message: `Date must be before ${maxStr}`,
+                                        expected: `<= ${maxStr}`,
+                                        received: formatReceivedValue(data[key]),
+                                        code: 'DATE_TOO_LATE',
+                                    },
                                 ]);
                             }
                         }
@@ -530,32 +667,115 @@ class TexEngine {
             }
             let path = 'root';
             let message = err.message || 'Validation failed';
+            let expected;
+            let code = 'VALIDATION_ERROR';
             if (message.startsWith('Missing required field: ')) {
                 path = message.replace('Missing required field: ', '').trim();
                 message = 'Expected value, received undefined';
+                expected = 'defined';
+                code = 'MISSING_REQUIRED_FIELD';
             }
             else if (message.startsWith("Field '")) {
                 const match = message.match(/Field '([^']+)' (.+)/);
                 if (match) {
                     path = match[1];
-                    message = match[2].charAt(0).toUpperCase() + match[2].slice(1);
+                    const constraint = match[2];
+                    message = constraint.charAt(0).toUpperCase() + constraint.slice(1);
+                    if (constraint.startsWith('must be a string')) {
+                        expected = 'string';
+                        code = 'INVALID_TYPE';
+                    }
+                    else if (constraint.startsWith('must be a number')) {
+                        expected = 'number';
+                        code = 'INVALID_TYPE';
+                    }
+                    else if (constraint.startsWith('must be a boolean')) {
+                        expected = 'boolean';
+                        code = 'INVALID_TYPE';
+                    }
+                    else if (constraint.startsWith('must be an array') ||
+                        constraint.includes('array must have') ||
+                        constraint.includes('array exceeds')) {
+                        expected = 'array';
+                        code = constraint.includes('array must have')
+                            ? 'ARRAY_TOO_SHORT'
+                            : constraint.includes('array exceeds')
+                                ? 'ARRAY_TOO_LONG'
+                                : 'INVALID_TYPE';
+                    }
+                    else if (constraint.startsWith('must be an object')) {
+                        expected = 'object';
+                        code = 'INVALID_TYPE';
+                    }
+                    else if (constraint.startsWith('must be a valid email')) {
+                        expected = 'valid email address';
+                        code = 'INVALID_EMAIL';
+                    }
+                    else if (constraint.startsWith('must be one of')) {
+                        expected = constraint.replace('must be one of', '').trim();
+                        code = 'INVALID_ENUM_VALUE';
+                    }
+                    else if (constraint.startsWith('must be at least') ||
+                        constraint.startsWith('must be >=')) {
+                        expected = constraint;
+                        code = 'VALUE_TOO_SMALL';
+                    }
+                    else if (constraint.startsWith('must be at most') ||
+                        constraint.startsWith('must be <=')) {
+                        expected = constraint;
+                        code = 'VALUE_TOO_LARGE';
+                    }
+                    else if (constraint.startsWith('must contain a number')) {
+                        expected = 'must contain at least one digit';
+                        code = 'PASSWORD_REQUIRES_NUMBER';
+                    }
+                    else if (constraint.startsWith('must contain an uppercase')) {
+                        expected = 'must contain at least one uppercase letter';
+                        code = 'PASSWORD_REQUIRES_UPPERCASE';
+                    }
+                    else if (constraint.startsWith('must contain a lowercase')) {
+                        expected = 'must contain at least one lowercase letter';
+                        code = 'PASSWORD_REQUIRES_LOWERCASE';
+                    }
+                    else if (constraint.startsWith('must contain a symbol')) {
+                        expected = 'must contain at least one symbol';
+                        code = 'PASSWORD_REQUIRES_SYMBOL';
+                    }
+                    else {
+                        expected = constraint;
+                    }
                 }
             }
             else if (message.startsWith("Strict mode error: Unknown field '")) {
-                const match = message.match(/Strict mode error: Unknown field '([^']+)'/);
+                const match = message.match(/Strict mode error: Unknown field '([^']+)'(?: at path '([^']*)')?/);
                 if (match) {
-                    path = match[1];
+                    const key = match[1];
+                    const parentPath = match[2];
+                    path =
+                        parentPath && parentPath.length > 0 ? `${parentPath}.${key}` : key;
                     message = 'Unknown field not allowed in strict mode';
+                    expected = 'undefined (field omitted)';
+                    code = 'UNRECOGNIZED_KEYS';
                 }
             }
-            throw new ValidatorError([{ path, message }]);
+            const receivedRaw = getNestedValue(data, path);
+            const received = formatReceivedValue(receivedRaw);
+            throw new ValidatorError([{ path, message, expected, received, code }]);
         }
-        // Preserve coerced Date objects
+        // Preserve Date objects and ensure defaults are applied
         if (parsedData && typeof parsedData === 'object') {
             for (const [key, val] of Object.entries(this.rawSchema)) {
+                if (parsedData[key] === undefined &&
+                    val instanceof tex_types_1.TexType &&
+                    val.defaultValue !== undefined) {
+                    parsedData[key] =
+                        typeof val.defaultValue === 'function'
+                            ? val.defaultValue()
+                            : val.defaultValue;
+                }
                 if (val instanceof tex_types_1.TexType &&
                     val._raw.startsWith('date') &&
-                    val._raw.includes('coerce') &&
+                    data &&
                     data[key] instanceof Date) {
                     parsedData[key] = data[key];
                 }
@@ -577,7 +797,13 @@ class TexEngine {
                                 const msg = typeof r.message === 'function'
                                     ? r.message(parsedData[key])
                                     : r.message || 'Invalid value';
-                                errors.push({ path: key, message: msg });
+                                errors.push({
+                                    path: key,
+                                    message: msg,
+                                    expected: 'custom refinement rule',
+                                    received: formatReceivedValue(parsedData[key]),
+                                    code: 'CUSTOM_VALIDATION',
+                                });
                             }
                         }
                     }
@@ -595,7 +821,13 @@ class TexEngine {
                                         const msg = typeof r.message === 'function'
                                             ? r.message(parsedData[key][i])
                                             : r.message || 'Invalid value';
-                                        errors.push({ path: `${key}[${i}]`, message: msg });
+                                        errors.push({
+                                            path: `${key}[${i}]`,
+                                            message: msg,
+                                            expected: 'custom refinement rule',
+                                            received: formatReceivedValue(parsedData[key][i]),
+                                            code: 'CUSTOM_VALIDATION',
+                                        });
                                     }
                                 }
                             }
@@ -626,7 +858,13 @@ class TexEngine {
                             const msg = typeof r.message === 'function'
                                 ? r.message(valData)
                                 : r.message || 'Invalid value';
-                            errors.push({ path: key, message: msg });
+                            errors.push({
+                                path: key,
+                                message: msg,
+                                expected: 'custom async refinement rule',
+                                received: formatReceivedValue(valData),
+                                code: 'CUSTOM_VALIDATION',
+                            });
                         }
                     }
                 }