@venizia/ignis-helpers 0.2.0-8 → 0.2.0

package/dist/cjs/modules/temporal/pattern.js

@@ -0,0 +1,133 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TemporalPattern = void 0;
+const http_1 = require("../../common/constants/http");
+const error_1 = require("../error");
+const tokens_1 = require("./tokens");
+/** The pattern dialect: compiled once per pattern, then formatted and parsed from the cache. */
+class TemporalPattern {
+    /** A service formats the same few patterns millions of times; capped so caller-fed patterns cannot grow it. */
+    static { this.compiled = new Map(); }
+    /**
+     * Splits a pattern into tokens and literals. A run of one letter is one token, and an unknown run
+     * is refused: `yyyy` is not `YYYY`, and `MMM` is never read as `MM` then `M`.
+     */
+    static compile(opts) {
+        const { pattern } = opts;
+        const cached = TemporalPattern.compiled.get(pattern);
+        if (cached) {
+            return cached;
+        }
+        const segments = [];
+        let literal = '';
+        let position = 0;
+        while (position < pattern.length) {
+            const character = pattern[position];
+            if (character === '[') {
+                const close = pattern.indexOf(']', position + 1);
+                if (close < 0) {
+                    throw (0, error_1.getError)({
+                        statusCode: http_1.HTTP.ResultCodes.RS_5.InternalServerError,
+                        message: `[TemporalPattern] unclosed [ in pattern '${pattern}'`,
+                    });
+                }
+                literal += pattern.slice(position + 1, close);
+                position = close + 1;
+                continue;
+            }
+            // `T` is the ISO date-time separator, and the one letter a pattern may carry bare.
+            if (!(0, tokens_1.isLetter)(pattern.charCodeAt(position)) || character === 'T') {
+                literal += character;
+                position += 1;
+                continue;
+            }
+            let runEnd = position + 1;
+            while (pattern[runEnd] === character) {
+                runEnd += 1;
+            }
+            const run = pattern.slice(position, runEnd);
+            if (!(0, tokens_1.isToken)(run)) {
+                throw (0, error_1.getError)({
+                    statusCode: http_1.HTTP.ResultCodes.RS_5.InternalServerError,
+                    message: `[TemporalPattern] unknown token '${run}' in pattern '${pattern}' | Supported: ${tokens_1.SUPPORTED}; wrap text in [brackets]`,
+                });
+            }
+            if (literal) {
+                segments.push({ literal });
+                literal = '';
+            }
+            segments.push({ token: run });
+            position = runEnd;
+        }
+        if (literal) {
+            segments.push({ literal });
+        }
+        if (TemporalPattern.compiled.size < tokens_1.MAX_COMPILED_PATTERNS) {
+            TemporalPattern.compiled.set(pattern, segments);
+        }
+        return segments;
+    }
+    static format(opts) {
+        const segments = TemporalPattern.compile({ pattern: opts.pattern });
+        let text = '';
+        for (const segment of segments) {
+            text +=
+                'literal' in segment ? segment.literal : (tokens_1.WRITERS.get(segment.token)?.(opts.parts) ?? '');
+        }
+        return text;
+    }
+    /** The fields a value spells under a pattern, or undefined when it does not match. Unset fields default to the start: month 1, day 1, 00:00. */
+    static parse(opts) {
+        const { value } = opts;
+        const segments = TemporalPattern.compile({ pattern: opts.pattern });
+        const parts = {
+            year: 1970,
+            month: 1,
+            day: 1,
+            hour: 0,
+            minute: 0,
+            second: 0,
+            millisecond: 0,
+        };
+        let offsetMilliseconds;
+        let position = 0;
+        for (const segment of segments) {
+            if ('literal' in segment) {
+                if (!value.startsWith(segment.literal, position)) {
+                    return undefined;
+                }
+                position += segment.literal.length;
+                continue;
+            }
+            const { token } = segment;
+            if (token === 'Z' || token === 'ZZ') {
+                const offset = (0, tokens_1.readOffset)({ value, position, separator: token === 'Z' });
+                if (!offset) {
+                    return undefined;
+                }
+                offsetMilliseconds = offset.milliseconds;
+                position = offset.next;
+                continue;
+            }
+            if (token === 'YY') {
+                const read = (0, tokens_1.readDigits)({ value, position, min: 2, max: 2 });
+                if (!read) {
+                    return undefined;
+                }
+                parts.year = read.number + (read.number > tokens_1.TWO_DIGIT_YEAR_PIVOT ? 1900 : 2000);
+                position = read.next;
+                continue;
+            }
+            const [min, max, field] = tokens_1.NUMERIC_TOKENS[token];
+            const read = (0, tokens_1.readDigits)({ value, position, min, max });
+            if (!read) {
+                return undefined;
+            }
+            parts[field] = read.number;
+            position = read.next;
+        }
+        return position === value.length ? { parts, offsetMilliseconds } : undefined;
+    }
+}
+exports.TemporalPattern = TemporalPattern;
+//# sourceMappingURL=pattern.js.map

