@digitaldefiance/ecies-lib 1.0.0

package/dist/member.js

@@ -0,0 +1,256 @@
+import { ECIES } from './constants';
+import { EmailString } from './email-string';
+import MemberErrorType from './enumerations/member-error-type';
+import MemberType from './enumerations/member-type';
+import { MemberError } from './errors/member';
+import { GuidV4 } from './guid';
+import { SecureBuffer } from './secure-buffer';
+import { base64ToUint8Array, uint8ArrayToBase64, uint8ArrayToHex, } from './utils';
+/**
+ * A member of Brightchain.
+ * In the Owner Free Filesystem (OFF), members are used to:
+ * 1. Sign and verify data
+ * 2. Encrypt and decrypt data
+ * 3. Participate in voting
+ * 4. Establish ownership of data
+ */
+export class Member {
+    _eciesService;
+    _id;
+    _type;
+    _name;
+    _email;
+    _publicKey;
+    _creatorId;
+    _dateCreated;
+    _dateUpdated;
+    _privateKey;
+    _wallet;
+    constructor(
+    // Add injected services as parameters
+    eciesService, 
+    // Original parameters
+    type, name, email, publicKey, privateKey, wallet, id, dateCreated, dateUpdated, creatorId) {
+        // Assign injected services
+        this._eciesService = eciesService;
+        // Assign original parameters
+        this._type = type;
+        this._id = id ?? GuidV4.new();
+        this._name = name;
+        if (!this._name || this._name.length == 0) {
+            throw new MemberError(MemberErrorType.MissingMemberName);
+        }
+        if (this._name.trim() != this._name) {
+            throw new MemberError(MemberErrorType.InvalidMemberNameWhitespace);
+        }
+        this._email = email;
+        this._publicKey = publicKey;
+        this._privateKey = privateKey;
+        this._wallet = wallet;
+        // don't create a new date object with nearly identical values to the existing one
+        let _now = null;
+        const now = function () {
+            if (!_now) {
+                _now = new Date();
+            }
+            return _now;
+        };
+        this._dateCreated = dateCreated ?? now();
+        this._dateUpdated = dateUpdated ?? now();
+        this._creatorId = creatorId ?? this._id;
+    }
+    // Required getters
+    get id() {
+        return this._id;
+    }
+    get type() {
+        return this._type;
+    }
+    get name() {
+        return this._name;
+    }
+    get email() {
+        return this._email;
+    }
+    get publicKey() {
+        return this._publicKey;
+    }
+    get creatorId() {
+        return this._creatorId;
+    }
+    get dateCreated() {
+        return this._dateCreated;
+    }
+    get dateUpdated() {
+        return this._dateUpdated;
+    }
+    // Optional private data getters
+    get privateKey() {
+        return this._privateKey;
+    }
+    get wallet() {
+        if (!this._wallet) {
+            throw new MemberError(MemberErrorType.NoWallet);
+        }
+        return this._wallet;
+    }
+    // State getters
+    get hasPrivateKey() {
+        return this._privateKey !== undefined;
+    }
+    unloadPrivateKey() {
+        // Do not dispose here; tests expect the same SecureBuffer instance to remain usable
+        // when reloaded into another member in the same process.
+        this._privateKey = undefined;
+    }
+    unloadWallet() {
+        this._wallet = undefined;
+    }
+    unloadWalletAndPrivateKey() {
+        this.unloadWallet();
+        this.unloadPrivateKey();
+    }
+    loadWallet(mnemonic) {
+        if (this._wallet) {
+            throw new MemberError(MemberErrorType.WalletAlreadyLoaded);
+        }
+        const { wallet } = this._eciesService.walletAndSeedFromMnemonic(mnemonic);
+        const privateKey = wallet.getPrivateKey();
+        const publicKey = wallet.getPublicKey();
+        const publicKeyWithPrefix = new Uint8Array(publicKey.length + 1);
+        publicKeyWithPrefix[0] = ECIES.PUBLIC_KEY_MAGIC;
+        publicKeyWithPrefix.set(publicKey, 1);
+        if (uint8ArrayToHex(publicKeyWithPrefix) !== uint8ArrayToHex(this._publicKey)) {
+            throw new MemberError(MemberErrorType.InvalidMnemonic);
+        }
+        this._wallet = wallet;
+        this._privateKey = new SecureBuffer(privateKey);
+    }
+    /**
+     * Loads the private key and optionally the voting private key.
+     *
+     * @param privateKey The private key to load.
+     * @param votingPrivateKey The voting private key to load.
+     */
+    loadPrivateKey(privateKey) {
+        this._privateKey = privateKey;
+    }
+    sign(data) {
+        if (!this._privateKey) {
+            throw new MemberError(MemberErrorType.MissingPrivateKey);
+        }
+        return this._eciesService.signMessage(this._privateKey.value, data);
+    }
+    signData(data) {
+        if (!this._privateKey) {
+            throw new MemberError(MemberErrorType.MissingPrivateKey);
+        }
+        return this._eciesService.signMessage(new Uint8Array(this._privateKey.value), data);
+    }
+    verify(signature, data) {
+        return this._eciesService.verifyMessage(this._publicKey, data, signature);
+    }
+    verifySignature(data, signature, publicKey) {
+        return this._eciesService.verifyMessage(publicKey, data, signature);
+    }
+    static MAX_ENCRYPTION_SIZE = 1024 * 1024 * 10; // 10MB limit
+    static VALID_STRING_REGEX = /^[\x20-\x7E\n\r\t]*$/; // Printable ASCII + common whitespace
+    async encryptData(data, recipientPublicKey) {
+        // Validate input
+        if (!data) {
+            throw new MemberError(MemberErrorType.MissingEncryptionData);
+        }
+        // Check size limit
+        const arr = data instanceof Uint8Array ? data : new TextEncoder().encode(data);
+        if (arr.length > Member.MAX_ENCRYPTION_SIZE) {
+            throw new MemberError(MemberErrorType.EncryptionDataTooLarge);
+        }
+        // Use recipient public key or self public key
+        const targetPublicKey = recipientPublicKey || this._publicKey;
+        return await this._eciesService.encryptSimpleOrSingle(false, targetPublicKey, arr);
+    }
+    async decryptData(encryptedData) {
+        if (!this._privateKey) {
+            throw new MemberError(MemberErrorType.MissingPrivateKey);
+        }
+        // decryptSingleWithHeader now returns the Uint8Array directly
+        return await this._eciesService.decryptSimpleOrSingleWithHeader(false, new Uint8Array(this._privateKey.value), encryptedData);
+    }
+    toJson() {
+        const storage = {
+            id: this._id.toString(),
+            type: this._type,
+            name: this._name,
+            email: this._email.toString(),
+            publicKey: uint8ArrayToBase64(this._publicKey),
+            creatorId: this._creatorId.toString(),
+            dateCreated: this._dateCreated.toISOString(),
+            dateUpdated: this._dateUpdated.toISOString(),
+        };
+        return JSON.stringify(storage);
+    }
+    dispose() {
+        // Ensure secret material is zeroized when disposing
+        try {
+            this._privateKey?.dispose();
+        }
+        finally {
+            this.unloadWalletAndPrivateKey();
+        }
+    }
+    static fromJson(json, 
+    // Add injected services as parameters
+    eciesService) {
+        const storage = JSON.parse(json);
+        const email = new EmailString(storage.email);
+        // Pass injected services to constructor
+        const dateCreated = new Date(storage.dateCreated);
+        return new Member(eciesService, storage.type, storage.name, email, base64ToUint8Array(storage.publicKey), undefined, undefined, new GuidV4(storage.id), dateCreated, new Date(storage.dateUpdated), new GuidV4(storage.creatorId));
+    }
+    static fromMnemonic(mnemonic, eciesService) {
+        const { wallet } = eciesService.walletAndSeedFromMnemonic(mnemonic);
+        const privateKey = wallet.getPrivateKey();
+        const publicKey = wallet.getPublicKey();
+        const publicKeyWithPrefix = new Uint8Array(publicKey.length + 1);
+        publicKeyWithPrefix[0] = ECIES.PUBLIC_KEY_MAGIC;
+        publicKeyWithPrefix.set(publicKey, 1);
+        return new Member(eciesService, MemberType.User, 'Test User', new EmailString('test@example.com'), publicKeyWithPrefix, new SecureBuffer(privateKey), wallet);
+    }
+    static newMember(
+    // Add injected services as parameters
+    eciesService, 
+    // Original parameters
+    type, name, email, forceMnemonic, createdBy) {
+        // Validate inputs first
+        if (!name || name.length == 0) {
+            throw new MemberError(MemberErrorType.MissingMemberName);
+        }
+        if (name.trim() != name) {
+            throw new MemberError(MemberErrorType.InvalidMemberNameWhitespace);
+        }
+        if (!email || email.toString().length == 0) {
+            throw new MemberError(MemberErrorType.MissingEmail);
+        }
+        if (email.toString().trim() != email.toString()) {
+            throw new MemberError(MemberErrorType.InvalidEmailWhitespace);
+        }
+        // Use injected services
+        const mnemonic = forceMnemonic ?? eciesService.generateNewMnemonic();
+        const { wallet } = eciesService.walletAndSeedFromMnemonic(mnemonic);
+        // Get private key from wallet
+        const privateKey = wallet.getPrivateKey();
+        // Get public key with 0x04 prefix
+        const publicKey = wallet.getPublicKey();
+        const publicKeyWithPrefix = new Uint8Array(publicKey.length + 1);
+        publicKeyWithPrefix[0] = ECIES.PUBLIC_KEY_MAGIC;
+        publicKeyWithPrefix.set(publicKey, 1);
+        const newId = GuidV4.new();
+        const dateCreated = new Date();
+        return {
+            // Pass injected services to constructor
+            member: new Member(eciesService, type, name, email, publicKeyWithPrefix, new SecureBuffer(privateKey), wallet, newId, dateCreated, dateCreated, createdBy ?? newId),
+            mnemonic,
+        };
+    }
+}
+//# sourceMappingURL=member.js.map

