@digitaldefiance/ecies-lib 4.4.13 → 4.4.14

package/src/interfaces/encryption-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"encryption-state.js","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-ecies-lib/src/interfaces/encryption-state.ts"],"names":[],"mappings":"AAkBA,MAAM,CAAC,MAAM,wBAAwB,GAAW,CAAC,CAAC"}

package/src/interfaces/frontend-member-operational.d.ts

@@ -0,0 +1,51 @@
+import type { Wallet } from '@ethereumjs/wallet';
+import type { EmailString } from '../email-string';
+import type MemberType from '../enumerations/member-type';
+import type { SecureBuffer } from '../secure-buffer';
+import type { SecureString } from '../secure-string';
+import type { SignatureUint8Array } from '../types';
+import type { IECIESConstants } from './ecies-consts';
+import type { IEncryptedChunk } from './encrypted-chunk';
+import type { ProgressCallback } from './stream-progress';
+/**
+ * Operational interface for member - defines getters and methods
+ */
+export interface IFrontendMemberOperational<TID = Uint8Array, TData = Uint8Array, TSignature = SignatureUint8Array> {
+    get id(): TID;
+    get type(): MemberType;
+    get name(): string;
+    get email(): EmailString;
+    get publicKey(): Uint8Array;
+    get creatorId(): TID;
+    get dateCreated(): Date;
+    get dateUpdated(): Date;
+    get privateKey(): SecureBuffer | undefined;
+    get wallet(): Wallet | undefined;
+    get hasPrivateKey(): boolean;
+    sign(data: TData): TSignature;
+    verify(signature: TSignature, data: TData): boolean;
+    encryptData(data: string | TData, recipientPublicKey?: Uint8Array): Promise<TData>;
+    decryptData(encryptedData: TData): Promise<TData>;
+    toJson(): string;
+    dispose(): void;
+    encryptDataStream(source: AsyncIterable<Uint8Array> | ReadableStream<Uint8Array>, options?: {
+        recipientPublicKey?: Uint8Array;
+        onProgress?: ProgressCallback;
+        signal?: AbortSignal;
+    }): AsyncGenerator<IEncryptedChunk, void, unknown>;
+    decryptDataStream(source: AsyncIterable<Uint8Array> | ReadableStream<Uint8Array>, options?: {
+        onProgress?: ProgressCallback;
+        signal?: AbortSignal;
+    }): AsyncGenerator<Uint8Array, void, unknown>;
+    loadWallet(mnemonic: SecureString, eciesParams?: IECIESConstants): void;
+    unloadPrivateKey(): void;
+    unloadWallet(): void;
+    unloadWalletAndPrivateKey(): void;
+}
+/**
+ * Extended operational interface for test members
+ */
+export interface ITestMemberOperational extends IFrontendMemberOperational {
+    get mnemonic(): SecureString | undefined;
+}
+//# sourceMappingURL=frontend-member-operational.d.ts.map

