@trigger.dev/sdk 4.0.2 → 4.0.4

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

@@ -0,0 +1,37 @@
+/**
+ *
+ * Yields to the Trigger.dev runtime to keep the task alive.
+ *
+ * This is a cooperative "heartbeat" that you can call as often as you like
+ * inside long-running or CPU-heavy loops (e.g. parsing large files, processing
+ * many records, or handling big Textract results).
+ *
+ * You don’t need to worry about over-calling it: the underlying implementation
+ * automatically decides when to actually yield to the event loop and send a
+ * heartbeat to the Trigger.dev runtime. Extra calls are effectively free.
+ *
+ * ### Example
+ * ```ts
+ * import { heartbeats } from "@trigger.dev/sdk/v3";
+ *
+ * for (const row of bigDataset) {
+ *   process(row);
+ *   await heartbeats.yield(); // safe to call every iteration
+ * }
+ * ```
+ *
+ * Using this regularly prevents `TASK_RUN_STALLED_EXECUTING` errors by ensuring
+ * the run never appears idle, even during heavy synchronous work.
+ *
+ * This function is also safe to call from outside of a Trigger.dev task run, it will effectively be a no-op.
+ */
+declare function heartbeatsYield(): Promise<void>;
+/**
+ * Returns the last heartbeat timestamp, for debugging purposes only. You probably don't need this.
+ */
+declare function heartbeatsGetLastHeartbeat(): Date | undefined;
+export declare const heartbeats: {
+    yield: typeof heartbeatsYield;
+    getLastHeartbeat: typeof heartbeatsGetLastHeartbeat;
+};
+export {};

package/dist/commonjs/v3/heartbeats.js

@@ -0,0 +1,45 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.heartbeats = void 0;
+const v3_1 = require("@trigger.dev/core/v3");
+/**
+ *
+ * Yields to the Trigger.dev runtime to keep the task alive.
+ *
+ * This is a cooperative "heartbeat" that you can call as often as you like
+ * inside long-running or CPU-heavy loops (e.g. parsing large files, processing
+ * many records, or handling big Textract results).
+ *
+ * You don’t need to worry about over-calling it: the underlying implementation
+ * automatically decides when to actually yield to the event loop and send a
+ * heartbeat to the Trigger.dev runtime. Extra calls are effectively free.
+ *
+ * ### Example
+ * ```ts
+ * import { heartbeats } from "@trigger.dev/sdk/v3";
+ *
+ * for (const row of bigDataset) {
+ *   process(row);
+ *   await heartbeats.yield(); // safe to call every iteration
+ * }
+ * ```
+ *
+ * Using this regularly prevents `TASK_RUN_STALLED_EXECUTING` errors by ensuring
+ * the run never appears idle, even during heavy synchronous work.
+ *
+ * This function is also safe to call from outside of a Trigger.dev task run, it will effectively be a no-op.
+ */
+async function heartbeatsYield() {
+    await v3_1.heartbeats.yield();
+}
+/**
+ * Returns the last heartbeat timestamp, for debugging purposes only. You probably don't need this.
+ */
+function heartbeatsGetLastHeartbeat() {
+    return v3_1.heartbeats.lastHeartbeat;
+}
+exports.heartbeats = {
+    yield: heartbeatsYield,
+    getLastHeartbeat: heartbeatsGetLastHeartbeat,
+};
+//# sourceMappingURL=heartbeats.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"heartbeats.js","sourceRoot":"","sources":["../../../src/v3/heartbeats.ts"],"names":[],"mappings":";;;AAAA,6CAAoE;AAEpE;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,KAAK,UAAU,eAAe;IAC5B,MAAM,eAAc,CAAC,KAAK,EAAE,CAAC;AAC/B,CAAC;AAED;;GAEG;AACH,SAAS,0BAA0B;IACjC,OAAO,eAAc,CAAC,aAAa,CAAC;AACtC,CAAC;AAEY,QAAA,UAAU,GAAG;IACxB,KAAK,EAAE,eAAe;IACtB,gBAAgB,EAAE,0BAA0B;CAC7C,CAAC"}

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

