@venizia/ignis-helpers 0.2.0-9 → 0.2.0

package/dist/esm/modules/uid/uuid/sha1.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sha1.js","sourceRoot":"","sources":["../../../../../src/modules/uid/uuid/sha1.ts"],"names":[],"mappings":"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"}

package/dist/esm/modules/uid/uuid/v4.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Builds a v4 generator. `crypto.randomUUID` is captured once - whether a realm is a secure context
+ * never changes - and called with no argument, since Node validates it and `['a'].map(uuidV4)` would
+ * throw.
+ */
+export declare const createUuidV4: () => (() => string);
+/** Mints a random UUID v4 - a public identifier or a token. */
+export declare const uuidV4: () => string;
+//# sourceMappingURL=v4.d.ts.map

package/dist/esm/modules/uid/uuid/v4.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"v4.d.ts","sourceRoot":"","sources":["../../../../../src/modules/uid/uuid/v4.ts"],"names":[],"mappings":"AAIA;;;;GAIG;AACH,eAAO,MAAM,YAAY,QAAO,CAAC,MAAM,MAAM,CA8C5C,CAAC;AAEF,+DAA+D;AAC/D,eAAO,MAAM,MAAM,EAAE,MAAM,MAAuB,CAAC"}

package/dist/esm/modules/uid/uuid/v4.js

@@ -0,0 +1,50 @@
+import { UUID_HEX_OCTETS } from './common/constants.js';
+const POOL_SIZE = 16 * 256;
+/**
+ * Builds a v4 generator. `crypto.randomUUID` is captured once - whether a realm is a secure context
+ * never changes - and called with no argument, since Node validates it and `['a'].map(uuidV4)` would
+ * throw.
+ */
+export const createUuidV4 = () => {
+    const randomUuid = globalThis.crypto?.randomUUID;
+    if (typeof randomUuid === 'function') {
+        const native = randomUuid.bind(globalThis.crypto);
+        return () => native();
+    }
+    const pool = new Uint8Array(POOL_SIZE);
+    let offset = POOL_SIZE;
+    return () => {
+        if (offset > POOL_SIZE - 16) {
+            globalThis.crypto.getRandomValues(pool);
+            offset = 0;
+        }
+        const at = offset;
+        offset = at + 16;
+        const version = (pool[at + 6] & 0x0f) | 0x40;
+        const variant = (pool[at + 8] & 0x3f) | 0x80;
+        const hex = UUID_HEX_OCTETS;
+        return (hex[pool[at]] +
+            hex[pool[at + 1]] +
+            hex[pool[at + 2]] +
+            hex[pool[at + 3]] +
+            '-' +
+            hex[pool[at + 4]] +
+            hex[pool[at + 5]] +
+            '-' +
+            hex[version] +
+            hex[pool[at + 7]] +
+            '-' +
+            hex[variant] +
+            hex[pool[at + 9]] +
+            '-' +
+            hex[pool[at + 10]] +
+            hex[pool[at + 11]] +
+            hex[pool[at + 12]] +
+            hex[pool[at + 13]] +
+            hex[pool[at + 14]] +
+            hex[pool[at + 15]]);
+    };
+};
+/** Mints a random UUID v4 - a public identifier or a token. */
+export const uuidV4 = createUuidV4();
+//# sourceMappingURL=v4.js.map

package/dist/esm/modules/uid/uuid/v4.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"v4.js","sourceRoot":"","sources":["../../../../../src/modules/uid/uuid/v4.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAErD,MAAM,SAAS,GAAG,EAAE,GAAG,GAAG,CAAC;AAE3B;;;;GAIG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,GAAmB,EAAE;IAC/C,MAAM,UAAU,GAAG,UAAU,CAAC,MAAM,EAAE,UAAU,CAAC;IACjD,IAAI,OAAO,UAAU,KAAK,UAAU,EAAE,CAAC;QACrC,MAAM,MAAM,GAAG,UAAU,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;QAClD,OAAO,GAAG,EAAE,CAAC,MAAM,EAAE,CAAC;IACxB,CAAC;IAED,MAAM,IAAI,GAAG,IAAI,UAAU,CAAC,SAAS,CAAC,CAAC;IACvC,IAAI,MAAM,GAAG,SAAS,CAAC;IAEvB,OAAO,GAAG,EAAE;QACV,IAAI,MAAM,GAAG,SAAS,GAAG,EAAE,EAAE,CAAC;YAC5B,UAAU,CAAC,MAAM,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;YACxC,MAAM,GAAG,CAAC,CAAC;QACb,CAAC;QAED,MAAM,EAAE,GAAG,MAAM,CAAC;QAClB,MAAM,GAAG,EAAE,GAAG,EAAE,CAAC;QAEjB,MAAM,OAAO,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC;QAC7C,MAAM,OAAO,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC;QAC7C,MAAM,GAAG,GAAG,eAAe,CAAC;QAE5B,OAAO,CACL,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACb,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;YACjB,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;YACjB,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;YACjB,GAAG;YACH,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;YACjB,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;YACjB,GAAG;YACH,GAAG,CAAC,OAAO,CAAC;YACZ,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;YACjB,GAAG;YACH,GAAG,CAAC,OAAO,CAAC;YACZ,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;YACjB,GAAG;YACH,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC;YAClB,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC;YAClB,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC;YAClB,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC;YAClB,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC;YAClB,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,CACnB,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC,CAAC;AAEF,+DAA+D;AAC/D,MAAM,CAAC,MAAM,MAAM,GAAiB,YAAY,EAAE,CAAC"}

