@digitaldefiance/ecies-lib 4.4.13 → 4.4.15

package/src/services/pbkdf2.js

@@ -0,0 +1,112 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Pbkdf2Service = void 0;
+const constants_1 = require("../constants");
+const pbkdf2_error_type_1 = require("../enumerations/pbkdf2-error-type");
+const pbkdf2_1 = require("../errors/pbkdf2");
+/**
+ * Service for handling PBKDF2 (Password-Based Key Derivation Function 2) operations.
+ * This service provides functionality for:
+ * - Generating secure key derivation configurations
+ * - Deriving cryptographic keys from passwords
+ * - Managing salt and iteration parameters
+ * - Both synchronous and asynchronous key derivation
+ */
+class Pbkdf2Service {
+    profiles;
+    eciesConsts;
+    pbkdf2Consts;
+    constructor(profiles = constants_1.Constants.PBKDF2_PROFILES, eciesParams = constants_1.Constants.ECIES, pbkdf2Params = constants_1.Constants.PBKDF2) {
+        this.profiles = profiles;
+        this.eciesConsts = eciesParams;
+        this.pbkdf2Consts = pbkdf2Params;
+    }
+    /**
+     * Get a predefined configuration profile for common use cases
+     * @param profile The name of the profile to use
+     * @returns Configuration object for the specified profile
+     */
+    getProfileConfig(profile) {
+        const profileConfig = this.profiles[profile];
+        if (!profileConfig) {
+            throw new pbkdf2_1.Pbkdf2Error(pbkdf2_error_type_1.Pbkdf2ErrorType.InvalidProfile);
+        }
+        return {
+            hashBytes: profileConfig.hashBytes,
+            saltBytes: profileConfig.saltBytes,
+            iterations: profileConfig.iterations,
+            algorithm: profileConfig.algorithm,
+        };
+    }
+    /**
+     * Generate an options object for pbkdf2
+     * @param iterations Optional number of iterations (defaults to Pbkdf2IterationsPerSecond)
+     * @param saltBytes Optional salt size in bytes (defaults to PBKDF2.SALT_BYTES)
+     * @param hashBytes Optional hash size in bytes (defaults to ECIES.SYMMETRIC.KEY_SIZE)
+     * @param algorithm Optional hash algorithm (defaults to PBKDF2.ALGORITHM)
+     * @returns Configuration object for PBKDF2
+     */
+    getConfig(iterations, saltBytes, hashBytes, algorithm) {
+        // larger numbers mean better security, less
+        return {
+            // size of the generated hash
+            hashBytes: hashBytes ?? this.eciesConsts.SYMMETRIC.KEY_SIZE,
+            // larger salt means hashed passwords are more resistant to rainbow table, but
+            // you get diminishing returns pretty fast
+            saltBytes: saltBytes ?? this.pbkdf2Consts.SALT_BYTES,
+            // more iterations means an attacker has to take longer to brute force an
+            // individual password, so larger is better. however, larger also means longer
+            // to hash the password. tune so that hashing the password takes about a
+            // second
+            iterations: iterations ?? this.pbkdf2Consts.ITERATIONS_PER_SECOND,
+            // hash algorithm
+            algorithm: algorithm ?? this.pbkdf2Consts.ALGORITHM,
+        };
+    }
+    /**
+     * Given a password, use pbkdf2 to generate an appropriately sized key for AES encryption
+     * @param password The password to derive a key from
+     * @param salt Optional salt (will be randomly generated if not provided)
+     * @param iterations Optional number of iterations
+     * @param saltBytes Optional salt size in bytes
+     * @param keySize Optional key size in bytes
+     * @param algorithm Optional hash algorithm
+     * @returns Object containing the derived key, salt, and iteration count
+     */
+    async deriveKeyFromPasswordAsync(password, salt, iterations, saltBytes, keySize, algorithm) {
+        const config = this.getConfig(iterations, saltBytes, keySize, algorithm);
+        const saltBytes_ = salt ?? crypto.getRandomValues(new Uint8Array(config.saltBytes));
+        if (saltBytes_.length !== config.saltBytes) {
+            throw new pbkdf2_1.Pbkdf2Error(pbkdf2_error_type_1.Pbkdf2ErrorType.InvalidSaltLength);
+        }
+        const keyMaterial = await crypto.subtle.importKey('raw', new Uint8Array(password), 'PBKDF2', false, ['deriveBits']);
+        const keyArray = await crypto.subtle.deriveBits({
+            name: 'PBKDF2',
+            salt: new Uint8Array(saltBytes_),
+            iterations: config.iterations,
+            hash: config.algorithm,
+        }, keyMaterial, config.hashBytes * 8);
+        const keyBytes = new Uint8Array(keyArray);
+        if (keyBytes.length !== config.hashBytes) {
+            throw new pbkdf2_1.Pbkdf2Error(pbkdf2_error_type_1.Pbkdf2ErrorType.InvalidHashLength);
+        }
+        return {
+            salt: saltBytes_,
+            hash: keyBytes,
+            iterations: config.iterations,
+        };
+    }
+    /**
+     * Derive a key using a predefined configuration profile
+     * @param password The password to derive a key from
+     * @param profile The configuration profile to use
+     * @param salt Optional salt (will be randomly generated if not provided)
+     * @returns Object containing the derived key, salt, and iteration count
+     */
+    async deriveKeyFromPasswordWithProfileAsync(password, profile, salt) {
+        const config = this.getProfileConfig(profile);
+        return await this.deriveKeyFromPasswordAsync(password, salt, config.iterations, config.saltBytes, config.hashBytes, config.algorithm);
+    }
+}
+exports.Pbkdf2Service = Pbkdf2Service;
+//# sourceMappingURL=pbkdf2.js.map

