xypriss 1.0.0 → 1.0.1

package/dist/cjs/mods/toolkit/src/components/secure-object/serialization/serialization-handler.js

@@ -0,0 +1,197 @@
+'use strict';
+
+var secureMemory = require('../../secure-memory.js');
+var secureStringCore = require('../../secure-string/core/secure-string-core.js');
+require('crypto');
+require('../../secure-string/advanced/entropy-analyzer.js');
+require('../../secure-string/advanced/quantum-safe.js');
+require('../../secure-string/advanced/performance-monitor.js');
+
+/**
+ * Serialization Handler Module
+ * Handles object serialization and format conversion
+ */
+/**
+ * Handles serialization operations for SecureObject
+ */
+class SerializationHandler {
+    constructor(cryptoHandler, metadataManager) {
+        this.cryptoHandler = cryptoHandler;
+        this.metadataManager = metadataManager;
+    }
+    /**
+     * Converts SecureObject data to a regular object
+     */
+    toObject(data, sensitiveKeys, options = {}) {
+        const result = {};
+        for (const [key, value] of data.entries()) {
+            const metadata = this.metadataManager.get(key);
+            const isUserDefinedSensitive = typeof sensitiveKeys === "function"
+                ? sensitiveKeys(key)
+                : sensitiveKeys.has(key);
+            // Handle sensitive keys
+            if (isUserDefinedSensitive) {
+                if (options.encryptSensitive) {
+                    // Encrypt user-defined sensitive data
+                    let valueToEncrypt;
+                    if (value instanceof secureMemory.SecureBuffer) {
+                        const buffer = value.getBuffer();
+                        if (metadata?.type === "Uint8Array") {
+                            valueToEncrypt = Array.from(new Uint8Array(buffer));
+                        }
+                        else {
+                            valueToEncrypt = new TextDecoder().decode(buffer);
+                        }
+                    }
+                    else if (value instanceof secureStringCore.SecureString) {
+                        valueToEncrypt = value.toString();
+                    }
+                    else {
+                        valueToEncrypt = value;
+                    }
+                    result[key] =
+                        this.cryptoHandler.encryptValue(valueToEncrypt);
+                }
+                // If encryptSensitive is false, skip sensitive keys (filter them out)
+                // This is the fix for the nested password filtering bug
+            }
+            else {
+                // Normal processing - show actual values for non-sensitive keys
+                result[key] = this.processValue(value, metadata, options, sensitiveKeys);
+            }
+        }
+        if (options.includeMetadata) {
+            result._metadata = this.metadataManager.toObject();
+        }
+        return this.applyFormat(result, options);
+    }
+    /**
+     * Processes a single value for serialization
+     */
+    processValue(value, metadata, options, sensitiveKeys) {
+        if (value instanceof secureMemory.SecureBuffer) {
+            const buffer = value.getBuffer();
+            if (metadata?.type === "Uint8Array") {
+                // Return as Uint8Array for binary data
+                return new Uint8Array(buffer);
+            }
+            else {
+                // Return as string for text data
+                return new TextDecoder().decode(buffer);
+            }
+        }
+        else if (value instanceof secureStringCore.SecureString) {
+            return value.toString();
+        }
+        else if (value &&
+            typeof value === "object" &&
+            typeof value.toObject === "function") {
+            // For nested SecureObjects, recursively process with the same options
+            // Pass through the strictSensitiveKeys option to maintain consistency
+            return value.toObject(options);
+        }
+        else if (typeof value === "object" && value !== null) {
+            // For regular nested objects, recursively check for sensitive keys
+            // FIXED: Pass the actual sensitive keys instead of empty Set
+            return this.cryptoHandler.processNestedObject(value, options, sensitiveKeys);
+        }
+        else {
+            return value;
+        }
+    }
+    /**
+     * Applies format transformation to the result
+     */
+    applyFormat(result, options) {
+        if (options.format === "binary") {
+            // Convert to binary format (Uint8Array)
+            const jsonString = JSON.stringify(result);
+            return new TextEncoder().encode(jsonString);
+        }
+        else if (options.format === "json") {
+            // Return as JSON string
+            return JSON.stringify(result);
+        }
+        // Default: return as regular object
+        return result;
+    }
+    /**
+     * Converts to JSON string
+     */
+    toJSON(data, sensitiveKeys, options = {}) {
+        const obj = this.toObject(data, sensitiveKeys, options);
+        return JSON.stringify(obj);
+    }
+    /**
+     * Creates a deterministic representation for hashing
+     */
+    createHashableRepresentation(entries) {
+        const sortedEntries = entries.sort(([a], [b]) => String(a).localeCompare(String(b)));
+        return JSON.stringify(sortedEntries.map(([key, value]) => [
+            String(key),
+            typeof value === "object" && value instanceof Uint8Array
+                ? Array.from(value)
+                : value,
+        ]));
+    }
+    /**
+     * Processes nested objects recursively for sensitive key detection
+     */
+    processNestedObject(obj, options, sensitiveKeys) {
+        return this.cryptoHandler.processNestedObject(obj, options, sensitiveKeys);
+    }
+    /**
+     * Validates serialization options
+     */
+    validateOptions(options) {
+        if (options.format && !["json", "binary"].includes(options.format)) {
+            throw new Error(`Invalid format option: ${options.format}. Must be 'json' or 'binary'.`);
+        }
+    }
+    /**
+     * Gets serialization statistics
+     */
+    getSerializationStats(data) {
+        let secureBufferCount = 0;
+        let secureStringCount = 0;
+        let nestedObjectCount = 0;
+        let primitiveCount = 0;
+        for (const value of data.values()) {
+            if (value instanceof secureMemory.SecureBuffer) {
+                secureBufferCount++;
+            }
+            else if (value instanceof secureStringCore.SecureString) {
+                secureStringCount++;
+            }
+            else if (typeof value === "object" && value !== null) {
+                nestedObjectCount++;
+            }
+            else {
+                primitiveCount++;
+            }
+        }
+        return {
+            totalKeys: data.size,
+            secureBufferCount,
+            secureStringCount,
+            nestedObjectCount,
+            primitiveCount,
+        };
+    }
+    /**
+     * Estimates serialized size
+     */
+    estimateSerializedSize(data, options = {}) {
+        try {
+            const serialized = this.toJSON(data, new Set(), options);
+            return new TextEncoder().encode(serialized).length;
+        }
+        catch (error) {
+            // Fallback estimation
+            return data.size * 50; // Rough estimate
+        }
+    }
+}
+
+exports.SerializationHandler = SerializationHandler;
+//# sourceMappingURL=serialization-handler.js.map

