@trigger.dev/core 0.0.0-prerelease-20251218163312 → 0.0.0-prerelease-20260120115202

package/dist/commonjs/v3/idempotencyKeys.js

@@ -1,15 +1,43 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.getIdempotencyKeyOptions = getIdempotencyKeyOptions;
 exports.isIdempotencyKey = isIdempotencyKey;
 exports.flattenIdempotencyKey = flattenIdempotencyKey;
 exports.makeIdempotencyKey = makeIdempotencyKey;
 exports.createIdempotencyKey = createIdempotencyKey;
 exports.attemptKey = attemptKey;
+exports.resetIdempotencyKey = resetIdempotencyKey;
+const apiClientManager_api_js_1 = require("./apiClientManager-api.js");
+const idempotency_key_catalog_api_js_1 = require("./idempotency-key-catalog-api.js");
 const task_context_api_js_1 = require("./task-context-api.js");
 const crypto_js_1 = require("./utils/crypto.js");
+/**
+ * Extracts the user-provided key and scope from an idempotency key created with `idempotencyKeys.create()`.
+ *
+ * @param idempotencyKey The idempotency key to extract options from
+ * @returns The original key and scope, or undefined if the key doesn't have attached options
+ *
+ * @example
+ * ```typescript
+ * const key = await idempotencyKeys.create("my-key", { scope: "global" });
+ * const options = getIdempotencyKeyOptions(key);
+ * // options = { key: "my-key", scope: "global" }
+ * ```
+ */
+function getIdempotencyKeyOptions(idempotencyKey) {
+    // Look up options from the catalog using the hash string
+    if (typeof idempotencyKey === "string") {
+        return idempotency_key_catalog_api_js_1.idempotencyKeyCatalog.getKeyOptions(idempotencyKey);
+    }
+    return undefined;
+}
 function isIdempotencyKey(value) {
     // Cannot check the brand at runtime because it doesn't exist (it's a TypeScript-only construct)
-    return typeof value === "string" && value.length === 64;
+    // Check for primitive strings only (we no longer use String objects)
+    if (typeof value === "string") {
+        return value.length === 64;
+    }
+    return false;
 }
 function flattenIdempotencyKey(idempotencyKey) {
     if (!idempotencyKey) {
@@ -76,7 +104,13 @@ async function makeIdempotencyKey(idempotencyKey) {
  * ```
  */
 async function createIdempotencyKey(key, options) {
-    const idempotencyKey = await generateIdempotencyKey([...(Array.isArray(key) ? key : [key])].concat(injectScope(options?.scope ?? "run")));
+    const scope = options?.scope ?? "run";
+    const keyArray = Array.isArray(key) ? key : [key];
+    const userKey = keyArray.join("-");
+    const idempotencyKey = await generateIdempotencyKey(keyArray.concat(injectScope(scope)));
+    // Register the original key and scope in the catalog for later extraction
+    idempotency_key_catalog_api_js_1.idempotencyKeyCatalog.registerKeyOptions(idempotencyKey, { key: userKey, scope });
+    // Return primitive string cast as IdempotencyKey
     return idempotencyKey;
 }
 function injectScope(scope) {
@@ -103,4 +137,69 @@ async function generateIdempotencyKey(keyMaterial) {
 function attemptKey(ctx) {
     return `${ctx.run.id}-${ctx.attempt.number}`;
 }
+/**
+ * Resets an idempotency key, effectively deleting it from the associated task.
+ *
+ * @param taskIdentifier The task identifier (e.g., "my-task")
+ * @param idempotencyKey The idempotency key to reset. Can be:
+ *   - An `IdempotencyKey` created with `idempotencyKeys.create()` (options are extracted automatically)
+ *   - A string or string array (requires `options.scope` and potentially `options.parentRunId`)
+ * @param options Options for reconstructing the hash if needed
+ * @param requestOptions Optional fetch options
+ *
+ * @example
+ * ```typescript
+ * // Using a key created with idempotencyKeys.create() - options are extracted automatically
+ * const key = await idempotencyKeys.create("my-key", { scope: "global" });
+ * await idempotencyKeys.reset("my-task", key);
+ *
+ * // Using a raw string with global scope
+ * await idempotencyKeys.reset("my-task", "my-key", { scope: "global" });
+ *
+ * // Using a raw string with run scope (requires parentRunId)
+ * await idempotencyKeys.reset("my-task", "my-key", {
+ *   scope: "run",
+ *   parentRunId: "run_abc123"
+ * });
+ * ```
+ */
+async function resetIdempotencyKey(taskIdentifier, idempotencyKey, options, requestOptions) {
+    const client = apiClientManager_api_js_1.apiClientManager.clientOrThrow();
+    // If the key is already a 64-char hash, use it directly
+    if (typeof idempotencyKey === "string" && idempotencyKey.length === 64) {
+        return client.resetIdempotencyKey(taskIdentifier, idempotencyKey, requestOptions);
+    }
+    // Try to extract options from an IdempotencyKey created with idempotencyKeys.create()
+    const attachedOptions = typeof idempotencyKey === "string"
+        ? getIdempotencyKeyOptions(idempotencyKey)
+        : undefined;
+    const scope = attachedOptions?.scope ?? options?.scope ?? "run";
+    const keyArray = Array.isArray(idempotencyKey)
+        ? idempotencyKey
+        : [attachedOptions?.key ?? String(idempotencyKey)];
+    // Build scope suffix based on scope type
+    let scopeSuffix = [];
+    switch (scope) {
+        case "run": {
+            const parentRunId = options?.parentRunId ?? task_context_api_js_1.taskContext?.ctx?.run.id;
+            if (!parentRunId) {
+                throw new Error("resetIdempotencyKey: parentRunId is required for 'run' scope when called outside a task context");
+            }
+            scopeSuffix = [parentRunId];
+            break;
+        }
+        case "attempt": {
+            const parentRunId = options?.parentRunId ?? task_context_api_js_1.taskContext?.ctx?.run.id;
+            const attemptNumber = options?.attemptNumber ?? task_context_api_js_1.taskContext?.ctx?.attempt.number;
+            if (!parentRunId || attemptNumber === undefined) {
+                throw new Error("resetIdempotencyKey: parentRunId and attemptNumber are required for 'attempt' scope when called outside a task context");
+            }
+            scopeSuffix = [parentRunId, attemptNumber.toString()];
+            break;
+        }
+    }
+    // Generate the hash using the same algorithm as createIdempotencyKey
+    const hash = await generateIdempotencyKey(keyArray.concat(scopeSuffix));
+    return client.resetIdempotencyKey(taskIdentifier, hash, requestOptions);
+}
 //# sourceMappingURL=idempotencyKeys.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"idempotencyKeys.js","sourceRoot":"","sources":["../../../src/v3/idempotencyKeys.ts"],"names":[],"mappings":";;AAIA,4CAKC;AAED,sDAyBC;AAED,gDAcC;AAqCD,oDASC;AAmCD,gCAEC;AAvID,+DAAoD;AAEpD,iDAAiD;AAEjD,SAAgB,gBAAgB,CAC9B,KAAyC;IAEzC,gGAAgG;IAChG,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,KAAK,EAAE,CAAC;AAC1D,CAAC;AAED,SAAgB,qBAAqB,CACnC,cAIsD;IAEtD,IAAI,CAAC,cAAc,EAAE,CAAC;QACpB,OAAO;IACT,CAAC;IAED,IAAI,KAAK,CAAC,OAAO,CAAC,cAAc,CAAC,EAAE,CAAC;QAClC,sEAAsE;QACtE,IAAI,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,SAAS,CAAC,EAAE,CAAC;YAChD,OAAO;QACT,CAAC;QAED,OAAO,cAAc,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE;YACpC,MAAM,CAAC,GAAG,qBAAqB,CAAC,GAAG,CAAC,CAAC;YACrC,IAAI,CAAC,CAAC;gBAAE,OAAO,EAAE,CAAC;YAClB,OAAO,CAAC,CAAC,CAAC,CAAC;QACb,CAAC,CAAa,CAAC;IACjB,CAAC;IAED,OAAO,cAAc,CAAC;AACxB,CAAC;AAEM,KAAK,UAAU,kBAAkB,CACtC,cAAmD;IAEnD,IAAI,CAAC,cAAc,EAAE,CAAC;QACpB,OAAO;IACT,CAAC;IAED,IAAI,gBAAgB,CAAC,cAAc,CAAC,EAAE,CAAC;QACrC,OAAO,cAAc,CAAC;IACxB,CAAC;IAED,OAAO,MAAM,oBAAoB,CAAC,cAAc,EAAE;QAChD,KAAK,EAAE,KAAK;KACb,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACI,KAAK,UAAU,oBAAoB,CACxC,GAAsB,EACtB,OAAkD;IAElD,MAAM,cAAc,GAAG,MAAM,sBAAsB,CACjD,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,OAAO,EAAE,KAAK,IAAI,KAAK,CAAC,CAAC,CACrF,CAAC;IAEF,OAAO,cAAgC,CAAC;AAC1C,CAAC;AAED,SAAS,WAAW,CAAC,KAAmC;IACtD,QAAQ,KAAK,EAAE,CAAC;QACd,KAAK,KAAK,CAAC,CAAC,CAAC;YACX,IAAI,iCAAW,EAAE,GAAG,EAAE,CAAC;gBACrB,OAAO,CAAC,iCAAW,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAClC,CAAC;YACD,MAAM;QACR,CAAC;QACD,KAAK,SAAS,CAAC,CAAC,CAAC;YACf,IAAI,iCAAW,EAAE,GAAG,EAAE,CAAC;gBACrB,OAAO,CAAC,iCAAW,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,EAAE,iCAAW,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC;YAC7E,CAAC;YACD,MAAM;QACR,CAAC;IACH,CAAC;IAED,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,KAAK,UAAU,sBAAsB,CAAC,WAAqB;IACzD,OAAO,MAAM,IAAA,wBAAY,EAAC,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AACnD,CAAC;AAWD,6CAA6C;AAC7C,SAAgB,UAAU,CAAC,GAAuB;IAChD,OAAO,GAAG,GAAG,CAAC,GAAG,CAAC,EAAE,IAAI,GAAG,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;AAC/C,CAAC"}
+{"version":3,"file":"idempotencyKeys.js","sourceRoot":"","sources":["../../../src/v3/idempotencyKeys.ts"],"names":[],"mappings":"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"}

package/dist/commonjs/v3/imports/superjson-cjs.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"superjson-cjs.cjs","sourceRoot":"","sources":["../../../../src/v3/imports/superjson-cjs.cts"],"names":[],"mappings":";;AAAA,aAAa;AACb,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;AAEpD,aAAa;AACb,SAAS,CAAC,cAAc,CACtB;IACE,YAAY,EAAE,CAAC,CAAU,EAAe,EAAE,CAAC,OAAO,MAAM,KAAK,UAAU,IAAI,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC7F,SAAS,EAAE,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC;IAChC,WAAW,EAAE,CAAC,CAAW,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;CAC7C,EACD,QAAQ,CACT,CAAC;AAEF,aAAa;AACb,MAAM,CAAC,OAAO,CAAC,OAAO,GAAG,SAAS,CAAC"}

package/dist/commonjs/v3/imports/superjson.d.ts

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

package/dist/commonjs/v3/imports/superjson.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+// @ts-ignore
+const { default: superjson } = require("superjson");
+// @ts-ignore
+superjson.registerCustom({
+    isApplicable: (v) => typeof Buffer === "function" && Buffer.isBuffer(v),
+    serialize: (v) => [...v],
+    deserialize: (v) => Buffer.from(v),
+}, "buffer");
+// @ts-ignore
+module.exports.default = superjson;
+//# sourceMappingURL=superjson-cjs.cjs.map

package/dist/commonjs/v3/runEngineWorker/supervisor/http.d.ts

@@ -17,6 +17,20 @@ export declare class SupervisorHttpClient {
         };
     }>>;
     dequeue(body: WorkerApiDequeueRequestBody): Promise<import("../../zodfetch.js").ApiResult<{
+        run: {
+            id: string;
+            isTest: boolean;
+            machine: {
+                cpu: number;
+                memory: number;
+                name: "micro" | "small-1x" | "small-2x" | "medium-1x" | "medium-2x" | "large-1x" | "large-2x";
+                centsPerMs: number;
+            };
+            traceContext: Record<string, unknown>;
+            friendlyId: string;
+            attemptNumber: number;
+            masterQueue: string;
+        };
         version: "1";
         environment: {
             type: "PRODUCTION" | "STAGING" | "DEVELOPMENT" | "PREVIEW";
@@ -33,20 +47,6 @@ export declare class SupervisorHttpClient {
             friendlyId?: string | undefined;
             imagePlatform?: string | undefined;
         };
-        run: {
-            id: string;
-            isTest: boolean;
-            machine: {
-                cpu: number;
-                memory: number;
-                name: "micro" | "small-1x" | "small-2x" | "medium-1x" | "medium-2x" | "large-1x" | "large-2x";
-                centsPerMs: number;
-            };
-            traceContext: Record<string, unknown>;
-            friendlyId: string;
-            attemptNumber: number;
-            masterQueue: string;
-        };
         snapshot: {
             id: string;
             createdAt: Date;
@@ -100,6 +100,20 @@ export declare class SupervisorHttpClient {
     }[]>>;
     /** @deprecated Not currently used */
     dequeueFromVersion(deploymentId: string, maxRunCount?: number, runnerId?: string): Promise<import("../../zodfetch.js").ApiResult<{
+        run: {
+            id: string;
+            isTest: boolean;
+            machine: {
+                cpu: number;
+                memory: number;
+                name: "micro" | "small-1x" | "small-2x" | "medium-1x" | "medium-2x" | "large-1x" | "large-2x";
+                centsPerMs: number;
+            };
+            traceContext: Record<string, unknown>;
+            friendlyId: string;
+            attemptNumber: number;
+            masterQueue: string;
+        };
         version: "1";
         environment: {
             type: "PRODUCTION" | "STAGING" | "DEVELOPMENT" | "PREVIEW";
@@ -116,20 +130,6 @@ export declare class SupervisorHttpClient {
             friendlyId?: string | undefined;
             imagePlatform?: string | undefined;
         };
-        run: {
-            id: string;
-            isTest: boolean;
-            machine: {
-                cpu: number;
-                memory: number;
-                name: "micro" | "small-1x" | "small-2x" | "medium-1x" | "medium-2x" | "large-1x" | "large-2x";
-                centsPerMs: number;
-            };
-            traceContext: Record<string, unknown>;
-            friendlyId: string;
-            attemptNumber: number;
-            masterQueue: string;
-        };
         snapshot: {
             id: string;
             createdAt: Date;
@@ -204,6 +204,37 @@ export declare class SupervisorHttpClient {
         };
     } & {
         execution: {
+            run: {
+                payload: string;
+                id: string;
+                payloadType: string;
+                tags: string[];
+                isTest: boolean;
+                createdAt: Date;
+                startedAt: Date;
+                metadata?: Record<string, import("../../../index.js").DeserializedJson> | undefined;
+                idempotencyKey?: string | undefined;
+                idempotencyKeyScope?: "run" | "attempt" | "global" | undefined;
+                maxAttempts?: number | undefined;
+                version?: string | undefined;
+                maxDuration?: number | undefined;
+                priority?: number | undefined;
+                baseCostInCents?: number | undefined;
+                parentTaskRunId?: string | undefined;
+                rootTaskRunId?: string | undefined;
+                durationMs?: number | undefined;
+                costInCents?: number | undefined;
+                region?: string | undefined;
+            } & {
+                traceContext?: Record<string, unknown> | undefined;
+                realtimeStreamsVersion?: string | undefined;
+            };
+            attempt: {
+                number: number;
+                startedAt: Date;
+            } & {
+                [k: string]: unknown;
+            };
             task: {
                 id: string;
                 filePath: string;
@@ -252,36 +283,6 @@ export declare class SupervisorHttpClient {
                 name: "micro" | "small-1x" | "small-2x" | "medium-1x" | "medium-2x" | "large-1x" | "large-2x";
                 centsPerMs: number;
             };
-            attempt: {
-                number: number;
-                startedAt: Date;
-            } & {
-                [k: string]: unknown;
-            };
-            run: {
-                payload: string;
-                id: string;
-                payloadType: string;
-                tags: string[];
-                isTest: boolean;
-                createdAt: Date;
-                startedAt: Date;
-                metadata?: Record<string, import("../../../index.js").DeserializedJson> | undefined;
-                idempotencyKey?: string | undefined;
-                maxAttempts?: number | undefined;
-                version?: string | undefined;
-                maxDuration?: number | undefined;
-                priority?: number | undefined;
-                baseCostInCents?: number | undefined;
-                parentTaskRunId?: string | undefined;
-                rootTaskRunId?: string | undefined;
-                durationMs?: number | undefined;
-                costInCents?: number | undefined;
-                region?: string | undefined;
-            } & {
-                traceContext?: Record<string, unknown> | undefined;
-                realtimeStreamsVersion?: string | undefined;
-            };
             batch?: {
                 id: string;
             } | undefined;
@@ -333,7 +334,6 @@ export declare class SupervisorHttpClient {
     }>>;
     getLatestSnapshot(runId: string, runnerId?: string): Promise<import("../../zodfetch.js").ApiResult<{
         execution: {
-            version: "1";
             run: {
                 status: import("../../index.js").TaskRunStatus;
                 id: string;
@@ -341,6 +341,7 @@ export declare class SupervisorHttpClient {
                 attemptNumber?: number | null | undefined;
                 taskEventStore?: string | undefined;
             };
+            version: "1";
             snapshot: {
                 id: string;
                 createdAt: Date;
@@ -388,7 +389,6 @@ export declare class SupervisorHttpClient {
     }>>;
     getSnapshotsSince(runId: string, snapshotId: string, runnerId?: string): Promise<import("../../zodfetch.js").ApiResult<{
         snapshots: {
-            version: "1";
             run: {
                 status: import("../../index.js").TaskRunStatus;
                 id: string;
@@ -396,6 +396,7 @@ export declare class SupervisorHttpClient {
                 attemptNumber?: number | null | undefined;
                 taskEventStore?: string | undefined;
             };
+            version: "1";
             snapshot: {
                 id: string;
                 createdAt: Date;