This PR was opened by the [Changesets release](https://github.com/changesets/action) GitHub action. When you're ready to do a release, you can merge this and publish to npm yourself or [setup this action to publish automatically](https://github.com/changesets/action#with-publishing). If you're not ready to do a release yet, that's fine, whenever you add more changesets to main, this PR will be updated. # Releases ## @trigger.dev/sdk@4.4.0 ### Minor Changes - Added `query.execute()` which lets you query your Trigger.dev data using TRQL (Trigger Query Language) and returns results as typed JSON rows or CSV. It supports configurable scope (environment, project, or organization), time filtering via `period` or `from`/`to` ranges, and a `format` option for JSON or CSV output. ([#3060](https://github.com/triggerdotdev/trigger.dev/pull/3060)) ```typescript import { query } from "@trigger.dev/sdk"; import type { QueryTable } from "@trigger.dev/sdk"; // Basic untyped query const result = await query.execute("SELECT run_id, status FROM runs LIMIT 10"); // Type-safe query using QueryTable to pick specific columns const typedResult = await query.execute<QueryTable<"runs", "run_id" | "status" | "triggered_at">>( "SELECT run_id, status, triggered_at FROM runs LIMIT 10" ); typedResult.results.forEach((row) => { console.log(row.run_id, row.status); // Fully typed }); // Aggregation query with inline types const stats = await query.execute<{ status: string; count: number }>( "SELECT status, COUNT(*) as count FROM runs GROUP BY status", { scope: "project", period: "30d" } ); // CSV export const csv = await query.execute("SELECT run_id, status FROM runs", { format: "csv", period: "7d", }); console.log(csv.results); // Raw CSV string ``` ### Patch Changes - Add `maxDelay` option to debounce feature. This allows setting a maximum time limit for how long a debounced run can be delayed, ensuring execution happens within a specified window even with continuous triggers. ([#2984](https://github.com/triggerdotdev/trigger.dev/pull/2984)) ```typescript await myTask.trigger(payload, { debounce: { key: "my-key", delay: "5s", maxDelay: "30m", // Execute within 30 minutes regardless of continuous triggers }, }); ``` - Aligned the SDK's `getRunIdForOptions` logic with the Core package to handle semantic targets (`root`, `parent`) in root tasks. ([#2874](https://github.com/triggerdotdev/trigger.dev/pull/2874)) - Export `AnyOnStartAttemptHookFunction` type to allow defining `onStartAttempt` hooks for individual tasks. ([#2966](https://github.com/triggerdotdev/trigger.dev/pull/2966)) - Fixed a minor issue in the deployment command on distinguishing between local builds for the cloud vs local builds for self-hosting setups. ([#3070](https://github.com/triggerdotdev/trigger.dev/pull/3070)) - Updated dependencies: - `@trigger.dev/core@4.4.0` ## @trigger.dev/build@4.4.0 ### Patch Changes - Updated dependencies: - `@trigger.dev/core@4.4.0` ## trigger.dev@4.4.0 ### Patch Changes - Fix runner getting stuck indefinitely when `execute()` is called on a dead child process. ([#2978](https://github.com/triggerdotdev/trigger.dev/pull/2978)) - Add optional `timeoutInSeconds` parameter to the `wait_for_run_to_complete` MCP tool. Defaults to 60 seconds. If the run doesn't complete within the timeout, the current state of the run is returned instead of waiting indefinitely. ([#3035](https://github.com/triggerdotdev/trigger.dev/pull/3035)) - Fixed a minor issue in the deployment command on distinguishing between local builds for the cloud vs local builds for self-hosting setups. ([#3070](https://github.com/triggerdotdev/trigger.dev/pull/3070)) - Updated dependencies: - `@trigger.dev/core@4.4.0` - `@trigger.dev/build@4.4.0` - `@trigger.dev/schema-to-json@4.4.0` ## @trigger.dev/core@4.4.0 ### Patch Changes - Add `maxDelay` option to debounce feature. This allows setting a maximum time limit for how long a debounced run can be delayed, ensuring execution happens within a specified window even with continuous triggers. ([#2984](https://github.com/triggerdotdev/trigger.dev/pull/2984)) ```typescript await myTask.trigger(payload, { debounce: { key: "my-key", delay: "5s", maxDelay: "30m", // Execute within 30 minutes regardless of continuous triggers }, }); ``` - Fixed a minor issue in the deployment command on distinguishing between local builds for the cloud vs local builds for self-hosting setups. ([#3070](https://github.com/triggerdotdev/trigger.dev/pull/3070)) - fix: vendor superjson to fix ESM/CJS compatibility ([#2949](https://github.com/triggerdotdev/trigger.dev/pull/2949)) Bundle superjson during build to avoid `ERR_REQUIRE_ESM` errors on Node.js versions that don't support `require(ESM)` by default (< 22.12.0) and AWS Lambda which intentionally disables it. - Add Vercel integration support to API schemas: `commitSHA` and `integrationDeployments` on deployment responses, and `source` field for environment variable imports. ([#2994](https://github.com/triggerdotdev/trigger.dev/pull/2994)) ## @trigger.dev/python@4.4.0 ### Patch Changes - Updated dependencies: - `@trigger.dev/core@4.4.0` - `@trigger.dev/sdk@4.4.0` - `@trigger.dev/build@4.4.0` ## @trigger.dev/react-hooks@4.4.0 ### Patch Changes - Fix `onComplete` callback firing prematurely when the realtime stream disconnects before the run finishes. ([#2929](https://github.com/triggerdotdev/trigger.dev/pull/2929)) - Updated dependencies: - `@trigger.dev/core@4.4.0` ## @trigger.dev/redis-worker@4.4.0 ### Patch Changes - Updated dependencies: - `@trigger.dev/core@4.4.0` ## @trigger.dev/rsc@4.4.0 ### Patch Changes - Updated dependencies: - `@trigger.dev/core@4.4.0` ## @trigger.dev/schema-to-json@4.4.0 ### Patch Changes - Updated dependencies: - `@trigger.dev/core@4.4.0` --------- Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com> Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>
13 KiB
@trigger.dev/react-hooks
4.4.0
Patch Changes
- Fix
onCompletecallback firing prematurely when the realtime stream disconnects before the run finishes. (#2929) - Updated dependencies:
@trigger.dev/core@4.4.0
4.3.3
Patch Changes
- Updated dependencies:
@trigger.dev/core@4.3.3
4.3.2
Patch Changes
- Updated dependencies:
@trigger.dev/core@4.3.2
4.3.1
Patch Changes
- Updated dependencies:
@trigger.dev/core@4.3.1
4.3.0
Patch Changes
- Updated dependencies:
@trigger.dev/core@4.3.0
4.2.0
Patch Changes
- fix: prevent infinite useEffect when passing an array of tags to useRealtimeRunsWithTag (#2705)
- Updated dependencies:
@trigger.dev/core@4.2.0
4.1.2
Patch Changes
- Updated dependencies:
@trigger.dev/core@4.1.2
4.1.1
Patch Changes
- Updated dependencies:
@trigger.dev/core@4.1.1
4.1.0
Minor Changes
- Realtime streams v2 (#2632)
Patch Changes
- Updated dependencies:
@trigger.dev/core@4.1.0
4.0.7
Patch Changes
- Updated dependencies:
@trigger.dev/core@4.0.7
4.0.6
Patch Changes
- Updated dependencies:
@trigger.dev/core@4.0.6
4.0.5
Patch Changes
- Updated dependencies:
@trigger.dev/core@4.0.5
4.0.4
Patch Changes
- Updated dependencies:
@trigger.dev/core@4.0.4
4.0.3
Patch Changes
- Updated dependencies:
@trigger.dev/core@4.0.3
4.0.2
Patch Changes
- Updated dependencies:
@trigger.dev/core@4.0.2
4.0.1
Patch Changes
- Updated dependencies:
@trigger.dev/core@4.0.1
4.0.0
Major Changes
- Trigger.dev v4 release. Please see our upgrade to v4 docs to view the full changelog: https://trigger.dev/docs/upgrade-to-v4 (#1869)
Patch Changes
-
Run Engine 2.0 (alpha) (#1575)
-
Added the ability to specify a "createdAt" filter when subscribing to tags in our useRealtime hooks: (#2158)
// Only subscribe to runs created in the last 10 hours useRealtimeRunWithTags("my-tag", { createdAt: "10h" });You can also now choose to skip subscribing to specific columns by specifying the
skipColumnsoption:useRealtimeRun(run.id, { skipColumns: ["usageDurationMs"] }); -
Fixes an issue with realtime when re-subscribing to a run, that would temporarily display stale data and the changes. Now when re-subscribing to a run only the latest changes will be vended (#2162)
-
Updated dependencies:
@trigger.dev/core@4.0.0
4.0.0-v4-beta.28
Patch Changes
- Updated dependencies:
@trigger.dev/core@4.0.0-v4-beta.28
4.0.0-v4-beta.27
Patch Changes
- Updated dependencies:
@trigger.dev/core@4.0.0-v4-beta.27
4.0.0-v4-beta.26
Patch Changes
- Updated dependencies:
@trigger.dev/core@4.0.0-v4-beta.26
4.0.0-v4-beta.25
Patch Changes
- Updated dependencies:
@trigger.dev/core@4.0.0-v4-beta.25
4.0.0-v4-beta.24
Patch Changes
- Updated dependencies:
@trigger.dev/core@4.0.0-v4-beta.24
4.0.0-v4-beta.23
Patch Changes
- Updated dependencies:
@trigger.dev/core@4.0.0-v4-beta.23
4.0.0-v4-beta.22
Patch Changes
-
Added the ability to specify a "createdAt" filter when subscribing to tags in our useRealtime hooks: (#2158)
// Only subscribe to runs created in the last 10 hours useRealtimeRunWithTags("my-tag", { createdAt: "10h" });You can also now choose to skip subscribing to specific columns by specifying the
skipColumnsoption:useRealtimeRun(run.id, { skipColumns: ["usageDurationMs"] }); -
Fixes an issue with realtime when re-subscribing to a run, that would temporarily display stale data and the changes. Now when re-subscribing to a run only the latest changes will be vended (#2162)
-
Updated dependencies:
@trigger.dev/core@4.0.0-v4-beta.22
4.0.0-v4-beta.21
Patch Changes
- Updated dependencies:
@trigger.dev/core@4.0.0-v4-beta.21
4.0.0-v4-beta.20
Patch Changes
- Updated dependencies:
@trigger.dev/core@4.0.0-v4-beta.20
4.0.0-v4-beta.19
Patch Changes
- Updated dependencies:
@trigger.dev/core@4.0.0-v4-beta.19
4.0.0-v4-beta.18
Patch Changes
- Updated dependencies:
@trigger.dev/core@4.0.0-v4-beta.18
4.0.0-v4-beta.17
Patch Changes
- Updated dependencies:
@trigger.dev/core@4.0.0-v4-beta.17
4.0.0-v4-beta.16
Patch Changes
- Updated dependencies:
@trigger.dev/core@4.0.0-v4-beta.16
4.0.0-v4-beta.15
Patch Changes
- Updated dependencies:
@trigger.dev/core@4.0.0-v4-beta.15
4.0.0-v4-beta.14
Patch Changes
- Updated dependencies:
@trigger.dev/core@4.0.0-v4-beta.14
4.0.0-v4-beta.13
Patch Changes
- Updated dependencies:
@trigger.dev/core@4.0.0-v4-beta.13
4.0.0-v4-beta.12
Patch Changes
- Updated dependencies:
@trigger.dev/core@4.0.0-v4-beta.12
4.0.0-v4-beta.11
Patch Changes
- Updated dependencies:
@trigger.dev/core@4.0.0-v4-beta.11
4.0.0-v4-beta.10
Patch Changes
- Updated dependencies:
@trigger.dev/core@4.0.0-v4-beta.10
4.0.0-v4-beta.9
Patch Changes
- Updated dependencies:
@trigger.dev/core@4.0.0-v4-beta.9
4.0.0-v4-beta.8
Patch Changes
- Updated dependencies:
@trigger.dev/core@4.0.0-v4-beta.8
4.0.0-v4-beta.7
Patch Changes
- Updated dependencies:
@trigger.dev/core@4.0.0-v4-beta.7
4.0.0-v4-beta.6
Patch Changes
- Updated dependencies:
@trigger.dev/core@4.0.0-v4-beta.6
4.0.0-v4-beta.5
Patch Changes
- Updated dependencies:
@trigger.dev/core@4.0.0-v4-beta.5
4.0.0-v4-beta.4
Patch Changes
- Updated dependencies:
@trigger.dev/core@4.0.0-v4-beta.4
4.0.0-v4-beta.3
Patch Changes
- Updated dependencies:
@trigger.dev/core@4.0.0-v4-beta.3
4.0.0-v4-beta.2
Patch Changes
- Updated dependencies:
@trigger.dev/core@4.0.0-v4-beta.2
4.0.0-v4-beta.1
Patch Changes
- Updated dependencies:
@trigger.dev/core@4.0.0-v4-beta.1
4.0.0-v4-beta.0
Major Changes
- Trigger.dev v4 release. Please see our upgrade to v4 docs to view the full changelog: https://trigger.dev/docs/upgrade-to-v4 (#1869)
Patch Changes
- Run Engine 2.0 (alpha) (#1575)
- Updated dependencies:
@trigger.dev/core@4.0.0-v4-beta.0
3.3.17
Patch Changes
- Add support for two-phase deployments and task version pinning (#1739)
- Updated dependencies:
@trigger.dev/core@3.3.17
3.3.16
Patch Changes
- Updated dependencies:
@trigger.dev/core@3.3.16
3.3.15
Patch Changes
- Updated dependencies:
@trigger.dev/core@3.3.15
3.3.14
Patch Changes
- Updated dependencies:
@trigger.dev/core@3.3.14
3.3.13
Patch Changes
- Updated dependencies:
@trigger.dev/core@3.3.13
3.3.12
Patch Changes
- Updated dependencies:
@trigger.dev/core@3.3.12
3.3.11
Patch Changes
- Updated dependencies:
@trigger.dev/core@3.3.11
3.3.10
Patch Changes
- Make sure useRealtimeRun onComplete hook fires at the correct time (#1599)
- Handle errors thrown by requests in Realtime react hooks (#1599)
- Updated dependencies:
@trigger.dev/core@3.3.10
3.3.9
Patch Changes
- Adding ability to update parent run metadata from child runs/tasks (#1563)
- Updated dependencies:
@trigger.dev/core@3.3.9
3.3.8
Patch Changes
- Updated dependencies:
@trigger.dev/core@3.3.8
3.3.7
Patch Changes
- Now compatible with React 19 (#1559)
-
- Fixes an issue in streams where "chunks" could get split across multiple reads (#1549)
- Fixed stopping the run subscription after a run is finished, when using useRealtimeRun or useRealtimeRunWithStreams
- Added an
onCompletecallback touseRealtimeRunanduseRealtimeRunWithStreams - Optimized the run subscription to reduce unnecessary updates
- Updated dependencies:
@trigger.dev/core@3.3.7
3.3.6
Patch Changes
- Realtime streams now powered by electric. Also, this change fixes a realtime bug that was causing too many re-renders, even on records that didn't change (#1541)
- Updated dependencies:
@trigger.dev/core@3.3.6
3.3.5
Patch Changes
- Updated dependencies:
@trigger.dev/core@3.3.5
3.3.4
Patch Changes
- Add trigger options to all trigger hooks (#1528)
- Updated dependencies:
@trigger.dev/core@3.3.4
3.3.3
Patch Changes
- Updated dependencies:
@trigger.dev/core@3.3.3
3.3.2
Patch Changes
- Updated dependencies:
@trigger.dev/core@3.3.2
3.3.1
Patch Changes
- Public access token scopes with just tags or just a batch can now access runs that have those tags or are in the batch. Previously, the only way to access a run was to have a specific scope for that exact run. (#1511)
- Updated dependencies:
@trigger.dev/core@3.3.1
3.3.0
Minor Changes
-
Improved Batch Triggering: (#1502)
-
The new Batch Trigger endpoint is now asynchronous and supports up to 500 runs per request.
-
The new endpoint also supports triggering multiple different tasks in a single batch request (support in the SDK coming soon).
-
The existing
batchTriggermethod now supports the new endpoint, and shouldn't require any changes to your code. -
Idempotency keys now expire after 24 hours, and you can customize the expiration time when creating a new key by using the
idempotencyKeyTTLparameter:
await myTask.batchTrigger([{ payload: { foo: "bar" } }], { idempotencyKey: "my-key", idempotencyKeyTTL: "60s", }); // Works for individual items as well: await myTask.batchTrigger([ { payload: { foo: "bar" }, options: { idempotencyKey: "my-key", idempotencyKeyTTL: "60s" } }, ]); // And `trigger`: await myTask.trigger({ foo: "bar" }, { idempotencyKey: "my-key", idempotencyKeyTTL: "60s" });Breaking Changes
- We've removed the
idempotencyKeyoption fromtriggerAndWaitandbatchTriggerAndWait, because it can lead to permanently frozen runs in deployed tasks. We're working on upgrading our entire system to support idempotency keys on these methods, and we'll re-add the option once that's complete.
-
Patch Changes
- Added ability to subscribe to a batch of runs using runs.subscribeToBatch (#1502)
- Updated dependencies:
@trigger.dev/core@3.3.0
3.2.2
Patch Changes
- Updated dependencies:
@trigger.dev/core@3.2.2
3.2.1
Patch Changes
- React hooks now all accept accessToken and baseURL options so the use of the Provider is no longer necessary (#1486)
- Upgrade zod to latest (3.23.8) (#1484)
- Realtime streams (#1470)
- Updated dependencies:
@trigger.dev/core@3.2.1
3.2.0
Patch Changes
- Updated dependencies:
@trigger.dev/core@3.2.0
3.1.2
Patch Changes
- Updated dependencies:
@trigger.dev/core@3.1.2
3.1.1
Patch Changes
- useBatch renamed to useRealtimeBatch (#1447)
- Updated dependencies:
@trigger.dev/core@3.1.1
3.1.0
Minor Changes
- Access run status updates in realtime, from your server or from your frontend (#1402)
Patch Changes
- Updated dependencies:
@trigger.dev/core@3.1.0