package/dist/cjs/mods/toolkit/src/components/secure-object/serialization/serialization-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serialization-handler.js","sources":["../../../../../../../../mods/toolkit/src/components/secure-object/serialization/serialization-handler.ts"],"sourcesContent":[null],"names":["SecureBuffer","SecureString"],"mappings":";;;;;;;;;AAAA;;;AAGG;AAQH;;AAEG;MACU,oBAAoB,CAAA;IAC7B,WACY,CAAA,aAA4B,EAC5B,eAAgC,EAAA;QADhC,IAAa,CAAA,aAAA,GAAb,aAAa,CAAe;QAC5B,IAAe,CAAA,eAAA,GAAf,eAAe,CAAiB;KACxC;AAEJ;;AAEG;AACH,IAAA,QAAQ,CACJ,IAAsB,EACtB,aAAuD,EACvD,UAAgC,EAAE,EAAA;QAElC,MAAM,MAAM,GAAG,EAAuD,CAAC;AAEvE,QAAA,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE;YACvC,MAAM,QAAQ,GAAG,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AAC/C,YAAA,MAAM,sBAAsB,GACxB,OAAO,aAAa,KAAK,UAAU;AAC/B,kBAAE,aAAa,CAAC,GAAG,CAAC;AACpB,kBAAE,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;;YAGjC,IAAI,sBAAsB,EAAE;AACxB,gBAAA,IAAI,OAAO,CAAC,gBAAgB,EAAE;;AAE1B,oBAAA,IAAI,cAAmB,CAAC;AACxB,oBAAA,IAAI,KAAK,YAAYA,yBAAY,EAAE;AAC/B,wBAAA,MAAM,MAAM,GAAG,KAAK,CAAC,SAAS,EAAE,CAAC;AACjC,wBAAA,IAAI,QAAQ,EAAE,IAAI,KAAK,YAAY,EAAE;4BACjC,cAAc,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC;yBACvD;6BAAM;4BACH,cAAc,GAAG,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;yBACrD;qBACJ;AAAM,yBAAA,IAAI,KAAK,YAAYC,6BAAY,EAAE;AACtC,wBAAA,cAAc,GAAG,KAAK,CAAC,QAAQ,EAAE,CAAC;qBACrC;yBAAM;wBACH,cAAc,GAAG,KAAK,CAAC;qBAC1B;oBACA,MAAc,CAAC,GAAG,CAAC;AAChB,wBAAA,IAAI,CAAC,aAAa,CAAC,YAAY,CAAC,cAAc,CAAC,CAAC;iBACvD;;;aAGJ;iBAAM;;AAEF,gBAAA,MAAc,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,YAAY,CACpC,KAAK,EACL,QAAQ,EACR,OAAO,EACP,aAAa,CAChB,CAAC;aACL;SACJ;AAED,QAAA,IAAI,OAAO,CAAC,eAAe,EAAE;YACzB,MAAM,CAAC,SAAS,GAAG,IAAI,CAAC,eAAe,CAAC,QAAQ,EAAE,CAAC;SACtD;QAED,OAAO,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KAC5C;AAED;;AAEG;AACK,IAAA,YAAY,CAChB,KAAU,EACV,QAAmC,EACnC,OAA6B,EAC7B,aAAuD,EAAA;AAEvD,QAAA,IAAI,KAAK,YAAYD,yBAAY,EAAE;AAC/B,YAAA,MAAM,MAAM,GAAG,KAAK,CAAC,SAAS,EAAE,CAAC;AAEjC,YAAA,IAAI,QAAQ,EAAE,IAAI,KAAK,YAAY,EAAE;;AAEjC,gBAAA,OAAO,IAAI,UAAU,CAAC,MAAM,CAAC,CAAC;aACjC;iBAAM;;gBAEH,OAAO,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;aAC3C;SACJ;AAAM,aAAA,IAAI,KAAK,YAAYC,6BAAY,EAAE;AACtC,YAAA,OAAO,KAAK,CAAC,QAAQ,EAAE,CAAC;SAC3B;AAAM,aAAA,IACH,KAAK;YACL,OAAO,KAAK,KAAK,QAAQ;AACzB,YAAA,OAAO,KAAK,CAAC,QAAQ,KAAK,UAAU,EACtC;;;AAGE,YAAA,OAAO,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;SAClC;aAAM,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,EAAE;;;AAGpD,YAAA,OAAO,IAAI,CAAC,aAAa,CAAC,mBAAmB,CACzC,KAAK,EACL,OAAO,EACP,aAAa,CAChB,CAAC;SACL;aAAM;AACH,YAAA,OAAO,KAAK,CAAC;SAChB;KACJ;AAED;;AAEG;IACK,WAAW,CAAI,MAAS,EAAE,OAA6B,EAAA;AAC3D,QAAA,IAAI,OAAO,CAAC,MAAM,KAAK,QAAQ,EAAE;;YAE7B,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;YAC1C,OAAO,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;SAC/C;AAAM,aAAA,IAAI,OAAO,CAAC,MAAM,KAAK,MAAM,EAAE;;AAElC,YAAA,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;SACjC;;AAGD,QAAA,OAAO,MAAM,CAAC;KACjB;AAED;;AAEG;AACH,IAAA,MAAM,CACF,IAAsB,EACtB,aAAuD,EACvD,UAAgC,EAAE,EAAA;AAElC,QAAA,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAI,IAAI,EAAE,aAAa,EAAE,OAAO,CAAC,CAAC;AAC3D,QAAA,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;KAC9B;AAED;;AAEG;AACH,IAAA,4BAA4B,CAAC,OAA0B,EAAA;AACnD,QAAA,MAAM,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KACxC,MAAM,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CACrC,CAAC;AAEF,QAAA,OAAO,IAAI,CAAC,SAAS,CACjB,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,KAAK;YAChC,MAAM,CAAC,GAAG,CAAC;AACX,YAAA,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,YAAY,UAAU;AACpD,kBAAE,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC;AACnB,kBAAE,KAAK;AACd,SAAA,CAAC,CACL,CAAC;KACL;AAED;;AAEG;AACH,IAAA,mBAAmB,CACf,GAAQ,EACR,OAA6B,EAC7B,aAAuD,EAAA;AAEvD,QAAA,OAAO,IAAI,CAAC,aAAa,CAAC,mBAAmB,CACzC,GAAG,EACH,OAAO,EACP,aAAa,CAChB,CAAC;KACL;AAED;;AAEG;AACH,IAAA,eAAe,CAAC,OAA6B,EAAA;AACzC,QAAA,IAAI,OAAO,CAAC,MAAM,IAAI,CAAC,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE;YAChE,MAAM,IAAI,KAAK,CACX,CAAA,uBAAA,EAA0B,OAAO,CAAC,MAAM,CAA+B,6BAAA,CAAA,CAC1E,CAAC;SACL;KACJ;AAED;;AAEG;AACH,IAAA,qBAAqB,CAAC,IAAsB,EAAA;QAOxC,IAAI,iBAAiB,GAAG,CAAC,CAAC;QAC1B,IAAI,iBAAiB,GAAG,CAAC,CAAC;QAC1B,IAAI,iBAAiB,GAAG,CAAC,CAAC;QAC1B,IAAI,cAAc,GAAG,CAAC,CAAC;QAEvB,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,MAAM,EAAE,EAAE;AAC/B,YAAA,IAAI,KAAK,YAAYD,yBAAY,EAAE;AAC/B,gBAAA,iBAAiB,EAAE,CAAC;aACvB;AAAM,iBAAA,IAAI,KAAK,YAAYC,6BAAY,EAAE;AACtC,gBAAA,iBAAiB,EAAE,CAAC;aACvB;iBAAM,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,EAAE;AACpD,gBAAA,iBAAiB,EAAE,CAAC;aACvB;iBAAM;AACH,gBAAA,cAAc,EAAE,CAAC;aACpB;SACJ;QAED,OAAO;YACH,SAAS,EAAE,IAAI,CAAC,IAAI;YACpB,iBAAiB;YACjB,iBAAiB;YACjB,iBAAiB;YACjB,cAAc;SACjB,CAAC;KACL;AAED;;AAEG;AACH,IAAA,sBAAsB,CAClB,IAAsB,EACtB,OAAA,GAAgC,EAAE,EAAA;AAElC,QAAA,IAAI;AACA,YAAA,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,GAAG,EAAE,EAAE,OAAO,CAAC,CAAC;YACzD,OAAO,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC;SACtD;QAAC,OAAO,KAAK,EAAE;;AAEZ,YAAA,OAAO,IAAI,CAAC,IAAI,GAAG,EAAE,CAAC;SACzB;KACJ;AACJ;;;;"}

