Packages

@trigger.dev/sdk

4.8.8 · 20 Nov 2026MIT1.7M / weekRepositoryHomepagenpmAtom feed

Upgrading @trigger.dev/sdk From 3.3.17 to 4.0.0

1 release in betweenevery note read

Other targets from 3.3.17Latest4.8.8
  1. 3.3.17yours
  2. 4.0.0target
  3. 28 pre

Start here

Before you upgrade

Tick each one off as you go
  • Breaking4.0.0
  • Breaking4.0.0
  • Breaking4.0.0
  • Breaking4.0.0
  • Deprecated4.0.0

Release by release

  1. 4.0.0

    Migration needed18 Aug 20258 new · 7 fixes
    • Breaking

      Trigger.dev v4 release. Please see our upgrade to v4 docs to view the full changelog: trigger.dev/docs/upgrade-to-v4

    • Breaking

      Removed deprecated properties from ctx

    • Breaking

      Concurrency is never released when a run is first blocked via a waitpoint, at either the env or queue level.

    • Breaking

      Concurrency is always released when a run is checkpointed and shutdown, at both the env and queue level.

8 other lines we could not sort, mostly version bumps
  • The envvars.list() and retrieve() functions receive isSecret for each value. Secret values are always redacted.

    4.0.0
  • Display clickable links in Cursor terminal

    4.0.0
  • Provide realtime skipColumns option via untamperable public access tokens

    4.0.0
  • Removed triggerAndPoll. It was never recommended so it's been removed.

    4.0.0
  • Improve metadata flushing efficiency by collapsing operations

    4.0.0
  • Upgrade to zod 3.25.76

    4.0.0
  • Specify a region override when triggering a run

    4.0.0
  • Maintain proper context in metadata.root and parent getters

    4.0.0

1 internal line (docs, tests, tooling) left out.

A whole project to check? Paste its package.json in the dependency check: every deprecated, outdated or vulnerable dependency, with what to upgrade to. Free, no account.