package/dist/member.js.map

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

package/dist/pbkdf2-profiles.d.ts

@@ -0,0 +1,6 @@
+import { Pbkdf2ProfileEnum } from './enumerations/pbkdf2-profile';
+import { IPbkdf2Config } from './interfaces/pbkdf2-config';
+export type Pbkdf2Profiles = {
+    [key in Pbkdf2ProfileEnum]: IPbkdf2Config;
+};
+//# sourceMappingURL=pbkdf2-profiles.d.ts.map

package/dist/pbkdf2-profiles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pbkdf2-profiles.d.ts","sourceRoot":"","sources":["../src/pbkdf2-profiles.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAE3D,MAAM,MAAM,cAAc,GAAG;KAC1B,GAAG,IAAI,iBAAiB,GAAG,aAAa;CAC1C,CAAC"}

package/dist/pbkdf2-profiles.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=pbkdf2-profiles.js.map

package/dist/pbkdf2-profiles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pbkdf2-profiles.js","sourceRoot":"","sources":["../src/pbkdf2-profiles.ts"],"names":[],"mappings":""}

package/dist/secure-buffer.d.ts

@@ -0,0 +1,38 @@
+import { FullHexGuid, RawGuidUint8Array } from './types';
+/**
+ * A secure string buffer is a buffer whose intent is to prevent the raw password from being stored in memory.
+ * The buffer is encrypted with a key derived from a GUID.
+ * The GUID is stored in the clear, but the buffer is encrypted with a key derived from the GUID.
+ * This allows the buffer to be decrypted, but only if the GUID and salt are known.
+ */
+export declare class SecureBuffer {
+    private _disposed;
+    private readonly _id;
+    private readonly _length;
+    private readonly _obfuscatedValue;
+    private readonly _key;
+    private readonly _obfuscatedChecksum;
+    private _disposedAt?;
+    constructor(data?: Uint8Array);
+    dispose(): void;
+    private assertNotDisposed;
+    static fromString(data: string): SecureBuffer;
+    get disposedAtStack(): string | undefined;
+    get id(): FullHexGuid;
+    get idUint8Array(): RawGuidUint8Array;
+    get originalLength(): number;
+    get value(): Uint8Array;
+    get valueAsString(): string;
+    get valueAsHexString(): string;
+    get valueAsBase64String(): string;
+    get checksum(): string;
+    private generateSimpleChecksum;
+    private createSimpleObfuscatedChecksum;
+    private validateSimpleChecksum;
+    private timingSafeEqual;
+    private validateObfuscatedChecksum;
+    private obfuscateData;
+    private deobfuscateData;
+    get length(): number;
+}
+//# sourceMappingURL=secure-buffer.d.ts.map

