@venizia/ignis-helpers 0.2.0-8 → 0.2.0

package/dist/cjs/modules/uid/uuid/common/index.js

@@ -0,0 +1,24 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UUID_PATTERN = exports.UuidNamespaces = void 0;
+// Explicit, not `export *`: the hex table and the cache cap are implementation detail, and a symbol
+// this package exports is a symbol it owes a deprecation cycle.
+var constants_1 = require("./constants");
+Object.defineProperty(exports, "UuidNamespaces", { enumerable: true, get: function () { return constants_1.UuidNamespaces; } });
+Object.defineProperty(exports, "UUID_PATTERN", { enumerable: true, get: function () { return constants_1.UUID_PATTERN; } });
+__exportStar(require("./types"), exports);
+//# sourceMappingURL=index.js.map

package/dist/cjs/modules/uid/uuid/common/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../src/modules/uid/uuid/common/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,oGAAoG;AACpG,gEAAgE;AAChE,yCAA2D;AAAlD,2GAAA,cAAc,OAAA;AAAE,yGAAA,YAAY,OAAA;AACrC,0CAAwB"}

package/dist/cjs/modules/uid/uuid/common/types.d.ts

@@ -0,0 +1,6 @@
+/** What a UUID says about itself. `createdAt` is present only for a version that carries a clock. */
+export interface IUuidInspection {
+    version: number;
+    createdAt?: Date;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/cjs/modules/uid/uuid/common/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../../src/modules/uid/uuid/common/types.ts"],"names":[],"mappings":"AAAA,qGAAqG;AACrG,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,IAAI,CAAC;CAClB"}

package/dist/cjs/modules/uid/uuid/common/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../../src/modules/uid/uuid/common/types.ts"],"names":[],"mappings":""}

package/dist/cjs/modules/uid/uuid/helper.d.ts

@@ -0,0 +1,37 @@
+import { BaseHelper } from '../../base';
+import type { IUuidInspection } from './common/types';
+/**
+ * One door for every UUID IGNIS mints: `v7()` for a database key, `v5()` for a deterministic key,
+ * `v4()` for a random token.
+ *
+ * A facade over {@link uuidV4}, {@link uuidV5} and {@link uuidV7} - importing one of those from
+ * `@venizia/ignis-helpers/uuid` leaves the other two out of a browser bundle.
+ */
+export declare class UuidHelper extends BaseHelper {
+    /**
+     * Per module copy, not realm-wide: the facade holds no state - ordering lives in the shared v7
+     * sequence - and a realm-wide slot would hand an older version's instance, and its generators,
+     * to every newer caller.
+     */
+    private static instance?;
+    /** Random - a public identifier or a token. */
+    readonly v4: () => string;
+    /** Deterministic - same inputs, same id. Reproducible therefore not secret. */
+    readonly v5: (opts: {
+        namespace: string;
+        name: string;
+    }) => string;
+    /** Time-ordered - a database key. A burst past about 2048 ids per millisecond leads the wall clock. */
+    readonly v7: () => string;
+    constructor(opts?: {
+        scope?: string;
+    });
+    static getInstance(): UuidHelper;
+    /** Lowercase, version 1-8, RFC variant - the nil and max placeholders are refused. */
+    static isValid(value: string): boolean;
+    /** Reads the version, and for v7 the creation time; undefined when it is not a UUID. */
+    inspect(opts: {
+        value: string;
+    }): IUuidInspection | undefined;
+}
+//# sourceMappingURL=helper.d.ts.map

package/dist/cjs/modules/uid/uuid/helper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helper.d.ts","sourceRoot":"","sources":["../../../../../src/modules/uid/uuid/helper.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAExC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAKtD;;;;;;GAMG;AACH,qBAAa,UAAW,SAAQ,UAAU;IACxC;;;;OAIG;IACH,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAa;IAErC,+CAA+C;IAC/C,QAAQ,CAAC,EAAE,EAAE,MAAM,MAAM,CAAU;IAEnC,+EAA+E;IAC/E,QAAQ,CAAC,EAAE,EAAE,CAAC,IAAI,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,KAAK,MAAM,CAAU;IAE5E,uGAAuG;IACvG,QAAQ,CAAC,EAAE,EAAE,MAAM,MAAM,CAAU;gBAEvB,IAAI,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE;IAIrC,MAAM,CAAC,WAAW,IAAI,UAAU;IAKhC,sFAAsF;IACtF,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAItC,wFAAwF;IACxF,OAAO,CAAC,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG,eAAe,GAAG,SAAS;CAe9D"}

package/dist/cjs/modules/uid/uuid/helper.js

@@ -0,0 +1,49 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UuidHelper = void 0;
+const base_1 = require("../../base");
+const constants_1 = require("./common/constants");
+const v4_1 = require("./v4");
+const v5_1 = require("./v5");
+const v7_1 = require("./v7");
+/**
+ * One door for every UUID IGNIS mints: `v7()` for a database key, `v5()` for a deterministic key,
+ * `v4()` for a random token.
+ *
+ * A facade over {@link uuidV4}, {@link uuidV5} and {@link uuidV7} - importing one of those from
+ * `@venizia/ignis-helpers/uuid` leaves the other two out of a browser bundle.
+ */
+class UuidHelper extends base_1.BaseHelper {
+    constructor(opts) {
+        super({ scope: opts?.scope ?? UuidHelper.name });
+        /** Random - a public identifier or a token. */
+        this.v4 = v4_1.uuidV4;
+        /** Deterministic - same inputs, same id. Reproducible therefore not secret. */
+        this.v5 = v5_1.uuidV5;
+        /** Time-ordered - a database key. A burst past about 2048 ids per millisecond leads the wall clock. */
+        this.v7 = v7_1.uuidV7;
+    }
+    static getInstance() {
+        UuidHelper.instance ??= new UuidHelper();
+        return UuidHelper.instance;
+    }
+    /** Lowercase, version 1-8, RFC variant - the nil and max placeholders are refused. */
+    static isValid(value) {
+        return constants_1.UUID_PATTERN.test(value);
+    }
+    /** Reads the version, and for v7 the creation time; undefined when it is not a UUID. */
+    inspect(opts) {
+        const { value } = opts;
+        if (!constants_1.UUID_PATTERN.test(value)) {
+            return undefined;
+        }
+        const version = Number.parseInt(value[14], 16);
+        if (version !== 7) {
+            return { version };
+        }
+        const milliseconds = Number.parseInt(value.slice(0, 8) + value.slice(9, 13), 16);
+        return { version, createdAt: new Date(milliseconds) };
+    }
+}
+exports.UuidHelper = UuidHelper;
+//# sourceMappingURL=helper.js.map

package/dist/cjs/modules/uid/uuid/helper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helper.js","sourceRoot":"","sources":["../../../../../src/modules/uid/uuid/helper.ts"],"names":[],"mappings":";;;AAAA,qCAAwC;AACxC,kDAAkD;AAElD,6BAA8B;AAC9B,6BAA8B;AAC9B,6BAA8B;AAE9B;;;;;;GAMG;AACH,MAAa,UAAW,SAAQ,iBAAU;IAiBxC,YAAY,IAAyB;QACnC,KAAK,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,IAAI,UAAU,CAAC,IAAI,EAAE,CAAC,CAAC;QAVnD,+CAA+C;QACtC,OAAE,GAAiB,WAAM,CAAC;QAEnC,+EAA+E;QACtE,OAAE,GAA0D,WAAM,CAAC;QAE5E,uGAAuG;QAC9F,OAAE,GAAiB,WAAM,CAAC;IAInC,CAAC;IAED,MAAM,CAAC,WAAW;QAChB,UAAU,CAAC,QAAQ,KAAK,IAAI,UAAU,EAAE,CAAC;QACzC,OAAO,UAAU,CAAC,QAAQ,CAAC;IAC7B,CAAC;IAED,sFAAsF;IACtF,MAAM,CAAC,OAAO,CAAC,KAAa;QAC1B,OAAO,wBAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAClC,CAAC;IAED,wFAAwF;IACxF,OAAO,CAAC,IAAuB;QAC7B,MAAM,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC;QAEvB,IAAI,CAAC,wBAAY,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;YAC9B,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,MAAM,OAAO,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;QAC/C,IAAI,OAAO,KAAK,CAAC,EAAE,CAAC;YAClB,OAAO,EAAE,OAAO,EAAE,CAAC;QACrB,CAAC;QAED,MAAM,YAAY,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;QACjF,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,IAAI,IAAI,CAAC,YAAY,CAAC,EAAE,CAAC;IACxD,CAAC;CACF;AA/CD,gCA+CC"}

package/dist/cjs/modules/uid/uuid/index.d.ts

@@ -0,0 +1,6 @@
+export * from './common';
+export * from './helper';
+export * from './v4';
+export * from './v5';
+export * from './v7';
+//# sourceMappingURL=index.d.ts.map

package/dist/cjs/modules/uid/uuid/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/modules/uid/uuid/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC;AACzB,cAAc,MAAM,CAAC;AACrB,cAAc,MAAM,CAAC;AACrB,cAAc,MAAM,CAAC"}

package/dist/cjs/modules/uid/uuid/index.js

@@ -0,0 +1,22 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./common"), exports);
+__exportStar(require("./helper"), exports);
+__exportStar(require("./v4"), exports);
+__exportStar(require("./v5"), exports);
+__exportStar(require("./v7"), exports);
+//# sourceMappingURL=index.js.map

package/dist/cjs/modules/uid/uuid/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/modules/uid/uuid/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,2CAAyB;AACzB,2CAAyB;AACzB,uCAAqB;AACrB,uCAAqB;AACrB,uCAAqB"}

package/dist/cjs/modules/uid/uuid/sha1.d.ts

@@ -0,0 +1,19 @@
+/**
+ * SHA-1 over bytes, synchronous, no host API - `node:crypto` fails the purity gate and
+ * `crypto.subtle` is async and secure-context only.
+ *
+ * Only UUID v5 uses it. SHA-1 is broken against a chosen-prefix collision: never sign, authenticate
+ * or store a password with it.
+ */
+export declare class Sha1Digest {
+    /** Reused: `of()` never yields, so no second call can observe it mid-flight. */
+    private static readonly SCHEDULE;
+    /** Padding buffer sized for a namespace plus a name; a longer input allocates. */
+    private static readonly SCRATCH;
+    private static readonly K;
+    /** Digests `bytes` into 20 big-endian bytes. */
+    static of(opts: {
+        bytes: Uint8Array;
+    }): Uint8Array;
+}
+//# sourceMappingURL=sha1.d.ts.map

package/dist/cjs/modules/uid/uuid/sha1.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sha1.d.ts","sourceRoot":"","sources":["../../../../../src/modules/uid/uuid/sha1.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,qBAAa,UAAU;IACrB,gFAAgF;IAChF,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAuB;IAEvD,kFAAkF;IAClF,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAuB;IAEtD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAoD;IAE7E,gDAAgD;IAChD,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,KAAK,EAAE,UAAU,CAAA;KAAE,GAAG,UAAU;CAqGnD"}

package/dist/cjs/modules/uid/uuid/sha1.js

@@ -0,0 +1,105 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Sha1Digest = void 0;
+/**
+ * SHA-1 over bytes, synchronous, no host API - `node:crypto` fails the purity gate and
+ * `crypto.subtle` is async and secure-context only.
+ *
+ * Only UUID v5 uses it. SHA-1 is broken against a chosen-prefix collision: never sign, authenticate
+ * or store a password with it.
+ */
+class Sha1Digest {
+    /** Reused: `of()` never yields, so no second call can observe it mid-flight. */
+    static { this.SCHEDULE = new Uint32Array(80); }
+    /** Padding buffer sized for a namespace plus a name; a longer input allocates. */
+    static { this.SCRATCH = new Uint8Array(512); }
+    static { this.K = [0x5a827999, 0x6ed9eba1, 0x8f1bbcdc, 0xca62c1d6]; }
+    /** Digests `bytes` into 20 big-endian bytes. */
+    static of(opts) {
+        const { bytes } = opts;
+        const length = bytes.length;
+        // Padding: a `0x80` byte, zeroes, then the bit length in the last 8 bytes of the last block.
+        const blockCount = Math.floor((length + 8) / 64) + 1;
+        const paddedLength = blockCount * 64;
+        const reusable = paddedLength <= Sha1Digest.SCRATCH.length;
+        const padded = reusable ? Sha1Digest.SCRATCH : new Uint8Array(paddedLength);
+        padded.set(bytes);
+        padded[length] = 0x80;
+        if (reusable) {
+            // The scratch still holds the previous input past this one: zero the gap, not the whole buffer.
+            padded.fill(0, length + 1, paddedLength);
+        }
+        // The bit length is 3 bits wider than 32 for inputs over 512 MB: split it arithmetically.
+        const bitsHigh = Math.floor(length / 0x20000000);
+        const bitsLow = (length << 3) >>> 0;
+        padded[paddedLength - 8] = (bitsHigh >>> 24) & 0xff;
+        padded[paddedLength - 7] = (bitsHigh >>> 16) & 0xff;
+        padded[paddedLength - 6] = (bitsHigh >>> 8) & 0xff;
+        padded[paddedLength - 5] = bitsHigh & 0xff;
+        padded[paddedLength - 4] = (bitsLow >>> 24) & 0xff;
+        padded[paddedLength - 3] = (bitsLow >>> 16) & 0xff;
+        padded[paddedLength - 2] = (bitsLow >>> 8) & 0xff;
+        padded[paddedLength - 1] = bitsLow & 0xff;
+        let h0 = 0x67452301;
+        let h1 = 0xefcdab89;
+        let h2 = 0x98badcfe;
+        let h3 = 0x10325476;
+        let h4 = 0xc3d2e1f0;
+        const schedule = Sha1Digest.SCHEDULE;
+        const constants = Sha1Digest.K;
+        for (let block = 0; block < paddedLength; block += 64) {
+            for (let index = 0; index < 16; index++) {
+                const at = block + index * 4;
+                schedule[index] =
+                    ((padded[at] << 24) | (padded[at + 1] << 16) | (padded[at + 2] << 8) | padded[at + 3]) >>>
+                        0;
+            }
+            for (let index = 16; index < 80; index++) {
+                const mixed = schedule[index - 3] ^ schedule[index - 8] ^ schedule[index - 14] ^ schedule[index - 16];
+                schedule[index] = (mixed << 1) | (mixed >>> 31);
+            }
+            let a = h0;
+            let b = h1;
+            let c = h2;
+            let d = h3;
+            let e = h4;
+            for (let index = 0; index < 80; index++) {
+                const round = (index / 20) | 0;
+                let mixed;
+                if (round === 0) {
+                    mixed = (b & c) | (~b & d);
+                }
+                else if (round === 2) {
+                    mixed = (b & c) | (b & d) | (c & d);
+                }
+                else {
+                    mixed = b ^ c ^ d;
+                }
+                const next = (((a << 5) | (a >>> 27)) + mixed + e + constants[round] + schedule[index]) >>> 0;
+                e = d;
+                d = c;
+                c = (b << 30) | (b >>> 2);
+                b = a;
+                a = next;
+            }
+            h0 = (h0 + a) >>> 0;
+            h1 = (h1 + b) >>> 0;
+            h2 = (h2 + c) >>> 0;
+            h3 = (h3 + d) >>> 0;
+            h4 = (h4 + e) >>> 0;
+        }
+        const digest = new Uint8Array(20);
+        const words = [h0, h1, h2, h3, h4];
+        for (let index = 0; index < 5; index++) {
+            const word = words[index];
+            const at = index * 4;
+            digest[at] = (word >>> 24) & 0xff;
+            digest[at + 1] = (word >>> 16) & 0xff;
+            digest[at + 2] = (word >>> 8) & 0xff;
+            digest[at + 3] = word & 0xff;
+        }
+        return digest;
+    }
+}
+exports.Sha1Digest = Sha1Digest;
+//# sourceMappingURL=sha1.js.map

package/dist/cjs/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/cjs/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/cjs/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/cjs/modules/uid/uuid/v4.js

@@ -0,0 +1,54 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.uuidV4 = exports.createUuidV4 = void 0;
+const constants_1 = require("./common/constants");
+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.
+ */
+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 = constants_1.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]]);
+    };
+};
+exports.createUuidV4 = createUuidV4;
+/** Mints a random UUID v4 - a public identifier or a token. */
+exports.uuidV4 = (0, exports.createUuidV4)();
+//# sourceMappingURL=v4.js.map

