@trigger.dev/core 4.5.0 → 4.5.1

package/dist/commonjs/v3/isomorphic/friendlyId.d.ts

@@ -1,4 +1,49 @@
 export declare function generateFriendlyId(prefix: string, size?: number): string;
+export declare const RUN_OPS_ID_LENGTH = 26;
+export declare const RUN_OPS_ID_REGION_INDEX = 24;
+export declare const RUN_OPS_ID_VERSION_INDEX = 25;
+export declare const RUN_OPS_ID_VERSION = "1";
+/** Region char stamped when the region is unknown or unmapped at mint. */
+export declare const DEFAULT_REGION_CHAR = "0";
+/** One lowercase [a-z0-9] char per supported region, at RUN_OPS_ID_REGION_INDEX. */
+export declare const REGION_CODES: Readonly<Record<string, string>>;
+export declare function regionCharForRegion(region: string | undefined): string;
+/** Lowercase base32hex (RFC 4648 §7): 5 bits per char, order-preserving, no padding. */
+export declare function base32hexEncode(bytes: Uint8Array): string;
+/** Inverse of base32hexEncode. Throws on characters outside the lowercase alphabet. */
+export declare function base32hexDecode(s: string): Uint8Array;
+/**
+ * Mint a run-ops v1 id body (26 chars, no prefix): 24-char base32hex core
+ * (6-byte ms timestamp + 9 CSPRNG bytes) + region char + version char "1".
+ * The trailing version char at RUN_OPS_ID_VERSION_INDEX is the residency
+ * discriminator — see runOpsResidency.ts.
+ */
+export declare function generateRunOpsId(region?: string): string;
+export type ParsedRunId = {
+    format: "b32hex";
+    table: "partitioned";
+    timestamp: Date;
+    region: string;
+    version: string;
+} | {
+    format: "legacy";
+    table: "legacy";
+};
+/**
+ * Parse a v1 id body (no prefix). Returns undefined unless the body is exactly
+ * 26 chars with version "1" at index 25 and every char inside the base32hex
+ * alphabet — anything else (cuid, nanoid, pre-cutover 27-char base62, malformed
+ * v1) is a legacy shape.
+ */
+export declare function parseRunOpsIdBody(body: string): {
+    timestamp: Date;
+    region: string;
+    version: string;
+} | undefined;
+/** True if the (prefixless) id body is a well-formed run-ops v1 id. */
+export declare function isRunOpsIdBody(body: string): boolean;
+/** Parse a `run_`-prefixed friendly id; anything not a well-formed v1 id is legacy. */
+export declare function parseRunId(id: string): ParsedRunId;
 export declare function generateInternalId(): string;
 /** Convert an internal ID to a friendly ID */
 export declare function toFriendlyId(entityName: string, internalId: string): string;

package/dist/commonjs/v3/isomorphic/friendlyId.js

@@ -3,8 +3,15 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.IdGenerator = exports.SessionId = exports.ErrorId = exports.AttemptId = exports.BulkActionId = exports.BatchId = exports.WaitpointId = exports.SnapshotId = exports.RunId = exports.QueueId = exports.CheckpointId = exports.BackgroundWorkerId = exports.IdUtil = void 0;
+exports.IdGenerator = exports.SessionId = exports.ErrorId = exports.AttemptId = exports.BulkActionId = exports.BatchId = exports.WaitpointId = exports.SnapshotId = exports.RunId = exports.QueueId = exports.CheckpointId = exports.BackgroundWorkerId = exports.IdUtil = exports.REGION_CODES = exports.DEFAULT_REGION_CHAR = exports.RUN_OPS_ID_VERSION = exports.RUN_OPS_ID_VERSION_INDEX = exports.RUN_OPS_ID_REGION_INDEX = exports.RUN_OPS_ID_LENGTH = void 0;
 exports.generateFriendlyId = generateFriendlyId;
+exports.regionCharForRegion = regionCharForRegion;
+exports.base32hexEncode = base32hexEncode;
+exports.base32hexDecode = base32hexDecode;
+exports.generateRunOpsId = generateRunOpsId;
+exports.parseRunOpsIdBody = parseRunOpsIdBody;
+exports.isRunOpsIdBody = isRunOpsIdBody;
+exports.parseRunId = parseRunId;
 exports.generateInternalId = generateInternalId;
 exports.toFriendlyId = toFriendlyId;
 exports.fromFriendlyId = fromFriendlyId;
