@venizia/ignis-helpers 0.2.0-9 → 0.2.0

package/dist/esm/modules/temporal/tokens.js

@@ -0,0 +1,102 @@
+export const SUPPORTED = 'YYYY YY MM M DD D HH H mm m ss s SSS Z ZZ';
+export const MAX_COMPILED_PATTERNS = 64;
+/** Two-digit years pivot as dayjs and moment do: 00-68 is 2000-2068, 69-99 is 1969-1999. */
+export const TWO_DIGIT_YEAR_PIVOT = 68;
+/** `[min digits, max digits, field]` for every numeric token a parse reads directly. */
+export const NUMERIC_TOKENS = {
+    YYYY: [4, 4, 'year'],
+    MM: [2, 2, 'month'],
+    M: [1, 2, 'month'],
+    DD: [2, 2, 'day'],
+    D: [1, 2, 'day'],
+    HH: [2, 2, 'hour'],
+    H: [1, 2, 'hour'],
+    mm: [2, 2, 'minute'],
+    m: [1, 2, 'minute'],
+    ss: [2, 2, 'second'],
+    s: [1, 2, 'second'],
+    SSS: [3, 3, 'millisecond'],
+};
+export const pad = (opts) => String(opts.value).padStart(opts.width, '0');
+/** `+07:00`, or `+07:06:40` for an offset with seconds - historic local mean time has them. */
+export const formatOffset = (opts) => {
+    const { offsetMinutes, separator } = opts;
+    const sign = offsetMinutes < 0 ? '-' : '+';
+    const totalSeconds = Math.round(Math.abs(offsetMinutes) * 60);
+    const seconds = totalSeconds % 60;
+    const text = sign +
+        pad({ value: Math.floor(totalSeconds / 3600), width: 2 }) +
+        separator +
+        pad({ value: Math.floor((totalSeconds % 3600) / 60), width: 2 });
+    return seconds === 0 ? text : text + separator + pad({ value: seconds, width: 2 });
+};
+/** One writer per token - a lookup rather than a branch per token on every format. */
+export const WRITERS = new Map([
+    ['YYYY', parts => pad({ value: parts.year, width: 4 })],
+    ['YY', parts => pad({ value: parts.year % 100, width: 2 })],
+    ['MM', parts => pad({ value: parts.month, width: 2 })],
+    ['M', parts => String(parts.month)],
+    ['DD', parts => pad({ value: parts.day, width: 2 })],
+    ['D', parts => String(parts.day)],
+    ['HH', parts => pad({ value: parts.hour, width: 2 })],
+    ['H', parts => String(parts.hour)],
+    ['mm', parts => pad({ value: parts.minute, width: 2 })],
+    ['m', parts => String(parts.minute)],
+    ['ss', parts => pad({ value: parts.second, width: 2 })],
+    ['s', parts => String(parts.second)],
+    ['SSS', parts => pad({ value: parts.millisecond, width: 3 })],
+    ['Z', parts => formatOffset({ offsetMinutes: parts.offsetMinutes, separator: ':' })],
+    ['ZZ', parts => formatOffset({ offsetMinutes: parts.offsetMinutes, separator: '' })],
+]);
+export const isLetter = (code) => (code >= 65 && code <= 90) || (code >= 97 && code <= 122);
+export const isDigit = (code) => code >= 48 && code <= 57;
+/** Reads `min`..`max` digits at `position`, greedily; undefined when fewer than `min` are there. */
+export const readDigits = (opts) => {
+    const { value, position, min, max } = opts;
+    let next = position;
+    let number = 0;
+    while (next < value.length && next - position < max && isDigit(value.charCodeAt(next))) {
+        number = number * 10 + (value.charCodeAt(next) - 48);
+        next += 1;
+    }
+    return next - position < min ? undefined : { number, next };
+};
+/** Reads two digits after an optional separator; undefined when either is missing. */
+export const readOffsetField = (opts) => {
+    const { value, position, separator } = opts;
+    if (separator && value[position] !== ':') {
+        return undefined;
+    }
+    return readDigits({ value, position: separator ? position + 1 : position, min: 2, max: 2 });
+};
+/**
+ * `Z`, `+07:00` (`Z` token) or `+0700` (`ZZ` token), seconds optional, as milliseconds east
+ * of UTC. Hours past 23 and minutes or seconds past 59 are refused rather than rolled over.
+ */
+export const readOffset = (opts) => {
+    const { value, position, separator } = opts;
+    const sign = value[position];
+    if (sign === 'Z') {
+        return { milliseconds: 0, next: position + 1 };
+    }
+    if (sign !== '+' && sign !== '-') {
+        return undefined;
+    }
+    const hours = readDigits({ value, position: position + 1, min: 2, max: 2 });
+    if (!hours) {
+        return undefined;
+    }
+    const minutes = readOffsetField({ value, position: hours.next, separator });
+    if (!minutes) {
+        return undefined;
+    }
+    const seconds = readOffsetField({ value, position: minutes.next, separator });
+    if (hours.number > 23 || minutes.number > 59 || (seconds && seconds.number > 59)) {
+        return undefined;
+    }
+    const total = ((hours.number * 60 + minutes.number) * 60 + (seconds?.number ?? 0)) * 1000;
+    return { milliseconds: sign === '-' ? -total : total, next: (seconds ?? minutes).next };
+};
+export const TOKEN_NAMES = new Set(WRITERS.keys());
+export const isToken = (run) => TOKEN_NAMES.has(run);
+//# sourceMappingURL=tokens.js.map

