@oxog/vld 1.1.1 → 1.3.1

package/dist/utils/codec-utils.js

@@ -0,0 +1,205 @@
+/**
+ * Utility functions for codec transformations
+ */
+/**
+ * Convert a base64 string to Uint8Array
+ */
+export function base64ToUint8Array(base64) {
+    // Handle URL-safe base64
+    const base64Clean = base64.replace(/-/g, '+').replace(/_/g, '/');
+    // Add padding if necessary
+    const padded = base64Clean.padEnd(base64Clean.length + (4 - base64Clean.length % 4) % 4, '=');
+    // Decode base64 to binary string
+    const binaryString = safeAtob(padded);
+    // Convert binary string to Uint8Array
+    const bytes = new Uint8Array(binaryString.length);
+    for (let i = 0; i < binaryString.length; i++) {
+        bytes[i] = binaryString.charCodeAt(i);
+    }
+    return bytes;
+}
+/**
+ * Convert Uint8Array to base64 string
+ */
+export function uint8ArrayToBase64(bytes) {
+    // Convert Uint8Array to binary string
+    let binaryString = '';
+    for (let i = 0; i < bytes.length; i++) {
+        binaryString += String.fromCharCode(bytes[i]);
+    }
+    // Encode to base64
+    return safeBtoa(binaryString);
+}
+/**
+ * Convert Uint8Array to URL-safe base64 string
+ */
+export function uint8ArrayToBase64Url(bytes) {
+    const base64 = uint8ArrayToBase64(bytes);
+    // Make URL-safe and remove padding
+    return base64
+        .replace(/\+/g, '-')
+        .replace(/\//g, '_')
+        .replace(/=/g, '');
+}
+/**
+ * Convert hex string to Uint8Array
+ */
+export function hexToUint8Array(hex) {
+    // Remove any 0x prefix if present
+    const cleanHex = hex.startsWith('0x') ? hex.slice(2) : hex;
+    // Ensure even length
+    const paddedHex = cleanHex.length % 2 === 0 ? cleanHex : '0' + cleanHex;
+    const bytes = new Uint8Array(paddedHex.length / 2);
+    for (let i = 0; i < paddedHex.length; i += 2) {
+        bytes[i / 2] = parseInt(paddedHex.substring(i, i + 2), 16);
+    }
+    return bytes;
+}
+/**
+ * Convert Uint8Array to hex string
+ */
+export function uint8ArrayToHex(bytes) {
+    let hex = '';
+    for (let i = 0; i < bytes.length; i++) {
+        const byte = bytes[i].toString(16);
+        hex += byte.length === 1 ? '0' + byte : byte;
+    }
+    return hex;
+}
+/**
+ * Convert string to Uint8Array using UTF-8 encoding
+ */
+export function stringToUint8Array(str) {
+    const encoder = new TextEncoder();
+    return encoder.encode(str);
+}
+/**
+ * Convert Uint8Array to string using UTF-8 decoding
+ */
+export function uint8ArrayToString(bytes) {
+    const decoder = new TextDecoder();
+    return decoder.decode(bytes);
+}
+/**
+ * Check if running in Node.js environment
+ */
+export function isNodeEnvironment() {
+    return typeof globalThis !== 'undefined' &&
+        typeof globalThis.process !== 'undefined' &&
+        globalThis.process.versions != null &&
+        globalThis.process.versions.node != null;
+}
+/**
+ * Validate and sanitize base64 input to prevent prototype pollution
+ */
+function validateBase64Input(encoded) {
+    // Check for null/undefined
+    if (encoded == null) {
+        throw new Error('Base64 input cannot be null or undefined');
+    }
+    // Ensure it's a string
+    if (typeof encoded !== 'string') {
+        throw new Error('Base64 input must be a string');
+    }
+    // Length validation - base64 strings should be reasonable length
+    if (encoded.length > 10000000) { // 10MB limit
+        throw new Error('Base64 input is too large');
+    }
+    // Base64 character validation - only allow valid base64 characters
+    const base64Regex = /^[A-Za-z0-9+/]*={0,2}$/;
+    if (!base64Regex.test(encoded)) {
+        throw new Error('Invalid base64 format');
+    }
+    // Check for padding issues
+    const paddingIndex = encoded.indexOf('=');
+    if (paddingIndex !== -1) {
+        const padding = encoded.substring(paddingIndex);
+        // Only allow '=', '==', or '===' as padding
+        if (!/^={1,2}$/.test(padding) && padding !== '===') {
+            throw new Error('Invalid base64 padding');
+        }
+        // Padding should only be at the end
+        if (paddingIndex < encoded.length - 3) {
+            throw new Error('Base64 padding must be at the end');
+        }
+    }
+    // Additional security check: prevent potential encoded JavaScript
+    // by looking for suspicious patterns that might indicate malicious content
+    const suspiciousPatterns = [
+        /eval/i,
+        /function/i,
+        /javascript:/i,
+        /<script/i,
+        /on\w+\s*=/i,
+        /__proto__/i,
+        /constructor/i,
+        /prototype/i
+    ];
+    // Decode a small portion to check for suspicious content
+    try {
+        const sampleSize = Math.min(100, encoded.length);
+        const sample = encoded.substring(0, sampleSize);
+        const sampleDecoded = typeof atob !== 'undefined'
+            ? atob(sample)
+            : Buffer.from(sample, 'base64').toString('utf8', 0, 50); // Only decode first 50 chars
+        for (const pattern of suspiciousPatterns) {
+            if (pattern.test(sampleDecoded)) {
+                throw new Error('Suspicious content detected in base64 input');
+            }
+        }
+    }
+    catch (error) {
+        if (error instanceof Error && error.message.includes('Suspicious content')) {
+            throw error;
+        }
+        // If decoding fails, continue - it might be invalid base64 which will be caught later
+    }
+}
+/**
+ * Polyfill for atob in Node.js with proper input validation
+ */
+export function safeAtob(encoded) {
+    // Input validation and sanitization
+    validateBase64Input(encoded);
+    if (typeof atob !== 'undefined') {
+        try {
+            return atob(encoded);
+        }
+        catch (error) {
+            throw new Error('Failed to decode base64 data');
+        }
+    }
+    // Node.js fallback with additional validation
+    if (isNodeEnvironment()) {
+        try {
+            // Use Buffer with explicit error handling
+            const buffer = Buffer.from(encoded, 'base64');
+            // Additional validation: ensure the decoded data is reasonable size
+            if (buffer.length > 5000000) { // 5MB limit for decoded data
+                throw new Error('Decoded base64 data is too large');
+            }
+            return buffer.toString('binary');
+        }
+        catch (error) {
+            if (error instanceof Error && error.message.includes('Invalid base64')) {
+                throw new Error('Invalid base64 format');
+            }
+            throw new Error('Failed to decode base64 data in Node.js environment');
+        }
+    }
+    throw new Error('Base64 decoding not supported in this environment');
+}
+/**
+ * Polyfill for btoa in Node.js
+ */
+export function safeBtoa(str) {
+    if (typeof btoa !== 'undefined') {
+        return btoa(str);
+    }
+    // Node.js fallback
+    if (isNodeEnvironment()) {
+        return Buffer.from(str, 'binary').toString('base64');
+    }
+    throw new Error('Base64 encoding not supported in this environment');
+}
+//# sourceMappingURL=codec-utils.js.map

package/dist/utils/codec-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"codec-utils.js","sourceRoot":"","sources":["../../src/utils/codec-utils.ts"],"names":[],"mappings":"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","sourcesContent":["/**\r\n * Utility functions for codec transformations\r\n */\r\n\r\n/**\r\n * Convert a base64 string to Uint8Array\r\n */\r\nexport function base64ToUint8Array(base64: string): Uint8Array {\r\n  // Handle URL-safe base64\r\n  const base64Clean = base64.replace(/-/g, '+').replace(/_/g, '/');\r\n  \r\n  // Add padding if necessary\r\n  const padded = base64Clean.padEnd(base64Clean.length + (4 - base64Clean.length % 4) % 4, '=');\r\n  \r\n  // Decode base64 to binary string\r\n  const binaryString = safeAtob(padded);\r\n  \r\n  // Convert binary string to Uint8Array\r\n  const bytes = new Uint8Array(binaryString.length);\r\n  for (let i = 0; i < binaryString.length; i++) {\r\n    bytes[i] = binaryString.charCodeAt(i);\r\n  }\r\n  \r\n  return bytes;\r\n}\r\n\r\n/**\r\n * Convert Uint8Array to base64 string\r\n */\r\nexport function uint8ArrayToBase64(bytes: Uint8Array): string {\r\n  // Convert Uint8Array to binary string\r\n  let binaryString = '';\r\n  for (let i = 0; i < bytes.length; i++) {\r\n    binaryString += String.fromCharCode(bytes[i]);\r\n  }\r\n  \r\n  // Encode to base64\r\n  return safeBtoa(binaryString);\r\n}\r\n\r\n/**\r\n * Convert Uint8Array to URL-safe base64 string\r\n */\r\nexport function uint8ArrayToBase64Url(bytes: Uint8Array): string {\r\n  const base64 = uint8ArrayToBase64(bytes);\r\n  // Make URL-safe and remove padding\r\n  return base64\r\n    .replace(/\\+/g, '-')\r\n    .replace(/\\//g, '_')\r\n    .replace(/=/g, '');\r\n}\r\n\r\n/**\r\n * Convert hex string to Uint8Array\r\n */\r\nexport function hexToUint8Array(hex: string): Uint8Array {\r\n  // Remove any 0x prefix if present\r\n  const cleanHex = hex.startsWith('0x') ? hex.slice(2) : hex;\r\n  \r\n  // Ensure even length\r\n  const paddedHex = cleanHex.length % 2 === 0 ? cleanHex : '0' + cleanHex;\r\n  \r\n  const bytes = new Uint8Array(paddedHex.length / 2);\r\n  for (let i = 0; i < paddedHex.length; i += 2) {\r\n    bytes[i / 2] = parseInt(paddedHex.substring(i, i + 2), 16);\r\n  }\r\n  \r\n  return bytes;\r\n}\r\n\r\n/**\r\n * Convert Uint8Array to hex string\r\n */\r\nexport function uint8ArrayToHex(bytes: Uint8Array): string {\r\n  let hex = '';\r\n  for (let i = 0; i < bytes.length; i++) {\r\n    const byte = bytes[i].toString(16);\r\n    hex += byte.length === 1 ? '0' + byte : byte;\r\n  }\r\n  return hex;\r\n}\r\n\r\n/**\r\n * Convert string to Uint8Array using UTF-8 encoding\r\n */\r\nexport function stringToUint8Array(str: string): Uint8Array {\r\n  const encoder = new TextEncoder();\r\n  return encoder.encode(str);\r\n}\r\n\r\n/**\r\n * Convert Uint8Array to string using UTF-8 decoding\r\n */\r\nexport function uint8ArrayToString(bytes: Uint8Array): string {\r\n  const decoder = new TextDecoder();\r\n  return decoder.decode(bytes);\r\n}\r\n\r\n/**\r\n * Check if running in Node.js environment\r\n */\r\nexport function isNodeEnvironment(): boolean {\r\n  return typeof globalThis !== 'undefined' && \r\n         typeof globalThis.process !== 'undefined' &&\r\n         globalThis.process.versions != null &&\r\n         globalThis.process.versions.node != null;\r\n}\r\n\r\n/**\r\n * Validate and sanitize base64 input to prevent prototype pollution\r\n */\r\nfunction validateBase64Input(encoded: string): void {\r\n  // Check for null/undefined\r\n  if (encoded == null) {\r\n    throw new Error('Base64 input cannot be null or undefined');\r\n  }\r\n\r\n  // Ensure it's a string\r\n  if (typeof encoded !== 'string') {\r\n    throw new Error('Base64 input must be a string');\r\n  }\r\n\r\n  // Length validation - base64 strings should be reasonable length\r\n  if (encoded.length > 10000000) { // 10MB limit\r\n    throw new Error('Base64 input is too large');\r\n  }\r\n\r\n  // Base64 character validation - only allow valid base64 characters\r\n  const base64Regex = /^[A-Za-z0-9+/]*={0,2}$/;\r\n  if (!base64Regex.test(encoded)) {\r\n    throw new Error('Invalid base64 format');\r\n  }\r\n\r\n  // Check for padding issues\r\n  const paddingIndex = encoded.indexOf('=');\r\n  if (paddingIndex !== -1) {\r\n    const padding = encoded.substring(paddingIndex);\r\n    // Only allow '=', '==', or '===' as padding\r\n    if (!/^={1,2}$/.test(padding) && padding !== '===') {\r\n      throw new Error('Invalid base64 padding');\r\n    }\r\n    // Padding should only be at the end\r\n    if (paddingIndex < encoded.length - 3) {\r\n      throw new Error('Base64 padding must be at the end');\r\n    }\r\n  }\r\n\r\n  // Additional security check: prevent potential encoded JavaScript\r\n  // by looking for suspicious patterns that might indicate malicious content\r\n  const suspiciousPatterns = [\r\n    /eval/i,\r\n    /function/i,\r\n    /javascript:/i,\r\n    /<script/i,\r\n    /on\\w+\\s*=/i,\r\n    /__proto__/i,\r\n    /constructor/i,\r\n    /prototype/i\r\n  ];\r\n\r\n  // Decode a small portion to check for suspicious content\r\n  try {\r\n    const sampleSize = Math.min(100, encoded.length);\r\n    const sample = encoded.substring(0, sampleSize);\r\n    const sampleDecoded = typeof atob !== 'undefined'\r\n      ? atob(sample)\r\n      : Buffer.from(sample, 'base64').toString('utf8', 0, 50); // Only decode first 50 chars\r\n\r\n    for (const pattern of suspiciousPatterns) {\r\n      if (pattern.test(sampleDecoded)) {\r\n        throw new Error('Suspicious content detected in base64 input');\r\n      }\r\n    }\r\n  } catch (error) {\r\n    if (error instanceof Error && error.message.includes('Suspicious content')) {\r\n      throw error;\r\n    }\r\n    // If decoding fails, continue - it might be invalid base64 which will be caught later\r\n  }\r\n}\r\n\r\n/**\r\n * Polyfill for atob in Node.js with proper input validation\r\n */\r\nexport function safeAtob(encoded: string): string {\r\n  // Input validation and sanitization\r\n  validateBase64Input(encoded);\r\n\r\n  if (typeof atob !== 'undefined') {\r\n    try {\r\n      return atob(encoded);\r\n    } catch (error) {\r\n      throw new Error('Failed to decode base64 data');\r\n    }\r\n  }\r\n\r\n  // Node.js fallback with additional validation\r\n  if (isNodeEnvironment()) {\r\n    try {\r\n      // Use Buffer with explicit error handling\r\n      const buffer = Buffer.from(encoded, 'base64');\r\n\r\n      // Additional validation: ensure the decoded data is reasonable size\r\n      if (buffer.length > 5000000) { // 5MB limit for decoded data\r\n        throw new Error('Decoded base64 data is too large');\r\n      }\r\n\r\n      return buffer.toString('binary');\r\n    } catch (error) {\r\n      if (error instanceof Error && error.message.includes('Invalid base64')) {\r\n        throw new Error('Invalid base64 format');\r\n      }\r\n      throw new Error('Failed to decode base64 data in Node.js environment');\r\n    }\r\n  }\r\n\r\n  throw new Error('Base64 decoding not supported in this environment');\r\n}\r\n\r\n/**\r\n * Polyfill for btoa in Node.js\r\n */\r\nexport function safeBtoa(str: string): string {\r\n  if (typeof btoa !== 'undefined') {\r\n    return btoa(str);\r\n  }\r\n  \r\n  // Node.js fallback\r\n  if (isNodeEnvironment()) {\r\n    return Buffer.from(str, 'binary').toString('base64');\r\n  }\r\n  \r\n  throw new Error('Base64 encoding not supported in this environment');\r\n}"]}

