Packages

@cloudflare/sandbox

1.0.3 · 22 Oct 2026Apache-2.02.1M / weekRepositoryHomepagenpmAtom feed

Upgrading @cloudflare/sandbox From 0.11.0 to 0.12.0

1 release in betweenevery note read

Reading releases, release notes and advisories…

Other targets from 0.11.0Newest 0.x0.12.14Latest1.0.3
  1. 0.11.0yours
  2. 0.12.0target
1
change to make
0
advisories fixed
1
new
2
fixes

Before you upgrade

Tick each one off as you go
  • Breaking0.12.0

Release by release

  1. 0.12.0

    Migration needed8 Jun 20261 new · 2 fixes
    • Breaking

      Remove the desktop client API and desktop Docker image variant. The sandbox.desktop APIs, DesktopClient exports, desktop-related types/errors, and -desktop container image are no longer available.

    • New

      Add credentialProxy option to mountBucket to keep real S3 credentials out of the container. When enabled, the Durable Object intercepts and signs outbound S3 requests — the container only sees dummy credentials. Supports S3-compatible endpoints, R2, and GCS HMAC signing, with optimized R2 mount defaults for reliable read and write performance.

    • Fixed

      Fix bucket mounts when a Sandbox class defines a catch-all outbound handler by routing SDK-managed mount hosts through the SDK ContainerProxy.

    • Fixed

      Fix phantom running processes after a failed startProcess call. When the underlying session was unavailable or threw during startup, the process record was left in memory with status running and would appear in listProcesses() indefinitely. Failed startups are now correctly marked as terminal error records.

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.