Skip to content

v0.13.0: Merge pull request #200 from pandemicsyn/changeset-release/main

Choose a tag to compare

@github-actions github-actions released this 11 Nov 06:22
ec80ac7

Beachside v0.13.0

@beachside/adapter

Minor Changes

  • #194 f95dce3 Thanks @pandemicsyn! - Egress allowlists: set network: { allow: ["registry.npmjs.org", "*.github.com", "10.0.0.0/8"] } in adapter setup to let sandboxes reach only those hosts and IPv4 ranges. Supported on E2B, Vercel, Modal, Runloop, Archil (paid plans), Daytona (Tier 3+; hosts or ranges, not both) and Freestyle (IPv4 ranges only); where the provider reports the list back, the adapter checks it recorded exactly that list. Modal also gains network: "internet"; it previously always blocked egress.

  • #196 9e3ab39 Thanks @pandemicsyn! - Previews on more providers. Daytona's preview: { access: "public" } now returns an expiring signed URL for one port (preview.expiresInSeconds, default 1 hour) instead of rejecting, and previews gain an optional expiresAt. Modal gets box.preview(port): protected by default through a connect token sent as a bearer header, or public tunnels for preview.ports declared at create (public tunnels need network: "internet" or an allowlist, because Modal refuses open ports on a blocked network). Boat gets public previews through its host-port API.

  • #198 f89fde4 Thanks @pandemicsyn! - Add box.fork(), box.submitFork() and box.checkFork(). A fork copies a running sandbox with the provider's native fork; adapters without one reject with UNSUPPORTED, and Beachside never emulates a fork with a snapshot and restore. capabilities().fork reports what a fork keeps, how the source is interrupted, whether processes resume and whether the fork's lifecycle is independent. boxd, E2B and Archil fork natively with memory and running processes. Adapters declare a fork with the new sandboxFork session hook; uncertain forks recover through operation kind sandbox_fork.

beachside

Minor Changes

  • #194 f95dce3 Thanks @pandemicsyn! - Egress allowlists: set network: { allow: ["registry.npmjs.org", "*.github.com", "10.0.0.0/8"] } in adapter setup to let sandboxes reach only those hosts and IPv4 ranges. Supported on E2B, Vercel, Modal, Runloop, Archil (paid plans), Daytona (Tier 3+; hosts or ranges, not both) and Freestyle (IPv4 ranges only); where the provider reports the list back, the adapter checks it recorded exactly that list. Modal also gains network: "internet"; it previously always blocked egress.

  • #196 9e3ab39 Thanks @pandemicsyn! - Previews on more providers. Daytona's preview: { access: "public" } now returns an expiring signed URL for one port (preview.expiresInSeconds, default 1 hour) instead of rejecting, and previews gain an optional expiresAt. Modal gets box.preview(port): protected by default through a connect token sent as a bearer header, or public tunnels for preview.ports declared at create (public tunnels need network: "internet" or an allowlist, because Modal refuses open ports on a blocked network). Boat gets public previews through its host-port API.

  • #198 f89fde4 Thanks @pandemicsyn! - Add box.fork(), box.submitFork() and box.checkFork(). A fork copies a running sandbox with the provider's native fork; adapters without one reject with UNSUPPORTED, and Beachside never emulates a fork with a snapshot and restore. capabilities().fork reports what a fork keeps, how the source is interrupted, whether processes resume and whether the fork's lifecycle is independent. boxd, E2B and Archil fork natively with memory and running processes. Adapters declare a fork with the new sandboxFork session hook; uncertain forks recover through operation kind sandbox_fork.

Patch Changes

@beachside/daytona

Minor Changes

  • #194 f95dce3 Thanks @pandemicsyn! - Egress allowlists: set network: { allow: ["registry.npmjs.org", "*.github.com", "10.0.0.0/8"] } in adapter setup to let sandboxes reach only those hosts and IPv4 ranges. Supported on E2B, Vercel, Modal, Runloop, Archil (paid plans), Daytona (Tier 3+; hosts or ranges, not both) and Freestyle (IPv4 ranges only); where the provider reports the list back, the adapter checks it recorded exactly that list. Modal also gains network: "internet"; it previously always blocked egress.

  • #196 9e3ab39 Thanks @pandemicsyn! - Previews on more providers. Daytona's preview: { access: "public" } now returns an expiring signed URL for one port (preview.expiresInSeconds, default 1 hour) instead of rejecting, and previews gain an optional expiresAt. Modal gets box.preview(port): protected by default through a connect token sent as a bearer header, or public tunnels for preview.ports declared at create (public tunnels need network: "internet" or an allowlist, because Modal refuses open ports on a blocked network). Boat gets public previews through its host-port API.

Patch Changes

@beachside/e2b