package/dist/utils/deep-merge.d.ts

@@ -4,6 +4,7 @@
 export declare function isPlainObject(obj: any): obj is Record<string, any>;
 /**
  * Safely deep merge two objects without prototype pollution vulnerability
+ * Optimized for performance with minimal object allocations
  * @param target The target object
  * @param source The source object to merge from
  * @returns A new merged object

package/dist/utils/deep-merge.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"deep-merge.d.ts","sourceRoot":"","sources":["../../src/utils/deep-merge.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,GAAG,GAAG,GAAG,IAAI,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAOlE;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACrD,MAAM,EAAE,CAAC,EACT,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,GACjB,CAAC,CA+BH;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAuBjD"}
+{"version":3,"file":"deep-merge.d.ts","sourceRoot":"","sources":["../../src/utils/deep-merge.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,GAAG,GAAG,GAAG,IAAI,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAOlE;AA6BD;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACrD,MAAM,EAAE,CAAC,EACT,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,GACjB,CAAC,CAiCH;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAuBjD"}

package/dist/utils/deep-merge.js

@@ -7,23 +7,48 @@ export function isPlainObject(obj) {
         obj.constructor === Object &&
         Object.prototype.toString.call(obj) === '[object Object]');
 }
+/**
+ * Check if a key could be dangerous for prototype pollution
+ */
+function isDangerousKey(key) {
+    // Direct dangerous keys
+    const directDangerousKeys = ['__proto__', 'constructor', 'prototype'];
+    if (directDangerousKeys.includes(key)) {
+        return true;
+    }
+    // Nested prototype manipulation vectors
+    const nestedPatterns = [
+        'constructor.prototype',
+        '__proto__.toString',
+        'prototype.constructor'
+    ];
+    // Check for nested patterns
+    for (const pattern of nestedPatterns) {
+        if (key.includes(pattern)) {
+            return true;
+        }
+    }
+    return false;
+}
 /**
  * Safely deep merge two objects without prototype pollution vulnerability
+ * Optimized for performance with minimal object allocations
  * @param target The target object
  * @param source The source object to merge from
  * @returns A new merged object
  */
 export function deepMerge(target, source) {
-    // Prevent prototype pollution
-    const DANGEROUS_KEYS = ['__proto__', 'constructor', 'prototype'];
-    // Create a new object to avoid mutations
+    // Create a new object to avoid mutations (only once)
     const result = { ...target };
-    for (const key in source) {
+    // Get source keys directly for better performance
+    const sourceKeys = Object.keys(source);
+    for (let i = 0; i < sourceKeys.length; i++) {
+        const key = sourceKeys[i];
         // Skip dangerous keys that could lead to prototype pollution
-        if (DANGEROUS_KEYS.includes(key)) {
+        if (isDangerousKey(key)) {
             continue;
         }
-        // Only process own properties, not inherited ones
+        // Only process own properties (redundant with Object.keys but safe)
         if (!Object.prototype.hasOwnProperty.call(source, key)) {
             continue;
         }
@@ -56,8 +81,8 @@ export function deepFreeze(obj) {
     }
     // Freeze the object/function itself
     Object.freeze(obj);
-    // Recursively freeze all properties
-    Object.getOwnPropertyNames(obj).forEach(prop => {
+    // Recursively freeze all properties (including Symbol properties)
+    Reflect.ownKeys(obj).forEach(prop => {
         const value = obj[prop];
         if (value !== null && (typeof value === 'object' || typeof value === 'function')) {
             deepFreeze(value);

package/dist/utils/deep-merge.js.map

@@ -1 +1 @@
-{"version":3,"file":"deep-merge.js","sourceRoot":"","sources":["../../src/utils/deep-merge.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,GAAQ;IACpC,OAAO,CACL,GAAG,KAAK,IAAI;QACZ,OAAO,GAAG,KAAK,QAAQ;QACvB,GAAG,CAAC,WAAW,KAAK,MAAM;QAC1B,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,iBAAiB,CAC1D,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,SAAS,CACvB,MAAS,EACT,MAAkB;IAElB,8BAA8B;IAC9B,MAAM,cAAc,GAAG,CAAC,WAAW,EAAE,aAAa,EAAE,WAAW,CAAC,CAAC;IAEjE,yCAAyC;IACzC,MAAM,MAAM,GAAG,EAAE,GAAG,MAAM,EAAO,CAAC;IAElC,KAAK,MAAM,GAAG,IAAI,MAAM,EAAE,CAAC;QACzB,6DAA6D;QAC7D,IAAI,cAAc,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YACjC,SAAS;QACX,CAAC;QAED,kDAAkD;QAClD,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,CAAC;YACvD,SAAS;QACX,CAAC;QAED,MAAM,WAAW,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;QAChC,MAAM,WAAW,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;QAEhC,2DAA2D;QAC3D,IAAI,aAAa,CAAC,WAAW,CAAC,IAAI,aAAa,CAAC,WAAW,CAAC,EAAE,CAAC;YAC5D,MAAc,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC,WAAkB,EAAE,WAAkB,CAAC,CAAC;QAC3E,CAAC;aAAM,CAAC;YACN,wDAAwD;YACvD,MAAc,CAAC,GAAG,CAAC,GAAG,WAAW,CAAC;QACrC,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,UAAU,CAAI,GAAM;IAClC,yCAAyC;IACzC,IAAI,GAAG,KAAK,IAAI,IAAI,CAAC,OAAO,GAAG,KAAK,QAAQ,IAAI,OAAO,GAAG,KAAK,UAAU,CAAC,EAAE,CAAC;QAC3E,OAAO,GAAG,CAAC;IACb,CAAC;IAED,wDAAwD;IACxD,IAAI,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QACzB,OAAO,GAAG,CAAC;IACb,CAAC;IAED,oCAAoC;IACpC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAEnB,oCAAoC;IACpC,MAAM,CAAC,mBAAmB,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE;QAC7C,MAAM,KAAK,GAAI,GAAW,CAAC,IAAI,CAAC,CAAC;QACjC,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,UAAU,CAAC,EAAE,CAAC;YACjF,UAAU,CAAC,KAAK,CAAC,CAAC;QACpB,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,OAAO,GAAG,CAAC;AACb,CAAC","sourcesContent":["/**\n * Type guard to check if a value is a plain object\n */\nexport function isPlainObject(obj: any): obj is Record<string, any> {\n  return (\n    obj !== null &&\n    typeof obj === 'object' &&\n    obj.constructor === Object &&\n    Object.prototype.toString.call(obj) === '[object Object]'\n  );\n}\n\n/**\n * Safely deep merge two objects without prototype pollution vulnerability\n * @param target The target object\n * @param source The source object to merge from\n * @returns A new merged object\n */\nexport function deepMerge<T extends Record<string, any>>(\n  target: T,\n  source: Partial<T>\n): T {\n  // Prevent prototype pollution\n  const DANGEROUS_KEYS = ['__proto__', 'constructor', 'prototype'];\n  \n  // Create a new object to avoid mutations\n  const result = { ...target } as T;\n  \n  for (const key in source) {\n    // Skip dangerous keys that could lead to prototype pollution\n    if (DANGEROUS_KEYS.includes(key)) {\n      continue;\n    }\n    \n    // Only process own properties, not inherited ones\n    if (!Object.prototype.hasOwnProperty.call(source, key)) {\n      continue;\n    }\n    \n    const sourceValue = source[key];\n    const targetValue = target[key];\n    \n    // If both values are plain objects, merge them recursively\n    if (isPlainObject(sourceValue) && isPlainObject(targetValue)) {\n      (result as any)[key] = deepMerge(targetValue as any, sourceValue as any);\n    } else {\n      // Otherwise, use the source value (including undefined)\n      (result as any)[key] = sourceValue;\n    }\n  }\n  \n  return result;\n}\n\n/**\n * Freeze an object deeply to prevent any mutations\n * @param obj Object to freeze\n * @returns The frozen object\n */\nexport function deepFreeze<T>(obj: T): Readonly<T> {\n  // Primitive values don't need processing\n  if (obj === null || (typeof obj !== 'object' && typeof obj !== 'function')) {\n    return obj;\n  }\n  \n  // Check if already frozen to prevent infinite recursion\n  if (Object.isFrozen(obj)) {\n    return obj;\n  }\n  \n  // Freeze the object/function itself\n  Object.freeze(obj);\n  \n  // Recursively freeze all properties\n  Object.getOwnPropertyNames(obj).forEach(prop => {\n    const value = (obj as any)[prop];\n    if (value !== null && (typeof value === 'object' || typeof value === 'function')) {\n      deepFreeze(value);\n    }\n  });\n  \n  return obj;\n}"]}
+{"version":3,"file":"deep-merge.js","sourceRoot":"","sources":["../../src/utils/deep-merge.ts"],"names":[],"mappings":"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","sourcesContent":["/**\r\n * Type guard to check if a value is a plain object\r\n */\r\nexport function isPlainObject(obj: any): obj is Record<string, any> {\r\n  return (\r\n    obj !== null &&\r\n    typeof obj === 'object' &&\r\n    obj.constructor === Object &&\r\n    Object.prototype.toString.call(obj) === '[object Object]'\r\n  );\r\n}\r\n\r\n/**\r\n * Check if a key could be dangerous for prototype pollution\r\n */\r\nfunction isDangerousKey(key: string): boolean {\r\n  // Direct dangerous keys\r\n  const directDangerousKeys = ['__proto__', 'constructor', 'prototype'];\r\n  if (directDangerousKeys.includes(key)) {\r\n    return true;\r\n  }\r\n\r\n  // Nested prototype manipulation vectors\r\n  const nestedPatterns = [\r\n    'constructor.prototype',\r\n    '__proto__.toString',\r\n    'prototype.constructor'\r\n  ];\r\n\r\n  // Check for nested patterns\r\n  for (const pattern of nestedPatterns) {\r\n    if (key.includes(pattern)) {\r\n      return true;\r\n    }\r\n  }\r\n\r\n  return false;\r\n}\r\n\r\n/**\r\n * Safely deep merge two objects without prototype pollution vulnerability\r\n * Optimized for performance with minimal object allocations\r\n * @param target The target object\r\n * @param source The source object to merge from\r\n * @returns A new merged object\r\n */\r\nexport function deepMerge<T extends Record<string, any>>(\r\n  target: T,\r\n  source: Partial<T>\r\n): T {\r\n  // Create a new object to avoid mutations (only once)\r\n  const result = { ...target } as T;\r\n\r\n  // Get source keys directly for better performance\r\n  const sourceKeys = Object.keys(source);\r\n\r\n  for (let i = 0; i < sourceKeys.length; i++) {\r\n    const key = sourceKeys[i];\r\n\r\n    // Skip dangerous keys that could lead to prototype pollution\r\n    if (isDangerousKey(key)) {\r\n      continue;\r\n    }\r\n\r\n    // Only process own properties (redundant with Object.keys but safe)\r\n    if (!Object.prototype.hasOwnProperty.call(source, key)) {\r\n      continue;\r\n    }\r\n\r\n    const sourceValue = source[key];\r\n    const targetValue = target[key];\r\n\r\n    // If both values are plain objects, merge them recursively\r\n    if (isPlainObject(sourceValue) && isPlainObject(targetValue)) {\r\n      (result as any)[key] = deepMerge(targetValue as any, sourceValue as any);\r\n    } else {\r\n      // Otherwise, use the source value (including undefined)\r\n      (result as any)[key] = sourceValue;\r\n    }\r\n  }\r\n\r\n  return result;\r\n}\r\n\r\n/**\r\n * Freeze an object deeply to prevent any mutations\r\n * @param obj Object to freeze\r\n * @returns The frozen object\r\n */\r\nexport function deepFreeze<T>(obj: T): Readonly<T> {\r\n  // Primitive values don't need processing\r\n  if (obj === null || (typeof obj !== 'object' && typeof obj !== 'function')) {\r\n    return obj;\r\n  }\r\n  \r\n  // Check if already frozen to prevent infinite recursion\r\n  if (Object.isFrozen(obj)) {\r\n    return obj;\r\n  }\r\n  \r\n  // Freeze the object/function itself\r\n  Object.freeze(obj);\r\n\r\n  // Recursively freeze all properties (including Symbol properties)\r\n  Reflect.ownKeys(obj).forEach(prop => {\r\n    const value = (obj as any)[prop];\r\n    if (value !== null && (typeof value === 'object' || typeof value === 'function')) {\r\n      deepFreeze(value);\r\n    }\r\n  });\r\n  \r\n  return obj;\r\n}"]}

package/dist/validators/array.d.ts

@@ -20,6 +20,11 @@ export declare class VldArray<T> extends VldBase<unknown[], T[]> {
      * Safely parse and validate an array value
      */
     safeParse(value: unknown): ParseResult<T[]>;
+    /**
+     * Create a stable string representation of an object for hashing
+     * Handles circular references gracefully
+     */
+    private stableStringify;
     /**
      * Create a new validator with minimum length constraint
      */

package/dist/validators/array.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"array.d.ts","sourceRoot":"","sources":["../../src/validators/array.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AAe9C;;GAEG;AACH,qBAAa,QAAQ,CAAC,CAAC,CAAE,SAAQ,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,EAAE,CAAC;IACtD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA0B;IAEjD;;OAEG;IACH,OAAO;IAKP;;OAEG;IACH,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,aAAa,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC;IAIjE;;OAEG;IACH,KAAK,CAAC,KAAK,EAAE,OAAO,GAAG,CAAC,EAAE;IA6C1B;;OAEG;IACH,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,WAAW,CAAC,CAAC,EAAE,CAAC;IAQ3C;;OAEG;IACH,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAC,CAAC,CAAC;IAQlD;;OAEG;IACH,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAC,CAAC,CAAC;IAQlD;;OAEG;IACH,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAC,CAAC,CAAC;IAUrD;;OAEG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAC,CAAC,CAAC;IAQvC;;OAEG;IACH,MAAM,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAC,CAAC,CAAC;IAQrC;;OAEG;IACH,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAC,CAAC,CAAC;CAQjE"}
+{"version":3,"file":"array.d.ts","sourceRoot":"","sources":["../../src/validators/array.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AAe9C;;GAEG;AACH,qBAAa,QAAQ,CAAC,CAAC,CAAE,SAAQ,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,EAAE,CAAC;IACtD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA0B;IAEjD;;OAEG;IACH,OAAO;IAKP;;OAEG;IACH,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,aAAa,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC;IAIjE;;OAEG;IACH,KAAK,CAAC,KAAK,EAAE,OAAO,GAAG,CAAC,EAAE;IA6C1B;;OAEG;IACH,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,WAAW,CAAC,CAAC,EAAE,CAAC;IAQ3C;;;OAGG;IACH,OAAO,CAAC,eAAe;IA2BvB;;OAEG;IACH,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAC,CAAC,CAAC;IAQlD;;OAEG;IACH,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAC,CAAC,CAAC;IAQlD;;OAEG;IACH,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAC,CAAC,CAAC;IAUrD;;OAEG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAC,CAAC,CAAC;IAQvC;;OAEG;IACH,MAAM,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAC,CAAC,CAAC;IAQrC;;OAEG;IACH,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAC,CAAC,CAAC;CAQjE"}

package/dist/validators/array.js

@@ -48,7 +48,7 @@ export class VldArray extends VldBase {
         if (this.config.unique) {
             const seen = new Set();
             for (const item of result) {
-                const key = typeof item === 'object' ? JSON.stringify(item) : item;
+                const key = typeof item === 'object' ? this.stableStringify(item) : item;
                 if (seen.has(key)) {
                     throw new Error('Array must contain unique items');
                 }
@@ -68,6 +68,35 @@ export class VldArray extends VldBase {
             return { success: false, error: error };
         }
     }
+    /**
+     * Create a stable string representation of an object for hashing
+     * Handles circular references gracefully
+     */
+    stableStringify(obj) {
+        const seen = new WeakSet();
+        const replacer = (_key, value) => {
+            if (typeof value === 'object' && value !== null) {
+                if (seen.has(value)) {
+                    return '[Circular]';
+                }
+                seen.add(value);
+            }
+            return value;
+        };
+        try {
+            const allKeys = [];
+            JSON.stringify(obj, (key, value) => {
+                allKeys.push(key);
+                return replacer(key, value);
+            });
+            allKeys.sort();
+            return JSON.stringify(obj, (_key, value) => replacer(_key, value));
+        }
+        catch (error) {
+            // Fallback to safe representation if stringify fails
+            return String(obj);
+        }
+    }
     /**
      * Create a new validator with minimum length constraint
      */

package/dist/validators/array.js.map

@@ -1 +1 @@
-{"version":3,"file":"array.js","sourceRoot":"","sources":["../../src/validators/array.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAe,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAczC;;GAEG;AACH,MAAM,OAAO,QAAY,SAAQ,OAAuB;IAGtD;;OAEG;IACH,YAAoB,MAA+B;QACjD,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,MAAM,CAAI,aAAkC;QACjD,OAAO,IAAI,QAAQ,CAAC,EAAE,aAAa,EAAE,CAAC,CAAC;IACzC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,KAAc;QAClB,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YAC1B,MAAM,IAAI,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,YAAY,IAAI,WAAW,EAAE,CAAC,YAAY,CAAC,CAAC;QAC1E,CAAC;QAED,8BAA8B;QAC9B,IAAI,IAAI,CAAC,MAAM,CAAC,WAAW,KAAK,SAAS,IAAI,KAAK,CAAC,MAAM,KAAK,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC;YACtF,MAAM,IAAI,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,YAAY,IAAI,WAAW,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC;QAClG,CAAC;QAED,IAAI,IAAI,CAAC,MAAM,CAAC,SAAS,KAAK,SAAS,IAAI,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC;YAChF,MAAM,IAAI,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,YAAY,IAAI,WAAW,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC;QAC7F,CAAC;QAED,IAAI,IAAI,CAAC,MAAM,CAAC,SAAS,KAAK,SAAS,IAAI,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC;YAChF,MAAM,IAAI,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,YAAY,IAAI,WAAW,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC;QAC7F,CAAC;QAED,uDAAuD;QACvD,MAAM,MAAM,GAAQ,EAAE,CAAC;QACvB,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;QAE5B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YAChC,MAAM,WAAW,GAAG,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;YAClE,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,CAAC;gBACzB,MAAM,IAAI,KAAK,CAAC,WAAW,EAAE,CAAC,SAAS,CAAC,CAAC,EAAE,WAAW,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;YACzE,CAAC;YACD,MAAM,CAAC,CAAC,CAAC,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC,wCAAwC;QACxE,CAAC;QAED,+BAA+B;QAC/B,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;YACvB,MAAM,IAAI,GAAG,IAAI,GAAG,EAAO,CAAC;YAC5B,KAAK,MAAM,IAAI,IAAI,MAAM,EAAE,CAAC;gBAC1B,MAAM,GAAG,GAAG,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;gBACnE,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;oBAClB,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC;gBACrD,CAAC;gBACD,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YAChB,CAAC;QACH,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;OAEG;IACH,SAAS,CAAC,KAAc;QACtB,IAAI,CAAC;YACH,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;QACpD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,KAAc,EAAE,CAAC;QACnD,CAAC;IACH,CAAC;IAED;;OAEG;IACH,GAAG,CAAC,MAAc,EAAE,OAAgB;QAClC,OAAO,IAAI,QAAQ,CAAC;YAClB,GAAG,IAAI,CAAC,MAAM;YACd,SAAS,EAAE,MAAM;YACjB,YAAY,EAAE,OAAO,IAAI,WAAW,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC;SACxD,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,GAAG,CAAC,MAAc,EAAE,OAAgB;QAClC,OAAO,IAAI,QAAQ,CAAC;YAClB,GAAG,IAAI,CAAC,MAAM;YACd,SAAS,EAAE,MAAM;YACjB,YAAY,EAAE,OAAO,IAAI,WAAW,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC;SACxD,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,MAAc,EAAE,OAAgB;QACrC,OAAO,IAAI,QAAQ,CAAC;YAClB,GAAG,IAAI,CAAC,MAAM;YACd,WAAW,EAAE,MAAM;YACnB,SAAS,EAAE,SAAS;YACpB,SAAS,EAAE,SAAS;YACpB,YAAY,EAAE,OAAO,IAAI,WAAW,EAAE,CAAC,WAAW,CAAC,MAAM,CAAC;SAC3D,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,QAAQ,CAAC,OAAgB;QACvB,OAAO,IAAI,QAAQ,CAAC;YAClB,GAAG,IAAI,CAAC,MAAM;YACd,SAAS,EAAE,CAAC;YACZ,YAAY,EAAE,OAAO,IAAI,WAAW,EAAE,CAAC,UAAU;SAClD,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,OAAgB;QACrB,OAAO,IAAI,QAAQ,CAAC;YAClB,GAAG,IAAI,CAAC,MAAM;YACd,MAAM,EAAE,IAAI;YACZ,YAAY,EAAE,OAAO,IAAI,iCAAiC;SAC3D,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,OAAO,CAAC,GAAW,EAAE,GAAW,EAAE,OAAgB;QAChD,OAAO,IAAI,QAAQ,CAAC;YAClB,GAAG,IAAI,CAAC,MAAM;YACd,SAAS,EAAE,GAAG;YACd,SAAS,EAAE,GAAG;YACd,YAAY,EAAE,OAAO,IAAI,gCAAgC,GAAG,QAAQ,GAAG,EAAE;SAC1E,CAAC,CAAC;IACL,CAAC;CACF","sourcesContent":["import { VldBase, ParseResult } from './base';\nimport { getMessages } from '../locales';\n\n/**\n * Configuration for array validator\n */\ninterface ArrayValidatorConfig<T> {\n  readonly itemValidator: VldBase<unknown, T>;\n  readonly minLength?: number;\n  readonly maxLength?: number;\n  readonly exactLength?: number;\n  readonly unique?: boolean;\n  readonly errorMessage?: string;\n}\n\n/**\n * Immutable array validator with chainable methods\n */\nexport class VldArray<T> extends VldBase<unknown[], T[]> {\n  private readonly config: ArrayValidatorConfig<T>;\n  \n  /**\n   * Private constructor to enforce immutability\n   */\n  private constructor(config: ArrayValidatorConfig<T>) {\n    super();\n    this.config = config;\n  }\n  \n  /**\n   * Create a new array validator\n   */\n  static create<T>(itemValidator: VldBase<unknown, T>): VldArray<T> {\n    return new VldArray({ itemValidator });\n  }\n  \n  /**\n   * Parse and validate an array value\n   */\n  parse(value: unknown): T[] {\n    if (!Array.isArray(value)) {\n      throw new Error(this.config.errorMessage || getMessages().invalidArray);\n    }\n    \n    // Validate length constraints\n    if (this.config.exactLength !== undefined && value.length !== this.config.exactLength) {\n      throw new Error(this.config.errorMessage || getMessages().arrayLength(this.config.exactLength));\n    }\n    \n    if (this.config.minLength !== undefined && value.length < this.config.minLength) {\n      throw new Error(this.config.errorMessage || getMessages().arrayMin(this.config.minLength));\n    }\n    \n    if (this.config.maxLength !== undefined && value.length > this.config.maxLength) {\n      throw new Error(this.config.errorMessage || getMessages().arrayMax(this.config.maxLength));\n    }\n    \n    // Validate each item with optimized loop and safeParse\n    const result: T[] = [];\n    const length = value.length;\n    \n    for (let i = 0; i < length; i++) {\n      const parseResult = this.config.itemValidator.safeParse(value[i]);\n      if (!parseResult.success) {\n        throw new Error(getMessages().arrayItem(i, parseResult.error.message));\n      }\n      result[i] = parseResult.data; // Direct assignment is faster than push\n    }\n    \n    // Check uniqueness if required\n    if (this.config.unique) {\n      const seen = new Set<any>();\n      for (const item of result) {\n        const key = typeof item === 'object' ? JSON.stringify(item) : item;\n        if (seen.has(key)) {\n          throw new Error('Array must contain unique items');\n        }\n        seen.add(key);\n      }\n    }\n    \n    return result;\n  }\n  \n  /**\n   * Safely parse and validate an array value\n   */\n  safeParse(value: unknown): ParseResult<T[]> {\n    try {\n      return { success: true, data: this.parse(value) };\n    } catch (error) {\n      return { success: false, error: error as Error };\n    }\n  }\n  \n  /**\n   * Create a new validator with minimum length constraint\n   */\n  min(length: number, message?: string): VldArray<T> {\n    return new VldArray({\n      ...this.config,\n      minLength: length,\n      errorMessage: message || getMessages().arrayMin(length)\n    });\n  }\n  \n  /**\n   * Create a new validator with maximum length constraint\n   */\n  max(length: number, message?: string): VldArray<T> {\n    return new VldArray({\n      ...this.config,\n      maxLength: length,\n      errorMessage: message || getMessages().arrayMax(length)\n    });\n  }\n  \n  /**\n   * Create a new validator with exact length constraint\n   */\n  length(length: number, message?: string): VldArray<T> {\n    return new VldArray({\n      ...this.config,\n      exactLength: length,\n      minLength: undefined,\n      maxLength: undefined,\n      errorMessage: message || getMessages().arrayLength(length)\n    });\n  }\n  \n  /**\n   * Create a new validator that ensures array is not empty\n   */\n  nonempty(message?: string): VldArray<T> {\n    return new VldArray({\n      ...this.config,\n      minLength: 1,\n      errorMessage: message || getMessages().arrayEmpty\n    });\n  }\n  \n  /**\n   * Create a new validator that ensures array contains unique items\n   */\n  unique(message?: string): VldArray<T> {\n    return new VldArray({\n      ...this.config,\n      unique: true,\n      errorMessage: message || 'Array must contain unique items'\n    });\n  }\n  \n  /**\n   * Create a new validator with a range constraint for length\n   */\n  between(min: number, max: number, message?: string): VldArray<T> {\n    return new VldArray({\n      ...this.config,\n      minLength: min,\n      maxLength: max,\n      errorMessage: message || `Array length must be between ${min} and ${max}`\n    });\n  }\n}"]}
+{"version":3,"file":"array.js","sourceRoot":"","sources":["../../src/validators/array.ts"],"names":[],"mappings":"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","sourcesContent":["import { VldBase, ParseResult } from './base';\r\nimport { getMessages } from '../locales';\r\n\r\n/**\r\n * Configuration for array validator\r\n */\r\ninterface ArrayValidatorConfig<T> {\r\n  readonly itemValidator: VldBase<unknown, T>;\r\n  readonly minLength?: number;\r\n  readonly maxLength?: number;\r\n  readonly exactLength?: number;\r\n  readonly unique?: boolean;\r\n  readonly errorMessage?: string;\r\n}\r\n\r\n/**\r\n * Immutable array validator with chainable methods\r\n */\r\nexport class VldArray<T> extends VldBase<unknown[], T[]> {\r\n  private readonly config: ArrayValidatorConfig<T>;\r\n  \r\n  /**\r\n   * Private constructor to enforce immutability\r\n   */\r\n  private constructor(config: ArrayValidatorConfig<T>) {\r\n    super();\r\n    this.config = config;\r\n  }\r\n  \r\n  /**\r\n   * Create a new array validator\r\n   */\r\n  static create<T>(itemValidator: VldBase<unknown, T>): VldArray<T> {\r\n    return new VldArray({ itemValidator });\r\n  }\r\n  \r\n  /**\r\n   * Parse and validate an array value\r\n   */\r\n  parse(value: unknown): T[] {\r\n    if (!Array.isArray(value)) {\r\n      throw new Error(this.config.errorMessage || getMessages().invalidArray);\r\n    }\r\n    \r\n    // Validate length constraints\r\n    if (this.config.exactLength !== undefined && value.length !== this.config.exactLength) {\r\n      throw new Error(this.config.errorMessage || getMessages().arrayLength(this.config.exactLength));\r\n    }\r\n    \r\n    if (this.config.minLength !== undefined && value.length < this.config.minLength) {\r\n      throw new Error(this.config.errorMessage || getMessages().arrayMin(this.config.minLength));\r\n    }\r\n    \r\n    if (this.config.maxLength !== undefined && value.length > this.config.maxLength) {\r\n      throw new Error(this.config.errorMessage || getMessages().arrayMax(this.config.maxLength));\r\n    }\r\n    \r\n    // Validate each item with optimized loop and safeParse\r\n    const result: T[] = [];\r\n    const length = value.length;\r\n    \r\n    for (let i = 0; i < length; i++) {\r\n      const parseResult = this.config.itemValidator.safeParse(value[i]);\r\n      if (!parseResult.success) {\r\n        throw new Error(getMessages().arrayItem(i, parseResult.error.message));\r\n      }\r\n      result[i] = parseResult.data; // Direct assignment is faster than push\r\n    }\r\n    \r\n    // Check uniqueness if required\r\n    if (this.config.unique) {\r\n      const seen = new Set<any>();\r\n      for (const item of result) {\r\n        const key = typeof item === 'object' ? this.stableStringify(item) : item;\r\n        if (seen.has(key)) {\r\n          throw new Error('Array must contain unique items');\r\n        }\r\n        seen.add(key);\r\n      }\r\n    }\r\n    \r\n    return result;\r\n  }\r\n  \r\n  /**\r\n   * Safely parse and validate an array value\r\n   */\r\n  safeParse(value: unknown): ParseResult<T[]> {\r\n    try {\r\n      return { success: true, data: this.parse(value) };\r\n    } catch (error) {\r\n      return { success: false, error: error as Error };\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Create a stable string representation of an object for hashing\r\n   * Handles circular references gracefully\r\n   */\r\n  private stableStringify(obj: any): string {\r\n    const seen = new WeakSet();\r\n\r\n    const replacer = (_key: string, value: any): any => {\r\n      if (typeof value === 'object' && value !== null) {\r\n        if (seen.has(value)) {\r\n          return '[Circular]';\r\n        }\r\n        seen.add(value);\r\n      }\r\n      return value;\r\n    };\r\n\r\n    try {\r\n      const allKeys: string[] = [];\r\n      JSON.stringify(obj, (key, value) => {\r\n        allKeys.push(key);\r\n        return replacer(key, value);\r\n      });\r\n      allKeys.sort();\r\n      return JSON.stringify(obj, (_key, value) => replacer(_key, value));\r\n    } catch (error) {\r\n      // Fallback to safe representation if stringify fails\r\n      return String(obj);\r\n    }\r\n  }\r\n  \r\n  /**\r\n   * Create a new validator with minimum length constraint\r\n   */\r\n  min(length: number, message?: string): VldArray<T> {\r\n    return new VldArray({\r\n      ...this.config,\r\n      minLength: length,\r\n      errorMessage: message || getMessages().arrayMin(length)\r\n    });\r\n  }\r\n  \r\n  /**\r\n   * Create a new validator with maximum length constraint\r\n   */\r\n  max(length: number, message?: string): VldArray<T> {\r\n    return new VldArray({\r\n      ...this.config,\r\n      maxLength: length,\r\n      errorMessage: message || getMessages().arrayMax(length)\r\n    });\r\n  }\r\n  \r\n  /**\r\n   * Create a new validator with exact length constraint\r\n   */\r\n  length(length: number, message?: string): VldArray<T> {\r\n    return new VldArray({\r\n      ...this.config,\r\n      exactLength: length,\r\n      minLength: undefined,\r\n      maxLength: undefined,\r\n      errorMessage: message || getMessages().arrayLength(length)\r\n    });\r\n  }\r\n  \r\n  /**\r\n   * Create a new validator that ensures array is not empty\r\n   */\r\n  nonempty(message?: string): VldArray<T> {\r\n    return new VldArray({\r\n      ...this.config,\r\n      minLength: 1,\r\n      errorMessage: message || getMessages().arrayEmpty\r\n    });\r\n  }\r\n  \r\n  /**\r\n   * Create a new validator that ensures array contains unique items\r\n   */\r\n  unique(message?: string): VldArray<T> {\r\n    return new VldArray({\r\n      ...this.config,\r\n      unique: true,\r\n      errorMessage: message || 'Array must contain unique items'\r\n    });\r\n  }\r\n  \r\n  /**\r\n   * Create a new validator with a range constraint for length\r\n   */\r\n  between(min: number, max: number, message?: string): VldArray<T> {\r\n    return new VldArray({\r\n      ...this.config,\r\n      minLength: min,\r\n      maxLength: max,\r\n      errorMessage: message || `Array length must be between ${min} and ${max}`\r\n    });\r\n  }\r\n}"]}

package/dist/validators/base64.d.ts

@@ -0,0 +1,18 @@
+import { VldBase, ParseResult } from './base';
+/**
+ * Base64 string validator
+ */
+export declare class VldBase64 extends VldBase<string, string> {
+    private static readonly BASE64_REGEX;
+    private static readonly BASE64_URL_REGEX;
+    private readonly urlSafe;
+    constructor(urlSafe?: boolean);
+    parse(value: unknown): string;
+    safeParse(value: unknown): ParseResult<string>;
+    /**
+     * Create a URL-safe base64 validator
+     */
+    urlSafeMode(): VldBase64;
+    static create(urlSafe?: boolean): VldBase64;
+}
+//# sourceMappingURL=base64.d.ts.map

package/dist/validators/base64.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base64.d.ts","sourceRoot":"","sources":["../../src/validators/base64.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AAI9C;;GAEG;AACH,qBAAa,SAAU,SAAQ,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC;IACpD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,YAAY,CAA4B;IAEhE,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,gBAAgB,CAA4B;IAEpE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAU;gBAEtB,OAAO,UAAQ;IAK3B,KAAK,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM;IAQ7B,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,WAAW,CAAC,MAAM,CAAC;IAsC9C;;OAEG;IACH,WAAW,IAAI,SAAS;IAIxB,MAAM,CAAC,MAAM,CAAC,OAAO,UAAQ,GAAG,SAAS;CAG1C"}

package/dist/validators/base64.js

@@ -0,0 +1,65 @@
+import { VldBase } from './base.js';
+import { VldError, createIssue } from '../errors.js';
+import { getMessages } from '../locales.js';
+/**
+ * Base64 string validator
+ */
+export class VldBase64 extends VldBase {
+    constructor(urlSafe = false) {
+        super();
+        this.urlSafe = urlSafe;
+    }
+    parse(value) {
+        const result = this.safeParse(value);
+        if (!result.success) {
+            throw result.error;
+        }
+        return result.data;
+    }
+    safeParse(value) {
+        if (typeof value !== 'string') {
+            return {
+                success: false,
+                error: new VldError([
+                    createIssue('invalid_type', [], getMessages().expectedString)
+                ])
+            };
+        }
+        // Check if it's a valid base64 string
+        const regex = this.urlSafe ? VldBase64.BASE64_URL_REGEX : VldBase64.BASE64_REGEX;
+        // Check basic format
+        if (!regex.test(value)) {
+            return {
+                success: false,
+                error: new VldError([
+                    createIssue('custom', [], getMessages().invalidBase64)
+                ])
+            };
+        }
+        // For standard base64, check length is multiple of 4 (after padding)
+        // Empty strings are valid (decode to empty buffer)
+        // For URL-safe base64, padding is not required
+        if (!this.urlSafe && value.length > 0 && value.length % 4 !== 0) {
+            return {
+                success: false,
+                error: new VldError([
+                    createIssue('custom', [], getMessages().invalidBase64)
+                ])
+            };
+        }
+        return { success: true, data: value };
+    }
+    /**
+     * Create a URL-safe base64 validator
+     */
+    urlSafeMode() {
+        return new VldBase64(true);
+    }
+    static create(urlSafe = false) {
+        return new VldBase64(urlSafe);
+    }
+}
+VldBase64.BASE64_REGEX = /^[A-Za-z0-9+/]*={0,2}$/;
+// Note: RFC 4648 specifies URL-safe base64 should omit padding, but we allow it for compatibility
+VldBase64.BASE64_URL_REGEX = /^[A-Za-z0-9_-]*={0,2}$/;
+//# sourceMappingURL=base64.js.map

package/dist/validators/base64.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base64.js","sourceRoot":"","sources":["../../src/validators/base64.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAe,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEzC;;GAEG;AACH,MAAM,OAAO,SAAU,SAAQ,OAAuB;IAOpD,YAAY,OAAO,GAAG,KAAK;QACzB,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED,KAAK,CAAC,KAAc;QAClB,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QACrC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,MAAM,MAAM,CAAC,KAAK,CAAC;QACrB,CAAC;QACD,OAAO,MAAM,CAAC,IAAI,CAAC;IACrB,CAAC;IAED,SAAS,CAAC,KAAc;QACtB,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC9B,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,IAAI,QAAQ,CAAC;oBAClB,WAAW,CAAC,cAAc,EAAE,EAAE,EAAE,WAAW,EAAE,CAAC,cAAc,CAAC;iBAC9D,CAAC;aACH,CAAC;QACJ,CAAC;QAED,sCAAsC;QACtC,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,gBAAgB,CAAC,CAAC,CAAC,SAAS,CAAC,YAAY,CAAC;QAEjF,qBAAqB;QACrB,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;YACvB,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,IAAI,QAAQ,CAAC;oBAClB,WAAW,CAAC,QAAQ,EAAE,EAAE,EAAE,WAAW,EAAE,CAAC,aAAa,CAAC;iBACvD,CAAC;aACH,CAAC;QACJ,CAAC;QAED,qEAAqE;QACrE,mDAAmD;QACnD,+CAA+C;QAC/C,IAAI,CAAC,IAAI,CAAC,OAAO,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;YAChE,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,IAAI,QAAQ,CAAC;oBAClB,WAAW,CAAC,QAAQ,EAAE,EAAE,EAAE,WAAW,EAAE,CAAC,aAAa,CAAC;iBACvD,CAAC;aACH,CAAC;QACJ,CAAC;QAED,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;IACxC,CAAC;IAED;;OAEG;IACH,WAAW;QACT,OAAO,IAAI,SAAS,CAAC,IAAI,CAAC,CAAC;IAC7B,CAAC;IAED,MAAM,CAAC,MAAM,CAAC,OAAO,GAAG,KAAK;QAC3B,OAAO,IAAI,SAAS,CAAC,OAAO,CAAC,CAAC;IAChC,CAAC;;AAlEuB,sBAAY,GAAG,wBAAwB,CAAC;AAChE,kGAAkG;AAC1E,0BAAgB,GAAG,wBAAwB,CAAC","sourcesContent":["import { VldBase, ParseResult } from './base';\r\nimport { VldError, createIssue } from '../errors';\r\nimport { getMessages } from '../locales';\r\n\r\n/**\r\n * Base64 string validator\r\n */\r\nexport class VldBase64 extends VldBase<string, string> {\r\n  private static readonly BASE64_REGEX = /^[A-Za-z0-9+/]*={0,2}$/;\r\n  // Note: RFC 4648 specifies URL-safe base64 should omit padding, but we allow it for compatibility\r\n  private static readonly BASE64_URL_REGEX = /^[A-Za-z0-9_-]*={0,2}$/;\r\n  \r\n  private readonly urlSafe: boolean;\r\n  \r\n  constructor(urlSafe = false) {\r\n    super();\r\n    this.urlSafe = urlSafe;\r\n  }\r\n  \r\n  parse(value: unknown): string {\r\n    const result = this.safeParse(value);\r\n    if (!result.success) {\r\n      throw result.error;\r\n    }\r\n    return result.data;\r\n  }\r\n  \r\n  safeParse(value: unknown): ParseResult<string> {\r\n    if (typeof value !== 'string') {\r\n      return {\r\n        success: false,\r\n        error: new VldError([\r\n          createIssue('invalid_type', [], getMessages().expectedString)\r\n        ])\r\n      };\r\n    }\r\n    \r\n    // Check if it's a valid base64 string\r\n    const regex = this.urlSafe ? VldBase64.BASE64_URL_REGEX : VldBase64.BASE64_REGEX;\r\n\r\n    // Check basic format\r\n    if (!regex.test(value)) {\r\n      return {\r\n        success: false,\r\n        error: new VldError([\r\n          createIssue('custom', [], getMessages().invalidBase64)\r\n        ])\r\n      };\r\n    }\r\n\r\n    // For standard base64, check length is multiple of 4 (after padding)\r\n    // Empty strings are valid (decode to empty buffer)\r\n    // For URL-safe base64, padding is not required\r\n    if (!this.urlSafe && value.length > 0 && value.length % 4 !== 0) {\r\n      return {\r\n        success: false,\r\n        error: new VldError([\r\n          createIssue('custom', [], getMessages().invalidBase64)\r\n        ])\r\n      };\r\n    }\r\n    \r\n    return { success: true, data: value };\r\n  }\r\n  \r\n  /**\r\n   * Create a URL-safe base64 validator\r\n   */\r\n  urlSafeMode(): VldBase64 {\r\n    return new VldBase64(true);\r\n  }\r\n  \r\n  static create(urlSafe = false): VldBase64 {\r\n    return new VldBase64(urlSafe);\r\n  }\r\n}"]}

package/dist/validators/codec.d.ts

@@ -0,0 +1,55 @@
+import { VldBase, ParseResult } from './base';
+/**
+ * Codec transform functions for bidirectional transformations
+ */
+export interface CodecTransform<TInput, TOutput> {
+    decode: (value: TInput) => TOutput | Promise<TOutput>;
+    encode: (value: TOutput) => TInput | Promise<TInput>;
+}
+/**
+ * Codec validator for bidirectional transformations
+ * Enables converting between different data representations
+ */
+export declare class VldCodec<TInput, TOutput> extends VldBase<TInput, TOutput> {
+    private readonly inputValidator;
+    private readonly outputValidator;
+    private readonly codecTransform;
+    constructor(inputValidator: VldBase<unknown, TInput>, outputValidator: VldBase<unknown, TOutput>, codecTransform: CodecTransform<TInput, TOutput>);
+    /**
+     * Parse (decode) a value from input to output format
+     */
+    parse(value: unknown): TOutput;
+    /**
+     * Safely parse (decode) a value from input to output format
+     */
+    safeParse(value: unknown): ParseResult<TOutput>;
+    /**
+     * Encode a value from output back to input format
+     */
+    encode(value: unknown): TInput;
+    /**
+     * Safely encode a value from output back to input format
+     */
+    safeEncode(value: unknown): ParseResult<TInput>;
+    /**
+     * Async version of parse (decode)
+     */
+    parseAsync(value: unknown): Promise<TOutput>;
+    /**
+     * Async version of safeParse (decode)
+     */
+    safeParseAsync(value: unknown): Promise<ParseResult<TOutput>>;
+    /**
+     * Async version of encode
+     */
+    encodeAsync(value: unknown): Promise<TInput>;
+    /**
+     * Async version of safeEncode
+     */
+    safeEncodeAsync(value: unknown): Promise<ParseResult<TInput>>;
+    /**
+     * Create a codec validator
+     */
+    static create<TInput, TOutput>(inputValidator: VldBase<unknown, TInput>, outputValidator: VldBase<unknown, TOutput>, codecTransform: CodecTransform<TInput, TOutput>): VldCodec<TInput, TOutput>;
+}
+//# sourceMappingURL=codec.d.ts.map

package/dist/validators/codec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codec.d.ts","sourceRoot":"","sources":["../../src/validators/codec.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AAI9C;;GAEG;AACH,MAAM,WAAW,cAAc,CAAC,MAAM,EAAE,OAAO;IAC7C,MAAM,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACtD,MAAM,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CACtD;AAED;;;GAGG;AACH,qBAAa,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAE,SAAQ,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC;IACrE,OAAO,CAAC,QAAQ,CAAC,cAAc,CAA2B;IAC1D,OAAO,CAAC,QAAQ,CAAC,eAAe,CAA4B;IAC5D,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAkC;gBAG/D,cAAc,EAAE,OAAO,CAAC,OAAO,EAAE,MAAM,CAAC,EACxC,eAAe,EAAE,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,EAC1C,cAAc,EAAE,cAAc,CAAC,MAAM,EAAE,OAAO,CAAC;IAQjD;;OAEG;IACH,KAAK,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO;IAQ9B;;OAEG;IACH,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,WAAW,CAAC,OAAO,CAAC;IAiC/C;;OAEG;IACH,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM;IAQ9B;;OAEG;IACH,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,WAAW,CAAC,MAAM,CAAC;IAiC/C;;OAEG;IACG,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAQlD;;OAEG;IACG,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;IA0BnE;;OAEG;IACG,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC;IAQlD;;OAEG;IACG,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;IA0BnE;;OAEG;IACH,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,EAC3B,cAAc,EAAE,OAAO,CAAC,OAAO,EAAE,MAAM,CAAC,EACxC,eAAe,EAAE,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,EAC1C,cAAc,EAAE,cAAc,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9C,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;CAG7B"}