@trigger.dev/core 4.5.11 → 4.5.13

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

@@ -4,6 +4,8 @@ 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.)
+/** Every legal gen-2 shard char: the full DNS-safe lowercase range. */
+const SHARD_CHARS = "abcdefghijklmnopqrstuvwxyz0123456789".split("");
 (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]) {
@@ -25,10 +27,11 @@ const SAMPLES = 50_000; // property-scale; CI-fast. (Bump locally toward "millio
             (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", () => {
+    (0, vitest_1.it)("discriminates on the version char, not length: 26+'1' → NEW, 26+'2' → NEW (gen-2)", () => {
         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(24) + "e2")).toBe("NEW"); // gen-2: shard "e"
+        (0, vitest_1.expect)((0, runOpsResidency_js_1.ownerEngine)("a".repeat(24) + "e9")).toBe("LEGACY"); // unallocated version char
         (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)", () => {
@@ -55,4 +58,84 @@ const SAMPLES = 50_000; // property-scale; CI-fast. (Bump locally toward "millio
         (0, vitest_1.expect)((0, runOpsResidency_js_1.ownerEngine)(friendlyId_js_1.SnapshotId.generate().id)).toBe("LEGACY");
     });
 });
+(0, vitest_1.describe)("resolveShard — the gen-2 refinement inside the dedicated family", () => {
+    (0, vitest_1.it)("returns the shard char for every legal gen-2 shard key, friendly + internal", () => {
+        for (const c of SHARD_CHARS) {
+            const id = (0, friendlyId_js_1.generateRunOpsIdV2)(c);
+            (0, vitest_1.expect)((0, runOpsResidency_js_1.resolveShard)(id)).toBe(c);
+            (0, vitest_1.expect)((0, runOpsResidency_js_1.resolveShard)(friendlyId_js_1.RunId.toFriendlyId(id))).toBe(c);
+            (0, vitest_1.expect)((0, runOpsResidency_js_1.resolveShard)(friendlyId_js_1.WaitpointId.toFriendlyId(id))).toBe(c);
+            (0, vitest_1.expect)((0, runOpsResidency_js_1.resolveShard)(friendlyId_js_1.BatchId.toFriendlyId(id))).toBe(c);
+        }
+    });
+    (0, vitest_1.it)("returns 'new' for a gen-1 v1 body, friendly + internal", () => {
+        for (const region of [undefined, "us-east-1", "us-west-2", "eu-central-1"]) {
+            const id = (0, friendlyId_js_1.generateRunOpsId)(region);
+            (0, vitest_1.expect)((0, runOpsResidency_js_1.resolveShard)(id)).toBe("new");
+            (0, vitest_1.expect)((0, runOpsResidency_js_1.resolveShard)(friendlyId_js_1.RunId.toFriendlyId(id))).toBe("new");
+        }
+    });
+    (0, vitest_1.it)("returns 'legacy' for a cuid, a nanoid, a pre-cutover base62 id and malformed input", () => {
+        (0, vitest_1.expect)((0, runOpsResidency_js_1.resolveShard)(friendlyId_js_1.RunId.generate().id)).toBe("legacy"); // cuid, 25
+        (0, vitest_1.expect)((0, runOpsResidency_js_1.resolveShard)(friendlyId_js_1.RunId.generate().friendlyId)).toBe("legacy");
+        (0, vitest_1.expect)((0, runOpsResidency_js_1.resolveShard)("123456789abcdefghijkm")).toBe("legacy"); // nanoid, 21
+        (0, vitest_1.expect)((0, runOpsResidency_js_1.resolveShard)("b".repeat(27))).toBe("legacy"); // pre-cutover base62, 27
+        for (const bad of [
+            "",
+            "x".repeat(24) + "01", // 'x' outside base32hex
+            "x".repeat(24) + "02", // 'x' outside base32hex, gen-2 version
+            "A".repeat(25) + "1", // uppercase
+            "A".repeat(25) + "2", // uppercase, gen-2 version
+            "a".repeat(24) + "-1", // hyphen positional char
+            "a".repeat(24) + "-2", // hyphen positional char, gen-2 version
+            "a".repeat(26), // 26 chars, no version marker
+            "a".repeat(24) + "e9", // unallocated version char
+            "x".repeat(40),
+        ]) {
+            (0, vitest_1.expect)((0, runOpsResidency_js_1.resolveShard)(bad)).toBe("legacy");
+        }
+    });
+    (0, vitest_1.it)("never throws, for any input string", () => {
+        for (const input of ["", "x", "-".repeat(26), " ".repeat(26), "\u{1F642}".repeat(26)]) {
+            (0, vitest_1.expect)(() => (0, runOpsResidency_js_1.resolveShard)(input)).not.toThrow();
+        }
+    });
+    (0, vitest_1.it)("the reserved keys are multi-char, so no single-char shard key can collide", () => {
+        for (const reserved of ["legacy", "new"]) {
+            (0, vitest_1.expect)(reserved.length).toBeGreaterThan(1);
+            (0, vitest_1.expect)(SHARD_CHARS).not.toContain(reserved);
+        }
+    });
+});
+(0, vitest_1.describe)("gen-2 ids classify NEW — the dedicated family widens in meaning only", () => {
+    (0, vitest_1.it)("a gen-2 id is NEW / runOpsId 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.generateRunOpsIdV2)("a");
+            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.expect)((0, runOpsResidency_js_1.isClassifiable)(id)).toBe(true);
+        }
+    });
+    (0, vitest_1.it)("26+'2' is now a gen-2 shard route, not LEGACY (the one deliberate flip)", () => {
+        const genTwo = "a".repeat(24) + "e2";
+        (0, vitest_1.expect)((0, runOpsResidency_js_1.ownerEngine)(genTwo)).toBe("NEW");
+        (0, vitest_1.expect)((0, runOpsResidency_js_1.resolveShard)(genTwo)).toBe("e");
+    });
+    (0, vitest_1.it)("three-way disjointness: cuid, gen-1 v1 and gen-2 never cross-classify", () => {
+        for (let i = 0; i < SAMPLES; i++) {
+            const cuid = friendlyId_js_1.RunId.generate().id;
+            const v1 = (0, friendlyId_js_1.generateRunOpsId)();
+            const v2 = (0, friendlyId_js_1.generateRunOpsIdV2)(SHARD_CHARS[i % SHARD_CHARS.length]);
+            (0, vitest_1.expect)((0, runOpsResidency_js_1.ownerEngine)(cuid)).toBe("LEGACY");
+            (0, vitest_1.expect)((0, runOpsResidency_js_1.resolveShard)(cuid)).toBe("legacy");
+            (0, vitest_1.expect)((0, runOpsResidency_js_1.ownerEngine)(v1)).toBe("NEW");
+            (0, vitest_1.expect)((0, runOpsResidency_js_1.resolveShard)(v1)).toBe("new");
+            (0, vitest_1.expect)((0, runOpsResidency_js_1.ownerEngine)(v2)).toBe("NEW");
+            (0, vitest_1.expect)((0, runOpsResidency_js_1.resolveShard)(v2)).toBe(SHARD_CHARS[i % SHARD_CHARS.length]);
+        }
+    });
+});
 //# sourceMappingURL=runOpsResidency.test.js.map

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

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

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

