sproutboat 0.12.0 → 0.12.1

package/CHANGELOG.md

@@ -10,6 +10,25 @@ maintained going forward by the `release` skill.
 
 ## Unreleased
 
+## [0.12.1] - 2026-09-30
+
+### Fixed
+
+- `sproutboat` with no arguments linked the platform repository and said to
+  use `bunx`, not `npx`. The CLI has shipped as a self-contained binary since
+  0.11.0, so `npx` works; the help now links https://docs.sproutboat.com.
+- Handler types now declare `batch.ackAll()`/`retryAll()`, per-message
+  `delaySeconds` in `sendBatch()` and D1 `raw()`, matching the runtime.
+  Comments that said direct R2 uploads are unavailable standalone, and that an
+  un-acked queue message is redelivered, are corrected.
+
+### Changed
+
+- `examples/runtime-comparison` runs one Worker-style app on Node, workerd and
+  a standalone Sproutboat binary and checks every response;
+  `benchmarks/v0.12.0` holds the first tagged run, which sproutboat.com
+  renders.
+
 ## [0.12.0] - 2026-09-28
 
 ### Added
@@ -639,7 +658,8 @@ its own package.
 - Renamed the package to `sproutboat` (was `@sproutboat/cli`); dropped the
   `sprout` bin alias in favour of a user-defined shell alias.
 
-[Unreleased]: https://github.com/baronunread/sproutboat-cli/compare/v0.12.0...HEAD
+[Unreleased]: https://github.com/baronunread/sproutboat-cli/compare/v0.12.1...HEAD
+[0.12.1]: https://github.com/baronunread/sproutboat-cli/compare/v0.12.0...v0.12.1
 [0.12.0]: https://github.com/baronunread/sproutboat-cli/compare/v0.11.13...v0.12.0
 [0.11.13]: https://github.com/baronunread/sproutboat-cli/compare/v0.11.12...v0.11.13
 [0.11.12]: https://github.com/baronunread/sproutboat-cli/compare/v0.11.11...v0.11.12

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.12.0 · runs on Bun (use `bunx`, not `npx`)
+**Package:** `sproutboat` 0.12.1
 
 ## Commands
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sproutboat",
-  "version": "0.12.0",
+  "version": "0.12.1",
   "description": "Wrangler-shaped CLI for Sproutboat. Deploys workers to any control plane via --api-url / SPROUTBOAT_API_URL.",
   "keywords": [
     "cli",
@@ -78,10 +78,10 @@
     "typescript": "7.0.2"
   },
   "optionalDependencies": {
-    "@sproutboat/cli-darwin-arm64": "0.12.0",
-    "@sproutboat/cli-darwin-x64": "0.12.0",
-    "@sproutboat/cli-linux-arm64": "0.12.0",
-    "@sproutboat/cli-linux-x64": "0.12.0"
+    "@sproutboat/cli-darwin-arm64": "0.12.1",
+    "@sproutboat/cli-darwin-x64": "0.12.1",
+    "@sproutboat/cli-linux-arm64": "0.12.1",
+    "@sproutboat/cli-linux-x64": "0.12.1"
   },
   "engines": {
     "node": ">=18"

package/src/surface.ts

@@ -7,7 +7,7 @@ import { bold, dim, leaf } from "./style";
 
 export const CLI_NAME = "sproutboat";
 export const TAGLINE = "Deploy JavaScript handlers as tiny native binaries on your own VPS.";
-export const REPO_URL = "https://github.com/baronunread/sproutboat";
+export const DOCS_URL = "https://docs.sproutboat.com";
 
 export type Group = "Develop" | "Ship" | "Storage" | "Configure" | "Account";
 
@@ -356,7 +356,7 @@ export function helpText(): string {
   lines.push(
     "",
     dim(`Run \`${CLI_NAME} <command>\` with no/invalid args to see that command's full usage.`),
-    dim(`Docs: ${REPO_URL}  ·  runs on Bun — use \`bunx\`, not \`npx\`.`),
+    dim(`Docs: ${DOCS_URL}`),
   );
   return lines.join("\n");
 }

package/types/sproutboat.d.ts

@@ -52,6 +52,8 @@ declare global {
     /** The first row, or one column of it when named. `null` if there are none. */
     first<T = Record<string, unknown>>(): T | null;
     first<T = unknown>(column: string): T | null;
+    /** Rows as arrays of column values. */
+    raw<T = unknown[]>(): T[];
   }
 
   interface D1Database {
@@ -81,8 +83,8 @@ declare global {
     httpMetadata: R2HttpMetadata;
     customMetadata?: Record<string, string>;
     /**
-     * The object as a string. A get holds the object whole in memory, so keep
-     * downloads small until native download tickets are available.
+     * The object as a string. A get holds the object whole in memory, so serve
+     * large objects with `createDownloadUrl` instead.
      *
      * `new Response(obj.body, ...)` corrupts any non-ASCII/binary content: the
      * runtime cannot tell these bytes apart from a string a handler built, so
@@ -159,9 +161,9 @@ declare global {
     createMultipartUpload(key: string, options?: R2PutOptions): R2MultipartUpload;
     /** Reconstructs a multipart handle after storing its key and upload id. */
     resumeMultipartUpload(key: string, uploadId: string): R2MultipartUpload;
-    /** Broker-backed direct PUT. Not available in native standalone mode yet. */
+    /** Direct PUT to a one-use URL, streamed to storage without passing through the handler. */
     createUploadUrl(key: string, options?: R2UploadTicketOptions): R2TransferTicket;
-    /** Broker-backed direct GET or HEAD, including Range. */
+    /** Direct GET or HEAD from a one-use URL, including Range. */
     createDownloadUrl(key: string, options?: R2DownloadTicketOptions): R2TransferTicket;
     get(key: string): R2Object | null;
     /** Metadata without the body. */
@@ -179,14 +181,14 @@ declare global {
   interface Queue<Body = unknown> {
     /** Returns immediately. The batch reaches `queue()` out of band. */
     send(body: Body, options?: QueueSendOptions): void;
-    sendBatch(messages: Array<{ body: Body }>): void;
+    sendBatch(messages: Array<{ body: Body; delaySeconds?: number }>): void;
   }
 
   interface QueueMessage<Body = unknown> {
     id: string;
     timestamp: number;
     body: Body;
-    /** Mark as handled. Without this the message is redelivered. */
+    /** Mark as handled. A message neither acked nor retried counts as acked. */
     ack(): void;
     /** Hand it back for another attempt. */
     retry(): void;
@@ -195,6 +197,8 @@ declare global {
   interface MessageBatch<Body = unknown> {
     queue: string;
     messages: Array<QueueMessage<Body>>;
+    ackAll(): void;
+    retryAll(): void;
   }
 
   // --------------------------------------------------- Durable Objects
@@ -273,8 +277,8 @@ declare global {
    *
    * `crypto.scryptVerify` is a Sproutboat extension (#153), not WebCrypto: it
    * re-derives a scrypt hash and compares it in constant time, for migrating
-   * password hashes made by Node/Bun `scrypt`. Verify-only on purpose; new
-   * credentials should use HMAC/PBKDF2 via `crypto.subtle`.
+   * password hashes made by Node/Bun `scrypt`. Verify-only on purpose; derive
+   * new credentials with HMAC via `crypto.subtle`.
    */
   interface Crypto {
     scryptVerify(