package/src/services/pbkdf2.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pbkdf2.js","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-ecies-lib/src/services/pbkdf2.ts"],"names":[],"mappings":"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"}

package/src/services/progress-tracker.d.ts

@@ -0,0 +1,23 @@
+import { IStreamProgress } from '../interfaces/stream-progress';
+/**
+ * Tracks progress for streaming operations
+ */
+export declare class ProgressTracker {
+    private readonly totalBytes?;
+    private startTime;
+    private lastUpdateTime;
+    private bytesProcessed;
+    private chunksProcessed;
+    private recentThroughputs;
+    private readonly maxThroughputSamples;
+    constructor(totalBytes?: number | undefined);
+    /**
+     * Update progress with new chunk
+     */
+    update(chunkBytes: number): IStreamProgress;
+    /**
+     * Get current progress without update
+     */
+    getProgress(): IStreamProgress;
+}
+//# sourceMappingURL=progress-tracker.d.ts.map

package/src/services/progress-tracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"progress-tracker.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-ecies-lib/src/services/progress-tracker.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAEhE;;GAEG;AACH,qBAAa,eAAe;IAQd,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC;IAPxC,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,cAAc,CAAa;IACnC,OAAO,CAAC,eAAe,CAAa;IACpC,OAAO,CAAC,iBAAiB,CAAgB;IACzC,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAK;gBAEb,UAAU,CAAC,EAAE,MAAM,YAAA;IAKhD;;OAEG;IACH,MAAM,CAAC,UAAU,EAAE,MAAM,GAAG,eAAe;IAsE3C;;OAEG;IACH,WAAW,IAAI,eAAe;CA+B/B"}

package/src/services/progress-tracker.js

@@ -0,0 +1,107 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ProgressTracker = void 0;
+const ecies_string_key_1 = require("../enumerations/ecies-string-key");
+const i18n_setup_1 = require("../i18n-setup");
+/**
+ * Tracks progress for streaming operations
+ */
+class ProgressTracker {
+    totalBytes;
+    startTime;
+    lastUpdateTime;
+    bytesProcessed = 0;
+    chunksProcessed = 0;
+    recentThroughputs = [];
+    maxThroughputSamples = 5;
+    constructor(totalBytes) {
+        this.totalBytes = totalBytes;
+        this.startTime = Date.now();
+        this.lastUpdateTime = this.startTime;
+    }
+    /**
+     * Update progress with new chunk
+     */
+    update(chunkBytes) {
+        // Validate input
+        if (chunkBytes < 0) {
+            const engine = (0, i18n_setup_1.getEciesI18nEngine)();
+            throw new Error(engine.translate(i18n_setup_1.EciesComponentId, ecies_string_key_1.EciesStringKey.Error_Progress_ChunkBytesCannotBeNegative));
+        }
+        this.bytesProcessed += chunkBytes;
+        this.chunksProcessed++;
+        const now = Date.now();
+        const elapsedTime = Math.max(0, now - this.startTime);
+        const timeSinceLastUpdate = Math.max(0, now - this.lastUpdateTime);
+        // Calculate instantaneous throughput (use elapsed time if same millisecond)
+        const timeWindow = timeSinceLastUpdate > 0 ? timeSinceLastUpdate : Math.max(1, elapsedTime);
+        if (chunkBytes > 0 && timeWindow > 0) {
+            const instantThroughput = (chunkBytes / timeWindow) * 1000;
+            // Guard against unrealistic throughput (>10GB/s)
+            if (isFinite(instantThroughput) &&
+                instantThroughput < 10 * 1024 * 1024 * 1024) {
+                this.recentThroughputs.push(instantThroughput);
+                if (this.recentThroughputs.length > this.maxThroughputSamples) {
+                    this.recentThroughputs.shift();
+                }
+            }
+        }
+        this.lastUpdateTime = now;
+        // Calculate average throughput
+        const throughput = this.recentThroughputs.length > 0
+            ? this.recentThroughputs.reduce((a, b) => a + b, 0) /
+                this.recentThroughputs.length
+            : 0;
+        // Calculate ETA (guard against negative)
+        let estimatedTimeRemaining;
+        if (this.totalBytes &&
+            throughput > 0 &&
+            this.bytesProcessed < this.totalBytes) {
+            const remainingBytes = this.totalBytes - this.bytesProcessed;
+            estimatedTimeRemaining = Math.max(0, remainingBytes / throughput);
+        }
+        return {
+            bytesProcessed: this.bytesProcessed,
+            totalBytes: this.totalBytes,
+            chunksProcessed: this.chunksProcessed,
+            percentComplete: this.totalBytes
+                ? Math.min(100, (this.bytesProcessed / this.totalBytes) * 100)
+                : undefined,
+            throughputBytesPerSec: throughput,
+            estimatedTimeRemaining,
+            startTime: this.startTime,
+            elapsedTime,
+        };
+    }
+    /**
+     * Get current progress without update
+     */
+    getProgress() {
+        const elapsedTime = Math.max(0, Date.now() - this.startTime);
+        const throughput = this.recentThroughputs.length > 0
+            ? this.recentThroughputs.reduce((a, b) => a + b, 0) /
+                this.recentThroughputs.length
+            : 0;
+        let estimatedTimeRemaining;
+        if (this.totalBytes &&
+            throughput > 0 &&
+            this.bytesProcessed < this.totalBytes) {
+            const remainingBytes = this.totalBytes - this.bytesProcessed;
+            estimatedTimeRemaining = Math.max(0, remainingBytes / throughput);
+        }
+        return {
+            bytesProcessed: this.bytesProcessed,
+            totalBytes: this.totalBytes,
+            chunksProcessed: this.chunksProcessed,
+            percentComplete: this.totalBytes
+                ? Math.min(100, (this.bytesProcessed / this.totalBytes) * 100)
+                : undefined,
+            throughputBytesPerSec: throughput,
+            estimatedTimeRemaining,
+            startTime: this.startTime,
+            elapsedTime,
+        };
+    }
+}
+exports.ProgressTracker = ProgressTracker;
+//# sourceMappingURL=progress-tracker.js.map

