@digitaldefiance/ecies-lib 4.8.2 → 4.8.6

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@digitaldefiance/ecies-lib",
-  "version": "4.8.2",
+  "version": "4.8.6",
   "description": "Digital Defiance ECIES Library",
   "homepage": "https://github.com/Digital-Defiance/ecies-lib",
   "repository": {
@@ -28,10 +28,16 @@
     "build:stream": "npx nx build --outputStyle=stream digitaldefiance-ecies-lib",
     "build:logged": "npx nx build --outputStyle=stream digitaldefiance-ecies-lib 2>&1 | ansifilter -o build.log",
     "test": "npx nx test digitaldefiance-ecies-lib",
+    "test:large": "node --max-old-space-size=8192 --expose-gc ../../node_modules/.bin/jest tests/integration/large-message-tests.spec.ts",
+    "test:16": "npx nx test digitaldefiance-ecies-lib --parallel=16",
+    "test:dev": "NODE_ENV=development npx nx test digitaldefiance-ecies-lib --configuration=development",
+    "test:16:dev:noansi": "NODE_ENV=development npx nx test digitaldefiance-ecies-lib --parallel=16 --configuration=development | ansifilter",
+    "test:dev:16": "NODE_ENV=development npx nx test digitaldefiance-ecies-lib --parallel=16 --configuration=development",
+    "test:dev:16:logged": "NODE_ENV=development npx nx test digitaldefiance-ecies-lib --parallel=16 --configuration=development 2>&1 | ansifilter -o test.log",
     "test:nocache": "npx nx test --skip-nx-cache digitaldefiance-ecies-lib",
     "test:stream": "npx nx test --outputStyle=stream digitaldefiance-ecies-lib",
-    "test:logged": "npx jest --config=jest.config.js 2>&1 | tee test.log",
-    "test:logged:verbose": "VERBOSE_TESTS=1 npx jest --config=jest.config.js 2>&1 | tee test.log",
+    "test:logged": "npx jest --config=jest.config.js 2>&1 | ansifilter | tee test.log",
+    "test:logged:verbose": "VERBOSE_TESTS=1 npx jest --config=jest.config.js 2>&1 | ansifilter | tee test.log",
     "test:coverage": "npx jest --coverage --testPathPattern=digitaldefiance-ecies-lib --coverageReporters=text",
     "check:circular": "madge --circular --extensions ts src/index.ts",
     "check:circular:json": "madge --circular --extensions ts --json src/index.ts",

package/src/interfaces/constants.d.ts

@@ -1,7 +1,7 @@
 import type { Pbkdf2Profiles } from '../pbkdf2-profiles';
 import type { IChecksumConsts } from './checksum-consts';
 import type { IECIESConstants } from './ecies-consts';
-import type { IIdProvider } from './id-provider';
+import type { IIdProviderBase } from './id-provider';
 import type { IPBkdf2Consts } from './pbkdf2-consts';
 import type { IVotingConsts } from './voting-consts';
 export interface IConstants {
@@ -31,6 +31,10 @@ export interface IConstants {
      *
      * Default: ObjectIdProvider (12 bytes, MongoDB compatible)
      *
+     * The base interface provides Uint8Array-based operations (generate, validate,
+     * serialize, deserialize). For typed operations with the native ID type,
+     * cast to the specific provider type or use IIdProvider<T>.
+     *
      * @example
      * ```typescript
      * import { GuidV4Provider } from './lib/id-providers';
@@ -39,9 +43,13 @@ export interface IConstants {
      * const config = createRuntimeConfiguration({
      *   idProvider: new GuidV4Provider()
      * });
+     *
+     * // For typed access:
+     * const provider = config.idProvider as GuidV4Provider;
+     * const guid = provider.fromBytes(provider.generate());
      * ```
      */
-    idProvider: IIdProvider;
+    idProvider: IIdProviderBase;
     CHECKSUM: IChecksumConsts;
     ECIES: IECIESConstants;
     PBKDF2: IPBkdf2Consts;

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

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-ecies-lib/src/interfaces/constants.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAErD,MAAM,WAAW,UAAU;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAElB;;;;OAIG;IACH,gBAAgB,EAAE,MAAM,CAAC;IAEzB;;;;OAIG;IACH,gBAAgB,EAAE,MAAM,CAAC;IAEzB;;;;;;;;;;;;;;;OAeG;IACH,UAAU,EAAE,WAAW,CAAC;IAExB,QAAQ,EAAE,eAAe,CAAC;IAC1B,KAAK,EAAE,eAAe,CAAC;IACvB,MAAM,EAAE,aAAa,CAAC;IACtB,eAAe,EAAE,cAAc,CAAC;IAChC,MAAM,EAAE,aAAa,CAAC;IAEtB;;OAEG;IACH,YAAY,EAAE,MAAM,CAAC;IACrB;;OAEG;IACH,iBAAiB,EAAE,MAAM,CAAC;IAC1B;;OAEG;IACH,aAAa,EAAE,MAAM,CAAC;IACtB;;;OAGG;IACH,aAAa,EAAE,MAAM,CAAC;IACtB;;OAEG;IACH,iBAAiB,EAAE,MAAM,CAAC;CAC3B"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-ecies-lib/src/interfaces/constants.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAErD,MAAM,WAAW,UAAU;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAElB;;;;OAIG;IACH,gBAAgB,EAAE,MAAM,CAAC;IAEzB;;;;OAIG;IACH,gBAAgB,EAAE,MAAM,CAAC;IAEzB;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACH,UAAU,EAAE,eAAe,CAAC;IAE5B,QAAQ,EAAE,eAAe,CAAC;IAC1B,KAAK,EAAE,eAAe,CAAC;IACvB,MAAM,EAAE,aAAa,CAAC;IACtB,eAAe,EAAE,cAAc,CAAC;IAChC,MAAM,EAAE,aAAa,CAAC;IAEtB;;OAEG;IACH,YAAY,EAAE,MAAM,CAAC;IACrB;;OAEG;IACH,iBAAiB,EAAE,MAAM,CAAC;IAC1B;;OAEG;IACH,aAAa,EAAE,MAAM,CAAC;IACtB;;;OAGG;IACH,aAAa,EAAE,MAAM,CAAC;IACtB;;OAEG;IACH,iBAAiB,EAAE,MAAM,CAAC;CAC3B"}

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

@@ -1,8 +1,9 @@
 /**
- * Interface for ID providers that supply recipient identifiers.
- * This allows the library to support various ID formats (ObjectID, GUID, UUID, custom).
+ * Base interface for ID providers with Uint8Array-based operations.
+ * This non-generic interface is used by IConstants and validation functions
+ * that don't need to know the native ID type.
  */
-export interface IIdProvider {
+export interface IIdProviderBase {
     /**
      * The fixed byte length of IDs produced by this provider.
      * This determines the size of recipient ID fields in encrypted messages.
@@ -41,6 +42,32 @@ export interface IIdProvider {
      * @throws Error if the string is not a valid representation
      */
     deserialize(str: string): Uint8Array;
+    /**
+     * Convert any ID representation to canonical Uint8Array format.
+     * At the base level, accepts unknown and returns Uint8Array.
+     * @param id The ID in any supported format
+     * @returns The ID as a Uint8Array of length `byteLength`
+     */
+    toBytes(id: unknown): Uint8Array;
+    /**
+     * Convert Uint8Array to the provider's native representation.
+     * At the base level, returns unknown.
+     * @param bytes The ID as a Uint8Array
+     * @returns The ID in the provider's native format
+     */
+    fromBytes(bytes: Uint8Array): unknown;
+}
+/**
+ * Full interface for ID providers that supply recipient identifiers.
+ * This allows the library to support various ID formats (ObjectID, GUID, UUID, custom).
+ *
+ * The generic type T represents the provider's "native" ID type:
+ * - ObjectIdProvider: T = ObjectId
+ * - GuidV4Provider: T = GuidV4
+ * - UuidProvider: T = string
+ * - CustomIdProvider: T = Uint8Array
+ */
+export interface IIdProvider<T> extends IIdProviderBase {
     /**
      * Compare two IDs for equality.
      * Default implementation uses constant-time comparison.
@@ -48,39 +75,39 @@ export interface IIdProvider {
      * @param b Second ID
      * @returns True if IDs are equal, false otherwise
      */
-    equals(a: Uint8Array, b: Uint8Array): boolean;
+    equals(a: T, b: T): 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;
+    clone(id: T): T;
     /**
      * 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;
+    idToString(id: T): 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;
+    idFromString(str: string): T;
     /**
      * Convert any ID representation to canonical Uint8Array format.
      * @param id The ID in any supported format
      * @returns The ID as a Uint8Array of length `byteLength`
      */
-    toBytes(id: unknown): Uint8Array;
+    toBytes(id: T): Uint8Array;
     /**
      * Convert Uint8Array to the provider's native representation.
      * @param bytes The ID as a Uint8Array
      * @returns The ID in the provider's native format
      */
-    fromBytes(bytes: Uint8Array): unknown;
+    fromBytes(bytes: Uint8Array): T;
 }
 //# sourceMappingURL=id-provider.d.ts.map

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

@@ -1 +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;IAEtC;;;;OAIG;IACH,OAAO,CAAC,EAAE,EAAE,OAAO,GAAG,UAAU,CAAC;IAEjC;;;;OAIG;IACH,SAAS,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC;CACvC"}
+{"version":3,"file":"id-provider.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-ecies-lib/src/interfaces/id-provider.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B;;;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;;;;;OAKG;IACH,OAAO,CAAC,EAAE,EAAE,OAAO,GAAG,UAAU,CAAC;IAEjC;;;;;OAKG;IACH,SAAS,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC;CACvC;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,WAAW,CAAC,CAAC,CAAE,SAAQ,eAAe;IACrD;;;;;;OAMG;IACH,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC;IAE5B;;;;;OAKG;IACH,KAAK,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC;IAEhB;;;;;OAKG;IACH,UAAU,CAAC,EAAE,EAAE,CAAC,GAAG,MAAM,CAAC;IAE1B;;;;;OAKG;IACH,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,CAAC,CAAC;IAE7B;;;;OAIG;IACH,OAAO,CAAC,EAAE,EAAE,CAAC,GAAG,UAAU,CAAC;IAE3B;;;;OAIG;IACH,SAAS,CAAC,KAAK,EAAE,UAAU,GAAG,CAAC,CAAC;CACjC"}

package/src/interfaces/index.d.ts

@@ -6,6 +6,7 @@ export * from './ecies-consts';
 export * from './ecies-file-service';
 export * from './ecies-library';
 export * from './guid';
+export type { IIdProvider, IIdProviderBase } from './id-provider';
 export type * from './member';
 export * from './member-storage';
 export type * from './member-with-mnemonic';

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

@@ -1 +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,iBAAiB,CAAC;AAChC,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;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,OAAO,EACL,KAAK,KAAK,EACV,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,KAAK,wBAAwB,EAC7B,aAAa,GACd,MAAM,eAAe,CAAC;AACvB,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC"}
+{"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,iBAAiB,CAAC;AAChC,cAAc,QAAQ,CAAC;AACvB,YAAY,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAClE,mBAAmB,UAAU,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,mBAAmB,wBAAwB,CAAC;AAC5C,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,OAAO,EACL,KAAK,KAAK,EACV,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,KAAK,wBAAwB,EAC7B,aAAa,GACd,MAAM,eAAe,CAAC;AACvB,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC"}

package/src/interfaces/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-ecies-lib/src/interfaces/index.ts"],"names":[],"mappings":";;;;AAAA,4DAAkC;AAClC,4DAAkC;AAClC,sDAA4B;AAC5B,yDAA+B;AAC/B,yDAA+B;AAC/B,+DAAqC;AACrC,0DAAgC;AAChC,iDAAuB;AAEvB,2DAAiC;AAEjC,0DAAgC;AAChC,0DAAgC;AAChC,0DAAgC;AAChC,4DAAkC;AAClC,wDAA8B;AAC9B,0DAAgC;AAChC,6CAOuB;AADrB,4GAAA,aAAa,OAAA;AAEf,2DAAiC;AACjC,0DAAgC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-ecies-lib/src/interfaces/index.ts"],"names":[],"mappings":";;;;AAAA,4DAAkC;AAClC,4DAAkC;AAClC,sDAA4B;AAC5B,yDAA+B;AAC/B,yDAA+B;AAC/B,+DAAqC;AACrC,0DAAgC;AAChC,iDAAuB;AAGvB,2DAAiC;AAEjC,0DAAgC;AAChC,0DAAgC;AAChC,0DAAgC;AAChC,4DAAkC;AAClC,wDAA8B;AAC9B,0DAAgC;AAChC,6CAOuB;AADrB,4GAAA,aAAa,OAAA;AAEf,2DAAiC;AACjC,0DAAgC"}

package/src/lib/base-id-provider.d.ts

@@ -1,8 +1,11 @@
 import type { IIdProvider } from '../interfaces/id-provider';
 /**
  * Base class for ID providers with common utility methods.
+ *
+ * Subclasses must implement all abstract methods for their specific ID type.
+ * For providers where T = Uint8Array, see ByteIdProvider for a concrete base.
  */
-export declare abstract class BaseIdProvider implements IIdProvider {
+export declare abstract class BaseIdProvider<T> implements IIdProvider<T> {
     abstract readonly byteLength: number;
     abstract readonly name: string;
     abstract generate(): Uint8Array;
@@ -10,36 +13,40 @@ export declare abstract class BaseIdProvider implements IIdProvider {
     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().
+     * Create a defensive copy of an ID.
      */
-    idToString(id: unknown): string;
+    abstract clone(id: T): T;
     /**
-     * Convert a string representation of an ID back to an ID buffer.
-     * Default implementation delegates to `deserialize`.
+     * Convert Uint8Array to the provider's native representation.
      */
-    idFromString(str: string): Uint8Array;
+    abstract fromBytes(bytes: Uint8Array): T;
     /**
-     * Convert any ID representation to canonical Uint8Array format.
-     * Default implementation handles common types.
+     * Convert the provider's native representation to Uint8Array.
      */
-    toBytes(id: unknown): Uint8Array;
+    abstract toBytes(id: T): Uint8Array;
     /**
-     * Convert Uint8Array to the provider's native representation.
-     * Default implementation returns Uint8Array (no conversion).
+     * Compare two IDs for equality.
+     * Subclasses should implement constant-time comparison where possible.
      */
-    fromBytes(bytes: Uint8Array): unknown;
+    abstract equals(a: T, b: T): boolean;
     /**
-     * Constant-time comparison to prevent timing attacks.
+     * Convert an ID to a string representation.
+     * Default implementation delegates to serialize().
      */
-    equals(a: Uint8Array, b: Uint8Array): boolean;
+    idToString(id: T): string;
     /**
-     * Create a defensive copy of an ID.
+     * Convert a string representation of an ID back to the native type.
+     * Default implementation delegates to deserialize().
      */
-    clone(id: Uint8Array): Uint8Array;
+    idFromString(str: string): T;
     /**
      * Validate ID length matches expected byte length.
      */
     protected validateLength(id: Uint8Array, context: string): void;
+    /**
+     * Constant-time comparison for Uint8Array buffers.
+     * Utility method for subclasses to use in their equals() implementation.
+     */
+    protected constantTimeEquals(a: Uint8Array, b: Uint8Array): boolean;
 }
 //# sourceMappingURL=base-id-provider.d.ts.map

package/src/lib/base-id-provider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"base-id-provider.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-ecies-lib/src/lib/base-id-provider.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAE7D;;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;;;OAGG;IACH,OAAO,CAAC,EAAE,EAAE,OAAO,GAAG,UAAU;IAWhC;;;OAGG;IACH,SAAS,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO;IAKrC;;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;CAUhE"}
+{"version":3,"file":"base-id-provider.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-ecies-lib/src/lib/base-id-provider.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAE7D;;;;;GAKG;AACH,8BAAsB,cAAc,CAAC,CAAC,CAAE,YAAW,WAAW,CAAC,CAAC,CAAC;IAC/D,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;;OAEG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC;IAExB;;OAEG;IACH,QAAQ,CAAC,SAAS,CAAC,KAAK,EAAE,UAAU,GAAG,CAAC;IAExC;;OAEG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,EAAE,CAAC,GAAG,UAAU;IAEnC;;;OAGG;IACH,QAAQ,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,GAAG,OAAO;IAEpC;;;OAGG;IACH,UAAU,CAAC,EAAE,EAAE,CAAC,GAAG,MAAM;IAIzB;;;OAGG;IACH,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,CAAC;IAI5B;;OAEG;IACH,SAAS,CAAC,cAAc,CAAC,EAAE,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAW/D;;;OAGG;IACH,SAAS,CAAC,kBAAkB,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,UAAU,GAAG,OAAO;CAUpE"}

package/src/lib/base-id-provider.js

@@ -5,51 +5,38 @@ const id_provider_error_type_1 = require("../enumerations/id-provider-error-type
 const id_provider_1 = require("../errors/id-provider");
 /**
  * Base class for ID providers with common utility methods.
+ *
+ * Subclasses must implement all abstract methods for their specific ID type.
+ * For providers where T = Uint8Array, see ByteIdProvider for a concrete base.
  */
 class BaseIdProvider {
     /**
-     * Convert an ID of unknown type to a string representation.
-     * Default implementation handles Uint8Array using serialize(), and falls back to String().
+     * Convert an ID to a string representation.
+     * Default implementation delegates to serialize().
      */
     idToString(id) {
-        if (id instanceof Uint8Array) {
-            return this.serialize(id);
-        }
-        return String(id);
+        return this.serialize(this.toBytes(id));
     }
     /**
-     * Convert a string representation of an ID back to an ID buffer.
-     * Default implementation delegates to `deserialize`.
+     * Convert a string representation of an ID back to the native type.
+     * Default implementation delegates to deserialize().
      */
     idFromString(str) {
-        return this.deserialize(str);
+        return this.fromBytes(this.deserialize(str));
     }
     /**
-     * Convert any ID representation to canonical Uint8Array format.
-     * Default implementation handles common types.
+     * Validate ID length matches expected byte length.
      */
-    toBytes(id) {
-        if (id instanceof Uint8Array) {
-            return this.clone(id);
-        }
-        if (typeof id === 'string') {
-            return this.deserialize(id);
+    validateLength(id, context) {
+        if (id.length !== this.byteLength) {
+            throw new id_provider_1.IdProviderError(id_provider_error_type_1.IdProviderErrorType.InvalidLength, undefined, undefined, { context, expected: this.byteLength, actual: id.length });
         }
-        // For other types, convert to string first then deserialize
-        return this.deserialize(String(id));
     }
     /**
-     * Convert Uint8Array to the provider's native representation.
-     * Default implementation returns Uint8Array (no conversion).
+     * Constant-time comparison for Uint8Array buffers.
+     * Utility method for subclasses to use in their equals() implementation.
      */
-    fromBytes(bytes) {
-        this.validateLength(bytes, 'BaseIdProvider.fromBytes');
-        return this.clone(bytes);
-    }
-    /**
-     * Constant-time comparison to prevent timing attacks.
-     */
-    equals(a, b) {
+    constantTimeEquals(a, b) {
         if (a.length !== b.length) {
             return false;
         }
@@ -59,20 +46,6 @@ class BaseIdProvider {
         }
         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) {
-            throw new id_provider_1.IdProviderError(id_provider_error_type_1.IdProviderErrorType.InvalidLength, undefined, undefined, { context, expected: this.byteLength, actual: id.length });
-        }
-    }
 }
 exports.BaseIdProvider = BaseIdProvider;
 //# sourceMappingURL=base-id-provider.js.map

package/src/lib/base-id-provider.js.map

@@ -1 +1 @@
-{"version":3,"file":"base-id-provider.js","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-ecies-lib/src/lib/base-id-provider.ts"],"names":[],"mappings":";;;AAAA,mFAA6E;AAC7E,uDAAwD;AAGxD;;GAEG;AACH,MAAsB,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;;;OAGG;IACH,OAAO,CAAC,EAAW;QACjB,IAAI,EAAE,YAAY,UAAU,EAAE,CAAC;YAC7B,OAAO,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACxB,CAAC;QACD,IAAI,OAAO,EAAE,KAAK,QAAQ,EAAE,CAAC;YAC3B,OAAO,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;QAC9B,CAAC;QACD,4DAA4D;QAC5D,OAAO,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;IACtC,CAAC;IAED;;;OAGG;IACH,SAAS,CAAC,KAAiB;QACzB,IAAI,CAAC,cAAc,CAAC,KAAK,EAAE,0BAA0B,CAAC,CAAC;QACvD,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAC3B,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,IAAI,6BAAe,CACvB,4CAAmB,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;AAvFD,wCAuFC"}
+{"version":3,"file":"base-id-provider.js","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-ecies-lib/src/lib/base-id-provider.ts"],"names":[],"mappings":";;;AAAA,mFAA6E;AAC7E,uDAAwD;AAGxD;;;;;GAKG;AACH,MAAsB,cAAc;IA8BlC;;;OAGG;IACH,UAAU,CAAC,EAAK;QACd,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC;IAC1C,CAAC;IAED;;;OAGG;IACH,YAAY,CAAC,GAAW;QACtB,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC;IAC/C,CAAC;IAED;;OAEG;IACO,cAAc,CAAC,EAAc,EAAE,OAAe;QACtD,IAAI,EAAE,CAAC,MAAM,KAAK,IAAI,CAAC,UAAU,EAAE,CAAC;YAClC,MAAM,IAAI,6BAAe,CACvB,4CAAmB,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;IAED;;;OAGG;IACO,kBAAkB,CAAC,CAAa,EAAE,CAAa;QACvD,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,MAAM,EAAE,CAAC;YAC1B,OAAO,KAAK,CAAC;QACf,CAAC;QACD,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;CACF;AA1ED,wCA0EC"}

package/src/lib/guid.d.ts

@@ -45,6 +45,14 @@ export declare class GuidV4 implements IGuidV4 {
      * Regex for validating full hex GUID format
      */
     private static readonly FULL_HEX_PATTERN;
+    /**
+     * Type guard to check if a value is a Uint8Array
+     */
+    private static isUint8Array;
+    /**
+     * Type guard to check if a value is a Buffer or Uint8Array
+     */
+    private static isBufferLike;
     /**
      * Cached empty/nil GUID constant (all zeros)
      */
@@ -143,6 +151,14 @@ export declare class GuidV4 implements IGuidV4 {
      * @returns A new GuidV4 instance
      */
     static fromBuffer(buffer: Uint8Array): GuidV4;
+    /**
+     * Factory method to create a GUID from a raw Uint8Array.
+     * This is an explicit alias for fromBuffer(), provided for clarity when working
+     * with browser environments where Uint8Array is the native binary type.
+     * @param bytes The raw 16-byte Uint8Array
+     * @returns A new GuidV4 instance
+     */
+    static fromUint8Array(bytes: Uint8Array): GuidV4;
     /**
      * Creates a namespace-based v3 GUID (MD5 hash).
      * Use this for deterministic GUIDs based on a namespace and name.

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

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

package/src/lib/guid.js

@@ -55,6 +55,18 @@ class GuidV4 {
      * Regex for validating full hex GUID format
      */
     static FULL_HEX_PATTERN = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+    /**
+     * Type guard to check if a value is a Uint8Array
+     */
+    static isUint8Array(value) {
+        return value instanceof Uint8Array;
+    }
+    /**
+     * Type guard to check if a value is a Buffer or Uint8Array
+     */
+    static isBufferLike(value) {
+        return buffer_compat_1.Buffer.isBuffer(value) || GuidV4.isUint8Array(value);
+    }
     /**
      * Cached empty/nil GUID constant (all zeros)
      */
@@ -128,7 +140,16 @@ class GuidV4 {
             // Convert to raw buffer
             const buffer = GuidV4.toRawGuidBuffer(value);
             // Validate against UUID standard (skip for boundary values)
-            const fullHex = GuidV4.toFullHexGuid(buffer.toString('hex'));
+            let hexString;
+            if (GuidV4.isUint8Array(buffer) && !buffer_compat_1.Buffer.isBuffer(buffer)) {
+                hexString = Array.from(buffer)
+                    .map((b) => b.toString(16).padStart(2, '0'))
+                    .join('');
+            }
+            else {
+                hexString = buffer.toString('hex');
+            }
+            const fullHex = GuidV4.toFullHexGuid(hexString);
             const isBoundary = GuidV4.isBoundaryValue(fullHex);
             if (!isBoundary && !uuid.validate(fullHex)) {
                 throw new guid_1.GuidError(guid_error_type_1.GuidErrorType.InvalidGuid, expectedBrand, undefined, buffer);
@@ -307,6 +328,16 @@ class GuidV4 {
     static fromBuffer(buffer) {
         return new GuidV4(buffer);
     }
+    /**
+     * Factory method to create a GUID from a raw Uint8Array.
+     * This is an explicit alias for fromBuffer(), provided for clarity when working
+     * with browser environments where Uint8Array is the native binary type.
+     * @param bytes The raw 16-byte Uint8Array
+     * @returns A new GuidV4 instance
+     */
+    static fromUint8Array(bytes) {
+        return new GuidV4(bytes);
+    }
     /**
      * Creates a namespace-based v3 GUID (MD5 hash).
      * Use this for deterministic GUIDs based on a namespace and name.
@@ -373,7 +404,16 @@ class GuidV4 {
      */
     get asFullHexGuid() {
         if (!this._cachedFullHex) {
-            this._cachedFullHex = GuidV4.toFullHexGuid(this._value.toString('hex'));
+            let hexString;
+            if (GuidV4.isUint8Array(this._value) && !buffer_compat_1.Buffer.isBuffer(this._value)) {
+                hexString = Array.from(this._value)
+                    .map((b) => b.toString(16).padStart(2, '0'))
+                    .join('');
+            }
+            else {
+                hexString = this._value.toString('hex');
+            }
+            this._cachedFullHex = GuidV4.toFullHexGuid(hexString);
         }
         return this._cachedFullHex;
     }
@@ -554,7 +594,7 @@ class GuidV4 {
             if (typeof value === 'bigint') {
                 valueLength = value.toString(16).length;
             }
-            else if (buffer_compat_1.Buffer.isBuffer(value)) {
+            else if (GuidV4.isBufferLike(value)) {
                 valueLength = value.length;
             }
             else {
@@ -564,7 +604,16 @@ class GuidV4 {
             if (result) {
                 try {
                     const fromBase64 = GuidV4.toRawGuidBuffer(value);
-                    const fullHexGuid = GuidV4.toFullHexGuid(fromBase64.toString('hex'));
+                    let hexString;
+                    if (GuidV4.isUint8Array(fromBase64) && !buffer_compat_1.Buffer.isBuffer(fromBase64)) {
+                        hexString = Array.from(fromBase64)
+                            .map((b) => b.toString(16).padStart(2, '0'))
+                            .join('');
+                    }
+                    else {
+                        hexString = fromBase64.toString('hex');
+                    }
+                    const fullHexGuid = GuidV4.toFullHexGuid(hexString);
                     // Boundary values are always valid
                     if (GuidV4.isBoundaryValue(fullHexGuid)) {
                         return true;
@@ -596,7 +645,7 @@ class GuidV4 {
             if (typeof value === 'bigint') {
                 valueLength = value.toString(16).length;
             }
-            else if (buffer_compat_1.Buffer.isBuffer(value)) {
+            else if (GuidV4.isBufferLike(value)) {
                 valueLength = value.length;
             }
             else {
@@ -606,10 +655,19 @@ class GuidV4 {
                 return false;
             }
             try {
-                if (!buffer_compat_1.Buffer.isBuffer(value)) {
+                if (!GuidV4.isBufferLike(value)) {
                     return false;
                 }
-                const fullHexGuid = GuidV4.toFullHexGuid(value.toString('hex'));
+                let hexString;
+                if (GuidV4.isUint8Array(value) && !buffer_compat_1.Buffer.isBuffer(value)) {
+                    hexString = Array.from(value)
+                        .map((b) => b.toString(16).padStart(2, '0'))
+                        .join('');
+                }
+                else {
+                    hexString = value.toString('hex');
+                }
+                const fullHexGuid = GuidV4.toFullHexGuid(hexString);
                 // Boundary values are always valid
                 if (GuidV4.isBoundaryValue(fullHexGuid)) {
                     return true;
@@ -668,8 +726,10 @@ class GuidV4 {
         if (typeof value === 'bigint') {
             return guid_brand_type_1.GuidBrandType.BigIntGuid;
         }
-        const isBuffer = buffer_compat_1.Buffer.isBuffer(value);
-        const expectedLength = isBuffer ? value.length : String(value).length;
+        const isBuffer = GuidV4.isBufferLike(value);
+        const expectedLength = isBuffer
+            ? value.length
+            : String(value).length;
         return GuidV4.lengthToGuidBrand(expectedLength, isBuffer);
     }
     /**
@@ -694,12 +754,21 @@ class GuidV4 {
         if (typeof guid === 'bigint') {
             return GuidV4.toFullHexFromBigInt(guid);
         }
-        else if (buffer_compat_1.Buffer.isBuffer(guid) &&
+        else if (GuidV4.isBufferLike(guid) &&
             guid.length === GuidV4.guidBrandToLength(guid_brand_type_1.GuidBrandType.RawGuidBuffer)) {
-            const shortHex = guid.toString('hex');
+            let hexString;
+            if (GuidV4.isUint8Array(guid) && !buffer_compat_1.Buffer.isBuffer(guid)) {
+                hexString = Array.from(guid)
+                    .map((b) => b.toString(16).padStart(2, '0'))
+                    .join('');
+            }
+            else {
+                hexString = guid.toString('hex');
+            }
+            const shortHex = hexString;
             return GuidV4.shortGuidToFullGuid(shortHex);
         }
-        else if (buffer_compat_1.Buffer.isBuffer(guid)) {
+        else if (GuidV4.isBufferLike(guid)) {
             throw new guid_1.GuidError(guid_error_type_1.GuidErrorType.InvalidGuid);
         }
         // all remaining cases are string types
@@ -729,11 +798,18 @@ class GuidV4 {
             const fullHex = GuidV4.toFullHexFromBigInt(guid);
             return fullHex.replace(/-/g, '');
         }
-        else if (buffer_compat_1.Buffer.isBuffer(guid) &&
+        else if (GuidV4.isBufferLike(guid) &&
             guid.length === GuidV4.guidBrandToLength(guid_brand_type_1.GuidBrandType.RawGuidBuffer)) {
-            return guid.toString('hex');
+            if (GuidV4.isUint8Array(guid) && !buffer_compat_1.Buffer.isBuffer(guid)) {
+                return Array.from(guid)
+                    .map((b) => b.toString(16).padStart(2, '0'))
+                    .join('');
+            }
+            else {
+                return guid.toString('hex');
+            }
         }
-        else if (buffer_compat_1.Buffer.isBuffer(guid)) {
+        else if (GuidV4.isBufferLike(guid)) {
             throw new guid_1.GuidError(guid_error_type_1.GuidErrorType.InvalidGuid);
         }
         // all remaining cases are string types