xypriss 1.1.0 → 1.1.3

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

@@ -1,273 +0,0 @@
-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/toolkit/src/components/secure-array/utils/validation.js.map

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