package/src/services/progress-tracker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"progress-tracker.js","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-ecies-lib/src/services/progress-tracker.ts"],"names":[],"mappings":"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"}

package/src/services/resumable-encryption.d.ts

@@ -0,0 +1,19 @@
+import { IEncryptionState } from '../interfaces/encryption-state';
+import { IEncryptedChunk } from '../interfaces/encrypted-chunk';
+import { EncryptionStream } from './encryption-stream';
+import { IEncryptStreamOptions } from './encryption-stream';
+export interface IResumableOptions extends IEncryptStreamOptions {
+    autoSaveInterval?: number;
+    onStateSaved?: (state: IEncryptionState) => void | Promise<void>;
+}
+export declare class ResumableEncryption {
+    private readonly stream;
+    private state;
+    constructor(stream: EncryptionStream, initialState?: IEncryptionState);
+    encrypt(source: AsyncIterable<Uint8Array>, publicKey: Uint8Array, options?: IResumableOptions): AsyncGenerator<IEncryptedChunk, void, unknown>;
+    saveState(): IEncryptionState;
+    private calculateStateHMAC;
+    static resume(stream: EncryptionStream, state: IEncryptionState): ResumableEncryption;
+    private validateState;
+}
+//# sourceMappingURL=resumable-encryption.d.ts.map

package/src/services/resumable-encryption.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resumable-encryption.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-ecies-lib/src/services/resumable-encryption.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAA4B,MAAM,gCAAgC,CAAC;AAC5F,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAChE,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAO5D,MAAM,WAAW,iBAAkB,SAAQ,qBAAqB;IAC9D,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,gBAAgB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAClE;AAED,qBAAa,mBAAmB;IAI5B,OAAO,CAAC,QAAQ,CAAC,MAAM;IAHzB,OAAO,CAAC,KAAK,CAAiC;gBAG3B,MAAM,EAAE,gBAAgB,EACzC,YAAY,CAAC,EAAE,gBAAgB;IAQ1B,OAAO,CACZ,MAAM,EAAE,aAAa,CAAC,UAAU,CAAC,EACjC,SAAS,EAAE,UAAU,EACrB,OAAO,GAAE,iBAAsB,GAC9B,cAAc,CAAC,eAAe,EAAE,IAAI,EAAE,OAAO,CAAC;IAkDjD,SAAS,IAAI,gBAAgB;IAW7B,OAAO,CAAC,kBAAkB;IAW1B,MAAM,CAAC,MAAM,CACX,MAAM,EAAE,gBAAgB,EACxB,KAAK,EAAE,gBAAgB,GACtB,mBAAmB;IAItB,OAAO,CAAC,aAAa;CAuBtB"}