package/dist/esm/modules/uid/uuid/v5.d.ts

@@ -0,0 +1,15 @@
+/** Builds a v5 generator with its own namespace cache and buffer. */
+export declare const createUuidV5: () => ((opts: {
+    namespace: string;
+    name: string;
+}) => string);
+/**
+ * Mints a deterministic UUID v5 from `namespace` and `name` - an idempotency key.
+ *
+ * Reproducible therefore NOT secret: never a share link, a reset token or an API key.
+ */
+export declare const uuidV5: (opts: {
+    namespace: string;
+    name: string;
+}) => string;
+//# sourceMappingURL=v5.d.ts.map

package/dist/esm/modules/uid/uuid/v5.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"v5.d.ts","sourceRoot":"","sources":["../../../../../src/modules/uid/uuid/v5.ts"],"names":[],"mappings":"AASA,qEAAqE;AACrE,eAAO,MAAM,YAAY,QAAO,CAAC,CAAC,IAAI,EAAE;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,KAAK,MAAM,CAyFrF,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,MAAM,EAAE,CAAC,IAAI,EAAE;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,KAAK,MAAuB,CAAC"}

package/dist/esm/modules/uid/uuid/v5.js

@@ -0,0 +1,86 @@
+// Past the barrels: this module ships on the `./uuid` subpath and must not pull their surface.
+import { getError } from '@venizia/ignis-inversion';
+import { HTTP } from '../../../common/constants/http.js';
+import { MAX_CACHED_NAMESPACES, UUID_HEX_OCTETS, UUID_NAMESPACE_PATTERN } from './common/constants.js';
+import { Sha1Digest } from './sha1.js';
+/** Fits a namespace plus a ~160-character name; a longer one allocates for its own call. */
+const INPUT_SIZE = 512;
+/** Builds a v5 generator with its own namespace cache and buffer. */
+export const createUuidV5 = () => {
+    const encoder = new TextEncoder();
+    /** Parsed namespaces, capped so a caller-fed one cannot grow the map without bound. */
+    const namespaces = new Map();
+    const input = new Uint8Array(INPUT_SIZE);
+    const nameView = input.subarray(16);
+    const resolveNamespace = (opts) => {
+        const { namespace } = opts;
+        const cached = namespaces.get(namespace);
+        if (cached) {
+            return cached;
+        }
+        if (!UUID_NAMESPACE_PATTERN.test(namespace)) {
+            throw getError({
+                statusCode: HTTP.ResultCodes.RS_5.InternalServerError,
+                message: `[uuidV5] namespace must be a UUID - received: ${namespace}`,
+            });
+        }
+        const bytes = new Uint8Array(16);
+        const hex = namespace.replaceAll('-', '');
+        for (let index = 0; index < 16; index++) {
+            bytes[index] = Number.parseInt(hex.slice(index * 2, index * 2 + 2), 16);
+        }
+        if (namespaces.size < MAX_CACHED_NAMESPACES) {
+            namespaces.set(namespace, bytes);
+        }
+        return bytes;
+    };
+    return opts => {
+        const { namespace, name } = opts;
+        const namespaceBytes = resolveNamespace({ namespace });
+        // Encoding turns a lone surrogate into U+FFFD, so two different malformed names would share an id.
+        if (typeof name.isWellFormed === 'function' && !name.isWellFormed()) {
+            throw getError({
+                statusCode: HTTP.ResultCodes.RS_4.BadRequest,
+                message: '[uuidV5] name carries a lone surrogate - it is not well-formed UTF-16 and would collide with another name',
+            });
+        }
+        // UTF-8 never exceeds 3 bytes per UTF-16 code unit. An oversized name gets a buffer of its own
+        // for this call only, so one huge name does not pin its size for the life of the process.
+        const required = 16 + name.length * 3;
+        const target = required > input.length ? new Uint8Array(required) : input;
+        const targetName = target === input ? nameView : target.subarray(16);
+        target.set(namespaceBytes);
+        const { written } = encoder.encodeInto(name, targetName);
+        const digest = Sha1Digest.of({ bytes: target.subarray(0, 16 + written) });
+        digest[6] = (digest[6] & 0x0f) | 0x50;
+        digest[8] = (digest[8] & 0x3f) | 0x80;
+        const hex = UUID_HEX_OCTETS;
+        return (hex[digest[0]] +
+            hex[digest[1]] +
+            hex[digest[2]] +
+            hex[digest[3]] +
+            '-' +
+            hex[digest[4]] +
+            hex[digest[5]] +
+            '-' +
+            hex[digest[6]] +
+            hex[digest[7]] +
+            '-' +
+            hex[digest[8]] +
+            hex[digest[9]] +
+            '-' +
+            hex[digest[10]] +
+            hex[digest[11]] +
+            hex[digest[12]] +
+            hex[digest[13]] +
+            hex[digest[14]] +
+            hex[digest[15]]);
+    };
+};
+/**
+ * Mints a deterministic UUID v5 from `namespace` and `name` - an idempotency key.
+ *
+ * Reproducible therefore NOT secret: never a share link, a reset token or an API key.
+ */
+export const uuidV5 = createUuidV5();
+//# sourceMappingURL=v5.js.map

