@digitaldefiance/node-ecies-lib 4.10.7 → 4.10.8

package/README.md

@@ -163,7 +163,89 @@ const decrypted = ecies.decryptSimpleOrSingleWithHeader(false, privateKey, encry
 console.log(decrypted.toString()); // "Hello, Secure World!"
 ```
 
-### 2. Using Custom ID Providers (e.g., GUID)
+### 2. Strong Typing with ID Providers (New in v4.10.7)
+
+The Node.js library now includes a comprehensive strong typing system for ID providers, eliminating the need for manual type casting and providing compile-time type safety.
+
+#### The Problem (Before v4.10.7)
+
+```typescript
+const Constants = getNodeRuntimeConfiguration();
+const id = Constants.idProvider.generate(); // Returns Uint8Array (no strong typing)
+const obj = Constants.idProvider.fromBytes(bytes); // Returns unknown (requires casting)
+```
+
+#### The Solution (v4.10.7+)
+
+**Enhanced Provider (Drop-in Replacement):**
+```typescript
+import { getEnhancedNodeIdProvider } from '@digitaldefiance/node-ecies-lib';
+
+const provider = getEnhancedNodeIdProvider<ObjectId>();
+const id = provider.generateTyped(); // Returns ObjectId (strongly typed)
+const obj = provider.fromBytesTyped(bytes); // Returns ObjectId (no casting needed)
+
+// Original methods still work for backward compatibility
+const rawBytes = provider.generate(); // Returns Uint8Array
+```
+
+**Simple Typed Provider (Clean API):**
+```typescript
+import { getTypedNodeIdProvider } from '@digitaldefiance/node-ecies-lib';
+
+const provider = getTypedNodeIdProvider<ObjectId>();
+const id = provider.generateTyped(); // Returns ObjectId
+const bytes = provider.toBytesTyped(id); // Type-safe conversion
+const restored = provider.fromBytesTyped(bytes); // Type-safe restoration
+```
+
+**Complete Typed Configuration:**
+```typescript
+import { createNodeObjectIdConfiguration } from '@digitaldefiance/node-ecies-lib';
+
+const config = createNodeObjectIdConfiguration();
+const objectId = config.generateId(); // Returns ObjectId (strongly typed)
+const bytes = config.idToBytes(objectId); // Convert to bytes
+const restored = config.idFromBytes(bytes); // Convert back to ObjectId
+
+// Access full Node.js runtime configuration
+const constants = config.constants; // Complete IConstants with ObjectIdProvider
+```
+
+**Custom Provider Types:**
+```typescript
+import { 
+  createNodeTypedConfiguration,
+  GuidV4Provider,
+  UuidProvider 
+} from '@digitaldefiance/node-ecies-lib';
+
+// GUID configuration
+const guidConfig = createNodeTypedConfiguration<string>({
+  idProvider: new GuidV4Provider()
+});
+const guidId = guidConfig.generateId(); // Returns GUID object (strongly typed)
+
+// UUID configuration
+const uuidConfig = createNodeTypedConfiguration<string>({
+  idProvider: new UuidProvider()
+});
+const uuidId = uuidConfig.generateId(); // Returns UUID string (strongly typed)
+```
+
+**Integration with ECIESService:**
+```typescript
+import { ECIESService, createNodeObjectIdConfiguration } from '@digitaldefiance/node-ecies-lib';
+
+const config = createNodeObjectIdConfiguration();
+const service = new ECIESService(config.constants);
+
+// Service uses the configured typed provider
+console.log(service.idProvider.name); // "ObjectID"
+console.log(service.idProvider.byteLength); // 12
+```
+
+### 3. Using Custom ID Providers (e.g., GUID)
 
 ```typescript
 import { 
@@ -198,7 +280,7 @@ const ecies2 = new ECIESService({
 const ecies3 = new ECIESService();
 ```
 
-### 3. Streaming Encryption (Large Files)
+### 4. Streaming Encryption (Large Files)
 
 Encrypt gigabytes of data with minimal memory footprint (<10MB).
 
@@ -223,7 +305,7 @@ async function processFile(filePath: string, publicKey: Buffer) {
 }
 ```
 
-### 4. Voting System (Node.js Optimized)
+### 5. Voting System (Node.js Optimized)
 
 The Node.js voting system extends the browser implementation with Buffer support and mongoose integration:
 
@@ -311,7 +393,7 @@ console.log(member.id); // Buffer (size depends on provider)
 const encrypted = member.encryptData('My Secrets');
 ```
 
-### 5. Member System
+### 6. Member System
 
 ### Core Services
 
@@ -571,6 +653,46 @@ describe('Integration with suite-core-lib', () => {
 
 ## ChangeLog
 
+### v4.10.7 - Strong Typing for ID Providers
+
+**Major Features:**
+- **Strong Typing System**: Added comprehensive strong typing for Node.js ID provider operations
+  - `getEnhancedNodeIdProvider<T>()`: Drop-in replacement with both original and typed methods
+  - `getTypedNodeIdProvider<T>()`: Simple typed provider with minimal API surface
+  - `createNodeTypedConfiguration<T>()`: Complete typed configuration wrapper
+  - `createNodeObjectIdConfiguration()`: Pre-configured ObjectId setup
+- **Type Safety Benefits**: Eliminates manual casting and provides compile-time type safety
+  - `generateTyped()`: Returns strongly-typed IDs (ObjectId, string, etc.)
+  - `fromBytesTyped()`: Type-safe byte conversion without casting
+  - `toBytesTyped()`, `serializeTyped()`, `deserializeTyped()`: Complete typed API
+- **Backward Compatibility**: Enhanced providers include original methods for seamless migration
+- **Integration Ready**: Works seamlessly with ECIESService and Member system
+
+**Usage Examples:**
+```typescript
+// Enhanced provider (drop-in replacement)
+const provider = getEnhancedNodeIdProvider<ObjectId>();
+const id = provider.generateTyped(); // Returns ObjectId (strongly typed)
+
+// Complete typed configuration
+const config = createNodeObjectIdConfiguration();
+const objectId = config.generateId(); // Returns ObjectId
+const bytes = config.idToBytes(objectId); // Type-safe conversion
+
+// Custom provider types
+const guidConfig = createNodeTypedConfiguration<string>({
+  idProvider: new GuidV4Provider()
+});
+const guidId = guidConfig.generateId(); // Returns GUID object (strongly typed)
+```
+
+**Breaking Changes:** None - fully backward compatible
+
+**Files Added:**
+- `src/typed-configuration.ts` - Main implementation
+- `src/typed-configuration.spec.ts` - Comprehensive tests
+- `src/examples/typed-configuration-usage.ts` - Usage examples
+
 ### v4.10.6 - Voting System & PlatformID Integration
 
 **Major Features:**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@digitaldefiance/node-ecies-lib",
-  "version": "4.10.7",
+  "version": "4.10.8",
   "description": "Digital Defiance Node ECIES Library",
   "homepage": "https://github.com/Digital-Defiance/node-ecies-lib",
   "repository": {
@@ -62,7 +62,7 @@
   "license": "MIT",
   "packageManager": "yarn@4.10.3",
   "dependencies": {
-    "@digitaldefiance/ecies-lib": "4.10.7",
+    "@digitaldefiance/ecies-lib": "4.10.8",
     "@digitaldefiance/express-suite-test-utils": "1.0.14",
     "@digitaldefiance/i18n-lib": "3.8.16",
     "@ethereumjs/wallet": "^10.0.0",

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

@@ -0,0 +1,54 @@
+/**
+ * @fileoverview Usage examples for Node.js ECIES typed configuration system
+ *
+ * This file demonstrates how to use the strongly-typed ID provider system
+ * in Node.js applications for better type safety and developer experience.
+ *
+ * @version 4.10.7
+ * @since 4.10.7
+ */
+/**
+ * Example 1: Enhanced ID Provider (Drop-in Replacement)
+ *
+ * The enhanced provider includes both original and typed methods,
+ * making it a perfect drop-in replacement for existing code.
+ */
+declare function enhancedProviderExample(): void;
+/**
+ * Example 2: Simple Typed Provider (Minimal API)
+ *
+ * The typed provider only exposes strongly-typed methods,
+ * providing a clean API surface for new code.
+ */
+declare function typedProviderExample(): void;
+/**
+ * Example 3: Complete Typed Configuration
+ *
+ * The typed configuration provides access to the full Node.js runtime
+ * configuration plus convenient typed ID helpers.
+ */
+declare function typedConfigurationExample(): void;
+/**
+ * Example 4: Custom Provider Configuration
+ *
+ * Demonstrates how to use different ID providers with strong typing.
+ */
+declare function customProviderExample(): void;
+/**
+ * Example 5: Type Safety Demonstration
+ *
+ * Shows how the typed system prevents common type-related errors.
+ */
+declare function typeSafetyExample(): void;
+/**
+ * Example 6: Integration with ECIESService
+ *
+ * Shows how to use typed configurations with the ECIES service.
+ */
+declare function eciesIntegrationExample(): void;
+/**
+ * Run all examples
+ */
+declare function runAllExamples(): void;
+export { enhancedProviderExample, typedProviderExample, typedConfigurationExample, customProviderExample, typeSafetyExample, eciesIntegrationExample, runAllExamples, };
+//# 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-node-ecies-lib/src/examples/typed-configuration-usage.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAYH;;;;;GAKG;AACH,iBAAS,uBAAuB,SAkB/B;AAED;;;;;GAKG;AACH,iBAAS,oBAAoB,SAqB5B;AAED;;;;;GAKG;AACH,iBAAS,yBAAyB,SAkBjC;AAED;;;;GAIG;AACH,iBAAS,qBAAqB,SAqB7B;AAED;;;;GAIG;AACH,iBAAS,iBAAiB,SAwBzB;AAED;;;;GAIG;AACH,iBAAS,uBAAuB,SAmB/B;AAED;;GAEG;AACH,iBAAS,cAAc,SAsBtB;AAGD,OAAO,EACL,uBAAuB,EACvB,oBAAoB,EACpB,yBAAyB,EACzB,qBAAqB,EACrB,iBAAiB,EACjB,uBAAuB,EACvB,cAAc,GACf,CAAC"}

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

@@ -0,0 +1,178 @@
+"use strict";
+/**
+ * @fileoverview Usage examples for Node.js ECIES typed configuration system
+ *
+ * This file demonstrates how to use the strongly-typed ID provider system
+ * in Node.js applications for better type safety and developer experience.
+ *
+ * @version 4.10.7
+ * @since 4.10.7
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.enhancedProviderExample = enhancedProviderExample;
+exports.typedProviderExample = typedProviderExample;
+exports.typedConfigurationExample = typedConfigurationExample;
+exports.customProviderExample = customProviderExample;
+exports.typeSafetyExample = typeSafetyExample;
+exports.eciesIntegrationExample = eciesIntegrationExample;
+exports.runAllExamples = runAllExamples;
+const ecies_lib_1 = require("@digitaldefiance/ecies-lib");
+const typed_configuration_1 = require("../typed-configuration");
+/**
+ * Example 1: Enhanced ID Provider (Drop-in Replacement)
+ *
+ * The enhanced provider includes both original and typed methods,
+ * making it a perfect drop-in replacement for existing code.
+ */
+function enhancedProviderExample() {
+    console.log('=== Enhanced Provider Example ===');
+    // Get enhanced provider with strong typing
+    const provider = (0, typed_configuration_1.getEnhancedNodeIdProvider)();
+    // Original methods still work (backward compatibility)
+    const rawBytes = provider.generate(); // Returns Uint8Array
+    // const _unknownObj = provider.fromBytes(rawBytes); // Returns unknown (requires casting)
+    // New typed methods provide type safety
+    const typedId = provider.generateTyped(); // Returns ObjectId (strongly typed)
+    const typedFromBytes = provider.fromBytesTyped(rawBytes); // Returns ObjectId (no casting needed)
+    console.log('Provider name:', provider.name);
+    console.log('Byte length:', provider.byteLength);
+    console.log('Typed ID generated:', typedId);
+    console.log('Round-trip successful:', typedFromBytes);
+}
+/**
+ * Example 2: Simple Typed Provider (Minimal API)
+ *
+ * The typed provider only exposes strongly-typed methods,
+ * providing a clean API surface for new code.
+ */
+function typedProviderExample() {
+    console.log('=== Typed Provider Example ===');
+    // Get simple typed provider
+    const provider = (0, typed_configuration_1.getTypedNodeIdProvider)();
+    // Only typed methods available
+    const typedId = provider.generateTyped(); // Returns ObjectId
+    const bytes = provider.toBytesTyped(typedId); // Convert to bytes
+    const restored = provider.fromBytesTyped(bytes); // Convert back to ObjectId
+    // Serialization methods
+    const serialized = provider.serializeTyped(typedId);
+    const deserialized = provider.deserializeTyped(serialized);
+    console.log('Provider name:', provider.name);
+    console.log('Byte length:', provider.byteLength);
+    console.log('Original ID:', typedId);
+    console.log('Restored ID:', restored);
+    console.log('Serialized:', serialized);
+    console.log('Deserialized:', deserialized);
+}
+/**
+ * Example 3: Complete Typed Configuration
+ *
+ * The typed configuration provides access to the full Node.js runtime
+ * configuration plus convenient typed ID helpers.
+ */
+function typedConfigurationExample() {
+    console.log('=== Typed Configuration Example ===');
+    // Create ObjectId configuration
+    const config = (0, typed_configuration_1.createNodeObjectIdConfiguration)();
+    // Access full Node.js runtime configuration
+    console.log('PBKDF2 algorithm:', config.constants.PBKDF2.ALGORITHM);
+    console.log('Member ID length:', config.constants.MEMBER_ID_LENGTH);
+    // Use convenient typed methods
+    const objectId = config.generateId(); // Returns ObjectId
+    const bytes = config.idToBytes(objectId);
+    const restored = config.idFromBytes(bytes);
+    console.log('Generated ObjectId:', objectId);
+    console.log('Byte length:', bytes.length);
+    console.log('Restored ObjectId:', restored);
+}
+/**
+ * Example 4: Custom Provider Configuration
+ *
+ * Demonstrates how to use different ID providers with strong typing.
+ */
+function customProviderExample() {
+    console.log('=== Custom Provider Example ===');
+    // GUID configuration
+    const guidConfig = (0, typed_configuration_1.createNodeTypedConfiguration)({
+        idProvider: new ecies_lib_1.GuidV4Provider(),
+    });
+    // UUID configuration
+    const uuidConfig = (0, typed_configuration_1.createNodeTypedConfiguration)({
+        idProvider: new ecies_lib_1.UuidProvider(),
+    });
+    // Generate typed IDs
+    // const _guidId = guidConfig.generateId(); // Returns GUID object (strongly typed)
+    // const _uuidId = uuidConfig.generateId(); // Returns UUID string (strongly typed)
+    console.log('GUID provider name:', guidConfig.constants.idProvider.name);
+    console.log('GUID byte length:', guidConfig.constants.idProvider.byteLength);
+    console.log('UUID provider name:', uuidConfig.constants.idProvider.name);
+    console.log('UUID byte length:', uuidConfig.constants.idProvider.byteLength);
+}
+/**
+ * Example 5: Type Safety Demonstration
+ *
+ * Shows how the typed system prevents common type-related errors.
+ */
+function typeSafetyExample() {
+    console.log('=== Type Safety Example ===');
+    const objectIdConfig = (0, typed_configuration_1.createNodeObjectIdConfiguration)();
+    const guidConfig = (0, typed_configuration_1.createNodeTypedConfiguration)({
+        idProvider: new ecies_lib_1.GuidV4Provider(),
+    });
+    // Generate strongly-typed IDs
+    const objectId = objectIdConfig.generateId(); // ObjectId type
+    const guidId = guidConfig.generateId(); // GUID object type
+    // Type-safe operations (no casting needed)
+    const objectIdBytes = objectIdConfig.idToBytes(objectId);
+    const guidBytes = guidConfig.idToBytes(guidId);
+    // Restore with type safety
+    const restoredObjectId = objectIdConfig.idFromBytes(objectIdBytes);
+    const restoredGuid = guidConfig.idFromBytes(guidBytes);
+    console.log('ObjectId bytes length:', objectIdBytes.length);
+    console.log('GUID bytes length:', guidBytes.length);
+    console.log('ObjectId restored:', restoredObjectId);
+    console.log('GUID restored:', restoredGuid);
+}
+/**
+ * Example 6: Integration with ECIESService
+ *
+ * Shows how to use typed configurations with the ECIES service.
+ */
+function eciesIntegrationExample() {
+    console.log('=== ECIES Integration Example ===');
+    // Import ECIESService (commented out to avoid circular dependencies in examples)
+    // import { ECIESService } from '../services/ecies/service';
+    // Create typed configuration
+    const config = (0, typed_configuration_1.createNodeObjectIdConfiguration)();
+    // Use with ECIESService
+    // const service = new ECIESService(config.constants);
+    // The service will use the configured ID provider
+    // console.log('Service ID provider:', service.idProvider.name);
+    // console.log('Service ID byte length:', service.idProvider.byteLength);
+    console.log('Configuration ready for ECIESService');
+    console.log('ID provider:', config.constants.idProvider.name);
+    console.log('Byte length:', config.constants.idProvider.byteLength);
+}
+/**
+ * Run all examples
+ */
+function runAllExamples() {
+    console.log('Node.js ECIES Typed Configuration Examples\n');
+    enhancedProviderExample();
+    console.log();
+    typedProviderExample();
+    console.log();
+    typedConfigurationExample();
+    console.log();
+    customProviderExample();
+    console.log();
+    typeSafetyExample();
+    console.log();
+    eciesIntegrationExample();
+    console.log();
+    console.log('All examples completed successfully!');
+}
+// Run examples if this file is executed directly
+if (require.main === module) {
+    runAllExamples();
+}
+//# 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-node-ecies-lib/src/examples/typed-configuration-usage.ts"],"names":[],"mappings":"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"}

package/src/index.d.ts

@@ -19,4 +19,5 @@ export * from './services/voting.service';
 export { IsolatedPublicKey } from './isolated-public';
 export { IsolatedPrivateKey } from './isolated-private';
 export type { PrivateKey, PublicKey, KeyPair as PaillierKeyPair, } from 'paillier-bigint';
+export * from './typed-configuration';
 //# sourceMappingURL=index.d.ts.map

package/src/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../packages/digitaldefiance-node-ecies-lib/src/index.ts"],"names":[],"mappings":"AACA,cAAc,YAAY,CAAC;AAC3B,cAAc,QAAQ,CAAC;AACvB,cAAc,OAAO,CAAC;AAGtB,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,QAAQ,CAAC;AACvB,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC;AACxB,cAAc,iBAAiB,CAAC;AAGhC,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC5D,cAAc,kBAAkB,CAAC;AACjC,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,EAAE,uBAAuB,EAAE,MAAM,sCAAsC,CAAC;AAC/E,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAC9D,cAAc,2BAA2B,CAAC;AAG1C,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAGxD,YAAY,EACV,UAAU,EACV,SAAS,EACT,OAAO,IAAI,eAAe,GAC3B,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../packages/digitaldefiance-node-ecies-lib/src/index.ts"],"names":[],"mappings":"AACA,cAAc,YAAY,CAAC;AAC3B,cAAc,QAAQ,CAAC;AACvB,cAAc,OAAO,CAAC;AAGtB,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,QAAQ,CAAC;AACvB,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC;AACxB,cAAc,iBAAiB,CAAC;AAGhC,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC5D,cAAc,kBAAkB,CAAC;AACjC,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,EAAE,uBAAuB,EAAE,MAAM,sCAAsC,CAAC;AAC/E,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAC9D,cAAc,2BAA2B,CAAC;AAG1C,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAGxD,YAAY,EACV,UAAU,EACV,SAAS,EACT,OAAO,IAAI,eAAe,GAC3B,MAAM,iBAAiB,CAAC;AAGzB,cAAc,uBAAuB,CAAC"}

package/src/index.js

@@ -34,4 +34,6 @@ var isolated_public_1 = require("./isolated-public");
 Object.defineProperty(exports, "IsolatedPublicKey", { enumerable: true, get: function () { return isolated_public_1.IsolatedPublicKey; } });
 var isolated_private_1 = require("./isolated-private");
 Object.defineProperty(exports, "IsolatedPrivateKey", { enumerable: true, get: function () { return isolated_private_1.IsolatedPrivateKey; } });
+// Typed configuration system for strong typing with ID providers
+tslib_1.__exportStar(require("./typed-configuration"), exports);
 //# sourceMappingURL=index.js.map

package/src/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../packages/digitaldefiance-node-ecies-lib/src/index.ts"],"names":[],"mappings":";;;;AAAA,0BAA0B;AAC1B,qDAA2B;AAC3B,iDAAuB;AACvB,gDAAsB;AAEtB,4CAA4C;AAC5C,sDAA4B;AAC5B,yDAA+B;AAC/B,iDAAuB;AACvB,uDAA6B;AAC7B,mDAAyB;AACzB,kDAAwB;AACxB,0DAAgC;AAEhC,iDAAiD;AACjD,8CAAmD;AAA1C,wGAAA,aAAa,OAAA;AACtB,8DAA4D;AAAnD,iHAAA,cAAc,OAAA;AACvB,2DAAiC;AACjC,kEAAgE;AAAvD,qHAAA,gBAAgB,OAAA;AACzB,kFAA+E;AAAtE,oIAAA,uBAAuB,OAAA;AAChC,4CAAkD;AAAzC,uGAAA,aAAa,OAAA;AACtB,gEAA8D;AAArD,mHAAA,eAAe,OAAA;AACxB,oEAA0C;AAE1C,kCAAkC;AAClC,qDAAsD;AAA7C,oHAAA,iBAAiB,OAAA;AAC1B,uDAAwD;AAA/C,sHAAA,kBAAkB,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../packages/digitaldefiance-node-ecies-lib/src/index.ts"],"names":[],"mappings":";;;;AAAA,0BAA0B;AAC1B,qDAA2B;AAC3B,iDAAuB;AACvB,gDAAsB;AAEtB,4CAA4C;AAC5C,sDAA4B;AAC5B,yDAA+B;AAC/B,iDAAuB;AACvB,uDAA6B;AAC7B,mDAAyB;AACzB,kDAAwB;AACxB,0DAAgC;AAEhC,iDAAiD;AACjD,8CAAmD;AAA1C,wGAAA,aAAa,OAAA;AACtB,8DAA4D;AAAnD,iHAAA,cAAc,OAAA;AACvB,2DAAiC;AACjC,kEAAgE;AAAvD,qHAAA,gBAAgB,OAAA;AACzB,kFAA+E;AAAtE,oIAAA,uBAAuB,OAAA;AAChC,4CAAkD;AAAzC,uGAAA,aAAa,OAAA;AACtB,gEAA8D;AAArD,mHAAA,eAAe,OAAA;AACxB,oEAA0C;AAE1C,kCAAkC;AAClC,qDAAsD;AAA7C,oHAAA,iBAAiB,OAAA;AAC1B,uDAAwD;AAA/C,sHAAA,kBAAkB,OAAA;AAS3B,iEAAiE;AACjE,gEAAsC"}

package/src/member.d.ts

@@ -1,5 +1,6 @@
 import { EmailString, IIdProvider, MemberErrorType, MemberType, SecureBuffer, SecureString } from '@digitaldefiance/ecies-lib';
 import { Wallet } from '@ethereumjs/wallet';
+import type { ObjectId } from 'mongodb';
 import type { PrivateKey, PublicKey } from 'paillier-bigint';
 import { PlatformID } from './interfaces';
 import { IEncryptedChunk } from './interfaces/encrypted-chunk';
@@ -33,6 +34,24 @@ export declare class Member<TID extends PlatformID = Buffer> implements IMember<
     private _wallet?;
     private _votingPublicKey?;
     private _votingPrivateKey?;
+    /**
+     * Creates a new Member instance.
+     *
+     * @example Using with typed configuration:
+     * ```typescript
+     * import { createNodeObjectIdConfiguration, getEnhancedNodeIdProvider } from '@digitaldefiance/node-ecies-lib';
+     *
+     * // Option 1: Use typed configuration
+     * const config = createNodeObjectIdConfiguration();
+     * const service = new ECIESService(config.constants);
+     * const { member } = Member.newMember(service, MemberType.User, 'Alice', email);
+     * // member.id is strongly typed as ObjectId
+     *
+     * // Option 2: Use enhanced provider for type-safe operations
+     * const provider = getEnhancedNodeIdProvider<ObjectId>();
+     * const typedId = provider.generateTyped(); // Returns ObjectId (strongly typed)
+     * ```
+     */
     constructor(eciesService: ECIESService, type: MemberType, name: string, email: EmailString, publicKey: Buffer, privateKey?: SecureBuffer, wallet?: Wallet, id?: TID, dateCreated?: Date, dateUpdated?: Date, creatorId?: TID);
     get id(): TID;
     get idBytes(): Buffer;
@@ -101,5 +120,38 @@ export declare class Member<TID extends PlatformID = Buffer> implements IMember<
         member: Member<TID>;
         mnemonic: SecureString;
     };
+    /**
+     * Example method demonstrating how to create a Member with strongly-typed ID providers.
+     * This shows the benefits of the new typed configuration system introduced in v4.10.7.
+     *
+     * @example
+     * ```typescript
+     * // ObjectId example with strong typing
+     * const { member } = Member.newMemberWithTypedId(
+     *   MemberType.User,
+     *   'Alice',
+     *   new EmailString('alice@example.com')
+     * );
+     * // member.id is strongly typed as ObjectId
+     *
+     * // GUID example with strong typing
+     * const { member: guidMember } = Member.newMemberWithTypedId<string>(
+     *   MemberType.User,
+     *   'Bob',
+     *   new EmailString('bob@example.com'),
+     *   { idProvider: new GuidV4Provider() }
+     * );
+     * // guidMember.id is strongly typed as GUID object
+     * ```
+     */
+    static newMemberWithTypedId<TID extends PlatformID = ObjectId>(type: MemberType, name: string, email: EmailString, options?: {
+        idProvider?: IIdProvider<TID>;
+        forceMnemonic?: SecureString;
+        createdBy?: TID;
+    }): {
+        member: Member<TID>;
+        mnemonic: SecureString;
+        typedId: TID;
+    };
 }
 //# sourceMappingURL=member.d.ts.map

package/src/member.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"member.d.ts","sourceRoot":"","sources":["../../../../packages/digitaldefiance-node-ecies-lib/src/member.ts"],"names":[],"mappings":"AACA,OAAO,EACL,WAAW,EACX,WAAW,EAEX,eAAe,EACf,UAAU,EACV,YAAY,EACZ,YAAY,EACb,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC5C,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAO7D,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAC/D,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAC/D,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAExD,OAAO,EAAE,eAAe,EAAgB,MAAM,SAAS,CAAC;AAGxD;;GAEG;AACH,qBAAa,eAAgB,SAAQ,KAAK;aAGtB,IAAI,EAAE,eAAe;gBADrC,OAAO,EAAE,MAAM,EACC,IAAI,EAAE,eAAe;CAKxC;AAED;;GAEG;AACH,qBAAa,MAAM,CAAC,GAAG,SAAS,UAAU,GAAG,MAAM,CAAE,YAAW,OAAO,CAAC,GAAG,CAAC;IAC1E,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAe;IAC7C,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAM;IAC1B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAa;IACnC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAc;IACrC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAM;IACjC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAS;IACzC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAO;IACpC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAO;IACpC,OAAO,CAAC,WAAW,CAAC,CAAe;IACnC,OAAO,CAAC,OAAO,CAAC,CAAS;IAGzB,OAAO,CAAC,gBAAgB,CAAC,CAAY;IACrC,OAAO,CAAC,iBAAiB,CAAC,CAAa;gBAIrC,YAAY,EAAE,YAAY,EAE1B,IAAI,EAAE,UAAU,EAChB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,WAAW,EAClB,SAAS,EAAE,MAAM,EACjB,UAAU,CAAC,EAAE,YAAY,EACzB,MAAM,CAAC,EAAE,MAAM,EACf,EAAE,CAAC,EAAE,GAAG,EACR,WAAW,CAAC,EAAE,IAAI,EAClB,WAAW,CAAC,EAAE,IAAI,EAClB,SAAS,CAAC,EAAE,GAAG;IAiEjB,IAAW,EAAE,IAAI,GAAG,CAEnB;IACD,IAAW,OAAO,IAAI,MAAM,CAE3B;IACD,IAAW,cAAc,IAAI,MAAM,CAElC;IACD,IAAW,IAAI,IAAI,UAAU,CAE5B;IACD,IAAW,IAAI,IAAI,MAAM,CAExB;IACD,IAAW,KAAK,IAAI,WAAW,CAE9B;IACD,IAAW,SAAS,IAAI,MAAM,CAE7B;IACD,IAAW,SAAS,IAAI,GAAG,CAE1B;IACD,IAAW,WAAW,IAAI,IAAI,CAE7B;IACD,IAAW,WAAW,IAAI,IAAI,CAE7B;IAGD,IAAW,UAAU,IAAI,WAAW,CAAC,GAAG,CAAC,CAExC;IACD,IAAW,SAAS,IAAI,OAAO,4BAA4B,EAAE,eAAe,CAE3E;IAGM,kBAAkB,IAAI,MAAM;IAI5B,WAAW,IAAI,MAAM;IAa5B,IAAW,UAAU,IAAI,YAAY,GAAG,SAAS,CAEhD;IACD,IAAW,MAAM,IAAI,MAAM,CAQ1B;IAGD,IAAW,cAAc,IAAI,MAAM,GAAG,SAAS,CAE9C;IAGD,IAAW,aAAa,IAAI,OAAO,CAElC;IAED,IAAW,eAAe,IAAI,SAAS,GAAG,SAAS,CAElD;IAED,IAAW,gBAAgB,IAAI,UAAU,GAAG,SAAS,CAEpD;IAED,IAAW,mBAAmB,IAAI,OAAO,CAExC;IAEM,cAAc,CACnB,eAAe,EAAE,SAAS,EAC1B,gBAAgB,CAAC,EAAE,UAAU,GAC5B,IAAI;IAOA,sBAAsB,IAAI,IAAI;IAIrC;;;;;;OAMG;IACU,gBAAgB,CAC3B,OAAO,CAAC,EAAE,OAAO,2BAA2B,EAAE,uBAAuB,GACpE,OAAO,CAAC,IAAI,CAAC;IAiCT,gBAAgB,IAAI,IAAI;IAMxB,YAAY,IAAI,IAAI;IAIpB,yBAAyB,IAAI,IAAI;IAKjC,UAAU,CAAC,QAAQ,EAAE,YAAY,GAAG,IAAI;IA6B/C;;;;;OAKG;IACI,cAAc,CAAC,UAAU,EAAE,YAAY,GAAG,IAAI;IAI9C,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe;IAenC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe;IAevC,MAAM,CAAC,SAAS,EAAE,eAAe,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO;IAIzD,eAAe,CACpB,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,GAChB,OAAO;IAQV,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,mBAAmB,CAAoB;IAC/D,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,kBAAkB,CAA0B;IAE7D,WAAW,CAChB,IAAI,EAAE,MAAM,GAAG,MAAM,EACrB,kBAAkB,CAAC,EAAE,MAAM,GAC1B,MAAM;IAqCF,WAAW,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM;IAiB1C,MAAM,IAAI,MAAM;IAkBhB,OAAO,IAAI,IAAI;IASR,iBAAiB,CAC7B,MAAM,EAAE,aAAa,CAAC,MAAM,CAAC,EAC7B,OAAO,CAAC,EAAE;QACR,kBAAkB,CAAC,EAAE,MAAM,CAAC;QAC5B,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,eAAe,KAAK,IAAI,CAAC;QACjD,MAAM,CAAC,EAAE,WAAW,CAAC;KACtB,GACA,cAAc,CAAC,eAAe,EAAE,IAAI,EAAE,OAAO,CAAC;IAYnC,iBAAiB,CAC7B,MAAM,EAAE,aAAa,CAAC,MAAM,CAAC,EAC7B,OAAO,CAAC,EAAE;QACR,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,eAAe,KAAK,IAAI,CAAC;QACjD,MAAM,CAAC,EAAE,WAAW,CAAC;KACtB,GACA,cAAc,CAAC,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC;WAwB1B,QAAQ,CAAC,GAAG,SAAS,UAAU,GAAG,MAAM,EACpD,IAAI,EAAE,MAAM,EAEZ,YAAY,EAAE,YAAY,GACzB,MAAM,CAAC,GAAG,CAAC;WA8CA,YAAY,CAAC,GAAG,SAAS,UAAU,GAAG,MAAM,EACxD,QAAQ,EAAE,YAAY,EACtB,YAAY,EAAE,YAAY,EAC1B,UAAU,aAAkB,EAC5B,IAAI,SAAc,EAClB,KAAK,cAAsC,GAC1C,MAAM,CAAC,GAAG,CAAC;WAkBA,SAAS,CAAC,GAAG,SAAS,UAAU,GAAG,MAAM,EAErD,YAAY,EAAE,YAAY,EAE1B,IAAI,EAAE,UAAU,EAChB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,WAAW,EAClB,aAAa,CAAC,EAAE,YAAY,EAC5B,SAAS,CAAC,EAAE,GAAG,GACd;QAAE,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC;QAAC,QAAQ,EAAE,YAAY,CAAA;KAAE;CA+DnD"}
+{"version":3,"file":"member.d.ts","sourceRoot":"","sources":["../../../../packages/digitaldefiance-node-ecies-lib/src/member.ts"],"names":[],"mappings":"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"}

package/src/member.js

@@ -6,6 +6,7 @@ const ecies_lib_1 = require("@digitaldefiance/ecies-lib");
 const mongoose_types_1 = require("@digitaldefiance/mongoose-types");
 const constants_1 = require("./constants");
 const ecies_i18n_factory_1 = require("./i18n/ecies-i18n-factory");
+const service_1 = require("./services/ecies/service");
 const encryption_stream_1 = require("./services/encryption-stream");
 const types_1 = require("./types");
 const Constants = (0, constants_1.getNodeRuntimeConfiguration)();
@@ -41,6 +42,24 @@ class Member {
     // Optional voting keys for homomorphic encryption voting systems
     _votingPublicKey;
     _votingPrivateKey;
+    /**
+     * Creates a new Member instance.
+     *
+     * @example Using with typed configuration:
+     * ```typescript
+     * import { createNodeObjectIdConfiguration, getEnhancedNodeIdProvider } from '@digitaldefiance/node-ecies-lib';
+     *
+     * // Option 1: Use typed configuration
+     * const config = createNodeObjectIdConfiguration();
+     * const service = new ECIESService(config.constants);
+     * const { member } = Member.newMember(service, MemberType.User, 'Alice', email);
+     * // member.id is strongly typed as ObjectId
+     *
+     * // Option 2: Use enhanced provider for type-safe operations
+     * const provider = getEnhancedNodeIdProvider<ObjectId>();
+     * const typedId = provider.generateTyped(); // Returns ObjectId (strongly typed)
+     * ```
+     */
     constructor(
     // Add injected services as parameters
     eciesService, 
@@ -385,6 +404,59 @@ class Member {
             mnemonic,
         };
     }
+    /**
+     * Example method demonstrating how to create a Member with strongly-typed ID providers.
+     * This shows the benefits of the new typed configuration system introduced in v4.10.7.
+     *
+     * @example
+     * ```typescript
+     * // ObjectId example with strong typing
+     * const { member } = Member.newMemberWithTypedId(
+     *   MemberType.User,
+     *   'Alice',
+     *   new EmailString('alice@example.com')
+     * );
+     * // member.id is strongly typed as ObjectId
+     *
+     * // GUID example with strong typing
+     * const { member: guidMember } = Member.newMemberWithTypedId<string>(
+     *   MemberType.User,
+     *   'Bob',
+     *   new EmailString('bob@example.com'),
+     *   { idProvider: new GuidV4Provider() }
+     * );
+     * // guidMember.id is strongly typed as GUID object
+     * ```
+     */
+    static newMemberWithTypedId(type, name, email, options) {
+        // Import the typed configuration functions dynamically to avoid circular dependencies
+        // eslint-disable-next-line @typescript-eslint/no-var-requires, @typescript-eslint/no-unsafe-assignment, @typescript-eslint/no-require-imports
+        const typedConfig = require('./typed-configuration');
+        // Create typed configuration
+        // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment, @typescript-eslint/no-unsafe-call, @typescript-eslint/no-unsafe-member-access
+        const config = options?.idProvider
+            ? // eslint-disable-next-line @typescript-eslint/no-unsafe-call, @typescript-eslint/no-unsafe-member-access
+                typedConfig.createNodeTypedConfiguration({
+                    idProvider: options.idProvider,
+                })
+            : // eslint-disable-next-line @typescript-eslint/no-unsafe-call, @typescript-eslint/no-unsafe-member-access
+                typedConfig.createNodeObjectIdConfiguration();
+        // Create service with typed configuration
+        // eslint-disable-next-line @typescript-eslint/no-unsafe-argument, @typescript-eslint/no-unsafe-member-access
+        const service = new service_1.ECIESService(config.constants);
+        // Create member using the standard method
+        const result = Member.newMember(service, type, name, email, options?.forceMnemonic, options?.createdBy);
+        // Get enhanced provider for type-safe operations
+        // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment, @typescript-eslint/no-unsafe-call, @typescript-eslint/no-unsafe-member-access
+        const enhancedProvider = typedConfig.getEnhancedNodeIdProvider();
+        // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment, @typescript-eslint/no-unsafe-call, @typescript-eslint/no-unsafe-member-access
+        const typedId = enhancedProvider.fromBytesTyped(new Uint8Array(result.member.idBytes));
+        return {
+            member: result.member,
+            mnemonic: result.mnemonic,
+            typedId, // Strongly typed ID
+        };
+    }
 }
 exports.Member = Member;
 //# sourceMappingURL=member.js.map