package/src/interfaces/frontend-member-operational.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frontend-member-operational.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-ecies-lib/src/interfaces/frontend-member-operational.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,KAAK,UAAU,MAAM,6BAA6B,CAAC;AAC1D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AACpD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAE1D;;GAEG;AACH,MAAM,WAAW,0BAA0B,CACzC,GAAG,GAAG,UAAU,EAChB,KAAK,GAAG,UAAU,EAClB,UAAU,GAAG,mBAAmB;IAGhC,IAAI,EAAE,IAAI,GAAG,CAAC;IACd,IAAI,IAAI,IAAI,UAAU,CAAC;IACvB,IAAI,IAAI,IAAI,MAAM,CAAC;IACnB,IAAI,KAAK,IAAI,WAAW,CAAC;IACzB,IAAI,SAAS,IAAI,UAAU,CAAC;IAC5B,IAAI,SAAS,IAAI,GAAG,CAAC;IACrB,IAAI,WAAW,IAAI,IAAI,CAAC;IACxB,IAAI,WAAW,IAAI,IAAI,CAAC;IAGxB,IAAI,UAAU,IAAI,YAAY,GAAG,SAAS,CAAC;IAC3C,IAAI,MAAM,IAAI,MAAM,GAAG,SAAS,CAAC;IAGjC,IAAI,aAAa,IAAI,OAAO,CAAC;IAG7B,IAAI,CAAC,IAAI,EAAE,KAAK,GAAG,UAAU,CAAC;IAC9B,MAAM,CAAC,SAAS,EAAE,UAAU,EAAE,IAAI,EAAE,KAAK,GAAG,OAAO,CAAC;IACpD,WAAW,CACT,IAAI,EAAE,MAAM,GAAG,KAAK,EACpB,kBAAkB,CAAC,EAAE,UAAU,GAC9B,OAAO,CAAC,KAAK,CAAC,CAAC;IAClB,WAAW,CAAC,aAAa,EAAE,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;IAClD,MAAM,IAAI,MAAM,CAAC;IACjB,OAAO,IAAI,IAAI,CAAC;IAGhB,iBAAiB,CACf,MAAM,EAAE,aAAa,CAAC,UAAU,CAAC,GAAG,cAAc,CAAC,UAAU,CAAC,EAC9D,OAAO,CAAC,EAAE;QACR,kBAAkB,CAAC,EAAE,UAAU,CAAC;QAChC,UAAU,CAAC,EAAE,gBAAgB,CAAC;QAC9B,MAAM,CAAC,EAAE,WAAW,CAAC;KACtB,GACA,cAAc,CAAC,eAAe,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;IAElD,iBAAiB,CACf,MAAM,EAAE,aAAa,CAAC,UAAU,CAAC,GAAG,cAAc,CAAC,UAAU,CAAC,EAC9D,OAAO,CAAC,EAAE;QACR,UAAU,CAAC,EAAE,gBAAgB,CAAC;QAC9B,MAAM,CAAC,EAAE,WAAW,CAAC;KACtB,GACA,cAAc,CAAC,UAAU,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;IAG7C,UAAU,CAAC,QAAQ,EAAE,YAAY,EAAE,WAAW,CAAC,EAAE,eAAe,GAAG,IAAI,CAAC;IACxE,gBAAgB,IAAI,IAAI,CAAC;IACzB,YAAY,IAAI,IAAI,CAAC;IACrB,yBAAyB,IAAI,IAAI,CAAC;CACnC;AAED;;GAEG;AACH,MAAM,WAAW,sBAAuB,SAAQ,0BAA0B;IACxE,IAAI,QAAQ,IAAI,YAAY,GAAG,SAAS,CAAC;CAC1C"}

package/src/interfaces/frontend-member-operational.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=frontend-member-operational.js.map

package/src/interfaces/frontend-member-operational.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"frontend-member-operational.js","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-ecies-lib/src/interfaces/frontend-member-operational.ts"],"names":[],"mappings":""}

package/src/interfaces/guid.d.ts

@@ -0,0 +1,78 @@
+import { Base64Guid, BigIntGuid, FullHexGuid, RawGuidBuffer, ShortHexGuid } from '../types';
+export interface IGuidV4 {
+    /**
+     * Returns the GUID as a raw buffer.
+     */
+    get asRawGuidBuffer(): RawGuidBuffer;
+    /**
+     * Returns the GUID as a full hex string.
+     */
+    get asFullHexGuid(): FullHexGuid;
+    /**
+     * Returns the GUID as a Uint8Array.
+     */
+    get asUint8Array(): Uint8Array;
+    /**
+     * Returns the GUID as a short hex string.
+     */
+    get asShortHexGuid(): ShortHexGuid;
+    /**
+     * Returns the GUID as a BigInt.
+     */
+    get asBigIntGuid(): BigIntGuid;
+    /**
+     * Returns the GUID as a Base64 string.
+     */
+    get asBase64Guid(): Base64Guid;
+    /**
+     * Returns the GUID as a base64 string
+     */
+    serialize(): string;
+    /**
+     * Returns the GUID as a JSON string
+     */
+    toJson(): string;
+    /**
+     * Returns the GUID as a Base64 string
+     */
+    toString(): Base64Guid;
+    /**
+     * Compares this GUID to another GUID
+     * @param other The GUID to compare to (can be null/undefined)
+     * @param constantTime Use constant-time comparison to prevent timing attacks
+     */
+    equals(other: IGuidV4 | null | undefined, constantTime?: boolean): boolean;
+    /**
+     * Creates a new GuidV4 instance with the same value as this one.
+     * @returns A new GuidV4 instance with identical value
+     */
+    clone(): IGuidV4;
+    /**
+     * Returns the hash code for this GUID based on its buffer content.
+     * Useful for using GUIDs as Map/Set keys.
+     * @returns A numeric hash code
+     */
+    hashCode(): number;
+    /**
+     * Checks if this GUID is empty (all zeros).
+     * @returns True if the GUID is all zeros, false otherwise
+     */
+    isEmpty(): boolean;
+    /**
+     * Extracts the RFC 4122 version from the GUID.
+     * @returns The version number (1-5) or undefined
+     */
+    getVersion(): number | undefined;
+    /**
+     * Validates that this GUID is a proper v4 GUID according to RFC 4122.
+     * @returns True if valid v4 GUID or boundary value, false otherwise
+     */
+    isValidV4(): boolean;
+    /**
+     * Compares two GUIDs for ordering.
+     * @param other The other GUID to compare to
+     * @returns -1 if this < other, 0 if equal, 1 if this > other
+     */
+    compareTo(other: IGuidV4): number;
+}
+//# sourceMappingURL=guid.d.ts.map