package/src/services/resumable-encryption.js

@@ -0,0 +1,109 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ResumableEncryption = void 0;
+const encryption_state_1 = require("../interfaces/encryption-state");
+const utils_1 = require("../utils");
+const ecies_encryption_type_1 = require("../enumerations/ecies-encryption-type");
+const i18n_setup_1 = require("../i18n-setup");
+const ecies_string_key_1 = require("../enumerations/ecies-string-key");
+class ResumableEncryption {
+    stream;
+    state = null;
+    constructor(stream, initialState) {
+        this.stream = stream;
+        if (initialState) {
+            this.validateState(initialState);
+            this.state = initialState;
+        }
+    }
+    async *encrypt(source, publicKey, options = {}) {
+        const engine = (0, i18n_setup_1.getEciesI18nEngine)();
+        const autoSaveInterval = options.autoSaveInterval ?? 10;
+        if (autoSaveInterval <= 0) {
+            throw new Error(engine.translate(i18n_setup_1.EciesComponentId, ecies_string_key_1.EciesStringKey.Error_Resumable_AutoSaveIntervalMustBePositive));
+        }
+        const publicKeyHex = (0, utils_1.uint8ArrayToHex)(publicKey);
+        if (this.state) {
+            if (this.state.publicKey !== publicKeyHex) {
+                throw new Error(engine.translate(i18n_setup_1.EciesComponentId, ecies_string_key_1.EciesStringKey.Error_Resumable_PublicKeyMismatch));
+            }
+            if (this.state.chunkSize !== (options.chunkSize ?? 1024 * 1024)) {
+                throw new Error(engine.translate(i18n_setup_1.EciesComponentId, ecies_string_key_1.EciesStringKey.Error_Resumable_ChunkSizeMismatch));
+            }
+            if (this.state.includeChecksums !== (options.includeChecksums ?? false)) {
+                throw new Error(engine.translate(i18n_setup_1.EciesComponentId, ecies_string_key_1.EciesStringKey.Error_Resumable_IncludeChecksumsMismatch));
+            }
+        }
+        const startIndex = this.state?.chunkIndex ?? 0;
+        let chunkIndex = 0;
+        for await (const chunk of this.stream.encryptStream(source, publicKey, options)) {
+            if (chunkIndex < startIndex) {
+                chunkIndex++;
+                continue;
+            }
+            yield chunk;
+            this.state = {
+                version: encryption_state_1.ENCRYPTION_STATE_VERSION,
+                chunkIndex: chunk.index + 1,
+                bytesProcessed: (this.state?.bytesProcessed ?? 0) + (chunk.metadata?.originalSize ?? 0),
+                publicKey: publicKeyHex,
+                encryptionType: ecies_encryption_type_1.EciesEncryptionTypeEnum.Single,
+                chunkSize: options.chunkSize ?? 1024 * 1024,
+                includeChecksums: options.includeChecksums ?? false,
+                timestamp: Date.now(),
+            };
+            if (options.onStateSaved && (chunk.index + 1) % autoSaveInterval === 0) {
+                await options.onStateSaved({ ...this.state });
+            }
+            chunkIndex++;
+        }
+    }
+    saveState() {
+        if (!this.state) {
+            const engine = (0, i18n_setup_1.getEciesI18nEngine)();
+            throw new Error(engine.translate(i18n_setup_1.EciesComponentId, ecies_string_key_1.EciesStringKey.Error_Resumable_NoStateToSave));
+        }
+        const state = { ...this.state };
+        // Add HMAC for integrity
+        state.hmac = this.calculateStateHMAC(state);
+        return state;
+    }
+    calculateStateHMAC(state) {
+        const data = `${state.version}|${state.chunkIndex}|${state.bytesProcessed}|${state.publicKey}|${state.chunkSize}|${state.includeChecksums}|${state.timestamp}`;
+        const hash = new Uint8Array(32);
+        // Simple hash for integrity check (not cryptographic HMAC)
+        const bytes = new TextEncoder().encode(data);
+        for (let i = 0; i < bytes.length; i++) {
+            hash[i % 32] ^= bytes[i];
+        }
+        return (0, utils_1.uint8ArrayToHex)(hash);
+    }
+    static resume(stream, state) {
+        return new ResumableEncryption(stream, state);
+    }
+    validateState(state) {
+        const engine = (0, i18n_setup_1.getEciesI18nEngine)();
+        if (state.version !== encryption_state_1.ENCRYPTION_STATE_VERSION) {
+            throw new Error(engine.translate(i18n_setup_1.EciesComponentId, ecies_string_key_1.EciesStringKey.Error_Resumable_UnsupportedStateVersionTemplate, { version: state.version }));
+        }
+        if (state.chunkIndex < 0) {
+            throw new Error(engine.translate(i18n_setup_1.EciesComponentId, ecies_string_key_1.EciesStringKey.Error_Resumable_InvalidChunkIndex));
+        }
+        const age = Date.now() - state.timestamp;
+        if (age > 24 * 60 * 60 * 1000) {
+            throw new Error(engine.translate(i18n_setup_1.EciesComponentId, ecies_string_key_1.EciesStringKey.Error_Resumable_StateTooOld));
+        }
+        if (!state.publicKey || state.publicKey.length === 0) {
+            throw new Error(engine.translate(i18n_setup_1.EciesComponentId, ecies_string_key_1.EciesStringKey.Error_Resumable_InvalidPublicKeyInState));
+        }
+        // Verify HMAC if present
+        if (state.hmac) {
+            const expectedHMAC = this.calculateStateHMAC(state);
+            if (state.hmac !== expectedHMAC) {
+                throw new Error(engine.translate(i18n_setup_1.EciesComponentId, ecies_string_key_1.EciesStringKey.Error_Resumable_StateIntegrityCheckFailed));
+            }
+        }
+    }
+}
+exports.ResumableEncryption = ResumableEncryption;
+//# sourceMappingURL=resumable-encryption.js.map

