xypriss 1.0.0 → 1.1.0

package/dist/cjs/mods/toolkit/src/components/secure-string/buffer/buffer-manager.js

@@ -0,0 +1,205 @@
+'use strict';
+
+var secureMemory = require('../../secure-memory.js');
+var index = require('../types/index.js');
+
+/**
+ * Buffer Manager Module
+ * Handles secure buffer operations for SecureString
+ */
+/**
+ * Manages secure buffer operations for SecureString
+ */
+class BufferManager {
+    constructor(initialValue = "", options = {}) {
+        this._isDestroyed = false;
+        this.options = { ...index.DEFAULT_SECURE_STRING_OPTIONS, ...options };
+        this.buffer = this.createBuffer(initialValue);
+    }
+    /**
+     * Creates a new secure buffer with the specified value
+     */
+    createBuffer(value) {
+        return secureMemory.SecureBuffer.from(value, {
+            protectionLevel: this.options.protectionLevel,
+            enableEncryption: this.options.enableEncryption,
+            enableFragmentation: this.options.enableFragmentation,
+            enableCanaries: this.options.enableCanaries,
+            enableObfuscation: this.options.enableObfuscation,
+            autoLock: this.options.autoLock,
+            quantumSafe: this.options.quantumSafe,
+        });
+    }
+    /**
+     * Gets the current buffer (read-only access)
+     */
+    getBuffer() {
+        this.ensureNotDestroyed();
+        return this.buffer.getBuffer();
+    }
+    /**
+     * Gets the string value from the buffer
+     */
+    getString() {
+        this.ensureNotDestroyed();
+        const buffer = this.buffer.getBuffer();
+        return new TextDecoder(this.options.encoding).decode(buffer);
+    }
+    /**
+     * Updates the buffer with a new string value
+     */
+    updateBuffer(newValue) {
+        this.ensureNotDestroyed();
+        // Destroy the old buffer
+        this.buffer.destroy();
+        // Create a new buffer with the new value
+        this.buffer = this.createBuffer(newValue);
+    }
+    /**
+     * Gets the byte length of the buffer
+     */
+    getByteLength() {
+        this.ensureNotDestroyed();
+        return this.buffer.getBuffer().length;
+    }
+    /**
+     * Gets the character length of the string
+     */
+    getCharacterLength() {
+        this.ensureNotDestroyed();
+        return this.getString().length;
+    }
+    /**
+     * Checks if the buffer is empty
+     */
+    isEmpty() {
+        this.ensureNotDestroyed();
+        return this.getCharacterLength() === 0;
+    }
+    /**
+     * Creates a copy of the current buffer
+     */
+    clone() {
+        this.ensureNotDestroyed();
+        const currentValue = this.getString();
+        return new BufferManager(currentValue, this.options);
+    }
+    /**
+     * Converts the buffer to a Uint8Array (copy)
+     */
+    toUint8Array() {
+        this.ensureNotDestroyed();
+        const buffer = this.buffer.getBuffer();
+        return new Uint8Array(buffer);
+    }
+    /**
+     * Creates a buffer from a Uint8Array
+     */
+    static fromUint8Array(data, options = {}, encoding = "utf-8") {
+        const decoder = new TextDecoder(encoding);
+        const value = decoder.decode(data);
+        return new BufferManager(value, { ...options, encoding });
+    }
+    /**
+     * Gets memory usage information
+     */
+    getMemoryUsage() {
+        this.ensureNotDestroyed();
+        const bufferSize = this.getByteLength();
+        const actualLength = this.getCharacterLength();
+        return {
+            bufferSize,
+            actualLength,
+            overhead: bufferSize - actualLength,
+            isFragmented: this.options.enableFragmentation,
+            isEncrypted: this.options.enableEncryption,
+        };
+    }
+    /**
+     * Gets the current options
+     */
+    getOptions() {
+        return { ...this.options };
+    }
+    /**
+     * Updates the options (creates new buffer if needed)
+     */
+    updateOptions(newOptions) {
+        this.ensureNotDestroyed();
+        const oldOptions = this.options;
+        this.options = { ...this.options, ...newOptions };
+        // Check if we need to recreate the buffer
+        const needsRecreation = oldOptions.protectionLevel !== this.options.protectionLevel ||
+            oldOptions.enableEncryption !== this.options.enableEncryption ||
+            oldOptions.enableFragmentation !== this.options.enableFragmentation ||
+            oldOptions.enableCanaries !== this.options.enableCanaries ||
+            oldOptions.enableObfuscation !== this.options.enableObfuscation ||
+            oldOptions.autoLock !== this.options.autoLock ||
+            oldOptions.quantumSafe !== this.options.quantumSafe;
+        if (needsRecreation) {
+            const currentValue = this.getString();
+            this.buffer.destroy();
+            this.buffer = this.createBuffer(currentValue);
+        }
+    }
+    /**
+     * Ensures the buffer manager hasn't been destroyed
+     */
+    ensureNotDestroyed() {
+        if (this._isDestroyed) {
+            throw new Error("BufferManager has been destroyed and cannot be used");
+        }
+    }
+    /**
+     * Checks if the buffer manager is destroyed
+     */
+    isDestroyed() {
+        return this._isDestroyed;
+    }
+    /**
+     * Destroys the buffer and clears all data
+     */
+    destroy() {
+        if (!this._isDestroyed) {
+            this.buffer.destroy();
+            this._isDestroyed = true;
+        }
+    }
+    /**
+     * Securely wipes the buffer content
+     */
+    wipe() {
+        this.ensureNotDestroyed();
+        this.updateBuffer("");
+    }
+    /**
+     * Gets debug information about the buffer
+     */
+    getDebugInfo() {
+        if (this._isDestroyed) {
+            return {
+                isDestroyed: true,
+                options: this.options,
+                memoryUsage: {
+                    bufferSize: 0,
+                    actualLength: 0,
+                    overhead: 0,
+                    isFragmented: false,
+                    isEncrypted: false,
+                },
+                characterLength: 0,
+                byteLength: 0,
+            };
+        }
+        return {
+            isDestroyed: false,
+            options: this.options,
+            memoryUsage: this.getMemoryUsage(),
+            characterLength: this.getCharacterLength(),
+            byteLength: this.getByteLength(),
+        };
+    }
+}
+
+exports.BufferManager = BufferManager;
+//# sourceMappingURL=buffer-manager.js.map

package/dist/cjs/mods/toolkit/src/components/secure-string/buffer/buffer-manager.js.map

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