package/src/interfaces/guid.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"guid.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-ecies-lib/src/interfaces/guid.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,EACV,UAAU,EAEV,WAAW,EACX,aAAa,EACb,YAAY,EACb,MAAM,UAAU,CAAC;AAElB,MAAM,WAAW,OAAO;IACtB;;OAEG;IACH,IAAI,eAAe,IAAI,aAAa,CAAC;IACrC;;OAEG;IACH,IAAI,aAAa,IAAI,WAAW,CAAC;IACjC;;OAEG;IACH,IAAI,YAAY,IAAI,UAAU,CAAC;IAC/B;;OAEG;IACH,IAAI,cAAc,IAAI,YAAY,CAAC;IACnC;;OAEG;IACH,IAAI,YAAY,IAAI,UAAU,CAAC;IAC/B;;OAEG;IACH,IAAI,YAAY,IAAI,UAAU,CAAC;IAE/B;;OAEG;IACH,SAAS,IAAI,MAAM,CAAC;IACpB;;OAEG;IACH,MAAM,IAAI,MAAM,CAAC;IACjB;;OAEG;IACH,QAAQ,IAAI,UAAU,CAAC;IACvB;;;;OAIG;IACH,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,GAAG,SAAS,EAAE,YAAY,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC;IAC3E;;;OAGG;IACH,KAAK,IAAI,OAAO,CAAC;IACjB;;;;OAIG;IACH,QAAQ,IAAI,MAAM,CAAC;IACnB;;;OAGG;IACH,OAAO,IAAI,OAAO,CAAC;IACnB;;;OAGG;IACH,UAAU,IAAI,MAAM,GAAG,SAAS,CAAC;IACjC;;;OAGG;IACH,SAAS,IAAI,OAAO,CAAC;IACrB;;;;OAIG;IACH,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAAC;CACnC"}

package/src/interfaces/guid.js

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

package/src/interfaces/guid.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"guid.js","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-ecies-lib/src/interfaces/guid.ts"],"names":[],"mappings":""}

package/src/interfaces/id-provider.d.ts

