reliant-type 1.0.0

package/dist/cjs/core/schema/mode/interfaces/validators/mods/securityValidator.js

@@ -0,0 +1,887 @@
+'use strict';
+
+var SECURITY_CONSTANTS = require('../../../../../../constants/SECURITY_CONSTANTS.js');
+var VALIDATION_CONSTANTS = require('../../../../../../constants/VALIDATION_CONSTANTS.js');
+var securityHelpers = require('../../../../../utils/securityHelpers.js');
+var Ajv = require('ajv');
+var addFormats = require('ajv-formats');
+var securityValidatorHelpers = require('../../../../../utils/securityValidatorHelpers.js');
+var ErrorHandler = require('../../errors/ErrorHandler.js');
+var errors_type = require('../../errors/types/errors.type.js');
+
+class SecurityValidators {
+    /**
+     * Initialize AJV instance with enhanced security configurations
+     */
+    static getAjv() {
+        if (!this.ajv) {
+            this.ajv = new Ajv(this.ajvOptions);
+            addFormats(this.ajv);
+            // security schema with more comprehensive protections
+            this.ajv.addSchema({
+                $id: "https://nehonix.space/lib/v/reliant-type",
+                type: ["object", "array", "string", "number", "boolean", "null"],
+                definitions: {
+                    secureObject: {
+                        type: "object",
+                        not: {
+                            anyOf: [
+                                ...Array.from(SECURITY_CONSTANTS.SECURITY_CONSTANTS.DANGEROUS_PROPERTIES).map((prop) => ({
+                                    properties: { [prop]: {} },
+                                    required: [prop],
+                                })),
+                                { additionalProperties: { type: "function" } },
+                            ],
+                        },
+                        patternProperties: {
+                            "^(?!__|constructor|prototype).*": { $ref: "#" },
+                        },
+                    },
+                },
+                if: { type: "object" },
+                then: { $ref: "#/definitions/secureObject" },
+                else: {
+                    if: { type: "array" },
+                    then: { items: { $ref: "#" } },
+                },
+            }, "secure-json-v2");
+        }
+        return this.ajv;
+    }
+    /**
+     * Check for dangerous properties that could lead to prototype pollution
+     */
+    static hasDangerousProperties(obj, visited = new WeakSet()) {
+        if (!obj || typeof obj !== "object" || visited.has(obj)) {
+            return false;
+        }
+        visited.add(obj);
+        // Check current level
+        for (const key of Object.keys(obj)) {
+            if (SECURITY_CONSTANTS.SECURITY_CONSTANTS.DANGEROUS_PROPERTIES.has(key)) {
+                return true;
+            }
+        }
+        // Recursively check nested objects
+        for (const value of Object.values(obj)) {
+            if (this.hasDangerousProperties(value, visited)) {
+                return true;
+            }
+        }
+        return false;
+    }
+    /**
+     * Execute validation with timeout protection
+     */
+    static async withTimeout(operation, timeoutMs = SECURITY_CONSTANTS.SECURITY_CONSTANTS.MAX_VALIDATION_TIME) {
+        return new Promise((resolve, reject) => {
+            const timer = setTimeout(() => {
+                reject(new Error(`Validation timeout after ${timeoutMs}ms`));
+            }, timeoutMs);
+            Promise.resolve(operation()).then((result) => {
+                clearTimeout(timer);
+                resolve(result);
+            }, (error) => {
+                clearTimeout(timer);
+                reject(error);
+            });
+        });
+    }
+    /**
+     * text validation with comprehensive security checks
+     */
+    static async validateText(value, options = {}) {
+        const startTime = Date.now();
+        const operationName = "validateText";
+        try {
+            const result = await this.withTimeout(async () => {
+                return this.validateTextSync(value, options);
+            }, options.timeout);
+            if (options.enableMetrics) {
+                securityValidatorHelpers.ValidationMetrics.record(operationName, Date.now() - startTime, !result.success);
+            }
+            return result;
+        }
+        catch (error) {
+            if (options.enableMetrics) {
+                securityValidatorHelpers.ValidationMetrics.record(operationName, Date.now() - startTime, true);
+            }
+            const msg = `${error instanceof Error ? error.message : "Unknown error"}`;
+            return {
+                success: false,
+                errors: [
+                    ErrorHandler.ErrorHandler.createValidationError([], msg, errors_type.ErrorCode.UNKNOWN_ERROR),
+                ],
+                warnings: [],
+                data: value,
+            };
+        }
+    }
+    static validateTextSync(value, options) {
+        const result = {
+            success: true,
+            errors: [],
+            warnings: [],
+            data: value,
+        };
+        const { minLength = 0, maxLength = SECURITY_CONSTANTS.SECURITY_CONSTANTS.MAX_TEXT_LENGTH, allowEmpty = true, trimWhitespace = false, allowedCharacters, forbiddenPatterns = [], encoding = "utf8", preventXSS = true, preventSQLInjection = true, preventLDAPInjection = false, preventCommandInjection = false, normalizeUnicode = false, maxLines = Infinity, requireAlphanumeric = false, allowHTML = false, stripHTML = false, } = options;
+        if (typeof value !== "string") {
+            result.success = false;
+            result.errors.push(ErrorHandler.ErrorHandler.createTypeError([], "string", value));
+            return result;
+        }
+        let text = value;
+        // Early size check to prevent DoS
+        if (text.length > maxLength) {
+            result.success = false;
+            result.errors.push(ErrorHandler.ErrorHandler.createStringError([], `Text exceeds maximum length of ${maxLength} characters`, value, errors_type.ErrorCode.STRING_TOO_LONG));
+            return result;
+        }
+        // Trim whitespace if requested
+        if (trimWhitespace) {
+            const trimmed = text.trim();
+            if (trimmed !== text) {
+                text = trimmed;
+                result.data = text;
+                result.warnings.push("Whitespace trimmed from text");
+            }
+        }
+        // Unicode normalization
+        if (normalizeUnicode) {
+            try {
+                const normalized = text.normalize("NFC");
+                if (normalized !== text) {
+                    text = normalized;
+                    result.data = text;
+                    result.warnings.push("Unicode characters normalized");
+                }
+            }
+            catch (error) {
+                result.warnings.push("Unicode normalization failed");
+            }
+        }
+        // Empty string validation
+        if (!allowEmpty && text.length === 0) {
+            result.success = false;
+            result.errors.push(ErrorHandler.ErrorHandler.createStringError([], "Text cannot be empty", value, errors_type.ErrorCode.STRING_TOO_SHORT));
+            return result;
+        }
+        // Length validation
+        if (text.length < minLength) {
+            result.success = false;
+            result.errors.push(ErrorHandler.ErrorHandler.createStringError([], `Text must be at least ${minLength} characters long`, value, errors_type.ErrorCode.STRING_TOO_SHORT));
+        }
+        // Line count validation
+        if (maxLines !== Infinity) {
+            const lineCount = text.split("\n").length;
+            if (lineCount > maxLines) {
+                result.success = false;
+                result.errors.push(ErrorHandler.ErrorHandler.createStringError([], `Text cannot exceed ${maxLines} lines`, value, errors_type.ErrorCode.STRING_TOO_LONG));
+            }
+        }
+        // Character encoding validation
+        if (encoding === "ascii" && !/^[\x00-\x7F]*$/.test(text)) {
+            result.success = false;
+            result.errors.push(ErrorHandler.ErrorHandler.createStringError([], "Text contains non-ASCII characters", value, errors_type.ErrorCode.INVALID_STRING_FORMAT));
+        }
+        // Alphanumeric requirement
+        if (requireAlphanumeric && !/^[a-zA-Z0-9\s]*$/.test(text)) {
+            result.success = false;
+            result.errors.push(ErrorHandler.ErrorHandler.createStringError([], "Text must contain only alphanumeric characters and spaces", value, errors_type.ErrorCode.INVALID_STRING_FORMAT));
+        }
+        // Allowed characters validation
+        if (allowedCharacters && !allowedCharacters.test(text)) {
+            result.success = false;
+            result.errors.push(ErrorHandler.ErrorHandler.createStringError([], "Text contains disallowed characters", value, errors_type.ErrorCode.INVALID_STRING_FORMAT));
+        }
+        // Forbidden patterns check
+        for (const pattern of forbiddenPatterns) {
+            if (pattern.test(text)) {
+                result.success = false;
+                result.errors.push(ErrorHandler.ErrorHandler.createStringError([], "Text contains forbidden pattern", value, errors_type.ErrorCode.PATTERN_MISMATCH));
+                break;
+            }
+        }
+        // XSS prevention
+        if (preventXSS && !allowHTML) {
+            for (const pattern of SECURITY_CONSTANTS.SECURITY_CONSTANTS.XSS_PATTERNS) {
+                if (pattern.test(text)) {
+                    result.success = false;
+                    result.errors.push(ErrorHandler.ErrorHandler.createStringError([], "Text contains potentially malicious content (XSS)", value, errors_type.ErrorCode.INVALID_STRING_FORMAT));
+                    break;
+                }
+            }
+            // Additional XSS checks
+            if (text.includes("javascript:") || text.includes("data:text/html")) {
+                result.success = false;
+                result.errors.push(ErrorHandler.ErrorHandler.createStringError([], "Text contains dangerous URI schemes", value, errors_type.ErrorCode.INVALID_STRING_FORMAT));
+            }
+        }
+        // SQL injection prevention
+        if (preventSQLInjection) {
+            for (const pattern of SECURITY_CONSTANTS.SECURITY_CONSTANTS.SQL_PATTERNS) {
+                if (pattern.test(text)) {
+                    result.warnings.push("Text contains SQL-like patterns");
+                    break;
+                }
+            }
+        }
+        // LDAP injection prevention
+        if (preventLDAPInjection) {
+            for (const pattern of SECURITY_CONSTANTS.SECURITY_CONSTANTS.LDAP_PATTERNS) {
+                if (pattern.test(text)) {
+                    result.success = false;
+                    result.errors.push(ErrorHandler.ErrorHandler.createStringError([], "Text contains LDAP injection patterns", value, errors_type.ErrorCode.INVALID_STRING_FORMAT));
+                    break;
+                }
+            }
+        }
+        // Command injection prevention
+        if (preventCommandInjection) {
+            for (const pattern of SECURITY_CONSTANTS.SECURITY_CONSTANTS.COMMAND_INJECTION_PATTERNS) {
+                if (pattern.test(text)) {
+                    result.success = false;
+                    result.errors.push(ErrorHandler.ErrorHandler.createStringError([], "Text contains command injection patterns", value, errors_type.ErrorCode.INVALID_STRING_FORMAT));
+                    break;
+                }
+            }
+        }
+        // Control character detection
+        if (/[\x00-\x08\x0B\x0C\x0E-\x1F\x7F-\x9F]/.test(text)) {
+            result.warnings.push("Text contains control characters");
+        }
+        // Null byte detection
+        if (text.includes("\0")) {
+            result.success = false;
+            result.errors.push(ErrorHandler.ErrorHandler.createStringError([], "Text contains null bytes", value, errors_type.ErrorCode.INVALID_STRING_FORMAT));
+        }
+        return result;
+    }
+    /**
+     * JSON validation with improved security and performance
+     */
+    static async validateJson(value, options = {}) {
+        const startTime = Date.now();
+        const operationName = "validateJson";
+        // Generate cache key if caching is enabled
+        const cacheKey = options.useCache
+            ? `json_${JSON.stringify(value).substring(0, 100)}_${JSON.stringify(options)}`
+            : null;
+        if (cacheKey) {
+            const cached = securityValidatorHelpers.ValidationCache.get(cacheKey);
+            if (cached) {
+                return cached;
+            }
+        }
+        try {
+            const result = await this.withTimeout(async () => {
+                return this.validateJsonSync(value, options);
+            }, options.timeout);
+            if (options.enableMetrics) {
+                securityValidatorHelpers.ValidationMetrics.record(operationName, Date.now() - startTime, !result.success);
+            }
+            if (cacheKey && result.success) {
+                securityValidatorHelpers.ValidationCache.set(cacheKey, result);
+            }
+            return result;
+        }
+        catch (error) {
+            if (options.enableMetrics) {
+                securityValidatorHelpers.ValidationMetrics.record(operationName, Date.now() - startTime, true);
+            }
+            const msg = `${error instanceof Error ? error.message : "Unknown error"}`;
+            const code = error instanceof Error ? error.name : errors_type.ErrorCode.UNKNOWN_ERROR;
+            return {
+                success: false,
+                errors: [ErrorHandler.ErrorHandler.createValidationError([], msg, code)],
+                warnings: [],
+                data: value,
+            };
+        }
+    }
+    static validateJsonSync(value, options) {
+        const result = {
+            success: true,
+            errors: [],
+            warnings: [],
+            data: value,
+        };
+        const { maxDepth = VALIDATION_CONSTANTS.MAX_OBJECT_DEPTH, maxKeys = 1000, maxStringLength = 10000, maxArrayLength = 1000, allowedTypes = ["object", "array", "string", "number", "boolean", "null"], forbiddenKeys = [], schema, preventCircular = true, maxSize = SECURITY_CONSTANTS.SECURITY_CONSTANTS.MAX_JSON_SIZE, securityMode = "secure", } = options;
+        let parsedData;
+        if (typeof value === "string") {
+            // Size check for string
+            if (value.length > maxSize) {
+                result.success = false;
+                result.errors.push(ErrorHandler.ErrorHandler.createStringError([], `JSON string exceeds maximum size of ${maxSize} characters`, value, errors_type.ErrorCode.STRING_TOO_LONG));
+                return result;
+            }
+            try {
+                parsedData = JSON.parse(value);
+            }
+            catch (error) {
+                result.success = false;
+                result.errors.push(ErrorHandler.ErrorHandler.createValidationError([], `Invalid JSON string: ${error instanceof Error ? error.message : "Parse error"}`, errors_type.ErrorCode.INVALID_JSON));
+                return result;
+            }
+        }
+        else if (typeof value === "object" && value !== null) {
+            parsedData = value;
+        }
+        else {
+            result.success = false;
+            result.errors.push(ErrorHandler.ErrorHandler.createTypeError([], "string or object", value));
+            return result;
+        }
+        // Security validations based on mode
+        if (securityMode === "secure" || securityMode === "strict") {
+            if (this.hasDangerousProperties(parsedData)) {
+                result.success = false;
+                result.errors.push(ErrorHandler.ErrorHandler.createValidationError([], "JSON contains dangerous properties (prototype pollution risk)", errors_type.ErrorCode.INVALID_JSON));
+                return result;
+            }
+            if (securityMode === "strict") {
+                const ajv = this.getAjv();
+                const validate = ajv.getSchema("secure-json-v2");
+                if (validate && !validate(parsedData)) {
+                    result.success = false;
+                    result.errors.push(ErrorHandler.ErrorHandler.createValidationError([], "JSON failed strict security validation", errors_type.ErrorCode.INVALID_JSON));
+                    if (validate.errors) {
+                        result.warnings.push(`AJV errors: ${JSON.stringify(validate.errors)}`);
+                    }
+                    return result;
+                }
+            }
+        }
+        // Circular reference detection
+        if (preventCircular) {
+            try {
+                JSON.stringify(parsedData);
+            }
+            catch (error) {
+                result.success = false;
+                result.errors.push(ErrorHandler.ErrorHandler.createValidationError([], "JSON contains circular references", errors_type.ErrorCode.INVALID_JSON));
+                return result;
+            }
+        }
+        // Deep validation
+        const validationResult = securityHelpers.validateJsonDeep(parsedData, {
+            maxDepth,
+            maxKeys,
+            maxStringLength,
+            maxArrayLength,
+            allowedTypes,
+            forbiddenKeys,
+            currentDepth: 0,
+            keyCount: 0,
+        });
+        result.success = result.success && validationResult.success;
+        result.errors.push(...validationResult.errors);
+        result.warnings.push(...validationResult.warnings);
+        result.data = parsedData;
+        // Schema validation if provided
+        if (schema && result.success) {
+            const schemaResult = securityHelpers.validateJsonSchema(parsedData, schema);
+            result.success = result.success && schemaResult.success;
+            result.errors.push(...schemaResult.errors);
+            result.warnings.push(...schemaResult.warnings);
+        }
+        return result;
+    }
+    /**
+     * IP validation with geographic and security checks
+     */
+    static validateIp(value, options = {}) {
+        const result = {
+            success: true,
+            errors: [],
+            warnings: [],
+            data: value,
+        };
+        const { version = "both", allowPrivate = true, allowLoopback = true, allowMulticast = false, allowReserved = true, allowCIDR = false, strict = true, blockBogons = false, allowDocumentation = true, } = options;
+        if (typeof value !== "string") {
+            result.success = false;
+            result.errors.push(ErrorHandler.ErrorHandler.createSimpleError("Expected string for IP address", [], "string"));
+            return result;
+        }
+        const ip = value.trim();
+        // Basic format validation
+        if (!/^[\d\.:a-fA-F\/]+$/.test(ip)) {
+            result.success = false;
+            result.errors.push(ErrorHandler.ErrorHandler.createValidationError([], "IP address contains invalid characters", errors_type.ErrorCode.SECURITY_VIOLATION));
+            return result;
+        }
+        let ipAddress = ip;
+        let cidrPrefix = null;
+        let isIPv4 = false;
+        let isIPv6 = false;
+        // Handle CIDR notation
+        if (ip.includes("/")) {
+            if (!allowCIDR) {
+                result.success = false;
+                result.errors.push(ErrorHandler.ErrorHandler.createValidationError([], "CIDR notation is not allowed", errors_type.ErrorCode.SECURITY_VIOLATION));
+                return result;
+            }
+            const parts = ip.split("/");
+            if (parts.length !== 2) {
+                result.success = false;
+                result.errors.push(ErrorHandler.ErrorHandler.createValidationError([], "Invalid CIDR notation format", errors_type.ErrorCode.SECURITY_VIOLATION));
+                return result;
+            }
+            ipAddress = parts[0];
+            const prefixStr = parts[1];
+            if (!/^\d+$/.test(prefixStr)) {
+                result.success = false;
+                result.errors.push(ErrorHandler.ErrorHandler.createValidationError([], "CIDR prefix must be numeric", errors_type.ErrorCode.SECURITY_VIOLATION));
+                return result;
+            }
+            cidrPrefix = parseInt(prefixStr, 10);
+        }
+        // Validate IP format
+        const ipv4Result = securityHelpers.validateIPv4(ipAddress, strict);
+        const ipv6Result = securityHelpers.validateIPv6(ipAddress);
+        isIPv4 = ipv4Result.valid;
+        isIPv6 = ipv6Result.valid;
+        // Version validation
+        if (version === "v4" && !isIPv4) {
+            result.success = false;
+            result.errors.push(ErrorHandler.ErrorHandler.createValidationError([], "Invalid IPv4 address format", errors_type.ErrorCode.SECURITY_VIOLATION));
+            return result;
+        }
+        if (version === "v6" && !isIPv6) {
+            result.success = false;
+            result.errors.push(ErrorHandler.ErrorHandler.createValidationError([], "Invalid IPv6 address format", errors_type.ErrorCode.SECURITY_VIOLATION));
+            return result;
+        }
+        if (version === "both" && !isIPv4 && !isIPv6) {
+            result.success = false;
+            result.errors.push(ErrorHandler.ErrorHandler.createValidationError([], "Invalid IP address format (must be valid IPv4 or IPv6)", errors_type.ErrorCode.SECURITY_VIOLATION));
+            return result;
+        }
+        // CIDR prefix validation
+        if (cidrPrefix !== null) {
+            if (isIPv4 && (cidrPrefix < 0 || cidrPrefix > 32)) {
+                result.success = false;
+                result.errors.push(ErrorHandler.ErrorHandler.createValidationError([], "Invalid IPv4 CIDR prefix (must be 0-32)", errors_type.ErrorCode.SECURITY_VIOLATION));
+            }
+            if (isIPv6 && (cidrPrefix < 0 || cidrPrefix > 128)) {
+                result.success = false;
+                result.errors.push(ErrorHandler.ErrorHandler.createValidationError([], "Invalid IPv6 CIDR prefix (must be 0-128)", errors_type.ErrorCode.SECURITY_VIOLATION));
+            }
+        }
+        // IPv4 specific validations
+        if (isIPv4) {
+            const octets = ipAddress.split(".").map(Number);
+            // private IP detection
+            if (!allowPrivate) {
+                if (octets[0] === 10 ||
+                    (octets[0] === 172 && octets[1] >= 16 && octets[1] <= 31) ||
+                    (octets[0] === 192 && octets[1] === 168) ||
+                    (octets[0] === 169 && octets[1] === 254) // Link-local
+                ) {
+                    result.success = false;
+                    result.errors.push(ErrorHandler.ErrorHandler.createValidationError([], "Private IPv4 addresses not allowed", errors_type.ErrorCode.SECURITY_VIOLATION));
+                }
+            }
+            // Loopback validation
+            if (!allowLoopback && octets[0] === 127) {
+                result.success = false;
+                result.errors.push(ErrorHandler.ErrorHandler.createValidationError([], "Loopback addresses not allowed", errors_type.ErrorCode.SECURITY_VIOLATION));
+            }
+            // Multicast validation
+            if (!allowMulticast && octets[0] >= 224 && octets[0] <= 239) {
+                result.success = false;
+                result.errors.push(ErrorHandler.ErrorHandler.createValidationError([], "Multicast addresses not allowed", errors_type.ErrorCode.SECURITY_VIOLATION));
+            }
+            // Documentation addresses (RFC 5737)
+            if (!allowDocumentation) {
+                if ((octets[0] === 192 && octets[1] === 0 && octets[2] === 2) ||
+                    (octets[0] === 198 && octets[1] === 51 && octets[2] === 100) ||
+                    (octets[0] === 203 && octets[1] === 0 && octets[2] === 113)) {
+                    result.success = false;
+                    result.errors.push(ErrorHandler.ErrorHandler.createValidationError([], "Documentation addresses not allowed", errors_type.ErrorCode.SECURITY_VIOLATION));
+                }
+            }
+            // Bogon detection
+            if (blockBogons) {
+                if (octets[0] === 0 ||
+                    octets[0] === 255 ||
+                    (octets[0] >= 240 && octets[0] <= 255)) {
+                    result.success = false;
+                    result.errors.push(ErrorHandler.ErrorHandler.createValidationError([], "Bogon IP address detected", errors_type.ErrorCode.SECURITY_VIOLATION));
+                }
+            }
+            // Reserved ranges
+            if (!allowReserved) {
+                if (octets[0] === 0 || octets[0] === 255) {
+                    result.success = false;
+                    result.errors.push(ErrorHandler.ErrorHandler.createValidationError([], "Reserved IPv4 addresses not allowed", errors_type.ErrorCode.SECURITY_VIOLATION));
+                }
+            }
+        }
+        // IPv6 specific validations
+        if (isIPv6) {
+            const normalized = securityHelpers.normalizeIPv6(ipAddress);
+            if (!allowLoopback &&
+                normalized === "0000:0000:0000:0000:0000:0000:0000:0001") {
+                result.success = false;
+                result.errors.push(ErrorHandler.ErrorHandler.createValidationError([], "IPv6 loopback address not allowed", errors_type.ErrorCode.SECURITY_VIOLATION));
+            }
+            // Unique local addresses (RFC 4193)
+            if (!allowPrivate &&
+                (normalized.startsWith("fc00:") || normalized.startsWith("fd00:"))) {
+                result.success = false;
+                result.errors.push(ErrorHandler.ErrorHandler.createValidationError([], "Private IPv6 addresses not allowed", errors_type.ErrorCode.SECURITY_VIOLATION));
+            }
+            // Link-local addresses
+            if (!allowPrivate && normalized.startsWith("fe80:")) {
+                result.success = false;
+                result.errors.push(ErrorHandler.ErrorHandler.createValidationError([], "Link-local IPv6 addresses not allowed", errors_type.ErrorCode.SECURITY_VIOLATION));
+            }
+            if (!allowMulticast && normalized.startsWith("ff00:")) {
+                result.success = false;
+                result.errors.push(ErrorHandler.ErrorHandler.createValidationError([], "IPv6 multicast addresses not allowed", errors_type.ErrorCode.SECURITY_VIOLATION));
+            }
+            // Documentation prefix (RFC 3849)
+            if (!allowDocumentation && normalized.startsWith("2001:0db8:")) {
+                result.success = false;
+                result.errors.push(ErrorHandler.ErrorHandler.createValidationError([], "Documentation IPv6 addresses not allowed", errors_type.ErrorCode.SECURITY_VIOLATION));
+            }
+        }
+        return result;
+    }
+    /**
+     * object validation with better security and performance
+     */
+    static validateObject(value, options = {}) {
+        const result = {
+            success: true,
+            errors: [],
+            warnings: [],
+            data: value,
+        };
+        const { allowNull = false, allowArray = false, maxDepth = VALIDATION_CONSTANTS.MAX_OBJECT_DEPTH, maxKeys = 1000, requiredKeys = [], allowedKeys = [], forbiddenKeys = [], keyPattern, schema, strict = false, preventPrototypePollution = true, maxPropertyNameLength = 100, } = options;
+        // Null check
+        if (value === null) {
+            if (!allowNull) {
+                result.success = false;
+                result.errors.push(ErrorHandler.ErrorHandler.createValidationError([], "Null values not allowed", errors_type.ErrorCode.SECURITY_VIOLATION));
+            }
+            return result;
+        }
+        // Array check
+        if (Array.isArray(value)) {
+            if (!allowArray) {
+                result.success = false;
+                result.errors.push(ErrorHandler.ErrorHandler.createValidationError([], "Arrays not allowed", errors_type.ErrorCode.SECURITY_VIOLATION));
+            }
+            return result;
+        }
+        // Type check
+        if (typeof value !== "object") {
+            result.success = false;
+            result.errors.push(ErrorHandler.ErrorHandler.createTypeError([], "object", value));
+            return result;
+        }
+        // Prototype pollution check
+        if (preventPrototypePollution && this.hasDangerousProperties(value)) {
+            result.success = false;
+            result.errors.push(ErrorHandler.ErrorHandler.createValidationError([], "Object contains dangerous properties that could lead to prototype pollution", errors_type.ErrorCode.SECURITY_VIOLATION));
+            return result;
+        }
+        const keys = Object.keys(value);
+        // Key count validation
+        if (keys.length > maxKeys) {
+            result.success = false;
+            result.errors.push(ErrorHandler.ErrorHandler.createValidationError([], `Object has too many keys (${keys.length}), maximum allowed: ${maxKeys}`, errors_type.ErrorCode.SECURITY_VIOLATION));
+        }
+        // Required keys validation
+        for (const requiredKey of requiredKeys) {
+            if (!(requiredKey in value)) {
+                result.success = false;
+                result.errors.push(ErrorHandler.ErrorHandler.createValidationError([], `Missing required key: ${requiredKey}`, errors_type.ErrorCode.SECURITY_VIOLATION));
+            }
+        }
+        // key validation
+        for (const key of keys) {
+            // Property name length check
+            if (key.length > maxPropertyNameLength) {
+                result.success = false;
+                result.errors.push(ErrorHandler.ErrorHandler.createValidationError([], `Property name '${key.substring(0, 20)}...' exceeds maximum length of ${maxPropertyNameLength}`, errors_type.ErrorCode.SECURITY_VIOLATION));
+                continue;
+            }
+            // Dangerous key detection
+            if (SECURITY_CONSTANTS.SECURITY_CONSTANTS.DANGEROUS_PROPERTIES.has(key)) {
+                result.success = false;
+                result.errors.push(ErrorHandler.ErrorHandler.createValidationError([], `Dangerous property name detected: '${key}'`, errors_type.ErrorCode.SECURITY_VIOLATION));
+                continue;
+            }
+            // Allowed keys check
+            if (allowedKeys.length > 0 && !allowedKeys.includes(key)) {
+                if (strict) {
+                    result.success = false;
+                    result.errors.push(ErrorHandler.ErrorHandler.createValidationError([], `Key '${key}' is not in allowed keys list`, errors_type.ErrorCode.SECURITY_VIOLATION));
+                }
+                else {
+                    result.warnings.push(`Key '${key}' is not in allowed keys list`);
+                }
+            }
+            // Forbidden keys check
+            if (forbiddenKeys.includes(key)) {
+                result.success = false;
+                result.errors.push(ErrorHandler.ErrorHandler.createValidationError([], `Key '${key}' is forbidden`, errors_type.ErrorCode.SECURITY_VIOLATION));
+            }
+            // Key pattern validation
+            if (keyPattern && !keyPattern.test(key)) {
+                result.success = false;
+                result.errors.push(ErrorHandler.ErrorHandler.createValidationError([], `Key '${key}' does not match required pattern`, errors_type.ErrorCode.SECURITY_VIOLATION));
+            }
+            // Check for suspicious patterns in key names
+            if (/^__|.*prototype.*|.*constructor.*$/i.test(key)) {
+                result.warnings.push(`Suspicious property name detected: '${key}'`);
+            }
+        }
+        // Deep structure validation
+        const deepResult = securityHelpers.validateObjectDeep(value, maxDepth, 0);
+        result.success = result.success && deepResult.success;
+        result.errors.push(...deepResult.errors);
+        result.warnings.push(...deepResult.warnings);
+        // Schema validation if provided
+        if (schema && result.success) {
+            const schemaResult = securityHelpers.validateObjectSchema(value, schema);
+            result.success = result.success && schemaResult.success;
+            result.errors.push(...schemaResult.errors);
+            result.warnings.push(...schemaResult.warnings);
+        }
+        return result;
+    }
+    /**
+     * Validate email address with comprehensive checks
+     */
+    static validateEmail(value, options = {}) {
+        const result = {
+            success: true,
+            errors: [],
+            warnings: [],
+            data: value,
+        };
+        const { allowInternational = true, maxLength = 254, allowedDomains = [], blockedDomains = [], strict = true, } = options;
+        if (typeof value !== "string") {
+            result.success = false;
+            result.errors.push(ErrorHandler.ErrorHandler.createTypeError([], "string", value));
+            return result;
+        }
+        const email = value.trim().toLowerCase();
+        // Length check
+        if (email.length > maxLength) {
+            result.success = false;
+            result.errors.push(ErrorHandler.ErrorHandler.createStringError([], `Email exceeds maximum length of ${maxLength} characters`, value, errors_type.ErrorCode.STRING_TOO_LONG));
+            return result;
+        }
+        // Basic format check - must contain exactly one @
+        const atSymbolCount = (email.match(/@/g) || []).length;
+        if (atSymbolCount !== 1) {
+            result.success = false;
+            result.errors.push(ErrorHandler.ErrorHandler.createValidationError([], "Email must contain exactly one @ symbol", errors_type.ErrorCode.SECURITY_VIOLATION));
+            return result;
+        }
+        const [localPart, domain] = email.split("@");
+        // Check for empty parts
+        if (!localPart || !domain) {
+            result.success = false;
+            result.errors.push(ErrorHandler.ErrorHandler.createValidationError([], "Email local part and domain cannot be empty", errors_type.ErrorCode.SECURITY_VIOLATION));
+            return result;
+        }
+        // Local part length validation
+        if (localPart.length > 64) {
+            result.success = false;
+            result.errors.push(ErrorHandler.ErrorHandler.createValidationError([], "Email local part exceeds 64 characters", errors_type.ErrorCode.SECURITY_VIOLATION));
+        }
+        // Plus addressing check - FIXED LOGIC
+        if (localPart.includes("+")) {
+            result.success = false;
+            result.errors.push(ErrorHandler.ErrorHandler.createValidationError([], "Plus addressing (+ symbols) is not allowed", errors_type.ErrorCode.SECURITY_VIOLATION));
+        }
+        // Local part character validation - FIXED TO PROPERLY HANDLE INVALID CHARACTERS
+        if (strict) {
+            // Practical validation - common characters only (excludes # and other problematic chars)
+            const validLocalPartRegex = /^[a-zA-Z0-9._+-]+$/;
+            if (!validLocalPartRegex.test(localPart)) {
+                result.success = false;
+                result.errors.push(ErrorHandler.ErrorHandler.createValidationError([], "Email local part contains invalid characters", errors_type.ErrorCode.SECURITY_VIOLATION));
+            }
+        }
+        else {
+            // RFC 5322 compliant - more permissive but excludes problematic chars like #
+            const validLocalPartRegex = /^[a-zA-Z0-9!#$%&'*+/=?^_`{|}~-]+(?:\.[a-zA-Z0-9!#$%&'*+/=?^_`{|}~-]+)*$/;
+            if (!validLocalPartRegex.test(localPart)) {
+                result.success = false;
+                result.errors.push(ErrorHandler.ErrorHandler.createValidationError([], "Email local part contains invalid characters", errors_type.ErrorCode.SECURITY_VIOLATION));
+            }
+        }
+        // Check for consecutive dots
+        if (localPart.includes("..")) {
+            result.success = false;
+            result.errors.push(ErrorHandler.ErrorHandler.createValidationError([], "Email local part cannot contain consecutive dots", errors_type.ErrorCode.SECURITY_VIOLATION));
+        }
+        // Check for dots at start or end
+        if (localPart.startsWith(".") || localPart.endsWith(".")) {
+            result.success = false;
+            result.errors.push(ErrorHandler.ErrorHandler.createValidationError([], "Email local part cannot start or end with a dot", errors_type.ErrorCode.SECURITY_VIOLATION));
+        }
+        // Domain validation
+        if (domain.length > 255) {
+            result.success = false;
+            result.errors.push(ErrorHandler.ErrorHandler.createValidationError([], "Email domain exceeds 255 characters", errors_type.ErrorCode.SECURITY_VIOLATION));
+        }
+        // Domain format validation
+        if (strict) {
+            // Basic domain validation - must have at least one dot and valid TLD
+            const validDomainRegex = /^[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}$/;
+            if (!validDomainRegex.test(domain)) {
+                result.success = false;
+                result.errors.push(ErrorHandler.ErrorHandler.createValidationError([], "Invalid domain format - must contain at least one dot and valid TLD", errors_type.ErrorCode.SECURITY_VIOLATION));
+            }
+        }
+        else {
+            // More strict domain validation
+            const validDomainRegex = /^[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?(?:\.[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?)*$/;
+            if (!validDomainRegex.test(domain)) {
+                result.success = false;
+                result.errors.push(ErrorHandler.ErrorHandler.createValidationError([], "Invalid domain format", errors_type.ErrorCode.SECURITY_VIOLATION));
+            }
+        }
+        // Check for consecutive dots in domain
+        if (domain.includes("..")) {
+            result.success = false;
+            result.errors.push(ErrorHandler.ErrorHandler.createValidationError([], "Domain cannot contain consecutive dots", errors_type.ErrorCode.SECURITY_VIOLATION));
+        }
+        // Check for dots at start or end of domain
+        if (domain.startsWith(".") || domain.endsWith(".")) {
+            result.success = false;
+            result.errors.push(ErrorHandler.ErrorHandler.createValidationError([], "Domain cannot start or end with a dot", errors_type.ErrorCode.SECURITY_VIOLATION));
+        }
+        // International domain validation
+        if (!allowInternational && /[^\x00-\x7F]/.test(domain)) {
+            result.success = false;
+            result.errors.push(ErrorHandler.ErrorHandler.createValidationError([], "International domain names are not allowed", errors_type.ErrorCode.SECURITY_VIOLATION));
+        }
+        // Domain whitelist/blacklist
+        if (allowedDomains.length > 0 && !allowedDomains.includes(domain)) {
+            result.success = false;
+            result.errors.push(ErrorHandler.ErrorHandler.createValidationError([], `Email domain '${domain}' is not allowed`, errors_type.ErrorCode.SECURITY_VIOLATION));
+        }
+        if (blockedDomains.includes(domain)) {
+            result.success = false;
+            result.errors.push(ErrorHandler.ErrorHandler.createValidationError([], `Email domain '${domain}' is blocked`, errors_type.ErrorCode.SECURITY_VIOLATION));
+        }
+        // Additional validation for common invalid patterns
+        const invalidCharsRegex = /[<>()[\]\\,;:\s@"]/;
+        if (invalidCharsRegex.test(localPart)) {
+            result.success = false;
+            result.errors.push(ErrorHandler.ErrorHandler.createValidationError([], "Email local part contains prohibited characters (spaces, quotes, brackets, etc.)", errors_type.ErrorCode.SECURITY_VIOLATION));
+        }
+        // Suspicious patterns
+        if (/test|temp|fake|spam|noreply/i.test(email)) {
+            result.warnings.push("Email appears to be temporary or test address");
+        }
+        // Set the cleaned data
+        result.data = email;
+        return result;
+    }
+    /**
+     * Get validation performance metrics
+     */
+    static getMetrics() {
+        return securityValidatorHelpers.ValidationMetrics.getMetrics();
+    }
+    /**
+     * Reset validation metrics
+     */
+    static resetMetrics() {
+        securityValidatorHelpers.ValidationMetrics.reset();
+    }
+    /**
+     * Clear validation cache
+     */
+    static clearCache() {
+        securityValidatorHelpers.ValidationCache.clear();
+    }
+    /**
+     * Validate multiple values with batch processing
+     */
+    static async validateBatch(values, validator, options = {}) {
+        const { continueOnError = true, maxConcurrency = 10, timeout = 30000, } = options;
+        const results = [];
+        const batches = [];
+        // Create batches
+        for (let i = 0; i < values.length; i += maxConcurrency) {
+            batches.push(values.slice(i, i + maxConcurrency));
+        }
+        try {
+            await this.withTimeout(async () => {
+                for (const batch of batches) {
+                    const batchPromises = batch.map(async (value) => {
+                        try {
+                            return await Promise.resolve(validator(value));
+                        }
+                        catch (error) {
+                            return {
+                                success: false,
+                                errors: [
+                                    ErrorHandler.ErrorHandler.createValidationError([], `Batch validation error: ${error instanceof Error ? error.message : "Unknown error"}`, errors_type.ErrorCode.UNKNOWN_ERROR),
+                                ],
+                                warnings: [],
+                                data: value,
+                            };
+                        }
+                    });
+                    const batchResults = await Promise.all(batchPromises);
+                    results.push(...batchResults);
+                    // Stop on first error if continueOnError is false
+                    if (!continueOnError && batchResults.some((r) => !r.success)) {
+                        break;
+                    }
+                }
+            }, timeout);
+        }
+        catch (error) {
+            // Add timeout error for remaining values
+            const remaining = values.length - results.length;
+            for (let i = 0; i < remaining; i++) {
+                results.push({
+                    success: false,
+                    errors: [
+                        ErrorHandler.ErrorHandler.createValidationError([], `Batch validation timeout: ${error instanceof Error ? error.message : "Unknown error"}`, errors_type.ErrorCode.UNKNOWN_ERROR),
+                    ],
+                    warnings: [],
+                    data: values[results.length + i],
+                });
+            }
+        }
+        const summary = {
+            total: results.length,
+            passed: results.filter((r) => r.success).length,
+            failed: results.filter((r) => !r.success).length,
+        };
+        return { results, summary };
+    }
+}
+SecurityValidators.ajv = null;
+SecurityValidators.ajvOptions = {
+    strict: false,
+    allErrors: true,
+    removeAdditional: false,
+    useDefaults: false,
+    coerceTypes: false,
+    validateFormats: true,
+    addUsedSchema: false,
+    verbose: false,
+    loadSchema: false, // Disable remote schema loading for security
+};
+
+exports.SECURITY_CONSTANTS = SECURITY_CONSTANTS.SECURITY_CONSTANTS;
+exports.ValidationCache = securityValidatorHelpers.ValidationCache;
+exports.ValidationMetrics = securityValidatorHelpers.ValidationMetrics;
+exports.Security = SecurityValidators;
+exports.SecurityValidators = SecurityValidators;
+//# sourceMappingURL=securityValidator.js.map