@digitaldefiance/node-ecies-lib 4.10.7 → 4.11.1

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.11.1",
   "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.11.1",
     "@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/interfaces/guid.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"guid.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-node-ecies-lib/src/interfaces/guid.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,UAAU,EACV,UAAU,EACV,WAAW,EACX,KAAK,IAAI,SAAS,EAClB,YAAY,EACb,MAAM,4BAA4B,CAAC;AAEpC,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,UAAU,CAAC;AAEtD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAExD,MAAM,WAAW,OAAQ,SAAQ,SAAS;IACxC;;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;IAE/B;;OAEG;IACH,SAAS,IAAI,MAAM,CAAC;IACpB;;OAEG;IACH,MAAM,IAAI,MAAM,CAAC;IACjB;;OAEG;IACH,QAAQ,IAAI,UAAU,CAAC;IACvB;;;;OAIG;IACH,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,GAAG,SAAS,EAAE,YAAY,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC;IAC3E;;;OAGG;IACH,KAAK,IAAI,OAAO,CAAC;IACjB;;;;OAIG;IACH,QAAQ,IAAI,MAAM,CAAC;IACnB;;;OAGG;IACH,OAAO,IAAI,OAAO,CAAC;IACnB;;;OAGG;IACH,UAAU,IAAI,MAAM,GAAG,SAAS,CAAC;IACjC;;;OAGG;IACH,SAAS,IAAI,OAAO,CAAC;IACrB;;;;OAIG;IACH,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAAC;CACnC"}

package/src/interfaces/guid.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=guid.js.map

package/src/interfaces/guid.js.map

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