package/dist/secure-buffer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"secure-buffer.d.ts","sourceRoot":"","sources":["../src/secure-buffer.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAGzD;;;;;GAKG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,SAAS,CAAkB;IACnC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;IAC7B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAa;IAC9C,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAa;IAClC,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAa;IACjD,OAAO,CAAC,WAAW,CAAC,CAAS;gBACjB,IAAI,CAAC,EAAE,UAAU;IAgBtB,OAAO,IAAI,IAAI;IAWtB,OAAO,CAAC,iBAAiB;WAUX,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY;IAGpD,IAAW,eAAe,IAAI,MAAM,GAAG,SAAS,CAE/C;IACD,IAAW,EAAE,IAAI,WAAW,CAG3B;IACD,IAAW,YAAY,IAAI,iBAAiB,CAG3C;IACD,IAAW,cAAc,IAAI,MAAM,CAGlC;IACD,IAAW,KAAK,IAAI,UAAU,CA4B7B;IACD,IAAW,aAAa,IAAI,MAAM,CAGjC;IACD,IAAW,gBAAgB,IAAI,MAAM,CAGpC;IACD,IAAW,mBAAmB,IAAI,MAAM,CAGvC;IACD,IAAW,QAAQ,IAAI,MAAM,CAM5B;IACD,OAAO,CAAC,sBAAsB;IAS9B,OAAO,CAAC,8BAA8B;IAOtC,OAAO,CAAC,sBAAsB;IAQ9B,OAAO,CAAC,eAAe;IAUvB,OAAO,CAAC,0BAA0B;IAMlC,OAAO,CAAC,aAAa;IAGrB,OAAO,CAAC,eAAe;IAGvB,IAAW,MAAM,IAAI,MAAM,CAG1B;CACF"}

