xypriss 1.1.0 → 1.1.3

package/dist/cjs/mods/toolkit/src/components/secure-memory.js

@@ -1,906 +0,0 @@
-'use strict';
-
-var crypto = require('crypto');
-var secureMemory = require('../types/secure-memory.js');
-var buffer_const = require('../const/buffer.const.js');
-var secureMem_type = require('../types/secure-mem.type.js');
-
-function _interopNamespaceDefault(e) {
-    var n = Object.create(null);
-    if (e) {
-        Object.keys(e).forEach(function (k) {
-            if (k !== 'default') {
-                var d = Object.getOwnPropertyDescriptor(e, k);
-                Object.defineProperty(n, k, d.get ? d : {
-                    enumerable: true,
-                    get: function () { return e[k]; }
-                });
-            }
-        });
-    }
-    n.default = e;
-    return Object.freeze(n);
-}
-
-var crypto__namespace = /*#__PURE__*/_interopNamespaceDefault(crypto);
-
-/**
- * This module provides military-grade utilities for securely handling sensitive data in memory:
- * - Secure buffers with advanced protection against memory dumps and swapping
- * - Multiple encryption layers for data at rest in memory
- * - Hardware-level security features when available
- * - Protection against cold boot attacks and memory forensics
- * - Canary tokens for tamper detection
- * - Memory fragmentation and obfuscation techniques
- * - Quantum-resistant security measures
- * - Side-channel attack resistance
- */
-/**
- * @author Seth Eleazar
- *
- * @license MIT
- * @description Enhanced Secure Memory Management Module
- * Enhanced secure buffer with military-grade protection
- * Features multiple layers of security including encryption, obfuscation, and tamper detection
- */
-class SecureBuffer {
-    /**
-     * Creates a new enhanced secure buffer with military-grade protection
-     *
-     * @param size - Size of the buffer in bytes
-     * @param fill - Optional value to fill the buffer with
-     * @param options - Security options
-     */
-    constructor(size, fill, options = {}) {
-        this.fragments = [];
-        this.encryptionKey = null;
-        this.nonce = null;
-        this.canaryTokens = [];
-        this.canaryPositions = []; // Track where canaries are embedded
-        this.obfuscationMask = null;
-        this.state = secureMemory.BufferState.UNINITIALIZED;
-        this.accessCount = 0;
-        this.lastAccess = Date.now();
-        this.lockTimer = null;
-        this.checksum = null;
-        this.originalSize = size;
-        this.options = {
-            protectionLevel: options.protectionLevel || secureMemory.MemoryProtectionLevel.ENHANCED,
-            enableEncryption: options.enableEncryption ?? true,
-            enableFragmentation: options.enableFragmentation ?? true,
-            enableCanaries: options.enableCanaries ?? true,
-            enableObfuscation: options.enableObfuscation ?? true,
-            autoLock: options.autoLock ?? true,
-            lockTimeout: options.lockTimeout || 300000, // 5 minutes
-            quantumSafe: options.quantumSafe || false,
-        };
-        this.protectionLevel = this.options.protectionLevel;
-        // Initialize synchronously without waiting for optional libraries
-        this.initializeSecureBuffer(size, fill);
-        this.registerFinalizer();
-        this.setupAutoLock();
-        // Initialize libraries asynchronously in background (non-blocking)
-        secureMem_type.ensureLibrariesInitialized().catch(() => {
-            // Ignore errors - libraries are optional
-        });
-    }
-    /**
-     * Initialize the secure buffer with enhanced protection
-     */
-    initializeSecureBuffer(size, fill) {
-        // Generate encryption key if encryption is enabled
-        if (this.options.enableEncryption) {
-            this.encryptionKey = this.generateSecureKey(buffer_const.BUFFER_SECURITY_CONSTANTS.ENCRYPTION_KEY_SIZE);
-            this.nonce = this.generateSecureKey(buffer_const.BUFFER_SECURITY_CONSTANTS.NONCE_SIZE);
-        }
-        // Create fragments if fragmentation is enabled
-        if (this.options.enableFragmentation &&
-            size > buffer_const.BUFFER_SECURITY_CONSTANTS.FRAGMENT_SIZE) {
-            this.createFragments(size, fill);
-        }
-        else {
-            // Single fragment for small buffers
-            this.fragments = [new Uint8Array(size)];
-            if (fill !== undefined) {
-                this.fragments[0].fill(fill);
-            }
-        }
-        // Generate canary tokens if enabled
-        if (this.options.enableCanaries) {
-            this.generateCanaryTokens();
-        }
-        // Create obfuscation mask if enabled
-        if (this.options.enableObfuscation) {
-            this.obfuscationMask = this.generateSecureKey(size);
-        }
-        // Calculate initial checksum
-        this.updateChecksum();
-        this.state = secureMemory.BufferState.ACTIVE;
-    }
-    /**
-     * Setup automatic locking mechanism
-     */
-    setupAutoLock() {
-        if (this.options.autoLock) {
-            this.resetLockTimer();
-        }
-    }
-    /**
-     * Reset the auto-lock timer
-     */
-    resetLockTimer() {
-        if (this.lockTimer) {
-            clearTimeout(this.lockTimer);
-        }
-        this.lockTimer = setTimeout(() => {
-            this.lock();
-        }, this.options.lockTimeout);
-    }
-    /**
-     * Generate a cryptographically secure key
-     */
-    generateSecureKey(size) {
-        // Try to use libsodium if available and properly initialized
-        if (secureMem_type.sodium && secureMem_type.libraryStatus.sodium) {
-            try {
-                return secureMem_type.sodium.randombytes_buf(size);
-            }
-            catch (error) {
-                console.warn("libsodium randombytes_buf failed:", error.message);
-            }
-        }
-        // Fallback to Node.js crypto
-        try {
-            return new Uint8Array(crypto__namespace.randomBytes(size));
-        }
-        catch (e) {
-            console.warn("crypto.randomBytes failed:", e.message);
-            // Ultimate fallback
-            const key = new Uint8Array(size);
-            for (let i = 0; i < size; i++) {
-                key[i] = Math.floor(Math.random() * 256);
-            }
-            return key;
-        }
-    }
-    /**
-     * Create memory fragments for enhanced security
-     */
-    createFragments(size, fill) {
-        const fragmentCount = Math.min(Math.ceil(size / buffer_const.BUFFER_SECURITY_CONSTANTS.FRAGMENT_SIZE), buffer_const.BUFFER_SECURITY_CONSTANTS.MAX_FRAGMENTS);
-        this.fragments = [];
-        let remaining = size;
-        for (let i = 0; i < fragmentCount; i++) {
-            const fragmentSize = Math.min(remaining, buffer_const.BUFFER_SECURITY_CONSTANTS.FRAGMENT_SIZE);
-            const fragment = new Uint8Array(fragmentSize);
-            if (fill !== undefined) {
-                fragment.fill(fill);
-            }
-            this.fragments.push(fragment);
-            remaining -= fragmentSize;
-            if (remaining <= 0)
-                break;
-        }
-    }
-    /**
-     * Generate canary tokens for tamper detection and embed them in memory
-     */
-    generateCanaryTokens() {
-        const canaryCount = Math.max(2, Math.min(8, Math.ceil(this.fragments.length / 4)));
-        this.canaryTokens = [];
-        this.canaryPositions = [];
-        for (let i = 0; i < canaryCount; i++) {
-            const canary = this.generateSecureKey(buffer_const.BUFFER_SECURITY_CONSTANTS.CANARY_SIZE);
-            this.canaryTokens.push(canary);
-            // Embed canary in memory around fragments
-            this.embedCanaryInMemory(canary, i);
-        }
-    }
-    /**
-     * Embed canary tokens in memory around buffer fragments
-     */
-    embedCanaryInMemory(canary, index) {
-        if (this.fragments.length === 0)
-            return;
-        // Calculate position to embed canary
-        // Distribute canaries evenly around fragments
-        const fragmentIndex = index % this.fragments.length;
-        const fragment = this.fragments[fragmentIndex];
-        // Create a new fragment with canary embedded
-        // Format: [canary_prefix][original_data][canary_suffix]
-        const canaryPrefix = canary.slice(0, Math.floor(canary.length / 2));
-        const canarySuffix = canary.slice(Math.floor(canary.length / 2));
-        const newFragment = new Uint8Array(canaryPrefix.length + fragment.length + canarySuffix.length);
-        // Embed canary around the data
-        newFragment.set(canaryPrefix, 0);
-        newFragment.set(fragment, canaryPrefix.length);
-        newFragment.set(canarySuffix, canaryPrefix.length + fragment.length);
-        // Replace the original fragment
-        this.fragments[fragmentIndex] = newFragment;
-        // Track the position for verification
-        this.canaryPositions.push(fragmentIndex);
-    }
-    /**
-     * Helper method to compare two Uint8Arrays for equality
-     */
-    arraysEqual(a, b) {
-        if (a.length !== b.length)
-            return false;
-        for (let i = 0; i < a.length; i++) {
-            if (a[i] !== b[i])
-                return false;
-        }
-        return true;
-    }
-    /**
-     * Get the unencrypted buffer by combining fragments (extracting data from canary-embedded fragments)
-     */
-    getUnencryptedBuffer() {
-        if (this.fragments.length === 0) {
-            return new Uint8Array(0);
-        }
-        const extractedFragments = [];
-        // Extract actual data from fragments, removing embedded canaries
-        for (let i = 0; i < this.fragments.length; i++) {
-            const fragment = this.fragments[i];
-            // Check if this fragment has embedded canaries
-            const canaryIndex = this.canaryPositions.indexOf(i);
-            if (canaryIndex >= 0 && canaryIndex < this.canaryTokens.length) {
-                // This fragment has embedded canaries, extract the original data
-                const canary = this.canaryTokens[canaryIndex];
-                const canaryPrefix = canary.slice(0, Math.floor(canary.length / 2));
-                const canarySuffix = canary.slice(Math.floor(canary.length / 2));
-                // Extract the original data between the canaries
-                const originalDataStart = canaryPrefix.length;
-                const originalDataEnd = fragment.length - canarySuffix.length;
-                const originalData = fragment.slice(originalDataStart, originalDataEnd);
-                extractedFragments.push(originalData);
-            }
-            else {
-                // No canaries in this fragment, use as-is
-                extractedFragments.push(fragment);
-            }
-        }
-        // Calculate total size of extracted data
-        const totalSize = extractedFragments.reduce((sum, fragment) => sum + fragment.length, 0);
-        const result = new Uint8Array(totalSize);
-        // Combine extracted fragments
-        let offset = 0;
-        for (const fragment of extractedFragments) {
-            result.set(fragment, offset);
-            offset += fragment.length;
-        }
-        return result;
-    }
-    /**
-     * Lock the buffer to prevent access
-     */
-    lock() {
-        if (this.state === secureMemory.BufferState.DESTROYED) {
-            throw new Error("Cannot lock destroyed buffer");
-        }
-        this.state = secureMemory.BufferState.LOCKED;
-        // Encrypt fragments if encryption is enabled
-        if (this.options.enableEncryption && this.encryptionKey && this.nonce) {
-            this.encryptFragments();
-        }
-    }
-    /**
-     * Unlock the buffer to allow access
-     */
-    unlock() {
-        if (this.state === secureMemory.BufferState.DESTROYED) {
-            throw new Error("Cannot unlock destroyed buffer");
-        }
-        // Decrypt fragments if they were encrypted
-        if (this.options.enableEncryption && this.encryptionKey && this.nonce) {
-            this.decryptFragments();
-        }
-        this.state = secureMemory.BufferState.ACTIVE;
-        this.resetLockTimer();
-    }
-    /**
-     * Check if buffer is locked
-     */
-    isLocked() {
-        return this.state === secureMemory.BufferState.LOCKED;
-    }
-    /**
-     * Check if buffer is destroyed
-     */
-    isDestroyed() {
-        return this.state === secureMemory.BufferState.DESTROYED;
-    }
-    /**
-     * Verify buffer integrity using canary tokens and checksum
-     */
-    verifyIntegrity() {
-        if (this.state === secureMemory.BufferState.DESTROYED) {
-            return false;
-        }
-        // Verify canary tokens
-        if (this.options.enableCanaries && this.canaryTokens.length > 0) {
-            // Verify embedded canaries in memory fragments
-            for (let i = 0; i < this.canaryTokens.length; i++) {
-                const canary = this.canaryTokens[i];
-                const fragmentIndex = this.canaryPositions[i];
-                if (fragmentIndex >= this.fragments.length) {
-                    this.state = secureMemory.BufferState.CORRUPTED;
-                    return false;
-                }
-                const fragment = this.fragments[fragmentIndex];
-                const canaryPrefix = canary.slice(0, Math.floor(canary.length / 2));
-                const canarySuffix = canary.slice(Math.floor(canary.length / 2));
-                // Verify prefix canary
-                const fragmentPrefix = fragment.slice(0, canaryPrefix.length);
-                if (!this.arraysEqual(fragmentPrefix, canaryPrefix)) {
-                    this.state = secureMemory.BufferState.CORRUPTED;
-                    return false;
-                }
-                // Verify suffix canary
-                const fragmentSuffix = fragment.slice(fragment.length - canarySuffix.length);
-                if (!this.arraysEqual(fragmentSuffix, canarySuffix)) {
-                    this.state = secureMemory.BufferState.CORRUPTED;
-                    return false;
-                }
-            }
-        }
-        // Verify checksum
-        if (this.checksum) {
-            const currentData = this.getUnencryptedBuffer();
-            const currentChecksum = new Uint8Array(32);
-            try {
-                if (secureMem_type.nobleHashes && secureMem_type.nobleHashes.sha256) {
-                    const hash = new Uint8Array(secureMem_type.nobleHashes.sha256(currentData));
-                    currentChecksum.set(hash);
-                }
-                else {
-                    const hash = crypto__namespace.createHash("sha256");
-                    hash.update(currentData);
-                    currentChecksum.set(new Uint8Array(hash.digest()));
-                }
-            }
-            catch (e) {
-                // Simple checksum fallback
-                for (let i = 0; i < currentData.length; i++) {
-                    currentChecksum[i % 32] ^= currentData[i];
-                }
-            }
-            // Constant-time comparison
-            let diff = 0;
-            for (let i = 0; i < Math.min(this.checksum.length, currentChecksum.length); i++) {
-                diff |= this.checksum[i] ^ currentChecksum[i];
-            }
-            if (diff !== 0) {
-                this.state = secureMemory.BufferState.CORRUPTED;
-                return false;
-            }
-        }
-        return true;
-    }
-    /**
-     * Encrypt fragments using ChaCha20-Poly1305 or AES-GCM
-     */
-    encryptFragments() {
-        if (!this.encryptionKey || !this.nonce) {
-            return;
-        }
-        try {
-            // Try to use libsodium for ChaCha20-Poly1305
-            if (secureMem_type.sodium && secureMem_type.libraryStatus.sodium && this.options.quantumSafe) {
-                try {
-                    for (let i = 0; i < this.fragments.length; i++) {
-                        const encrypted = secureMem_type.sodium.crypto_aead_chacha20poly1305_ietf_encrypt(this.fragments[i], null, null, this.nonce, this.encryptionKey);
-                        this.fragments[i] = new Uint8Array(encrypted);
-                    }
-                    return;
-                }
-                catch (sodiumError) {
-                    console.warn("libsodium encryption failed:", sodiumError.message);
-                }
-            }
-            // Fallback to AES-GCM with proper IV
-            for (let i = 0; i < this.fragments.length; i++) {
-                try {
-                    // Use createCipheriv instead of deprecated createCipher
-                    const iv = crypto__namespace.randomBytes(12); // 96-bit IV for GCM
-                    const cipher = crypto__namespace.createCipheriv("aes-256-gcm", this.encryptionKey, iv);
-                    const encrypted = Buffer.concat([
-                        iv, // Prepend IV
-                        cipher.update(this.fragments[i]),
-                        cipher.final(),
-                        cipher.getAuthTag(), // Append auth tag
-                    ]);
-                    this.fragments[i] = new Uint8Array(encrypted);
-                }
-                catch (cipherError) {
-                    console.warn(`Fragment ${i} encryption failed:`, cipherError.message);
-                }
-            }
-        }
-        catch (e) {
-            console.warn("Fragment encryption failed:", e.message);
-        }
-    }
-    /**
-     * Decrypt fragments
-     */
-    decryptFragments() {
-        if (!this.encryptionKey || !this.nonce) {
-            return;
-        }
-        try {
-            // Try to use libsodium for ChaCha20-Poly1305
-            if (secureMem_type.sodium && secureMem_type.libraryStatus.sodium && this.options.quantumSafe) {
-                try {
-                    for (let i = 0; i < this.fragments.length; i++) {
-                        const decrypted = secureMem_type.sodium.crypto_aead_chacha20poly1305_ietf_decrypt(null, this.fragments[i], null, this.nonce, this.encryptionKey);
-                        this.fragments[i] = new Uint8Array(decrypted);
-                    }
-                    return;
-                }
-                catch (sodiumError) {
-                    console.warn("libsodium decryption failed:", sodiumError.message);
-                }
-            }
-            // Fallback to AES-GCM with proper IV extraction
-            for (let i = 0; i < this.fragments.length; i++) {
-                try {
-                    const fragment = this.fragments[i];
-                    if (fragment.length < 12 + 16) {
-                        // IV + auth tag minimum
-                        console.warn(`Fragment ${i} too small for decryption`);
-                        continue;
-                    }
-                    // Extract IV, ciphertext, and auth tag
-                    const iv = fragment.slice(0, 12);
-                    const authTagStart = fragment.length - 16;
-                    const ciphertext = fragment.slice(12, authTagStart);
-                    const authTag = fragment.slice(authTagStart);
-                    // Use createDecipheriv instead of deprecated createDecipher
-                    const decipher = crypto__namespace.createDecipheriv("aes-256-gcm", this.encryptionKey, iv);
-                    decipher.setAuthTag(authTag);
-                    const decrypted = Buffer.concat([
-                        decipher.update(ciphertext),
-                        decipher.final(),
-                    ]);
-                    this.fragments[i] = new Uint8Array(decrypted);
-                }
-                catch (cipherError) {
-                    console.warn(`Fragment ${i} decryption failed:`, cipherError.message);
-                }
-            }
-        }
-        catch (e) {
-            console.warn("Fragment decryption failed:", e.message);
-        }
-    }
-    /**
-     * Sets data directly in fragments (private method for initialization)
-     *
-     * @param data - Data to set in the fragments
-     */
-    setDataInFragments(data) {
-        if (this.fragments.length === 1) {
-            // Single fragment - copy data directly
-            this.fragments[0].set(data);
-        }
-        else {
-            // Multiple fragments - distribute data across fragments
-            let offset = 0;
-            for (let i = 0; i < this.fragments.length && offset < data.length; i++) {
-                const fragment = this.fragments[i];
-                const copyLength = Math.min(fragment.length, data.length - offset);
-                fragment.set(data.subarray(offset, offset + copyLength));
-                offset += copyLength;
-            }
-        }
-    }
-    /**
-     * Creates a secure buffer from existing data
-     *
-     * @param data - Data to store in the secure buffer
-     * @param options - Security options
-     * @returns A new secure buffer containing the data
-     */
-    static from(data, options = {}) {
-        let buffer;
-        if (typeof data === "string") {
-            buffer = new TextEncoder().encode(data);
-        }
-        else if (Array.isArray(data)) {
-            buffer = new Uint8Array(data);
-        }
-        else {
-            buffer = new Uint8Array(data.buffer, data.byteOffset, data.byteLength);
-        }
-        const secureBuffer = new SecureBuffer(buffer.length, undefined, options);
-        // Set data directly in fragments instead of using getBuffer()
-        secureBuffer.setDataInFragments(buffer);
-        secureBuffer.updateChecksum();
-        return secureBuffer;
-    }
-    /**
-     * Gets the underlying buffer (decrypted if necessary)
-     * Throws if the buffer has been destroyed or locked
-     *
-     * @returns The underlying buffer
-     */
-    getBuffer() {
-        if (this.isDestroyed()) {
-            throw new Error("Buffer has been destroyed");
-        }
-        if (this.isLocked()) {
-            throw new Error("Buffer is locked - call unlock() first");
-        }
-        this.accessCount++;
-        this.lastAccess = Date.now();
-        this.resetLockTimer();
-        // Verify integrity before access
-        if (!this.verifyIntegrity()) {
-            throw new Error("Buffer integrity check failed - possible tampering detected");
-        }
-        return this.getUnencryptedBuffer();
-    }
-    /**
-     * Gets the length of the buffer
-     *
-     * @returns The length of the buffer in bytes
-     */
-    length() {
-        return this.originalSize;
-    }
-    /**
-     * Copies data to another buffer
-     *
-     * @param target - Target buffer
-     * @param targetStart - Start position in the target buffer
-     * @param sourceStart - Start position in this buffer
-     * @param sourceEnd - End position in this buffer
-     * @returns Number of bytes copied
-     */
-    copy(target, targetStart = 0, sourceStart = 0, sourceEnd = this.originalSize) {
-        if (this.isDestroyed()) {
-            throw new Error("Buffer has been destroyed");
-        }
-        if (this.isLocked()) {
-            throw new Error("Buffer is locked - call unlock() first");
-        }
-        const sourceBuffer = this.getBuffer();
-        const sourceLength = Math.min(sourceEnd - sourceStart, sourceBuffer.length - sourceStart);
-        const targetLength = Math.min(sourceLength, target.length - targetStart);
-        for (let i = 0; i < targetLength; i++) {
-            target[targetStart + i] = sourceBuffer[sourceStart + i];
-        }
-        return targetLength;
-    }
-    /**
-     * Fills the buffer with the specified value
-     *
-     * @param value - Value to fill the buffer with
-     * @param start - Start position
-     * @param end - End position
-     * @returns This buffer
-     */
-    fill(value, start = 0, end = this.originalSize) {
-        if (this.isDestroyed()) {
-            throw new Error("Buffer has been destroyed");
-        }
-        if (this.isLocked()) {
-            throw new Error("Buffer is locked - call unlock() first");
-        }
-        // Fill fragments directly
-        let currentPos = 0;
-        for (const fragment of this.fragments) {
-            const fragmentStart = Math.max(0, start - currentPos);
-            const fragmentEnd = Math.min(fragment.length, end - currentPos);
-            if (fragmentStart < fragmentEnd) {
-                for (let i = fragmentStart; i < fragmentEnd; i++) {
-                    fragment[i] = value;
-                }
-            }
-            currentPos += fragment.length;
-            if (currentPos >= end)
-                break;
-        }
-        this.updateChecksum();
-        return this;
-    }
-    /**
-     * Compares this buffer with another buffer using constant-time comparison
-     *
-     * @param otherBuffer - Buffer to compare with
-     * @returns True if the buffers are equal, false otherwise
-     */
-    equals(otherBuffer) {
-        if (this.isDestroyed()) {
-            throw new Error("Buffer has been destroyed");
-        }
-        if (this.isLocked()) {
-            throw new Error("Buffer is locked - call unlock() first");
-        }
-        const thisBuffer = this.getBuffer();
-        const other = typeof otherBuffer === "object" &&
-            otherBuffer &&
-            otherBuffer.constructor &&
-            otherBuffer.constructor.name === "SecureBuffer"
-            ? otherBuffer.getBuffer()
-            : otherBuffer;
-        if (thisBuffer.length !== other.length) {
-            return false;
-        }
-        // Constant-time comparison to prevent timing attacks
-        let diff = 0;
-        // Ensure other is a Uint8Array
-        const otherArray = other;
-        for (let i = 0; i < thisBuffer.length; i++) {
-            diff |= thisBuffer[i] ^ otherArray[i];
-        }
-        return diff === 0;
-    }
-    /**
-     * Destroys the buffer by securely wiping its contents
-     * After calling this method, the buffer can no longer be used
-     */
-    destroy() {
-        if (this.state === secureMemory.BufferState.DESTROYED) {
-            return; // Already destroyed
-        }
-        // Clear auto-lock timer
-        if (this.lockTimer) {
-            clearTimeout(this.lockTimer);
-            this.lockTimer = null;
-        }
-        // Securely wipe all fragments
-        for (const fragment of this.fragments) {
-            secureWipe(fragment, 0, fragment.length, 3);
-        }
-        // Wipe encryption keys
-        if (this.encryptionKey) {
-            secureWipe(this.encryptionKey, 0, this.encryptionKey.length, 3);
-            this.encryptionKey = null;
-        }
-        if (this.nonce) {
-            secureWipe(this.nonce, 0, this.nonce.length, 3);
-            this.nonce = null;
-        }
-        // Wipe canary tokens
-        for (const canary of this.canaryTokens) {
-            secureWipe(canary, 0, canary.length, 3);
-        }
-        this.canaryTokens = [];
-        // Wipe obfuscation mask
-        if (this.obfuscationMask) {
-            secureWipe(this.obfuscationMask, 0, this.obfuscationMask.length, 3);
-            this.obfuscationMask = null;
-        }
-        // Wipe checksum
-        if (this.checksum) {
-            secureWipe(this.checksum, 0, this.checksum.length, 3);
-            this.checksum = null;
-        }
-        // Clear fragments array
-        this.fragments = [];
-        this.state = secureMemory.BufferState.DESTROYED;
-    }
-    /**
-     * Get security statistics and information
-     */
-    getSecurityInfo() {
-        return {
-            protectionLevel: this.protectionLevel,
-            isEncrypted: this.options.enableEncryption && !!this.encryptionKey,
-            isFragmented: this.options.enableFragmentation && this.fragments.length > 1,
-            hasCanaries: this.options.enableCanaries && this.canaryTokens.length > 0,
-            isObfuscated: this.options.enableObfuscation && !!this.obfuscationMask,
-            accessCount: this.accessCount,
-            lastAccess: this.lastAccess,
-            fragmentCount: this.fragments.length,
-            state: this.state,
-        };
-    }
-    /**
-     * Clone the secure buffer with the same protection settings
-     */
-    clone() {
-        if (this.isDestroyed()) {
-            throw new Error("Cannot clone destroyed buffer");
-        }
-        const data = this.getBuffer();
-        return SecureBuffer.from(data, this.options);
-    }
-    /**
-     * Resize the buffer (creates a new buffer with copied data)
-     */
-    resize(newSize) {
-        if (this.isDestroyed()) {
-            throw new Error("Cannot resize destroyed buffer");
-        }
-        if (newSize < 0) {
-            throw new Error("Buffer size cannot be negative");
-        }
-        const currentData = this.getBuffer();
-        const newBuffer = new SecureBuffer(newSize, 0, this.options);
-        if (newSize > 0) {
-            const copyLength = Math.min(currentData.length, newSize);
-            const targetBuffer = newBuffer.getBuffer();
-            for (let i = 0; i < copyLength; i++) {
-                targetBuffer[i] = currentData[i];
-            }
-            newBuffer.updateChecksum();
-        }
-        return newBuffer;
-    }
-    /**
-     * Update the checksum after buffer modification
-     */
-    updateChecksum() {
-        if (this.state === secureMemory.BufferState.DESTROYED) {
-            return;
-        }
-        const data = this.getUnencryptedBuffer();
-        // Use SHA-256 for checksum
-        try {
-            if (secureMem_type.nobleHashes && secureMem_type.nobleHashes.sha256) {
-                this.checksum = new Uint8Array(secureMem_type.nobleHashes.sha256(data));
-            }
-            else {
-                const hash = crypto__namespace.createHash("sha256");
-                hash.update(data);
-                this.checksum = new Uint8Array(hash.digest());
-            }
-        }
-        catch (e) {
-            // Simple checksum fallback
-            this.checksum = new Uint8Array(32);
-            for (let i = 0; i < data.length; i++) {
-                this.checksum[i % 32] ^= data[i];
-            }
-        }
-    }
-    /**
-     * Registers a finalizer to clean up the buffer when it's garbage collected
-     * This is a best-effort approach as JavaScript doesn't guarantee finalization
-     */
-    registerFinalizer() {
-        // Use FinalizationRegistry if available (modern environments)
-        if (typeof globalThis.FinalizationRegistry !== "undefined") {
-            try {
-                const FinalizationRegistry = globalThis
-                    .FinalizationRegistry;
-                const registry = new FinalizationRegistry((heldValue) => {
-                    // Clean up fragments if they still exist
-                    if (heldValue.fragments) {
-                        for (const fragment of heldValue.fragments) {
-                            if (fragment && fragment.length > 0) {
-                                for (let i = 0; i < fragment.length; i++) {
-                                    fragment[i] = 0;
-                                }
-                            }
-                        }
-                    }
-                });
-                registry.register(this, { fragments: this.fragments });
-                return;
-            }
-            catch (e) {
-                // Fall back to timeout approach
-            }
-        }
-        // Fallback timeout-based approach for older environments
-        const fragmentRefs = this.fragments.slice(); // Create a copy of references
-        setTimeout(() => {
-            // This will only run if the original object is garbage collected
-            // but the timeout reference is still alive
-            for (const fragment of fragmentRefs) {
-                if (fragment && fragment.length > 0) {
-                    for (let i = 0; i < fragment.length; i++) {
-                        fragment[i] = 0;
-                    }
-                }
-            }
-        }, 30000); // Check after 30 seconds
-    }
-}
-/**
- * Securely wipes a section of memory
- *
- * This implementation follows recommendations from security standards
- * for secure data deletion, using multiple overwrite patterns to ensure
- * data cannot be recovered even with advanced forensic techniques.
- *
- * @param buffer - Buffer to wipe
- * @param start - Start position
- * @param end - End position
- * @param passes - Number of overwrite passes (default: 3)
- */
-function secureWipe(buffer, start = 0, end = buffer.length, passes = 3) {
-    if (!buffer || buffer.length === 0) {
-        return;
-    }
-    // Ensure bounds are valid
-    start = Math.max(0, Math.min(start, buffer.length));
-    end = Math.max(start, Math.min(end, buffer.length));
-    // Ensure passes is at least 1
-    passes = Math.max(1, passes);
-    // Get a cryptographically secure random source if available
-    let getRandomByte;
-    try {
-        // Try to use crypto.getRandomValues in browser
-        if (typeof window !== "undefined" &&
-            window.crypto &&
-            window.crypto.getRandomValues) {
-            const randomBuffer = new Uint8Array(1);
-            getRandomByte = () => {
-                window.crypto.getRandomValues(randomBuffer);
-                return randomBuffer[0];
-            };
-        }
-        // Try to use Node.js crypto module
-        else if (typeof require === "function") {
-            try {
-                // const crypto = require("crypto");
-                getRandomByte = () => crypto__namespace.randomBytes(1)[0];
-            }
-            catch (e) {
-                // Fallback to Math.random if crypto is not available
-                getRandomByte = () => Math.floor(Math.random() * 256);
-            }
-        }
-        // Fallback to Math.random
-        else {
-            getRandomByte = () => Math.floor(Math.random() * 256);
-        }
-    }
-    catch (e) {
-        // Final fallback
-        getRandomByte = () => Math.floor(Math.random() * 256);
-    }
-    // DoD 5220.22-M inspired wiping patterns
-    const patterns = [
-        0x00, // All zeros
-        0xff, // All ones
-        0x55, // Alternating 01010101
-        0xaa, // Alternating 10101010
-        0x92, // Pseudo-random
-        0x49, // Pseudo-random
-        0x24, // Pseudo-random
-        0x6d, // Pseudo-random
-        0xb6, // Pseudo-random
-        0xdb, // Pseudo-random
-    ];
-    // Perform the wipes
-    for (let pass = 0; pass < passes; pass++) {
-        // Use a different pattern for each pass, cycling through the available patterns
-        const patternIndex = pass % patterns.length;
-        const pattern = patterns[patternIndex];
-        // Fill the buffer with the pattern
-        for (let i = start; i < end; i++) {
-            // Use volatile to prevent compiler optimizations from removing this code
-            // This is a JavaScript approximation of the volatile keyword in C/C++
-            buffer[i] = pattern;
-            // Add a small delay every 1024 bytes to prevent optimization
-            if (i % 1024 === 0) {
-                // Force the JavaScript engine to actually perform the write
-                // by reading the value back and using it
-                const dummy = buffer[i];
-                if (dummy === undefined) {
-                    // This condition will never be true, but the compiler doesn't know that
-                    buffer[i] = getRandomByte();
-                }
-            }
-        }
-    }
-    // Final pass with cryptographically secure random data
-    for (let i = start; i < end; i++) {
-        buffer[i] = getRandomByte();
-    }
-    // Final zero pass
-    for (let i = start; i < end; i++) {
-        buffer[i] = 0x00;
-    }
-}
-
-exports.SecureBuffer = SecureBuffer;
-exports.secureWipe = secureWipe;
-//# sourceMappingURL=secure-memory.js.map