package/dist/cjs/modules/temporal/pattern.js.map

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

package/dist/cjs/modules/temporal/tokens.d.ts

@@ -0,0 +1,65 @@
+import type { ITemporalParts, IZonedTemporalParts } from './common/types';
+/**
+ * The pattern dialect, one for every adapter: `YYYY YY MM M DD D HH H mm m ss s SSS Z ZZ`, with
+ * text in `[brackets]`. Numeric only - month and weekday names are a locale's business, not a parser's.
+ */
+export type TPatternToken = 'YYYY' | 'YY' | 'MM' | 'M' | 'DD' | 'D' | 'HH' | 'H' | 'mm' | 'm' | 'ss' | 's' | 'SSS' | 'Z' | 'ZZ';
+export type TPatternSegment = {
+    token: TPatternToken;
+} | {
+    literal: string;
+};
+export type TNumericToken = Exclude<TPatternToken, 'Z' | 'ZZ' | 'YY'>;
+export declare const SUPPORTED = "YYYY YY MM M DD D HH H mm m ss s SSS Z ZZ";
+export declare 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 declare const TWO_DIGIT_YEAR_PIVOT = 68;
+/** `[min digits, max digits, field]` for every numeric token a parse reads directly. */
+export declare const NUMERIC_TOKENS: Record<TNumericToken, [number, number, keyof ITemporalParts]>;
+export declare const pad: (opts: {
+    value: number;
+    width: number;
+}) => string;
+/** `+07:00`, or `+07:06:40` for an offset with seconds - historic local mean time has them. */
+export declare const formatOffset: (opts: {
+    offsetMinutes: number;
+    separator: string;
+}) => string;
+/** One writer per token - a lookup rather than a branch per token on every format. */
+export declare const WRITERS: Map<TPatternToken, (parts: IZonedTemporalParts) => string>;
+export declare const isLetter: (code: number) => boolean;
+export declare const isDigit: (code: number) => boolean;
+/** Reads `min`..`max` digits at `position`, greedily; undefined when fewer than `min` are there. */
+export declare const readDigits: (opts: {
+    value: string;
+    position: number;
+    min: number;
+    max: number;
+}) => {
+    number: number;
+    next: number;
+} | undefined;
+/** Reads two digits after an optional separator; undefined when either is missing. */
+export declare const readOffsetField: (opts: {
+    value: string;
+    position: number;
+    separator: boolean;
+}) => {
+    number: number;
+    next: number;
+} | undefined;
+/**
+ * `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 declare const readOffset: (opts: {
+    value: string;
+    position: number;
+    separator: boolean;
+}) => {
+    milliseconds: number;
+    next: number;
+} | undefined;
+export declare const TOKEN_NAMES: ReadonlySet<string>;
+export declare const isToken: (run: string) => run is TPatternToken;
+//# sourceMappingURL=tokens.d.ts.map

package/dist/cjs/modules/temporal/tokens.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokens.d.ts","sourceRoot":"","sources":["../../../../src/modules/temporal/tokens.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAE1E;;;GAGG;AACH,MAAM,MAAM,aAAa,GACrB,MAAM,GACN,IAAI,GACJ,IAAI,GACJ,GAAG,GACH,IAAI,GACJ,GAAG,GACH,IAAI,GACJ,GAAG,GACH,IAAI,GACJ,GAAG,GACH,IAAI,GACJ,GAAG,GACH,KAAK,GACL,GAAG,GACH,IAAI,CAAC;AAET,MAAM,MAAM,eAAe,GAAG;IAAE,KAAK,EAAE,aAAa,CAAA;CAAE,GAAG;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAE7E,MAAM,MAAM,aAAa,GAAG,OAAO,CAAC,aAAa,EAAE,GAAG,GAAG,IAAI,GAAG,IAAI,CAAC,CAAC;AAEtE,eAAO,MAAM,SAAS,8CAA8C,CAAC;AAErE,eAAO,MAAM,qBAAqB,KAAK,CAAC;AAExC,4FAA4F;AAC5F,eAAO,MAAM,oBAAoB,KAAK,CAAC;AAEvC,wFAAwF;AACxF,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,aAAa,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC,CAaxF,CAAC;AAEF,eAAO,MAAM,GAAG,GAAI,MAAM;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,KAAG,MACf,CAAC;AAE/C,+FAA+F;AAC/F,eAAO,MAAM,YAAY,GAAI,MAAM;IAAE,aAAa,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,KAAG,MAYjF,CAAC;AAEF,sFAAsF;AACtF,eAAO,MAAM,OAAO,6BAAkC,mBAAmB,KAAK,MAAM,CAgBlF,CAAC;AAEH,eAAO,MAAM,QAAQ,GAAI,MAAM,MAAM,KAAG,OACmB,CAAC;AAE5D,eAAO,MAAM,OAAO,GAAI,MAAM,MAAM,KAAG,OAAmC,CAAC;AAE3E,oGAAoG;AACpG,eAAO,MAAM,UAAU,GAAI,MAAM;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;CACb,KAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,SAStC,CAAC;AAEF,sFAAsF;AACtF,eAAO,MAAM,eAAe,GAAI,MAAM;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,OAAO,CAAC;CACpB,KAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,SAMtC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,UAAU,GAAI,MAAM;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,OAAO,CAAC;CACpB,KAAG;IAAE,YAAY,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,SA0B5C,CAAC;AAEF,eAAO,MAAM,WAAW,EAAE,WAAW,CAAC,MAAM,CAA2B,CAAC;AAExE,eAAO,MAAM,OAAO,GAAI,KAAK,MAAM,KAAG,GAAG,IAAI,aAAqC,CAAC"}

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

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

package/dist/cjs/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/cjs/modules/tree/builder.d.ts

@@ -1,5 +1,5 @@
 import type { IBuildOptions, INodeWithPath, IPrintOptions, ITreeNode } from './common/types';
-import { BaseHelper } from '../../modules/base';
+import { BaseHelper } from '../base';
 /**
  * Static members call each other through the class name (`TreeBuilder.xxx`), never `this` - a
  * detached static method loses its `this` binding.

package/dist/cjs/modules/tree/builder.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.TreeBuilder = void 0;
-const base_1 = require("../../modules/base");
+const base_1 = require("../base");
 /**
  * Static members call each other through the class name (`TreeBuilder.xxx`), never `this` - a
  * detached static method loses its `this` binding.

package/dist/cjs/modules/tree/walk.d.ts

@@ -1,5 +1,5 @@
 import type { IHeightWhereOptions, ITreeNode, IWalkAsyncOptions, IWalkOptions } from './common/types';
-import { BaseHelper } from '../../modules/base';
+import { BaseHelper } from '../base';
 /**
  * Static members call each other through the class name (`TreeWalker.xxx`), never `this` - a
  * detached static method loses its `this` binding.

package/dist/cjs/modules/tree/walk.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.TreeWalker = void 0;
-const base_1 = require("../../modules/base");
+const base_1 = require("../base");
 /**
  * Static members call each other through the class name (`TreeWalker.xxx`), never `this` - a
  * detached static method loses its `this` binding.

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

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

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

@@ -18,4 +18,5 @@ __exportStar(require("./common"), exports);
 __exportStar(require("./helper"), exports);
 __exportStar(require("./opaque"), exports);
 __exportStar(require("./request-id"), exports);
+__exportStar(require("./uuid"), exports);
 //# sourceMappingURL=index.js.map

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

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

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

@@ -1,29 +1,22 @@
 import { BaseHelper } from '../base';
 /**
  * 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/cjs/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/cjs/modules/uid/request-id.js

@@ -2,64 +2,27 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.RequestIdGenerator = void 0;
 const base_1 = require("../base");
+const uuid_1 = require("./uuid");
 /**
  * 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.
  */
 class RequestIdGenerator extends base_1.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 = uuid_1.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();
     }
 }
 exports.RequestIdGenerator = RequestIdGenerator;

