xypriss 1.0.1 → 1.1.0

package/dist/esm/mods/security/src/components/secure-array/serialization/ArraySerializationHandler.js

@@ -0,0 +1,388 @@
+import { bufferToBase64, base64ToBuffer } from '../../../utils/encoding.js';
+import { Hash } from '../../../core/hash/hash-core.js';
+import '../../../core/hash/hash-types.js';
+import 'crypto';
+import '../../../core/hash/hash-security.js';
+import '../../../core/hash/hash-advanced.js';
+import '../../../algorithms/hash-algorithms.js';
+
+/***************************************************************************
+ * XyPrissSecurity - Secure Array Serialization Handler
+ *
+ * This file contains the serialization operations for SecureArray
+ *
+ * @author Nehonix
+ * @version 2.0.0
+ * @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.
+ ***************************************************************************** */
+/**
+ * Serialization handler for SecureArray operations
+ */
+class ArraySerializationHandler {
+    constructor(crypto, metadata) {
+        this.crypto = crypto;
+        this.metadata = metadata;
+        this.version = "2.0.0";
+        this.format = "XyPrissSecurity-SecureArray";
+    }
+    /**
+     * Serializes SecureArray data to a secure format
+     */
+    serialize(elements, options = {}) {
+        try {
+            const { includeMetadata = true, encryptSensitive = true, compression = false, format = "json", includeChecksum = true, } = options;
+            // Create serialization package
+            const package_ = {
+                version: this.version,
+                format: this.format,
+                timestamp: Date.now(),
+                elements: this.serializeElements(elements, encryptSensitive),
+                metadata: includeMetadata ? this.serializeMetadata() : null,
+                checksum: null,
+                compression: compression,
+                elementCount: elements.length,
+            };
+            // Generate checksum if requested
+            if (includeChecksum) {
+                package_.checksum = this.generateChecksum(package_);
+            }
+            // Convert to string based on format
+            let serialized;
+            switch (format) {
+                case "json":
+                    serialized = JSON.stringify(package_, null, 0);
+                    break;
+                case "compact":
+                    serialized = JSON.stringify(package_);
+                    break;
+                case "base64":
+                    serialized = bufferToBase64(new TextEncoder().encode(JSON.stringify(package_)));
+                    break;
+                default:
+                    serialized = JSON.stringify(package_);
+            }
+            // Apply compression if requested
+            if (compression) {
+                serialized = this.compressData(serialized);
+            }
+            return serialized;
+        }
+        catch (error) {
+            console.error("Serialization failed:", error);
+            throw new Error(`Serialization failed: ${error.message}`);
+        }
+    }
+    /**
+     * Deserializes SecureArray data from a secure format
+     */
+    deserialize(serializedData) {
+        try {
+            // Detect and handle compression
+            let data = serializedData;
+            if (this.isCompressed(data)) {
+                data = this.decompressData(data);
+            }
+            // Parse the package
+            let package_;
+            try {
+                // Try base64 decode first
+                if (this.isBase64Format(data)) {
+                    const decoded = base64ToBuffer(data);
+                    package_ = JSON.parse(new TextDecoder().decode(decoded));
+                }
+                else {
+                    package_ = JSON.parse(data);
+                }
+            }
+            catch {
+                throw new Error("Invalid serialization format");
+            }
+            // Validate package structure
+            this.validatePackage(package_);
+            // Verify checksum if present
+            if (package_.checksum) {
+                const originalChecksum = package_.checksum;
+                package_.checksum = null;
+                const computedChecksum = this.generateChecksum(package_);
+                if (originalChecksum !== computedChecksum) {
+                    throw new Error("Checksum verification failed - data may be corrupted");
+                }
+            }
+            // Deserialize elements
+            const elements = this.deserializeElements(package_.elements);
+            // Deserialize metadata
+            const metadata = package_.metadata
+                ? this.deserializeMetadata(package_.metadata)
+                : new Map();
+            return {
+                elements,
+                metadata,
+                version: package_.version,
+                timestamp: package_.timestamp,
+            };
+        }
+        catch (error) {
+            console.error("Deserialization failed:", error);
+            throw new Error(`Deserialization failed: ${error.message}`);
+        }
+    }
+    /**
+     * Serializes array elements with optional encryption
+     */
+    serializeElements(elements, encryptSensitive) {
+        return elements.map((element, index) => {
+            const metadata = this.metadata.get(index);
+            const isSecure = metadata?.isSecure || false;
+            if (encryptSensitive && isSecure && typeof element === "string") {
+                // Encrypt sensitive string data
+                return {
+                    type: "encrypted",
+                    value: this.crypto.encryptValue(element),
+                    originalType: metadata?.type || "string",
+                };
+            }
+            else {
+                // Store non-sensitive data as-is
+                return {
+                    type: "plain",
+                    value: element,
+                    originalType: metadata?.type || typeof element,
+                };
+            }
+        });
+    }
+    /**
+     * Deserializes array elements with decryption
+     */
+    deserializeElements(serializedElements) {
+        return serializedElements.map((item) => {
+            if (item.type === "encrypted") {
+                // Decrypt encrypted data
+                return this.crypto.decryptValue(item.value);
+            }
+            else {
+                // Return plain data
+                return item.value;
+            }
+        });
+    }
+    /**
+     * Serializes metadata
+     */
+    serializeMetadata() {
+        const metadataObj = {};
+        // Convert Map to object for serialization
+        for (const [index, metadata] of this.metadata.getAll()) {
+            metadataObj[index] = {
+                type: metadata.type,
+                isSecure: metadata.isSecure,
+                lastAccessed: metadata.lastAccessed,
+                accessCount: metadata.accessCount,
+            };
+        }
+        return metadataObj;
+    }
+    /**
+     * Deserializes metadata
+     */
+    deserializeMetadata(serializedMetadata) {
+        const metadata = new Map();
+        for (const [indexStr, data] of Object.entries(serializedMetadata)) {
+            const index = parseInt(indexStr, 10);
+            metadata.set(index, data);
+        }
+        return metadata;
+    }
+    /**
+     * Generates a checksum for data integrity
+     */
+    generateChecksum(package_) {
+        // Create a deterministic string representation
+        const dataStr = JSON.stringify(package_, Object.keys(package_).sort());
+        // Generate SHA-256 hash
+        const hash = Hash.create(dataStr, {
+            algorithm: "sha256",
+            outputFormat: "hex",
+        });
+        return hash;
+    }
+    /**
+     * Validates package structure
+     */
+    validatePackage(package_) {
+        if (!package_ || typeof package_ !== "object") {
+            throw new Error("Invalid package structure");
+        }
+        const requiredFields = ["version", "format", "timestamp", "elements"];
+        for (const field of requiredFields) {
+            if (!(field in package_)) {
+                throw new Error(`Missing required field: ${field}`);
+            }
+        }
+        if (package_.format !== this.format) {
+            throw new Error(`Unsupported format: ${package_.format}`);
+        }
+        if (!Array.isArray(package_.elements)) {
+            throw new Error("Elements must be an array");
+        }
+    }
+    /**
+     * Compresses data using a simple compression algorithm
+     */
+    compressData(data) {
+        // Simple compression using base64 encoding with compression marker
+        const compressed = bufferToBase64(new TextEncoder().encode(data));
+        return `[COMPRESSED:${compressed}]`;
+    }
+    /**
+     * Decompresses data
+     */
+    decompressData(data) {
+        if (!this.isCompressed(data)) {
+            return data;
+        }
+        // Extract compressed data
+        const compressedData = data.slice(12, -1); // Remove [COMPRESSED: and ]
+        const decompressed = base64ToBuffer(compressedData);
+        return new TextDecoder().decode(decompressed);
+    }
+    /**
+     * Checks if data is compressed
+     */
+    isCompressed(data) {
+        return data.startsWith("[COMPRESSED:") && data.endsWith("]");
+    }
+    /**
+     * Checks if data is in base64 format
+     */
+    isBase64Format(data) {
+        try {
+            // Simple base64 detection
+            return /^[A-Za-z0-9+/]*={0,2}$/.test(data) && data.length % 4 === 0;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Exports array data in various formats
+     */
+    exportData(elements, format = "json") {
+        try {
+            switch (format) {
+                case "json":
+                    return JSON.stringify(elements, null, 2);
+                case "csv":
+                    return this.exportToCSV(elements);
+                case "xml":
+                    return this.exportToXML(elements);
+                case "yaml":
+                    return this.exportToYAML(elements);
+                default:
+                    throw new Error(`Unsupported export format: ${format}`);
+            }
+        }
+        catch (error) {
+            console.error("Export failed:", error);
+            throw new Error(`Export failed: ${error.message}`);
+        }
+    }
+    /**
+     * Exports to CSV format
+     */
+    exportToCSV(elements) {
+        if (elements.length === 0) {
+            return "";
+        }
+        // Simple CSV export
+        const rows = [];
+        // Header
+        rows.push("Index,Value,Type");
+        // Data rows
+        elements.forEach((element, index) => {
+            const value = typeof element === "string"
+                ? `"${element.replace(/"/g, '""')}"`
+                : String(element);
+            const type = typeof element;
+            rows.push(`${index},${value},${type}`);
+        });
+        return rows.join("\n");
+    }
+    /**
+     * Exports to XML format
+     */
+    exportToXML(elements) {
+        const xmlElements = elements
+            .map((element, index) => {
+            const value = String(element)
+                .replace(/&/g, "&")
+                .replace(/</g, "&lt;")
+                .replace(/>/g, "&gt;");
+            const type = typeof element;
+            return `  <element index="${index}" type="${type}">${value}</element>`;
+        })
+            .join("\n");
+        return `<?xml version="1.0" encoding="UTF-8"?>\n<secureArray>\n${xmlElements}\n</secureArray>`;
+    }
+    /**
+     * Exports to YAML format
+     */
+    exportToYAML(elements) {
+        const yamlElements = elements
+            .map((element, index) => {
+            const value = typeof element === "string"
+                ? `"${element.replace(/"/g, '\\"')}"`
+                : String(element);
+            return `  - index: ${index}\n    value: ${value}\n    type: ${typeof element}`;
+        })
+            .join("\n");
+        return `secureArray:\n${yamlElements}`;
+    }
+    /**
+     * Gets serialization statistics
+     */
+    getSerializationStats() {
+        return {
+            version: this.version,
+            format: this.format,
+            supportedFormats: ["json", "compact", "base64"],
+            features: [
+                "Encryption",
+                "Compression",
+                "Checksum verification",
+                "Metadata preservation",
+                "Multiple export formats",
+            ],
+        };
+    }
+    /**
+     * Securely destroys the serialization handler
+     */
+    destroy() {
+        // Clear any cached data
+        // The crypto and metadata handlers will be destroyed by their owners
+    }
+}
+
+export { ArraySerializationHandler };
+//# sourceMappingURL=ArraySerializationHandler.js.map

package/dist/esm/mods/security/src/components/secure-array/serialization/ArraySerializationHandler.js.map

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

package/dist/esm/mods/security/src/components/secure-array/types/index.js

@@ -0,0 +1,84 @@
+import { SecureString } from '../../secure-string/core/secure-string-core.js';
+import 'crypto';
+import '../../../types/secure-memory.js';
+import '../../secure-string/advanced/entropy-analyzer.js';
+import '../../secure-string/advanced/quantum-safe.js';
+import '../../secure-string/advanced/performance-monitor.js';
+import { SecureObject } from '../../secure-object/core/secure-object-core.js';
+import '../../../core/hash/hash-core.js';
+import '../../../core/hash/hash-types.js';
+import '../../../core/hash/hash-security.js';
+import '../../../core/hash/hash-advanced.js';
+import '../../../algorithms/hash-algorithms.js';
+import '../../../core/random/random-types.js';
+import '../../../core/random/random-sources.js';
+import 'nehonix-uri-processor';
+import '../../../utils/memory/index.js';
+import '../../../types.js';
+import 'nehoid';
+
+/***************************************************************************
+ * XyPrissSecurity - Secure Array Types
+ *
+ * This file contains type definitions for the SecureArray modular architecture
+ *
+ * @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.
+ ***************************************************************************** */
+/**
+ * Type definitions for SecureArray modular architecture
+ */
+/**
+ * Default options for SecureArray
+ */
+const DEFAULT_SECURE_ARRAY_OPTIONS = {
+    readOnly: false,
+    autoDestroy: false,
+    encryptionKey: "",
+    maxMemory: 100 * 1024 * 1024, // 100MB
+    gcThreshold: 0.8,
+    enableMemoryTracking: true,
+    autoCleanup: true,
+    maxLength: Number.MAX_SAFE_INTEGER,
+    maxSize: Number.MAX_SAFE_INTEGER,
+    enableIndexValidation: true,
+    enableTypeValidation: true,
+};
+/**
+ * Type guard for SecureArray values
+ */
+function isSecureArrayValue(value) {
+    return (typeof value === "string" ||
+        typeof value === "number" ||
+        typeof value === "boolean" ||
+        value instanceof Uint8Array ||
+        value instanceof SecureString ||
+        value instanceof SecureObject ||
+        value === null ||
+        value === undefined ||
+        (typeof value === "object" && value !== null));
+}
+
+export { DEFAULT_SECURE_ARRAY_OPTIONS, isSecureArrayValue };
+//# sourceMappingURL=index.js.map

package/dist/esm/mods/security/src/components/secure-array/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":["../../../../../../../../mods/security/src/components/secure-array/types/index.ts"],"sourcesContent":[null],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA4BiF;AAEjF;;AAEG;AA6LH;;AAEG;AACU,MAAA,4BAA4B,GAAiC;AACtE,IAAA,QAAQ,EAAE,KAAK;AACf,IAAA,WAAW,EAAE,KAAK;AAClB,IAAA,aAAa,EAAE,EAAE;AACjB,IAAA,SAAS,EAAE,GAAG,GAAG,IAAI,GAAG,IAAI;AAC5B,IAAA,WAAW,EAAE,GAAG;AAChB,IAAA,oBAAoB,EAAE,IAAI;AAC1B,IAAA,WAAW,EAAE,IAAI;IACjB,SAAS,EAAE,MAAM,CAAC,gBAAgB;IAClC,OAAO,EAAE,MAAM,CAAC,gBAAgB;AAChC,IAAA,qBAAqB,EAAE,IAAI;AAC3B,IAAA,oBAAoB,EAAE,IAAI;EACnB;AA4BX;;AAEG;AACG,SAAU,kBAAkB,CAAC,KAAU,EAAA;AACzC,IAAA,QACI,OAAO,KAAK,KAAK,QAAQ;QACzB,OAAO,KAAK,KAAK,QAAQ;QACzB,OAAO,KAAK,KAAK,SAAS;AAC1B,QAAA,KAAK,YAAY,UAAU;AAC3B,QAAA,KAAK,YAAY,YAAY;AAC7B,QAAA,KAAK,YAAY,YAAY;AAC7B,QAAA,KAAK,KAAK,IAAI;AACd,QAAA,KAAK,KAAK,SAAS;SAClB,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,CAAC,EAC/C;AACN;;;;"}

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

@@ -0,0 +1,78 @@
+import { NehoID } from 'nehoid';
+
+/***************************************************************************
+ * XyPrissSecurity - Secure Array ID Generator
+ *
+ * This file contains the ID generation utility 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.
+ ***************************************************************************** */
+/**
+ * ID generator utility for SecureArray instances
+ */
+/**
+ * Generates unique IDs for SecureArray instances
+ */
+class ArrayIdGenerator {
+    /**
+     * Generates a unique ID for a SecureArray instance
+     */
+    static generate() {
+        return NehoID.generate({ prefix: this.prefix, size: 10 });
+    }
+    /**
+     * Validates if a string is a valid SecureArray ID
+     */
+    static isValid(id) {
+        if (typeof id !== "string") {
+            return false;
+        }
+        return (id.startsWith(this.prefix + "-") &&
+            id.length > this.prefix.length + 1);
+    }
+    /**
+     * Resets the counter (for testing purposes)
+     */
+    static resetCounter() {
+        this.counter = 0;
+    }
+    /**
+     * Gets the current counter value
+     */
+    static getCounter() {
+        return this.counter;
+    }
+    /**
+     * Gets the prefix used for IDs
+     */
+    static getPrefix() {
+        return this.prefix;
+    }
+}
+ArrayIdGenerator.counter = 0;
+ArrayIdGenerator.prefix = "f.arr.";
+
+export { ArrayIdGenerator };
+//# sourceMappingURL=id-generator.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"id-generator.js","sources":["../../../../../../../../mods/security/src/components/secure-array/utils/id-generator.ts"],"sourcesContent":[null],"names":[],"mappings":";;AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA4BiF;AAIjF;;AAEG;AAEH;;AAEG;MACU,gBAAgB,CAAA;AAIzB;;AAEG;AACI,IAAA,OAAO,QAAQ,GAAA;AAClB,QAAA,OAAO,MAAM,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;KAC7D;AAED;;AAEG;IACI,OAAO,OAAO,CAAC,EAAU,EAAA;AAC5B,QAAA,IAAI,OAAO,EAAE,KAAK,QAAQ,EAAE;AACxB,YAAA,OAAO,KAAK,CAAC;SAChB;QAED,QACI,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,MAAM,GAAG,GAAG,CAAC;YAChC,EAAE,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EACpC;KACL;AAED;;AAEG;AACI,IAAA,OAAO,YAAY,GAAA;AACtB,QAAA,IAAI,CAAC,OAAO,GAAG,CAAC,CAAC;KACpB;AAED;;AAEG;AACI,IAAA,OAAO,UAAU,GAAA;QACpB,OAAO,IAAI,CAAC,OAAO,CAAC;KACvB;AAED;;AAEG;AACI,IAAA,OAAO,SAAS,GAAA;QACnB,OAAO,IAAI,CAAC,MAAM,CAAC;KACtB;;AA3Cc,gBAAO,CAAA,OAAA,GAAW,CAAC,CAAC;AACX,gBAAM,CAAA,MAAA,GAAW,QAAQ;;;;"}