package/dist/secure-buffer.js

@@ -0,0 +1,161 @@
+import { SecureStorageErrorType } from './enumerations/secure-storage-error-type';
+import { DisposedError } from './errors/disposed';
+import { SecureStorageError } from './errors/secure-storage';
+import { GuidV4 } from './guid';
+import { XorService } from './services/xor';
+import { uint8ArrayToHex } from './utils';
+/**
+ * A secure string buffer is a buffer whose intent is to prevent the raw password from being stored in memory.
+ * The buffer is encrypted with a key derived from a GUID.
+ * The GUID is stored in the clear, but the buffer is encrypted with a key derived from the GUID.
+ * This allows the buffer to be decrypted, but only if the GUID and salt are known.
+ */
+export class SecureBuffer {
+    _disposed = false;
+    _id;
+    _length;
+    _obfuscatedValue;
+    _key;
+    _obfuscatedChecksum;
+    _disposedAt;
+    constructor(data) {
+        this._id = GuidV4.new();
+        // don't bother encrypting an empty buffer
+        if (data === undefined || data.length === 0) {
+            this._length = 0;
+            this._obfuscatedValue = new Uint8Array(0);
+            this._key = new Uint8Array(0);
+            this._obfuscatedChecksum = new Uint8Array(0);
+            return;
+        }
+        this._length = data.length;
+        this._key = this.idUint8Array;
+        this._obfuscatedValue = this.obfuscateData(data);
+        // Create a simple checksum without crypto for synchronous operation
+        this._obfuscatedChecksum = this.createSimpleObfuscatedChecksum(data);
+    }
+    dispose() {
+        const err = new DisposedError();
+        if (typeof Error.captureStackTrace === 'function') {
+            Error.captureStackTrace(err, this.dispose);
+        }
+        this._disposedAt = err.stack ?? 'stack unavailable';
+        this._obfuscatedValue.fill(0);
+        this._key.fill(0);
+        this._obfuscatedChecksum.fill(0);
+        this._disposed = true;
+    }
+    assertNotDisposed() {
+        if (!this._disposed)
+            return;
+        const e = new DisposedError();
+        try {
+            e.disposedAt = this._disposedAt;
+        }
+        catch {
+            // ignore if Error object is sealed/frozen
+        }
+        throw e;
+    }
+    static fromString(data) {
+        return new SecureBuffer(new TextEncoder().encode(data));
+    }
+    get disposedAtStack() {
+        return this._disposedAt;
+    }
+    get id() {
+        this.assertNotDisposed();
+        return this._id.asFullHexGuid;
+    }
+    get idUint8Array() {
+        this.assertNotDisposed();
+        return this._id.asRawGuidUint8Array;
+    }
+    get originalLength() {
+        this.assertNotDisposed();
+        return this._length;
+    }
+    get value() {
+        this.assertNotDisposed();
+        if (this._length === 0) {
+            return new Uint8Array(0);
+        }
+        try {
+            const deobfuscatedResult = this.deobfuscateData(this._obfuscatedValue);
+            if (deobfuscatedResult.length !== this._length) {
+                throw new SecureStorageError(SecureStorageErrorType.DecryptedValueLengthMismatch);
+            }
+            if (!this.validateObfuscatedChecksum(deobfuscatedResult)) {
+                throw new SecureStorageError(SecureStorageErrorType.DecryptedValueChecksumMismatch);
+            }
+            return deobfuscatedResult;
+        }
+        catch (error) {
+            // If it's already a SecureStorageError, re-throw it
+            if (error instanceof SecureStorageError) {
+                throw error;
+            }
+            // Convert any other error (including AES-GCM authentication errors) to SecureStorageError
+            throw new SecureStorageError(SecureStorageErrorType.DecryptedValueChecksumMismatch);
+        }
+    }
+    get valueAsString() {
+        this.assertNotDisposed();
+        return new TextDecoder().decode(this.value);
+    }
+    get valueAsHexString() {
+        this.assertNotDisposed();
+        return uint8ArrayToHex(this.value);
+    }
+    get valueAsBase64String() {
+        this.assertNotDisposed();
+        return btoa(String.fromCharCode(...this.value));
+    }
+    get checksum() {
+        this.assertNotDisposed();
+        const deobfuscatedChecksum = new TextDecoder().decode(this.deobfuscateData(this._obfuscatedChecksum));
+        return deobfuscatedChecksum;
+    }
+    generateSimpleChecksum(data) {
+        const dataBytes = typeof data === 'string' ? new TextEncoder().encode(data) : data;
+        let hash = 0;
+        for (let i = 0; i < dataBytes.length; i++) {
+            hash = ((hash << 5) - hash + dataBytes[i]) & 0xffffffff;
+        }
+        return hash.toString(16);
+    }
+    createSimpleObfuscatedChecksum(data) {
+        const checksum = this.generateSimpleChecksum(data);
+        const result = this.obfuscateData(new TextEncoder().encode(checksum));
+        return result;
+    }
+    validateSimpleChecksum(data, checksum) {
+        const generatedChecksum = this.generateSimpleChecksum(data);
+        return generatedChecksum === checksum;
+    }
+    timingSafeEqual(a, b) {
+        if (a.length !== b.length) {
+            return false;
+        }
+        let result = 0;
+        for (let i = 0; i < a.length; i++) {
+            result |= a[i] ^ b[i];
+        }
+        return result === 0;
+    }
+    validateObfuscatedChecksum(data) {
+        const deobfuscatedChecksum = new TextDecoder().decode(this.deobfuscateData(this._obfuscatedChecksum));
+        return this.validateSimpleChecksum(data, deobfuscatedChecksum);
+    }
+    obfuscateData(data) {
+        return XorService.xor(data, this._key);
+    }
+    deobfuscateData(data) {
+        return XorService.xor(data, this._key);
+    }
+    get length() {
+        this.assertNotDisposed();
+        return this._length;
+    }
+}
+//# sourceMappingURL=secure-buffer.js.map