@@ -0,0 +1,107 @@
+/**
+ * Interface for ID providers that supply recipient identifiers.
+ * This allows the library to support various ID formats (ObjectID, GUID, UUID, custom).
+ */
+export interface IIdProvider {
+    /**
+     * The fixed byte length of IDs produced by this provider.
+     * This determines the size of recipient ID fields in encrypted messages.
+     */
+    readonly byteLength: number;
+    /**
+     * A human-readable name for this ID provider type.
+     * Examples: 'ObjectID', 'GUIDv4', 'UUIDv4', 'Custom'
+     */
+    readonly name: string;
+    /**
+     * Generate a new random ID.
+     * @returns A newly generated ID as a Uint8Array of length `byteLength`
+     */
+    generate(): Uint8Array;
+    /**
+     * Validate that a given buffer is a properly formatted ID for this provider.
+     * This should check length, format constraints, and any version bits if applicable.
+     * @param id The ID buffer to validate
+     * @returns True if the ID is valid for this provider, false otherwise
+     */
+    validate(id: Uint8Array): boolean;
+    /**
+     * Serialize an ID buffer to a human-readable string representation.
+     * Examples: hex string, base64, ObjectID hex, UUID format with dashes
+     * @param id The ID buffer to serialize
+     * @returns A string representation of the ID
+     * @throws Error if the ID is invalid
+     */
+    serialize(id: Uint8Array): string;
+    /**
+     * Deserialize a string representation back to an ID buffer.
+     * This is the inverse of `serialize`.
+     * @param str The string representation of the ID
+     * @returns The ID as a Uint8Array of length `byteLength`
+     * @throws Error if the string is not a valid representation
+     */
+    deserialize(str: string): Uint8Array;
+    /**
+     * Compare two IDs for equality.
+     * Default implementation uses constant-time comparison.
+     * @param a First ID
+     * @param b Second ID
+     * @returns True if IDs are equal, false otherwise
+     */
+    equals(a: Uint8Array, b: Uint8Array): boolean;
+    /**
+     * Clone an ID buffer.
+     * Default implementation creates a defensive copy.
+     * @param id The ID to clone
+     * @returns A new Uint8Array with the same contents
+     */
+    clone(id: Uint8Array): Uint8Array;
+    /**
+     * Convert an ID of unknown type to a string representation.
+     * This is useful when dealing with generic IDs that might be Uint8Array, string, or other types.
+     * @param id The ID to convert
+     * @returns A string representation of the ID
+     */
+    idToString(id: unknown): string;
+    /**
+     * Convert a string representation of an ID back to an ID buffer.
+     * This is an alias for `deserialize` to provide symmetry with `idToString`.
+     * @param str The string representation of the ID
+     * @returns The ID as a Uint8Array of length `byteLength`
+     */
+    idFromString(str: string): Uint8Array;
+}
+/**
+ * Base class for ID providers with common utility methods.
+ */
+export declare abstract class BaseIdProvider implements IIdProvider {
+    abstract readonly byteLength: number;
+    abstract readonly name: string;
+    abstract generate(): Uint8Array;
+    abstract validate(id: Uint8Array): boolean;
+    abstract serialize(id: Uint8Array): string;
+    abstract deserialize(str: string): Uint8Array;
+    /**
+     * Convert an ID of unknown type to a string representation.
+     * Default implementation handles Uint8Array using serialize(), and falls back to String().
+     */
+    idToString(id: unknown): string;
+    /**
+     * Convert a string representation of an ID back to an ID buffer.
+     * Default implementation delegates to `deserialize`.
+     */
+    idFromString(str: string): Uint8Array;
+    /**
+     * Constant-time comparison to prevent timing attacks.
+     */
+    equals(a: Uint8Array, b: Uint8Array): boolean;
+    /**
+     * Create a defensive copy of an ID.
+     */
+    clone(id: Uint8Array): Uint8Array;
+    /**
+     * Validate ID length matches expected byte length.
+     */
+    protected validateLength(id: Uint8Array, context: string): void;
+}
+//# sourceMappingURL=id-provider.d.ts.map