Minor Changes

  • #193 473b891 Thanks @pandemicsyn! - E2B: upgrade to e2b@2.63.0 and support protected previews. With preview: { access: "protected" }, box.preview(port) now returns the sandbox's traffic token as an e2b-traffic-access-token header instead of rejecting.

    The connect call that returns the token uses the sandbox's observed remaining lifetime as its timeout, so a running sandbox's lifetime is unchanged; if the sandbox paused after the running check, E2B resumes it with that remaining lifetime and preview() rejects with CONFLICT.

    Compatibility: e2b@2.63.0 requires Node 22.19 or newer, so @beachside/e2b now declares engines.node >=22.19 (previously Node 20 worked).

  • #194 f95dce3 Thanks @pandemicsyn! - Egress allowlists: set network: { allow: ["registry.npmjs.org", "*.github.com", "10.0.0.0/8"] } in adapter setup to let sandboxes reach only those hosts and IPv4 ranges. Supported on E2B, Vercel, Modal, Runloop, Archil (paid plans), Daytona (Tier 3+; hosts or ranges, not both) and Freestyle (IPv4 ranges only); where the provider reports the list back, the adapter checks it recorded exactly that list. Modal also gains network: "internet"; it previously always blocked egress.

  • #198 f89fde4 Thanks @pandemicsyn! - Add box.fork(), box.submitFork() and box.checkFork(). A fork copies a running sandbox with the provider's native fork; adapters without one reject with UNSUPPORTED, and Beachside never emulates a fork with a snapshot and restore. capabilities().fork reports what a fork keeps, how the source is interrupted, whether processes resume and whether the fork's lifecycle is independent. boxd, E2B and Archil fork natively with memory and running processes. Adapters declare a fork with the new sandboxFork session hook; uncertain forks recover through operation kind sandbox_fork.

Patch Changes

@beachside/boxd

Minor Changes

  • #197 3ab2e60 Thanks @pandemicsyn! - boxd moves to @boxd-sh/sdk 0.3.0 and gains blocked egress, labels and regions. network now defaults to blocked, which sets the machine's native egress allowlist to none before Beachside hands it out; set network: "internet" (or BOXD_NETWORK=internet in the CLI) for open egress. create({ labels }) and restore({ labels }) set boxd machine labels, and sandboxes.list() returns them. A new region setting (BOXD_REGION in the CLI) sends machine, disk and snapshot calls to that boxd region.

  • #201 99d3d14 Thanks @pandemicsyn! - boxd egress allowlists: network: { allow: [...] } takes up to 256 host names, *. wildcards and public IPv4 addresses or ranges, through boxd's native egress allowlist. Restores now carry their egress in the machine spec, so blocked or the allowlist is in force from first boot, and creates, restores and forks write their expiry together with the machine. A list boxd refuses leaves the machine reaching nothing.

  • #198 f89fde4 Thanks @pandemicsyn! - Add box.fork(), box.submitFork() and box.checkFork(). A fork copies a running sandbox with the provider's native fork; adapters without one reject with UNSUPPORTED, and Beachside never emulates a fork with a snapshot and restore. capabilities().fork reports what a fork keeps, how the source is interrupted, whether processes resume and whether the fork's lifecycle is independent. boxd, E2B and Archil fork natively with memory and running processes. Adapters declare a fork with the new sandboxFork session hook; uncertain forks recover through operation kind sandbox_fork.

Patch Changes

  • #203 c22ed44 Thanks @pandemicsyn! - boxd is now a supported provider: it is out of experimental in the docs and is the landing page's default provider.

    File operations on an image without Python 3 now fail with a clear UNSUPPORTED error instead of an unknown outcome.

    makeDirectory on an existing file now rejects with INVALID_ARGUMENT and no effect, recursive or not, instead of an unknown outcome.

    Destroying a machine with writable disks now flushes and freezes them first, so the next machine can mount them (read-only mounts used to fail after an unclean stop). The docs explain that boxd ends background processes with the command that started them.

    Commands, file calls and processes on a suspended machine now fail with UNAVAILABLE instead of silently waking it, and readDirectory() reports symlinks exactly when the image has Python.

    File streams move 1 MiB pieces through boxd's native upload and download instead of 64 KiB through command output.

  • Updated dependencies [f95dce3, 9e3ab39, f89fde4]:

    • @beachside/adapter@0.13.0

@beachside/boat

Minor Changes

  • #196 9e3ab39 Thanks @pandemicsyn! - Previews on more providers. Daytona's preview: { access: "public" } now returns an expiring signed URL for one port (preview.expiresInSeconds, default 1 hour) instead of rejecting, and previews gain an optional expiresAt. Modal gets box.preview(port): protected by default through a connect token sent as a bearer header, or public tunnels for preview.ports declared at create (public tunnels need network: "internet" or an allowlist, because Modal refuses open ports on a blocked network). Boat gets public previews through its host-port API.

Patch Changes

@beachside/runloop

