@trigger.dev/core 4.5.11 → 4.5.13

package/dist/commonjs/v3/idempotencyKeys.test.js

@@ -1,7 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+const node_http_1 = require("node:http");
 const vitest_1 = require("vitest");
+const apiClientManager_api_js_1 = require("./apiClientManager-api.js");
 const idempotencyKeys_js_1 = require("./idempotencyKeys.js");
+const crypto_js_1 = require("./utils/crypto.js");
 (0, vitest_1.describe)("idempotencyKeys metadata retention", () => {
     (0, vitest_1.it)("retains key/scope options for every key created in a run, even beyond 1000", async () => {
         const count = 3000;
@@ -31,4 +34,159 @@ const idempotencyKeys_js_1 = require("./idempotencyKeys.js");
         (0, vitest_1.expect)((0, idempotencyKeys_js_1.getIdempotencyKeyOptions)(key)).toBeUndefined();
     });
 });
+(0, vitest_1.describe)("resetIdempotencyKey", () => {
+    const digestShapedKey = "a".repeat(64);
+    let server;
+    let resetKeys = [];
+    /** Keys the server has runs for. `undefined` means "accept every key". */
+    let existingKeys;
+    /** Per-key failure statuses, applied before the existence check. */
+    let statusByKey;
+    function notFoundMessage(key) {
+        return `No runs found with idempotency key: ${key}`;
+    }
+    async function resetAndCaptureKey(...args) {
+        resetKeys = [];
+        await (0, idempotencyKeys_js_1.resetIdempotencyKey)(...args);
+        (0, vitest_1.expect)(resetKeys).toHaveLength(1);
+        return resetKeys[0];
+    }
+    (0, vitest_1.beforeEach)(async () => {
+        (0, idempotencyKeys_js_1.resetIdempotencyKeyCatalog)();
+        resetKeys = [];
+        existingKeys = undefined;
+        statusByKey = new Map();
+        server = (0, node_http_1.createServer)((req, res) => {
+            req.resume();
+            req.on("end", () => {
+                const match = /^\/api\/v1\/idempotencyKeys\/(.+)\/reset$/.exec(req.url ?? "");
+                if (!match) {
+                    res.writeHead(404).end();
+                    return;
+                }
+                const key = decodeURIComponent(match[1]);
+                resetKeys.push(key);
+                const failWith = statusByKey.get(key);
+                if (failWith !== undefined) {
+                    res.writeHead(failWith, { "content-type": "application/json" });
+                    res.end(JSON.stringify({ error: `request failed for ${key}` }));
+                    return;
+                }
+                if (existingKeys !== undefined && !existingKeys.has(key)) {
+                    res.writeHead(404, { "content-type": "application/json" });
+                    res.end(JSON.stringify({ error: notFoundMessage(key) }));
+                    return;
+                }
+                res.writeHead(200, { "content-type": "application/json" });
+                res.end(JSON.stringify({ id: "run_reset" }));
+            });
+        });
+        await new Promise((resolve) => {
+            server.listen(0, "127.0.0.1", () => resolve());
+        });
+        apiClientManager_api_js_1.apiClientManager.setGlobalAPIClientConfiguration({
+            baseURL: `http://127.0.0.1:${server.address().port}`,
+            accessToken: "tr_test_key",
+        });
+    });
+    (0, vitest_1.afterEach)(async () => {
+        apiClientManager_api_js_1.apiClientManager.disable();
+        (0, idempotencyKeys_js_1.resetIdempotencyKeyCatalog)();
+        await new Promise((resolve) => server.close(() => resolve()));
+    });
+    (0, vitest_1.it)("derives the hash for 64-character key material with an explicit scope when the verbatim key misses", async () => {
+        const created = await (0, idempotencyKeys_js_1.createIdempotencyKey)(digestShapedKey, { scope: "global" });
+        (0, idempotencyKeys_js_1.resetIdempotencyKeyCatalog)();
+        existingKeys = new Set([created]);
+        await (0, idempotencyKeys_js_1.resetIdempotencyKey)("my-task", digestShapedKey, { scope: "global" });
+        (0, vitest_1.expect)(resetKeys).toEqual([digestShapedKey, created]);
+    });
+    (0, vitest_1.it)("derives the run-scoped hash for 64-character key material when the verbatim key misses", async () => {
+        const parentRunId = "run_abc123";
+        const expected = await (0, crypto_js_1.digestSHA256)(`${digestShapedKey}-${parentRunId}`);
+        existingKeys = new Set([expected]);
+        await (0, idempotencyKeys_js_1.resetIdempotencyKey)("my-task", digestShapedKey, { scope: "run", parentRunId });
+        (0, vitest_1.expect)(resetKeys).toEqual([digestShapedKey, expected]);
+    });
+    (0, vitest_1.it)("sends a key created with idempotencyKeys.create() unchanged while the catalog knows it", async () => {
+        const created = await (0, idempotencyKeys_js_1.createIdempotencyKey)("my-key", { scope: "global" });
+        existingKeys = new Set([created]);
+        (0, vitest_1.expect)(await resetAndCaptureKey("my-task", created)).toBe(created);
+        (0, vitest_1.expect)(await resetAndCaptureKey("my-task", created, { scope: "global" })).toBe(created);
+    });
+    (0, vitest_1.it)("sends a created key unchanged when no scope is passed and the catalog is cold", async () => {
+        const created = await (0, idempotencyKeys_js_1.createIdempotencyKey)("my-key", { scope: "global" });
+        // The reset can happen in a different process from the create
+        (0, idempotencyKeys_js_1.resetIdempotencyKeyCatalog)();
+        existingKeys = new Set([created]);
+        (0, vitest_1.expect)(await resetAndCaptureKey("my-task", created)).toBe(created);
+    });
+    (0, vitest_1.it)("resolves a created key in one request when reset with a scope and the catalog is cold", async () => {
+        const created = await (0, idempotencyKeys_js_1.createIdempotencyKey)("my-key", { scope: "global" });
+        (0, idempotencyKeys_js_1.resetIdempotencyKeyCatalog)();
+        existingKeys = new Set([created]);
+        (0, vitest_1.expect)(await resetAndCaptureKey("my-task", created, { scope: "global" })).toBe(created);
+    });
+    (0, vitest_1.it)("sends a 64-character key unchanged when no scope is passed", async () => {
+        (0, vitest_1.expect)(await resetAndCaptureKey("my-task", digestShapedKey)).toBe(digestShapedKey);
+    });
+    (0, vitest_1.it)("resets 64-character material that trigger stored verbatim when no scope is passed", async () => {
+        // trigger() forwards 64-character material as-is, so that is what the server stored
+        (0, vitest_1.expect)(await (0, idempotencyKeys_js_1.makeIdempotencyKey)(digestShapedKey)).toBe(digestShapedKey);
+        existingKeys = new Set([digestShapedKey]);
+        (0, vitest_1.expect)(await resetAndCaptureKey("my-task", digestShapedKey)).toBe(digestShapedKey);
+    });
+    (0, vitest_1.it)("resets the verbatim run when runs exist under both the verbatim key and the derived hash", async () => {
+        const created = await (0, idempotencyKeys_js_1.createIdempotencyKey)(digestShapedKey, { scope: "global" });
+        (0, idempotencyKeys_js_1.resetIdempotencyKeyCatalog)();
+        existingKeys = new Set([digestShapedKey, created]);
+        await (0, idempotencyKeys_js_1.resetIdempotencyKey)("my-task", digestShapedKey, { scope: "global" });
+        (0, vitest_1.expect)(resetKeys).toEqual([digestShapedKey]);
+    });
+    (0, vitest_1.it)("does not reset the derived run when the verbatim attempt fails transiently", async () => {
+        const created = await (0, idempotencyKeys_js_1.createIdempotencyKey)(digestShapedKey, { scope: "global" });
+        (0, idempotencyKeys_js_1.resetIdempotencyKeyCatalog)();
+        statusByKey.set(digestShapedKey, 503);
+        existingKeys = new Set([created]);
+        await (0, vitest_1.expect)((0, idempotencyKeys_js_1.resetIdempotencyKey)("my-task", digestShapedKey, { scope: "global" }, { retry: { maxAttempts: 1 } })).rejects.toMatchObject({ status: 503 });
+        (0, vitest_1.expect)(resetKeys).toEqual([digestShapedKey]);
+    });
+    (0, vitest_1.it)("surfaces the fallback's error when it fails with something other than a 404", async () => {
+        const derived = await (0, crypto_js_1.digestSHA256)(digestShapedKey);
+        statusByKey.set(digestShapedKey, 404);
+        statusByKey.set(derived, 503);
+        await (0, vitest_1.expect)((0, idempotencyKeys_js_1.resetIdempotencyKey)("my-task", digestShapedKey, { scope: "global" }, { retry: { maxAttempts: 1 } })).rejects.toMatchObject({ status: 503 });
+        (0, vitest_1.expect)(resetKeys).toEqual([digestShapedKey, derived]);
+    });
+    (0, vitest_1.it)("surfaces the verbatim key's error when both attempts 404", async () => {
+        const derived = await (0, crypto_js_1.digestSHA256)(digestShapedKey);
+        existingKeys = new Set();
+        await (0, vitest_1.expect)((0, idempotencyKeys_js_1.resetIdempotencyKey)("my-task", digestShapedKey, { scope: "global" })).rejects.toThrow(notFoundMessage(digestShapedKey));
+        (0, vitest_1.expect)(resetKeys).toEqual([digestShapedKey, derived]);
+    });
+    (0, vitest_1.it)("hashes key material that is not 64 characters", async () => {
+        const created = await (0, idempotencyKeys_js_1.createIdempotencyKey)("my-key", { scope: "global" });
+        (0, idempotencyKeys_js_1.resetIdempotencyKeyCatalog)();
+        (0, vitest_1.expect)(await resetAndCaptureKey("my-task", "my-key", { scope: "global" })).toBe(created);
+    });
+    (0, vitest_1.it)("sends a 64-character key verbatim when run scope cannot be derived", async () => {
+        const created = await (0, idempotencyKeys_js_1.createIdempotencyKey)("my-key", { scope: "run" });
+        (0, idempotencyKeys_js_1.resetIdempotencyKeyCatalog)();
+        existingKeys = new Set([created]);
+        // No parentRunId and no task context, so the hash is underivable
+        (0, vitest_1.expect)(await resetAndCaptureKey("my-task", created, { scope: "run" })).toBe(created);
+    });
+    (0, vitest_1.it)("sends a 64-character key verbatim when attempt scope cannot be derived", async () => {
+        existingKeys = new Set([digestShapedKey]);
+        (0, vitest_1.expect)(await resetAndCaptureKey("my-task", digestShapedKey, { scope: "attempt" })).toBe(digestShapedKey);
+    });
+    (0, vitest_1.it)("still throws for non-64-character material when run scope cannot be derived", async () => {
+        await (0, vitest_1.expect)((0, idempotencyKeys_js_1.resetIdempotencyKey)("my-task", "my-key", { scope: "run" })).rejects.toThrow("parentRunId is required for 'run' scope");
+        (0, vitest_1.expect)(resetKeys).toEqual([]);
+    });
+    (0, vitest_1.it)("still throws for non-64-character material when attempt scope cannot be derived", async () => {
+        await (0, vitest_1.expect)((0, idempotencyKeys_js_1.resetIdempotencyKey)("my-task", "my-key", { scope: "attempt", parentRunId: "run_abc123" })).rejects.toThrow("parentRunId and attemptNumber are required for 'attempt' scope");
+        (0, vitest_1.expect)(resetKeys).toEqual([]);
+    });
+});
 //# sourceMappingURL=idempotencyKeys.test.js.map