@@ -0,0 +1,9 @@
+import { type ShardKey } from "./runOpsResidency.js";
+export declare function mintWaitpointIdForShard(key: ShardKey): {
+    id: string;
+    friendlyId: string;
+};
+export declare function mintWaitpointIdFor(anchorId: string | undefined): {
+    id: string;
+    friendlyId: string;
+};

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

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mintWaitpointIdForShard = mintWaitpointIdForShard;
+exports.mintWaitpointIdFor = mintWaitpointIdFor;
+const friendlyId_js_1 = require("./friendlyId.js");
+const runOpsResidency_js_1 = require("./runOpsResidency.js");
+// A Postgres waitpoint id, not the Redis store format (version "w"), which has no row to route.
+// The core is always fresh, or the body would equal the anchor's own id.
+function mintWaitpointIdForShard(key) {
+    if (key === "new" || key === "legacy") {
+        return friendlyId_js_1.WaitpointId.generate();
+    }
+    const id = (0, friendlyId_js_1.generateRunOpsIdV2)(key);
+    return { id, friendlyId: friendlyId_js_1.WaitpointId.toFriendlyId(id) };
+}
+// Every Postgres waitpoint mint goes through here: the router refuses an unstamped id on a shard.
+function mintWaitpointIdFor(anchorId) {
+    return anchorId === undefined
+        ? friendlyId_js_1.WaitpointId.generate()
+        : mintWaitpointIdForShard((0, runOpsResidency_js_1.resolveShard)(anchorId));
+}
+//# sourceMappingURL=waitpointMint.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"waitpointMint.js","sourceRoot":"","sources":["../../../../src/v3/isomorphic/waitpointMint.ts"],"names":[],"mappings":";;;;AAAA,mDAAkE;AAClE,6DAAmE;AAEnE,gGAAgG;AAChG,yEAAyE;AACzE,iCAAwC,GAAa;IACnD,IAAI,GAAG,KAAK,KAAK,IAAI,GAAG,KAAK,QAAQ,EAAE,CAAC;QACtC,OAAO,2BAAW,CAAC,QAAQ,EAAE,CAAC;IAChC,CAAC;IAED,MAAM,EAAE,GAAG,IAAA,kCAAkB,EAAC,GAAG,CAAC,CAAC;IACnC,OAAO,EAAE,EAAE,EAAE,UAAU,EAAE,2BAAW,CAAC,YAAY,CAAC,EAAE,CAAC,EAAE,CAAC;AAC1D,CAAC;AAED,kGAAkG;AAClG,4BAAmC,QAA4B;IAI7D,OAAO,QAAQ,KAAK,SAAS;QAC3B,CAAC,CAAC,2BAAW,CAAC,QAAQ,EAAE;QACxB,CAAC,CAAC,uBAAuB,CAAC,IAAA,iCAAY,EAAC,QAAQ,CAAC,CAAC,CAAC;AACtD,CAAC"}

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

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

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