package/src/interfaces/id-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"id-provider.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-ecies-lib/src/interfaces/id-provider.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B;;;OAGG;IACH,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAE5B;;;OAGG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB;;;OAGG;IACH,QAAQ,IAAI,UAAU,CAAC;IAEvB;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,EAAE,UAAU,GAAG,OAAO,CAAC;IAElC;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,EAAE,UAAU,GAAG,MAAM,CAAC;IAElC;;;;;;OAMG;IACH,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,CAAC;IAErC;;;;;;OAMG;IACH,MAAM,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC;IAE9C;;;;;OAKG;IACH,KAAK,CAAC,EAAE,EAAE,UAAU,GAAG,UAAU,CAAC;IAElC;;;;;OAKG;IACH,UAAU,CAAC,EAAE,EAAE,OAAO,GAAG,MAAM,CAAC;IAEhC;;;;;OAKG;IACH,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,CAAC;CACvC;AAED;;GAEG;AACH,8BAAsB,cAAe,YAAW,WAAW;IACzD,QAAQ,CAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAE/B,QAAQ,CAAC,QAAQ,IAAI,UAAU;IAC/B,QAAQ,CAAC,QAAQ,CAAC,EAAE,EAAE,UAAU,GAAG,OAAO;IAC1C,QAAQ,CAAC,SAAS,CAAC,EAAE,EAAE,UAAU,GAAG,MAAM;IAC1C,QAAQ,CAAC,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU;IAE7C;;;OAGG;IACH,UAAU,CAAC,EAAE,EAAE,OAAO,GAAG,MAAM;IAO/B;;;OAGG;IACH,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU;IAIrC;;OAEG;IACH,MAAM,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,UAAU,GAAG,OAAO;IAY7C;;OAEG;IACH,KAAK,CAAC,EAAE,EAAE,UAAU,GAAG,UAAU;IAIjC;;OAEG;IACH,SAAS,CAAC,cAAc,CAAC,EAAE,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;CAYhE"}

package/src/interfaces/id-provider.js

@@ -0,0 +1,52 @@
+/**
+ * Base class for ID providers with common utility methods.
+ */
+export class BaseIdProvider {
+    /**
+     * Convert an ID of unknown type to a string representation.
+     * Default implementation handles Uint8Array using serialize(), and falls back to String().
+     */
+    idToString(id) {
+        if (id instanceof Uint8Array) {
+            return this.serialize(id);
+        }
+        return String(id);
+    }
+    /**
+     * Convert a string representation of an ID back to an ID buffer.
+     * Default implementation delegates to `deserialize`.
+     */
+    idFromString(str) {
+        return this.deserialize(str);
+    }
+    /**
+     * Constant-time comparison to prevent timing attacks.
+     */
+    equals(a, b) {
+        if (a.length !== b.length) {
+            return false;
+        }
+        let diff = 0;
+        for (let i = 0; i < a.length; i++) {
+            diff |= a[i] ^ b[i];
+        }
+        return diff === 0;
+    }
+    /**
+     * Create a defensive copy of an ID.
+     */
+    clone(id) {
+        return new Uint8Array(id);
+    }
+    /**
+     * Validate ID length matches expected byte length.
+     */
+    validateLength(id, context) {
+        if (id.length !== this.byteLength) {
+            const { IdProviderError } = require('../errors/id-provider');
+            const { IdProviderErrorType } = require('../enumerations/id-provider-error-type');
+            throw new IdProviderError(IdProviderErrorType.InvalidLength, undefined, undefined, { context, expected: this.byteLength, actual: id.length });
+        }
+    }
+}
+//# sourceMappingURL=id-provider.js.map

package/src/interfaces/id-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"id-provider.js","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-ecies-lib/src/interfaces/id-provider.ts"],"names":[],"mappings":"AAmFA;;GAEG;AACH,MAAM,OAAgB,cAAc;IASlC;;;OAGG;IACH,UAAU,CAAC,EAAW;QACpB,IAAI,EAAE,YAAY,UAAU,EAAE,CAAC;YAC7B,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;QAC5B,CAAC;QACD,OAAO,MAAM,CAAC,EAAE,CAAC,CAAC;IACpB,CAAC;IAED;;;OAGG;IACH,YAAY,CAAC,GAAW;QACtB,OAAO,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IAC/B,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,CAAa,EAAE,CAAa;QACjC,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,MAAM,EAAE,CAAC;YAC1B,OAAO,KAAK,CAAC;QACf,CAAC;QAED,IAAI,IAAI,GAAG,CAAC,CAAC;QACb,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YAClC,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QACtB,CAAC;QACD,OAAO,IAAI,KAAK,CAAC,CAAC;IACpB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,EAAc;QAClB,OAAO,IAAI,UAAU,CAAC,EAAE,CAAC,CAAC;IAC5B,CAAC;IAED;;OAEG;IACO,cAAc,CAAC,EAAc,EAAE,OAAe;QACtD,IAAI,EAAE,CAAC,MAAM,KAAK,IAAI,CAAC,UAAU,EAAE,CAAC;YAClC,MAAM,EAAE,eAAe,EAAE,GAAG,OAAO,CAAC,uBAAuB,CAAC,CAAC;YAC7D,MAAM,EAAE,mBAAmB,EAAE,GAAG,OAAO,CAAC,wCAAwC,CAAC,CAAC;YAClF,MAAM,IAAI,eAAe,CACvB,mBAAmB,CAAC,aAAa,EACjC,SAAS,EACT,SAAS,EACT,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,CAAC,UAAU,EAAE,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,CAC1D,CAAC;QACJ,CAAC;IACH,CAAC;CACF"}