package/dist/esm/modules/uid/uuid/v5.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"v5.js","sourceRoot":"","sources":["../../../../../src/modules/uid/uuid/v5.ts"],"names":[],"mappings":"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"}

package/dist/esm/modules/uid/uuid/v7.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Builds a v7 generator with its own clock state and counter. Never `Bun.randomUUIDv7`: it is
+ * slower, and it reads `(encoding, timestamp)` from whatever it is called with.
+ */
+export declare const createUuidV7: () => (() => string);
+/**
+ * Mints a time-ordered UUID v7 - the default for a string primary key. Forwards no argument: the
+ * shared slot may hold another helpers version's generator.
+ */
+export declare const uuidV7: () => string;
+//# sourceMappingURL=v7.d.ts.map

package/dist/esm/modules/uid/uuid/v7.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"v7.d.ts","sourceRoot":"","sources":["../../../../../src/modules/uid/uuid/v7.ts"],"names":[],"mappings":"AAWA;;;GAGG;AACH,eAAO,MAAM,YAAY,QAAO,CAAC,MAAM,MAAM,CA+E5C,CAAC;AAQF;;;GAGG;AACH,eAAO,MAAM,MAAM,QAAO,MAAsB,CAAC"}

package/dist/esm/modules/uid/uuid/v7.js

@@ -0,0 +1,90 @@
+import { UUID_HEX_OCTETS } from './common/constants.js';
+/**
+ * One sequence per realm, so the CJS and ESM copies - and two helpers versions - never interleave two
+ * counters. The slot holds a `() => string`; that key and shape are a contract across versions.
+ */
+const SHARED_SLOT = Symbol.for('@venizia/ignis-helpers:uuid-v7');
+const POOL_SIZE = 8 * 256;
+const MAX_COUNTER = 0xfff;
+/**
+ * Builds a v7 generator with its own clock state and counter. Never `Bun.randomUUIDv7`: it is
+ * slower, and it reads `(encoding, timestamp)` from whatever it is called with.
+ */
+export const createUuidV7 = () => {
+    const pool = new Uint8Array(POOL_SIZE);
+    let offset = POOL_SIZE;
+    let lastMs = -1;
+    let counter = 0;
+    let prefix = '';
+    /** Draws a counter seed below 0x800, leaving room to climb inside the millisecond. */
+    const drawCounterSeed = () => {
+        if (offset > POOL_SIZE - 2) {
+            globalThis.crypto.getRandomValues(pool);
+            offset = 0;
+        }
+        const seed = ((pool[offset] << 8) | pool[offset + 1]) & 0x7ff;
+        offset += 2;
+        return seed;
+    };
+    /** Renders the 48-bit timestamp half of the id. */
+    const renderPrefix = (opts) => {
+        const { ms } = opts;
+        const hex = UUID_HEX_OCTETS;
+        // 48 bits exceed the 32-bit bitwise range: split at 24 bits with arithmetic first.
+        const high = Math.floor(ms / 0x1000000);
+        const low = ms % 0x1000000;
+        return (hex[(high >>> 16) & 0xff] +
+            hex[(high >>> 8) & 0xff] +
+            hex[high & 0xff] +
+            hex[(low >>> 16) & 0xff] +
+            '-' +
+            hex[(low >>> 8) & 0xff] +
+            hex[low & 0xff] +
+            '-');
+    };
+    return () => {
+        const now = Date.now();
+        if (now > lastMs) {
+            lastMs = now;
+            counter = drawCounterSeed();
+            prefix = renderPrefix({ ms: now });
+        }
+        else if (++counter > MAX_COUNTER) {
+            // Counter spent, or the clock stepped back: borrow the next millisecond rather than repeat.
+            lastMs += 1;
+            counter = drawCounterSeed();
+            prefix = renderPrefix({ ms: lastMs });
+        }
+        if (offset > POOL_SIZE - 8) {
+            globalThis.crypto.getRandomValues(pool);
+            offset = 0;
+        }
+        const at = offset;
+        offset = at + 8;
+        const hex = UUID_HEX_OCTETS;
+        return (prefix +
+            hex[0x70 | (counter >>> 8)] +
+            hex[counter & 0xff] +
+            '-' +
+            hex[(pool[at] & 0x3f) | 0x80] +
+            hex[pool[at + 1]] +
+            '-' +
+            hex[pool[at + 2]] +
+            hex[pool[at + 3]] +
+            hex[pool[at + 4]] +
+            hex[pool[at + 5]] +
+            hex[pool[at + 6]] +
+            hex[pool[at + 7]]);
+    };
+};
+const sharedV7 = Reflect.get(globalThis, SHARED_SLOT);
+const resolvedV7 = sharedV7 ?? createUuidV7();
+if (!sharedV7) {
+    Reflect.set(globalThis, SHARED_SLOT, resolvedV7);
+}
+/**
+ * Mints a time-ordered UUID v7 - the default for a string primary key. Forwards no argument: the
+ * shared slot may hold another helpers version's generator.
+ */
+export const uuidV7 = () => resolvedV7();
+//# sourceMappingURL=v7.js.map