@@ -14,6 +21,152 @@ const idGenerator = (0, nanoid_1.customAlphabet)("123456789abcdefghijkmnopqrstuv
 function generateFriendlyId(prefix, size) {
     return `${prefix}_${idGenerator(size)}`;
 }
+// Run-ops v1 id: `<24-char base32hex core><region char><version char>` — 26 chars.
+// Core = 6-byte big-endian unix ms timestamp + 9 bytes CSPRNG. Invariants:
+//  - alphabet is lowercase [a-z0-9] (base32hex is [0-9a-v]): DNS-1123 safe for
+//    k8s pod names, and byte order == lexicographic order, so ids sort in mint
+//    order at ms resolution;
+//  - the id NEVER contains "-" — that delimiter belongs to pod-name suffixes
+//    (`runner-<id>-attempt-N`), so the id round-trips through a pod name by
+//    cutting at the first hyphen;
+//  - the `run_` (friendly) and `runner-` (pod) prefixes are part of the spec:
+//    they guarantee the k8s name starts with a letter even though a base32hex
+//    core can start with a digit.
+const RUN_OPS_ID_ALPHABET = "0123456789abcdefghijklmnopqrstuv"; // base32hex, lowercase (RFC 4648 §7)
+exports.RUN_OPS_ID_LENGTH = 26;
+exports.RUN_OPS_ID_REGION_INDEX = 24;
+exports.RUN_OPS_ID_VERSION_INDEX = 25;
+exports.RUN_OPS_ID_VERSION = "1";
+const RUN_OPS_ID_CORE_BYTES = 15; // 6 timestamp + 9 random → exactly 24 base32hex chars
+const RUN_OPS_ID_CORE_LENGTH = 24;
+const RUN_OPS_ID_TIMESTAMP_BYTES = 6;
+/** Region char stamped when the region is unknown or unmapped at mint. */
+exports.DEFAULT_REGION_CHAR = "0";
+// The region char is a raw positional char (readable via charAt before any
+// decoding), NOT part of the base32hex core — so it may use the full DNS-safe
+// lowercase [a-z0-9] range (e.g. "w" for us-west-2, which is outside [0-9a-v]).
+const REGION_CHAR_PATTERN = /^[a-z0-9]$/;
+/** One lowercase [a-z0-9] char per supported region, at RUN_OPS_ID_REGION_INDEX. */
+exports.REGION_CODES = {
+    "us-east-1": "e",
+    "us-west-2": "w",
+    "eu-central-1": "c",
+};
+function regionCharForRegion(region) {
+    return (region && exports.REGION_CODES[region]) || exports.DEFAULT_REGION_CHAR;
+}
+function resolveGetRandomValues() {
+    const globalCrypto = globalThis.crypto;
+    if (globalCrypto?.getRandomValues) {
+        return (array) => globalCrypto.getRandomValues(array);
+    }
+    const webcrypto = loadNodeWebCrypto();
+    if (webcrypto?.getRandomValues) {
+        return (array) => webcrypto.getRandomValues(array);
+    }
+    throw new Error("No Web Crypto getRandomValues implementation available");
+}
+function loadNodeWebCrypto() {
+    try {
+        return (typeof require === "function" ? require("node:crypto") : undefined)?.webcrypto;
+    }
+    catch {
+        return undefined;
+    }
+}
+// Resolve the crypto source lazily on first use (memoized), so merely importing this
+// widely-used module never throws when crypto is unavailable — only minting an id would.
+let cachedGetRandomValues;
+const getRandomValues = (array) => (cachedGetRandomValues ??= resolveGetRandomValues())(array);
+/** Lowercase base32hex (RFC 4648 §7): 5 bits per char, order-preserving, no padding. */
+function base32hexEncode(bytes) {
+    let out = "";
+    let buf = 0;
+    let bits = 0;
+    for (const b of bytes) {
+        buf = (buf << 8) | b;
+        bits += 8;
+        while (bits >= 5) {
+            out += RUN_OPS_ID_ALPHABET[(buf >> (bits - 5)) & 31];
+            bits -= 5;
+        }
+    }
+    return out;
+}
+/** Inverse of base32hexEncode. Throws on characters outside the lowercase alphabet. */
+function base32hexDecode(s) {
+    const out = [];
+    let buf = 0;
+    let bits = 0;
+    for (const c of s) {
+        const v = RUN_OPS_ID_ALPHABET.indexOf(c);
+        if (v === -1) {
+            throw new Error(`invalid run id char: ${c}`);
+        }
+        buf = (buf << 5) | v;
+        bits += 5;
+        if (bits >= 8) {
+            out.push((buf >> (bits - 8)) & 0xff);
+            bits -= 8;
+        }
+    }
+    return Uint8Array.from(out);
+}
+/**
+ * Mint a run-ops v1 id body (26 chars, no prefix): 24-char base32hex core
+ * (6-byte ms timestamp + 9 CSPRNG bytes) + region char + version char "1".
+ * The trailing version char at RUN_OPS_ID_VERSION_INDEX is the residency
+ * discriminator — see runOpsResidency.ts.
+ */
+function generateRunOpsId(region) {
+    const core = new Uint8Array(RUN_OPS_ID_CORE_BYTES);
+    let ms = Date.now();
+    for (let i = RUN_OPS_ID_TIMESTAMP_BYTES - 1; i >= 0; i--) {
+        core[i] = ms % 256;
+        ms = Math.floor(ms / 256);
+    }
+    getRandomValues(core.subarray(RUN_OPS_ID_TIMESTAMP_BYTES));
+    return `${base32hexEncode(core)}${regionCharForRegion(region)}${exports.RUN_OPS_ID_VERSION}`;
+}
+const LEGACY_RUN_ID = { format: "legacy", table: "legacy" };
+/**
+ * Parse a v1 id body (no prefix). Returns undefined unless the body is exactly
+ * 26 chars with version "1" at index 25 and every char inside the base32hex
+ * alphabet — anything else (cuid, nanoid, pre-cutover 27-char base62, malformed
+ * v1) is a legacy shape.
+ */
+function parseRunOpsIdBody(body) {
+    if (body.length !== exports.RUN_OPS_ID_LENGTH)
+        return undefined;
+    if (body[exports.RUN_OPS_ID_VERSION_INDEX] !== exports.RUN_OPS_ID_VERSION)
+        return undefined;
+    const region = body[exports.RUN_OPS_ID_REGION_INDEX] ?? "";
+    if (!REGION_CHAR_PATTERN.test(region))
+        return undefined;
+    let core;
+    try {
+        core = base32hexDecode(body.slice(0, RUN_OPS_ID_CORE_LENGTH));
+    }
+    catch {
+        return undefined;
+    }
+    let ms = 0;
+    for (let i = 0; i < RUN_OPS_ID_TIMESTAMP_BYTES; i++) {
+        ms = ms * 256 + (core[i] ?? 0);
+    }
+    return { timestamp: new Date(ms), region, version: exports.RUN_OPS_ID_VERSION };
+}
+/** True if the (prefixless) id body is a well-formed run-ops v1 id. */
+function isRunOpsIdBody(body) {
+    return parseRunOpsIdBody(body) !== undefined;
+}
+/** Parse a `run_`-prefixed friendly id; anything not a well-formed v1 id is legacy. */
+function parseRunId(id) {
+    if (!id.startsWith("run_"))
+        return LEGACY_RUN_ID;
+    const parsed = parseRunOpsIdBody(id.slice(4));
+    return parsed ? { format: "b32hex", table: "partitioned", ...parsed } : LEGACY_RUN_ID;
+}
 function generateInternalId() {
     return (0, cuid_1.default)();
 }

package/dist/commonjs/v3/isomorphic/friendlyId.js.map

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

package/dist/commonjs/v3/isomorphic/friendlyId.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/commonjs/v3/isomorphic/friendlyId.test.js

@@ -0,0 +1,172 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const friendlyId_js_1 = require("./friendlyId.js");
+const CUID_LEN = 25;
+(0, vitest_1.describe)("RunId + WaitpointId mint cuid by default; run-ops v1 via generateRunOpsId", () => {
+    (0, vitest_1.it)("default: run + waitpoint mint cuid (25) and round-trip", () => {
+        for (const util of [friendlyId_js_1.RunId, friendlyId_js_1.WaitpointId]) {
+            const { id, friendlyId } = util.generate();
+            (0, vitest_1.expect)(id.length).toBe(CUID_LEN);
+            (0, vitest_1.expect)(util.fromFriendlyId(friendlyId)).toBe(id);
+            (0, vitest_1.expect)(util.toId(friendlyId)).toBe(id);
+            (0, vitest_1.expect)(util.toId(id)).toBe(id);
+            (0, vitest_1.expect)(util.toFriendlyId(id)).toBe(friendlyId);
+        }
+    });
+    (0, vitest_1.it)("explicit run-ops id: a run/waitpoint friendlyId over generateRunOpsId() is 26-char and round-trips", () => {
+        for (const util of [friendlyId_js_1.RunId, friendlyId_js_1.WaitpointId]) {
+            const id = (0, friendlyId_js_1.generateRunOpsId)();
+            const friendlyId = util.toFriendlyId(id);
+            (0, vitest_1.expect)(id.length).toBe(friendlyId_js_1.RUN_OPS_ID_LENGTH);
+            (0, vitest_1.expect)(util.fromFriendlyId(friendlyId)).toBe(id);
+            (0, vitest_1.expect)(util.toId(friendlyId)).toBe(id);
+            (0, vitest_1.expect)(util.toId(id)).toBe(id);
+        }
+    });
+    (0, vitest_1.it)("SnapshotId + QueueId stay cuid (25)", () => {
+        (0, vitest_1.expect)(friendlyId_js_1.SnapshotId.generate().id.length).toBe(CUID_LEN);
+        (0, vitest_1.expect)(friendlyId_js_1.QueueId.generate().id.length).toBe(CUID_LEN);
+    });
+});
+(0, vitest_1.describe)("base32hex codec (lowercase RFC 4648 §7)", () => {
+    // Independent reference: interpret the bytes as one big-endian integer and
+    // emit base-32 digits. Only exact multiples of 5 bytes (40 bits) are used, so
+    // there is never a partial trailing group to disagree on.
+    const ALPHA = "0123456789abcdefghijklmnopqrstuv";
+    function referenceEncode(bytes) {
+        let n = 0n;
+        for (const b of bytes)
+            n = (n << 8n) | BigInt(b);
+        const chars = (bytes.length * 8) / 5;
+        let out = "";
+        for (let i = 0; i < chars; i++) {
+            out = ALPHA[Number(n & 31n)] + out;
+            n >>= 5n;
+        }
+        return out;
+    }
+    (0, vitest_1.it)("matches the big-integer reference bit-for-bit (property, 5/10/15/20-byte inputs)", () => {
+        for (let iter = 0; iter < 2_000; iter++) {
+            for (const len of [5, 10, 15, 20]) {
+                const bytes = new Uint8Array(len);
+                crypto.getRandomValues(bytes);
+                const encoded = (0, friendlyId_js_1.base32hexEncode)(bytes);
+                (0, vitest_1.expect)(encoded).toBe(referenceEncode(bytes));
+                (0, vitest_1.expect)(Array.from((0, friendlyId_js_1.base32hexDecode)(encoded))).toEqual(Array.from(bytes));
+            }
+        }
+    });
+    (0, vitest_1.it)("hand-verified vectors", () => {
+        (0, vitest_1.expect)((0, friendlyId_js_1.base32hexEncode)(new Uint8Array(5))).toBe("00000000");
+        (0, vitest_1.expect)((0, friendlyId_js_1.base32hexEncode)(new Uint8Array(5).fill(0xff))).toBe("vvvvvvvv");
+        (0, vitest_1.expect)((0, friendlyId_js_1.base32hexEncode)(new Uint8Array([0, 0, 0, 0, 1]))).toBe("00000001");
+        // 0x20 0 0 0 0 = 2^37; 2^37 / 32^7 = 4 → leading digit "4"
+        (0, vitest_1.expect)((0, friendlyId_js_1.base32hexEncode)(new Uint8Array([0x20, 0, 0, 0, 0]))).toBe("40000000");
+    });
+    (0, vitest_1.it)("decode rejects characters outside the lowercase base32hex alphabet", () => {
+        for (const bad of ["w", "x", "z", "A", "V", "-", "_", " "]) {
+            (0, vitest_1.expect)(() => (0, friendlyId_js_1.base32hexDecode)(`0000000${bad}`)).toThrow(/invalid/i);
+        }
+    });
+});
+(0, vitest_1.describe)("generateRunOpsId — run-ops v1 id spec", () => {
+    (0, vitest_1.afterEach)(() => vitest_1.vi.useRealTimers());
+    (0, vitest_1.it)("emits <24-char base32hex core><region char><version '1'> — 26 chars total", () => {
+        const id = (0, friendlyId_js_1.generateRunOpsId)();
+        (0, vitest_1.expect)(id.length).toBe(friendlyId_js_1.RUN_OPS_ID_LENGTH);
+        (0, vitest_1.expect)(id).toMatch(/^[0-9a-v]{24}[a-z0-9]1$/);
+        (0, vitest_1.expect)(id[friendlyId_js_1.RUN_OPS_ID_VERSION_INDEX]).toBe(friendlyId_js_1.RUN_OPS_ID_VERSION);
+    });
+    (0, vitest_1.it)("only ever uses lowercase [a-z0-9] and NEVER '-' (DNS-1123 / pod-name invariant)", () => {
+        for (let i = 0; i < 5_000; i++) {
+            const id = (0, friendlyId_js_1.generateRunOpsId)();
+            (0, vitest_1.expect)(id).toMatch(/^[a-z0-9]+$/);
+            (0, vitest_1.expect)(id).not.toContain("-");
+        }
+    });
+    (0, vitest_1.it)("stamps the region char from REGION_CODES, defaulting to '0' when unknown/absent", () => {
+        (0, vitest_1.expect)((0, friendlyId_js_1.generateRunOpsId)("us-east-1")[friendlyId_js_1.RUN_OPS_ID_REGION_INDEX]).toBe("e");
+        (0, vitest_1.expect)((0, friendlyId_js_1.generateRunOpsId)("us-west-2")[friendlyId_js_1.RUN_OPS_ID_REGION_INDEX]).toBe("w");
+        (0, vitest_1.expect)((0, friendlyId_js_1.generateRunOpsId)("eu-central-1")[friendlyId_js_1.RUN_OPS_ID_REGION_INDEX]).toBe("c");
+        (0, vitest_1.expect)((0, friendlyId_js_1.generateRunOpsId)("mars-north-1")[friendlyId_js_1.RUN_OPS_ID_REGION_INDEX]).toBe("0");
+        (0, vitest_1.expect)((0, friendlyId_js_1.generateRunOpsId)()[friendlyId_js_1.RUN_OPS_ID_REGION_INDEX]).toBe("0");
+    });
+    (0, vitest_1.it)("sorts lexicographically in creation order at ms resolution (A@t, C@t+3ms, B@t+1s → A,C,B)", () => {
+        vitest_1.vi.useFakeTimers();
+        const t = new Date("2026-07-04T12:00:00.000Z").getTime();
+        vitest_1.vi.setSystemTime(t);
+        const a = (0, friendlyId_js_1.generateRunOpsId)();
+        vitest_1.vi.setSystemTime(t + 1000);
+        const b = (0, friendlyId_js_1.generateRunOpsId)();
+        vitest_1.vi.setSystemTime(t + 3);
+        const c = (0, friendlyId_js_1.generateRunOpsId)();
+        (0, vitest_1.expect)([b, c, a].sort()).toEqual([a, c, b]);
+    });
+    (0, vitest_1.it)("decode recovers the exact ms timestamp", () => {
+        vitest_1.vi.useFakeTimers();
+        const t = new Date("2026-07-04T12:34:56.789Z");
+        vitest_1.vi.setSystemTime(t);
+        const parsed = (0, friendlyId_js_1.parseRunId)(`run_${(0, friendlyId_js_1.generateRunOpsId)("us-east-1")}`);
+        (0, vitest_1.expect)(parsed.format).toBe("b32hex");
+        if (parsed.format === "b32hex") {
+            (0, vitest_1.expect)(parsed.timestamp.getTime()).toBe(t.getTime());
+        }
+    });
+    (0, vitest_1.it)("is unique across many mints in the same ms (72 bits of CSPRNG)", () => {
+        vitest_1.vi.useFakeTimers();
+        vitest_1.vi.setSystemTime(new Date("2026-07-04T00:00:00.000Z"));
+        const n = 2_000;
+        (0, vitest_1.expect)(new Set(Array.from({ length: n }, () => (0, friendlyId_js_1.generateRunOpsId)())).size).toBe(n);
+    });
+});
+(0, vitest_1.describe)("parseRunId — version-char discrimination (not length)", () => {
+    (0, vitest_1.it)("parses a v1 friendly id as partitioned with region + version", () => {
+        const parsed = (0, friendlyId_js_1.parseRunId)(`run_${(0, friendlyId_js_1.generateRunOpsId)("us-west-2")}`);
+        (0, vitest_1.expect)(parsed).toMatchObject({
+            format: "b32hex",
+            table: "partitioned",
+            region: "w",
+            version: "1",
+        });
+    });
+    (0, vitest_1.it)("classifies a cuid friendly id legacy", () => {
+        (0, vitest_1.expect)((0, friendlyId_js_1.parseRunId)(friendlyId_js_1.RunId.generate().friendlyId)).toEqual({
+            format: "legacy",
+            table: "legacy",
+        });
+    });
+    (0, vitest_1.it)("classifies a nanoid-bodied friendly id and a run_-less id legacy", () => {
+        (0, vitest_1.expect)((0, friendlyId_js_1.parseRunId)("run_123456789abcdefghijkm").format).toBe("legacy"); // 21-char nanoid body
+        (0, vitest_1.expect)((0, friendlyId_js_1.parseRunId)((0, friendlyId_js_1.generateRunOpsId)()).format).toBe("legacy"); // bare body, no run_ prefix
+        (0, vitest_1.expect)((0, friendlyId_js_1.parseRunId)("waitpoint_" + (0, friendlyId_js_1.generateRunOpsId)()).format).toBe("legacy"); // wrong prefix
+    });
+    (0, vitest_1.it)("falls back to legacy on a malformed v1 (bad alphabet / wrong version char)", () => {
+        (0, vitest_1.expect)((0, friendlyId_js_1.parseRunId)(`run_${"A".repeat(25)}1`).format).toBe("legacy"); // uppercase core
+        (0, vitest_1.expect)((0, friendlyId_js_1.parseRunId)(`run_${"a".repeat(25)}2`).format).toBe("legacy"); // wrong version
+        (0, vitest_1.expect)((0, friendlyId_js_1.parseRunId)(`run_${"a".repeat(24)}-1`).format).toBe("legacy"); // region char not [a-z0-9]
+        (0, vitest_1.expect)((0, friendlyId_js_1.parseRunId)(`run_${"a".repeat(27)}`).format).toBe("legacy"); // old 27-char shape
+    });
+});
+(0, vitest_1.describe)("firekeeper pod-name round-trip (runner-<id>[-attempt-N] → run_<id>)", () => {
+    // Mirrors firekeeper's runIDFromPodName: strip "runner-", cut before the first
+    // hyphen, prepend "run_". Works because a v1 id is all-lowercase [0-9a-v] and
+    // NEVER contains "-" — the hyphens all belong to the pod-name delimiters.
+    function firekeeperRunIdFromPodName(name) {
+        const rest = name.slice("runner-".length);
+        const hyphen = rest.indexOf("-");
+        return `run_${hyphen === -1 ? rest : rest.slice(0, hyphen)}`;
+    }
+    (0, vitest_1.it)("recovers the exact id (incl. region + version chars) from first-attempt and retry pods", () => {
+        const id = (0, friendlyId_js_1.generateRunOpsId)("us-east-1");
+        (0, vitest_1.expect)(firekeeperRunIdFromPodName(`runner-${id}`)).toBe(`run_${id}`);
+        (0, vitest_1.expect)(firekeeperRunIdFromPodName(`runner-${id}-attempt-2`)).toBe(`run_${id}`);
+        (0, vitest_1.expect)((0, friendlyId_js_1.parseRunId)(firekeeperRunIdFromPodName(`runner-${id}-attempt-2`)).format).toBe("b32hex");
+    });
+    (0, vitest_1.it)("the recovered id is a valid DNS-1123 label body (k8s accepts runner-<id>)", () => {
+        const podName = `runner-${(0, friendlyId_js_1.generateRunOpsId)("eu-central-1")}`;
+        (0, vitest_1.expect)(podName).toMatch(/^[a-z]([a-z0-9-]{0,61}[a-z0-9])?$/);
+        (0, vitest_1.expect)(podName.length).toBeLessThanOrEqual(63);
+    });
+});
+//# sourceMappingURL=friendlyId.test.js.map

package/dist/commonjs/v3/isomorphic/friendlyId.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"friendlyId.test.js","sourceRoot":"","sources":["../../../../src/v3/isomorphic/friendlyId.test.ts"],"names":[],"mappings":";;AAAA,mCAA6D;AAC7D,mDAayB;AAEzB,MAAM,QAAQ,GAAG,EAAE,CAAC;AAEpB,IAAA,iBAAQ,EAAC,2EAA2E,EAAE,GAAG,EAAE;IACzF,IAAA,WAAE,EAAC,wDAAwD,EAAE,GAAG,EAAE;QAChE,KAAK,MAAM,IAAI,IAAI,CAAC,qBAAK,EAAE,2BAAW,CAAC,EAAE,CAAC;YACxC,MAAM,EAAE,EAAE,EAAE,UAAU,EAAE,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;YAC3C,IAAA,eAAM,EAAC,EAAE,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YACjC,IAAA,eAAM,EAAC,IAAI,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACjD,IAAA,eAAM,EAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACvC,IAAA,eAAM,EAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAC/B,IAAA,eAAM,EAAC,IAAI,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACjD,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,oGAAoG,EAAE,GAAG,EAAE;QAC5G,KAAK,MAAM,IAAI,IAAI,CAAC,qBAAK,EAAE,2BAAW,CAAC,EAAE,CAAC;YACxC,MAAM,EAAE,GAAG,IAAA,gCAAgB,GAAE,CAAC;YAC9B,MAAM,UAAU,GAAG,IAAI,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;YACzC,IAAA,eAAM,EAAC,EAAE,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,iCAAiB,CAAC,CAAC;YAC1C,IAAA,eAAM,EAAC,IAAI,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACjD,IAAA,eAAM,EAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACvC,IAAA,eAAM,EAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACjC,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,qCAAqC,EAAE,GAAG,EAAE;QAC7C,IAAA,eAAM,EAAC,0BAAU,CAAC,QAAQ,EAAE,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACvD,IAAA,eAAM,EAAC,uBAAO,CAAC,QAAQ,EAAE,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACtD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,IAAA,iBAAQ,EAAC,yCAAyC,EAAE,GAAG,EAAE;IACvD,2EAA2E;IAC3E,8EAA8E;IAC9E,0DAA0D;IAC1D,MAAM,KAAK,GAAG,kCAAkC,CAAC;IACjD,SAAS,eAAe,CAAC,KAAiB;QACxC,IAAI,CAAC,GAAG,EAAE,CAAC;QACX,KAAK,MAAM,CAAC,IAAI,KAAK;YAAE,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;QACjD,MAAM,KAAK,GAAG,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC;QACrC,IAAI,GAAG,GAAG,EAAE,CAAC;QACb,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC;YAC/B,GAAG,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,GAAG,GAAG,CAAC;YACnC,CAAC,KAAK,EAAE,CAAC;QACX,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;IAED,IAAA,WAAE,EAAC,kFAAkF,EAAE,GAAG,EAAE;QAC1F,KAAK,IAAI,IAAI,GAAG,CAAC,EAAE,IAAI,GAAG,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC;YACxC,KAAK,MAAM,GAAG,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC;gBAClC,MAAM,KAAK,GAAG,IAAI,UAAU,CAAC,GAAG,CAAC,CAAC;gBAClC,MAAM,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC;gBAC9B,MAAM,OAAO,GAAG,IAAA,+BAAe,EAAC,KAAK,CAAC,CAAC;gBACvC,IAAA,eAAM,EAAC,OAAO,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC,CAAC;gBAC7C,IAAA,eAAM,EAAC,KAAK,CAAC,IAAI,CAAC,IAAA,+BAAe,EAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;YAC1E,CAAC;QACH,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,uBAAuB,EAAE,GAAG,EAAE;QAC/B,IAAA,eAAM,EAAC,IAAA,+BAAe,EAAC,IAAI,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAC5D,IAAA,eAAM,EAAC,IAAA,+BAAe,EAAC,IAAI,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACvE,IAAA,eAAM,EAAC,IAAA,+BAAe,EAAC,IAAI,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAC1E,2DAA2D;QAC3D,IAAA,eAAM,EAAC,IAAA,+BAAe,EAAC,IAAI,UAAU,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAC/E,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,oEAAoE,EAAE,GAAG,EAAE;QAC5E,KAAK,MAAM,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,EAAE,CAAC;YAC3D,IAAA,eAAM,EAAC,GAAG,EAAE,CAAC,IAAA,+BAAe,EAAC,UAAU,GAAG,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QACrE,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,IAAA,iBAAQ,EAAC,uCAAuC,EAAE,GAAG,EAAE;IACrD,IAAA,kBAAS,EAAC,GAAG,EAAE,CAAC,WAAE,CAAC,aAAa,EAAE,CAAC,CAAC;IAEpC,IAAA,WAAE,EAAC,2EAA2E,EAAE,GAAG,EAAE;QACnF,MAAM,EAAE,GAAG,IAAA,gCAAgB,GAAE,CAAC;QAC9B,IAAA,eAAM,EAAC,EAAE,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,iCAAiB,CAAC,CAAC;QAC1C,IAAA,eAAM,EAAC,EAAE,CAAC,CAAC,OAAO,CAAC,yBAAyB,CAAC,CAAC;QAC9C,IAAA,eAAM,EAAC,EAAE,CAAC,wCAAwB,CAAC,CAAC,CAAC,IAAI,CAAC,kCAAkB,CAAC,CAAC;IAChE,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,iFAAiF,EAAE,GAAG,EAAE;QACzF,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC;YAC/B,MAAM,EAAE,GAAG,IAAA,gCAAgB,GAAE,CAAC;YAC9B,IAAA,eAAM,EAAC,EAAE,CAAC,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;YAClC,IAAA,eAAM,EAAC,EAAE,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;QAChC,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,iFAAiF,EAAE,GAAG,EAAE;QACzF,IAAA,eAAM,EAAC,IAAA,gCAAgB,EAAC,WAAW,CAAC,CAAC,uCAAuB,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACzE,IAAA,eAAM,EAAC,IAAA,gCAAgB,EAAC,WAAW,CAAC,CAAC,uCAAuB,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACzE,IAAA,eAAM,EAAC,IAAA,gCAAgB,EAAC,cAAc,CAAC,CAAC,uCAAuB,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC5E,IAAA,eAAM,EAAC,IAAA,gCAAgB,EAAC,cAAc,CAAC,CAAC,uCAAuB,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC5E,IAAA,eAAM,EAAC,IAAA,gCAAgB,GAAE,CAAC,uCAAuB,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAChE,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,2FAA2F,EAAE,GAAG,EAAE;QACnG,WAAE,CAAC,aAAa,EAAE,CAAC;QACnB,MAAM,CAAC,GAAG,IAAI,IAAI,CAAC,0BAA0B,CAAC,CAAC,OAAO,EAAE,CAAC;QACzD,WAAE,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;QACpB,MAAM,CAAC,GAAG,IAAA,gCAAgB,GAAE,CAAC;QAC7B,WAAE,CAAC,aAAa,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;QAC3B,MAAM,CAAC,GAAG,IAAA,gCAAgB,GAAE,CAAC;QAC7B,WAAE,CAAC,aAAa,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QACxB,MAAM,CAAC,GAAG,IAAA,gCAAgB,GAAE,CAAC;QAC7B,IAAA,eAAM,EAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IAC9C,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,wCAAwC,EAAE,GAAG,EAAE;QAChD,WAAE,CAAC,aAAa,EAAE,CAAC;QACnB,MAAM,CAAC,GAAG,IAAI,IAAI,CAAC,0BAA0B,CAAC,CAAC;QAC/C,WAAE,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;QACpB,MAAM,MAAM,GAAG,IAAA,0BAAU,EAAC,OAAO,IAAA,gCAAgB,EAAC,WAAW,CAAC,EAAE,CAAC,CAAC;QAClE,IAAA,eAAM,EAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACrC,IAAI,MAAM,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;YAC/B,IAAA,eAAM,EAAC,MAAM,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;QACvD,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,gEAAgE,EAAE,GAAG,EAAE;QACxE,WAAE,CAAC,aAAa,EAAE,CAAC;QACnB,WAAE,CAAC,aAAa,CAAC,IAAI,IAAI,CAAC,0BAA0B,CAAC,CAAC,CAAC;QACvD,MAAM,CAAC,GAAG,KAAK,CAAC;QAChB,IAAA,eAAM,EAAC,IAAI,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,EAAE,GAAG,EAAE,CAAC,IAAA,gCAAgB,GAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACpF,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,IAAA,iBAAQ,EAAC,uDAAuD,EAAE,GAAG,EAAE;IACrE,IAAA,WAAE,EAAC,8DAA8D,EAAE,GAAG,EAAE;QACtE,MAAM,MAAM,GAAG,IAAA,0BAAU,EAAC,OAAO,IAAA,gCAAgB,EAAC,WAAW,CAAC,EAAE,CAAC,CAAC;QAClE,IAAA,eAAM,EAAC,MAAM,CAAC,CAAC,aAAa,CAAC;YAC3B,MAAM,EAAE,QAAQ;YAChB,KAAK,EAAE,aAAa;YACpB,MAAM,EAAE,GAAG;YACX,OAAO,EAAE,GAAG;SACb,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,sCAAsC,EAAE,GAAG,EAAE;QAC9C,IAAA,eAAM,EAAC,IAAA,0BAAU,EAAC,qBAAK,CAAC,QAAQ,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC;YACtD,MAAM,EAAE,QAAQ;YAChB,KAAK,EAAE,QAAQ;SAChB,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,kEAAkE,EAAE,GAAG,EAAE;QAC1E,IAAA,eAAM,EAAC,IAAA,0BAAU,EAAC,2BAA2B,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,sBAAsB;QAC7F,IAAA,eAAM,EAAC,IAAA,0BAAU,EAAC,IAAA,gCAAgB,GAAE,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,4BAA4B;QAC1F,IAAA,eAAM,EAAC,IAAA,0BAAU,EAAC,YAAY,GAAG,IAAA,gCAAgB,GAAE,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,eAAe;IAC9F,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,4EAA4E,EAAE,GAAG,EAAE;QACpF,IAAA,eAAM,EAAC,IAAA,0BAAU,EAAC,OAAO,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,iBAAiB;QACrF,IAAA,eAAM,EAAC,IAAA,0BAAU,EAAC,OAAO,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,gBAAgB;QACpF,IAAA,eAAM,EAAC,IAAA,0BAAU,EAAC,OAAO,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,2BAA2B;QAChG,IAAA,eAAM,EAAC,IAAA,0BAAU,EAAC,OAAO,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,oBAAoB;IACzF,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,IAAA,iBAAQ,EAAC,qEAAqE,EAAE,GAAG,EAAE;IACnF,+EAA+E;IAC/E,8EAA8E;IAC9E,0EAA0E;IAC1E,SAAS,0BAA0B,CAAC,IAAY;QAC9C,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QAC1C,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACjC,OAAO,OAAO,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC,EAAE,CAAC;IAC/D,CAAC;IAED,IAAA,WAAE,EAAC,wFAAwF,EAAE,GAAG,EAAE;QAChG,MAAM,EAAE,GAAG,IAAA,gCAAgB,EAAC,WAAW,CAAC,CAAC;QACzC,IAAA,eAAM,EAAC,0BAA0B,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QACrE,IAAA,eAAM,EAAC,0BAA0B,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QAC/E,IAAA,eAAM,EAAC,IAAA,0BAAU,EAAC,0BAA0B,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACjG,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,2EAA2E,EAAE,GAAG,EAAE;QACnF,MAAM,OAAO,GAAG,UAAU,IAAA,gCAAgB,EAAC,cAAc,CAAC,EAAE,CAAC;QAC7D,IAAA,eAAM,EAAC,OAAO,CAAC,CAAC,OAAO,CAAC,mCAAmC,CAAC,CAAC;QAC7D,IAAA,eAAM,EAAC,OAAO,CAAC,MAAM,CAAC,CAAC,mBAAmB,CAAC,EAAE,CAAC,CAAC;IACjD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/commonjs/v3/isomorphic/index.d.ts

@@ -1,4 +1,5 @@
 export * from "./friendlyId.js";
+export * from "./runOpsResidency.js";
 export * from "./duration.js";
 export * from "./maxDuration.js";
 export * from "./queueName.js";

package/dist/commonjs/v3/isomorphic/index.js

@@ -15,6 +15,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./friendlyId.js"), exports);
+__exportStar(require("./runOpsResidency.js"), exports);
 __exportStar(require("./duration.js"), exports);
 __exportStar(require("./maxDuration.js"), exports);
 __exportStar(require("./queueName.js"), exports);

package/dist/commonjs/v3/isomorphic/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/v3/isomorphic/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,kDAAgC;AAChC,gDAA8B;AAC9B,mDAAiC;AACjC,iDAA+B;AAC/B,8CAA4B;AAC5B,oDAAkC;AAClC,6CAA2B"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/v3/isomorphic/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,kDAAgC;AAChC,uDAAqC;AACrC,gDAA8B;AAC9B,mDAAiC;AACjC,iDAA+B;AAC/B,8CAA4B;AAC5B,oDAAkC;AAClC,6CAA2B"}

