@pristine-ts/common 3.0.1 → 3.0.2

package/dist/lib/cjs/managers/event-context.als.browser.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.eventContextStorage = void 0;
+/**
+ * Browser substitute for the Node `AsyncLocalStorage`-backed {@link EventContextStorage}.
+ * Browsers have no `async_hooks`, so this keeps the active `EventContext` in a single
+ * synchronous slot: it correctly scopes — and restores — the context for the synchronous
+ * portion of `run()` (including nested `run()` calls), but, unlike Node's
+ * `AsyncLocalStorage`, it cannot propagate across `await` boundaries, which no browser API
+ * supports.
+ */
+class SynchronousEventContextStorage {
+    run(store, callback) {
+        const previous = this.store;
+        this.store = store;
+        try {
+            return callback();
+        }
+        finally {
+            this.store = previous;
+        }
+    }
+    getStore() {
+        return this.store;
+    }
+}
+exports.eventContextStorage = new SynchronousEventContextStorage();
+//# sourceMappingURL=event-context.als.browser.js.map

package/dist/lib/cjs/managers/event-context.als.browser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-context.als.browser.js","sourceRoot":"","sources":["../../../../src/managers/event-context.als.browser.ts"],"names":[],"mappings":";;;AAGA;;;;;;;GAOG;AACH,MAAM,8BAA8B;IAGlC,GAAG,CAAI,KAAmB,EAAE,QAAiB;QAC3C,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC;QAC5B,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC;YACH,OAAO,QAAQ,EAAE,CAAC;QACpB,CAAC;gBAAS,CAAC;YACT,IAAI,CAAC,KAAK,GAAG,QAAQ,CAAC;QACxB,CAAC;IACH,CAAC;IAED,QAAQ;QACN,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;CACF;AAEY,QAAA,mBAAmB,GAAwB,IAAI,8BAA8B,EAAE,CAAC"}

package/dist/lib/cjs/managers/event-context.als.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.eventContextStorage = void 0;
+const async_hooks_1 = require("async_hooks");
+/**
+ * Process-wide storage backing the active `EventContext`. A single instance is essential —
+ * multiple `AsyncLocalStorage` instances would each track their own propagation chain and
+ * contexts wouldn't be visible across them. On Node this propagates the context across
+ * `await` boundaries, `Promise.all`, `setImmediate`, and the rest of the async machinery.
+ */
+exports.eventContextStorage = new async_hooks_1.AsyncLocalStorage();
+//# sourceMappingURL=event-context.als.js.map

package/dist/lib/cjs/managers/event-context.als.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-context.als.js","sourceRoot":"","sources":["../../../../src/managers/event-context.als.ts"],"names":[],"mappings":";;;AAAA,6CAA8C;AAe9C;;;;;GAKG;AACU,QAAA,mBAAmB,GAAwB,IAAI,+BAAiB,EAAgB,CAAC"}

package/dist/lib/cjs/managers/event-context.manager.js

@@ -8,8 +8,8 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
 var EventContextManager_1;
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.EventContextManager = void 0;
-const async_hooks_1 = require("async_hooks");
 const tsyringe_1 = require("tsyringe");