package/src/interfaces/{index.ts → index.d.ts}

@@ -12,3 +12,4 @@ export type * from './member-with-mnemonic';
 export * from './pbkdf2-config';
 export * from './pbkdf2-consts';
 export * from './pbkdf2-result';
+//# sourceMappingURL=index.d.ts.map

package/src/interfaces/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-ecies-lib/src/interfaces/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,sBAAsB,CAAC;AACrC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,QAAQ,CAAC;AACvB,mBAAmB,UAAU,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,mBAAmB,wBAAwB,CAAC;AAC5C,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC"}

package/src/interfaces/index.js

@@ -0,0 +1,13 @@
+export * from './checksum-config';
+export * from './checksum-consts';
+export * from './constants';
+export * from './ecies-config';
+export * from './ecies-consts';
+export * from './ecies-file-service';
+export * from './frontend-member-operational';
+export * from './guid';
+export * from './member-storage';
+export * from './pbkdf2-config';
+export * from './pbkdf2-consts';
+export * from './pbkdf2-result';
+//# sourceMappingURL=index.js.map

package/src/interfaces/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-ecies-lib/src/interfaces/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,sBAAsB,CAAC;AACrC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,QAAQ,CAAC;AAEvB,cAAc,kBAAkB,CAAC;AAEjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC"}

package/src/interfaces/invariant.d.ts

@@ -0,0 +1,46 @@
+import type { IConstants } from './constants';
+/**
+ * An invariant is a relationship between configuration values that must always hold true.
+ * Unlike simple property validation, invariants check consistency across multiple related values.
+ *
+ * Example: MEMBER_ID_LENGTH must equal idProvider.byteLength
+ *
+ * Invariants help catch configuration errors that simple property validation would miss,
+ * such as the 12 vs 32 byte discrepancy we encountered.
+ */
+export interface IInvariant {
+    /**
+     * Unique name for this invariant (used in error messages)
+     */
+    readonly name: string;
+    /**
+     * Human-readable description of what this invariant validates
+     */
+    readonly description: string;
+    /**
+     * Check if the invariant holds for the given configuration
+     * @returns true if invariant is satisfied, false otherwise
+     */
+    check(config: IConstants): boolean;
+    /**
+     * Generate a detailed error message explaining why the invariant failed
+     * @param config The configuration that failed validation
+     * @returns Error message with actual vs expected values
+     */
+    errorMessage(config: IConstants): string;
+}
+/**
+ * Base class for invariants with common utilities
+ */
+export declare abstract class BaseInvariant implements IInvariant {
+    readonly name: string;
+    readonly description: string;
+    constructor(name: string, description: string);
+    abstract check(config: IConstants): boolean;
+    abstract errorMessage(config: IConstants): string;
+    /**
+     * Helper to format error messages consistently
+     */
+    protected formatError(property1: string, value1: unknown, property2: string, value2: unknown): string;
+}
+//# sourceMappingURL=invariant.d.ts.map

package/src/interfaces/invariant.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"invariant.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-ecies-lib/src/interfaces/invariant.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C;;;;;;;;GAQG;AACH,MAAM,WAAW,UAAU;IACzB;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAE7B;;;OAGG;IACH,KAAK,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC;IAEnC;;;;OAIG;IACH,YAAY,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAAC;CAC1C;AAED;;GAEG;AACH,8BAAsB,aAAc,YAAW,UAAU;aAErC,IAAI,EAAE,MAAM;aACZ,WAAW,EAAE,MAAM;gBADnB,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM;IAGrC,QAAQ,CAAC,KAAK,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO;IAC3C,QAAQ,CAAC,YAAY,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM;IAEjD;;OAEG;IACH,SAAS,CAAC,WAAW,CACnB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,OAAO,EACf,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,OAAO,GACd,MAAM;CAGV"}