package/dist/commonjs/v3/isomorphic/runOpsResidency.d.ts

@@ -0,0 +1,36 @@
+/** The two run-ops stores a run/waitpoint can reside in. */
+export type Residency = "LEGACY" | "NEW";
+/**
+ * Underlying id lineage. "runOpsId" is the label for the NEW-store mint path
+ * — a base32hex run-ops v1 id (see friendlyId.ts). It is the value persisted in
+ * the runOpsMintKind feature flag. "cuid" is every legacy shape (cuid, nanoid,
+ * and the pre-cutover 27-char base62 format).
+ */
+export type ResidencyKind = "cuid" | "runOpsId";
+/** @bugsnag/cuid emits 25-char ids (legacy mint path, flag OFF). */
+export declare const CUID_LENGTH = 25;
+/**
+ * Kept for API compatibility: the default classifier no longer throws (every
+ * non-v1 shape is legacy), but injected classifiers may still raise it and
+ * callers still catch it.
+ */
+export declare class UnclassifiableRunId extends Error {
+    readonly value: string;
+    readonly valueLength: number;
+    constructor(value: string);
+}
+/**
+ * Returns the id lineage by the version-char rule: a well-formed run-ops v1
+ * body (26 chars, version "1" at index 25, base32hex alphabet) is "runOpsId"
+ * (NEW store); everything else — including malformed v1 shapes — is "cuid"
+ * (legacy). Total: never throws. Transition: pre-cutover 27-char base62 ids (the old
+ * NEW-mint format) now classify LEGACY, so ship this with the base32hex generator only once
+ * any 27-char NEW-resident runs are drained/disposable — no live run is misrouted mid-cutover.
+ */
+export declare function classifyKind(id: string): ResidencyKind;
+/** Classification is total now; kept for API compatibility. */
+export declare function isClassifiable(_id: string): boolean;
+/** Map an id to its owning run-ops store by the version-char rule. */
+export declare function classifyResidency(id: string): Residency;
+/** Primary public name (RoutingRunStore / cross-seam guard). */
+export declare const ownerEngine: typeof classifyResidency;