@@ -15,6 +15,7 @@ export * from "./webhooks.js";
 export * from "./locals.js";
 export * from "./otel.js";
 export * from "./schemas.js";
+export * from "./heartbeats.js";
 export type { Context };
 import type { Context } from "./shared.js";
 import type { ApiClientConfiguration } from "@trigger.dev/core/v3";

package/dist/commonjs/v3/index.js

@@ -46,6 +46,7 @@ __exportStar(require("./webhooks.js"), exports);
 __exportStar(require("./locals.js"), exports);
 __exportStar(require("./otel.js"), exports);
 __exportStar(require("./schemas.js"), exports);
+__exportStar(require("./heartbeats.js"), exports);
 var v3_1 = require("@trigger.dev/core/v3");
 Object.defineProperty(exports, "ApiError", { enumerable: true, get: function () { return v3_1.ApiError; } });
 Object.defineProperty(exports, "AuthenticationError", { enumerable: true, get: function () { return v3_1.AuthenticationError; } });

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/v3/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,6CAA2B;AAC3B,8CAA4B;AAC5B,uCAAsD;AAA7C,iGAAA,KAAK,OAAA;AACd,yCAAoC;AAA3B,kGAAA,KAAK,OAAA;AACd,6CAA2B;AAC3B,6CAA2B;AAC3B,4CAA0B;AAC1B,iDAA+B;AAC/B,6CAA2B;AAC3B,uDAAqC;AACrC,4CAA0B;AAC1B,gDAA8B;AAC9B,+CAA6B;AAC7B,gDAA8B;AAC9B,8CAA4B;AAC5B,4CAA0B;AAC1B,+CAA6B;AAS7B,2CAe8B;AAd5B,8FAAA,QAAQ,OAAA;AACR,yGAAA,mBAAmB,OAAA;AACnB,qGAAA,eAAe,OAAA;AACf,mGAAA,aAAa,OAAA;AACb,yGAAA,mBAAmB,OAAA;AACnB,mGAAA,aAAa,OAAA;AACb,2GAAA,qBAAqB,OAAA;AACrB,oGAAA,cAAc,OAAA;AACd,8GAAA,wBAAwB,OAAA;AACxB,uGAAA,iBAAiB,OAAA;AACjB,sGAAA,gBAAgB,OAAA;AAChB,4GAAA,sBAAsB,OAAA;AACtB,4FAAA,MAAM,OAAA;AAIR,qCASmB;AARjB,+FAAA,IAAI,OAAA;AASN,kEAAkD;AAClD,wDAAwC;AACxC,sDAAsC;AAGtC,qCAA4C;AAAnC,oGAAA,SAAS,OAAA;AAAE,+FAAA,IAAI,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/v3/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,6CAA2B;AAC3B,8CAA4B;AAC5B,uCAAsD;AAA7C,iGAAA,KAAK,OAAA;AACd,yCAAoC;AAA3B,kGAAA,KAAK,OAAA;AACd,6CAA2B;AAC3B,6CAA2B;AAC3B,4CAA0B;AAC1B,iDAA+B;AAC/B,6CAA2B;AAC3B,uDAAqC;AACrC,4CAA0B;AAC1B,gDAA8B;AAC9B,+CAA6B;AAC7B,gDAA8B;AAC9B,8CAA4B;AAC5B,4CAA0B;AAC1B,+CAA6B;AAC7B,kDAAgC;AAShC,2CAe8B;AAd5B,8FAAA,QAAQ,OAAA;AACR,yGAAA,mBAAmB,OAAA;AACnB,qGAAA,eAAe,OAAA;AACf,mGAAA,aAAa,OAAA;AACb,yGAAA,mBAAmB,OAAA;AACnB,mGAAA,aAAa,OAAA;AACb,2GAAA,qBAAqB,OAAA;AACrB,oGAAA,cAAc,OAAA;AACd,8GAAA,wBAAwB,OAAA;AACxB,uGAAA,iBAAiB,OAAA;AACjB,sGAAA,gBAAgB,OAAA;AAChB,4GAAA,sBAAsB,OAAA;AACtB,4FAAA,MAAM,OAAA;AAIR,qCASmB;AARjB,+FAAA,IAAI,OAAA;AASN,kEAAkD;AAClD,wDAAwC;AACxC,sDAAsC;AAGtC,qCAA4C;AAAnC,oGAAA,SAAS,OAAA;AAAE,+FAAA,IAAI,OAAA"}