package/dist/esm/modules/uid/uuid/v7.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"v7.js","sourceRoot":"","sources":["../../../../../src/modules/uid/uuid/v7.ts"],"names":[],"mappings":"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"}

package/dist/esm/package.json

@@ -0,0 +1,6 @@
+{
+  "type": "module",
+  "sideEffects": [
+    "./index.js"
+  ]
+}

package/dist/esm/temporal.d.ts

@@ -0,0 +1,2 @@
+export * from './modules/temporal/index.js';
+//# sourceMappingURL=temporal.d.ts.map

package/dist/esm/temporal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"temporal.d.ts","sourceRoot":"","sources":["../../src/temporal.ts"],"names":[],"mappings":"AACA,cAAc,oBAAoB,CAAC"}

package/dist/esm/temporal.js

@@ -0,0 +1,3 @@
+// Dates through a chosen adapter - no date library is loaded by this package itself.
+export * from './modules/temporal/index.js';
+//# sourceMappingURL=temporal.js.map

package/dist/esm/temporal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"temporal.js","sourceRoot":"","sources":["../../src/temporal.ts"],"names":[],"mappings":"AAAA,qFAAqF;AACrF,cAAc,oBAAoB,CAAC"}

package/dist/esm/utilities/build-info.utility.d.ts

@@ -0,0 +1,33 @@
+/**
+ * What a build stamps about itself. Every field optional: a host that never ran the generator still
+ * answers, with the fields it does know.
+ */
+export interface IBuildInfo {
+    service?: string;
+    version?: string;
+    commit?: string;
+    branch?: string;
+    builtAt?: string;
+}
+/** The stamp with every field resolved: what the generator writes and what the health reporter answers. */
+export type TBuildInfoRecord = Required<IBuildInfo>;
+/**
+ * The `globalThis` slot a build stamp lives in, PUSHED from the application entrypoint rather than
+ * read back from disk. Same reasoning as {@link ProjectRootRegistry}: no Node import here, so a
+ * browser Worker reaches it through `/core`, and a `bun build --compile` binary - which ships no
+ * `node_modules`, no `.git` and no readable `package.json` - carries the value inside its own code.
+ */
+export declare class BuildInfoRegistry {
+    private static readonly SLOT;
+    /** What a field reads when it is unknowable: the generator writes it, the health reporter falls back to it. Visible on purpose - a pipeline that forgot a variable shows up as this word, never as an absent key. */
+    static readonly UNSPECIFIED = "unspecified";
+    /** Called once at the entrypoint with the generated stamp; every later read sees it. */
+    static set(opts: {
+        buildInfo: IBuildInfo;
+    }): void;
+    /** The shared stamp, or `undefined` when no application registered one. */
+    static get(): IBuildInfo | undefined;
+    /** Drops the stamp - tests only; a host never unregisters its own build. */
+    static clear(): void;
+}
+//# sourceMappingURL=build-info.utility.d.ts.map