package/src/interfaces/invariant.js

@@ -0,0 +1,18 @@
+/**
+ * Base class for invariants with common utilities
+ */
+export class BaseInvariant {
+    name;
+    description;
+    constructor(name, description) {
+        this.name = name;
+        this.description = description;
+    }
+    /**
+     * Helper to format error messages consistently
+     */
+    formatError(property1, value1, property2, value2) {
+        return `Invariant '${this.name}' failed: ${property1} (${value1}) must equal ${property2} (${value2})`;
+    }
+}
+//# sourceMappingURL=invariant.js.map

package/src/interfaces/invariant.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"invariant.js","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-ecies-lib/src/interfaces/invariant.ts"],"names":[],"mappings":"AAoCA;;GAEG;AACH,MAAM,OAAgB,aAAa;IAEf;IACA;IAFlB,YACkB,IAAY,EACZ,WAAmB;QADnB,SAAI,GAAJ,IAAI,CAAQ;QACZ,gBAAW,GAAX,WAAW,CAAQ;IAClC,CAAC;IAKJ;;OAEG;IACO,WAAW,CACnB,SAAiB,EACjB,MAAe,EACf,SAAiB,EACjB,MAAe;QAEf,OAAO,cAAc,IAAI,CAAC,IAAI,aAAa,SAAS,KAAK,MAAM,gBAAgB,SAAS,KAAK,MAAM,GAAG,CAAC;IACzG,CAAC;CACF"}

package/src/interfaces/library-error.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Standardized error interface for Digital Defiance libraries
+ * Ensures consistent error handling across the ecosystem
+ */
+export interface LibraryError extends Error {
+    /** The library that generated this error */
+    readonly library: string;
+    /** Unique error code for programmatic handling */
+    readonly errorCode: string;
+    /** HTTP-style status code */
+    readonly statusCode: number;
+}
+/**
+ * Interface for resources that can be disposed
+ * Ensures consistent memory management across libraries
+ */
+export interface DisposableResource {
+    /** Dispose of the resource and clean up memory */
+    dispose(): void;
+    /** Whether the resource has been disposed */
+    readonly isDisposed: boolean;
+}
+//# sourceMappingURL=library-error.d.ts.map

package/src/interfaces/library-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"library-error.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-ecies-lib/src/interfaces/library-error.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,YAAa,SAAQ,KAAK;IACzC,4CAA4C;IAC5C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,kDAAkD;IAClD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,6BAA6B;IAC7B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,kDAAkD;IAClD,OAAO,IAAI,IAAI,CAAC;IAChB,6CAA6C;IAC7C,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;CAC9B"}

package/src/interfaces/library-error.js

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

package/src/interfaces/library-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"library-error.js","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-ecies-lib/src/interfaces/library-error.ts"],"names":[],"mappings":""}

package/src/interfaces/{member-storage.ts → member-storage.d.ts}

@@ -1,22 +1,21 @@
 import type { MemberType } from '../enumerations/member-type';
-
 /**
  * Storage format for member data - all serializable types
  */
 export interface IMemberStorageData {
-  id: string;
-  type: MemberType;
-  name: string;
-  email: string;
-  publicKey: string; // base64
-  creatorId: string;
-  dateCreated: string; // ISO string
-  dateUpdated: string; // ISO string
+    id: string;
+    type: MemberType;
+    name: string;
+    email: string;
+    publicKey: string;
+    creatorId: string;
+    dateCreated: string;
+    dateUpdated: string;
 }
-
 /**
  * Extended storage format for test member data
  */
 export interface ITestMemberStorageData extends IMemberStorageData {
-  mnemonic?: string;
+    mnemonic?: string;
 }
+//# sourceMappingURL=member-storage.d.ts.map

package/src/interfaces/member-storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"member-storage.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-ecies-lib/src/interfaces/member-storage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAE9D;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,UAAU,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,sBAAuB,SAAQ,kBAAkB;IAChE,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB"}

package/src/interfaces/member-storage.js

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

