@digitaldefiance/node-ecies-lib 4.19.7 → 4.19.11

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@digitaldefiance/node-ecies-lib",
-  "version": "4.19.7",
+  "version": "4.19.11",
   "description": "Digital Defiance Node ECIES Library",
   "homepage": "https://github.com/Digital-Defiance/node-ecies-lib",
   "repository": {
@@ -59,7 +59,7 @@
   "license": "MIT",
   "packageManager": "yarn@4.10.3",
   "dependencies": {
-    "@digitaldefiance/ecies-lib": "4.19.6",
+    "@digitaldefiance/ecies-lib": "4.19.11",
     "@digitaldefiance/i18n-lib": "4.6.4",
     "@ethereumjs/wallet": "^2.0.4",
     "@noble/curves": "^1.4.2",

package/src/lib/guid-provider-utils.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Provider-to-GUID conversion utilities for Node.js Buffer-based GUIDs.
+ *
+ * Extracted from GuidBuffer to break the circular dependency between
+ * guid.ts and id-providers. These functions import both modules without
+ * creating a cycle since nothing imports back into this file from either side.
+ */
+import { BaseIdProvider } from '@digitaldefiance/ecies-lib';
+import { VersionedGuidBuffer } from './guid';
+/**
+ * Convert a provider's native ID to a GuidBuffer.
+ *
+ * For 16-byte providers (GuidV4Provider, UuidProvider) the bytes are
+ * reinterpreted directly as a GUID — they already are one.
+ *
+ * For non-16-byte providers (ObjectIdProvider, CustomIdProvider,
+ * Uint8ArrayIdProvider, BufferIdProvider) a deterministic UUID v5 is
+ * derived using a provider-specific namespace.
+ */
+export declare function fromProviderId<T>(id: T, provider: BaseIdProvider<T>): VersionedGuidBuffer;
+/**
+ * Convert raw ID bytes (from any provider) to a GuidBuffer.
+ *
+ * Same strategy as {@link fromProviderId} but starts from the Buffer
+ * byte representation rather than the provider's native type.
+ */
+export declare function fromProviderIdBytes<T>(idBytes: Buffer, provider: BaseIdProvider<T>): VersionedGuidBuffer;
+//# sourceMappingURL=guid-provider-utils.d.ts.map

package/src/lib/guid-provider-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"guid-provider-utils.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-node-ecies-lib/src/lib/guid-provider-utils.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EACL,cAAc,EAQf,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EAAc,mBAAmB,EAAE,MAAM,QAAQ,CAAC;AAUzD;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAC9B,EAAE,EAAE,CAAC,EACL,QAAQ,EAAE,cAAc,CAAC,CAAC,CAAC,GAC1B,mBAAmB,CAGrB;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,EACnC,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,cAAc,CAAC,CAAC,CAAC,GAC1B,mBAAmB,CAgCrB"}

package/src/lib/guid-provider-utils.js

@@ -0,0 +1,72 @@
+"use strict";
+/**
+ * Provider-to-GUID conversion utilities for Node.js Buffer-based GUIDs.
+ *
+ * Extracted from GuidBuffer to break the circular dependency between
+ * guid.ts and id-providers. These functions import both modules without
+ * creating a cycle since nothing imports back into this file from either side.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.fromProviderId = fromProviderId;
+exports.fromProviderIdBytes = fromProviderIdBytes;
+const ecies_lib_1 = require("@digitaldefiance/ecies-lib");
+const guid_1 = require("./guid");
+const buffer_provider_1 = require("./id-providers/buffer-provider");
+const guidv4_provider_1 = require("./id-providers/guidv4-provider");
+// Well-known v5 namespace UUIDs for deterministic derivation.
+const NS_OBJECTID = '6ba7b814-9dad-11d1-80b4-00c04fd430c8';
+const NS_CUSTOM = '6ba7b815-9dad-11d1-80b4-00c04fd430c8';
+const NS_UINT8ARRAY = '6ba7b816-9dad-11d1-80b4-00c04fd430c8';
+const NS_BUFFER = '6ba7b817-9dad-11d1-80b4-00c04fd430c8';
+/**
+ * Convert a provider's native ID to a GuidBuffer.
+ *
+ * For 16-byte providers (GuidV4Provider, UuidProvider) the bytes are
+ * reinterpreted directly as a GUID — they already are one.
+ *
+ * For non-16-byte providers (ObjectIdProvider, CustomIdProvider,
+ * Uint8ArrayIdProvider, BufferIdProvider) a deterministic UUID v5 is
+ * derived using a provider-specific namespace.
+ */
+function fromProviderId(id, provider) {
+    const bytes = Buffer.from(provider.toBytes(id));
+    return fromProviderIdBytes(bytes, provider);
+}
+/**
+ * Convert raw ID bytes (from any provider) to a GuidBuffer.
+ *
+ * Same strategy as {@link fromProviderId} but starts from the Buffer
+ * byte representation rather than the provider's native type.
+ */
+function fromProviderIdBytes(idBytes, provider) {
+    if (idBytes.length !== provider.byteLength) {
+        throw new ecies_lib_1.GuidError(ecies_lib_1.GuidErrorType.InvalidGuid);
+    }
+    // 16-byte providers: the bytes already represent a valid GUID
+    if (provider instanceof guidv4_provider_1.GuidV4Provider ||
+        provider instanceof ecies_lib_1.GuidV4Provider ||
+        provider instanceof ecies_lib_1.UuidProvider) {
+        return guid_1.GuidBuffer.fromPlatformBuffer(idBytes);
+    }
+    // Non-16-byte providers: derive a deterministic v5 GUID
+    const serialized = provider.serialize(idBytes);
+    let namespace;
+    if (provider instanceof ecies_lib_1.ObjectIdProvider) {
+        namespace = NS_OBJECTID;
+    }
+    else if (provider instanceof ecies_lib_1.CustomIdProvider) {
+        namespace = NS_CUSTOM;
+    }
+    else if (provider instanceof ecies_lib_1.Uint8ArrayIdProvider) {
+        namespace = NS_UINT8ARRAY;
+    }
+    else if (provider instanceof buffer_provider_1.BufferIdProvider) {
+        namespace = NS_BUFFER;
+    }
+    else {
+        // Fallback for unknown providers
+        namespace = NS_CUSTOM;
+    }
+    return guid_1.GuidBuffer.v5(serialized, namespace);
+}
+//# sourceMappingURL=guid-provider-utils.js.map

package/src/lib/guid-provider-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"guid-provider-utils.js","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-node-ecies-lib/src/lib/guid-provider-utils.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;AAiCH,wCAMC;AAQD,kDAmCC;AAhFD,0DASoC;AAEpC,iCAAyD;AACzD,oEAAkE;AAClE,oEAAgE;AAEhE,8DAA8D;AAC9D,MAAM,WAAW,GAAG,sCAAsC,CAAC;AAC3D,MAAM,SAAS,GAAG,sCAAsC,CAAC;AACzD,MAAM,aAAa,GAAG,sCAAsC,CAAC;AAC7D,MAAM,SAAS,GAAG,sCAAsC,CAAC;AAEzD;;;;;;;;;GASG;AACH,SAAgB,cAAc,CAC5B,EAAK,EACL,QAA2B;IAE3B,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC;IAChD,OAAO,mBAAmB,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;AAC9C,CAAC;AAED;;;;;GAKG;AACH,SAAgB,mBAAmB,CACjC,OAAe,EACf,QAA2B;IAE3B,IAAI,OAAO,CAAC,MAAM,KAAK,QAAQ,CAAC,UAAU,EAAE,CAAC;QAC3C,MAAM,IAAI,qBAAS,CAAC,yBAAa,CAAC,WAAW,CAAC,CAAC;IACjD,CAAC;IAED,8DAA8D;IAC9D,IACE,QAAQ,YAAY,gCAAc;QAClC,QAAQ,YAAY,0BAAwB;QAC5C,QAAQ,YAAY,wBAAY,EAChC,CAAC;QACD,OAAO,iBAAU,CAAC,kBAAkB,CAAC,OAAO,CAAC,CAAC;IAChD,CAAC;IAED,wDAAwD;IACxD,MAAM,UAAU,GAAG,QAAQ,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IAC/C,IAAI,SAAiB,CAAC;IAEtB,IAAI,QAAQ,YAAY,4BAAgB,EAAE,CAAC;QACzC,SAAS,GAAG,WAAW,CAAC;IAC1B,CAAC;SAAM,IAAI,QAAQ,YAAY,4BAAgB,EAAE,CAAC;QAChD,SAAS,GAAG,SAAS,CAAC;IACxB,CAAC;SAAM,IAAI,QAAQ,YAAY,gCAAoB,EAAE,CAAC;QACpD,SAAS,GAAG,aAAa,CAAC;IAC5B,CAAC;SAAM,IAAI,QAAQ,YAAY,kCAAgB,EAAE,CAAC;QAChD,SAAS,GAAG,SAAS,CAAC;IACxB,CAAC;SAAM,CAAC;QACN,iCAAiC;QACjC,SAAS,GAAG,SAAS,CAAC;IACxB,CAAC;IAED,OAAO,iBAAU,CAAC,EAAE,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC;AAC9C,CAAC"}

