@trigger.dev/core 0.0.0-prerelease-20260508090504 → 0.0.0-prerelease-20260810145618

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

@@ -0,0 +1,170 @@
+import { afterEach, describe, expect, it, vi } from "vitest";
+import { RunId, WaitpointId, SnapshotId, QueueId, RUN_OPS_ID_LENGTH, RUN_OPS_ID_REGION_INDEX, RUN_OPS_ID_VERSION, RUN_OPS_ID_VERSION_INDEX, base32hexDecode, base32hexEncode, generateRunOpsId, parseRunId, } from "./friendlyId.js";
+const CUID_LEN = 25;
+describe("RunId + WaitpointId mint cuid by default; run-ops v1 via generateRunOpsId", () => {
+    it("default: run + waitpoint mint cuid (25) and round-trip", () => {
+        for (const util of [RunId, WaitpointId]) {
+            const { id, friendlyId } = util.generate();
+            expect(id.length).toBe(CUID_LEN);
+            expect(util.fromFriendlyId(friendlyId)).toBe(id);
+            expect(util.toId(friendlyId)).toBe(id);
+            expect(util.toId(id)).toBe(id);
+            expect(util.toFriendlyId(id)).toBe(friendlyId);
+        }
+    });
+    it("explicit run-ops id: a run/waitpoint friendlyId over generateRunOpsId() is 26-char and round-trips", () => {
+        for (const util of [RunId, WaitpointId]) {
+            const id = generateRunOpsId();
+            const friendlyId = util.toFriendlyId(id);
+            expect(id.length).toBe(RUN_OPS_ID_LENGTH);
+            expect(util.fromFriendlyId(friendlyId)).toBe(id);
+            expect(util.toId(friendlyId)).toBe(id);
+            expect(util.toId(id)).toBe(id);
+        }
+    });
+    it("SnapshotId + QueueId stay cuid (25)", () => {
+        expect(SnapshotId.generate().id.length).toBe(CUID_LEN);
+        expect(QueueId.generate().id.length).toBe(CUID_LEN);
+    });
+});
+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;
+    }
+    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 = base32hexEncode(bytes);
+                expect(encoded).toBe(referenceEncode(bytes));
+                expect(Array.from(base32hexDecode(encoded))).toEqual(Array.from(bytes));
+            }
+        }
+    });
+    it("hand-verified vectors", () => {
+        expect(base32hexEncode(new Uint8Array(5))).toBe("00000000");
+        expect(base32hexEncode(new Uint8Array(5).fill(0xff))).toBe("vvvvvvvv");
+        expect(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"
+        expect(base32hexEncode(new Uint8Array([0x20, 0, 0, 0, 0]))).toBe("40000000");
+    });
+    it("decode rejects characters outside the lowercase base32hex alphabet", () => {
+        for (const bad of ["w", "x", "z", "A", "V", "-", "_", " "]) {
+            expect(() => base32hexDecode(`0000000${bad}`)).toThrow(/invalid/i);
+        }
+    });
+});
+describe("generateRunOpsId — run-ops v1 id spec", () => {
+    afterEach(() => vi.useRealTimers());
+    it("emits <24-char base32hex core><region char><version '1'> — 26 chars total", () => {
+        const id = generateRunOpsId();
+        expect(id.length).toBe(RUN_OPS_ID_LENGTH);
+        expect(id).toMatch(/^[0-9a-v]{24}[a-z0-9]1$/);
+        expect(id[RUN_OPS_ID_VERSION_INDEX]).toBe(RUN_OPS_ID_VERSION);
+    });
+    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 = generateRunOpsId();
+            expect(id).toMatch(/^[a-z0-9]+$/);
+            expect(id).not.toContain("-");
+        }
+    });
+    it("stamps the region char from REGION_CODES, defaulting to '0' when unknown/absent", () => {
+        expect(generateRunOpsId("us-east-1")[RUN_OPS_ID_REGION_INDEX]).toBe("e");
+        expect(generateRunOpsId("us-west-2")[RUN_OPS_ID_REGION_INDEX]).toBe("w");
+        expect(generateRunOpsId("eu-central-1")[RUN_OPS_ID_REGION_INDEX]).toBe("c");
+        expect(generateRunOpsId("mars-north-1")[RUN_OPS_ID_REGION_INDEX]).toBe("0");
+        expect(generateRunOpsId()[RUN_OPS_ID_REGION_INDEX]).toBe("0");
+    });
+    it("sorts lexicographically in creation order at ms resolution (A@t, C@t+3ms, B@t+1s → A,C,B)", () => {
+        vi.useFakeTimers();
+        const t = new Date("2026-07-04T12:00:00.000Z").getTime();
+        vi.setSystemTime(t);
+        const a = generateRunOpsId();
+        vi.setSystemTime(t + 1000);
+        const b = generateRunOpsId();
+        vi.setSystemTime(t + 3);
+        const c = generateRunOpsId();
+        expect([b, c, a].sort()).toEqual([a, c, b]);
+    });
+    it("decode recovers the exact ms timestamp", () => {
+        vi.useFakeTimers();
+        const t = new Date("2026-07-04T12:34:56.789Z");
+        vi.setSystemTime(t);
+        const parsed = parseRunId(`run_${generateRunOpsId("us-east-1")}`);
+        expect(parsed.format).toBe("b32hex");
+        if (parsed.format === "b32hex") {
+            expect(parsed.timestamp.getTime()).toBe(t.getTime());
+        }
+    });
+    it("is unique across many mints in the same ms (72 bits of CSPRNG)", () => {
+        vi.useFakeTimers();
+        vi.setSystemTime(new Date("2026-07-04T00:00:00.000Z"));
+        const n = 2_000;
+        expect(new Set(Array.from({ length: n }, () => generateRunOpsId())).size).toBe(n);
+    });
+});
+describe("parseRunId — version-char discrimination (not length)", () => {
+    it("parses a v1 friendly id as partitioned with region + version", () => {
+        const parsed = parseRunId(`run_${generateRunOpsId("us-west-2")}`);
+        expect(parsed).toMatchObject({
+            format: "b32hex",
+            table: "partitioned",
+            region: "w",
+            version: "1",
+        });
+    });
+    it("classifies a cuid friendly id legacy", () => {
+        expect(parseRunId(RunId.generate().friendlyId)).toEqual({
+            format: "legacy",
+            table: "legacy",
+        });
+    });
+    it("classifies a nanoid-bodied friendly id and a run_-less id legacy", () => {
+        expect(parseRunId("run_123456789abcdefghijkm").format).toBe("legacy"); // 21-char nanoid body
+        expect(parseRunId(generateRunOpsId()).format).toBe("legacy"); // bare body, no run_ prefix
+        expect(parseRunId("waitpoint_" + generateRunOpsId()).format).toBe("legacy"); // wrong prefix
+    });
+    it("falls back to legacy on a malformed v1 (bad alphabet / wrong version char)", () => {
+        expect(parseRunId(`run_${"A".repeat(25)}1`).format).toBe("legacy"); // uppercase core
+        expect(parseRunId(`run_${"a".repeat(25)}2`).format).toBe("legacy"); // wrong version
+        expect(parseRunId(`run_${"a".repeat(24)}-1`).format).toBe("legacy"); // region char not [a-z0-9]
+        expect(parseRunId(`run_${"a".repeat(27)}`).format).toBe("legacy"); // old 27-char shape
+    });
+});
+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)}`;
+    }
+    it("recovers the exact id (incl. region + version chars) from first-attempt and retry pods", () => {
+        const id = generateRunOpsId("us-east-1");
+        expect(firekeeperRunIdFromPodName(`runner-${id}`)).toBe(`run_${id}`);
+        expect(firekeeperRunIdFromPodName(`runner-${id}-attempt-2`)).toBe(`run_${id}`);
+        expect(parseRunId(firekeeperRunIdFromPodName(`runner-${id}-attempt-2`)).format).toBe("b32hex");
+    });
+    it("the recovered id is a valid DNS-1123 label body (k8s accepts runner-<id>)", () => {
+        const podName = `runner-${generateRunOpsId("eu-central-1")}`;
+        expect(podName).toMatch(/^[a-z]([a-z0-9-]{0,61}[a-z0-9])?$/);
+        expect(podName.length).toBeLessThanOrEqual(63);
+    });
+});
+//# sourceMappingURL=friendlyId.test.js.map

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

package/dist/esm/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/esm/v3/isomorphic/index.js

@@ -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/esm/v3/isomorphic/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/v3/isomorphic/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC;AAClC,cAAc,YAAY,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/v3/isomorphic/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,sBAAsB,CAAC;AACrC,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC;AAClC,cAAc,YAAY,CAAC"}

package/dist/esm/v3/isomorphic/queueName.js

@@ -1,5 +1,5 @@
 // Only allow alphanumeric characters, underscores, hyphens, and slashes (and only the first 128 characters)
 export function sanitizeQueueName(queueName) {
-    return queueName.replace(/[^a-zA-Z0-9_\-\/]/g, "").substring(0, 128);
+    return queueName.replace(/[^a-zA-Z0-9_\-/]/g, "").substring(0, 128);
 }
 //# sourceMappingURL=queueName.js.map

package/dist/esm/v3/isomorphic/queueName.js.map

@@ -1 +1 @@
-{"version":3,"file":"queueName.js","sourceRoot":"","sources":["../../../../src/v3/isomorphic/queueName.ts"],"names":[],"mappings":"AAAA,4GAA4G;AAC5G,MAAM,UAAU,iBAAiB,CAAC,SAAiB;IACjD,OAAO,SAAS,CAAC,OAAO,CAAC,oBAAoB,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;AACvE,CAAC"}
+{"version":3,"file":"queueName.js","sourceRoot":"","sources":["../../../../src/v3/isomorphic/queueName.ts"],"names":[],"mappings":"AAAA,4GAA4G;AAC5G,MAAM,UAAU,iBAAiB,CAAC,SAAiB;IACjD,OAAO,SAAS,CAAC,OAAO,CAAC,mBAAmB,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;AACtE,CAAC"}

package/dist/esm/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/esm/v3/isomorphic/runOpsResidency.js

@@ -0,0 +1,50 @@
+import { isRunOpsIdBody } from "./friendlyId.js";
+/** @bugsnag/cuid emits 25-char ids (legacy mint path, flag OFF). */
+export 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 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;
+    }
+}
+/**
+ * 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.
+ */
+export function classifyKind(id) {
+    return isRunOpsIdBody(internalForm(id)) ? "runOpsId" : "cuid";
+}
+/** Classification is total now; kept for API compatibility. */
+export function isClassifiable(_id) {
+    return true;
+}
+/** Map an id to its owning run-ops store by the version-char rule. */
+export function classifyResidency(id) {
+    return classifyKind(id) === "runOpsId" ? "NEW" : "LEGACY";
+}
+/** Primary public name (RoutingRunStore / cross-seam guard). */
+export const ownerEngine = classifyResidency;
+//# sourceMappingURL=runOpsResidency.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"runOpsResidency.js","sourceRoot":"","sources":["../../../../src/v3/isomorphic/runOpsResidency.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAajD,oEAAoE;AACpE,MAAM,CAAC,MAAM,WAAW,GAAG,EAAE,CAAC;AAE9B;;;;GAIG;AACH,MAAM,OAAO,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;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,MAAM,UAAU,YAAY,CAAC,EAAU;IACrC,OAAO,cAAc,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC;AAChE,CAAC;AAED,+DAA+D;AAC/D,MAAM,UAAU,cAAc,CAAC,GAAW;IACxC,OAAO,IAAI,CAAC;AACd,CAAC;AAED,sEAAsE;AACtE,MAAM,UAAU,iBAAiB,CAAC,EAAU;IAC1C,OAAO,YAAY,CAAC,EAAE,CAAC,KAAK,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC;AAC5D,CAAC;AAED,gEAAgE;AAChE,MAAM,CAAC,MAAM,WAAW,GAAG,iBAAiB,CAAC"}

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

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

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

@@ -0,0 +1,56 @@
+import { describe, expect, it } from "vitest";
+import { RunId, WaitpointId, BatchId, SnapshotId, generateRunOpsId } from "./friendlyId.js";
+import { ownerEngine, classifyResidency, classifyKind, isClassifiable } from "./runOpsResidency.js";
+const SAMPLES = 50_000; // property-scale; CI-fast. (Bump locally toward "millions" for deeper coverage.)
+describe("ownerEngine — residency classifier (version char at fixed position, not length)", () => {
+    it("cuid ids (default mint) classify LEGACY, friendly + internal", () => {
+        for (const util of [RunId, WaitpointId]) {
+            const { id, friendlyId } = util.generate();
+            expect(ownerEngine(id)).toBe("LEGACY");
+            expect(ownerEngine(friendlyId)).toBe("LEGACY"); // strips run_/waitpoint_ prefix
+            expect(classifyResidency(id)).toBe("LEGACY"); // alias agrees
+            expect(classifyKind(id)).toBe("cuid");
+            expect(isClassifiable(id)).toBe(true);
+        }
+    });
+    it("run-ops v1 ids (generateRunOpsId) classify NEW, friendly + internal, across id-shape co-located entities", () => {
+        for (const util of [RunId, WaitpointId, BatchId]) {
+            const id = generateRunOpsId("us-east-1");
+            const friendlyId = util.toFriendlyId(id);
+            expect(ownerEngine(id)).toBe("NEW");
+            expect(ownerEngine(friendlyId)).toBe("NEW");
+            expect(classifyResidency(id)).toBe("NEW");
+            expect(classifyKind(id)).toBe("runOpsId");
+        }
+    });
+    it("discriminates on the version char, not length: 26+'1' → NEW, 26+'2' → LEGACY", () => {
+        const v1 = "a".repeat(24) + "e1";
+        expect(ownerEngine(v1)).toBe("NEW");
+        expect(ownerEngine("a".repeat(24) + "e2")).toBe("LEGACY");
+        expect(ownerEngine("a".repeat(26))).toBe("LEGACY"); // 26 chars but no version marker
+    });
+    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),
+        ]) {
+            expect(ownerEngine(bad)).toBe("LEGACY");
+            expect(isClassifiable(bad)).toBe(true); // classification is total now
+        }
+    });
+    it("disjointness: no cuid sample is ever NEW, no v1 sample is ever LEGACY", () => {
+        for (let i = 0; i < SAMPLES; i++) {
+            expect(ownerEngine(RunId.generate().id)).toBe("LEGACY");
+            expect(ownerEngine(generateRunOpsId())).toBe("NEW");
+        }
+    });
+    it("SnapshotId (always cuid) classifies LEGACY — proves snapshot needs no residency key", () => {
+        expect(ownerEngine(SnapshotId.generate().id)).toBe("LEGACY");
+    });
+});
+//# sourceMappingURL=runOpsResidency.test.js.map

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

package/dist/esm/v3/jwt.d.ts

@@ -3,10 +3,13 @@ export type GenerateJWTOptions = {
     secretKey: string;
     payload: Record<string, any>;
     expirationTime?: number | Date | string;
+    omitIssuedAt?: boolean;
 };
 export declare const JWT_ALGORITHM = "HS256";
 export declare const JWT_ISSUER = "https://id.trigger.dev";
 export declare const JWT_AUDIENCE = "https://api.trigger.dev";
+export declare function isPublicJWT(token: string): boolean;
+export declare function extractJWTSub(token: string): string | undefined;
 export declare function generateJWT(options: GenerateJWTOptions): Promise<string>;
 export type ValidationResult = {
     ok: true;

package/dist/esm/v3/jwt.js

@@ -1,16 +1,48 @@
 export const JWT_ALGORITHM = "HS256";
 export const JWT_ISSUER = "https://id.trigger.dev";
 export const JWT_AUDIENCE = "https://api.trigger.dev";
+function decodeJWTPayload(token) {
+    const parts = token.split(".");
+    const encodedPayload = parts[1];
+    if (parts.length !== 3 || !encodedPayload)
+        return;
+    try {
+        const base64 = encodedPayload
+            .replace(/-/g, "+")
+            .replace(/_/g, "/")
+            .padEnd(Math.ceil(encodedPayload.length / 4) * 4, "=");
+        const bytes = Uint8Array.from(atob(base64), (character) => character.charCodeAt(0));
+        return JSON.parse(new TextDecoder().decode(bytes));
+    }
+    catch {
+        return;
+    }
+}
+export function isPublicJWT(token) {
+    const payload = decodeJWTPayload(token);
+    return (payload !== null && typeof payload === "object" && "pub" in payload && payload.pub === true);
+}
+export function extractJWTSub(token) {
+    const payload = decodeJWTPayload(token);
+    return payload !== null &&
+        typeof payload === "object" &&
+        "sub" in payload &&
+        typeof payload.sub === "string"
+        ? payload.sub
+        : undefined;
+}
 export async function generateJWT(options) {
     const { SignJWT } = await import("jose");
     const secret = new TextEncoder().encode(options.secretKey);
-    return new SignJWT(options.payload)
+    const jwt = new SignJWT(options.payload)
         .setIssuer(JWT_ISSUER)
         .setAudience(JWT_AUDIENCE)
         .setProtectedHeader({ alg: JWT_ALGORITHM })
-        .setIssuedAt()
-        .setExpirationTime(options.expirationTime ?? "15m")
-        .sign(secret);
+        .setExpirationTime(options.expirationTime ?? "15m");
+    if (!options.omitIssuedAt) {
+        jwt.setIssuedAt();
+    }
+    return jwt.sign(secret);
 }
 export async function validateJWT(token, apiKey) {
     const { jwtVerify, errors } = await import("jose");

package/dist/esm/v3/jwt.js.map

@@ -1 +1 @@
-{"version":3,"file":"jwt.js","sourceRoot":"","sources":["../../../src/v3/jwt.ts"],"names":[],"mappings":"AAQA,MAAM,CAAC,MAAM,aAAa,GAAG,OAAO,CAAC;AACrC,MAAM,CAAC,MAAM,UAAU,GAAG,wBAAwB,CAAC;AACnD,MAAM,CAAC,MAAM,YAAY,GAAG,yBAAyB,CAAC;AAEtD,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,OAA2B;IAC3D,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,CAAC;IAEzC,MAAM,MAAM,GAAG,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAE3D,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC;SAChC,SAAS,CAAC,UAAU,CAAC;SACrB,WAAW,CAAC,YAAY,CAAC;SACzB,kBAAkB,CAAC,EAAE,GAAG,EAAE,aAAa,EAAE,CAAC;SAC1C,WAAW,EAAE;SACb,iBAAiB,CAAC,OAAO,CAAC,cAAc,IAAI,KAAK,CAAC;SAClD,IAAI,CAAC,MAAM,CAAC,CAAC;AAClB,CAAC;AAaD,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,KAAa,EAAE,MAAc;IAC7D,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,CAAC;IAEnD,MAAM,MAAM,GAAG,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAEhD,IAAI,CAAC;QACH,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE;YACjD,MAAM,EAAE,UAAU;YAClB,QAAQ,EAAE,YAAY;SACvB,CAAC,CAAC;QAEH,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;IAC/B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,MAAM,CAAC,SAAS,EAAE,CAAC;YACtC,OAAO;gBACL,EAAE,EAAE,KAAK;gBACT,KAAK,EAAE,KAAK,CAAC,OAAO;gBACpB,IAAI,EAAE,KAAK,CAAC,IAAI;aACjB,CAAC;QACJ,CAAC;aAAM,CAAC;YACN,OAAO;gBACL,EAAE,EAAE,KAAK;gBACT,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe;gBAC/D,IAAI,EAAE,aAAa;aACpB,CAAC;QACJ,CAAC;IACH,CAAC;AACH,CAAC"}
+{"version":3,"file":"jwt.js","sourceRoot":"","sources":["../../../src/v3/jwt.ts"],"names":[],"mappings":"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"}

package/dist/esm/v3/lifecycleHooks/index.d.ts

@@ -1,4 +1,4 @@
-import { AnyOnCatchErrorHookFunction, AnyOnCleanupHookFunction, AnyOnCompleteHookFunction, AnyOnFailureHookFunction, AnyOnInitHookFunction, AnyOnMiddlewareHookFunction, AnyOnResumeHookFunction, AnyOnStartHookFunction, AnyOnSuccessHookFunction, AnyOnWaitHookFunction, AnyOnCancelHookFunction, RegisteredHookFunction, RegisterHookFunctionParams, TaskWait, type LifecycleHooksManager, AnyOnStartAttemptHookFunction } from "./types.js";
+import { type AnyOnCatchErrorHookFunction, type AnyOnCleanupHookFunction, type AnyOnCompleteHookFunction, type AnyOnFailureHookFunction, type AnyOnInitHookFunction, type AnyOnMiddlewareHookFunction, type AnyOnResumeHookFunction, type AnyOnStartHookFunction, type AnyOnSuccessHookFunction, type AnyOnWaitHookFunction, type AnyOnCancelHookFunction, type RegisteredHookFunction, type RegisterHookFunctionParams, type TaskWait, type AnyOnStartAttemptHookFunction, type LifecycleHooksManager } from "./types.js";
 export declare class LifecycleHooksAPI {
     #private;
     private static _instance?;

package/dist/esm/v3/lifecycleHooks/manager.d.ts

@@ -1,4 +1,4 @@
-import { AnyOnInitHookFunction, AnyOnStartHookFunction, LifecycleHooksManager, RegisteredHookFunction, RegisterHookFunctionParams, AnyOnFailureHookFunction, AnyOnSuccessHookFunction, AnyOnCompleteHookFunction, AnyOnWaitHookFunction, AnyOnResumeHookFunction, AnyOnCatchErrorHookFunction, AnyOnMiddlewareHookFunction, AnyOnCleanupHookFunction, TaskWait, AnyOnCancelHookFunction, AnyOnStartAttemptHookFunction } from "./types.js";
+import type { AnyOnInitHookFunction, AnyOnStartHookFunction, LifecycleHooksManager, RegisteredHookFunction, RegisterHookFunctionParams, AnyOnFailureHookFunction, AnyOnSuccessHookFunction, AnyOnCompleteHookFunction, AnyOnWaitHookFunction, AnyOnResumeHookFunction, AnyOnCatchErrorHookFunction, AnyOnMiddlewareHookFunction, AnyOnCleanupHookFunction, TaskWait, AnyOnCancelHookFunction, AnyOnStartAttemptHookFunction } from "./types.js";
 export declare class StandardLifecycleHooksManager implements LifecycleHooksManager {
     private globalInitHooks;
     private taskInitHooks;

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

@@ -1,5 +1,5 @@
-import { RetryOptions, TaskRunContext } from "../schemas/index.js";
-import { HandleErrorResult } from "../types/index.js";
+import type { RetryOptions, TaskRunContext } from "../schemas/index.js";
+import type { HandleErrorResult } from "../types/index.js";
 export type TaskInitOutput = Record<string, any> | void | undefined;
 export type TaskInitHookParams<TPayload = unknown> = {
     ctx: TaskRunContext;

package/dist/esm/v3/limits.d.ts

@@ -1,4 +1,4 @@
-import { Attributes } from "@opentelemetry/api";
+import type { Attributes } from "@opentelemetry/api";
 export declare const OTEL_SPAN_ATTRIBUTE_COUNT_LIMIT: number;
 export declare const OTEL_LOG_ATTRIBUTE_COUNT_LIMIT: number;
 export declare const OTEL_SPAN_ATTRIBUTE_VALUE_LENGTH_LIMIT: number;

package/dist/esm/v3/links.d.ts

@@ -24,7 +24,6 @@ export declare const links: {
         gitHubActions: {
             personalAccessToken: string;
         };
-        maxDuration: string;
     };
     site: {
         home: string;

package/dist/esm/v3/links.js

@@ -24,7 +24,6 @@ export const links = {
         gitHubActions: {
             personalAccessToken: "https://trigger.dev/docs/github-actions#creating-a-personal-access-token",
         },
-        maxDuration: "https://trigger.dev/docs/runs/max-duration",
     },
     site: {
         home: "https://trigger.dev",

package/dist/esm/v3/links.js.map

@@ -1 +1 @@
-{"version":3,"file":"links.js","sourceRoot":"","sources":["../../../src/v3/links.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,KAAK,GAAG;IACnB,IAAI,EAAE;QACJ,MAAM,EAAE;YACN,IAAI,EAAE,6CAA6C;YACnD,kBAAkB,EAAE,gEAAgE;YACpF,UAAU,EAAE,wDAAwD;YACpE,MAAM,EAAE,oDAAoD;SAC7D;QACD,QAAQ,EAAE;YACR,IAAI,EAAE,sCAAsC;SAC7C;QACD,OAAO,EAAE;YACP,IAAI,EAAE,yCAAyC;SAChD;QACD,eAAe,EAAE;YACf,eAAe,EAAE,2EAA2E;YAC5F,gBAAgB,EAAE,qEAAqE;YACvF,iBAAiB,EAAE,8DAA8D;SAClF;QACD,WAAW,EAAE;YACX,iBAAiB,EACf,oFAAoF;YACtF,QAAQ,EAAE,qDAAqD;SAChE;QACD,aAAa,EAAE;YACb,mBAAmB,EACjB,0EAA0E;SAC7E;QACD,WAAW,EAAE,4CAA4C;KAC1D;IACD,IAAI,EAAE;QACJ,IAAI,EAAE,qBAAqB;QAC3B,OAAO,EAAE,6BAA6B;KACvC;CACF,CAAC"}
+{"version":3,"file":"links.js","sourceRoot":"","sources":["../../../src/v3/links.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,KAAK,GAAG;IACnB,IAAI,EAAE;QACJ,MAAM,EAAE;YACN,IAAI,EAAE,6CAA6C;YACnD,kBAAkB,EAAE,gEAAgE;YACpF,UAAU,EAAE,wDAAwD;YACpE,MAAM,EAAE,oDAAoD;SAC7D;QACD,QAAQ,EAAE;YACR,IAAI,EAAE,sCAAsC;SAC7C;QACD,OAAO,EAAE;YACP,IAAI,EAAE,yCAAyC;SAChD;QACD,eAAe,EAAE;YACf,eAAe,EAAE,2EAA2E;YAC5F,gBAAgB,EAAE,qEAAqE;YACvF,iBAAiB,EAAE,8DAA8D;SAClF;QACD,WAAW,EAAE;YACX,iBAAiB,EACf,oFAAoF;YACtF,QAAQ,EAAE,qDAAqD;SAChE;QACD,aAAa,EAAE;YACb,mBAAmB,EACjB,0EAA0E;SAC7E;KACF;IACD,IAAI,EAAE;QACJ,IAAI,EAAE,qBAAqB;QAC3B,OAAO,EAAE,6BAA6B;KACvC;CACF,CAAC"}

package/dist/esm/v3/locals/index.d.ts

@@ -1,4 +1,4 @@
-import { LocalsKey, type LocalsManager } from "./types.js";
+import { type LocalsKey, type LocalsManager } from "./types.js";
 export declare class LocalsAPI implements LocalsManager {
     #private;
     private static _instance?;

package/dist/esm/v3/locals/manager.d.ts

@@ -1,4 +1,4 @@
-import { LocalsKey, LocalsManager } from "./types.js";
+import type { LocalsKey, LocalsManager } from "./types.js";
 export declare class NoopLocalsManager implements LocalsManager {
     createLocal<T>(id: string): LocalsKey<T>;
     getLocal<T>(key: LocalsKey<T>): T | undefined;

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

@@ -1 +1 @@
-{"version":3,"file":"manager.js","sourceRoot":"","sources":["../../../../src/v3/locals/manager.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,iBAAiB;IAC5B,WAAW,CAAI,EAAU;QACvB,OAAO;YACL,MAAM,EAAE,MAAM,EAAE;YAChB,EAAE;SACwB,CAAC;IAC/B,CAAC;IAED,QAAQ,CAAI,GAAiB;QAC3B,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,QAAQ,CAAI,GAAiB,EAAE,KAAQ,IAAS,CAAC;CAClD;AAED,MAAM,OAAO,qBAAqB;IACxB,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;SACwB,CAAC;IAC/B,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,MAAM,OAAO,iBAAiB;IAC5B,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,MAAM,OAAO,qBAAqB;IACxB,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/esm/v3/locals/types.d.ts

@@ -1,14 +1,25 @@
-declare const __local: unique symbol;
-type BrandLocal<T> = {
-    [__local]: T;
-};
-export type LocalsKey<T> = BrandLocal<T> & {
+/**
+ * A type-safe key for `locals`. Carries the value type `T` as a phantom
+ * marker on the optional `__valueType` field so two keys with different
+ * value types are distinguishable at the type level.
+ *
+ * The phantom field is intentionally not anchored to a `unique symbol`:
+ * dual-package builds (`tshy`) emit separate `.d.ts` files for ESM and
+ * CJS outputs, and each `unique symbol` declaration in a `.d.ts` is its
+ * own nominal type. If a single compilation ever resolves `LocalsKey`
+ * from both the ESM and CJS paths — which happens under certain pnpm
+ * hoisting layouts — `unique symbol` brands produce structurally
+ * incompatible variants of the same type. A plain string brand avoids
+ * the hazard.
+ */
+export type LocalsKey<T> = {
     readonly id: string;
-    readonly __type: unique symbol;
+    readonly __type: symbol;
+    /** Phantom carrier for the value type — never read at runtime. */
+    readonly __valueType?: T;
 };
 export interface LocalsManager {
     createLocal<T>(id: string): LocalsKey<T>;
     getLocal<T>(key: LocalsKey<T>): T | undefined;
     setLocal<T>(key: LocalsKey<T>, value: T): void;
 }
-export {};

package/dist/esm/v3/logger/index.d.ts

@@ -1,5 +1,5 @@
-import { TaskLogger, TraceOptions } from "./taskLogger.js";
-import { Span } from "@opentelemetry/api";
+import type { TaskLogger, TraceOptions } from "./taskLogger.js";
+import type { Span } from "@opentelemetry/api";
 export declare class LoggerAPI implements TaskLogger {
     #private;
     private static _instance?;

package/dist/esm/v3/logger/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/v3/logger/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAA4B,MAAM,iBAAiB,CAAC;AAC3E,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAGlF,MAAM,QAAQ,GAAG,QAAQ,CAAC;AAE1B,MAAM,gBAAgB,GAAG,IAAI,cAAc,EAAE,CAAC;AAE9C,MAAM,OAAO,SAAS;IACZ,MAAM,CAAC,SAAS,CAAa;IAErC,gBAAuB,CAAC;IAEjB,MAAM,CAAC,WAAW;QACvB,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;YACpB,IAAI,CAAC,SAAS,GAAG,IAAI,SAAS,EAAE,CAAC;QACnC,CAAC;QAED,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;IAEM,OAAO;QACZ,gBAAgB,CAAC,QAAQ,CAAC,CAAC;IAC7B,CAAC;IAEM,mBAAmB,CAAC,UAAsB;QAC/C,OAAO,cAAc,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;IAC9C,CAAC;IAEM,KAAK,CAAC,OAAe,EAAE,QAAkC;QAC9D,IAAI,CAAC,cAAc,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IACjD,CAAC;IAEM,GAAG,CAAC,OAAe,EAAE,QAAkC;QAC5D,IAAI,CAAC,cAAc,EAAE,CAAC,GAAG,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IAC/C,CAAC;IAEM,IAAI,CAAC,OAAe,EAAE,QAAkC;QAC7D,IAAI,CAAC,cAAc,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IAChD,CAAC;IAEM,IAAI,CAAC,OAAe,EAAE,QAAkC;QAC7D,IAAI,CAAC,cAAc,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IAChD,CAAC;IAEM,KAAK,CAAC,OAAe,EAAE,QAAkC;QAC9D,IAAI,CAAC,cAAc,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IACjD,CAAC;IAEM,KAAK,CACV,IAAY,EACZ,EAA8B,EAC9B,OAAsB;QAEtB,OAAO,IAAI,CAAC,cAAc,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,EAAE,OAAO,CAAC,CAAC;IACxD,CAAC;IAEM,SAAS,CAAC,IAAY,EAAE,OAAsB;QACnD,OAAO,IAAI,CAAC,cAAc,EAAE,CAAC,SAAS,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACxD,CAAC;IAED,cAAc;QACZ,OAAO,SAAS,CAAC,QAAQ,CAAC,IAAI,gBAAgB,CAAC;IACjD,CAAC;CACF"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/v3/logger/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAGlF,MAAM,QAAQ,GAAG,QAAQ,CAAC;AAE1B,MAAM,gBAAgB,GAAG,IAAI,cAAc,EAAE,CAAC;AAE9C,MAAM,OAAO,SAAS;IACZ,MAAM,CAAC,SAAS,CAAa;IAErC,gBAAuB,CAAC;IAEjB,MAAM,CAAC,WAAW;QACvB,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;YACpB,IAAI,CAAC,SAAS,GAAG,IAAI,SAAS,EAAE,CAAC;QACnC,CAAC;QAED,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;IAEM,OAAO;QACZ,gBAAgB,CAAC,QAAQ,CAAC,CAAC;IAC7B,CAAC;IAEM,mBAAmB,CAAC,UAAsB;QAC/C,OAAO,cAAc,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;IAC9C,CAAC;IAEM,KAAK,CAAC,OAAe,EAAE,QAAkC;QAC9D,IAAI,CAAC,cAAc,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IACjD,CAAC;IAEM,GAAG,CAAC,OAAe,EAAE,QAAkC;QAC5D,IAAI,CAAC,cAAc,EAAE,CAAC,GAAG,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IAC/C,CAAC;IAEM,IAAI,CAAC,OAAe,EAAE,QAAkC;QAC7D,IAAI,CAAC,cAAc,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IAChD,CAAC;IAEM,IAAI,CAAC,OAAe,EAAE,QAAkC;QAC7D,IAAI,CAAC,cAAc,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IAChD,CAAC;IAEM,KAAK,CAAC,OAAe,EAAE,QAAkC;QAC9D,IAAI,CAAC,cAAc,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IACjD,CAAC;IAEM,KAAK,CACV,IAAY,EACZ,EAA8B,EAC9B,OAAsB;QAEtB,OAAO,IAAI,CAAC,cAAc,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,EAAE,OAAO,CAAC,CAAC;IACxD,CAAC;IAEM,SAAS,CAAC,IAAY,EAAE,OAAsB;QACnD,OAAO,IAAI,CAAC,cAAc,EAAE,CAAC,SAAS,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACxD,CAAC;IAED,cAAc;QACZ,OAAO,SAAS,CAAC,QAAQ,CAAC,IAAI,gBAAgB,CAAC;IACjD,CAAC;CACF"}

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

@@ -1,7 +1,7 @@
-import { Span, SpanOptions } from "@opentelemetry/api";
-import { Logger } from "@opentelemetry/api-logs";
-import { TriggerTracer } from "../tracer.js";
-import { Prettify } from "../types/utils.js";
+import type { Span, SpanOptions } from "@opentelemetry/api";
+import type { Logger } from "@opentelemetry/api-logs";
+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 = {