+const event_context_als_1 = require("./event-context.als");
 /**
  * Owns the `AsyncLocalStorage` instance that propagates the active `EventContext`
  * across `await` boundaries, `Promise.all`, `setImmediate`, and the rest of Node's
@@ -25,21 +25,20 @@ const tsyringe_1 = require("tsyringe");
  *     Captures the current context and returns a wrapped function that restores it
  *     on call.
  *
- * Why static state inside an `@injectable()` class: the `AsyncLocalStorage` instance
- * itself must be a single process-wide singleton — multiple instances would each track
- * their own propagation chain and contexts wouldn't be visible across them. Making the
- * ALS `private static readonly` while keeping the class `@injectable()` lets DI consumers
- * resolve it normally (and substitute fakes in tests) while the underlying state stays
- * shared and consistent.
+ * The backing storage lives in `./event-context.als` (a single process-wide
+ * `AsyncLocalStorage`) rather than being constructed here, so a browser build can swap it
+ * for a synchronous shim — `async_hooks` is Node-only. Keeping the storage shared while the
+ * class stays `@injectable()` lets DI consumers resolve the manager normally (and substitute
+ * fakes in tests) while the underlying state stays shared and consistent.
  */
 let EventContextManager = EventContextManager_1 = class EventContextManager {
     run(ctx, fn) {
-        return EventContextManager_1.als.run(ctx, fn);
+        return event_context_als_1.eventContextStorage.run(ctx, fn);
     }
     /** Returns the active `EventContext`, or `undefined` if no context is installed
      *  (i.e. we're outside any `run()` call). */
     current() {
-        return EventContextManager_1.als.getStore();
+        return event_context_als_1.eventContextStorage.getStore();
     }
     /** Convenience: the `eventId` of the active context, or `undefined`. */
     eventId() {
@@ -74,15 +73,14 @@ let EventContextManager = EventContextManager_1 = class EventContextManager {
         const ctx = this.current();
         if (ctx === undefined)
             return fn;
-        const als = EventContextManager_1.als;
-        return ((...args) => als.run(ctx, () => fn(...args)));
+        return ((...args) => event_context_als_1.eventContextStorage.run(ctx, () => fn(...args)));
     }
     // ── Static convenience mirrors. ────────────────────────────────────────────────
     // For callers that don't want DI noise (e.g. utility code, decorators, helpers
     // that don't have a constructor to inject through). All forwarding to the same
-    // shared ALS instance.
+    // shared storage instance.
     static current() {
-        return EventContextManager_1.als.getStore();
+        return event_context_als_1.eventContextStorage.getStore();
     }
     static eventId() {
         var _a;
@@ -104,12 +102,10 @@ let EventContextManager = EventContextManager_1 = class EventContextManager {
         const ctx = EventContextManager_1.current();
         if (ctx === undefined)
             return fn;
-        const als = EventContextManager_1.als;
-        return ((...args) => als.run(ctx, () => fn(...args)));
+        return ((...args) => event_context_als_1.eventContextStorage.run(ctx, () => fn(...args)));
     }
 };
 exports.EventContextManager = EventContextManager;
-EventContextManager.als = new async_hooks_1.AsyncLocalStorage();
 exports.EventContextManager = EventContextManager = EventContextManager_1 = __decorate([
     (0, tsyringe_1.injectable)()
 ], EventContextManager);

package/dist/lib/cjs/managers/event-context.manager.js.map

@@ -1 +1 @@
-{"version":3,"file":"event-context.manager.js","sourceRoot":"","sources":["../../../../src/managers/event-context.manager.ts"],"names":[],"mappings":";;;;;;;;;;AAAA,6CAA8C;AAC9C,uCAAyD;AAIzD;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEI,IAAM,mBAAmB,2BAAzB,MAAM,mBAAmB;IAU9B,GAAG,CAAI,GAAiB,EAAE,EAAwB;QAChD,OAAO,qBAAmB,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;IAC9C,CAAC;IAED;iDAC6C;IAC7C,OAAO;QACL,OAAO,qBAAmB,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC;IAC5C,CAAC;IAED,wEAAwE;IACxE,OAAO;;QACL,OAAO,MAAA,IAAI,CAAC,OAAO,EAAE,0CAAE,OAAO,CAAC;IACjC,CAAC;IAED,wEAAwE;IACxE,OAAO;;QACL,OAAO,MAAA,IAAI,CAAC,OAAO,EAAE,0CAAE,OAAO,CAAC;IACjC,CAAC;IAED,qEAAqE;IACrE,SAAS;;QACP,OAAO,MAAA,IAAI,CAAC,OAAO,EAAE,0CAAE,SAAS,CAAC;IACnC,CAAC;IAED,sFAAsF;IACtF,cAAc;;QACZ,OAAO,MAAA,IAAI,CAAC,OAAO,EAAE,0CAAE,cAAc,CAAC;IACxC,CAAC;IAED;;;;;;;;OAQG;IACH,IAAI,CAAoC,EAAK;QAC3C,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;QAC3B,IAAI,GAAG,KAAK,SAAS;YAAE,OAAO,EAAE,CAAC;QACjC,MAAM,GAAG,GAAG,qBAAmB,CAAC,GAAG,CAAC;QACpC,OAAO,CAAC,CAAC,GAAG,IAAW,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC,CAAM,CAAC;IACpE,CAAC;IAED,kFAAkF;IAClF,+EAA+E;IAC/E,+EAA+E;IAC/E,uBAAuB;IAEvB,MAAM,CAAC,OAAO;QACZ,OAAO,qBAAmB,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC;IAC5C,CAAC;IAED,MAAM,CAAC,OAAO;;QACZ,OAAO,MAAA,qBAAmB,CAAC,OAAO,EAAE,0CAAE,OAAO,CAAC;IAChD,CAAC;IAED,MAAM,CAAC,OAAO;;QACZ,OAAO,MAAA,qBAAmB,CAAC,OAAO,EAAE,0CAAE,OAAO,CAAC;IAChD,CAAC;IAED,MAAM,CAAC,SAAS;;QACd,OAAO,MAAA,qBAAmB,CAAC,OAAO,EAAE,0CAAE,SAAS,CAAC;IAClD,CAAC;IAED,MAAM,CAAC,cAAc;;QACnB,OAAO,MAAA,qBAAmB,CAAC,OAAO,EAAE,0CAAE,cAAc,CAAC;IACvD,CAAC;IAED,MAAM,CAAC,IAAI,CAAoC,EAAK;QAClD,MAAM,GAAG,GAAG,qBAAmB,CAAC,OAAO,EAAE,CAAC;QAC1C,IAAI,GAAG,KAAK,SAAS;YAAE,OAAO,EAAE,CAAC;QACjC,MAAM,GAAG,GAAG,qBAAmB,CAAC,GAAG,CAAC;QACpC,OAAO,CAAC,CAAC,GAAG,IAAW,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC,CAAM,CAAC;IACpE,CAAC;;AAtFU,kDAAmB;AACN,uBAAG,GAAG,IAAI,+BAAiB,EAAgB,AAAxC,CAAyC;8BADzD,mBAAmB;IAD/B,IAAA,qBAAU,GAAE;GACA,mBAAmB,CAuF/B"}
+{"version":3,"file":"event-context.manager.js","sourceRoot":"","sources":["../../../../src/managers/event-context.manager.ts"],"names":[],"mappings":";;;;;;;;;;AAAA,uCAAyD;AAGzD,2DAAwD;AAExD;;;;;;;;;;;;;;;;;;;;GAoBG;AAEI,IAAM,mBAAmB,2BAAzB,MAAM,mBAAmB;IAQ9B,GAAG,CAAI,GAAiB,EAAE,EAAwB;QAChD,OAAO,uCAAmB,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;IAC1C,CAAC;IAED;iDAC6C;IAC7C,OAAO;QACL,OAAO,uCAAmB,CAAC,QAAQ,EAAE,CAAC;IACxC,CAAC;IAED,wEAAwE;IACxE,OAAO;;QACL,OAAO,MAAA,IAAI,CAAC,OAAO,EAAE,0CAAE,OAAO,CAAC;IACjC,CAAC;IAED,wEAAwE;IACxE,OAAO;;QACL,OAAO,MAAA,IAAI,CAAC,OAAO,EAAE,0CAAE,OAAO,CAAC;IACjC,CAAC;IAED,qEAAqE;IACrE,SAAS;;QACP,OAAO,MAAA,IAAI,CAAC,OAAO,EAAE,0CAAE,SAAS,CAAC;IACnC,CAAC;IAED,sFAAsF;IACtF,cAAc;;QACZ,OAAO,MAAA,IAAI,CAAC,OAAO,EAAE,0CAAE,cAAc,CAAC;IACxC,CAAC;IAED;;;;;;;;OAQG;IACH,IAAI,CAAoC,EAAK;QAC3C,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;QAC3B,IAAI,GAAG,KAAK,SAAS;YAAE,OAAO,EAAE,CAAC;QACjC,OAAO,CAAC,CAAC,GAAG,IAAW,EAAE,EAAE,CAAC,uCAAmB,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC,CAAM,CAAC;IACpF,CAAC;IAED,kFAAkF;IAClF,+EAA+E;IAC/E,+EAA+E;IAC/E,2BAA2B;IAE3B,MAAM,CAAC,OAAO;QACZ,OAAO,uCAAmB,CAAC,QAAQ,EAAE,CAAC;IACxC,CAAC;IAED,MAAM,CAAC,OAAO;;QACZ,OAAO,MAAA,qBAAmB,CAAC,OAAO,EAAE,0CAAE,OAAO,CAAC;IAChD,CAAC;IAED,MAAM,CAAC,OAAO;;QACZ,OAAO,MAAA,qBAAmB,CAAC,OAAO,EAAE,0CAAE,OAAO,CAAC;IAChD,CAAC;IAED,MAAM,CAAC,SAAS;;QACd,OAAO,MAAA,qBAAmB,CAAC,OAAO,EAAE,0CAAE,SAAS,CAAC;IAClD,CAAC;IAED,MAAM,CAAC,cAAc;;QACnB,OAAO,MAAA,qBAAmB,CAAC,OAAO,EAAE,0CAAE,cAAc,CAAC;IACvD,CAAC;IAED,MAAM,CAAC,IAAI,CAAoC,EAAK;QAClD,MAAM,GAAG,GAAG,qBAAmB,CAAC,OAAO,EAAE,CAAC;QAC1C,IAAI,GAAG,KAAK,SAAS;YAAE,OAAO,EAAE,CAAC;QACjC,OAAO,CAAC,CAAC,GAAG,IAAW,EAAE,EAAE,CAAC,uCAAmB,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC,CAAM,CAAC;IACpF,CAAC;CACF,CAAA;AAnFY,kDAAmB;8BAAnB,mBAAmB;IAD/B,IAAA,qBAAU,GAAE;GACA,mBAAmB,CAmF/B"}

package/dist/lib/cjs/models/span.model.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Span = void 0;
-const crypto_1 = require("crypto");
+const uuid_util_1 = require("../utils/uuid.util");
 /**
  * This model represents a span.
  */
@@ -40,7 +40,7 @@ class Span {
          * Whether or not the span is in progress, meaning it has not ended.
          */
         this.inProgress = true;
-        this.id = id !== null && id !== void 0 ? id : (0, crypto_1.randomUUID)();
+        this.id = id !== null && id !== void 0 ? id : uuid_util_1.UuidGenerator.generate();
         this.context = context !== null && context !== void 0 ? context : {};
     }
     /**

package/dist/lib/cjs/models/span.model.js.map

@@ -1 +1 @@
-{"version":3,"file":"span.model.js","sourceRoot":"","sources":["../../../../src/models/span.model.ts"],"names":[],"mappings":";;;AAAA,mCAAkC;AAKlC;;GAEG;AACH,MAAa,IAAI;IA0Df;;;;;OAKG;IACH,YAA0B,OAAe,EAAE,EAAW,EAAE,OAAmC;QAAjE,YAAO,GAAP,OAAO,CAAQ;QA/CzC;;WAEG;QACI,cAAS,GAAW,IAAI,CAAC,GAAG,EAAE,CAAC;QAYtC;;WAEG;QACI,aAAQ,GAAW,EAAE,CAAC;QAE7B;;;;;;;;WAQG;QACI,YAAO,GAAiB,EAAE,CAAC;QAElC;;WAEG;QACI,YAAO,GAA8B,EAAE,CAAC;QAE/C;;WAEG;QACI,eAAU,GAAG,IAAI,CAAC;QASvB,IAAI,CAAC,EAAE,GAAG,EAAE,aAAF,EAAE,cAAF,EAAE,GAAI,IAAA,mBAAU,GAAE,CAAC;QAC7B,IAAI,CAAC,OAAO,GAAG,OAAO,aAAP,OAAO,cAAP,OAAO,GAAI,EAAE,CAAC;IAC/B,CAAC;IAED;;OAEG;IACI,WAAW;;QAChB,OAAO,CAAC,MAAA,IAAI,CAAC,OAAO,mCAAI,IAAI,CAAC,GAAG,EAAE,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC;IACvD,CAAC;IAED;;OAEG;IACI,GAAG;;QACR,MAAA,IAAI,CAAC,cAAc,0CAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IACrC,CAAC;IAED;;;OAGG;IACI,QAAQ,CAAC,KAAY;QAC1B,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QAEnB,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC,SAAS,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;IAChE,CAAC;IAED;;;OAGG;IACI,QAAQ,CAAC,IAAU;QACxB,MAAM,iBAAiB,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,SAAS,CAAC,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC,CAAC;QAEpF,IAAI,iBAAiB,EAAE,CAAC;YACtB,OAAO;QACT,CAAC;QAED,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;QACvB,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC3B,CAAC;CACF;AA3GD,oBA2GC"}
+{"version":3,"file":"span.model.js","sourceRoot":"","sources":["../../../../src/models/span.model.ts"],"names":[],"mappings":";;;AAAA,kDAAiD;AAKjD;;GAEG;AACH,MAAa,IAAI;IA0Df;;;;;OAKG;IACH,YAA0B,OAAe,EAAE,EAAW,EAAE,OAAmC;QAAjE,YAAO,GAAP,OAAO,CAAQ;QA/CzC;;WAEG;QACI,cAAS,GAAW,IAAI,CAAC,GAAG,EAAE,CAAC;QAYtC;;WAEG;QACI,aAAQ,GAAW,EAAE,CAAC;QAE7B;;;;;;;;WAQG;QACI,YAAO,GAAiB,EAAE,CAAC;QAElC;;WAEG;QACI,YAAO,GAA8B,EAAE,CAAC;QAE/C;;WAEG;QACI,eAAU,GAAG,IAAI,CAAC;QASvB,IAAI,CAAC,EAAE,GAAG,EAAE,aAAF,EAAE,cAAF,EAAE,GAAI,yBAAa,CAAC,QAAQ,EAAE,CAAC;QACzC,IAAI,CAAC,OAAO,GAAG,OAAO,aAAP,OAAO,cAAP,OAAO,GAAI,EAAE,CAAC;IAC/B,CAAC;IAED;;OAEG;IACI,WAAW;;QAChB,OAAO,CAAC,MAAA,IAAI,CAAC,OAAO,mCAAI,IAAI,CAAC,GAAG,EAAE,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC;IACvD,CAAC;IAED;;OAEG;IACI,GAAG;;QACR,MAAA,IAAI,CAAC,cAAc,0CAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IACrC,CAAC;IAED;;;OAGG;IACI,QAAQ,CAAC,KAAY;QAC1B,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QAEnB,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC,SAAS,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;IAChE,CAAC;IAED;;;OAGG;IACI,QAAQ,CAAC,IAAU;QACxB,MAAM,iBAAiB,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,SAAS,CAAC,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC,CAAC;QAEpF,IAAI,iBAAiB,EAAE,CAAC;YACtB,OAAO;QACT,CAAC;QAED,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;QACvB,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC3B,CAAC;CACF;AA3GD,oBA2GC"}

package/dist/lib/cjs/models/trace.model.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Trace = void 0;
-const crypto_1 = require("crypto");
+const uuid_util_1 = require("../utils/uuid.util");
 /**
  * This model represents a trace.
  */
@@ -31,7 +31,7 @@ class Trace {
          * Whether or not the trace was ended.
          */
         this.hasEnded = false;
-        this.id = id !== null && id !== void 0 ? id : (0, crypto_1.randomUUID)();
+        this.id = id !== null && id !== void 0 ? id : uuid_util_1.UuidGenerator.generate();
         this.context = context !== null && context !== void 0 ? context : {};
     }
     /**

package/dist/lib/cjs/models/trace.model.js.map

@@ -1 +1 @@
-{"version":3,"file":"trace.model.js","sourceRoot":"","sources":["../../../../src/models/trace.model.ts"],"names":[],"mappings":";;;AAAA,mCAAkC;AAGlC;;GAEG;AACH,MAAa,KAAK;IAuChB;;;;OAIG;IACH,YAAmB,EAAW,EAAE,OAAmC;QAtCnE;;WAEG;QACI,cAAS,GAAW,IAAI,CAAC,GAAG,EAAE,CAAC;QAYtC;;;;;WAKG;QACI,mBAAc,GAAkC,EAAE,CAAC;QAE1D;;WAEG;QACI,YAAO,GAA+B,EAAE,CAAC;QAEhD;;WAEG;QACI,aAAQ,GAAY,KAAK,CAAC;QAQ/B,IAAI,CAAC,EAAE,GAAG,EAAE,aAAF,EAAE,cAAF,EAAE,GAAI,IAAA,mBAAU,GAAE,CAAC;QAC7B,IAAI,CAAC,OAAO,GAAG,OAAO,aAAP,OAAO,cAAP,OAAO,GAAI,EAAE,CAAC;IAC/B,CAAC;IAED;;OAEG;IACI,WAAW;;QAChB,OAAO,CAAC,MAAA,IAAI,CAAC,OAAO,mCAAI,IAAI,CAAC,GAAG,EAAE,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC;IACvD,CAAC;CACF;AAvDD,sBAuDC"}
+{"version":3,"file":"trace.model.js","sourceRoot":"","sources":["../../../../src/models/trace.model.ts"],"names":[],"mappings":";;;AAAA,kDAAiD;AAGjD;;GAEG;AACH,MAAa,KAAK;IAuChB;;;;OAIG;IACH,YAAmB,EAAW,EAAE,OAAmC;QAtCnE;;WAEG;QACI,cAAS,GAAW,IAAI,CAAC,GAAG,EAAE,CAAC;QAYtC;;;;;WAKG;QACI,mBAAc,GAAkC,EAAE,CAAC;QAE1D;;WAEG;QACI,YAAO,GAA+B,EAAE,CAAC;QAEhD;;WAEG;QACI,aAAQ,GAAY,KAAK,CAAC;QAQ/B,IAAI,CAAC,EAAE,GAAG,EAAE,aAAF,EAAE,cAAF,EAAE,GAAI,yBAAa,CAAC,QAAQ,EAAE,CAAC;QACzC,IAAI,CAAC,OAAO,GAAG,OAAO,aAAP,OAAO,cAAP,OAAO,GAAI,EAAE,CAAC;IAC/B,CAAC;IAED;;OAEG;IACI,WAAW;;QAChB,OAAO,CAAC,MAAA,IAAI,CAAC,OAAO,mCAAI,IAAI,CAAC,GAAG,EAAE,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC;IACvD,CAAC;CACF;AAvDD,sBAuDC"}

package/dist/lib/cjs/utils/utils.js

@@ -18,4 +18,5 @@ __exportStar(require("./date.util"), exports);
 __exportStar(require("./enum.util"), exports);
 __exportStar(require("./metadata.util"), exports);
 __exportStar(require("./object.util"), exports);
+__exportStar(require("./uuid.util"), exports);
 //# sourceMappingURL=utils.js.map

package/dist/lib/cjs/utils/utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../../src/utils/utils.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,8CAA4B;AAC5B,8CAA4B;AAC5B,kDAAgC;AAChC,gDAA8B"}
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../../src/utils/utils.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,8CAA4B;AAC5B,8CAA4B;AAC5B,kDAAgC;AAChC,gDAA8B;AAC9B,8CAA4B"}

package/dist/lib/cjs/utils/uuid.util.js

@@ -0,0 +1,46 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UuidGenerator = void 0;
+/**
+ * Cross-runtime UUID generation. Replaces Node's `crypto.randomUUID()` with the Web Crypto
+ * API exposed on `globalThis.crypto`, which is available in browsers, Node.js (19+), Deno,
+ * Bun and Cloudflare Workers — keeping `@pristine-ts/common` importable outside Node without
+ * pulling in the Node-only `crypto` module.
+ */
+class UuidGenerator {
+    /**
+     * Returns an RFC 4122 version 4 UUID. Prefers the native `crypto.randomUUID()`, then
+     * derives one from `crypto.getRandomValues()`, and only as a last resort (no Web Crypto at
+     * all) falls back to `Math.random()` — which is NOT cryptographically secure but keeps
+     * exotic runtimes working rather than throwing.
+     */
+    static generate() {
+        const webCrypto = globalThis.crypto;
+        if (typeof (webCrypto === null || webCrypto === void 0 ? void 0 : webCrypto.randomUUID) === "function") {
+            return webCrypto.randomUUID();
+        }
+        if (typeof (webCrypto === null || webCrypto === void 0 ? void 0 : webCrypto.getRandomValues) === "function") {
+            const bytes = webCrypto.getRandomValues(new Uint8Array(16));
+            // Set the version (4) and variant (RFC 4122) bits.
+            bytes[6] = (bytes[6] & 0x0f) | 0x40;
+            bytes[8] = (bytes[8] & 0x3f) | 0x80;
+            const hex = [];
+            for (let i = 0; i < bytes.length; i++) {
+                hex.push(bytes[i].toString(16).padStart(2, "0"));
+            }
+            return (hex.slice(0, 4).join("") + "-" +
+                hex.slice(4, 6).join("") + "-" +
+                hex.slice(6, 8).join("") + "-" +
+                hex.slice(8, 10).join("") + "-" +
+                hex.slice(10, 16).join(""));
+        }
+        // Last-resort, non-cryptographic fallback.
+        return "xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(/[xy]/g, (char) => {
+            const random = (Math.random() * 16) | 0;
+            const value = char === "x" ? random : (random & 0x3) | 0x8;
+            return value.toString(16);
+        });
+    }
+}
+exports.UuidGenerator = UuidGenerator;
+//# sourceMappingURL=uuid.util.js.map

