@venizia/ignis-helpers 0.2.0-9 → 0.2.0

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/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"}

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

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

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"}