package/dist/cjs/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,kDAAqD;AAErD,MAAM,SAAS,GAAG,EAAE,GAAG,GAAG,CAAC;AAE3B;;;;GAIG;AACI,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,2BAAe,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;AA9CW,QAAA,YAAY,gBA8CvB;AAEF,+DAA+D;AAClD,QAAA,MAAM,GAAiB,IAAA,oBAAY,GAAE,CAAC"}

package/dist/cjs/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/cjs/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/cjs/modules/uid/uuid/v5.js

@@ -0,0 +1,90 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.uuidV5 = exports.createUuidV5 = void 0;
+// Past the barrels: this module ships on the `./uuid` subpath and must not pull their surface.
+const ignis_inversion_1 = require("@venizia/ignis-inversion");
+const http_1 = require("../../../common/constants/http");
+const constants_1 = require("./common/constants");
+const sha1_1 = require("./sha1");
+/** 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. */
+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 (!constants_1.UUID_NAMESPACE_PATTERN.test(namespace)) {
+            throw (0, ignis_inversion_1.getError)({
+                statusCode: http_1.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 < constants_1.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 (0, ignis_inversion_1.getError)({
+                statusCode: http_1.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 = sha1_1.Sha1Digest.of({ bytes: target.subarray(0, 16 + written) });
+        digest[6] = (digest[6] & 0x0f) | 0x50;
+        digest[8] = (digest[8] & 0x3f) | 0x80;
+        const hex = constants_1.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]]);
+    };
+};
+exports.createUuidV5 = createUuidV5;
+/**
+ * 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.
+ */
+exports.uuidV5 = (0, exports.createUuidV5)();
+//# sourceMappingURL=v5.js.map

package/dist/cjs/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/cjs/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/cjs/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/cjs/modules/uid/uuid/v7.js

@@ -0,0 +1,95 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.uuidV7 = exports.createUuidV7 = void 0;
+const constants_1 = require("./common/constants");
+/**
+ * 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.
+ */
+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 = constants_1.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 = constants_1.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]]);
+    };
+};
+exports.createUuidV7 = createUuidV7;
+const sharedV7 = Reflect.get(globalThis, SHARED_SLOT);
+const resolvedV7 = sharedV7 ?? (0, exports.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.
+ */
+const uuidV7 = () => resolvedV7();
+exports.uuidV7 = uuidV7;
+//# sourceMappingURL=v7.js.map

package/dist/cjs/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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"}