package/dist/commonjs/v3/isomorphic/runOpsResidency.js

@@ -0,0 +1,57 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ownerEngine = exports.UnclassifiableRunId = exports.CUID_LENGTH = void 0;
+exports.classifyKind = classifyKind;
+exports.isClassifiable = isClassifiable;
+exports.classifyResidency = classifyResidency;
+const friendlyId_js_1 = require("./friendlyId.js");
+/** @bugsnag/cuid emits 25-char ids (legacy mint path, flag OFF). */
+exports.CUID_LENGTH = 25;
+/**
+ * Kept for API compatibility: the default classifier no longer throws (every
+ * non-v1 shape is legacy), but injected classifiers may still raise it and
+ * callers still catch it.
+ */
+class UnclassifiableRunId extends Error {
+    value;
+    valueLength;
+    constructor(value) {
+        super(`Unclassifiable run-ops id: value=${JSON.stringify(value)} (length ${value.length})`);
+        this.name = "UnclassifiableRunId";
+        this.value = value;
+        this.valueLength = value.length;
+    }
+}
+exports.UnclassifiableRunId = UnclassifiableRunId;
+/**
+ * Strip a single leading `<prefix>_` (e.g. `run_`, `waitpoint_`) if present,
+ * so friendly and internal forms classify identically. Only the FIRST
+ * underscore is treated as the prefix separator (mirrors fromFriendlyId's
+ * two-part split contract in friendlyId.ts), without importing it.
+ */
+function internalForm(id) {
+    const underscore = id.indexOf("_");
+    return underscore === -1 ? id : id.slice(underscore + 1);
+}
+/**
+ * Returns the id lineage by the version-char rule: a well-formed run-ops v1
+ * body (26 chars, version "1" at index 25, base32hex alphabet) is "runOpsId"
+ * (NEW store); everything else — including malformed v1 shapes — is "cuid"
+ * (legacy). Total: never throws. Transition: pre-cutover 27-char base62 ids (the old
+ * NEW-mint format) now classify LEGACY, so ship this with the base32hex generator only once
+ * any 27-char NEW-resident runs are drained/disposable — no live run is misrouted mid-cutover.
+ */
+function classifyKind(id) {
+    return (0, friendlyId_js_1.isRunOpsIdBody)(internalForm(id)) ? "runOpsId" : "cuid";
+}
+/** Classification is total now; kept for API compatibility. */
+function isClassifiable(_id) {
+    return true;
+}
+/** Map an id to its owning run-ops store by the version-char rule. */
+function classifyResidency(id) {
+    return classifyKind(id) === "runOpsId" ? "NEW" : "LEGACY";
+}
+/** Primary public name (RoutingRunStore / cross-seam guard). */
+exports.ownerEngine = classifyResidency;
+//# sourceMappingURL=runOpsResidency.js.map