@@ -0,0 +1,97 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const waitpointMint_js_1 = require("./waitpointMint.js");
+const friendlyId_js_1 = require("./friendlyId.js");
+const runOpsResidency_js_1 = require("./runOpsResidency.js");
+const GEN2_RUN = `run_${"a".repeat(24)}a2`; // shard "a", version "2"
+const GEN1_RUN = `run_${"a".repeat(24)}01`; // region "0", version "1"
+const CUID_RUN = `run_${"b".repeat(25)}`;
+(0, vitest_1.describe)("mintWaitpointIdForShard", () => {
+    (0, vitest_1.it)("a gen-2 shard key mints a gen-2 body with that char at index 24", () => {
+        const r = (0, waitpointMint_js_1.mintWaitpointIdForShard)("a");
+        (0, vitest_1.expect)(r.id.length).toBe(26);
+        (0, vitest_1.expect)(r.id[24]).toBe("a");
+        (0, vitest_1.expect)(r.id[25]).toBe("2");
+        (0, vitest_1.expect)(r.friendlyId).toBe(`waitpoint_${r.id}`);
+        (0, vitest_1.expect)((0, friendlyId_js_1.parseRunOpsIdV2Body)(r.id)?.shard).toBe("a");
+    });
+    (0, vitest_1.it)("the reserved key 'new' mints a cuid, unchanged from today", () => {
+        const r = (0, waitpointMint_js_1.mintWaitpointIdForShard)("new");
+        (0, vitest_1.expect)(r.id.length).toBe(25);
+        (0, vitest_1.expect)((0, runOpsResidency_js_1.resolveShard)(r.id)).toBe("legacy");
+    });
+    (0, vitest_1.it)("the reserved key 'legacy' mints a cuid", () => {
+        (0, vitest_1.expect)((0, waitpointMint_js_1.mintWaitpointIdForShard)("legacy").id.length).toBe(25);
+    });
+    (0, vitest_1.it)("two calls for one shard never collide", () => {
+        (0, vitest_1.expect)((0, waitpointMint_js_1.mintWaitpointIdForShard)("a").id).not.toBe((0, waitpointMint_js_1.mintWaitpointIdForShard)("a").id);
+    });
+    (0, vitest_1.it)("every gen-2 id it mints routes back to its own shard", () => {
+        for (const key of ["a", "b", "0", "z", "9"]) {
+            (0, vitest_1.expect)((0, friendlyId_js_1.isValidShardChar)(key)).toBe(true);
+            (0, vitest_1.expect)((0, runOpsResidency_js_1.resolveShard)((0, waitpointMint_js_1.mintWaitpointIdForShard)(key).id)).toBe(key);
+        }
+    });
+});
+(0, vitest_1.describe)("mintWaitpointIdFor", () => {
+    (0, vitest_1.it)("a gen-2 anchor stamps the anchor's shard char", () => {
+        const r = (0, waitpointMint_js_1.mintWaitpointIdFor)(GEN2_RUN);
+        (0, vitest_1.expect)(r.id[24]).toBe("a");
+        (0, vitest_1.expect)(r.id[25]).toBe("2");
+    });
+    (0, vitest_1.it)("a gen-2 anchor yields a FRESH core, never the anchor's own body", () => {
+        const r = (0, waitpointMint_js_1.mintWaitpointIdFor)(GEN2_RUN);
+        (0, vitest_1.expect)(r.id).not.toBe(GEN2_RUN.slice(4));
+        (0, vitest_1.expect)(r.id.slice(0, 24)).not.toBe("a".repeat(24));
+    });
+    (0, vitest_1.it)("accepts the bare internal form as well as the prefixed form", () => {
+        (0, vitest_1.expect)((0, waitpointMint_js_1.mintWaitpointIdFor)(GEN2_RUN.slice(4)).id[24]).toBe("a");
+    });
+    (0, vitest_1.it)("a gen-1 v1 anchor mints a cuid", () => {
+        (0, vitest_1.expect)((0, waitpointMint_js_1.mintWaitpointIdFor)(GEN1_RUN).id.length).toBe(25);
+    });
+    (0, vitest_1.it)("a cuid anchor mints a cuid", () => {
+        (0, vitest_1.expect)((0, waitpointMint_js_1.mintWaitpointIdFor)(CUID_RUN).id.length).toBe(25);
+    });
+    (0, vitest_1.it)("no anchor mints a cuid", () => {
+        (0, vitest_1.expect)((0, waitpointMint_js_1.mintWaitpointIdFor)(undefined).id.length).toBe(25);
+    });
+});
+(0, vitest_1.describe)("resolveShard shape checks match the decoding parsers", () => {
+    // Pins the shape/decode equivalence: a drift misroutes rather than erroring.
+    const classifyByDecode = (body) => {
+        const genTwo = (0, friendlyId_js_1.parseRunOpsIdV2Body)(body);
+        if (genTwo)
+            return genTwo.shard;
+        return (0, friendlyId_js_1.parseRunOpsIdBody)(body) !== undefined ? "new" : "legacy";
+    };
+    (0, vitest_1.it)("agrees on freshly minted gen-1 and gen-2 bodies", () => {
+        for (let i = 0; i < 500; i++) {
+            const one = (0, friendlyId_js_1.generateRunOpsId)();
+            const two = (0, friendlyId_js_1.generateRunOpsIdV2)("abcdefghijklmnopqrstuvwxyz0123456789"[i % 36]);
+            (0, vitest_1.expect)((0, runOpsResidency_js_1.resolveShard)(one)).toBe(classifyByDecode(one));
+            (0, vitest_1.expect)((0, runOpsResidency_js_1.resolveShard)(two)).toBe(classifyByDecode(two));
+        }
+    });
+    (0, vitest_1.it)("agrees on 26-char strings carrying out-of-alphabet characters", () => {
+        const alpha = "0123456789abcdefghijklmnopqrstuvwxyz-_.ZW!";
+        for (let i = 0; i < 2000; i++) {
+            let s = "";
+            for (let j = 0; j < 26; j++)
+                s += alpha[(i * 7 + j * 13) % alpha.length];
+            for (const body of [s, s.slice(0, 25) + "1", s.slice(0, 25) + "2"]) {
+                (0, vitest_1.expect)({ body, shape: (0, runOpsResidency_js_1.resolveShard)(body) }).toEqual({
+                    body,
+                    shape: classifyByDecode(body),
+                });
+            }
+        }
+    });
+    (0, vitest_1.it)("agrees on the shapes the plan pins as legacy", () => {
+        for (const body of ["", "a", "a".repeat(25), "a".repeat(27), `${"a".repeat(24)}e2`]) {
+            (0, vitest_1.expect)((0, runOpsResidency_js_1.resolveShard)(body)).toBe(classifyByDecode(body));
+        }
+    });
+});
+//# sourceMappingURL=waitpointMint.test.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"waitpointMint.test.js","sourceRoot":"","sources":["../../../../src/v3/isomorphic/waitpointMint.test.ts"],"names":[],"mappings":";;AAAA,mCAA8C;AAC9C,yDAAiF;AACjF,mDAMyB;AACzB,6DAAoD;AAEpD,MAAM,QAAQ,GAAG,OAAO,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,yBAAyB;AACrE,MAAM,QAAQ,GAAG,OAAO,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,0BAA0B;AACtE,MAAM,QAAQ,GAAG,OAAO,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC;AAEzC,IAAA,iBAAQ,EAAC,yBAAyB,EAAE,GAAG,EAAE;IACvC,IAAA,WAAE,EAAC,iEAAiE,EAAE,GAAG,EAAE;QACzE,MAAM,CAAC,GAAG,IAAA,0CAAuB,EAAC,GAAG,CAAC,CAAC;QACvC,IAAA,eAAM,EAAC,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC7B,IAAA,eAAM,EAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC3B,IAAA,eAAM,EAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC3B,IAAA,eAAM,EAAC,CAAC,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAC/C,IAAA,eAAM,EAAC,IAAA,mCAAmB,EAAC,CAAC,CAAC,EAAE,CAAC,EAAE,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACrD,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,2DAA2D,EAAE,GAAG,EAAE;QACnE,MAAM,CAAC,GAAG,IAAA,0CAAuB,EAAC,KAAK,CAAC,CAAC;QACzC,IAAA,eAAM,EAAC,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC7B,IAAA,eAAM,EAAC,IAAA,iCAAY,EAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC5C,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,wCAAwC,EAAE,GAAG,EAAE;QAChD,IAAA,eAAM,EAAC,IAAA,0CAAuB,EAAC,QAAQ,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC/D,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,uCAAuC,EAAE,GAAG,EAAE;QAC/C,IAAA,eAAM,EAAC,IAAA,0CAAuB,EAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,IAAA,0CAAuB,EAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC;IACpF,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,sDAAsD,EAAE,GAAG,EAAE;QAC9D,KAAK,MAAM,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,EAAE,CAAC;YAC5C,IAAA,eAAM,EAAC,IAAA,gCAAgB,EAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACzC,IAAA,eAAM,EAAC,IAAA,iCAAY,EAAC,IAAA,0CAAuB,EAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAClE,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,IAAA,iBAAQ,EAAC,oBAAoB,EAAE,GAAG,EAAE;IAClC,IAAA,WAAE,EAAC,+CAA+C,EAAE,GAAG,EAAE;QACvD,MAAM,CAAC,GAAG,IAAA,qCAAkB,EAAC,QAAQ,CAAC,CAAC;QACvC,IAAA,eAAM,EAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC3B,IAAA,eAAM,EAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC7B,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,iEAAiE,EAAE,GAAG,EAAE;QACzE,MAAM,CAAC,GAAG,IAAA,qCAAkB,EAAC,QAAQ,CAAC,CAAC;QACvC,IAAA,eAAM,EAAC,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QACzC,IAAA,eAAM,EAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;IACrD,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,6DAA6D,EAAE,GAAG,EAAE;QACrE,IAAA,eAAM,EAAC,IAAA,qCAAkB,EAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACjE,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,gCAAgC,EAAE,GAAG,EAAE;QACxC,IAAA,eAAM,EAAC,IAAA,qCAAkB,EAAC,QAAQ,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC1D,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,4BAA4B,EAAE,GAAG,EAAE;QACpC,IAAA,eAAM,EAAC,IAAA,qCAAkB,EAAC,QAAQ,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC1D,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,wBAAwB,EAAE,GAAG,EAAE;QAChC,IAAA,eAAM,EAAC,IAAA,qCAAkB,EAAC,SAAS,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC3D,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,IAAA,iBAAQ,EAAC,sDAAsD,EAAE,GAAG,EAAE;IACpE,6EAA6E;IAC7E,MAAM,gBAAgB,GAAG,CAAC,IAAY,EAAU,EAAE;QAChD,MAAM,MAAM,GAAG,IAAA,mCAAmB,EAAC,IAAI,CAAC,CAAC;QACzC,IAAI,MAAM;YAAE,OAAO,MAAM,CAAC,KAAK,CAAC;QAChC,OAAO,IAAA,iCAAiB,EAAC,IAAI,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC;IAClE,CAAC,CAAC;IAEF,IAAA,WAAE,EAAC,iDAAiD,EAAE,GAAG,EAAE;QACzD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;YAC7B,MAAM,GAAG,GAAG,IAAA,gCAAgB,GAAE,CAAC;YAC/B,MAAM,GAAG,GAAG,IAAA,kCAAkB,EAAC,sCAAsC,CAAC,CAAC,GAAG,EAAE,CAAE,CAAC,CAAC;YAChF,IAAA,eAAM,EAAC,IAAA,iCAAY,EAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC,CAAC;YACtD,IAAA,eAAM,EAAC,IAAA,iCAAY,EAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC,CAAC;QACxD,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,+DAA+D,EAAE,GAAG,EAAE;QACvE,MAAM,KAAK,GAAG,4CAA4C,CAAC;QAC3D,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC;YAC9B,IAAI,CAAC,GAAG,EAAE,CAAC;YACX,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,EAAE;gBAAE,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC;YACzE,KAAK,MAAM,IAAI,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,EAAE,CAAC;gBACnE,IAAA,eAAM,EAAC,EAAE,IAAI,EAAE,KAAK,EAAE,IAAA,iCAAY,EAAC,IAAI,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC;oBAClD,IAAI;oBACJ,KAAK,EAAE,gBAAgB,CAAC,IAAI,CAAC;iBAC9B,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,8CAA8C,EAAE,GAAG,EAAE;QACtD,KAAK,MAAM,IAAI,IAAI,CAAC,EAAE,EAAE,GAAG,EAAE,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,GAAG,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;YACpF,IAAA,eAAM,EAAC,IAAA,iCAAY,EAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC;QAC1D,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/commonjs/v3/lifecycleHooks/types.d.ts

