@digitaldefiance/ecies-lib 4.10.7 → 4.11.0

package/README.md

@@ -8,7 +8,7 @@ Production-ready, browser-compatible ECIES (Elliptic Curve Integrated Encryption
 
 Part of [Express Suite](https://github.com/Digital-Defiance/express-suite)
 
-**Current Version: v4.10.6**
+**Current Version: v4.10.7**
 
 This library implements a modern, enterprise-grade ECIES protocol (v4.0) featuring HKDF key derivation, AAD binding, and optimized multi-recipient encryption. It includes a pluggable ID provider system with PlatformID support, memory-efficient streaming encryption, comprehensive internationalization, and a complete cryptographic voting system with 15+ voting methods.
 
@@ -47,6 +47,7 @@ This library implements a modern, enterprise-grade ECIES protocol (v4.0) featuri
   - **PlatformID Type**: Generic type system supporting `Uint8Array | GuidV4 | ObjectId | string`
   - **Auto-Sync**: Configuration automatically adapts all cryptographic constants to the selected ID provider
   - **Member System**: User abstraction with cryptographic operations, fully integrated with the configured ID provider
+  - **Strong Typing**: New typed configuration system provides compile-time type safety for ID operations
 - **Key Management**:
   - **BIP39**: Mnemonic phrase generation (12-24 words).
   - **HD Wallets**: BIP32/BIP44 hierarchical deterministic derivation.
@@ -201,7 +202,8 @@ import {
   ECIESService, 
   getEciesI18nEngine, 
   createRuntimeConfiguration, 
-  ObjectIdProvider 
+  ObjectIdProvider,
+  getEnhancedIdProvider
 } from '@digitaldefiance/ecies-lib';
 
 // 1. Initialize i18n (required once)
@@ -227,6 +229,12 @@ const encrypted = await ecies.encryptSimpleOrSingle(false, publicKey, message);
 const decrypted = await ecies.decryptSimpleOrSingleWithHeader(false, privateKey, encrypted);
 
 console.log(new TextDecoder().decode(decrypted)); // "Hello, Secure World!"
+
+// 6. Strong Typing for ID Operations (NEW!)
+const idProvider = getEnhancedIdProvider<ObjectId>();
+const objectId = idProvider.generateTyped(); // Returns ObjectId - strongly typed!
+const serialized = idProvider.serializeTyped(objectId); // Accepts ObjectId directly
+const deserialized = idProvider.deserializeTyped(serialized); // Returns ObjectId
 ```
 
 ## Cryptographic Voting System
@@ -394,7 +402,55 @@ VotingSecurityValidator.validate(VotingMethod.Quadratic); // Throws error
 VotingSecurityValidator.validate(VotingMethod.Quadratic, { allowInsecure: true });
 ```
 
-### 2. Using Custom ID Providers (e.g., GUID)
+### 2. Strong Typing for ID Providers (NEW!)
+
+The library now provides strongly-typed alternatives to the weak typing pattern `Constants.idProvider.generate()`:
+
+```typescript
+import { 
+  getRuntimeConfiguration,
+  getEnhancedIdProvider,
+  getTypedIdProvider,
+  createObjectIdConfiguration
+} from '@digitaldefiance/ecies-lib';
+import { ObjectId } from 'bson';
+
+// BEFORE: Weak typing (still works for compatibility)
+const Constants = getRuntimeConfiguration();
+const rawBytes = Constants.idProvider.generate(); // Returns Uint8Array, no strong typing
+const nativeId = Constants.idProvider.fromBytes(rawBytes); // Returns unknown, requires casting
+
+// AFTER: Strong typing - Option 1 (Enhanced Provider - Recommended)
+const enhancedProvider = getEnhancedIdProvider<ObjectId>();
+
+// Original methods still work exactly the same
+const rawBytes2 = enhancedProvider.generate(); // Uint8Array (same as before)
+const isValid = enhancedProvider.validate(rawBytes2); // boolean (same as before)
+
+// Plus new strongly-typed methods
+const objectId = enhancedProvider.generateTyped(); // ObjectId - strongly typed!
+const validTyped = enhancedProvider.validateTyped(objectId); // boolean, accepts ObjectId
+const serialized = enhancedProvider.serializeTyped(objectId); // string, accepts ObjectId
+const deserialized = enhancedProvider.deserializeTyped(serialized); // ObjectId
+
+// AFTER: Strong typing - Option 2 (Simple Typed Provider)
+const typedProvider = getTypedIdProvider<ObjectId>();
+const bytes = typedProvider.generate();
+const typedId = typedProvider.fromBytes(bytes); // Returns ObjectId, not unknown!
+
+// AFTER: Strong typing - Option 3 (Configuration Wrapper)
+const config = createObjectIdConfiguration();
+const configId = config.generateId(); // ObjectId directly!
+const configValid = config.validateId(configId); // boolean, accepts ObjectId
+```
+
+**Benefits:**
+- ✅ **Full IntelliSense** - Autocomplete for native ID methods (`objectId.toHexString()`)
+- ✅ **Compile-time checking** - Prevents type mismatches at build time
+- ✅ **Zero breaking changes** - All existing code continues to work
+- ✅ **Multiple migration paths** - Choose the approach that fits your use case
+
+### 3. Using Custom ID Providers (e.g., GUID)
 
 ```typescript
 import { 
@@ -413,7 +469,7 @@ const ecies = new ECIESService(config);
 const id = config.idProvider.generate(); // Returns 16-byte Uint8Array
 ```
 
-### 3. Streaming Encryption (Large Files)
+### 4. Streaming Encryption (Large Files)
 
 Encrypt gigabytes of data with minimal memory footprint (<10MB).
 
@@ -437,7 +493,7 @@ async function processFile(fileStream: ReadableStream, publicKey: Uint8Array) {
 }
 ```
 
-### 4. Member System
+### 5. Member System
 
 The `Member` class provides a high-level user abstraction that integrates keys, IDs, and encryption.
 
@@ -973,6 +1029,27 @@ class MemberService {
   - `get(key)`: Retrieve a configuration.
 - **`createRuntimeConfiguration(overrides)`**: Creates a validated configuration object with your overrides.
 
+### Strong Typing System (NEW!)
+
+- **`getEnhancedIdProvider<T>(key?)`**: Get a strongly-typed ID provider with enhanced convenience methods
+  - Drop-in replacement for `Constants.idProvider` with both original and typed methods
+  - `generateTyped()`: Generate ID with native type (e.g., `ObjectId`)
+  - `validateTyped(id)`: Validate ID with native type
+  - `serializeTyped(id)`: Serialize ID with native type
+  - `deserializeTyped(str)`: Deserialize to native type
+- **`getTypedIdProvider<T>(key?)`**: Get a simple strongly-typed ID provider
+  - Minimal API surface with type-safe conversions
+  - `fromBytes(bytes)`: Returns native type instead of `unknown`
+- **`createObjectIdConfiguration(overrides?)`**: Create ObjectId-typed configuration
+- **`createGuidV4Configuration(overrides?)`**: Create GuidV4-typed configuration
+- **`createUint8ArrayConfiguration(overrides?)`**: Create Uint8Array-typed configuration
+- **`createUuidConfiguration(overrides?)`**: Create UUID string-typed configuration
+- **`TypedConfiguration<T>`**: Configuration wrapper with strongly-typed ID operations
+  - `generateId()`: Generate ID with native type
+  - `validateId(id)`: Validate ID with native type
+  - `serializeId(id)`: Serialize ID with native type
+  - `deserializeId(str)`: Deserialize to native type
+
 ### Secure Primitives
 
 - **`SecureString` / `SecureBuffer`**:
@@ -1181,6 +1258,59 @@ The library maintains **100% test coverage** with over 1,200 tests, including:
 
 ## ChangeLog
 
+### v4.10.7 - Strong Typing for ID Providers
+
+**Major Features:**
+- **Strong Typing System**: Added comprehensive strong typing solution for ID provider operations
+  - `getEnhancedIdProvider<T>()`: Drop-in replacement for `Constants.idProvider` with typed methods
+  - `getTypedIdProvider<T>()`: Simple typed provider for minimal API surface
+  - `createObjectIdConfiguration()`: ObjectId-typed configuration factory
+  - `TypedConfiguration<T>`: Configuration wrapper with strongly-typed ID operations
+- **Enhanced Developer Experience**: 
+  - Full IntelliSense support for native ID types (`ObjectId`, `GuidV4`, `string`, etc.)
+  - Compile-time type checking prevents runtime type errors
+  - Multiple migration paths to choose from based on use case
+- **Zero Breaking Changes**: All existing code continues to work unchanged
+  - Original `Constants.idProvider` pattern still supported
+  - Enhanced providers include all original methods plus typed alternatives
+  - Backward compatibility maintained for all existing APIs
+
+**New APIs:**
+- `getEnhancedIdProvider<T>(key?)`: Enhanced provider with typed convenience methods
+- `getTypedIdProvider<T>(key?)`: Simple typed provider
+- `createObjectIdConfiguration(overrides?)`: ObjectId-typed configuration
+- `createGuidV4Configuration(overrides?)`: GuidV4-typed configuration  
+- `createUint8ArrayConfiguration(overrides?)`: Uint8Array-typed configuration
+- `createUuidConfiguration(overrides?)`: UUID string-typed configuration
+- `TypedIdProviderWrapper<T>`: Enhanced wrapper with typed methods
+
+**Migration Examples:**
+```typescript
+// BEFORE: Weak typing
+const Constants = getRuntimeConfiguration();
+const id = Constants.idProvider.generate(); // Uint8Array, no strong typing
+
+// AFTER: Strong typing (multiple options)
+const enhancedProvider = getEnhancedIdProvider<ObjectId>();
+const objectId = enhancedProvider.generateTyped(); // ObjectId - strongly typed!
+
+const typedProvider = getTypedIdProvider<ObjectId>();
+const typedId = typedProvider.fromBytes(bytes); // ObjectId, not unknown!
+
+const config = createObjectIdConfiguration();
+const configId = config.generateId(); // ObjectId directly!
+```
+
+**Documentation:**
+- Added comprehensive migration guide (`src/migration-guide.md`)
+- Updated README with strong typing examples
+- Added usage examples and real-world migration patterns
+
+**Testing:**
+- 14 new tests covering all strong typing scenarios
+- Property-based tests for type safety validation
+- Migration pattern tests for backward compatibility
+
 ### v4.10.6 - Voting System & PlatformID Integration
 
 **Major Features:**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@digitaldefiance/ecies-lib",
-  "version": "4.10.7",
+  "version": "4.11.0",
   "description": "Digital Defiance ECIES Library",
   "homepage": "https://github.com/Digital-Defiance/ecies-lib",
   "repository": {

package/src/enumerations/guid-brand-type.d.ts

@@ -22,6 +22,6 @@ export declare enum GuidBrandType {
     /**
      * Raw Guid, in a buffer, 16 bytes
      */
-    RawGuidBuffer = "RawGuidBuffer"
+    RawGuidPlatformBuffer = "RawGuidPlatformBuffer"
 }
 //# sourceMappingURL=guid-brand-type.d.ts.map

package/src/enumerations/guid-brand-type.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"guid-brand-type.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-ecies-lib/src/enumerations/guid-brand-type.ts"],"names":[],"mappings":"AAAA,oBAAY,aAAa;IACvB,OAAO,YAAY;IACnB;;;OAGG;IACH,WAAW,gBAAgB;IAC3B;;;OAGG;IACH,YAAY,iBAAiB;IAC7B;;;OAGG;IACH,UAAU,eAAe;IACzB;;OAEG;IACH,UAAU,eAAe;IACzB;;OAEG;IACH,aAAa,kBAAkB;CAChC"}
+{"version":3,"file":"guid-brand-type.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-ecies-lib/src/enumerations/guid-brand-type.ts"],"names":[],"mappings":"AAAA,oBAAY,aAAa;IACvB,OAAO,YAAY;IACnB;;;OAGG;IACH,WAAW,gBAAgB;IAC3B;;;OAGG;IACH,YAAY,iBAAiB;IAC7B;;;OAGG;IACH,UAAU,eAAe;IACzB;;OAEG;IACH,UAAU,eAAe;IACzB;;OAEG;IACH,qBAAqB,0BAA0B;CAChD"}

package/src/enumerations/guid-brand-type.js

@@ -26,6 +26,6 @@ var GuidBrandType;
     /**
      * Raw Guid, in a buffer, 16 bytes
      */
-    GuidBrandType["RawGuidBuffer"] = "RawGuidBuffer";
+    GuidBrandType["RawGuidPlatformBuffer"] = "RawGuidPlatformBuffer";
 })(GuidBrandType || (exports.GuidBrandType = GuidBrandType = {}));
 //# sourceMappingURL=guid-brand-type.js.map

package/src/enumerations/guid-brand-type.js.map

@@ -1 +1 @@
-{"version":3,"file":"guid-brand-type.js","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-ecies-lib/src/enumerations/guid-brand-type.ts"],"names":[],"mappings":";;;AAAA,IAAY,aAyBX;AAzBD,WAAY,aAAa;IACvB,oCAAmB,CAAA;IACnB;;;OAGG;IACH,4CAA2B,CAAA;IAC3B;;;OAGG;IACH,8CAA6B,CAAA;IAC7B;;;OAGG;IACH,0CAAyB,CAAA;IACzB;;OAEG;IACH,0CAAyB,CAAA;IACzB;;OAEG;IACH,gDAA+B,CAAA;AACjC,CAAC,EAzBW,aAAa,6BAAb,aAAa,QAyBxB"}
+{"version":3,"file":"guid-brand-type.js","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-ecies-lib/src/enumerations/guid-brand-type.ts"],"names":[],"mappings":";;;AAAA,IAAY,aAyBX;AAzBD,WAAY,aAAa;IACvB,oCAAmB,CAAA;IACnB;;;OAGG;IACH,4CAA2B,CAAA;IAC3B;;;OAGG;IACH,8CAA6B,CAAA;IAC7B;;;OAGG;IACH,0CAAyB,CAAA;IACzB;;OAEG;IACH,0CAAyB,CAAA;IACzB;;OAEG;IACH,gEAA+C,CAAA;AACjD,CAAC,EAzBW,aAAa,6BAAb,aAAa,QAyBxB"}

package/src/errors/guid.d.ts

@@ -2,7 +2,7 @@ import { TypedHandleableError } from '@digitaldefiance/i18n-lib';
 import { EciesStringKey } from '../enumerations';
 import { GuidBrandType } from '../enumerations/guid-brand-type';
 import { GuidErrorType } from '../enumerations/guid-error-type';
-import { RawGuidBuffer } from '../types';
+import type { RawGuidPlatformBuffer } from '../types';
 /**
  * Error class for handling GUID-related errors.
  * Provides detailed error information including the error type, optional brand, length, and GUID value.
@@ -17,7 +17,7 @@ import { RawGuidBuffer } from '../types';
 export declare class GuidError extends TypedHandleableError<typeof GuidErrorType, EciesStringKey> {
     readonly brand?: GuidBrandType | undefined;
     readonly length?: number | undefined;
-    readonly guid?: (RawGuidBuffer | Uint8Array) | undefined;
+    readonly guid?: (RawGuidPlatformBuffer | Uint8Array) | undefined;
     /**
      * Reason map cache to avoid rebuilding on every error instantiation.
      * This improves performance in scenarios where many errors are created.
@@ -34,7 +34,7 @@ export declare class GuidError extends TypedHandleableError<typeof GuidErrorType
      *
      * @throws {Error} If guid parameter is provided but is not a Buffer.
      */
-    constructor(type: GuidErrorType, brand?: GuidBrandType | undefined, length?: number | undefined, guid?: (RawGuidBuffer | Uint8Array) | undefined, language?: string);
+    constructor(type: GuidErrorType, brand?: GuidBrandType | undefined, length?: number | undefined, guid?: (RawGuidPlatformBuffer | Uint8Array) | undefined, language?: string);
     /**
      * Returns a string representation of the error with all relevant details.
      * @returns A detailed error string.

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

@@ -1 +1 @@
-{"version":3,"file":"guid.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-ecies-lib/src/errors/guid.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,oBAAoB,EACrB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AAChE,OAAO,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AAGhE,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC;;;;;;;;;;GAUG;AACH,qBAAa,SAAU,SAAQ,oBAAoB,CACjD,OAAO,aAAa,EACpB,cAAc,CACf;aA+BmB,KAAK,CAAC,EAAE,aAAa;aACrB,MAAM,CAAC,EAAE,MAAM;aACf,IAAI,CAAC,GAAE,aAAa,GAAG,UAAU;IAhCnD;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,UAAU,CAWhC;IAEF;;;;;;;;;;OAUG;gBAED,IAAI,EAAE,aAAa,EACH,KAAK,CAAC,EAAE,aAAa,YAAA,EACrB,MAAM,CAAC,EAAE,MAAM,YAAA,EACf,IAAI,CAAC,GAAE,aAAa,GAAG,UAAU,aAAA,EACjD,QAAQ,CAAC,EAAE,MAAM;IAoCnB;;;OAGG;IACa,QAAQ,IAAI,MAAM;IAkBlC;;;OAGG;IACa,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CASlD"}
+{"version":3,"file":"guid.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-ecies-lib/src/errors/guid.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,oBAAoB,EACrB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AAChE,OAAO,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AAGhE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,UAAU,CAAC;AAEtD;;;;;;;;;;GAUG;AACH,qBAAa,SAAU,SAAQ,oBAAoB,CACjD,OAAO,aAAa,EACpB,cAAc,CACf;aA+BmB,KAAK,CAAC,EAAE,aAAa;aACrB,MAAM,CAAC,EAAE,MAAM;aACf,IAAI,CAAC,GAAE,qBAAqB,GAAG,UAAU;IAhC3D;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,UAAU,CAWhC;IAEF;;;;;;;;;;OAUG;gBAED,IAAI,EAAE,aAAa,EACH,KAAK,CAAC,EAAE,aAAa,YAAA,EACrB,MAAM,CAAC,EAAE,MAAM,YAAA,EACf,IAAI,CAAC,GAAE,qBAAqB,GAAG,UAAU,aAAA,EACzD,QAAQ,CAAC,EAAE,MAAM;IAoCnB;;;OAGG;IACa,QAAQ,IAAI,MAAM;IAkBlC;;;OAGG;IACa,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CASlD"}

package/src/errors/guid.js.map

@@ -1 +1 @@
-{"version":3,"file":"guid.js","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-ecies-lib/src/errors/guid.ts"],"names":[],"mappings":";;;AAAA,wDAGmC;AAGnC,qEAAgE;AAChE,8CAAiD;AACjD,wDAA8C;AAG9C;;;;;;;;;;GAUG;AACH,MAAa,SAAU,SAAQ,+BAG9B;IA+BmB;IACA;IACA;IAhClB;;;OAGG;IACK,MAAM,CAAU,UAAU,GAAG,IAAA,yBAAc,EAIjD,+BAAa,EACb,CAAC,OAAO,EAAE,WAAW,CAAC,EACtB,IAAI,GAAG,CAAC;QACN,+BAAa,CAAC,sBAAsB;QACpC,+BAAa,CAAC,uBAAuB;QACrC,+BAAa,CAAC,wBAAwB;KACvC,CAAC,CACH,CAAC;IAEF;;;;;;;;;;OAUG;IACH,YACE,IAAmB,EACH,KAAqB,EACrB,MAAe,EACf,IAAiC,EACjD,QAAiB;QAEjB,kEAAkE;QAClE,MAAM,cAAc,GAA2B,EAAE,CAAC;QAElD,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,cAAc,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;QACvC,CAAC;QAED,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACzB,cAAc,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;QACzC,CAAC;QAED,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACvB,6CAA6C;YAC7C,IAAI,CAAC,sBAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC3B,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;YAChE,CAAC;YACD,cAAc,CAAC,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QAC7C,CAAC;QAED,KAAK,CACH,6BAAgB,EAChB,IAAI,EACJ,SAAS,CAAC,UAAU,EACpB,IAAI,KAAK,EAAE,EAAE,eAAe;QAC5B,SAAS,EAAE,UAAU;QACrB,QAAQ,EACR,cAAc,CACf,CAAC;QAhCc,UAAK,GAAL,KAAK,CAAgB;QACrB,WAAM,GAAN,MAAM,CAAS;QACf,SAAI,GAAJ,IAAI,CAA6B;QA+BjD,IAAI,CAAC,IAAI,GAAG,WAAW,CAAC;QAExB,yDAAyD;QACzD,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IACnD,CAAC;IAED;;;OAGG;IACa,QAAQ;QACtB,MAAM,KAAK,GAAG,CAAC,GAAG,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;QAEhD,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;YAC7B,KAAK,CAAC,IAAI,CAAC,UAAU,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;QACrC,CAAC;QAED,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YAC9B,KAAK,CAAC,IAAI,CAAC,WAAW,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;QACvC,CAAC;QAED,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YAC5B,KAAK,CAAC,IAAI,CAAC,SAAS,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACnD,CAAC;QAED,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC3B,CAAC;IAED;;;OAGG;IACa,MAAM;QACpB,MAAM,QAAQ,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC;QAChC,OAAO;YACL,GAAG,QAAQ;YACX,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS;SACxD,CAAC;IACJ,CAAC;;AA3GH,8BA4GC"}
+{"version":3,"file":"guid.js","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-ecies-lib/src/errors/guid.ts"],"names":[],"mappings":"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"}

package/src/examples/typed-configuration-usage.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Examples showing how to use the typed configuration system for strong ID provider typing.
+ * This demonstrates the solution to the original problem where Constants.idProvider.generate()
+ * had no strong typing.
+ */
+declare function beforeExample(): void;
+declare function afterExample(): void;
+declare function realWorldUsage(): void;
+declare function serviceIntegration(): void;
+declare function typeSafetyDemo(): void;
+export { beforeExample, afterExample, realWorldUsage, serviceIntegration, typeSafetyDemo, };
+//# sourceMappingURL=typed-configuration-usage.d.ts.map

package/src/examples/typed-configuration-usage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"typed-configuration-usage.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-ecies-lib/src/examples/typed-configuration-usage.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAiBH,iBAAS,aAAa,SAKrB;AAMD,iBAAS,YAAY,SAsBpB;AAMD,iBAAS,cAAc,SAsBtB;AAMD,iBAAS,kBAAkB,SAU1B;AAMD,iBAAS,cAAc,SAgBtB;AAED,OAAO,EACL,aAAa,EACb,YAAY,EACZ,cAAc,EACd,kBAAkB,EAClB,cAAc,GACf,CAAC"}

package/src/examples/typed-configuration-usage.js

@@ -0,0 +1,98 @@
+"use strict";
+/**
+ * Examples showing how to use the typed configuration system for strong ID provider typing.
+ * This demonstrates the solution to the original problem where Constants.idProvider.generate()
+ * had no strong typing.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.beforeExample = beforeExample;
+exports.afterExample = afterExample;
+exports.realWorldUsage = realWorldUsage;
+exports.serviceIntegration = serviceIntegration;
+exports.typeSafetyDemo = typeSafetyDemo;
+const constants_1 = require("../constants");
+const guidv4_provider_1 = require("../lib/id-providers/guidv4-provider");
+const typed_configuration_1 = require("../typed-configuration");
+// ============================================================================
+// BEFORE: Weak typing with getRuntimeConfiguration()
+// ============================================================================
+function beforeExample() {
+    // This was the original problem - no strong typing
+    const Constants = (0, constants_1.getRuntimeConfiguration)();
+    const id = Constants.idProvider.generate(); // Returns Uint8Array, loses type info
+    const _nativeId = Constants.idProvider.fromBytes(id); // Returns unknown, no type safety
+}
+// ============================================================================
+// AFTER: Strong typing solutions
+// ============================================================================
+function afterExample() {
+    // Solution 1: Direct replacement for Constants.idProvider
+    const enhancedProvider = (0, typed_configuration_1.getEnhancedIdProvider)();
+    // Original methods still work exactly the same
+    const rawBytes = enhancedProvider.generate(); // Uint8Array (same as before)
+    const _isValid = enhancedProvider.validate(rawBytes); // boolean (same as before)
+    // But now you also have strongly-typed methods
+    const objectId = enhancedProvider.generateTyped(); // ObjectId - strongly typed!
+    const _validTyped = enhancedProvider.validateTyped(objectId); // boolean, accepts ObjectId
+    const serialized = enhancedProvider.serializeTyped(objectId); // string, accepts ObjectId
+    const _deserialized = enhancedProvider.deserializeTyped(serialized); // ObjectId
+    // Solution 2: Simple typed provider
+    const typedProvider = (0, typed_configuration_1.getTypedIdProvider)();
+    const bytes = typedProvider.generate();
+    const _typedId = typedProvider.fromBytes(bytes); // Returns ObjectId, not unknown!
+    // Solution 3: Configuration approach (for more complex scenarios)
+    const config = (0, typed_configuration_1.createObjectIdConfiguration)();
+    const _configId = config.generateId(); // Returns ObjectId - strongly typed!
+}
+// ============================================================================
+// Real-world usage patterns
+// ============================================================================
+function realWorldUsage() {
+    // Pattern 1: Service initialization with strong typing
+    const config = (0, typed_configuration_1.createObjectIdConfiguration)();
+    // Now you can use config.idProvider with full type safety
+    const newId = config.generateId(); // ObjectId
+    const _isValid = config.validateId(newId); // boolean
+    const _idString = config.serializeId(newId); // string
+    // Pattern 2: Custom provider with type inference
+    const customProvider = new guidv4_provider_1.GuidProvider();
+    const typedConfig = (0, typed_configuration_1.createTypedConfiguration)({
+        idProvider: customProvider,
+        // Other overrides...
+        BcryptRounds: 12,
+    });
+    const _guidId = typedConfig.generateId(); // GuidV4 - automatically inferred!
+    // Pattern 3: Backward compatibility - access underlying constants
+    const _underlyingConstants = typedConfig.constants;
+    // This still works for existing code that expects IConstants
+}
+// ============================================================================
+// Integration with ECIESService
+// ============================================================================
+function serviceIntegration() {
+    // The ECIESService can now use TypedConfiguration for better typing
+    const config = (0, typed_configuration_1.createObjectIdConfiguration)();
+    // Pass the underlying constants to existing services
+    // const service = new ECIESService<ObjectId>(config.constants);
+    // Or use the typed config directly for ID operations
+    const memberId = config.generateId(); // ObjectId
+    const _memberIdString = config.serializeId(memberId); // string
+}
+// ============================================================================
+// Type safety demonstrations
+// ============================================================================
+function typeSafetyDemo() {
+    const objectIdConfig = (0, typed_configuration_1.createObjectIdConfiguration)();
+    const guidConfig = (0, typed_configuration_1.createGuidV4Configuration)({
+        idProvider: new guidv4_provider_1.GuidProvider(),
+    });
+    const objectId = objectIdConfig.generateId(); // ObjectId
+    const guid = guidConfig.generateId(); // GuidV4
+    // These operations are now type-safe:
+    objectIdConfig.serializeId(objectId); // ✅ Accepts ObjectId
+    guidConfig.serializeId(guid); // ✅ Accepts GuidV4
+    // These would be compile-time errors:
+    // objectIdConfig.serializeId(guid); // ❌ Type error: GuidV4 not assignable to ObjectId
+    // guidConfig.serializeId(objectId); // ❌ Type error: ObjectId not assignable to GuidV4
+}
+//# sourceMappingURL=typed-configuration-usage.js.map

package/src/examples/typed-configuration-usage.js.map

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

package/src/index.d.ts

@@ -15,6 +15,7 @@ export * from './lib/index';
 export { EciesComponentId, EciesI18nEngineKey, getEciesI18nEngine, getEciesTranslation, resetEciesI18nEngine, safeEciesTranslation, } from './i18n-setup';
 export { encryptionTypeEnumToType, encryptionTypeToString, ensureEciesEncryptionTypeEnum, validateEciesEncryptionTypeEnum, } from './utils/encryption-type-utils';
 export * from './constants';
+export * from './typed-configuration';
 export * from './email-string';
 export * from './enumerations';
 export * from './errors';
@@ -34,6 +35,7 @@ export * from './secure-buffer';
 export * from './secure-string';
 export * from './services';
 export * from './types';
+export * from './types/guid-versions';
 export * from './utils';
 export * from './lib/voting';
 export type { PrivateKey, PublicKey, KeyPair as PaillierKeyPair, } from 'paillier-bigint';

package/src/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../packages/digitaldefiance-ecies-lib/src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,uBAAuB,CAAC;AAG/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAG5B,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,EACnB,oBAAoB,EACpB,oBAAoB,GACrB,MAAM,cAAc,CAAC;AAItB,OAAO,EACL,wBAAwB,EACxB,sBAAsB,EACtB,6BAA6B,EAC7B,+BAA+B,GAChC,MAAM,+BAA+B,CAAC;AASvC,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,UAAU,CAAC;AACzB,cAAc,cAAc,CAAC;AAC7B,cAAc,8BAA8B,CAAC;AAC7C,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AACzE,YAAY,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACtE,cAAc,4BAA4B,CAAC;AAC3C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,UAAU,CAAC;AACzB,cAAc,mBAAmB,CAAC;AAClC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,YAAY,CAAC;AAC3B,cAAc,SAAS,CAAC;AACxB,cAAc,SAAS,CAAC;AAGxB,cAAc,cAAc,CAAC;AAG7B,YAAY,EACV,UAAU,EACV,SAAS,EACT,OAAO,IAAI,eAAe,GAC3B,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../packages/digitaldefiance-ecies-lib/src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,uBAAuB,CAAC;AAG/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAG5B,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,EACnB,oBAAoB,EACpB,oBAAoB,GACrB,MAAM,cAAc,CAAC;AAItB,OAAO,EACL,wBAAwB,EACxB,sBAAsB,EACtB,6BAA6B,EAC7B,+BAA+B,GAChC,MAAM,+BAA+B,CAAC;AASvC,cAAc,aAAa,CAAC;AAC5B,cAAc,uBAAuB,CAAC;AACtC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,UAAU,CAAC;AACzB,cAAc,cAAc,CAAC;AAC7B,cAAc,8BAA8B,CAAC;AAC7C,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AACzE,YAAY,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACtE,cAAc,4BAA4B,CAAC;AAC3C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,UAAU,CAAC;AACzB,cAAc,mBAAmB,CAAC;AAClC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,YAAY,CAAC;AAC3B,cAAc,SAAS,CAAC;AACxB,cAAc,uBAAuB,CAAC;AACtC,cAAc,SAAS,CAAC;AAGxB,cAAc,cAAc,CAAC;AAG7B,YAAY,EACV,UAAU,EACV,SAAS,EACT,OAAO,IAAI,eAAe,GAC3B,MAAM,iBAAiB,CAAC"}

package/src/index.js

@@ -40,6 +40,7 @@ Object.defineProperty(exports, "validateEciesEncryptionTypeEnum", { enumerable:
 // Note: Existing services will be re-exported once migrated to v2
 // For now, import from main index.ts for backward compatibility
 tslib_1.__exportStar(require("./constants"), exports);
+tslib_1.__exportStar(require("./typed-configuration"), exports);
 tslib_1.__exportStar(require("./email-string"), exports);
 tslib_1.__exportStar(require("./enumerations"), exports);
 tslib_1.__exportStar(require("./errors"), exports);
@@ -59,6 +60,7 @@ tslib_1.__exportStar(require("./secure-buffer"), exports);
 tslib_1.__exportStar(require("./secure-string"), exports);
 tslib_1.__exportStar(require("./services"), exports);
 tslib_1.__exportStar(require("./types"), exports);
+tslib_1.__exportStar(require("./types/guid-versions"), exports);
 tslib_1.__exportStar(require("./utils"), exports);
 // Voting system exports (IMember already exported from ./interfaces)
 tslib_1.__exportStar(require("./lib/voting"), exports);

package/src/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../packages/digitaldefiance-ecies-lib/src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;GASG;;;;AAEH,mEAAmE;AACnE,wEAAwE;AACxE,iCAA+B;AAE/B,kBAAkB;AAClB,2DAAiC;AACjC,uDAA6B;AAC7B,sDAA4B;AAE5B,UAAU;AACV,2CAOsB;AANpB,8GAAA,gBAAgB,OAAA;AAChB,gHAAA,kBAAkB,OAAA;AAClB,gHAAA,kBAAkB,OAAA;AAClB,iHAAA,mBAAmB,OAAA;AACnB,kHAAA,oBAAoB,OAAA;AACpB,kHAAA,oBAAoB,OAAA;AAGtB,mFAAmF;AACnF,mEAAmE;AACnE,uEAKuC;AAJrC,iIAAA,wBAAwB,OAAA;AACxB,+HAAA,sBAAsB,OAAA;AACtB,sIAAA,6BAA6B,OAAA;AAC7B,wIAAA,+BAA+B,OAAA;AAGjC,2DAA2D;AAC3D,oEAAoE;AACpE,8DAA8D;AAE9D,kEAAkE;AAClE,gEAAgE;AAEhE,sDAA4B;AAC5B,yDAA+B;AAC/B,yDAA+B;AAC/B,mDAAyB;AACzB,uDAA6B;AAC7B,uEAA6C;AAC7C,kEAAyE;AAAhE,4HAAA,wBAAwB,OAAA;AAEjC,qEAA2C;AAC3C,qEAA2C;AAC3C,uEAA6C;AAC7C,6DAAmC;AACnC,4DAAkC;AAClC,mDAAyB;AACzB,4DAAkC;AAClC,yDAA+B;AAC/B,0DAAgC;AAChC,0DAAgC;AAChC,qDAA2B;AAC3B,kDAAwB;AACxB,kDAAwB;AAExB,qEAAqE;AACrE,uDAA6B"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../packages/digitaldefiance-ecies-lib/src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;GASG;;;;AAEH,mEAAmE;AACnE,wEAAwE;AACxE,iCAA+B;AAE/B,kBAAkB;AAClB,2DAAiC;AACjC,uDAA6B;AAC7B,sDAA4B;AAE5B,UAAU;AACV,2CAOsB;AANpB,8GAAA,gBAAgB,OAAA;AAChB,gHAAA,kBAAkB,OAAA;AAClB,gHAAA,kBAAkB,OAAA;AAClB,iHAAA,mBAAmB,OAAA;AACnB,kHAAA,oBAAoB,OAAA;AACpB,kHAAA,oBAAoB,OAAA;AAGtB,mFAAmF;AACnF,mEAAmE;AACnE,uEAKuC;AAJrC,iIAAA,wBAAwB,OAAA;AACxB,+HAAA,sBAAsB,OAAA;AACtB,sIAAA,6BAA6B,OAAA;AAC7B,wIAAA,+BAA+B,OAAA;AAGjC,2DAA2D;AAC3D,oEAAoE;AACpE,8DAA8D;AAE9D,kEAAkE;AAClE,gEAAgE;AAEhE,sDAA4B;AAC5B,gEAAsC;AACtC,yDAA+B;AAC/B,yDAA+B;AAC/B,mDAAyB;AACzB,uDAA6B;AAC7B,uEAA6C;AAC7C,kEAAyE;AAAhE,4HAAA,wBAAwB,OAAA;AAEjC,qEAA2C;AAC3C,qEAA2C;AAC3C,uEAA6C;AAC7C,6DAAmC;AACnC,4DAAkC;AAClC,mDAAyB;AACzB,4DAAkC;AAClC,yDAA+B;AAC/B,0DAAgC;AAChC,0DAAgC;AAChC,qDAA2B;AAC3B,kDAAwB;AACxB,gEAAsC;AACtC,kDAAwB;AAExB,qEAAqE;AACrE,uDAA6B"}

package/src/interfaces/guid.d.ts

@@ -1,17 +1,18 @@
-import { Base64Guid, BigIntGuid, FullHexGuid, RawGuidBuffer, ShortHexGuid } from '../types';
-export interface IGuidV4 {
+import type { Base64Guid, BigIntGuid, FullHexGuid, RawGuidPlatformBuffer, ShortHexGuid } from '../types';
+import type { PlatformBuffer } from './platform-buffer';
+export interface IGuid {
     /**
      * Returns the GUID as a raw buffer.
      */
-    get asRawGuidBuffer(): RawGuidBuffer;
+    get asRawGuidPlatformBuffer(): RawGuidPlatformBuffer;
     /**
      * Returns the GUID as a full hex string.
      */
     get asFullHexGuid(): FullHexGuid;
     /**
-     * Returns the GUID as a Uint8Array.
+     * Returns the GUID as a PlatformBuffer.
      */
-    get asUint8Array(): Uint8Array;
+    get asPlatformBuffer(): PlatformBuffer;
     /**
      * Returns the GUID as a short hex string.
      */
@@ -24,6 +25,10 @@ export interface IGuidV4 {
      * Returns the GUID as a Base64 string.
      */
     get asBase64Guid(): Base64Guid;
+    /**
+     * Returns a URL-safe base64 representation.
+     */
+    get asUrlSafeBase64(): string;
     /**
      * Returns the GUID as a base64 string
      */
@@ -41,12 +46,12 @@ export interface IGuidV4 {
      * @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;
+    equals(other: IGuid | 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;
+    clone(): IGuid;
     /**
      * Returns the hash code for this GUID based on its buffer content.
      * Useful for using GUIDs as Map/Set keys.
@@ -63,16 +68,45 @@ export interface IGuidV4 {
      * @returns The version number (1-5) or undefined
      */
     getVersion(): number | undefined;
+    /**
+     * Extracts the variant from the GUID.
+     * @returns The variant (0-2) or undefined
+     */
+    getVariant(): number | undefined;
+    /**
+     * Returns the timestamp from a v1 GUID.
+     * @returns Date object or undefined if not a v1 GUID
+     */
+    getTimestamp(): Date | undefined;
+    /**
+     * Validates that this GUID is a proper v1 GUID according to RFC 4122.
+     * @returns True if valid v1 GUID, false otherwise
+     */
+    isValidV1(): boolean;
+    /**
+     * Validates that this GUID is a proper v3 GUID according to RFC 4122.
+     * @returns True if valid v3 GUID, false otherwise
+     */
+    isValidV3(): boolean;
     /**
      * 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;
+    /**
+     * Validates that this GUID is a proper v5 GUID according to RFC 4122.
+     * @returns True if valid v5 GUID, false otherwise
+     */
+    isValidV5(): 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;
+    compareTo(other: IGuid): number;
+    /**
+     * Returns a human-readable debug string.
+     */
+    toDebugString(): string;
 }
 //# sourceMappingURL=guid.d.ts.map

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

@@ -1 +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"}
+{"version":3,"file":"guid.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-ecies-lib/src/interfaces/guid.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,UAAU,EACV,UAAU,EAEV,WAAW,EACX,qBAAqB,EACrB,YAAY,EACb,MAAM,UAAU,CAAC;AAClB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAExD,MAAM,WAAW,KAAK;IACpB;;OAEG;IACH,IAAI,uBAAuB,IAAI,qBAAqB,CAAC;IACrD;;OAEG;IACH,IAAI,aAAa,IAAI,WAAW,CAAC;IACjC;;OAEG;IACH,IAAI,gBAAgB,IAAI,cAAc,CAAC;IACvC;;OAEG;IACH,IAAI,cAAc,IAAI,YAAY,CAAC;IACnC;;OAEG;IACH,IAAI,YAAY,IAAI,UAAU,CAAC;IAC/B;;OAEG;IACH,IAAI,YAAY,IAAI,UAAU,CAAC;IAC/B;;OAEG;IACH,IAAI,eAAe,IAAI,MAAM,CAAC;IAE9B;;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,KAAK,GAAG,IAAI,GAAG,SAAS,EAAE,YAAY,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC;IACzE;;;OAGG;IACH,KAAK,IAAI,KAAK,CAAC;IACf;;;;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,UAAU,IAAI,MAAM,GAAG,SAAS,CAAC;IACjC;;;OAGG;IACH,YAAY,IAAI,IAAI,GAAG,SAAS,CAAC;IACjC;;;OAGG;IACH,SAAS,IAAI,OAAO,CAAC;IACrB;;;OAGG;IACH,SAAS,IAAI,OAAO,CAAC;IACrB;;;OAGG;IACH,SAAS,IAAI,OAAO,CAAC;IACrB;;;OAGG;IACH,SAAS,IAAI,OAAO,CAAC;IACrB;;;;OAIG;IACH,SAAS,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,CAAC;IAChC;;OAEG;IACH,aAAa,IAAI,MAAM,CAAC;CACzB"}

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

@@ -1,4 +1,4 @@
-import { ObjectId } from 'bson';
-import type { GuidV4 } from '../lib';
+import type { ObjectId } from 'bson';
+import type { GuidV4 } from '../types/guid-versions';
 export type PlatformID = Uint8Array | GuidV4 | ObjectId | string;
 //# sourceMappingURL=platform-id.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"platform-id.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-ecies-lib/src/interfaces/platform-id.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,MAAM,CAAC;AAChC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAErC,MAAM,MAAM,UAAU,GAAG,UAAU,GAAG,MAAM,GAAG,QAAQ,GAAG,MAAM,CAAC"}
+{"version":3,"file":"platform-id.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-ecies-lib/src/interfaces/platform-id.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,MAAM,CAAC;AACrC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAErD,MAAM,MAAM,UAAU,GAAG,UAAU,GAAG,MAAM,GAAG,QAAQ,GAAG,MAAM,CAAC"}