package/dist/commonjs/v3/idempotencyKeys.test.js.map

@@ -1 +1 @@
-{"version":3,"file":"idempotencyKeys.test.js","sourceRoot":"","sources":["../../../src/v3/idempotencyKeys.test.ts"],"names":[],"mappings":";;AAAA,mCAA8C;AAC9C,6DAI8B;AAE9B,IAAA,iBAAQ,EAAC,oCAAoC,EAAE,GAAG,EAAE;IAClD,IAAA,WAAE,EAAC,4EAA4E,EAAE,KAAK,IAAI,EAAE;QAC1F,MAAM,KAAK,GAAG,IAAI,CAAC;QACnB,MAAM,IAAI,GAAa,EAAE,CAAC;QAE1B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC;YAC/B,MAAM,GAAG,GAAG,MAAM,IAAA,yCAAoB,EAAC,QAAQ,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;YACzE,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACjB,CAAC;QAED,wEAAwE;QACxE,wEAAwE;QACxE,+CAA+C;QAC/C,MAAM,YAAY,GAAG,IAAA,6CAAwB,EAAC,IAAI,CAAC,CAAC,CAAE,CAAC,CAAC;QACxD,IAAA,eAAM,EAAC,YAAY,CAAC,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;QAEjE,wDAAwD;QACxD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC;YAC/B,MAAM,OAAO,GAAG,IAAA,6CAAwB,EAAC,IAAI,CAAC,CAAC,CAAE,CAAC,CAAC;YACnD,IAAA,eAAM,EAAC,OAAO,EAAE,iCAAiC,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC;gBAC5D,GAAG,EAAE,QAAQ,CAAC,EAAE;gBAChB,KAAK,EAAE,QAAQ;aAChB,CAAC,CAAC;QACL,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,8DAA8D,EAAE,KAAK,IAAI,EAAE;QAC5E,MAAM,GAAG,GAAG,MAAM,IAAA,yCAAoB,EAAC,cAAc,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;QAC5E,IAAA,eAAM,EAAC,IAAA,6CAAwB,EAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE,cAAc,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;QAExF,IAAA,+CAA0B,GAAE,CAAC;QAE7B,IAAA,eAAM,EAAC,IAAA,6CAAwB,EAAC,GAAG,CAAC,CAAC,CAAC,aAAa,EAAE,CAAC;IACxD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}
+{"version":3,"file":"idempotencyKeys.test.js","sourceRoot":"","sources":["../../../src/v3/idempotencyKeys.test.ts"],"names":[],"mappings":"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"}

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

@@ -5,6 +5,7 @@ export type { ApiPromise, OffsetLimitPagePromise, CursorPagePromise } from "./ap
 export * from "./apiClient/errors.js";
 export * from "./clock-api.js";
 export * from "./errors.js";
+export * from "./externalDeploymentId.js";
 export * from "./limits.js";
 export * from "./logger-api.js";
 export * from "./runtime-api.js";

package/dist/commonjs/v3/index.js

@@ -21,6 +21,7 @@ __exportStar(require("./apiClient/pagination.js"), exports);
 __exportStar(require("./apiClient/errors.js"), exports);
 __exportStar(require("./clock-api.js"), exports);
 __exportStar(require("./errors.js"), exports);
+__exportStar(require("./externalDeploymentId.js"), exports);
 __exportStar(require("./limits.js"), exports);
 __exportStar(require("./logger-api.js"), exports);
 __exportStar(require("./runtime-api.js"), exports);

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/v3/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,uDAAqC;AACrC,uDAAqC;AACrC,4DAA0C;AAE1C,wDAAsC;AACtC,iDAA+B;AAC/B,8CAA4B;AAC5B,8CAA4B;AAC5B,kDAAgC;AAChC,mDAAiC;AACjC,wDAAsC;AACtC,yDAAuC;AACvC,4DAA0C;AAC1C,oDAAkC;AAClC,iDAA+B;AAC/B,wDAAsC;AACtC,sDAAoC;AACpC,mDAAiC;AACjC,gEAA8C;AAC9C,2DAAyC;AACzC,kDAAgC;AAChC,sDAAoC;AACpC,4DAA0C;AAC1C,yDAAuC;AACvC,2DAAyC;AACzC,wDAAsC;AACtC,qDAAmC;AACnC,iFAA6E;AAApE,2IAAA,0BAA0B,OAAA;AACnC,4DAA0C;AAC1C,mDAAiC;AACjC,uCAAmC;AAA1B,iGAAA,KAAK,OAAA;AACd,2CAAyB;AACzB,+CAA6B;AAC7B,+DAA6C;AAC7C,uDAAqC;AACrC,mEAAiD;AACjD,oDAAkC;AAClC,gDAA8B;AAC9B,qDAO8B;AAN5B,8GAAA,cAAc,OAAA;AACd,oHAAA,oBAAoB,OAAA;AACpB,0HAAA,0BAA0B,OAAA;AAC1B,yHAAA,yBAAyB,OAAA;AACzB,yHAAA,yBAAyB,OAAA;AACzB,yHAAA,yBAAyB,OAAA;AAK3B,kEAA8D;AAArD,2HAAA,kBAAkB,OAAA;AAC3B,qEAKsC;AAJpC,yHAAA,iBAAiB,OAAA;AACjB,2IAAA,mCAAmC,OAAA;AACnC,2HAAA,mBAAmB,OAAA;AACnB,qHAAA,aAAa,OAAA;AAEf,2CAAuC;AAA9B,+FAAA,IAAI,OAAA;AACb,4DAAgF;AAAvE,mHAAA,kBAAkB,OAAA;AAAE,+GAAA,cAAc,OAAA;AAC3C,iDAK4B;AAJ1B,qHAAA,uBAAuB,OAAA;AACvB,8GAAA,gBAAgB,OAAA;AAChB,sHAAA,wBAAwB,OAAA;AACxB,iHAAA,mBAAmB,OAAA;AAErB,iEAAiE;AAAxD,yHAAA,mBAAmB,OAAA;AAE5B,iEAUoC;AATlC,+HAAA,yBAAyB,OAAA;AACzB,+HAAA,yBAAyB,OAAA;AACzB,4HAAA,sBAAsB,OAAA;AACtB,kIAAA,4BAA4B,OAAA;AAC5B,8HAAA,wBAAwB,OAAA;AACxB,iHAAA,WAAW,OAAA;AACX,uHAAA,iBAAiB,OAAA;AACjB,iHAAA,WAAW,OAAA;AAIb,sDAAoC;AACpC,sDAAoC;AAEpC,8CAA4B;AAC5B,iDAQ4B;AAP1B,8GAAA,gBAAgB,OAAA;AAIhB,8GAAA,gBAAgB,OAAA;AAChB,kHAAA,oBAAoB,OAAA;AACpB,kHAAA,oBAAoB,OAAA;AAGtB,8CAAwC;6FAA/B,oBAAO"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/v3/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,uDAAqC;AACrC,uDAAqC;AACrC,4DAA0C;AAE1C,wDAAsC;AACtC,iDAA+B;AAC/B,8CAA4B;AAC5B,4DAA0C;AAC1C,8CAA4B;AAC5B,kDAAgC;AAChC,mDAAiC;AACjC,wDAAsC;AACtC,yDAAuC;AACvC,4DAA0C;AAC1C,oDAAkC;AAClC,iDAA+B;AAC/B,wDAAsC;AACtC,sDAAoC;AACpC,mDAAiC;AACjC,gEAA8C;AAC9C,2DAAyC;AACzC,kDAAgC;AAChC,sDAAoC;AACpC,4DAA0C;AAC1C,yDAAuC;AACvC,2DAAyC;AACzC,wDAAsC;AACtC,qDAAmC;AACnC,iFAA6E;AAApE,2IAAA,0BAA0B,OAAA;AACnC,4DAA0C;AAC1C,mDAAiC;AACjC,uCAAmC;AAA1B,iGAAA,KAAK,OAAA;AACd,2CAAyB;AACzB,+CAA6B;AAC7B,+DAA6C;AAC7C,uDAAqC;AACrC,mEAAiD;AACjD,oDAAkC;AAClC,gDAA8B;AAC9B,qDAO8B;AAN5B,8GAAA,cAAc,OAAA;AACd,oHAAA,oBAAoB,OAAA;AACpB,0HAAA,0BAA0B,OAAA;AAC1B,yHAAA,yBAAyB,OAAA;AACzB,yHAAA,yBAAyB,OAAA;AACzB,yHAAA,yBAAyB,OAAA;AAK3B,kEAA8D;AAArD,2HAAA,kBAAkB,OAAA;AAC3B,qEAKsC;AAJpC,yHAAA,iBAAiB,OAAA;AACjB,2IAAA,mCAAmC,OAAA;AACnC,2HAAA,mBAAmB,OAAA;AACnB,qHAAA,aAAa,OAAA;AAEf,2CAAuC;AAA9B,+FAAA,IAAI,OAAA;AACb,4DAAgF;AAAvE,mHAAA,kBAAkB,OAAA;AAAE,+GAAA,cAAc,OAAA;AAC3C,iDAK4B;AAJ1B,qHAAA,uBAAuB,OAAA;AACvB,8GAAA,gBAAgB,OAAA;AAChB,sHAAA,wBAAwB,OAAA;AACxB,iHAAA,mBAAmB,OAAA;AAErB,iEAAiE;AAAxD,yHAAA,mBAAmB,OAAA;AAE5B,iEAUoC;AATlC,+HAAA,yBAAyB,OAAA;AACzB,+HAAA,yBAAyB,OAAA;AACzB,4HAAA,sBAAsB,OAAA;AACtB,kIAAA,4BAA4B,OAAA;AAC5B,8HAAA,wBAAwB,OAAA;AACxB,iHAAA,WAAW,OAAA;AACX,uHAAA,iBAAiB,OAAA;AACjB,iHAAA,WAAW,OAAA;AAIb,sDAAoC;AACpC,sDAAoC;AAEpC,8CAA4B;AAC5B,iDAQ4B;AAP1B,8GAAA,gBAAgB,OAAA;AAIhB,8GAAA,gBAAgB,OAAA;AAChB,kHAAA,oBAAoB,OAAA;AACpB,kHAAA,oBAAoB,OAAA;AAGtB,8CAAwC;6FAA/B,oBAAO"}

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

