sproutboat 0.14.0 → 0.16.0

package/CHANGELOG.md

@@ -10,6 +10,61 @@ maintained going forward by the `release` skill.
 
 ## Unreleased
 
+## [0.16.0] - 2026-10-10
+
+### Added
+
+- Proxy and revocable Proxy are accepted in handlers with Porffor alpha-16.
+  Native regression checks cover property traps, enumeration, callable and
+  constructible proxies, revocation, and frozen-property invariants.
+
+- `URLSearchParams` and `FormData` provide live keys, values and entries
+  iterators. `itty-router` 5.0.24 `IttyRouter` passes GET parameters, Unicode
+  POST bodies and a 404 fallback. A basic tRPC 11.19.0 server caller also works.
+
+### Changed
+
+- Pin Porffor alpha-16 (`43087d4`) through `@sproutboat/toolchain` 0.6.0
+  and `@sproutboat/runtime` 0.15.0. Collection iterator methods and `matchAll`
+  now return iterators. Typed-array `from`, `set` offset and `join` fixes are
+  supplied upstream, so their local source patches are removed.
+- Native output handles Unicode console strings, clamped-array ties round
+  to even, and class static initializers use the class as `this`.
+
+### Compatibility limits
+
+- Proxy support alone does not establish compatibility for every package.
+  `qs` 6.16.0 parses and serializes nested query data in a native HTTP probe.
+  Standard `itty-router` 5.0.24 `Router` still hits a labelled-break compiler
+  error. String iteration still splits astral characters into UTF-16 halves.
+
+
+## [0.15.0] - 2026-10-05
+
+### Changed
+
+- Sprouts compile with Porffor alpha-15 (`@sproutboat/toolchain` 0.5.0).
+  Async functions now compile to state machines, and `console.log` no longer
+  adds colour codes when its output is piped. The compatibility suite is
+  unchanged at 30/32, and binary size, compile time, start-up and throughput
+  are level with alpha-13.
+
+### Performance
+
+- Rebuilding after a small change is about 3 times faster: 2.1 to 2.4 s
+  instead of 6.8 to 7.7 s for the standalone example app. Builds now compile
+  from one path per project, so Porffor reuses the C units that didn't change.
+  Porffor's build directories that haven't been used for a week are removed;
+  they used to pile up without limit.
+
+### Fixed
+
+- Handlers using marked, or any bundled class whose static methods create
+  instances of the class itself, work again. Since 0.12.6 they failed with
+  `TypeError: value is not a constructor` (baronunread/sproutboat#256).
+- An ISO date's timezone offset could flip sign, so `-00:30` sometimes parsed
+  as `+00:30`, depending on what sat next to the string in memory.
+
 ## [0.14.0] - 2026-10-04
 
 ### Changed
@@ -804,7 +859,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.14.0...HEAD
+[Unreleased]: https://github.com/baronunread/sproutboat-cli/compare/v0.15.0...HEAD
+[0.15.0]: https://github.com/baronunread/sproutboat-cli/compare/v0.14.0...v0.15.0
 [0.14.0]: https://github.com/baronunread/sproutboat-cli/compare/v0.13.0...v0.14.0
 [0.13.0]: https://github.com/baronunread/sproutboat-cli/compare/v0.12.7...v0.13.0
 [0.12.7]: https://github.com/baronunread/sproutboat-cli/compare/v0.12.6...v0.12.7

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.14.0
+**Package:** `sproutboat` 0.16.0
 
 ## Commands
 
@@ -76,7 +76,7 @@ usage: sproutboat <init [name] | check [project-dir] | types [project-dir] | dev
 | | |
 | --- | --- |
 | Zig | `0.16.0` (`zig cc -target x86_64-linux-musl`, static) |
-| Provenance stamp | `zig-musl/0.16.0+porffor/547c781+uws/360c276d` |
+| Provenance stamp | `zig-musl/0.16.0+porffor/43087d4+uws/360c276d` |
 | Artifact schema | `2` |
 | Runtime | `native-fetch` |
 | Capability profile | `http-sync-v0` |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sproutboat",
-  "version": "0.14.0",
+  "version": "0.16.0",
   "description": "Wrangler-shaped CLI for Sproutboat. Deploys workers to any control plane via --api-url / SPROUTBOAT_API_URL.",
   "keywords": [
     "cli",
@@ -64,24 +64,24 @@
     "@sproutboat/artifact": "^0.3.0",
     "@sproutboat/assets": "^0.3.0",
     "@sproutboat/config": "^0.5.0",
-    "@sproutboat/runtime": "^0.14.0",
-    "@sproutboat/toolchain": "^0.4.24",
+    "@sproutboat/runtime": "^0.15.0",
+    "@sproutboat/toolchain": "^0.6.0",
     "@sproutboat/wire": "^0.11.0"
   },
   "devDependencies": {
-    "@oxlint/plugins": "1.81.0",
-    "@types/bun": "1.4.0",
+    "@oxlint/plugins": "1.85.0",
+    "@types/bun": "1.4.2",
     "cookie": "2.0.1",
-    "lefthook": "2.1.12",
-    "oxfmt": "0.66.0",
-    "oxlint": "1.81.0",
+    "lefthook": "2.1.14",
+    "oxfmt": "0.70.0",
+    "oxlint": "1.85.0",
     "typescript": "7.0.2"
   },
   "optionalDependencies": {
-    "@sproutboat/cli-darwin-arm64": "0.14.0",
-    "@sproutboat/cli-darwin-x64": "0.14.0",
-    "@sproutboat/cli-linux-arm64": "0.14.0",
-    "@sproutboat/cli-linux-x64": "0.14.0"
+    "@sproutboat/cli-darwin-arm64": "0.16.0",
+    "@sproutboat/cli-darwin-x64": "0.16.0",
+    "@sproutboat/cli-linux-arm64": "0.16.0",
+    "@sproutboat/cli-linux-x64": "0.16.0"
   },
   "engines": {
     "node": ">=18"

package/src/build.ts

@@ -248,24 +248,38 @@ export async function buildArtifact(input: BuildInput): Promise<BuildOutput> {
       const [sqliteObject, tls] = embedded
         ? await Promise.all([ensureSqliteObject({ target, zigBin }), ensureBearssl({ target, zigBin })])
         : [null, null];
-      await compileSprout({
-        sourcePath: input.sourcePath,
-        generatedPath: input.generatedPath,
-        generatedSource,
-        outPath,
-        vars: input.config.vars ?? {},
-        bindings,
-        zigBin,
-        target: input.target,
-        compatibilityDate: input.config.compatibility_date,
-        transport: input.transport,
-        appName: input.config.name,
-        assets: bakedAssets,
-        extraLink: [...(sqliteObject ? [sqliteObject] : []), ...(tls ? tls.objects : [])],
-        extraCflags: tls ? ["-I", tls.includeDir] : [],
-        optimize: input.optimize,
-        versionMetadata,
-      });
+      // Porffor caches compiled C units per entry path, so compile from one
+      // path per project and build shape: unchanged units (the uWebSockets
+      // server alone is ~1.75 s of clang) are reused instead of rebuilt, and
+      // Porffor keeps one build dir per shape instead of one per artifact.
+      const unitDir = resolve(
+        input.projectDir,
+        ".sproutboat/porffor-units",
+        `${input.target ?? "linux-x86_64"}-${input.transport ?? "broker"}-${input.optimize ?? "release"}`,
+      );
+      const unitLock = input.generatedPath ? null : await acquireArtifactLock(unitDir);
+      try {
+        await compileSprout({
+          sourcePath: input.sourcePath,
+          generatedPath: input.generatedPath ?? resolve(unitDir, "sprout.generated.js"),
+          generatedSource,
+          outPath,
+          vars: input.config.vars ?? {},
+          bindings,
+          zigBin,
+          target: input.target,
+          compatibilityDate: input.config.compatibility_date,
+          transport: input.transport,
+          appName: input.config.name,
+          assets: bakedAssets,
+          extraLink: [...(sqliteObject ? [sqliteObject] : []), ...(tls ? tls.objects : [])],
+          extraCflags: tls ? ["-I", tls.includeDir] : [],
+          optimize: input.optimize,
+          versionMetadata,
+        });
+      } finally {
+        if (unitLock) await rm(unitLock, { recursive: true, force: true });
+      }
     };
     let compileCache: BuildOutput["compileCache"] = "bypass";
     const compileStartedAt = performance.now();

package/src/compile.ts

@@ -10,7 +10,8 @@
  * unusable it stops with its specific integrity or archive error. Contributors
  * may explicitly opt into Porffor's source fallback.
  */
-import { chmod, mkdir, readFile, rm, writeFile } from "node:fs/promises";
+import { chmod, mkdir, readdir, readFile, rm, stat, writeFile } from "node:fs/promises";
+import { homedir } from "node:os";
 import { dirname, resolve } from "node:path";
 import { ensurePorfforPatched } from "./patch-porffor";
 import { ensureUWebSockets, ensureUWebSocketsHost, resolveHostCompiler, UwsUnavailableError } from "./toolchain";
@@ -113,6 +114,32 @@ export async function loadPrelude(transport: Transport = "broker"): Promise<stri
   return core.replace(TRANSPORT_MARKER, chosen);
 }
 
+let porfforBuildsPruned = false;
+/**
+ * Porffor writes one build dir per entry path under ~/.cache/porffor/build and
+ * never removes any (one machine had 1,395 of them, 6.3 GB). Drop the ones not
+ * compiled in for a week; the only cost is a recompile. Each dir's `flags`
+ * stamp is rewritten on every compile, so its mtime is "last used".
+ */
+export async function prunePorfforBuilds(
+  root = resolve(process.env.HOME ?? homedir(), ".cache/porffor/build"),
+  now = Date.now(),
+): Promise<number> {
+  porfforBuildsPruned = true;
+  const cutoff = now - 7 * 24 * 60 * 60 * 1000;
+  const entries: string[] = await readdir(root).catch(() => []);
+  let removed = 0;
+  for (const name of entries) {
+    const dir = resolve(root, name);
+    const used = (await stat(resolve(dir, "flags")).catch(() => null)) ?? (await stat(dir).catch(() => null));
+    if (used && used.mtimeMs < cutoff) {
+      await rm(dir, { recursive: true, force: true });
+      removed++;
+    }
+  }
+  return removed;
+}
+
 /** Child env for the Porffor run. `SB_EXTRA_LINK` is read by the patched link
  *  step (#15) and is absent entirely for a normal build. `cc`/`cxx` override
  *  Porffor's own `CC`/`CXX` read for a **host** build (musl builds hardcode
@@ -191,6 +218,9 @@ export async function compileSprout(input: CompileInput): Promise<void> {
     }
   }
 
+  // Once per process, in the background: housekeeping must never slow a build.
+  if (!porfforBuildsPruned) void prunePorfforBuilds().catch(() => {});
+
   const outDir = dirname(input.outPath);
   await mkdir(outDir, { recursive: true });
   // The artifact dir is content-addressed, so rebuilding unchanged source lands