package/dist/esm/utilities/build-info.utility.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-info.utility.d.ts","sourceRoot":"","sources":["../../../src/utilities/build-info.utility.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,2GAA2G;AAC3G,MAAM,MAAM,gBAAgB,GAAG,QAAQ,CAAC,UAAU,CAAC,CAAC;AAEpD;;;;;GAKG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAkC;IAE9D,qNAAqN;IACrN,MAAM,CAAC,QAAQ,CAAC,WAAW,iBAAiB;IAE5C,wFAAwF;IACxF,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE;QAAE,SAAS,EAAE,UAAU,CAAA;KAAE,GAAG,IAAI;IAIjD,2EAA2E;IAC3E,MAAM,CAAC,GAAG,IAAI,UAAU,GAAG,SAAS;IAIpC,4EAA4E;IAC5E,MAAM,CAAC,KAAK,IAAI,IAAI;CAGrB"}

package/dist/esm/utilities/build-info.utility.js

@@ -0,0 +1,24 @@
+/**
+ * The `globalThis` slot a build stamp lives in, PUSHED from the application entrypoint rather than
+ * read back from disk. Same reasoning as {@link ProjectRootRegistry}: no Node import here, so a
+ * browser Worker reaches it through `/core`, and a `bun build --compile` binary - which ships no
+ * `node_modules`, no `.git` and no readable `package.json` - carries the value inside its own code.
+ */
+export class BuildInfoRegistry {
+    static { this.SLOT = Symbol.for('ignis:build-info'); }
+    /** What a field reads when it is unknowable: the generator writes it, the health reporter falls back to it. Visible on purpose - a pipeline that forgot a variable shows up as this word, never as an absent key. */
+    static { this.UNSPECIFIED = 'unspecified'; }
+    /** Called once at the entrypoint with the generated stamp; every later read sees it. */
+    static set(opts) {
+        Reflect.set(globalThis, this.SLOT, opts.buildInfo);
+    }
+    /** The shared stamp, or `undefined` when no application registered one. */
+    static get() {
+        return Reflect.get(globalThis, this.SLOT);
+    }
+    /** Drops the stamp - tests only; a host never unregisters its own build. */
+    static clear() {
+        Reflect.deleteProperty(globalThis, this.SLOT);
+    }
+}
+//# sourceMappingURL=build-info.utility.js.map

package/dist/esm/utilities/build-info.utility.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-info.utility.js","sourceRoot":"","sources":["../../../src/utilities/build-info.utility.ts"],"names":[],"mappings":"AAeA;;;;;GAKG;AACH,MAAM,OAAO,iBAAiB;aACJ,SAAI,GAAG,MAAM,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC;IAE9D,qNAAqN;aACrM,gBAAW,GAAG,aAAa,CAAC;IAE5C,wFAAwF;IACxF,MAAM,CAAC,GAAG,CAAC,IAA+B;QACxC,OAAO,CAAC,GAAG,CAAC,UAAU,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;IACrD,CAAC;IAED,2EAA2E;IAC3E,MAAM,CAAC,GAAG;QACR,OAAO,OAAO,CAAC,GAAG,CAAC,UAAU,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;IAC5C,CAAC;IAED,4EAA4E;IAC5E,MAAM,CAAC,KAAK;QACV,OAAO,CAAC,cAAc,CAAC,UAAU,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;IAChD,CAAC"}

package/dist/esm/utilities/hr-time.utility.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Seconds from the process's high-resolution clock, to nine decimals - for measuring, not for dates.
+ * A file of its own: `process.hrtime` is Node-only, and `performance.utility` ships on `/core`.
+ */
+export declare const hrTime: () => number;
+//# sourceMappingURL=hr-time.utility.d.ts.map

package/dist/esm/utilities/hr-time.utility.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hr-time.utility.d.ts","sourceRoot":"","sources":["../../../src/utilities/hr-time.utility.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,eAAO,MAAM,MAAM,cAGlB,CAAC"}

package/dist/esm/utilities/hr-time.utility.js

@@ -0,0 +1,10 @@
+import { float } from './parse.utility.js';
+/**
+ * Seconds from the process's high-resolution clock, to nine decimals - for measuring, not for dates.
+ * A file of its own: `process.hrtime` is Node-only, and `performance.utility` ships on `/core`.
+ */
+export const hrTime = () => {
+    const current = process.hrtime();
+    return float(current[0] + current[1] / 10 ** 9, 9);
+};
+//# sourceMappingURL=hr-time.utility.js.map

package/dist/esm/utilities/hr-time.utility.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hr-time.utility.js","sourceRoot":"","sources":["../../../src/utilities/hr-time.utility.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAExC;;;GAGG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG,GAAG,EAAE;IACzB,MAAM,OAAO,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IACjC,OAAO,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;AACrD,CAAC,CAAC"}

package/dist/esm/utilities/index.d.ts