package/dist/esm/modules/temporal/tokens.js.map

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

package/dist/esm/modules/uid/index.d.ts

@@ -2,4 +2,5 @@ export * from './common/index.js';
 export * from './helper.js';
 export * from './opaque.js';
 export * from './request-id.js';
+export * from './uuid/index.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/esm/modules/uid/index.d.ts.map

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

package/dist/esm/modules/uid/index.js

@@ -2,4 +2,5 @@ export * from './common/index.js';
 export * from './helper.js';
 export * from './opaque.js';
 export * from './request-id.js';
+export * from './uuid/index.js';
 //# sourceMappingURL=index.js.map

package/dist/esm/modules/uid/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/modules/uid/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC;AACzB,cAAc,cAAc,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/modules/uid/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC;AACzB,cAAc,cAAc,CAAC;AAC7B,cAAc,QAAQ,CAAC"}

package/dist/esm/modules/uid/request-id.d.ts

@@ -1,29 +1,22 @@
 import { BaseHelper } from '../base.js';
 /**
  * The correlation id every IGNIS host stamps on a request, so a server, a browser Worker and the
- * page calling it cannot drift into different formats.
+ * page calling it cannot drift into different formats. A UUID version 4 - random, no clock to
+ * correlate a caller by - drawn through {@link UuidHelper}.
  *
  * Never `crypto.randomUUID()` on its own, which is `hono/request-id`'s default: browsers gate that
  * one API on a SECURE CONTEXT. Measured in Chrome - on `http://<lan-ip>` both the page and a Worker
  * report `crypto` present and `getRandomValues` working, while `randomUUID` and `subtle` are
  * `undefined` and the call throws `TypeError`. On `http://localhost` (a secure origin) all four are
  * there. So the gate follows the ORIGIN, not the worker: testing from a phone over the LAN is
- * enough to lose it.
- *
- * `getRandomValues` carries no such gate, so the fallback below builds the identical shape from raw
- * entropy - a log pipeline cannot tell the two paths apart.
+ * enough to lose it. `UuidHelper.v4()` rebuilds the identical shape from `getRandomValues`, which
+ * carries no such gate - a log pipeline cannot tell the two paths apart.
  */
 export declare class RequestIdGenerator extends BaseHelper {
-    /** 256 pre-rendered octets: formatting a byte as hex costs more than drawing the entropy does. */
-    private static readonly HEX_OCTETS;
-    /** Reused across calls - `nextId()` never yields between filling this and reading it. */
-    private readonly entropy;
-    private readonly generate;
+    private readonly uuid;
     constructor(opts?: {
         scope?: string;
     });
     nextId(): string;
-    /** RFC 9562 version 4, same shape `crypto.randomUUID()` returns: version nibble 4, variant 10xx. */
-    private uuidFromEntropy;
 }
 //# sourceMappingURL=request-id.d.ts.map