package/dist/lib/cjs/utils/uuid.util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"uuid.util.js","sourceRoot":"","sources":["../../../../src/utils/uuid.util.ts"],"names":[],"mappings":";;;AASA;;;;;GAKG;AACH,MAAa,aAAa;IACxB;;;;;OAKG;IACI,MAAM,CAAC,QAAQ;QACpB,MAAM,SAAS,GAA+B,UAAyC,CAAC,MAAM,CAAC;QAE/F,IAAI,OAAO,CAAA,SAAS,aAAT,SAAS,uBAAT,SAAS,CAAE,UAAU,CAAA,KAAK,UAAU,EAAE,CAAC;YAChD,OAAO,SAAS,CAAC,UAAU,EAAE,CAAC;QAChC,CAAC;QAED,IAAI,OAAO,CAAA,SAAS,aAAT,SAAS,uBAAT,SAAS,CAAE,eAAe,CAAA,KAAK,UAAU,EAAE,CAAC;YACrD,MAAM,KAAK,GAAG,SAAS,CAAC,eAAe,CAAC,IAAI,UAAU,CAAC,EAAE,CAAC,CAAC,CAAC;YAC5D,mDAAmD;YACnD,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC;YACpC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC;YAEpC,MAAM,GAAG,GAAa,EAAE,CAAC;YACzB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;gBACtC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;YACnD,CAAC;YAED,OAAO,CACL,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,GAAG,GAAG;gBAC9B,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,GAAG,GAAG;gBAC9B,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,GAAG,GAAG;gBAC9B,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,GAAG,GAAG;gBAC/B,GAAG,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAC3B,CAAC;QACJ,CAAC;QAED,2CAA2C;QAC3C,OAAO,sCAAsC,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE;YACtE,MAAM,MAAM,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC;YACxC,MAAM,KAAK,GAAG,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC;YAC3D,OAAO,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;QAC5B,CAAC,CAAC,CAAC;IACL,CAAC;CACF;AAzCD,sCAyCC"}