@@ -0,0 +1 @@
+export declare function compareDeploymentVersions(versionA: string, versionB: string): number;

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

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.compareDeploymentVersions = compareDeploymentVersions;
+function compareDeploymentVersions(versionA, versionB) {
+    const [dateA = "", numberA] = versionA.split(".");
+    const [dateB = "", numberB] = versionB.split(".");
+    if (dateA < dateB) {
+        return -1;
+    }
+    if (dateA > dateB) {
+        return 1;
+    }
+    const numA = Number(numberA);
+    const numB = Number(numberB);
+    if (numA < numB) {
+        return -1;
+    }
+    if (numA > numB) {
+        return 1;
+    }
+    return 0;
+}
+//# sourceMappingURL=deploymentVersions.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"deploymentVersions.js","sourceRoot":"","sources":["../../../../src/v3/isomorphic/deploymentVersions.ts"],"names":[],"mappings":";;;AAAA,mCAA0C,QAAgB,EAAE,QAAgB;IAC1E,MAAM,CAAC,KAAK,GAAG,EAAE,EAAE,OAAO,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAClD,MAAM,CAAC,KAAK,GAAG,EAAE,EAAE,OAAO,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAElD,IAAI,KAAK,GAAG,KAAK,EAAE,CAAC;QAClB,OAAO,CAAC,CAAC,CAAC;IACZ,CAAC;IAED,IAAI,KAAK,GAAG,KAAK,EAAE,CAAC;QAClB,OAAO,CAAC,CAAC;IACX,CAAC;IAED,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;IAC7B,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;IAE7B,IAAI,IAAI,GAAG,IAAI,EAAE,CAAC;QAChB,OAAO,CAAC,CAAC,CAAC;IACZ,CAAC;IAED,IAAI,IAAI,GAAG,IAAI,EAAE,CAAC;QAChB,OAAO,CAAC,CAAC;IACX,CAAC;IAED,OAAO,CAAC,CAAC;AACX,CAAC"}

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