package/dist/esm/modules/uid/request-id.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"request-id.d.ts","sourceRoot":"","sources":["../../../../src/modules/uid/request-id.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAErC;;;;;;;;;;;;;GAaG;AACH,qBAAa,kBAAmB,SAAQ,UAAU;IAChD,kGAAkG;IAClG,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,UAAU,CAEhC;IAEF,yFAAyF;IACzF,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAsB;IAE9C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAe;gBAE5B,IAAI,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE;IAWrC,MAAM,IAAI,MAAM;IAIhB,oGAAoG;IACpG,OAAO,CAAC,eAAe;CAgCxB"}
+{"version":3,"file":"request-id.d.ts","sourceRoot":"","sources":["../../../../src/modules/uid/request-id.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAGrC;;;;;;;;;;;;GAYG;AACH,qBAAa,kBAAmB,SAAQ,UAAU;IAChD,OAAO,CAAC,QAAQ,CAAC,IAAI,CAA4B;gBAErC,IAAI,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE;IAIrC,MAAM,IAAI,MAAM;CAGjB"}

package/dist/esm/modules/uid/request-id.js

@@ -1,62 +1,25 @@
 import { BaseHelper } from '../base.js';
+import { UuidHelper } from './uuid/index.js';
 /**
  * The correlation id every IGNIS host stamps on a request, so a server, a browser Worker and the
- * page calling it cannot drift into different formats.
+ * page calling it cannot drift into different formats. A UUID version 4 - random, no clock to
+ * correlate a caller by - drawn through {@link UuidHelper}.
  *
  * Never `crypto.randomUUID()` on its own, which is `hono/request-id`'s default: browsers gate that
  * one API on a SECURE CONTEXT. Measured in Chrome - on `http://<lan-ip>` both the page and a Worker
  * report `crypto` present and `getRandomValues` working, while `randomUUID` and `subtle` are
  * `undefined` and the call throws `TypeError`. On `http://localhost` (a secure origin) all four are
  * there. So the gate follows the ORIGIN, not the worker: testing from a phone over the LAN is
- * enough to lose it.
- *
- * `getRandomValues` carries no such gate, so the fallback below builds the identical shape from raw
- * entropy - a log pipeline cannot tell the two paths apart.
+ * enough to lose it. `UuidHelper.v4()` rebuilds the identical shape from `getRandomValues`, which
+ * carries no such gate - a log pipeline cannot tell the two paths apart.
  */
 export class RequestIdGenerator extends BaseHelper {
-    /** 256 pre-rendered octets: formatting a byte as hex costs more than drawing the entropy does. */
-    static { this.HEX_OCTETS = Array.from({ length: 256 }, (_, value) => (value + 0x100).toString(16).slice(1)); }
     constructor(opts) {
         super({ scope: opts?.scope ?? RequestIdGenerator.name });
-        /** Reused across calls - `nextId()` never yields between filling this and reading it. */
-        this.entropy = new Uint8Array(16);
-        // Resolved once, not per call: whether the host exposes `randomUUID` is fixed for the life of a
-        // realm, so a per-request branch would only pay for a question already answered.
-        this.generate =
-            typeof globalThis.crypto?.randomUUID === 'function'
-                ? () => globalThis.crypto.randomUUID()
-                : () => this.uuidFromEntropy();
+        this.uuid = UuidHelper.getInstance();
     }
     nextId() {
-        return this.generate();
-    }
-    /** RFC 9562 version 4, same shape `crypto.randomUUID()` returns: version nibble 4, variant 10xx. */
-    uuidFromEntropy() {
-        const bytes = this.entropy;
-        globalThis.crypto.getRandomValues(bytes);
-        bytes[6] = (bytes[6] & 0x0f) | 0x40;
-        bytes[8] = (bytes[8] & 0x3f) | 0x80;
-        const hex = RequestIdGenerator.HEX_OCTETS;
-        return (hex[bytes[0]] +
-            hex[bytes[1]] +
-            hex[bytes[2]] +
-            hex[bytes[3]] +
-            '-' +
-            hex[bytes[4]] +
-            hex[bytes[5]] +
-            '-' +
-            hex[bytes[6]] +
-            hex[bytes[7]] +
-            '-' +
-            hex[bytes[8]] +
-            hex[bytes[9]] +
-            '-' +
-            hex[bytes[10]] +
-            hex[bytes[11]] +
-            hex[bytes[12]] +
-            hex[bytes[13]] +
-            hex[bytes[14]] +
-            hex[bytes[15]]);
+        return this.uuid.v4();
     }
 }
 //# sourceMappingURL=request-id.js.map

package/dist/esm/modules/uid/request-id.js.map

@@ -1 +1 @@
-{"version":3,"file":"request-id.js","sourceRoot":"","sources":["../../../../src/modules/uid/request-id.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAErC;;;;;;;;;;;;;GAaG;AACH,MAAM,OAAO,kBAAmB,SAAQ,UAAU;IAChD,kGAAkG;aAC1E,eAAU,GAAG,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,CAC5E,CAAC,KAAK,GAAG,KAAK,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CACtC,AAFiC,CAEhC;IAOF,YAAY,IAAyB;QACnC,KAAK,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,IAAI,kBAAkB,CAAC,IAAI,EAAE,CAAC,CAAC;QAN3D,yFAAyF;QACxE,YAAO,GAAG,IAAI,UAAU,CAAC,EAAE,CAAC,CAAC;QAO5C,gGAAgG;QAChG,iFAAiF;QACjF,IAAI,CAAC,QAAQ;YACX,OAAO,UAAU,CAAC,MAAM,EAAE,UAAU,KAAK,UAAU;gBACjD,CAAC,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,UAAU,EAAE;gBACtC,CAAC,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,eAAe,EAAE,CAAC;IACrC,CAAC;IAED,MAAM;QACJ,OAAO,IAAI,CAAC,QAAQ,EAAE,CAAC;IACzB,CAAC;IAED,oGAAoG;IAC5F,eAAe;QACrB,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC;QAC3B,UAAU,CAAC,MAAM,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC;QAEzC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC;QACpC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC;QAEpC,MAAM,GAAG,GAAG,kBAAkB,CAAC,UAAU,CAAC;QAE1C,OAAO,CACL,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YACb,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YACb,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YACb,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YACb,GAAG;YACH,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YACb,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YACb,GAAG;YACH,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YACb,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YACb,GAAG;YACH,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YACb,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YACb,GAAG;YACH,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YACd,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YACd,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YACd,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YACd,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YACd,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CACf,CAAC;IACJ,CAAC"}
+{"version":3,"file":"request-id.js","sourceRoot":"","sources":["../../../../src/modules/uid/request-id.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAEpC;;;;;;;;;;;;GAYG;AACH,MAAM,OAAO,kBAAmB,SAAQ,UAAU;IAGhD,YAAY,IAAyB;QACnC,KAAK,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,IAAI,kBAAkB,CAAC,IAAI,EAAE,CAAC,CAAC;QAH1C,SAAI,GAAG,UAAU,CAAC,WAAW,EAAE,CAAC;IAIjD,CAAC;IAED,MAAM;QACJ,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC;IACxB,CAAC;CACF"}

package/dist/esm/modules/uid/uuid/common/constants.d.ts

@@ -0,0 +1,32 @@
+/**
+ * The four namespaces RFC 9562 names. A namespace partitions the deterministic space, so one
+ * `name` under two namespaces answers two ids.
+ *
+ * Need your own? Mint it ONCE (`bun -e "console.log(crypto.randomUUID())"`) and pin it as a
+ * constant. Generating one at runtime makes `uuidV5` answer a different id every call, silently.
+ */
+export declare class UuidNamespaces {
+    /** Fully-qualified domain names. */
+    static readonly DNS = "6ba7b810-9dad-11d1-80b4-00c04fd430c8";
+    /** URLs. The usual pick for a business key written as a path, like `orders/4711/refund`. */
+    static readonly URL = "6ba7b811-9dad-11d1-80b4-00c04fd430c8";
+    /** ISO object identifiers. */
+    static readonly OID = "6ba7b812-9dad-11d1-80b4-00c04fd430c8";
+    /** X.500 distinguished names. */
+    static readonly X500 = "6ba7b814-9dad-11d1-80b4-00c04fd430c8";
+}
+/** 256 pre-rendered octets: formatting a byte as hex costs more than producing it does. */
+export declare const UUID_HEX_OCTETS: string[];
+/**
+ * Lowercase, version 1-8, RFC variant. The all-zero nil id and the all-one max id fail it on
+ * purpose: both are placeholders, and a column holding one is holding a bug.
+ */
+export declare const UUID_PATTERN: RegExp;
+/**
+ * Any well-formed UUID, either case: a v5 namespace is 16 bytes, and RFC 9562 reads its hex
+ * case-insensitively. Wider than {@link UUID_PATTERN} on purpose - the nil UUID is a valid namespace.
+ */
+export declare const UUID_NAMESPACE_PATTERN: RegExp;
+/** Parsed namespaces are cached; past this many distinct ones the cache stops growing and parsing resumes, so a caller-fed namespace cannot grow the map without bound. */
+export declare const MAX_CACHED_NAMESPACES = 32;
+//# sourceMappingURL=constants.d.ts.map

package/dist/esm/modules/uid/uuid/common/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../../../../src/modules/uid/uuid/common/constants.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,qBAAa,cAAc;IACzB,oCAAoC;IACpC,MAAM,CAAC,QAAQ,CAAC,GAAG,0CAA0C;IAE7D,4FAA4F;IAC5F,MAAM,CAAC,QAAQ,CAAC,GAAG,0CAA0C;IAE7D,8BAA8B;IAC9B,MAAM,CAAC,QAAQ,CAAC,GAAG,0CAA0C;IAE7D,iCAAiC;IACjC,MAAM,CAAC,QAAQ,CAAC,IAAI,0CAA0C;CAC/D;AAED,2FAA2F;AAC3F,eAAO,MAAM,eAAe,UAE3B,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,YAAY,QACoD,CAAC;AAE9E;;;GAGG;AACH,eAAO,MAAM,sBAAsB,QACgC,CAAC;AAEpE,2KAA2K;AAC3K,eAAO,MAAM,qBAAqB,KAAK,CAAC"}

package/dist/esm/modules/uid/uuid/common/constants.js

@@ -0,0 +1,32 @@
+/**
+ * The four namespaces RFC 9562 names. A namespace partitions the deterministic space, so one
+ * `name` under two namespaces answers two ids.
+ *
+ * Need your own? Mint it ONCE (`bun -e "console.log(crypto.randomUUID())"`) and pin it as a
+ * constant. Generating one at runtime makes `uuidV5` answer a different id every call, silently.
+ */
+export class UuidNamespaces {
+    /** Fully-qualified domain names. */
+    static { this.DNS = '6ba7b810-9dad-11d1-80b4-00c04fd430c8'; }
+    /** URLs. The usual pick for a business key written as a path, like `orders/4711/refund`. */
+    static { this.URL = '6ba7b811-9dad-11d1-80b4-00c04fd430c8'; }
+    /** ISO object identifiers. */
+    static { this.OID = '6ba7b812-9dad-11d1-80b4-00c04fd430c8'; }
+    /** X.500 distinguished names. */
+    static { this.X500 = '6ba7b814-9dad-11d1-80b4-00c04fd430c8'; }
+}
+/** 256 pre-rendered octets: formatting a byte as hex costs more than producing it does. */
+export const UUID_HEX_OCTETS = Array.from({ length: 256 }, (_, value) => (value + 0x100).toString(16).slice(1));
+/**
+ * Lowercase, version 1-8, RFC variant. The all-zero nil id and the all-one max id fail it on
+ * purpose: both are placeholders, and a column holding one is holding a bug.
+ */
+export const UUID_PATTERN = /^[0-9a-f]{8}-[0-9a-f]{4}-[1-8][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/;
+/**
+ * Any well-formed UUID, either case: a v5 namespace is 16 bytes, and RFC 9562 reads its hex
+ * case-insensitively. Wider than {@link UUID_PATTERN} on purpose - the nil UUID is a valid namespace.
+ */
+export const UUID_NAMESPACE_PATTERN = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+/** Parsed namespaces are cached; past this many distinct ones the cache stops growing and parsing resumes, so a caller-fed namespace cannot grow the map without bound. */
+export const MAX_CACHED_NAMESPACES = 32;
+//# sourceMappingURL=constants.js.map

package/dist/esm/modules/uid/uuid/common/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../../../../src/modules/uid/uuid/common/constants.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,OAAO,cAAc;IACzB,oCAAoC;aACpB,QAAG,GAAG,sCAAsC,CAAC;IAE7D,4FAA4F;aAC5E,QAAG,GAAG,sCAAsC,CAAC;IAE7D,8BAA8B;aACd,QAAG,GAAG,sCAAsC,CAAC;IAE7D,iCAAiC;aACjB,SAAI,GAAG,sCAAsC,CAAC;;AAGhE,2FAA2F;AAC3F,MAAM,CAAC,MAAM,eAAe,GAAG,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,CACtE,CAAC,KAAK,GAAG,KAAK,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CACtC,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,YAAY,GACvB,2EAA2E,CAAC;AAE9E;;;GAGG;AACH,MAAM,CAAC,MAAM,sBAAsB,GACjC,iEAAiE,CAAC;AAEpE,2KAA2K;AAC3K,MAAM,CAAC,MAAM,qBAAqB,GAAG,EAAE,CAAC"}

package/dist/esm/modules/uid/uuid/common/index.d.ts

@@ -0,0 +1,3 @@
+export { UuidNamespaces, UUID_PATTERN } from './constants.js';
+export * from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/modules/uid/uuid/common/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/modules/uid/uuid/common/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3D,cAAc,SAAS,CAAC"}

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

@@ -0,0 +1,5 @@
+// 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.
+export { UuidNamespaces, UUID_PATTERN } from './constants.js';
+export * from './types.js';
+//# sourceMappingURL=index.js.map

package/dist/esm/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,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3D,cAAc,SAAS,CAAC"}

package/dist/esm/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/esm/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/esm/modules/uid/uuid/common/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/esm/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/esm/modules/uid/uuid/helper.d.ts

@@ -0,0 +1,37 @@
+import { BaseHelper } from '../../base.js';
+import type { IUuidInspection } from './common/types.js';
+/**
+ * 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/esm/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/esm/modules/uid/uuid/helper.js

@@ -0,0 +1,45 @@
+import { BaseHelper } from '../../base.js';
+import { UUID_PATTERN } from './common/constants.js';
+import { uuidV4 } from './v4.js';
+import { uuidV5 } from './v5.js';
+import { uuidV7 } from './v7.js';
+/**
+ * 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 class UuidHelper extends BaseHelper {
+    constructor(opts) {
+        super({ scope: opts?.scope ?? UuidHelper.name });
+        /** Random - a public identifier or a token. */
+        this.v4 = uuidV4;
+        /** Deterministic - same inputs, same id. Reproducible therefore not secret. */
+        this.v5 = uuidV5;
+        /** Time-ordered - a database key. A burst past about 2048 ids per millisecond leads the wall clock. */
+        this.v7 = 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 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 (!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) };
+    }
+}
+//# sourceMappingURL=helper.js.map

package/dist/esm/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,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,OAAO,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAC9B,OAAO,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAC9B,OAAO,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAE9B;;;;;;GAMG;AACH,MAAM,OAAO,UAAW,SAAQ,UAAU;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,MAAM,CAAC;QAEnC,+EAA+E;QACtE,OAAE,GAA0D,MAAM,CAAC;QAE5E,uGAAuG;QAC9F,OAAE,GAAiB,MAAM,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,YAAY,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,YAAY,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"}

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

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

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

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

package/dist/esm/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,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC;AACzB,cAAc,MAAM,CAAC;AACrB,cAAc,MAAM,CAAC;AACrB,cAAc,MAAM,CAAC"}

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

@@ -0,0 +1,101 @@
+/**
+ * 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 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;
+    }
+}
+//# sourceMappingURL=sha1.js.map