package/dist/secure-buffer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"secure-buffer.js","sourceRoot":"","sources":["../src/secure-buffer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,0CAA0C,CAAC;AAClF,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAE5C,OAAO,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE1C;;;;;GAKG;AACH,MAAM,OAAO,YAAY;IACf,SAAS,GAAY,KAAK,CAAC;IAClB,GAAG,CAAS;IACZ,OAAO,CAAS;IAChB,gBAAgB,CAAa;IAC7B,IAAI,CAAa;IACjB,mBAAmB,CAAa;IACzC,WAAW,CAAU;IAC7B,YAAY,IAAiB;QAC3B,IAAI,CAAC,GAAG,GAAG,MAAM,CAAC,GAAG,EAAE,CAAC;QACxB,0CAA0C;QAC1C,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC5C,IAAI,CAAC,OAAO,GAAG,CAAC,CAAC;YACjB,IAAI,CAAC,gBAAgB,GAAG,IAAI,UAAU,CAAC,CAAC,CAAC,CAAC;YAC1C,IAAI,CAAC,IAAI,GAAG,IAAI,UAAU,CAAC,CAAC,CAAC,CAAC;YAC9B,IAAI,CAAC,mBAAmB,GAAG,IAAI,UAAU,CAAC,CAAC,CAAC,CAAC;YAC7C,OAAO;QACT,CAAC;QACD,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC;QAC3B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,YAAY,CAAC;QAC9B,IAAI,CAAC,gBAAgB,GAAG,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;QACjD,oEAAoE;QACpE,IAAI,CAAC,mBAAmB,GAAG,IAAI,CAAC,8BAA8B,CAAC,IAAI,CAAC,CAAC;IACvE,CAAC;IACM,OAAO;QACZ,MAAM,GAAG,GAAG,IAAI,aAAa,EAAE,CAAC;QAChC,IAAI,OAAQ,KAAa,CAAC,iBAAiB,KAAK,UAAU,EAAE,CAAC;YAC1D,KAAa,CAAC,iBAAiB,CAAC,GAAG,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;QACtD,CAAC;QACD,IAAI,CAAC,WAAW,GAAG,GAAG,CAAC,KAAK,IAAI,mBAAmB,CAAC;QACpD,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC9B,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACjC,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;IACxB,CAAC;IACO,iBAAiB;QACvB,IAAI,CAAC,IAAI,CAAC,SAAS;YAAE,OAAO;QAC5B,MAAM,CAAC,GAAG,IAAI,aAAa,EAAE,CAAC;QAC9B,IAAI,CAAC;YACF,CAAS,CAAC,UAAU,GAAG,IAAI,CAAC,WAAW,CAAC;QAC3C,CAAC;QAAC,MAAM,CAAC;YACP,0CAA0C;QAC5C,CAAC;QACD,MAAM,CAAC,CAAC;IACV,CAAC;IACM,MAAM,CAAC,UAAU,CAAC,IAAY;QACnC,OAAO,IAAI,YAAY,CAAC,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;IAC1D,CAAC;IACD,IAAW,eAAe;QACxB,OAAO,IAAI,CAAC,WAAW,CAAC;IAC1B,CAAC;IACD,IAAW,EAAE;QACX,IAAI,CAAC,iBAAiB,EAAE,CAAC;QACzB,OAAO,IAAI,CAAC,GAAG,CAAC,aAAa,CAAC;IAChC,CAAC;IACD,IAAW,YAAY;QACrB,IAAI,CAAC,iBAAiB,EAAE,CAAC;QACzB,OAAO,IAAI,CAAC,GAAG,CAAC,mBAAmB,CAAC;IACtC,CAAC;IACD,IAAW,cAAc;QACvB,IAAI,CAAC,iBAAiB,EAAE,CAAC;QACzB,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IACD,IAAW,KAAK;QACd,IAAI,CAAC,iBAAiB,EAAE,CAAC;QACzB,IAAI,IAAI,CAAC,OAAO,KAAK,CAAC,EAAE,CAAC;YACvB,OAAO,IAAI,UAAU,CAAC,CAAC,CAAC,CAAC;QAC3B,CAAC;QACD,IAAI,CAAC;YACH,MAAM,kBAAkB,GAAG,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;YACvE,IAAI,kBAAkB,CAAC,MAAM,KAAK,IAAI,CAAC,OAAO,EAAE,CAAC;gBAC/C,MAAM,IAAI,kBAAkB,CAC1B,sBAAsB,CAAC,4BAA4B,CACpD,CAAC;YACJ,CAAC;YACD,IAAI,CAAC,IAAI,CAAC,0BAA0B,CAAC,kBAAkB,CAAC,EAAE,CAAC;gBACzD,MAAM,IAAI,kBAAkB,CAC1B,sBAAsB,CAAC,8BAA8B,CACtD,CAAC;YACJ,CAAC;YACD,OAAO,kBAAkB,CAAC;QAC5B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,oDAAoD;YACpD,IAAI,KAAK,YAAY,kBAAkB,EAAE,CAAC;gBACxC,MAAM,KAAK,CAAC;YACd,CAAC;YACD,0FAA0F;YAC1F,MAAM,IAAI,kBAAkB,CAC1B,sBAAsB,CAAC,8BAA8B,CACtD,CAAC;QACJ,CAAC;IACH,CAAC;IACD,IAAW,aAAa;QACtB,IAAI,CAAC,iBAAiB,EAAE,CAAC;QACzB,OAAO,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC9C,CAAC;IACD,IAAW,gBAAgB;QACzB,IAAI,CAAC,iBAAiB,EAAE,CAAC;QACzB,OAAO,eAAe,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACrC,CAAC;IACD,IAAW,mBAAmB;QAC5B,IAAI,CAAC,iBAAiB,EAAE,CAAC;QACzB,OAAO,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;IAClD,CAAC;IACD,IAAW,QAAQ;QACjB,IAAI,CAAC,iBAAiB,EAAE,CAAC;QACzB,MAAM,oBAAoB,GAAG,IAAI,WAAW,EAAE,CAAC,MAAM,CACnD,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAC/C,CAAC;QACF,OAAO,oBAAoB,CAAC;IAC9B,CAAC;IACO,sBAAsB,CAAC,IAAyB;QACtD,MAAM,SAAS,GACb,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QACnE,IAAI,IAAI,GAAG,CAAC,CAAC;QACb,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,SAAS,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YAC1C,IAAI,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC,GAAG,UAAU,CAAC;QAC1D,CAAC;QACD,OAAO,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IAC3B,CAAC;IACO,8BAA8B,CACpC,IAAyB;QAEzB,MAAM,QAAQ,GAAG,IAAI,CAAC,sBAAsB,CAAC,IAAI,CAAC,CAAC;QACnD,MAAM,MAAM,GAAG,IAAI,CAAC,aAAa,CAAC,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC;QACtE,OAAO,MAAM,CAAC;IAChB,CAAC;IACO,sBAAsB,CAC5B,IAAyB,EACzB,QAAgB;QAEhB,MAAM,iBAAiB,GAAG,IAAI,CAAC,sBAAsB,CAAC,IAAI,CAAC,CAAC;QAC5D,OAAO,iBAAiB,KAAK,QAAQ,CAAC;IACxC,CAAC;IAEO,eAAe,CAAC,CAAa,EAAE,CAAa;QAClD,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,MAAM,EAAE,CAAC;YAC1B,OAAO,KAAK,CAAC;QACf,CAAC;QACD,IAAI,MAAM,GAAG,CAAC,CAAC;QACf,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YAClC,MAAM,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QACxB,CAAC;QACD,OAAO,MAAM,KAAK,CAAC,CAAC;IACtB,CAAC;IACO,0BAA0B,CAAC,IAAyB;QAC1D,MAAM,oBAAoB,GAAG,IAAI,WAAW,EAAE,CAAC,MAAM,CACnD,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAC/C,CAAC;QACF,OAAO,IAAI,CAAC,sBAAsB,CAAC,IAAI,EAAE,oBAAoB,CAAC,CAAC;IACjE,CAAC;IACO,aAAa,CAAC,IAAgB;QACpC,OAAO,UAAU,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;IACzC,CAAC;IACO,eAAe,CAAC,IAAgB;QACtC,OAAO,UAAU,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;IACzC,CAAC;IACD,IAAW,MAAM;QACf,IAAI,CAAC,iBAAiB,EAAE,CAAC;QACzB,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;CACF"}