@@ -1,7 +1,9 @@
-export * from './date.utility.js';
+export * from './build-info.utility.js';
+export * from './hr-time.utility.js';
 export * from './module.utility.js';
 export * from './parse.utility.js';
 export * from './performance.utility.js';
 export * from './promise.utility.js';
 export * from './request.utility.js';
+export * from './sleep.utility.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/esm/utilities/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utilities/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utilities/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC"}

package/dist/esm/utilities/index.js

@@ -1,7 +1,9 @@
-export * from './date.utility.js';
+export * from './build-info.utility.js';
+export * from './hr-time.utility.js';
 export * from './module.utility.js';
 export * from './parse.utility.js';
 export * from './performance.utility.js';
 export * from './promise.utility.js';
 export * from './request.utility.js';
+export * from './sleep.utility.js';
 //# sourceMappingURL=index.js.map

package/dist/esm/utilities/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/utilities/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/utilities/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC"}

package/dist/esm/utilities/module.utility.d.ts

@@ -1,9 +1,15 @@
 import type { AnyType } from '../common/types/index.js';
 /** Loads an optional peer without letting `Bun.build` see it: every specifier stays a parameter, so there is no literal (nor a `minify.syntax`-folded const) for the bundler to resolve. */
 export declare class ModuleUtility {
-    /** Peers handed over by the application, keyed by specifier. Checked before any filesystem lookup. */
+    /** Peers handed over by the application, keyed by specifier. Checked before any filesystem lookup. The map lives in a globalThis slot because a process (or a compiled bundle) can carry two copies of this module, and a peer registered through one copy must be found by the other. */
     private static readonly registered;
-    /** Resolves peers against the APP's node_modules, not this package's own `dist/` location. */
+    private static sharedRegistry;
+    /** Called by the application once it knows its root (`configs.projectRoot` or the cwd); every peer lookup below follows it. Delegates to `ProjectRootRegistry`, which a browser Worker host reaches too through `/core` - the two must share ONE slot. */
+    static setProjectRoot(opts: {
+        projectRoot: string;
+    }): void;
+    static getProjectRoot(): string;
+    /** Resolves peers against the APP's node_modules (under the project root), not this package's own `dist/` location. */
     private static appRequire;
     private static fail;
     /**

package/dist/esm/utilities/module.utility.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"module.utility.d.ts","sourceRoot":"","sources":["../../../src/utilities/module.utility.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAM9C,4LAA4L;AAC5L,qBAAa,aAAa;IACxB,sGAAsG;IACtG,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,UAAU,CAA8B;IAEhE,8FAA8F;IAC9F,OAAO,CAAC,MAAM,CAAC,UAAU;IAIzB,OAAO,CAAC,MAAM,CAAC,IAAI;IAanB;;;;;;;;;OASG;IACH,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,GAAG,IAAI;IAMjE,sFAAsF;WACzE,IAAI,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,CAAC,CAAC;IAcpE,kFAAkF;IAClF,MAAM,CAAC,QAAQ,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,CAAC;IAczD;;;;;;;OAOG;IACH,MAAM,CAAC,eAAe,CAAC,IAAI,EAAE;QAC3B,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;QACvB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,eAAe,CAAC,EAAE,OAAO,CAAC;KAC3B,GAAG,IAAI;CAgBT"}
+{"version":3,"file":"module.utility.d.ts","sourceRoot":"","sources":["../../../src/utilities/module.utility.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAO9C,4LAA4L;AAC5L,qBAAa,aAAa;IACxB,0RAA0R;IAC1R,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAwD;IAE1F,OAAO,CAAC,MAAM,CAAC,cAAc;IAa7B,0PAA0P;IAC1P,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE;QAAE,WAAW,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAI1D,MAAM,CAAC,cAAc,IAAI,MAAM;IAI/B,uHAAuH;IACvH,OAAO,CAAC,MAAM,CAAC,UAAU;IAIzB,OAAO,CAAC,MAAM,CAAC,IAAI;IAanB;;;;;;;;;OASG;IACH,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,GAAG,IAAI;IAOjE,sFAAsF;WACzE,IAAI,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,CAAC,CAAC;IAcpE,kFAAkF;IAClF,MAAM,CAAC,QAAQ,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,CAAC;IAczD;;;;;;;OAOG;IACH,MAAM,CAAC,eAAe,CAAC,IAAI,EAAE;QAC3B,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;QACvB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,eAAe,CAAC,EAAE,OAAO,CAAC;KAC3B,GAAG,IAAI;CAgBT"}

package/dist/esm/utilities/module.utility.js

@@ -2,21 +2,39 @@ import { createRequire } from 'node:module';
 import path from 'node:path';
 import { LoggerFactory } from '../modules/logger/index.js';
 import { getError } from '../modules/error/index.js';
+import { ProjectRootRegistry } from './project-root.utility.js';
 const logger = LoggerFactory.getLogger(['ModuleUtility']);
 /** Loads an optional peer without letting `Bun.build` see it: every specifier stays a parameter, so there is no literal (nor a `minify.syntax`-folded const) for the bundler to resolve. */
 export class ModuleUtility {
-    /** Peers handed over by the application, keyed by specifier. Checked before any filesystem lookup. */
-    static { this.registered = new Map(); }
-    /** Resolves peers against the APP's node_modules, not this package's own `dist/` location. */
+    /** Peers handed over by the application, keyed by specifier. Checked before any filesystem lookup. The map lives in a globalThis slot because a process (or a compiled bundle) can carry two copies of this module, and a peer registered through one copy must be found by the other. */
+    static { this.registered = ModuleUtility.sharedRegistry(); }
+    static sharedRegistry() {
+        const slot = Symbol.for('ignis:module-registry');
+        const shared = Reflect.get(globalThis, slot);
+        if (shared) {
+            return shared;
+        }
+        const created = new Map();
+        Reflect.set(globalThis, slot, created);
+        return created;
+    }
+    /** Called by the application once it knows its root (`configs.projectRoot` or the cwd); every peer lookup below follows it. Delegates to `ProjectRootRegistry`, which a browser Worker host reaches too through `/core` - the two must share ONE slot. */
+    static setProjectRoot(opts) {
+        ProjectRootRegistry.set(opts);
+    }
+    static getProjectRoot() {
+        return ProjectRootRegistry.getShared() ?? process.cwd();
+    }
+    /** Resolves peers against the APP's node_modules (under the project root), not this package's own `dist/` location. */
     static appRequire() {
-        return createRequire(path.join(process.cwd(), 'node_modules'));
+        return createRequire(path.join(this.getProjectRoot(), 'node_modules'));
     }
     static fail(opts) {
         const { method, module, error, scope } = opts;
         const reason = error instanceof Error ? error.message : String(error);
         logger.for(method).error("Failed to load '%s' | Error: %s", module, reason);
         return getError({
-            message: `[ModuleUtility.${method}] ${module} is required${scope ? ` for ${scope}` : ''}. Please install '${module}' | Error: ${reason}`,
+            message: `[ModuleUtility.${method}] ${module} is required, resolved from ${this.getProjectRoot()}${scope ? ` for ${scope}` : ''}. Please install '${module}' | Error: ${reason}`,
         });
     }
     /**
@@ -30,7 +48,8 @@ export class ModuleUtility {
      * module after the first.
      */
     static register(opts) {
-        for (const [module, value] of Object.entries(opts.modules)) {
+        const modulesEntries = Object.entries(opts.modules);
+        for (const [module, value] of modulesEntries) {
             this.registered.set(module, value);
         }
     }

package/dist/esm/utilities/module.utility.js.map

@@ -1 +1 @@
-{"version":3,"file":"module.utility.js","sourceRoot":"","sources":["../../../src/utilities/module.utility.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"module.utility.js","sourceRoot":"","sources":["../../../src/utilities/module.utility.ts"],"names":[],"mappings":"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"}

package/dist/esm/utilities/parse.utility.d.ts

@@ -3,6 +3,21 @@ export declare const toCamel: (s: string) => string;
 export declare const keysToCamel: (object: object) => any;
 export declare const isInt: (n: any) => boolean;
 export declare const isFloat: (input: any) => boolean;
+/**
+ * Parses an integer, TOTAL by design: it always answers a number, and answers `0` for anything it
+ * cannot parse - `undefined`, `''`, `'abc'`.
+ *
+ * That makes `int(value) ?? fallback` dead code, because the left side is never nullish. The
+ * fallback belongs INSIDE the call, and for an environment read it belongs in the read itself:
+ *
+ * ```ts
+ * int(applicationEnvironment.get(KEY, { defaultValue: '6379' }))  // correct
+ * int(applicationEnvironment.get(KEY)) ?? 6379                    // always 0 when KEY is unset
+ * ```
+ *
+ * The second form is silent: a missing port reads `0` and a missing retry budget reads `0`, which
+ * through `AbstractRedisHelper.buildRetryStrategy` means "give up after the first failure".
+ */
 export declare const int: (input: any) => number;
 export declare const float: (input: any, digit?: number) => number;
 export declare const toBoolean: (input: any) => boolean;
@@ -10,6 +25,20 @@ export declare const toBoolean: (input: any) => boolean;
 export declare const parseArrayToMapWithKey: <T extends Record<K, PropertyKey>, K extends keyof T>(arr: T[], keyMap: K) => Map<T[K], T>;
 /** Splits a delimited string into trimmed, non-empty entries - the transform for list-shaped env values (e.g. `applicationEnvironment.get(KEY, { transform: toDelimitedArray })`). */
 export declare const toDelimitedArray: (input: unknown, separator?: string) => string[];
+/**
+ * A trimmed value, or `undefined` when the input is absent or carries nothing but whitespace.
+ *
+ * Written for environment reads. `KEY=` in a deployment file is a pipeline that forgot to export the
+ * value, but `process.env.KEY` answers `''` for it, and `''` walks straight past `??`:
+ *
+ * ```ts
+ * process.env.APP_ENV_LOGGER_FORMAT ?? 'text'                    // '' when the line is blank
+ * blankToUndefined(process.env.APP_ENV_LOGGER_FORMAT) ?? 'text'  // 'text'
+ * ```
+ *
+ * Reach for this rather than `||`, which reads `'0'` as blank as well.
+ */
+export declare const blankToUndefined: (input: string | undefined) => string | undefined;
 /** Trims a possibly-undefined env value to a clean string ('' when absent). */
 export declare const toTrimmed: (input: unknown) => string;
 //# sourceMappingURL=parse.utility.d.ts.map

package/dist/esm/utilities/parse.utility.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"parse.utility.d.ts","sourceRoot":"","sources":["../../../src/utilities/parse.utility.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,MAAM,cAA0D,CAAC;AAE9E,eAAO,MAAM,OAAO,GAAI,GAAG,MAAM,WAIhC,CAAC;AAoBF,eAAO,MAAM,WAAW,GAAI,QAAQ,MAAM,QASzC,CAAC;AAEF,eAAO,MAAM,KAAK,GAAI,GAAG,GAAG,YAM3B,CAAC;AAEF,eAAO,MAAM,OAAO,GAAI,OAAO,GAAG,YAMjC,CAAC;AAEF,eAAO,MAAM,GAAG,GAAI,OAAO,GAAG,WAY7B,CAAC;AAEF,eAAO,MAAM,KAAK,GAAI,OAAO,GAAG,EAAE,cAAS,WAY1C,CAAC;AAEF,eAAO,MAAM,SAAS,GAAI,OAAO,GAAG,KAAG,OAUtC,CAAC;AAEF,yFAAyF;AACzF,eAAO,MAAM,sBAAsB,GAAI,CAAC,SAAS,MAAM,CAAC,CAAC,EAAE,WAAW,CAAC,EAAE,CAAC,SAAS,MAAM,CAAC,EACxF,KAAK,CAAC,EAAE,EACR,QAAQ,CAAC,KACR,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAiBb,CAAC;AAEF,sLAAsL;AACtL,eAAO,MAAM,gBAAgB,GAAI,OAAO,OAAO,EAAE,kBAAe,KAAG,MAAM,EASxE,CAAC;AAEF,+EAA+E;AAC/E,eAAO,MAAM,SAAS,GAAI,OAAO,OAAO,KAAG,MAM1C,CAAC"}
+{"version":3,"file":"parse.utility.d.ts","sourceRoot":"","sources":["../../../src/utilities/parse.utility.ts"],"names":[],"mappings":"AAyBA,eAAO,MAAM,MAAM,cAA0D,CAAC;AAE9E,eAAO,MAAM,OAAO,GAAI,GAAG,MAAM,WAIhC,CAAC;AAqBF,eAAO,MAAM,WAAW,GAAI,QAAQ,MAAM,QASzC,CAAC;AAEF,eAAO,MAAM,KAAK,GAAI,GAAG,GAAG,YAM3B,CAAC;AAEF,eAAO,MAAM,OAAO,GAAI,OAAO,GAAG,YAMjC,CAAC;AAEF;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,GAAG,GAAI,OAAO,GAAG,WAY7B,CAAC;AAEF,eAAO,MAAM,KAAK,GAAI,OAAO,GAAG,EAAE,cAAS,WAY1C,CAAC;AAEF,eAAO,MAAM,SAAS,GAAI,OAAO,GAAG,KAAG,OAUtC,CAAC;AAEF,yFAAyF;AACzF,eAAO,MAAM,sBAAsB,GAAI,CAAC,SAAS,MAAM,CAAC,CAAC,EAAE,WAAW,CAAC,EAAE,CAAC,SAAS,MAAM,CAAC,EACxF,KAAK,CAAC,EAAE,EACR,QAAQ,CAAC,KACR,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAiBb,CAAC;AAEF,sLAAsL;AACtL,eAAO,MAAM,gBAAgB,GAAI,OAAO,OAAO,EAAE,kBAAe,KAAG,MAAM,EASxE,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,gBAAgB,GAAI,OAAO,MAAM,GAAG,SAAS,KAAG,MAAM,GAAG,SAGrE,CAAC;AAEF,+EAA+E;AAC/E,eAAO,MAAM,SAAS,GAAI,OAAO,OAAO,KAAG,MAM1C,CAAC"}