package/src/services/resumable-encryption.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resumable-encryption.js","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-ecies-lib/src/services/resumable-encryption.ts"],"names":[],"mappings":";;;AAAA,qEAA4F;AAI5F,oCAA4D;AAC5D,iFAAgF;AAChF,8CAAqE;AACrE,uEAAkE;AAQlE,MAAa,mBAAmB;IAIX;IAHX,KAAK,GAA4B,IAAI,CAAC;IAE9C,YACmB,MAAwB,EACzC,YAA+B;QADd,WAAM,GAAN,MAAM,CAAkB;QAGzC,IAAI,YAAY,EAAE,CAAC;YACjB,IAAI,CAAC,aAAa,CAAC,YAAY,CAAC,CAAC;YACjC,IAAI,CAAC,KAAK,GAAG,YAAY,CAAC;QAC5B,CAAC;IACH,CAAC;IAED,KAAK,CAAC,CAAC,OAAO,CACZ,MAAiC,EACjC,SAAqB,EACrB,UAA6B,EAAE;QAE/B,MAAM,MAAM,GAAG,IAAA,+BAAkB,GAAE,CAAC;QACpC,MAAM,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,IAAI,EAAE,CAAC;QACxD,IAAI,gBAAgB,IAAI,CAAC,EAAE,CAAC;YAC1B,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC,6BAAgB,EAAE,iCAAc,CAAC,8CAA8C,CAAC,CAAC,CAAC;QACrH,CAAC;QAED,MAAM,YAAY,GAAG,IAAA,uBAAe,EAAC,SAAS,CAAC,CAAC;QAChD,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACf,IAAI,IAAI,CAAC,KAAK,CAAC,SAAS,KAAK,YAAY,EAAE,CAAC;gBAC1C,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC,6BAAgB,EAAE,iCAAc,CAAC,iCAAiC,CAAC,CAAC,CAAC;YACxG,CAAC;YACD,IAAI,IAAI,CAAC,KAAK,CAAC,SAAS,KAAK,CAAC,OAAO,CAAC,SAAS,IAAI,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC;gBAChE,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC,6BAAgB,EAAE,iCAAc,CAAC,iCAAiC,CAAC,CAAC,CAAC;YACxG,CAAC;YACD,IAAI,IAAI,CAAC,KAAK,CAAC,gBAAgB,KAAK,CAAC,OAAO,CAAC,gBAAgB,IAAI,KAAK,CAAC,EAAE,CAAC;gBACxE,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC,6BAAgB,EAAE,iCAAc,CAAC,wCAAwC,CAAC,CAAC,CAAC;YAC/G,CAAC;QACH,CAAC;QAED,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,EAAE,UAAU,IAAI,CAAC,CAAC;QAE/C,IAAI,UAAU,GAAG,CAAC,CAAC;QACnB,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE,CAAC;YAChF,IAAI,UAAU,GAAG,UAAU,EAAE,CAAC;gBAC5B,UAAU,EAAE,CAAC;gBACb,SAAS;YACX,CAAC;YAED,MAAM,KAAK,CAAC;YAEZ,IAAI,CAAC,KAAK,GAAG;gBACX,OAAO,EAAE,2CAAwB;gBACjC,UAAU,EAAE,KAAK,CAAC,KAAK,GAAG,CAAC;gBAC3B,cAAc,EAAE,CAAC,IAAI,CAAC,KAAK,EAAE,cAAc,IAAI,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,EAAE,YAAY,IAAI,CAAC,CAAC;gBACvF,SAAS,EAAE,YAAY;gBACvB,cAAc,EAAE,+CAAuB,CAAC,MAAM;gBAC9C,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,IAAI,GAAG,IAAI;gBAC3C,gBAAgB,EAAE,OAAO,CAAC,gBAAgB,IAAI,KAAK;gBACnD,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;aACtB,CAAC;YAEF,IAAI,OAAO,CAAC,YAAY,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,GAAG,gBAAgB,KAAK,CAAC,EAAE,CAAC;gBACvE,MAAM,OAAO,CAAC,YAAY,CAAC,EAAE,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;YAChD,CAAC;YAED,UAAU,EAAE,CAAC;QACf,CAAC;IACH,CAAC;IAED,SAAS;QACP,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;YAChB,MAAM,MAAM,GAAG,IAAA,+BAAkB,GAAE,CAAC;YACpC,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC,6BAAgB,EAAE,iCAAc,CAAC,6BAA6B,CAAC,CAAC,CAAC;QACpG,CAAC;QACD,MAAM,KAAK,GAAG,EAAE,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC;QAChC,yBAAyB;QACzB,KAAK,CAAC,IAAI,GAAG,IAAI,CAAC,kBAAkB,CAAC,KAAK,CAAC,CAAC;QAC5C,OAAO,KAAK,CAAC;IACf,CAAC;IAEO,kBAAkB,CAAC,KAAuB;QAChD,MAAM,IAAI,GAAG,GAAG,KAAK,CAAC,OAAO,IAAI,KAAK,CAAC,UAAU,IAAI,KAAK,CAAC,cAAc,IAAI,KAAK,CAAC,SAAS,IAAI,KAAK,CAAC,SAAS,IAAI,KAAK,CAAC,gBAAgB,IAAI,KAAK,CAAC,SAAS,EAAE,CAAC;QAC/J,MAAM,IAAI,GAAG,IAAI,UAAU,CAAC,EAAE,CAAC,CAAC;QAChC,2DAA2D;QAC3D,MAAM,KAAK,GAAG,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAC7C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACtC,IAAI,CAAC,CAAC,GAAG,EAAE,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC;QAC3B,CAAC;QACD,OAAO,IAAA,uBAAe,EAAC,IAAI,CAAC,CAAC;IAC/B,CAAC;IAED,MAAM,CAAC,MAAM,CACX,MAAwB,EACxB,KAAuB;QAEvB,OAAO,IAAI,mBAAmB,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAChD,CAAC;IAEO,aAAa,CAAC,KAAuB;QAC3C,MAAM,MAAM,GAAG,IAAA,+BAAkB,GAAE,CAAC;QACpC,IAAI,KAAK,CAAC,OAAO,KAAK,2CAAwB,EAAE,CAAC;YAC/C,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC,6BAAgB,EAAE,iCAAc,CAAC,+CAA+C,EAAE,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;QAClJ,CAAC;QACD,IAAI,KAAK,CAAC,UAAU,GAAG,CAAC,EAAE,CAAC;YACzB,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC,6BAAgB,EAAE,iCAAc,CAAC,iCAAiC,CAAC,CAAC,CAAC;QACxG,CAAC;QACD,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,SAAS,CAAC;QACzC,IAAI,GAAG,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,EAAE,CAAC;YAC9B,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC,6BAAgB,EAAE,iCAAc,CAAC,2BAA2B,CAAC,CAAC,CAAC;QAClG,CAAC;QACD,IAAI,CAAC,KAAK,CAAC,SAAS,IAAI,KAAK,CAAC,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACrD,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC,6BAAgB,EAAE,iCAAc,CAAC,uCAAuC,CAAC,CAAC,CAAC;QAC9G,CAAC;QACD,yBAAyB;QACzB,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;YACf,MAAM,YAAY,GAAG,IAAI,CAAC,kBAAkB,CAAC,KAAK,CAAC,CAAC;YACpD,IAAI,KAAK,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;gBAChC,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC,6BAAgB,EAAE,iCAAc,CAAC,yCAAyC,CAAC,CAAC,CAAC;YAChH,CAAC;QACH,CAAC;IACH,CAAC;CACF;AAvHD,kDAuHC"}