package/dist/secure-string.d.ts

@@ -0,0 +1,39 @@
+import { FullHexGuid, RawGuidUint8Array } from './types';
+/**
+ * A secure string buffer is a buffer whose intent is to prevent the raw password from being stored in memory.
+ */
+export declare class SecureString {
+    private _disposed;
+    private readonly _isNull;
+    private readonly _id;
+    private readonly _length;
+    private readonly _obfuscatedValue;
+    private readonly _key;
+    private readonly _obfuscatedChecksum;
+    private _disposedAt?;
+    constructor(data?: string | Uint8Array | null);
+    private assertNotDisposed;
+    dispose(): void;
+    get disposedAtStack(): string | undefined;
+    get id(): FullHexGuid;
+    get idUint8Array(): RawGuidUint8Array;
+    get originalLength(): number;
+    get valueAsUint8Array(): Uint8Array;
+    get value(): string | null;
+    get notNullValue(): string;
+    get valueAsHexString(): string;
+    get valueAsBase64String(): string;
+    get hasValue(): boolean;
+    get checksum(): string;
+    get length(): number;
+    private generateChecksum;
+    private createSimpleChecksum;
+    private createSimpleObfuscatedChecksum;
+    private createObfuscatedChecksum;
+    private validateChecksum;
+    private timingSafeEqual;
+    private validateObfuscatedChecksum;
+    private obfuscateData;
+    private deobfuscateData;
+}
+//# sourceMappingURL=secure-string.d.ts.map