package/dist/cjs/mods/toolkit/src/components/secure-object/utils/id-generator.js

@@ -0,0 +1,64 @@
+'use strict';
+
+var nehoid = require('nehoid');
+
+/**
+ * ID Generator Utility
+ * Generates unique IDs for SecureObject instances
+ */
+/**
+ * Generates unique IDs for SecureObject instances
+ */
+class IdGenerator {
+    /**
+     * Generates a unique ID for a SecureObject instance
+     */
+    static generate() {
+        return nehoid.NehoID.generate({ prefix: "sobj", size: 16 });
+    }
+    /**
+     * Generates a unique ID with custom prefix
+     */
+    static generateWithPrefix(prefix) {
+        return nehoid.NehoID.generate({ prefix, size: 16 });
+    }
+    /**
+     * Generates a unique ID with custom size
+     */
+    static generateWithSize(size) {
+        return nehoid.NehoID.generate({ prefix: "sobj", size });
+    }
+    /**
+     * Generates a unique ID with custom prefix and size
+     */
+    static generateCustom(prefix, size) {
+        return nehoid.NehoID.generate({ prefix, size });
+    }
+    /**
+     * Validates if a string looks like a valid SecureObject ID
+     */
+    static isValidId(id) {
+        // Basic validation - starts with sobj_ and has reasonable length
+        return typeof id === "string" &&
+            id.startsWith("sobj_") &&
+            id.length > 10 &&
+            id.length < 50;
+    }
+    /**
+     * Extracts the prefix from an ID
+     */
+    static extractPrefix(id) {
+        const underscoreIndex = id.indexOf("_");
+        return underscoreIndex > 0 ? id.substring(0, underscoreIndex) : null;
+    }
+    /**
+     * Extracts the unique part from an ID (without prefix)
+     */
+    static extractUniquePart(id) {
+        const underscoreIndex = id.indexOf("_");
+        return underscoreIndex > 0 ? id.substring(underscoreIndex + 1) : null;
+    }
+}
+
+exports.IdGenerator = IdGenerator;
+//# sourceMappingURL=id-generator.js.map