package/dist/commonjs/v3/isomorphic/runOpsResidency.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runOpsResidency.js","sourceRoot":"","sources":["../../../../src/v3/isomorphic/runOpsResidency.ts"],"names":[],"mappings":";;;AAmDA,oCAEC;AAGD,wCAEC;AAGD,8CAEC;AA/DD,mDAAiD;AAajD,oEAAoE;AACvD,QAAA,WAAW,GAAG,EAAE,CAAC;AAE9B;;;;GAIG;AACH,MAAa,mBAAoB,SAAQ,KAAK;IACnC,KAAK,CAAS;IACd,WAAW,CAAS;IAC7B,YAAY,KAAa;QACvB,KAAK,CAAC,oCAAoC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,YAAY,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;QAC5F,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;QAClC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,WAAW,GAAG,KAAK,CAAC,MAAM,CAAC;IAClC,CAAC;CACF;AATD,kDASC;AAED;;;;;GAKG;AACH,SAAS,YAAY,CAAC,EAAU;IAC9B,MAAM,UAAU,GAAG,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACnC,OAAO,UAAU,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC;AAC3D,CAAC;AAED;;;;;;;GAOG;AACH,SAAgB,YAAY,CAAC,EAAU;IACrC,OAAO,IAAA,8BAAc,EAAC,YAAY,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC;AAChE,CAAC;AAED,+DAA+D;AAC/D,SAAgB,cAAc,CAAC,GAAW;IACxC,OAAO,IAAI,CAAC;AACd,CAAC;AAED,sEAAsE;AACtE,SAAgB,iBAAiB,CAAC,EAAU;IAC1C,OAAO,YAAY,CAAC,EAAE,CAAC,KAAK,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC;AAC5D,CAAC;AAED,gEAAgE;AACnD,QAAA,WAAW,GAAG,iBAAiB,CAAC"}