package/dist/lib/esm/managers/event-context.als.browser.js

@@ -0,0 +1,25 @@
+/**
+ * Browser substitute for the Node `AsyncLocalStorage`-backed {@link EventContextStorage}.
+ * Browsers have no `async_hooks`, so this keeps the active `EventContext` in a single
+ * synchronous slot: it correctly scopes — and restores — the context for the synchronous
+ * portion of `run()` (including nested `run()` calls), but, unlike Node's
+ * `AsyncLocalStorage`, it cannot propagate across `await` boundaries, which no browser API
+ * supports.
+ */
+class SynchronousEventContextStorage {
+    run(store, callback) {
+        const previous = this.store;
+        this.store = store;
+        try {
+            return callback();
+        }
+        finally {
+            this.store = previous;
+        }
+    }
+    getStore() {
+        return this.store;
+    }
+}
+export const eventContextStorage = new SynchronousEventContextStorage();
+//# sourceMappingURL=event-context.als.browser.js.map

package/dist/lib/esm/managers/event-context.als.browser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-context.als.browser.js","sourceRoot":"","sources":["../../../../src/managers/event-context.als.browser.ts"],"names":[],"mappings":"AAGA;;;;;;;GAOG;AACH,MAAM,8BAA8B;IAGlC,GAAG,CAAI,KAAmB,EAAE,QAAiB;QAC3C,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC;QAC5B,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC;YACH,OAAO,QAAQ,EAAE,CAAC;QACpB,CAAC;gBAAS,CAAC;YACT,IAAI,CAAC,KAAK,GAAG,QAAQ,CAAC;QACxB,CAAC;IACH,CAAC;IAED,QAAQ;QACN,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;CACF;AAED,MAAM,CAAC,MAAM,mBAAmB,GAAwB,IAAI,8BAA8B,EAAE,CAAC"}