package/dist/commonjs/version.js

@@ -1,5 +1,5 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.VERSION = void 0;
-exports.VERSION = "4.0.2";
+exports.VERSION = "4.0.4";
 //# sourceMappingURL=version.js.map

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

@@ -0,0 +1,37 @@
+/**
+ *
+ * Yields to the Trigger.dev runtime to keep the task alive.
+ *
+ * This is a cooperative "heartbeat" that you can call as often as you like
+ * inside long-running or CPU-heavy loops (e.g. parsing large files, processing
+ * many records, or handling big Textract results).
+ *
+ * You don’t need to worry about over-calling it: the underlying implementation
+ * automatically decides when to actually yield to the event loop and send a
+ * heartbeat to the Trigger.dev runtime. Extra calls are effectively free.
+ *
+ * ### Example
+ * ```ts
+ * import { heartbeats } from "@trigger.dev/sdk/v3";
+ *
+ * for (const row of bigDataset) {
+ *   process(row);
+ *   await heartbeats.yield(); // safe to call every iteration
+ * }
+ * ```
+ *
+ * Using this regularly prevents `TASK_RUN_STALLED_EXECUTING` errors by ensuring
+ * the run never appears idle, even during heavy synchronous work.
+ *
+ * This function is also safe to call from outside of a Trigger.dev task run, it will effectively be a no-op.
+ */
+declare function heartbeatsYield(): Promise<void>;
+/**
+ * Returns the last heartbeat timestamp, for debugging purposes only. You probably don't need this.
+ */
+declare function heartbeatsGetLastHeartbeat(): Date | undefined;
+export declare const heartbeats: {
+    yield: typeof heartbeatsYield;
+    getLastHeartbeat: typeof heartbeatsGetLastHeartbeat;
+};
+export {};

package/dist/esm/v3/heartbeats.js

@@ -0,0 +1,42 @@
+import { heartbeats as coreHeartbeats } from "@trigger.dev/core/v3";
+/**
+ *
+ * Yields to the Trigger.dev runtime to keep the task alive.
+ *
+ * This is a cooperative "heartbeat" that you can call as often as you like
+ * inside long-running or CPU-heavy loops (e.g. parsing large files, processing
+ * many records, or handling big Textract results).
+ *
+ * You don’t need to worry about over-calling it: the underlying implementation
+ * automatically decides when to actually yield to the event loop and send a
+ * heartbeat to the Trigger.dev runtime. Extra calls are effectively free.
+ *
+ * ### Example
+ * ```ts
+ * import { heartbeats } from "@trigger.dev/sdk/v3";
+ *
+ * for (const row of bigDataset) {
+ *   process(row);
+ *   await heartbeats.yield(); // safe to call every iteration
+ * }
+ * ```
+ *
+ * Using this regularly prevents `TASK_RUN_STALLED_EXECUTING` errors by ensuring
+ * the run never appears idle, even during heavy synchronous work.
+ *
+ * This function is also safe to call from outside of a Trigger.dev task run, it will effectively be a no-op.
+ */
+async function heartbeatsYield() {
+    await coreHeartbeats.yield();
+}
+/**
+ * Returns the last heartbeat timestamp, for debugging purposes only. You probably don't need this.
+ */
+function heartbeatsGetLastHeartbeat() {
+    return coreHeartbeats.lastHeartbeat;
+}
+export const heartbeats = {
+    yield: heartbeatsYield,
+    getLastHeartbeat: heartbeatsGetLastHeartbeat,
+};
+//# sourceMappingURL=heartbeats.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"heartbeats.js","sourceRoot":"","sources":["../../../src/v3/heartbeats.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,IAAI,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEpE;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,KAAK,UAAU,eAAe;IAC5B,MAAM,cAAc,CAAC,KAAK,EAAE,CAAC;AAC/B,CAAC;AAED;;GAEG;AACH,SAAS,0BAA0B;IACjC,OAAO,cAAc,CAAC,aAAa,CAAC;AACtC,CAAC;AAED,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,KAAK,EAAE,eAAe;IACtB,gBAAgB,EAAE,0BAA0B;CAC7C,CAAC"}

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