package/src/services/xor.d.ts

@@ -0,0 +1,37 @@
+/**
+ * A simple and fast XOR cipher for obfuscating data in memory for browser environments.
+ * This is not a substitute for strong cryptography but provides a lightweight way
+ * to prevent sensitive data from being stored in plaintext in memory.
+ */
+export declare class XorService {
+    /**
+     * Encrypts or decrypts data using a simple XOR cipher.
+     * The key is XORed with the data. The same function is used for
+     * both encryption and decryption.
+     *
+     * @param data The data to process.
+     * @param key The key to use for the XOR operation.
+     * @returns A new Uint8Array containing the result of the XOR operation.
+     */
+    static xor(data: Uint8Array, key: Uint8Array): Uint8Array;
+    /**
+     * Generates a random key of a specified length.
+     * @param length The length of the key in bytes.
+     * @returns A Uint8Array containing the random key.
+     * @throws Error if crypto API is not available.
+     */
+    static generateKey(length: number): Uint8Array;
+    /**
+     * Helper method to convert a string to a Uint8Array.
+     * @param str The string to convert.
+     * @returns A Uint8Array representation of the string.
+     */
+    static stringToBytes(str: string): Uint8Array;
+    /**
+     * Helper method to convert a Uint8Array to a string.
+     * @param bytes The Uint8Array to convert.
+     * @returns A string representation of the Uint8Array.
+     */
+    static bytesToString(bytes: Uint8Array): string;
+}
+//# sourceMappingURL=xor.d.ts.map

