@digitaldefiance/ecies-lib 4.19.6 → 4.19.11

package/package.json

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

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

@@ -0,0 +1,29 @@
+/**
+ * Provider-to-GUID conversion utilities.
+ *
+ * Extracted from GuidUint8Array 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 './base-id-provider';
+import { VersionedGuidUint8Array } from './guid';
+/**
+ * Convert a provider's native ID to a GuidUint8Array.
+ *
+ * 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) a deterministic UUID v5 is derived using a
+ * provider-specific namespace, so the same input always yields the same
+ * GUID and different providers never collide.
+ */
+export declare function fromProviderId<T>(id: T, provider: BaseIdProvider<T>): VersionedGuidUint8Array;
+/**
+ * Convert raw ID bytes (from any provider) to a GuidUint8Array.
+ *
+ * Same strategy as {@link fromProviderId} but starts from the Uint8Array
+ * byte representation rather than the provider's native type.
+ */
+export declare function fromProviderIdBytes<T>(idBytes: Uint8Array, provider: BaseIdProvider<T>): VersionedGuidUint8Array;
+//# 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-ecies-lib/src/lib/guid-provider-utils.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAkB,uBAAuB,EAAE,MAAM,QAAQ,CAAC;AAiBjE;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAC9B,EAAE,EAAE,CAAC,EACL,QAAQ,EAAE,cAAc,CAAC,CAAC,CAAC,GAC1B,uBAAuB,CAGzB;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,EACnC,OAAO,EAAE,UAAU,EACnB,QAAQ,EAAE,cAAc,CAAC,CAAC,CAAC,GAC1B,uBAAuB,CA0BzB"}

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