@@ -15,6 +15,7 @@ export * from "./webhooks.js";
 export * from "./locals.js";
 export * from "./otel.js";
 export * from "./schemas.js";
+export * from "./heartbeats.js";
 export type { Context };
 import type { Context } from "./shared.js";
 import type { ApiClientConfiguration } from "@trigger.dev/core/v3";

package/dist/esm/v3/index.js

@@ -15,6 +15,7 @@ export * from "./webhooks.js";
 export * from "./locals.js";
 export * from "./otel.js";
 export * from "./schemas.js";
+export * from "./heartbeats.js";
 export { ApiError, AuthenticationError, BadRequestError, ConflictError, InternalServerError, NotFoundError, PermissionDeniedError, RateLimitError, UnprocessableEntityError, AbortTaskRunError, OutOfMemoryError, CompleteTaskWithOutput, logger, } from "@trigger.dev/core/v3";
 export { runs, } from "./runs.js";
 export * as schedules from "./schedules/index.js";

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/v3/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,OAAO,EAAE,KAAK,EAAqB,MAAM,YAAY,CAAC;AACtD,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACpC,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,sBAAsB,CAAC;AACrC,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAS7B,OAAO,EACL,QAAQ,EACR,mBAAmB,EACnB,eAAe,EACf,aAAa,EACb,mBAAmB,EACnB,aAAa,EACb,qBAAqB,EACrB,cAAc,EACd,wBAAwB,EACxB,iBAAiB,EACjB,gBAAgB,EAChB,sBAAsB,EACtB,MAAM,GAEP,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,IAAI,GAQL,MAAM,WAAW,CAAC;AACnB,OAAO,KAAK,SAAS,MAAM,sBAAsB,CAAC;AAClD,OAAO,KAAK,OAAO,MAAM,cAAc,CAAC;AACxC,OAAO,KAAK,MAAM,MAAM,aAAa,CAAC;AAGtC,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/v3/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,OAAO,EAAE,KAAK,EAAqB,MAAM,YAAY,CAAC;AACtD,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACpC,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,sBAAsB,CAAC;AACrC,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAShC,OAAO,EACL,QAAQ,EACR,mBAAmB,EACnB,eAAe,EACf,aAAa,EACb,mBAAmB,EACnB,aAAa,EACb,qBAAqB,EACrB,cAAc,EACd,wBAAwB,EACxB,iBAAiB,EACjB,gBAAgB,EAChB,sBAAsB,EACtB,MAAM,GAEP,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,IAAI,GAQL,MAAM,WAAW,CAAC;AACnB,OAAO,KAAK,SAAS,MAAM,sBAAsB,CAAC;AAClD,OAAO,KAAK,OAAO,MAAM,cAAc,CAAC;AACxC,OAAO,KAAK,MAAM,MAAM,aAAa,CAAC;AAGtC,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC"}

package/dist/esm/version.js

@@ -1,2 +1,2 @@
-export const VERSION = "4.0.2";
+export const VERSION = "4.0.4";
 //# sourceMappingURL=version.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@trigger.dev/sdk",
-  "version": "4.0.2",
+  "version": "4.0.4",
   "description": "trigger.dev Node.JS SDK",
   "license": "MIT",
   "publishConfig": {
@@ -43,7 +43,7 @@
   "dependencies": {
     "@opentelemetry/api": "1.9.0",
     "@opentelemetry/semantic-conventions": "1.36.0",
-    "@trigger.dev/core": "4.0.2",
+    "@trigger.dev/core": "4.0.4",
     "chalk": "^5.2.0",
     "cronstrue": "^2.21.0",
     "debug": "^4.3.4",