package/src/services/xor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"xor.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-ecies-lib/src/services/xor.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,qBAAa,UAAU;IACrB;;;;;;;;OAQG;WACW,GAAG,CAAC,IAAI,EAAE,UAAU,EAAE,GAAG,EAAE,UAAU,GAAG,UAAU;IAQhE;;;;;OAKG;WACW,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU;IAgBrD;;;;OAIG;WACW,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU;IAKpD;;;;OAIG;WACW,aAAa,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM;CAIvD"}

package/src/services/xor.js

@@ -0,0 +1,67 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.XorService = void 0;
+/**
+ * A simple and fast XOR cipher for obfuscating data in memory for browser environments.
+ * This is not a substitute for strong cryptography but provides a lightweight way
+ * to prevent sensitive data from being stored in plaintext in memory.
+ */
+class XorService {
+    /**
+     * Encrypts or decrypts data using a simple XOR cipher.
+     * The key is XORed with the data. The same function is used for
+     * both encryption and decryption.
+     *
+     * @param data The data to process.
+     * @param key The key to use for the XOR operation.
+     * @returns A new Uint8Array containing the result of the XOR operation.
+     */
+    static xor(data, key) {
+        const result = new Uint8Array(data.length);
+        for (let i = 0; i < data.length; i++) {
+            result[i] = data[i] ^ key[i % key.length];
+        }
+        return result;
+    }
+    /**
+     * Generates a random key of a specified length.
+     * @param length The length of the key in bytes.
+     * @returns A Uint8Array containing the random key.
+     * @throws Error if crypto API is not available.
+     */
+    static generateKey(length) {
+        const randomBytes = new Uint8Array(length);
+        // Check if running in a browser with crypto support
+        if (typeof window !== 'undefined' && window.crypto) {
+            window.crypto.getRandomValues(randomBytes);
+        }
+        else if (typeof crypto !== 'undefined') {
+            // For environments where crypto is global (some newer JS runtimes)
+            crypto.getRandomValues(randomBytes);
+        }
+        else {
+            throw new Error('Crypto API not available in this environment');
+        }
+        return randomBytes;
+    }
+    /**
+     * Helper method to convert a string to a Uint8Array.
+     * @param str The string to convert.
+     * @returns A Uint8Array representation of the string.
+     */
+    static stringToBytes(str) {
+        const encoder = new TextEncoder();
+        return encoder.encode(str);
+    }
+    /**
+     * Helper method to convert a Uint8Array to a string.
+     * @param bytes The Uint8Array to convert.
+     * @returns A string representation of the Uint8Array.
+     */
+    static bytesToString(bytes) {
+        const decoder = new TextDecoder();
+        return decoder.decode(bytes);
+    }
+}
+exports.XorService = XorService;
+//# sourceMappingURL=xor.js.map

package/src/services/xor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"xor.js","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-ecies-lib/src/services/xor.ts"],"names":[],"mappings":";;;AAAA;;;;GAIG;AACH,MAAa,UAAU;IACrB;;;;;;;;OAQG;IACI,MAAM,CAAC,GAAG,CAAC,IAAgB,EAAE,GAAe;QACjD,MAAM,MAAM,GAAG,IAAI,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC3C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACrC,MAAM,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC;QAC5C,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;;;;OAKG;IACI,MAAM,CAAC,WAAW,CAAC,MAAc;QACtC,MAAM,WAAW,GAAG,IAAI,UAAU,CAAC,MAAM,CAAC,CAAC;QAE3C,oDAAoD;QACpD,IAAI,OAAO,MAAM,KAAK,WAAW,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;YACnD,MAAM,CAAC,MAAM,CAAC,eAAe,CAAC,WAAW,CAAC,CAAC;QAC7C,CAAC;aAAM,IAAI,OAAO,MAAM,KAAK,WAAW,EAAE,CAAC;YACzC,mEAAmE;YACnE,MAAM,CAAC,eAAe,CAAC,WAAW,CAAC,CAAC;QACtC,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAC;QAClE,CAAC;QAED,OAAO,WAAW,CAAC;IACrB,CAAC;IAED;;;;OAIG;IACI,MAAM,CAAC,aAAa,CAAC,GAAW;QACrC,MAAM,OAAO,GAAG,IAAI,WAAW,EAAE,CAAC;QAClC,OAAO,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAC7B,CAAC;IAED;;;;OAIG;IACI,MAAM,CAAC,aAAa,CAAC,KAAiB;QAC3C,MAAM,OAAO,GAAG,IAAI,WAAW,EAAE,CAAC;QAClC,OAAO,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC/B,CAAC;CACF;AA3DD,gCA2DC"}