package/src/lib/index.d.ts

@@ -3,6 +3,7 @@
  */
 export * from './crypto-container';
 export * from './guid';
+export * from './guid-provider-utils';
 export * from './id-providers/buffer-provider';
 export * from './id-providers/guidv4-provider';
 export * from './invariant-validator';

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-node-ecies-lib/src/lib/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,cAAc,oBAAoB,CAAC;AACnC,cAAc,QAAQ,CAAC;AACvB,cAAc,gCAAgC,CAAC;AAC/C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,uBAAuB,CAAC;AACtC,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-node-ecies-lib/src/lib/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,cAAc,oBAAoB,CAAC;AACnC,cAAc,QAAQ,CAAC;AACvB,cAAc,uBAAuB,CAAC;AACtC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,uBAAuB,CAAC;AACtC,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC"}

package/src/lib/index.js

@@ -6,6 +6,7 @@ const tslib_1 = require("tslib");
  */
 tslib_1.__exportStar(require("./crypto-container"), exports);
 tslib_1.__exportStar(require("./guid"), exports);
+tslib_1.__exportStar(require("./guid-provider-utils"), exports);
 tslib_1.__exportStar(require("./id-providers/buffer-provider"), exports);
 tslib_1.__exportStar(require("./id-providers/guidv4-provider"), exports);
 tslib_1.__exportStar(require("./invariant-validator"), exports);

package/src/lib/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-node-ecies-lib/src/lib/index.ts"],"names":[],"mappings":";;;AAAA;;GAEG;AACH,6DAAmC;AACnC,iDAAuB;AACvB,yEAA+C;AAC/C,yEAA+C;AAC/C,gEAAsC;AACtC,uDAA6B;AAC7B,mDAAyB"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-node-ecies-lib/src/lib/index.ts"],"names":[],"mappings":";;;AAAA;;GAEG;AACH,6DAAmC;AACnC,iDAAuB;AACvB,gEAAsC;AACtC,yEAA+C;AAC/C,yEAA+C;AAC/C,gEAAsC;AACtC,uDAA6B;AAC7B,mDAAyB"}