package/dist/cjs/mods/toolkit/src/components/secure-object/utils/id-generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"id-generator.js","sources":["../../../../../../../../mods/toolkit/src/components/secure-object/utils/id-generator.ts"],"sourcesContent":[null],"names":["NehoID"],"mappings":";;;;AAAA;;;AAGG;AAIH;;AAEG;MACU,WAAW,CAAA;AACpB;;AAEG;AACH,IAAA,OAAO,QAAQ,GAAA;AACX,QAAA,OAAOA,aAAM,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;KACxD;AAED;;AAEG;IACH,OAAO,kBAAkB,CAAC,MAAc,EAAA;AACpC,QAAA,OAAOA,aAAM,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;KAChD;AAED;;AAEG;IACH,OAAO,gBAAgB,CAAC,IAAY,EAAA;AAChC,QAAA,OAAOA,aAAM,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;KACpD;AAED;;AAEG;AACH,IAAA,OAAO,cAAc,CAAC,MAAc,EAAE,IAAY,EAAA;QAC9C,OAAOA,aAAM,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;KAC5C;AAED;;AAEG;IACH,OAAO,SAAS,CAAC,EAAU,EAAA;;QAEvB,OAAO,OAAO,EAAE,KAAK,QAAQ;AACtB,YAAA,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC;YACtB,EAAE,CAAC,MAAM,GAAG,EAAE;AACd,YAAA,EAAE,CAAC,MAAM,GAAG,EAAE,CAAC;KACzB;AAED;;AAEG;IACH,OAAO,aAAa,CAAC,EAAU,EAAA;QAC3B,MAAM,eAAe,GAAG,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;AACxC,QAAA,OAAO,eAAe,GAAG,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC,EAAE,eAAe,CAAC,GAAG,IAAI,CAAC;KACxE;AAED;;AAEG;IACH,OAAO,iBAAiB,CAAC,EAAU,EAAA;QAC/B,MAAM,eAAe,GAAG,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;AACxC,QAAA,OAAO,eAAe,GAAG,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,eAAe,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC;KACzE;AACJ;;;;"}