package/src/test-mocks/index.d.ts

@@ -0,0 +1,2 @@
+export * from './mock-frontend-member';
+//# sourceMappingURL=index.d.ts.map

package/src/test-mocks/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-ecies-lib/src/test-mocks/index.ts"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAC"}

package/src/test-mocks/index.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./mock-frontend-member"), exports);
+//# sourceMappingURL=index.js.map

package/src/test-mocks/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-ecies-lib/src/test-mocks/index.ts"],"names":[],"mappings":";;;AAAA,iEAAuC"}

package/src/test-mocks/mock-frontend-member.d.ts

@@ -0,0 +1,85 @@
+import { EmailString, MemberType, SecureBuffer, SecureString } from '@digitaldefiance/ecies-lib';
+import { Wallet } from '@ethereumjs/wallet';
+import { ObjectId } from 'bson';
+import type { IFrontendMemberOperational } from '../interfaces/frontend-member-operational';
+import { SignatureUint8Array } from '../types';
+export declare class MockFrontendMember implements IFrontendMemberOperational<ObjectId> {
+    private _id;
+    private _type;
+    private _name;
+    private _email;
+    private _publicKey;
+    private _creatorId;
+    private _dateCreated;
+    private _dateUpdated;
+    private _privateKey?;
+    private _wallet?;
+    private _hasPrivateKey;
+    constructor(data?: Partial<{
+        id: ObjectId;
+        type: MemberType;
+        name: string;
+        email: EmailString;
+        publicKey: Uint8Array;
+        privateKey: SecureBuffer;
+        wallet: Wallet;
+        creatorId: ObjectId;
+        dateCreated: Date;
+        dateUpdated: Date;
+        hasPrivateKey: boolean;
+    }>);
+    get id(): ObjectId;
+    get type(): MemberType;
+    get name(): string;
+    get email(): EmailString;
+    get publicKey(): Uint8Array;
+    get creatorId(): ObjectId;
+    get dateCreated(): Date;
+    get dateUpdated(): Date;
+    get privateKey(): SecureBuffer | undefined;
+    get wallet(): Wallet | undefined;
+    get hasPrivateKey(): boolean;
+    unloadPrivateKey(): void;
+    unloadWallet(): void;
+    unloadWalletAndPrivateKey(): void;
+    loadWallet(mnemonic: SecureString): void;
+    loadPrivateKey(privateKey: SecureBuffer): void;
+    sign(data: Uint8Array): SignatureUint8Array;
+    verify(signature: SignatureUint8Array, data: Uint8Array): boolean;
+    encryptData(data: string | Uint8Array): Promise<Uint8Array>;
+    decryptData(encryptedData: Uint8Array): Promise<Uint8Array>;
+    encryptDataStream(source: AsyncIterable<Uint8Array> | ReadableStream<Uint8Array>, options?: {
+        recipientPublicKey?: Uint8Array;
+        onProgress?: (progress: {
+            bytesProcessed: number;
+            chunksProcessed: number;
+        }) => void;
+        signal?: AbortSignal;
+    }): AsyncGenerator<import('../interfaces/encrypted-chunk').IEncryptedChunk, void, unknown>;
+    decryptDataStream(source: AsyncIterable<Uint8Array> | ReadableStream<Uint8Array>, options?: {
+        onProgress?: (progress: {
+            bytesProcessed: number;
+            chunksProcessed: number;
+        }) => void;
+        signal?: AbortSignal;
+    }): AsyncGenerator<Uint8Array, void, unknown>;
+    toJson(): string;
+    dispose(): void;
+    static create(overrides?: Partial<{
+        id: ObjectId;
+        type: MemberType;
+        name: string;
+        email: EmailString;
+        publicKey: Uint8Array;
+        privateKey: SecureBuffer;
+        wallet: Wallet;
+        creatorId: ObjectId;
+        dateCreated: Date;
+        dateUpdated: Date;
+        hasPrivateKey: boolean;
+    }>): MockFrontendMember;
+    static createMultiple(count: number): MockFrontendMember[];
+    static createWithPrivateKey(): MockFrontendMember;
+    static createWithoutPrivateKey(): MockFrontendMember;
+}
+//# sourceMappingURL=mock-frontend-member.d.ts.map

package/src/test-mocks/mock-frontend-member.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock-frontend-member.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-ecies-lib/src/test-mocks/mock-frontend-member.ts"],"names":[],"mappings":"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"}