package/dist/lib/esm/managers/event-context.als.js

@@ -0,0 +1,9 @@
+import { AsyncLocalStorage } from "async_hooks";
+/**
+ * Process-wide storage backing the active `EventContext`. A single instance is essential —
+ * multiple `AsyncLocalStorage` instances would each track their own propagation chain and
+ * contexts wouldn't be visible across them. On Node this propagates the context across
+ * `await` boundaries, `Promise.all`, `setImmediate`, and the rest of the async machinery.
+ */
+export const eventContextStorage = new AsyncLocalStorage();
+//# sourceMappingURL=event-context.als.js.map

package/dist/lib/esm/managers/event-context.als.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-context.als.js","sourceRoot":"","sources":["../../../../src/managers/event-context.als.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,iBAAiB,EAAC,MAAM,aAAa,CAAC;AAe9C;;;;;GAKG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAwB,IAAI,iBAAiB,EAAgB,CAAC"}

package/dist/lib/esm/managers/event-context.manager.js

@@ -5,8 +5,8 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
     return c > 3 && r && Object.defineProperty(target, key, r), r;
 };
 var EventContextManager_1;
-import { AsyncLocalStorage } from "async_hooks";
 import { injectable } from "tsyringe";
+import { eventContextStorage } from "./event-context.als";
 /**
  * Owns the `AsyncLocalStorage` instance that propagates the active `EventContext`
  * across `await` boundaries, `Promise.all`, `setImmediate`, and the rest of Node's
@@ -22,21 +22,20 @@ import { injectable } from "tsyringe";
  *     Captures the current context and returns a wrapped function that restores it
  *     on call.
  *
- * Why static state inside an `@injectable()` class: the `AsyncLocalStorage` instance
- * itself must be a single process-wide singleton — multiple instances would each track
- * their own propagation chain and contexts wouldn't be visible across them. Making the
- * ALS `private static readonly` while keeping the class `@injectable()` lets DI consumers
- * resolve it normally (and substitute fakes in tests) while the underlying state stays
- * shared and consistent.
+ * The backing storage lives in `./event-context.als` (a single process-wide
+ * `AsyncLocalStorage`) rather than being constructed here, so a browser build can swap it
+ * for a synchronous shim — `async_hooks` is Node-only. Keeping the storage shared while the
+ * class stays `@injectable()` lets DI consumers resolve the manager normally (and substitute
+ * fakes in tests) while the underlying state stays shared and consistent.
  */
 let EventContextManager = EventContextManager_1 = class EventContextManager {
     run(ctx, fn) {
-        return EventContextManager_1.als.run(ctx, fn);
+        return eventContextStorage.run(ctx, fn);
     }
     /** Returns the active `EventContext`, or `undefined` if no context is installed
      *  (i.e. we're outside any `run()` call). */
     current() {
-        return EventContextManager_1.als.getStore();
+        return eventContextStorage.getStore();
     }
     /** Convenience: the `eventId` of the active context, or `undefined`. */
     eventId() {
@@ -71,15 +70,14 @@ let EventContextManager = EventContextManager_1 = class EventContextManager {
         const ctx = this.current();
         if (ctx === undefined)
             return fn;
-        const als = EventContextManager_1.als;
-        return ((...args) => als.run(ctx, () => fn(...args)));
+        return ((...args) => eventContextStorage.run(ctx, () => fn(...args)));
     }
     // ── Static convenience mirrors. ────────────────────────────────────────────────
     // For callers that don't want DI noise (e.g. utility code, decorators, helpers
     // that don't have a constructor to inject through). All forwarding to the same
-    // shared ALS instance.
+    // shared storage instance.
     static current() {
-        return EventContextManager_1.als.getStore();
+        return eventContextStorage.getStore();
     }
     static eventId() {
         var _a;
@@ -101,11 +99,9 @@ let EventContextManager = EventContextManager_1 = class EventContextManager {
         const ctx = EventContextManager_1.current();
         if (ctx === undefined)
             return fn;
-        const als = EventContextManager_1.als;
-        return ((...args) => als.run(ctx, () => fn(...args)));
+        return ((...args) => eventContextStorage.run(ctx, () => fn(...args)));
     }
 };
-EventContextManager.als = new AsyncLocalStorage();
 EventContextManager = EventContextManager_1 = __decorate([
     injectable()
 ], EventContextManager);

package/dist/lib/esm/managers/event-context.manager.js.map

@@ -1 +1 @@
-{"version":3,"file":"event-context.manager.js","sourceRoot":"","sources":["../../../../src/managers/event-context.manager.ts"],"names":[],"mappings":";;;;;;;AAAA,OAAO,EAAC,iBAAiB,EAAC,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAsB,UAAU,EAAC,MAAM,UAAU,CAAC;AAIzD;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEI,IAAM,mBAAmB,2BAAzB,MAAM,mBAAmB;IAU9B,GAAG,CAAI,GAAiB,EAAE,EAAwB;QAChD,OAAO,qBAAmB,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;IAC9C,CAAC;IAED;iDAC6C;IAC7C,OAAO;QACL,OAAO,qBAAmB,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC;IAC5C,CAAC;IAED,wEAAwE;IACxE,OAAO;;QACL,OAAO,MAAA,IAAI,CAAC,OAAO,EAAE,0CAAE,OAAO,CAAC;IACjC,CAAC;IAED,wEAAwE;IACxE,OAAO;;QACL,OAAO,MAAA,IAAI,CAAC,OAAO,EAAE,0CAAE,OAAO,CAAC;IACjC,CAAC;IAED,qEAAqE;IACrE,SAAS;;QACP,OAAO,MAAA,IAAI,CAAC,OAAO,EAAE,0CAAE,SAAS,CAAC;IACnC,CAAC;IAED,sFAAsF;IACtF,cAAc;;QACZ,OAAO,MAAA,IAAI,CAAC,OAAO,EAAE,0CAAE,cAAc,CAAC;IACxC,CAAC;IAED;;;;;;;;OAQG;IACH,IAAI,CAAoC,EAAK;QAC3C,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;QAC3B,IAAI,GAAG,KAAK,SAAS;YAAE,OAAO,EAAE,CAAC;QACjC,MAAM,GAAG,GAAG,qBAAmB,CAAC,GAAG,CAAC;QACpC,OAAO,CAAC,CAAC,GAAG,IAAW,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC,CAAM,CAAC;IACpE,CAAC;IAED,kFAAkF;IAClF,+EAA+E;IAC/E,+EAA+E;IAC/E,uBAAuB;IAEvB,MAAM,CAAC,OAAO;QACZ,OAAO,qBAAmB,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC;IAC5C,CAAC;IAED,MAAM,CAAC,OAAO;;QACZ,OAAO,MAAA,qBAAmB,CAAC,OAAO,EAAE,0CAAE,OAAO,CAAC;IAChD,CAAC;IAED,MAAM,CAAC,OAAO;;QACZ,OAAO,MAAA,qBAAmB,CAAC,OAAO,EAAE,0CAAE,OAAO,CAAC;IAChD,CAAC;IAED,MAAM,CAAC,SAAS;;QACd,OAAO,MAAA,qBAAmB,CAAC,OAAO,EAAE,0CAAE,SAAS,CAAC;IAClD,CAAC;IAED,MAAM,CAAC,cAAc;;QACnB,OAAO,MAAA,qBAAmB,CAAC,OAAO,EAAE,0CAAE,cAAc,CAAC;IACvD,CAAC;IAED,MAAM,CAAC,IAAI,CAAoC,EAAK;QAClD,MAAM,GAAG,GAAG,qBAAmB,CAAC,OAAO,EAAE,CAAC;QAC1C,IAAI,GAAG,KAAK,SAAS;YAAE,OAAO,EAAE,CAAC;QACjC,MAAM,GAAG,GAAG,qBAAmB,CAAC,GAAG,CAAC;QACpC,OAAO,CAAC,CAAC,GAAG,IAAW,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC,CAAM,CAAC;IACpE,CAAC;;AArFuB,uBAAG,GAAG,IAAI,iBAAiB,EAAgB,AAAxC,CAAyC;AADzD,mBAAmB;IAD/B,UAAU,EAAE;GACA,mBAAmB,CAuF/B"}
+{"version":3,"file":"event-context.manager.js","sourceRoot":"","sources":["../../../../src/managers/event-context.manager.ts"],"names":[],"mappings":";;;;;;;AAAA,OAAO,EAAsB,UAAU,EAAC,MAAM,UAAU,CAAC;AAGzD,OAAO,EAAC,mBAAmB,EAAC,MAAM,qBAAqB,CAAC;AAExD;;;;;;;;;;;;;;;;;;;;GAoBG;AAEI,IAAM,mBAAmB,2BAAzB,MAAM,mBAAmB;IAQ9B,GAAG,CAAI,GAAiB,EAAE,EAAwB;QAChD,OAAO,mBAAmB,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;IAC1C,CAAC;IAED;iDAC6C;IAC7C,OAAO;QACL,OAAO,mBAAmB,CAAC,QAAQ,EAAE,CAAC;IACxC,CAAC;IAED,wEAAwE;IACxE,OAAO;;QACL,OAAO,MAAA,IAAI,CAAC,OAAO,EAAE,0CAAE,OAAO,CAAC;IACjC,CAAC;IAED,wEAAwE;IACxE,OAAO;;QACL,OAAO,MAAA,IAAI,CAAC,OAAO,EAAE,0CAAE,OAAO,CAAC;IACjC,CAAC;IAED,qEAAqE;IACrE,SAAS;;QACP,OAAO,MAAA,IAAI,CAAC,OAAO,EAAE,0CAAE,SAAS,CAAC;IACnC,CAAC;IAED,sFAAsF;IACtF,cAAc;;QACZ,OAAO,MAAA,IAAI,CAAC,OAAO,EAAE,0CAAE,cAAc,CAAC;IACxC,CAAC;IAED;;;;;;;;OAQG;IACH,IAAI,CAAoC,EAAK;QAC3C,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;QAC3B,IAAI,GAAG,KAAK,SAAS;YAAE,OAAO,EAAE,CAAC;QACjC,OAAO,CAAC,CAAC,GAAG,IAAW,EAAE,EAAE,CAAC,mBAAmB,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC,CAAM,CAAC;IACpF,CAAC;IAED,kFAAkF;IAClF,+EAA+E;IAC/E,+EAA+E;IAC/E,2BAA2B;IAE3B,MAAM,CAAC,OAAO;QACZ,OAAO,mBAAmB,CAAC,QAAQ,EAAE,CAAC;IACxC,CAAC;IAED,MAAM,CAAC,OAAO;;QACZ,OAAO,MAAA,qBAAmB,CAAC,OAAO,EAAE,0CAAE,OAAO,CAAC;IAChD,CAAC;IAED,MAAM,CAAC,OAAO;;QACZ,OAAO,MAAA,qBAAmB,CAAC,OAAO,EAAE,0CAAE,OAAO,CAAC;IAChD,CAAC;IAED,MAAM,CAAC,SAAS;;QACd,OAAO,MAAA,qBAAmB,CAAC,OAAO,EAAE,0CAAE,SAAS,CAAC;IAClD,CAAC;IAED,MAAM,CAAC,cAAc;;QACnB,OAAO,MAAA,qBAAmB,CAAC,OAAO,EAAE,0CAAE,cAAc,CAAC;IACvD,CAAC;IAED,MAAM,CAAC,IAAI,CAAoC,EAAK;QAClD,MAAM,GAAG,GAAG,qBAAmB,CAAC,OAAO,EAAE,CAAC;QAC1C,IAAI,GAAG,KAAK,SAAS;YAAE,OAAO,EAAE,CAAC;QACjC,OAAO,CAAC,CAAC,GAAG,IAAW,EAAE,EAAE,CAAC,mBAAmB,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC,CAAM,CAAC;IACpF,CAAC;CACF,CAAA;AAnFY,mBAAmB;IAD/B,UAAU,EAAE;GACA,mBAAmB,CAmF/B"}

package/dist/lib/esm/models/span.model.js

@@ -1,4 +1,4 @@
-import { randomUUID } from "crypto";
+import { UuidGenerator } from "../utils/uuid.util";
 /**
  * This model represents a span.
  */
@@ -37,7 +37,7 @@ export class Span {
          * Whether or not the span is in progress, meaning it has not ended.
          */
         this.inProgress = true;
-        this.id = id !== null && id !== void 0 ? id : randomUUID();
+        this.id = id !== null && id !== void 0 ? id : UuidGenerator.generate();
         this.context = context !== null && context !== void 0 ? context : {};
     }
     /**

package/dist/lib/esm/models/span.model.js.map

@@ -1 +1 @@
-{"version":3,"file":"span.model.js","sourceRoot":"","sources":["../../../../src/models/span.model.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,UAAU,EAAC,MAAM,QAAQ,CAAC;AAKlC;;GAEG;AACH,MAAM,OAAO,IAAI;IA0Df;;;;;OAKG;IACH,YAA0B,OAAe,EAAE,EAAW,EAAE,OAAmC;QAAjE,YAAO,GAAP,OAAO,CAAQ;QA/CzC;;WAEG;QACI,cAAS,GAAW,IAAI,CAAC,GAAG,EAAE,CAAC;QAYtC;;WAEG;QACI,aAAQ,GAAW,EAAE,CAAC;QAE7B;;;;;;;;WAQG;QACI,YAAO,GAAiB,EAAE,CAAC;QAElC;;WAEG;QACI,YAAO,GAA8B,EAAE,CAAC;QAE/C;;WAEG;QACI,eAAU,GAAG,IAAI,CAAC;QASvB,IAAI,CAAC,EAAE,GAAG,EAAE,aAAF,EAAE,cAAF,EAAE,GAAI,UAAU,EAAE,CAAC;QAC7B,IAAI,CAAC,OAAO,GAAG,OAAO,aAAP,OAAO,cAAP,OAAO,GAAI,EAAE,CAAC;IAC/B,CAAC;IAED;;OAEG;IACI,WAAW;;QAChB,OAAO,CAAC,MAAA,IAAI,CAAC,OAAO,mCAAI,IAAI,CAAC,GAAG,EAAE,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC;IACvD,CAAC;IAED;;OAEG;IACI,GAAG;;QACR,MAAA,IAAI,CAAC,cAAc,0CAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IACrC,CAAC;IAED;;;OAGG;IACI,QAAQ,CAAC,KAAY;QAC1B,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QAEnB,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC,SAAS,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;IAChE,CAAC;IAED;;;OAGG;IACI,QAAQ,CAAC,IAAU;QACxB,MAAM,iBAAiB,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,SAAS,CAAC,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC,CAAC;QAEpF,IAAI,iBAAiB,EAAE,CAAC;YACtB,OAAO;QACT,CAAC;QAED,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;QACvB,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC3B,CAAC;CACF"}
+{"version":3,"file":"span.model.js","sourceRoot":"","sources":["../../../../src/models/span.model.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,aAAa,EAAC,MAAM,oBAAoB,CAAC;AAKjD;;GAEG;AACH,MAAM,OAAO,IAAI;IA0Df;;;;;OAKG;IACH,YAA0B,OAAe,EAAE,EAAW,EAAE,OAAmC;QAAjE,YAAO,GAAP,OAAO,CAAQ;QA/CzC;;WAEG;QACI,cAAS,GAAW,IAAI,CAAC,GAAG,EAAE,CAAC;QAYtC;;WAEG;QACI,aAAQ,GAAW,EAAE,CAAC;QAE7B;;;;;;;;WAQG;QACI,YAAO,GAAiB,EAAE,CAAC;QAElC;;WAEG;QACI,YAAO,GAA8B,EAAE,CAAC;QAE/C;;WAEG;QACI,eAAU,GAAG,IAAI,CAAC;QASvB,IAAI,CAAC,EAAE,GAAG,EAAE,aAAF,EAAE,cAAF,EAAE,GAAI,aAAa,CAAC,QAAQ,EAAE,CAAC;QACzC,IAAI,CAAC,OAAO,GAAG,OAAO,aAAP,OAAO,cAAP,OAAO,GAAI,EAAE,CAAC;IAC/B,CAAC;IAED;;OAEG;IACI,WAAW;;QAChB,OAAO,CAAC,MAAA,IAAI,CAAC,OAAO,mCAAI,IAAI,CAAC,GAAG,EAAE,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC;IACvD,CAAC;IAED;;OAEG;IACI,GAAG;;QACR,MAAA,IAAI,CAAC,cAAc,0CAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IACrC,CAAC;IAED;;;OAGG;IACI,QAAQ,CAAC,KAAY;QAC1B,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QAEnB,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC,SAAS,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;IAChE,CAAC;IAED;;;OAGG;IACI,QAAQ,CAAC,IAAU;QACxB,MAAM,iBAAiB,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,SAAS,CAAC,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC,CAAC;QAEpF,IAAI,iBAAiB,EAAE,CAAC;YACtB,OAAO;QACT,CAAC;QAED,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;QACvB,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC3B,CAAC;CACF"}

package/dist/lib/esm/models/trace.model.js

@@ -1,4 +1,4 @@
-import { randomUUID } from "crypto";
+import { UuidGenerator } from "../utils/uuid.util";
 /**
  * This model represents a trace.
  */
@@ -28,7 +28,7 @@ export class Trace {
          * Whether or not the trace was ended.
          */
         this.hasEnded = false;
-        this.id = id !== null && id !== void 0 ? id : randomUUID();
+        this.id = id !== null && id !== void 0 ? id : UuidGenerator.generate();
         this.context = context !== null && context !== void 0 ? context : {};
     }
     /**

package/dist/lib/esm/models/trace.model.js.map

@@ -1 +1 @@
-{"version":3,"file":"trace.model.js","sourceRoot":"","sources":["../../../../src/models/trace.model.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,UAAU,EAAC,MAAM,QAAQ,CAAC;AAGlC;;GAEG;AACH,MAAM,OAAO,KAAK;IAuChB;;;;OAIG;IACH,YAAmB,EAAW,EAAE,OAAmC;QAtCnE;;WAEG;QACI,cAAS,GAAW,IAAI,CAAC,GAAG,EAAE,CAAC;QAYtC;;;;;WAKG;QACI,mBAAc,GAAkC,EAAE,CAAC;QAE1D;;WAEG;QACI,YAAO,GAA+B,EAAE,CAAC;QAEhD;;WAEG;QACI,aAAQ,GAAY,KAAK,CAAC;QAQ/B,IAAI,CAAC,EAAE,GAAG,EAAE,aAAF,EAAE,cAAF,EAAE,GAAI,UAAU,EAAE,CAAC;QAC7B,IAAI,CAAC,OAAO,GAAG,OAAO,aAAP,OAAO,cAAP,OAAO,GAAI,EAAE,CAAC;IAC/B,CAAC;IAED;;OAEG;IACI,WAAW;;QAChB,OAAO,CAAC,MAAA,IAAI,CAAC,OAAO,mCAAI,IAAI,CAAC,GAAG,EAAE,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC;IACvD,CAAC;CACF"}
+{"version":3,"file":"trace.model.js","sourceRoot":"","sources":["../../../../src/models/trace.model.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,aAAa,EAAC,MAAM,oBAAoB,CAAC;AAGjD;;GAEG;AACH,MAAM,OAAO,KAAK;IAuChB;;;;OAIG;IACH,YAAmB,EAAW,EAAE,OAAmC;QAtCnE;;WAEG;QACI,cAAS,GAAW,IAAI,CAAC,GAAG,EAAE,CAAC;QAYtC;;;;;WAKG;QACI,mBAAc,GAAkC,EAAE,CAAC;QAE1D;;WAEG;QACI,YAAO,GAA+B,EAAE,CAAC;QAEhD;;WAEG;QACI,aAAQ,GAAY,KAAK,CAAC;QAQ/B,IAAI,CAAC,EAAE,GAAG,EAAE,aAAF,EAAE,cAAF,EAAE,GAAI,aAAa,CAAC,QAAQ,EAAE,CAAC;QACzC,IAAI,CAAC,OAAO,GAAG,OAAO,aAAP,OAAO,cAAP,OAAO,GAAI,EAAE,CAAC;IAC/B,CAAC;IAED;;OAEG;IACI,WAAW;;QAChB,OAAO,CAAC,MAAA,IAAI,CAAC,OAAO,mCAAI,IAAI,CAAC,GAAG,EAAE,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC;IACvD,CAAC;CACF"}

package/dist/lib/esm/utils/utils.js

@@ -2,4 +2,5 @@ export * from "./date.util";
 export * from "./enum.util";
 export * from "./metadata.util";
 export * from "./object.util";
+export * from "./uuid.util";
 //# sourceMappingURL=utils.js.map

package/dist/lib/esm/utils/utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../../src/utils/utils.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC"}
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../../src/utils/utils.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC"}

package/dist/lib/esm/utils/uuid.util.js

@@ -0,0 +1,42 @@
+/**
+ * Cross-runtime UUID generation. Replaces Node's `crypto.randomUUID()` with the Web Crypto
+ * API exposed on `globalThis.crypto`, which is available in browsers, Node.js (19+), Deno,
+ * Bun and Cloudflare Workers — keeping `@pristine-ts/common` importable outside Node without
+ * pulling in the Node-only `crypto` module.
+ */
+export class UuidGenerator {
+    /**
+     * Returns an RFC 4122 version 4 UUID. Prefers the native `crypto.randomUUID()`, then
+     * derives one from `crypto.getRandomValues()`, and only as a last resort (no Web Crypto at
+     * all) falls back to `Math.random()` — which is NOT cryptographically secure but keeps
+     * exotic runtimes working rather than throwing.
+     */
+    static generate() {
+        const webCrypto = globalThis.crypto;
+        if (typeof (webCrypto === null || webCrypto === void 0 ? void 0 : webCrypto.randomUUID) === "function") {
+            return webCrypto.randomUUID();
+        }
+        if (typeof (webCrypto === null || webCrypto === void 0 ? void 0 : webCrypto.getRandomValues) === "function") {
+            const bytes = webCrypto.getRandomValues(new Uint8Array(16));
+            // Set the version (4) and variant (RFC 4122) bits.
+            bytes[6] = (bytes[6] & 0x0f) | 0x40;
+            bytes[8] = (bytes[8] & 0x3f) | 0x80;
+            const hex = [];
+            for (let i = 0; i < bytes.length; i++) {
+                hex.push(bytes[i].toString(16).padStart(2, "0"));
+            }
+            return (hex.slice(0, 4).join("") + "-" +
+                hex.slice(4, 6).join("") + "-" +
+                hex.slice(6, 8).join("") + "-" +
+                hex.slice(8, 10).join("") + "-" +
+                hex.slice(10, 16).join(""));
+        }
+        // Last-resort, non-cryptographic fallback.
+        return "xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(/[xy]/g, (char) => {
+            const random = (Math.random() * 16) | 0;
+            const value = char === "x" ? random : (random & 0x3) | 0x8;
+            return value.toString(16);
+        });
+    }
+}
+//# sourceMappingURL=uuid.util.js.map

