xypriss 1.0.0 → 1.1.0

package/dist/esm/mods/security/src/components/secure-array/utils/validation.js

@@ -0,0 +1,273 @@
+import { isSecureArrayValue } from '../types/index.js';
+
+/***************************************************************************
+ * XyPrissSecurity - Secure Array Validation Utilities
+ *
+ * This file contains validation utilities for SecureArray
+ *
+ * @author Nehonix
+ *
+ * @license MIT
+ *
+ * Copyright (c) 2025 Nehonix. All rights reserved.
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ ***************************************************************************** */
+/**
+ * Validation utilities for SecureArray
+ */
+/**
+ * Validation utilities for SecureArray operations
+ */
+class ArrayValidationUtils {
+    /**
+     * Validates a SecureArray value
+     */
+    static validateSecureArrayValue(value) {
+        if (!isSecureArrayValue(value)) {
+            throw new Error(`Invalid SecureArray value: ${typeof value}`);
+        }
+    }
+    /**
+     * Validates an array index
+     */
+    static validateIndex(index, arrayLength) {
+        if (!Number.isInteger(index)) {
+            throw new Error(`Index must be an integer: ${index}`);
+        }
+        if (index < 0) {
+            throw new Error(`Index cannot be negative: ${index}`);
+        }
+        if (arrayLength !== undefined && index >= arrayLength) {
+            throw new Error(`Index out of bounds: ${index} >= ${arrayLength}`);
+        }
+    }
+    /**
+     * Validates SecureArray options
+     */
+    static validateOptions(options) {
+        const errors = [];
+        const warnings = [];
+        if (options.maxMemory !== undefined) {
+            if (typeof options.maxMemory !== "number" ||
+                options.maxMemory <= 0) {
+                errors.push("maxMemory must be a positive number");
+            }
+        }
+        if (options.gcThreshold !== undefined) {
+            if (typeof options.gcThreshold !== "number" ||
+                options.gcThreshold < 0 ||
+                options.gcThreshold > 1) {
+                errors.push("gcThreshold must be a number between 0 and 1");
+            }
+        }
+        if (options.maxLength !== undefined) {
+            if (typeof options.maxLength !== "number" ||
+                options.maxLength <= 0) {
+                errors.push("maxLength must be a positive number");
+            }
+        }
+        if (options.encryptionKey !== undefined) {
+            if (typeof options.encryptionKey !== "string") {
+                errors.push("encryptionKey must be a string");
+            }
+            else if (options.encryptionKey.length < 8) {
+                warnings.push("encryptionKey should be at least 8 characters long");
+            }
+        }
+        return {
+            isValid: errors.length === 0,
+            errors,
+            warnings,
+        };
+    }
+    /**
+     * Validates an array of values
+     */
+    static validateArray(values) {
+        const errors = [];
+        const warnings = [];
+        if (!Array.isArray(values)) {
+            errors.push("Input must be an array");
+            return { isValid: false, errors, warnings };
+        }
+        for (let i = 0; i < values.length; i++) {
+            try {
+                this.validateSecureArrayValue(values[i]);
+            }
+            catch (error) {
+                errors.push(`Invalid value at index ${i}: ${error.message}`);
+            }
+        }
+        if (values.length > 10000) {
+            warnings.push("Large array detected, consider performance implications");
+        }
+        return {
+            isValid: errors.length === 0,
+            errors,
+            warnings,
+        };
+    }
+    /**
+     * Validates a callback function
+     */
+    static validateCallback(callback, name = "callback") {
+        if (typeof callback !== "function") {
+            throw new Error(`${name} must be a function`);
+        }
+    }
+    /**
+     * Validates a predicate function
+     */
+    static validatePredicate(predicate) {
+        this.validateCallback(predicate, "predicate");
+    }
+    /**
+     * Validates a mapper function
+     */
+    static validateMapper(mapper) {
+        this.validateCallback(mapper, "mapper");
+    }
+    /**
+     * Validates a reducer function
+     */
+    static validateReducer(reducer) {
+        this.validateCallback(reducer, "reducer");
+    }
+    /**
+     * Validates a comparator function
+     */
+    static validateComparator(comparator) {
+        this.validateCallback(comparator, "comparator");
+    }
+    /**
+     * Validates a range (start and end indices)
+     */
+    static validateRange(start, end, arrayLength) {
+        this.validateIndex(start);
+        this.validateIndex(end);
+        if (start > end) {
+            throw new Error(`Start index (${start}) cannot be greater than end index (${end})`);
+        }
+        if (end >= arrayLength) {
+            throw new Error(`End index (${end}) is out of bounds for array length ${arrayLength}`);
+        }
+    }
+    /**
+     * Validates a chunk size
+     */
+    static validateChunkSize(size) {
+        if (!Number.isInteger(size) || size <= 0) {
+            throw new Error(`Chunk size must be a positive integer: ${size}`);
+        }
+    }
+    /**
+     * Sanitizes an index to ensure it's valid
+     */
+    static sanitizeIndex(index) {
+        const num = Number(index);
+        if (!Number.isInteger(num) || num < 0) {
+            throw new Error(`Invalid index: ${index}`);
+        }
+        return num;
+    }
+    /**
+     * Checks if a value is a SecureString
+     */
+    static isSecureString(value) {
+        return (value &&
+            typeof value === "object" &&
+            value.constructor?.name === "SecureString");
+    }
+    /**
+     * Checks if a value is a SecureObject
+     */
+    static isSecureObject(value) {
+        return (value &&
+            typeof value === "object" &&
+            value.constructor?.name === "SecureObject");
+    }
+    /**
+     * Checks if a value is a SecureArray
+     */
+    static isSecureArray(value) {
+        return (value &&
+            typeof value === "object" &&
+            value.constructor?.name === "SecureArray");
+    }
+    /**
+     * Validates memory usage
+     */
+    static validateMemoryUsage(currentUsage, maxMemory) {
+        if (currentUsage > maxMemory) {
+            throw new Error(`Memory usage (${currentUsage}) exceeds maximum allowed (${maxMemory})`);
+        }
+    }
+    /**
+     * Validates that an array is not destroyed
+     */
+    static validateNotDestroyed(isDestroyed) {
+        if (isDestroyed) {
+            throw new Error("SecureArray has been destroyed");
+        }
+    }
+    /**
+     * Validates that an array is not read-only
+     */
+    static validateNotReadOnly(isReadOnly) {
+        if (isReadOnly) {
+            throw new Error("SecureArray is read-only");
+        }
+    }
+    /**
+     * Validates encryption key strength
+     */
+    static validateEncryptionKey(key) {
+        const errors = [];
+        const warnings = [];
+        if (key === null || key === undefined) {
+            return { isValid: true, errors, warnings };
+        }
+        if (typeof key !== "string") {
+            errors.push("Encryption key must be a string");
+            return { isValid: false, errors, warnings };
+        }
+        if (key.length < 8) {
+            errors.push("Encryption key must be at least 8 characters long");
+        }
+        else if (key.length < 16) {
+            warnings.push("Consider using a longer encryption key for better security");
+        }
+        // Check for common weak patterns
+        if (/^(.)\1+$/.test(key)) {
+            warnings.push("Encryption key should not consist of repeated characters");
+        }
+        if (/^(012|123|abc|password|secret)/i.test(key)) {
+            warnings.push("Encryption key appears to be weak or common");
+        }
+        return {
+            isValid: errors.length === 0,
+            errors,
+            warnings,
+        };
+    }
+}
+
+export { ArrayValidationUtils };
+//# sourceMappingURL=validation.js.map

package/dist/esm/mods/security/src/components/secure-array/utils/validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.js","sources":["../../../../../../../../mods/security/src/components/secure-array/utils/validation.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}