package/dist/commonjs/v3/isomorphic/runOpsResidency.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/commonjs/v3/isomorphic/runOpsResidency.test.js

@@ -0,0 +1,58 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const friendlyId_js_1 = require("./friendlyId.js");
+const runOpsResidency_js_1 = require("./runOpsResidency.js");
+const SAMPLES = 50_000; // property-scale; CI-fast. (Bump locally toward "millions" for deeper coverage.)
+(0, vitest_1.describe)("ownerEngine — residency classifier (version char at fixed position, not length)", () => {
+    (0, vitest_1.it)("cuid ids (default mint) classify LEGACY, friendly + internal", () => {
+        for (const util of [friendlyId_js_1.RunId, friendlyId_js_1.WaitpointId]) {
+            const { id, friendlyId } = util.generate();
+            (0, vitest_1.expect)((0, runOpsResidency_js_1.ownerEngine)(id)).toBe("LEGACY");
+            (0, vitest_1.expect)((0, runOpsResidency_js_1.ownerEngine)(friendlyId)).toBe("LEGACY"); // strips run_/waitpoint_ prefix
+            (0, vitest_1.expect)((0, runOpsResidency_js_1.classifyResidency)(id)).toBe("LEGACY"); // alias agrees
+            (0, vitest_1.expect)((0, runOpsResidency_js_1.classifyKind)(id)).toBe("cuid");
+            (0, vitest_1.expect)((0, runOpsResidency_js_1.isClassifiable)(id)).toBe(true);
+        }
+    });
+    (0, vitest_1.it)("run-ops v1 ids (generateRunOpsId) classify NEW, friendly + internal, across id-shape co-located entities", () => {
+        for (const util of [friendlyId_js_1.RunId, friendlyId_js_1.WaitpointId, friendlyId_js_1.BatchId]) {
+            const id = (0, friendlyId_js_1.generateRunOpsId)("us-east-1");
+            const friendlyId = util.toFriendlyId(id);
+            (0, vitest_1.expect)((0, runOpsResidency_js_1.ownerEngine)(id)).toBe("NEW");
+            (0, vitest_1.expect)((0, runOpsResidency_js_1.ownerEngine)(friendlyId)).toBe("NEW");
+            (0, vitest_1.expect)((0, runOpsResidency_js_1.classifyResidency)(id)).toBe("NEW");
+            (0, vitest_1.expect)((0, runOpsResidency_js_1.classifyKind)(id)).toBe("runOpsId");
+        }
+    });
+    (0, vitest_1.it)("discriminates on the version char, not length: 26+'1' → NEW, 26+'2' → LEGACY", () => {
+        const v1 = "a".repeat(24) + "e1";
+        (0, vitest_1.expect)((0, runOpsResidency_js_1.ownerEngine)(v1)).toBe("NEW");
+        (0, vitest_1.expect)((0, runOpsResidency_js_1.ownerEngine)("a".repeat(24) + "e2")).toBe("LEGACY");
+        (0, vitest_1.expect)((0, runOpsResidency_js_1.ownerEngine)("a".repeat(26))).toBe("LEGACY"); // 26 chars but no version marker
+    });
+    (0, vitest_1.it)("malformed v1 shapes fall back to LEGACY (never throw)", () => {
+        for (const bad of [
+            "",
+            "x".repeat(24) + "01", // 'x' outside base32hex
+            "A".repeat(25) + "1", // uppercase
+            "a".repeat(24) + "-1", // hyphen region char
+            "a".repeat(27), // pre-cutover 27-char shape → LEGACY under the version rule
+            "run_" + "b".repeat(27), // 27-char base62 pre-cutover friendly id → LEGACY
+            "x".repeat(40),
+        ]) {
+            (0, vitest_1.expect)((0, runOpsResidency_js_1.ownerEngine)(bad)).toBe("LEGACY");
+            (0, vitest_1.expect)((0, runOpsResidency_js_1.isClassifiable)(bad)).toBe(true); // classification is total now
+        }
+    });
+    (0, vitest_1.it)("disjointness: no cuid sample is ever NEW, no v1 sample is ever LEGACY", () => {
+        for (let i = 0; i < SAMPLES; i++) {
+            (0, vitest_1.expect)((0, runOpsResidency_js_1.ownerEngine)(friendlyId_js_1.RunId.generate().id)).toBe("LEGACY");
+            (0, vitest_1.expect)((0, runOpsResidency_js_1.ownerEngine)((0, friendlyId_js_1.generateRunOpsId)())).toBe("NEW");
+        }
+    });
+    (0, vitest_1.it)("SnapshotId (always cuid) classifies LEGACY — proves snapshot needs no residency key", () => {
+        (0, vitest_1.expect)((0, runOpsResidency_js_1.ownerEngine)(friendlyId_js_1.SnapshotId.generate().id)).toBe("LEGACY");
+    });
+});
+//# sourceMappingURL=runOpsResidency.test.js.map

package/dist/commonjs/v3/isomorphic/runOpsResidency.test.js.map

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