package/dist/cjs/mods/toolkit/src/components/secure-object/utils/validation.js

@@ -0,0 +1,239 @@
+'use strict';
+
+/**
+ * Validation Utilities
+ * Common validation functions for SecureObject
+ */
+/**
+ * Validation utilities for SecureObject
+ */
+class ValidationUtils {
+    /**
+     * Validates if a value is a valid SecureValue type
+     */
+    static isValidSecureValue(value) {
+        return (typeof value === "string" ||
+            typeof value === "number" ||
+            typeof value === "boolean" ||
+            value instanceof Uint8Array ||
+            value === null ||
+            value === undefined ||
+            this.isSecureString(value) ||
+            this.isSecureObject(value));
+    }
+    /**
+     * Checks if a value is a SecureString instance
+     */
+    static isSecureString(value) {
+        return (value &&
+            typeof value === "object" &&
+            value.constructor.name === "SecureString");
+    }
+    /**
+     * Checks if a value is a SecureObject instance
+     */
+    static isSecureObject(value) {
+        return (value &&
+            typeof value === "object" &&
+            value.constructor.name === "SecureObject");
+    }
+    /**
+     * Validates serialization options
+     */
+    static validateSerializationOptions(options) {
+        if (options.format && !["json", "binary"].includes(options.format)) {
+            throw new Error(`Invalid format option: ${options.format}. Must be 'json' or 'binary'.`);
+        }
+        if (options.includeMetadata !== undefined &&
+            typeof options.includeMetadata !== "boolean") {
+            throw new Error("includeMetadata option must be a boolean");
+        }
+        if (options.encryptSensitive !== undefined &&
+            typeof options.encryptSensitive !== "boolean") {
+            throw new Error("encryptSensitive option must be a boolean");
+        }
+    }
+    /**
+     * Validates a key for SecureObject operations
+     */
+    static validateKey(key) {
+        if (key === null || key === undefined) {
+            throw new Error("Key cannot be null or undefined");
+        }
+        if (typeof key !== "string" &&
+            typeof key !== "number" &&
+            typeof key !== "symbol") {
+            throw new Error("Key must be a string, number, or symbol");
+        }
+    }
+    /**
+     * Validates an array of keys
+     */
+    static validateKeys(keys) {
+        if (!Array.isArray(keys)) {
+            throw new Error("Keys must be an array");
+        }
+        keys.forEach((key, index) => {
+            try {
+                this.validateKey(key);
+            }
+            catch (error) {
+                throw new Error(`Invalid key at index ${index}: ${error.message}`);
+            }
+        });
+    }
+    /**
+     * Validates an encryption key
+     */
+    static validateEncryptionKey(key) {
+        if (key !== null && typeof key !== "string") {
+            throw new Error("Encryption key must be a string or null");
+        }
+        if (typeof key === "string" && key.length === 0) {
+            throw new Error("Encryption key cannot be an empty string");
+        }
+    }
+    /**
+     * Validates a timeout value
+     */
+    static validateTimeout(timeout) {
+        if (timeout !== undefined) {
+            if (typeof timeout !== "number" ||
+                timeout < 0 ||
+                !Number.isFinite(timeout)) {
+                throw new Error("Timeout must be a positive finite number");
+            }
+        }
+    }
+    /**
+     * Validates a limit value for pagination/filtering
+     */
+    static validateLimit(limit) {
+        if (typeof limit !== "number" ||
+            limit < 1 ||
+            !Number.isInteger(limit)) {
+            throw new Error("Limit must be a positive integer");
+        }
+    }
+    /**
+     * Validates a callback function
+     */
+    static validateCallback(callback, name = "callback") {
+        if (typeof callback !== "function") {
+            throw new Error(`${name} must be a function`);
+        }
+    }
+    /**
+     * Validates an event listener
+     */
+    static validateEventListener(listener) {
+        this.validateCallback(listener, "Event listener");
+    }
+    /**
+     * Validates an event type
+     */
+    static validateEventType(event) {
+        const validEvents = [
+            "set",
+            "get",
+            "delete",
+            "clear",
+            "destroy",
+            "filtered",
+        ];
+        if (!validEvents.includes(event)) {
+            throw new Error(`Invalid event type: ${event}. Must be one of: ${validEvents.join(", ")}`);
+        }
+    }
+    /**
+     * Validates a predicate function
+     */
+    static validatePredicate(predicate) {
+        this.validateCallback(predicate, "Predicate");
+    }
+    /**
+     * Validates a mapping function
+     */
+    static validateMapper(mapper) {
+        this.validateCallback(mapper, "Mapper function");
+    }
+    /**
+     * Sanitizes a key to ensure it's a string
+     */
+    static sanitizeKey(key) {
+        this.validateKey(key);
+        return String(key);
+    }
+    /**
+     * Checks if an object is empty (null, undefined, or has no properties)
+     */
+    static isEmpty(obj) {
+        if (obj === null || obj === undefined) {
+            return true;
+        }
+        if (typeof obj === "object") {
+            return Object.keys(obj).length === 0;
+        }
+        return false;
+    }
+    /**
+     * Deep clones a value (for non-secure values only)
+     */
+    static deepClone(value) {
+        if (value === null || typeof value !== "object") {
+            return value;
+        }
+        if (value instanceof Date) {
+            return new Date(value.getTime());
+        }
+        if (value instanceof Array) {
+            return value.map((item) => this.deepClone(item));
+        }
+        if (value instanceof Uint8Array) {
+            return new Uint8Array(value);
+        }
+        // For regular objects
+        const cloned = {};
+        for (const key in value) {
+            if (Object.prototype.hasOwnProperty.call(value, key)) {
+                cloned[key] = this.deepClone(value[key]);
+            }
+        }
+        return cloned;
+    }
+    /**
+     * Checks if a value is a primitive type
+     */
+    static isPrimitive(value) {
+        return (value === null ||
+            value === undefined ||
+            typeof value === "string" ||
+            typeof value === "number" ||
+            typeof value === "boolean" ||
+            typeof value === "symbol" ||
+            typeof value === "bigint");
+    }
+    /**
+     * Gets the type name of a value
+     */
+    static getTypeName(value) {
+        if (value === null)
+            return "null";
+        if (value === undefined)
+            return "undefined";
+        if (value instanceof Uint8Array)
+            return "Uint8Array";
+        if (Array.isArray(value))
+            return "Array";
+        if (value instanceof Date)
+            return "Date";
+        if (this.isSecureString(value))
+            return "SecureString";
+        if (this.isSecureObject(value))
+            return "SecureObject";
+        return typeof value;
+    }
+}
+
+exports.ValidationUtils = ValidationUtils;
+//# sourceMappingURL=validation.js.map

package/dist/cjs/mods/toolkit/src/components/secure-object/utils/validation.js.map

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