sproutboat 0.33.0 → 0.34.0

package/CHANGELOG.md

@@ -10,6 +10,28 @@ maintained going forward by the `release` skill.
 
 ## Unreleased
 
+## [0.34.0] - 2026-10-26
+
+Built on `@sproutboat/runtime` 0.33.0, `@sproutboat/toolchain` 0.17.0 and
+`@sproutboat/wire` 0.20.1.
+
+### Added
+
+- **WebSockets from compatibility date 2026-10-30.** `WebSocketPair`, `WebSocket`
+  (`accept`, `send`, `close`, listeners), `new Response(null, { status: 101, webSocket })`,
+  `response.webSocket`, `WebSocketRequestResponsePair`, and the Durable Object hibernation API
+  (`acceptWebSocket`, `getWebSockets`, `getTags`, auto-responses, attachments,
+  `webSocketMessage` and `webSocketClose`). Behaviour follows workerd. Sockets reaching a client
+  are carried by sproutd (B19); a standalone executable or the platform answers a 101 with 501
+  for now, while a pair whose ends both stay in the worker (a Worker and its Durable Object)
+  works everywhere. Outbound `new WebSocket(url)` is not supported yet.
+- Streamed request bodies on sproutd (B19), from compatibility date 2026-10-27.
+
+### Changed
+
+- `types/sproutboat.d.ts` declares the WebSocket types and the hibernation handlers.
+- The toolchain moves to 0.17.0, so compiled apps get a new fingerprint and rebuild once.
+
 ## [0.33.0] - 2026-10-25
 
 Built on `@sproutboat/runtime` 0.32.0, `@sproutboat/wire` 0.20.0 and

package/README.md

@@ -168,7 +168,8 @@ Windows, build from WSL.
 ## Limits
 
 Capability profile `http-sync-v0`: one synchronous `fetch` handler, optional
-`scheduled` / `queue` handlers, no streaming, no WebSockets. Binding values are
+`scheduled` / `queue` handlers. WebSockets (from compatibility date 2026-10-30) need
+a host that carries them (sproutd). Binding values are
 text/JSON, one at a time over a 32 MiB loopback frame. Sprout uploads cap at
 16 MiB, assets at 64 MiB / 4096 files.
 

package/SURFACE.md

@@ -3,7 +3,7 @@
 > Generated by `src/surface.test.ts` from `src/surface.ts` + the pinned
 > toolchain constants. Do not edit by hand — run `UPDATE_SURFACE=1 bun test`.
 
-**Package:** `sproutboat` 0.33.0
+**Package:** `sproutboat` 0.34.0
 
 ## Commands
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sproutboat",
-  "version": "0.33.0",
+  "version": "0.34.0",
   "description": "Wrangler-shaped CLI for Sproutboat. Deploys workers to any control plane via --api-url / SPROUTBOAT_API_URL.",
   "keywords": [
     "cli",
@@ -64,9 +64,9 @@
     "@sproutboat/artifact": "^0.3.0",
     "@sproutboat/assets": "^0.3.0",
     "@sproutboat/config": "^0.6.0",
-    "@sproutboat/runtime": "^0.32.0",
-    "@sproutboat/toolchain": "^0.16.1",
-    "@sproutboat/wire": "^0.20.0"
+    "@sproutboat/runtime": "^0.33.0",
+    "@sproutboat/toolchain": "^0.17.0",
+    "@sproutboat/wire": "^0.20.1"
   },
   "devDependencies": {
     "@oxlint/plugins": "1.85.0",
@@ -78,10 +78,10 @@
     "typescript": "7.0.2"
   },
   "optionalDependencies": {
-    "@sproutboat/cli-darwin-arm64": "0.33.0",
-    "@sproutboat/cli-darwin-x64": "0.33.0",
-    "@sproutboat/cli-linux-arm64": "0.33.0",
-    "@sproutboat/cli-linux-x64": "0.33.0"
+    "@sproutboat/cli-darwin-arm64": "0.34.0",
+    "@sproutboat/cli-darwin-x64": "0.34.0",
+    "@sproutboat/cli-linux-arm64": "0.34.0",
+    "@sproutboat/cli-linux-x64": "0.34.0"
   },
   "engines": {
     "node": ">=18"

package/types/sproutboat.d.ts

@@ -272,6 +272,46 @@ declare global {
     id: DurableObjectId;
     /** Synchronous, like every other binding. */
     storage: DurableObjectStorage;
+    /**
+     * The WebSocket hibernation API, from compatibility date 2026-10-30. Messages and
+     * closes on an accepted socket go to the class's `webSocketMessage` and
+     * `webSocketClose`. On sproutd an open socket keeps the app's worker running.
+     */
+    acceptWebSocket(ws: WebSocket, tags?: string[]): void;
+    getWebSockets(tag?: string): WebSocket[];
+    getTags(ws: WebSocket): string[];
+    setWebSocketAutoResponse(pair?: WebSocketRequestResponsePair): void;
+    getWebSocketAutoResponse(): WebSocketRequestResponsePair | null;
+  }
+
+  // ---------------------------------------------------------- WebSockets
+
+  /**
+   * From compatibility date 2026-10-30, as in workerd. Return the client end in a
+   * `new Response(null, { status: 101, webSocket: client })` and talk on the server end.
+   * Client sockets are carried by sproutd; a standalone or platform sprout answers a 101
+   * with 501 for now. Inbound messages are capped at 32 MiB (1009 above it). Outbound
+   * WebSockets (`new WebSocket(url)`) are not supported.
+   */
+  class WebSocketPair {
+    0: WebSocket;
+    1: WebSocket;
+  }
+  class WebSocketRequestResponsePair {
+    constructor(request: string, response: string);
+    readonly request: string;
+    readonly response: string;
+  }
+  interface ResponseInit {
+    webSocket?: WebSocket | null;
+  }
+  interface Response {
+    readonly webSocket: WebSocket | null;
+  }
+  interface WebSocket {
+    accept(): void;
+    serializeAttachment(value: unknown): void;
+    deserializeAttachment(): unknown;
   }
 
   // -------------------------------------------------- Analytics Engine
@@ -366,6 +406,9 @@ declare global {
     fetch(request: Request): Response | Promise<Response>;
     /** Runs after `storage.setAlarm`, with no request in flight. */
     alarm?(): void | Promise<void>;
+    /** A message on a socket taken with `state.acceptWebSocket` (from 2026-10-30). */
+    webSocketMessage?(ws: WebSocket, message: string | ArrayBuffer): void | Promise<void>;
+    webSocketClose?(ws: WebSocket, code: number, reason: string, wasClean: boolean): void | Promise<void>;
   }
 
   // ------------------------------------------------------- Version metadata