package/src/interfaces/member-storage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"member-storage.js","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-ecies-lib/src/interfaces/member-storage.ts"],"names":[],"mappings":""}

package/src/interfaces/{member-with-mnemonic.ts → member-with-mnemonic.d.ts}

@@ -1,7 +1,7 @@
 import type { SecureString } from '../secure-string';
 import type { IMember } from './member';
-
 export interface IMemberWithMnemonic {
-  member: IMember;
-  mnemonic: SecureString;
+    member: IMember;
+    mnemonic: SecureString;
 }
+//# sourceMappingURL=member-with-mnemonic.d.ts.map

package/src/interfaces/member-with-mnemonic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"member-with-mnemonic.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-ecies-lib/src/interfaces/member-with-mnemonic.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAExC,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,OAAO,CAAC;IAChB,QAAQ,EAAE,YAAY,CAAC;CACxB"}

package/src/interfaces/member-with-mnemonic.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=member-with-mnemonic.js.map

package/src/interfaces/member-with-mnemonic.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"member-with-mnemonic.js","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-ecies-lib/src/interfaces/member-with-mnemonic.ts"],"names":[],"mappings":""}

package/src/interfaces/member.d.ts

@@ -0,0 +1,55 @@
+import type { Wallet } from '@ethereumjs/wallet';
+import type { EmailString } from '../email-string';
+import type MemberType from '../enumerations/member-type';
+import type { SecureBuffer } from '../secure-buffer';
+import type { SecureString } from '../secure-string';
+import type { SignatureUint8Array } from '../types';
+import type { IECIESConstants } from './ecies-consts';
+import type { IEncryptedChunk } from './encrypted-chunk';
+/**
+ * Interface representing a member with cryptographic capabilities.
+ * This interface defines the contract for member operations without
+ * referencing concrete class implementations.
+ */
+export interface IMember {
+    readonly id: Uint8Array;
+    readonly type: MemberType;
+    readonly name: string;
+    readonly email: EmailString;
+    readonly publicKey: Uint8Array;
+    readonly creatorId: Uint8Array;
+    readonly dateCreated: Date;
+    readonly dateUpdated: Date;
+    readonly privateKey: SecureBuffer | undefined;
+    readonly wallet: Wallet;
+    readonly hasPrivateKey: boolean;
+    unloadPrivateKey(): void;
+    unloadWallet(): void;
+    unloadWalletAndPrivateKey(): void;
+    loadWallet(mnemonic: SecureString, eciesParams?: IECIESConstants): void;
+    loadPrivateKey(privateKey: SecureBuffer): void;
+    sign(data: Uint8Array): SignatureUint8Array;
+    signData(data: Uint8Array): SignatureUint8Array;
+    verify(signature: SignatureUint8Array, data: Uint8Array): boolean;
+    verifySignature(data: Uint8Array, signature: Uint8Array, publicKey: Uint8Array): boolean;
+    encryptDataStream(source: AsyncIterable<Uint8Array> | ReadableStream<Uint8Array>, options?: {
+        recipientPublicKey?: Uint8Array;
+        onProgress?: (progress: {
+            bytesProcessed: number;
+            chunksProcessed: number;
+        }) => void;
+        signal?: AbortSignal;
+    }): AsyncGenerator<IEncryptedChunk, void, unknown>;
+    decryptDataStream(source: AsyncIterable<Uint8Array> | ReadableStream<Uint8Array>, options?: {
+        onProgress?: (progress: {
+            bytesProcessed: number;
+            chunksProcessed: number;
+        }) => void;
+        signal?: AbortSignal;
+    }): AsyncGenerator<Uint8Array, void, unknown>;
+    encryptData(data: string | Uint8Array, recipientPublicKey?: Uint8Array): Promise<Uint8Array>;
+    decryptData(encryptedData: Uint8Array): Promise<Uint8Array>;
+    toJson(): string;
+    dispose(): void;
+}
+//# sourceMappingURL=member.d.ts.map

package/src/interfaces/member.d.ts.map

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

package/src/interfaces/member.js

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

package/src/interfaces/member.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"member.js","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-ecies-lib/src/interfaces/member.ts"],"names":[],"mappings":""}