@@ -0,0 +1,70 @@
+"use strict";
+/**
+ * Provider-to-GUID conversion utilities.
+ *
+ * Extracted from GuidUint8Array 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 guid_error_type_1 = require("../enumerations/guid-error-type");
+const guid_1 = require("../errors/guid");
+const guid_2 = require("./guid");
+const id_providers_1 = require("./id-providers");
+// Well-known v5 namespace UUIDs for deterministic derivation.
+// These are arbitrary but fixed UUIDs that scope the v5 hash per provider,
+// ensuring that the same raw bytes from different providers produce
+// different GUIDs.
+const NS_OBJECTID = '6ba7b814-9dad-11d1-80b4-00c04fd430c8';
+const NS_CUSTOM = '6ba7b815-9dad-11d1-80b4-00c04fd430c8';
+const NS_UINT8ARRAY = '6ba7b816-9dad-11d1-80b4-00c04fd430c8';
+/**
+ * Convert a provider's native ID to a GuidUint8Array.
+ *
+ * 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) a deterministic UUID v5 is derived using a
+ * provider-specific namespace, so the same input always yields the same
+ * GUID and different providers never collide.
+ */
+function fromProviderId(id, provider) {
+    const bytes = provider.toBytes(id);
+    return fromProviderIdBytes(bytes, provider);
+}
+/**
+ * Convert raw ID bytes (from any provider) to a GuidUint8Array.
+ *
+ * Same strategy as {@link fromProviderId} but starts from the Uint8Array
+ * byte representation rather than the provider's native type.
+ */
+function fromProviderIdBytes(idBytes, provider) {
+    if (idBytes.length !== provider.byteLength) {
+        throw new guid_1.GuidError(guid_error_type_1.GuidErrorType.InvalidGuid);
+    }
+    // 16-byte providers: the bytes already represent a valid GUID
+    if (provider instanceof id_providers_1.GuidV4Provider || provider instanceof id_providers_1.UuidProvider) {
+        return guid_2.GuidUint8Array.fromPlatformBuffer(idBytes);
+    }
+    // Non-16-byte providers: derive a deterministic v5 GUID
+    const serialized = provider.serialize(idBytes);
+    let namespace;
+    if (provider instanceof id_providers_1.ObjectIdProvider) {
+        namespace = NS_OBJECTID;
+    }
+    else if (provider instanceof id_providers_1.CustomIdProvider) {
+        namespace = NS_CUSTOM;
+    }
+    else if (provider instanceof id_providers_1.Uint8ArrayIdProvider) {
+        namespace = NS_UINT8ARRAY;
+    }
+    else {
+        // Fallback for unknown providers
+        namespace = NS_CUSTOM;
+    }
+    return guid_2.GuidUint8Array.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-ecies-lib/src/lib/guid-provider-utils.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;AAiCH,wCAMC;AAQD,kDA6BC;AA1ED,qEAAgE;AAChE,yCAA2C;AAE3C,iCAAiE;AACjE,iDAMwB;AAExB,8DAA8D;AAC9D,2EAA2E;AAC3E,oEAAoE;AACpE,mBAAmB;AACnB,MAAM,WAAW,GAAG,sCAAsC,CAAC;AAC3D,MAAM,SAAS,GAAG,sCAAsC,CAAC;AACzD,MAAM,aAAa,GAAG,sCAAsC,CAAC;AAE7D;;;;;;;;;;GAUG;AACH,SAAgB,cAAc,CAC5B,EAAK,EACL,QAA2B;IAE3B,MAAM,KAAK,GAAG,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IACnC,OAAO,mBAAmB,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;AAC9C,CAAC;AAED;;;;;GAKG;AACH,SAAgB,mBAAmB,CACjC,OAAmB,EACnB,QAA2B;IAE3B,IAAI,OAAO,CAAC,MAAM,KAAK,QAAQ,CAAC,UAAU,EAAE,CAAC;QAC3C,MAAM,IAAI,gBAAS,CAAC,+BAAa,CAAC,WAAW,CAAC,CAAC;IACjD,CAAC;IAED,8DAA8D;IAC9D,IAAI,QAAQ,YAAY,6BAAc,IAAI,QAAQ,YAAY,2BAAY,EAAE,CAAC;QAC3E,OAAO,qBAAc,CAAC,kBAAkB,CAAC,OAAO,CAAC,CAAC;IACpD,CAAC;IAED,wDAAwD;IACxD,MAAM,UAAU,GAAG,QAAQ,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IAC/C,IAAI,SAAiB,CAAC;IAEtB,IAAI,QAAQ,YAAY,+BAAgB,EAAE,CAAC;QACzC,SAAS,GAAG,WAAW,CAAC;IAC1B,CAAC;SAAM,IAAI,QAAQ,YAAY,+BAAgB,EAAE,CAAC;QAChD,SAAS,GAAG,SAAS,CAAC;IACxB,CAAC;SAAM,IAAI,QAAQ,YAAY,mCAAoB,EAAE,CAAC;QACpD,SAAS,GAAG,aAAa,CAAC;IAC5B,CAAC;SAAM,CAAC;QACN,iCAAiC;QACjC,SAAS,GAAG,SAAS,CAAC;IACxB,CAAC;IAED,OAAO,qBAAc,CAAC,EAAE,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC;AAClD,CAAC"}

package/src/lib/index.d.ts

@@ -3,5 +3,6 @@
  */
 export * from './crypto-container';
 export * from './guid';
+export * from './guid-provider-utils';
 export * from './id-providers';
 //# sourceMappingURL=index.d.ts.map

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

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

package/src/lib/index.js

@@ -6,5 +6,6 @@ Object.defineProperty(exports, "__esModule", { value: true });
 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"), exports);
 //# sourceMappingURL=index.js.map

package/src/lib/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-ecies-lib/src/lib/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH,6DAAmC;AACnC,iDAAuB;AACvB,yDAA+B"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-ecies-lib/src/lib/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH,6DAAmC;AACnC,iDAAuB;AACvB,gEAAsC;AACtC,yDAA+B"}