package/dist/cjs/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,kCAAqC;AAErC;;;;;;;;;;;;;GAaG;AACH,MAAa,kBAAmB,SAAQ,iBAAU;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;;AA1DH,gDA2DC"}
+{"version":3,"file":"request-id.js","sourceRoot":"","sources":["../../../../src/modules/uid/request-id.ts"],"names":[],"mappings":";;;AAAA,kCAAqC;AACrC,iCAAoC;AAEpC;;;;;;;;;;;;GAYG;AACH,MAAa,kBAAmB,SAAQ,iBAAU;IAGhD,YAAY,IAAyB;QACnC,KAAK,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,IAAI,kBAAkB,CAAC,IAAI,EAAE,CAAC,CAAC;QAH1C,SAAI,GAAG,iBAAU,CAAC,WAAW,EAAE,CAAC;IAIjD,CAAC;IAED,MAAM;QACJ,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC;IACxB,CAAC;CACF;AAVD,gDAUC"}

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

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MAX_CACHED_NAMESPACES = exports.UUID_NAMESPACE_PATTERN = exports.UUID_PATTERN = exports.UUID_HEX_OCTETS = exports.UuidNamespaces = void 0;
+/**
+ * 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.
+ */
+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'; }
+}
+exports.UuidNamespaces = UuidNamespaces;
+/** 256 pre-rendered octets: formatting a byte as hex costs more than producing it does. */
+exports.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.
+ */
+exports.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.
+ */
+exports.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. */
+exports.MAX_CACHED_NAMESPACES = 32;
+//# sourceMappingURL=constants.js.map

package/dist/cjs/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,MAAa,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;;AAXhE,wCAYC;AAED,2FAA2F;AAC9E,QAAA,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;AACU,QAAA,YAAY,GACvB,2EAA2E,CAAC;AAE9E;;;GAGG;AACU,QAAA,sBAAsB,GACjC,iEAAiE,CAAC;AAEpE,2KAA2K;AAC9J,QAAA,qBAAqB,GAAG,EAAE,CAAC"}

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

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

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