package/dist/secure-string.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"secure-string.d.ts","sourceRoot":"","sources":["../src/secure-string.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAGzD;;GAEG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,SAAS,CAAkB;IACnC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAU;IAClC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;IAC7B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAa;IAC9C,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAa;IAClC,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAa;IACjD,OAAO,CAAC,WAAW,CAAC,CAAS;gBACjB,IAAI,CAAC,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI;IAuB7C,OAAO,CAAC,iBAAiB;IAUlB,OAAO,IAAI,IAAI;IAWtB,IAAW,eAAe,IAAI,MAAM,GAAG,SAAS,CAE/C;IACD,IAAW,EAAE,IAAI,WAAW,CAG3B;IACD,IAAW,YAAY,IAAI,iBAAiB,CAG3C;IACD,IAAW,cAAc,IAAI,MAAM,CAGlC;IACD,IAAW,iBAAiB,IAAI,UAAU,CAoCzC;IACD,IAAW,KAAK,IAAI,MAAM,GAAG,IAAI,CAMhC;IACD,IAAW,YAAY,IAAI,MAAM,CAMhC;IACD,IAAW,gBAAgB,IAAI,MAAM,CAGpC;IACD,IAAW,mBAAmB,IAAI,MAAM,CAGvC;IACD,IAAW,QAAQ,IAAI,OAAO,CAG7B;IACD,IAAW,QAAQ,IAAI,MAAM,CAM5B;IACD,IAAW,MAAM,IAAI,MAAM,CAG1B;YACa,gBAAgB;IAS9B,OAAO,CAAC,oBAAoB;IAQ5B,OAAO,CAAC,8BAA8B;YASxB,wBAAwB;YAOxB,gBAAgB;IAQ9B,OAAO,CAAC,eAAe;YAUT,0BAA0B;IAQxC,OAAO,CAAC,aAAa;IAGrB,OAAO,CAAC,eAAe;CAGxB"}