Minor Changes

  • #194 f95dce3 Thanks @pandemicsyn! - Egress allowlists: set network: { allow: ["registry.npmjs.org", "*.github.com", "10.0.0.0/8"] } in adapter setup to let sandboxes reach only those hosts and IPv4 ranges. Supported on E2B, Vercel, Modal, Runloop, Archil (paid plans), Daytona (Tier 3+; hosts or ranges, not both) and Freestyle (IPv4 ranges only); where the provider reports the list back, the adapter checks it recorded exactly that list. Modal also gains network: "internet"; it previously always blocked egress.

  • #195 4053134 Thanks @pandemicsyn! - Runloop: create({ labels }) and restore({ labels }) are now stored as Devbox metadata and returned by sandboxes.list(), so beachside gc --label works on Runloop. Keys starting with beachside_ stay reserved.

Patch Changes

@beachside/freestyle

Minor Changes

  • #194 f95dce3 Thanks @pandemicsyn! - Egress allowlists: set network: { allow: ["registry.npmjs.org", "*.github.com", "10.0.0.0/8"] } in adapter setup to let sandboxes reach only those hosts and IPv4 ranges. Supported on E2B, Vercel, Modal, Runloop, Archil (paid plans), Daytona (Tier 3+; hosts or ranges, not both) and Freestyle (IPv4 ranges only); where the provider reports the list back, the adapter checks it recorded exactly that list. Modal also gains network: "internet"; it previously always blocked egress.

Patch Changes

  • #205 d37c0c8 Thanks @pandemicsyn! - Freestyle is now a supported provider, out of experimental in the docs and on the landing page. makeDirectory on an existing file now rejects with INVALID_ARGUMENT and no effect, recursive or not, instead of an unknown outcome.
  • Updated dependencies [f95dce3, 9e3ab39, f89fde4]:
    • @beachside/adapter@0.13.0

@beachside/archil

Minor Changes

  • #194 f95dce3 Thanks @pandemicsyn! - Egress allowlists: set network: { allow: ["registry.npmjs.org", "*.github.com", "10.0.0.0/8"] } in adapter setup to let sandboxes reach only those hosts and IPv4 ranges. Supported on E2B, Vercel, Modal, Runloop, Archil (paid plans), Daytona (Tier 3+; hosts or ranges, not both) and Freestyle (IPv4 ranges only); where the provider reports the list back, the adapter checks it recorded exactly that list. Modal also gains network: "internet"; it previously always blocked egress.

  • #198 f89fde4 Thanks @pandemicsyn! - Add box.fork(), box.submitFork() and box.checkFork(). A fork copies a running sandbox with the provider's native fork; adapters without one reject with UNSUPPORTED, and Beachside never emulates a fork with a snapshot and restore. capabilities().fork reports what a fork keeps, how the source is interrupted, whether processes resume and whether the fork's lifecycle is independent. boxd, E2B and Archil fork natively with memory and running processes. Adapters declare a fork with the new sandboxFork session hook; uncertain forks recover through operation kind sandbox_fork.

Patch Changes

@beachside/modal

Minor Changes

  • #194 f95dce3 Thanks @pandemicsyn! - Egress allowlists: set network: { allow: ["registry.npmjs.org", "*.github.com", "10.0.0.0/8"] } in adapter setup to let sandboxes reach only those hosts and IPv4 ranges. Supported on E2B, Vercel, Modal, Runloop, Archil (paid plans), Daytona (Tier 3+; hosts or ranges, not both) and Freestyle (IPv4 ranges only); where the provider reports the list back, the adapter checks it recorded exactly that list. Modal also gains network: "internet"; it previously always blocked egress.

  • #196 9e3ab39 Thanks @pandemicsyn! - Previews on more providers. Daytona's preview: { access: "public" } now returns an expiring signed URL for one port (preview.expiresInSeconds, default 1 hour) instead of rejecting, and previews gain an optional expiresAt. Modal gets box.preview(port): protected by default through a connect token sent as a bearer header, or public tunnels for preview.ports declared at create (public tunnels need network: "internet" or an allowlist, because Modal refuses open ports on a blocked network). Boat gets public previews through its host-port API.

Patch Changes

@beachside/vercel

Minor Changes

  • #194 f95dce3 Thanks @pandemicsyn! - Egress allowlists: set network: { allow: ["registry.npmjs.org", "*.github.com", "10.0.0.0/8"] } in adapter setup to let sandboxes reach only those hosts and IPv4 ranges. Supported on E2B, Vercel, Modal, Runloop, Archil (paid plans), Daytona (Tier 3+; hosts or ranges, not both) and Freestyle (IPv4 ranges only); where the provider reports the list back, the adapter checks it recorded exactly that list. Modal also gains network: "internet"; it previously always blocked egress.

Patch Changes

@beachside/cli

Minor Changes

  • #197 3ab2e60 Thanks @pandemicsyn! - boxd moves to @boxd-sh/sdk 0.3.0 and gains blocked egress, labels and regions. network now defaults to blocked, which sets the machine's native egress allowlist to none before Beachside hands it out; set network: "internet" (or BOXD_NETWORK=internet in the CLI) for open egress. create({ labels }) and restore({ labels }) set boxd machine labels, and sandboxes.list() returns them. A new region setting (BOXD_REGION in the CLI) sends machine, disk and snapshot calls to that boxd region.

Patch Changes