package/dist/lib/esm/utils/uuid.util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"uuid.util.js","sourceRoot":"","sources":["../../../../src/utils/uuid.util.ts"],"names":[],"mappings":"AASA;;;;;GAKG;AACH,MAAM,OAAO,aAAa;IACxB;;;;;OAKG;IACI,MAAM,CAAC,QAAQ;QACpB,MAAM,SAAS,GAA+B,UAAyC,CAAC,MAAM,CAAC;QAE/F,IAAI,OAAO,CAAA,SAAS,aAAT,SAAS,uBAAT,SAAS,CAAE,UAAU,CAAA,KAAK,UAAU,EAAE,CAAC;YAChD,OAAO,SAAS,CAAC,UAAU,EAAE,CAAC;QAChC,CAAC;QAED,IAAI,OAAO,CAAA,SAAS,aAAT,SAAS,uBAAT,SAAS,CAAE,eAAe,CAAA,KAAK,UAAU,EAAE,CAAC;YACrD,MAAM,KAAK,GAAG,SAAS,CAAC,eAAe,CAAC,IAAI,UAAU,CAAC,EAAE,CAAC,CAAC,CAAC;YAC5D,mDAAmD;YACnD,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC;YACpC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC;YAEpC,MAAM,GAAG,GAAa,EAAE,CAAC;YACzB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;gBACtC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;YACnD,CAAC;YAED,OAAO,CACL,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,GAAG,GAAG;gBAC9B,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,GAAG,GAAG;gBAC9B,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,GAAG,GAAG;gBAC9B,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,GAAG,GAAG;gBAC/B,GAAG,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAC3B,CAAC;QACJ,CAAC;QAED,2CAA2C;QAC3C,OAAO,sCAAsC,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE;YACtE,MAAM,MAAM,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC;YACxC,MAAM,KAAK,GAAG,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC;YAC3D,OAAO,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;QAC5B,CAAC,CAAC,CAAC;IACL,CAAC;CACF"}