@@ -18,7 +18,7 @@ export type TaskStartHookParams<TPayload = unknown, TInitOutput extends TaskInit
 };
 export type OnStartHookFunction<TPayload, TInitOutput extends TaskInitOutput = TaskInitOutput> = (params: TaskStartHookParams<TPayload, TInitOutput>) => undefined | void | Promise<undefined | void>;
 export type AnyOnStartHookFunction = OnStartHookFunction<unknown, TaskInitOutput>;
-export type TaskStartAttemptHookParams<TPayload = unknown> = {
+type TaskStartAttemptHookParams<TPayload = unknown> = {
     ctx: TaskRunContext;
     payload: TPayload;
     task: string;
@@ -80,11 +80,11 @@ export type TaskSuccessHookParams<TPayload = unknown, TOutput = unknown, TInitOu
 };
 export type OnSuccessHookFunction<TPayload, TOutput, TInitOutput extends TaskInitOutput = TaskInitOutput> = (params: TaskSuccessHookParams<TPayload, TOutput, TInitOutput>) => undefined | void | Promise<undefined | void>;
 export type AnyOnSuccessHookFunction = OnSuccessHookFunction<unknown, unknown, TaskInitOutput>;
-export type TaskCompleteSuccessResult<TOutput> = {
+type TaskCompleteSuccessResult<TOutput> = {
     ok: true;
     data: TOutput;
 };
-export type TaskCompleteErrorResult = {
+type TaskCompleteErrorResult = {
     ok: false;
     error: unknown;
 };
@@ -205,3 +205,4 @@ export interface LifecycleHooksManager {
     registerOnCancelHookListener(listener: () => Promise<void>): void;
     callOnCancelHookListeners(): Promise<void>;
 }
+export {};

package/dist/commonjs/v3/locals/manager.js

@@ -4,7 +4,7 @@ exports.StandardLocalsManager = exports.NoopLocalsManager = void 0;
 class NoopLocalsManager {
     createLocal(id) {
         return {
-            __type: Symbol(),
+            __type: Symbol(id),
             id,
         };
     }

package/dist/commonjs/v3/locals/manager.js.map

@@ -1 +1 @@
-{"version":3,"file":"manager.js","sourceRoot":"","sources":["../../../../src/v3/locals/manager.ts"],"names":[],"mappings":";;;AAEA;IACE,WAAW,CAAI,EAAU;QACvB,OAAO;YACL,MAAM,EAAE,MAAM,EAAE;YAChB,EAAE;SACH,CAAC;IACJ,CAAC;IAED,QAAQ,CAAI,GAAiB;QAC3B,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,QAAQ,CAAI,GAAiB,EAAE,KAAQ,IAAS,CAAC;CAClD;;AAED;IACU,KAAK,GAAyB,IAAI,GAAG,EAAE,CAAC;IAEhD,WAAW,CAAI,EAAU;QACvB,MAAM,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC3B,OAAO;YACL,MAAM,EAAE,GAAG;YACX,EAAE;SACH,CAAC;IACJ,CAAC;IAED,QAAQ,CAAI,GAAiB;QAC3B,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAkB,CAAC;IACrD,CAAC;IAED,QAAQ,CAAI,GAAiB,EAAE,KAAQ;QACrC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IACpC,CAAC;IAED,KAAK;QACH,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;CACF"}
+{"version":3,"file":"manager.js","sourceRoot":"","sources":["../../../../src/v3/locals/manager.ts"],"names":[],"mappings":";;;AAEA;IACE,WAAW,CAAI,EAAU;QACvB,OAAO;YACL,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC;YAClB,EAAE;SACH,CAAC;IACJ,CAAC;IAED,QAAQ,CAAI,GAAiB;QAC3B,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,QAAQ,CAAI,GAAiB,EAAE,KAAQ,IAAS,CAAC;CAClD;;AAED;IACU,KAAK,GAAyB,IAAI,GAAG,EAAE,CAAC;IAEhD,WAAW,CAAI,EAAU;QACvB,MAAM,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC3B,OAAO;YACL,MAAM,EAAE,GAAG;YACX,EAAE;SACH,CAAC;IACJ,CAAC;IAED,QAAQ,CAAI,GAAiB;QAC3B,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAkB,CAAC;IACrD,CAAC;IAED,QAAQ,CAAI,GAAiB,EAAE,KAAQ;QACrC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IACpC,CAAC;IAED,KAAK;QACH,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;CACF"}

package/dist/commonjs/v3/logger/taskLogger.d.ts

@@ -4,7 +4,7 @@ import type { TriggerTracer } from "../tracer.js";
 import type { Prettify } from "../types/utils.js";
 export type LogLevel = "none" | "error" | "warn" | "info" | "debug" | "log";
 export declare const logLevels: Array<LogLevel>;
-export type TaskLoggerConfig = {
+type TaskLoggerConfig = {
     logger: Logger;
     tracer: TriggerTracer;
     level: LogLevel;
@@ -44,3 +44,4 @@ export declare class NoopTaskLogger implements TaskLogger {
     trace<T>(name: string, fn: (span: Span) => Promise<T>): Promise<T>;
     startSpan(): Span;
 }
+export {};

package/dist/commonjs/v3/otel/tracingSDK.d.ts

@@ -1,9 +1,10 @@
 import type { TracerProvider } from "@opentelemetry/api";
 import { type Instrumentation } from "@opentelemetry/instrumentation";
 import type { Resource } from "@opentelemetry/resources";
-import type { LogRecordExporter } from "@opentelemetry/sdk-logs";
+import type { LogRecordExporter, ReadableLogRecord } from "@opentelemetry/sdk-logs";
 import { LoggerProvider } from "@opentelemetry/sdk-logs";
 import { type MetricReader, type PushMetricExporter } from "@opentelemetry/sdk-metrics";
+import { RandomIdGenerator } from "@opentelemetry/sdk-trace-base";
 import type { SpanExporter } from "@opentelemetry/sdk-trace-node";
 export type TracingDiagnosticLogLevel = "none" | "error" | "warn" | "info" | "debug" | "verbose" | "all";
 export type TracingSDKConfig = {
@@ -35,19 +36,62 @@ export declare class TracingSDK {
     private readonly _spanExporter;
     private readonly _traceProvider;
     private readonly _meterProvider;
+    private readonly _metricReaders;
     readonly getLogger: LoggerProvider["getLogger"];
     readonly getTracer: TracerProvider["getTracer"];
     constructor(config: TracingSDKConfig);
     flush(): Promise<void>;
+    private _flushMetricReadersSerially;
+    private _shutdownMetricReadersSerially;
+    private _eachMetricReaderSerially;
     shutdown(): Promise<void>;
 }
+/** Only the current run and the tail of recently ended ones can still export. */
+export declare const MAX_TRACKED_INTERNAL_TRACES = 64;
+/**
+ * External trace ids for runs that carry no external trace context — with
+ * `processKeepAlive` the `TracingSDK` outlives the run, so an id captured at
+ * construction merges every run on the process into one trace.
+ *
+ * A record's id comes from its own internal trace id rather than from whatever
+ * run is current when the exporter is called. Batch processors drain
+ * asynchronously, so a run's records are routinely exported after the next run
+ * has started, and reading ambient state then would stamp them with the wrong
+ * run's id. It also makes a run's spans and logs agree without coordinating.
+ *
+ * Granularity therefore follows the internal trace, not the run: a run tree
+ * shares one internal trace, so a parent and the runs it triggers land on one
+ * external trace together, which is the grouping you want.
+ */
+export declare class FallbackExternalTraceIds {
+    private seed;
+    private traceIdGenerator;
+    private readonly byInternalTrace;
+    constructor(seed: string, traceIdGenerator?: Pick<RandomIdGenerator, "generateTraceId">);
+    /** False when no external trace id was configured, i.e. external export is off. */
+    get enabled(): boolean;
+    forInternalTrace(internalTraceId: string): string;
+}
 export declare class ExternalSpanExporterWrapper {
     private underlyingExporter;
-    private externalTraceId;
-    constructor(underlyingExporter: SpanExporter, externalTraceId: string);
+    private fallback;
+    constructor(underlyingExporter: SpanExporter, fallback: FallbackExternalTraceIds);
     private transformSpan;
     export(spans: any[], resultCallback: (result: any) => void): void;
     shutdown(): Promise<void>;
     forceFlush?(): Promise<void>;
 }
-export declare function parseOtelResourceAttributes(rawEnvAttributes: string | undefined | null): Record<string, string>;
+export declare class ExternalLogRecordExporterWrapper {
+    private underlyingExporter;
+    private fallback;
+    constructor(underlyingExporter: LogRecordExporter, fallback: FallbackExternalTraceIds);
+    export(logs: any[], resultCallback: (result: any) => void): void;
+    shutdown(): Promise<void>;
+    forceFlush(): Promise<void>;
+    transformLogRecord(logRecord: ReadableLogRecord, externalTraceContext: {
+        traceId: string;
+        spanId: string;
+        tracestate?: string;
+        traceFlags: number;
+    } | undefined): ReadableLogRecord;
+}