@@ -3,8 +3,13 @@ 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";
+export declare const RUN_OPS_ID_VERSION_2 = "2";
+export declare const RUN_OPS_ID_SHARD_INDEX = 24;
 /** Region char stamped when the region is unknown or unmapped at mint. */
 export declare const DEFAULT_REGION_CHAR = "0";
+/** True iff `value` is a single valid gen-2 shard char. The descriptor validator and
+ * `resolveShard` share this so a configured key and a decoded key cannot drift. */
+export declare function isValidShardChar(value: string): boolean;
 /** 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;
@@ -19,12 +24,24 @@ export declare function base32hexDecode(s: string): Uint8Array;
  * discriminator — see runOpsResidency.ts.
  */
 export declare function generateRunOpsId(region?: string): string;
+/**
+ * Mint a gen-2 id body (26 chars, no prefix): the same core, then the shard key,
+ * then version char "2". Throws on a shard char outside [a-z0-9] — an id that
+ * cannot be routed must never be minted.
+ */
+export declare function generateRunOpsIdV2(shardChar: string): string;
 export type ParsedRunId = {
     format: "b32hex";
     table: "partitioned";
     timestamp: Date;
     region: string;
     version: string;
+} | {
+    format: "b32hexV2";
+    table: "partitioned";
+    timestamp: Date;
+    shard: string;
+    version: string;
 } | {
     format: "legacy";
     table: "legacy";
@@ -40,10 +57,56 @@ export declare function parseRunOpsIdBody(body: string): {
     region: string;
     version: string;
 } | undefined;
+/**
+ * Parse a gen-2 id body (no prefix): the mirror of {@link parseRunOpsIdBody},
+ * requiring version "2" at index 25 and a shard key in [a-z0-9] at index 24.
+ * Total: returns undefined for any other string, and never throws.
+ */
+export declare function parseRunOpsIdV2Body(body: string): {
+    timestamp: Date;
+    shard: 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 isRunOpsIdBodyShape(body: string): boolean;
+export declare function runOpsIdV2ShardShape(body: string): string | undefined;
+/** Parse a `run_`-prefixed friendly id; anything not a well-formed v1/gen-2 id is legacy. */
 export declare function parseRunId(id: string): ParsedRunId;
+export declare const WAITPOINT_ID_VERSION = "w";
+export declare const WAITPOINT_ID_TYPE_INDEX = 24;
+export type WaitpointIdType = "RUN" | "BATCH" | "DATETIME" | "MANUAL";
+export type ParsedWaitpointId = {
+    format: "b32hexW";
+    type: WaitpointIdType;
+    timestamp: Date;
+} | {
+    format: "legacy";
+};
+/**
+ * Mint a standalone waitpoint id body (26 chars, no prefix) for DATETIME and MANUAL: a
+ * fresh core, the type char, then the waitpoint version char.
+ */
+export declare function generateWaitpointId(type: WaitpointIdType): string;
+/**
+ * Derive the 1:1 waitpoint id body for a RUN or BATCH anchor by reusing the anchor's
+ * 24-char core. Pure, so create-if-absent is idempotent without a lock. Returns
+ * undefined when the anchor is not a run-ops id, which is the caller's signal to mint a
+ * legacy waitpoint instead.
+ *
+ * Only the core survives: the anchor's region or shard char and its version char are
+ * both replaced. So the anchor id is NOT recoverable from the waitpoint id — the reverse
+ * direction uses the completedBy* back-pointer.
+ */
+export declare function deriveWaitpointIdFromAnchor(anchorId: string, type: WaitpointIdType): string | undefined;
+/**
+ * Classify a waitpoint id. Accepts the prefixed (`waitpoint_<body>`) and bare forms, but
+ * NOT another entity's prefix (`run_`, `batch_`, ...) — this is the discriminator a
+ * later ticket uses to route a possibly customer-supplied id, so a foreign prefix must
+ * classify legacy rather than have its body reinterpreted as a waitpoint id. Total:
+ * never throws.
+ */
+export declare function parseWaitpointId(id: string): ParsedWaitpointId;
 export declare function generateInternalId(): string;
 /** Convert an internal ID to a friendly ID */
 export declare function toFriendlyId(entityName: string, internalId: string): string;
@@ -72,6 +135,25 @@ export declare const BulkActionId: IdUtil;
 export declare const AttemptId: IdUtil;
 export declare const ErrorId: IdUtil;
 export declare const SessionId: IdUtil;
+export declare const WebhookEndpointId: IdUtil;
+export declare const WebhookDeliveryId: {
+    /**
+     * Mint a delivery id. The row's `createdAt` MUST be set to the returned `timestamp` so the id's
+     * embedded timestamp equals the partition key that {@link WebhookDeliveryId.parseTimestamp} recovers.
+     */
+    generate(): {
+        id: string;
+        friendlyId: string;
+        timestamp: Date;
+    };
+    toFriendlyId(id: string): string;
+    toId(idOrFriendlyId: string): string;
+    /**
+     * Decode the mint timestamp (== the row's `createdAt` partition key) from an id or friendlyId.
+     * Returns `undefined` if the value is not a well-formed time-encoded id.
+     */
+    parseTimestamp(idOrFriendlyId: string): Date | undefined;
+};
 export declare class IdGenerator {
     private alphabet;
     private length;