feat(bankai): bankai v10 — the isomorphic compiler & server on Vite 8

One command, zero config, and only the client ever bundles: v8 server code is plain ESM that Node runs as-authored, so there is no server build to rot (the lesson of v9). - start: Vite middleware mode + HMR with per-request streaming SSR via ssrLoadModule; a virtual client entry generates the browser glue so the user writes exactly one isomorphic module (plan decision D5). - build: client bundle via Vite 8/Rolldown, manifest-derived route assets in dist/bankai.json, service worker built with the precache list injected (choo-service-worker convention, manifest edition), brotli+gzip precompression of every text asset. - serve: immutable caching + precompressed negotiation for hashed assets, 103 Early Hints (res.writeEarlyHints) with the route's assets before every page, streaming SSR, and a window.initialState tail with script-breakout-safe serialization and choo internals filtered out. - inspect: raw/gzip/brotli size report. Integration tests drive the real counter example through build and serve, asserting the 103 interim response at the HTTP level. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_014NgfSjHE11oFpoSnLVKLXd
2026-09-08 19:32:37 +02:00
parent d755af5ca0
commit 7e08b585ac
13 changed files with 716 additions and 1 deletions
@@ -0,0 +1,116 @@
+// bankai serve — the production server. Static assets from dist
+// (precompressed variants negotiated, hashed assets cached forever);
+// everything else is a page: 103 Early Hints from the build manifest,
+// then streaming SSR of the entry module — imported natively, because
+// the server side never needed a build.
+
+import { createServer } from 'node:http'
+import { createReadStream } from 'node:fs'
+import { readFile, stat } from 'node:fs/promises'
+import { join, normalize, extname, resolve } from 'node:path'
+import { pathToFileURL } from 'node:url'
+
+import { resolveApp } from './app.js'
+import { documentHead, documentTail, assetLinks } from './document.js'
+
+const MIME = {
+  '.html': 'text/html; charset=utf-8',
+  '.js': 'text/javascript; charset=utf-8',
+  '.mjs': 'text/javascript; charset=utf-8',
+  '.css': 'text/css; charset=utf-8',
+  '.json': 'application/json; charset=utf-8',
+  '.svg': 'image/svg+xml',
+  '.map': 'application/json',
+  '.txt': 'text/plain; charset=utf-8',
+  '.woff2': 'font/woff2',
+  '.png': 'image/png',
+  '.webp': 'image/webp',
+  '.ico': 'image/x-icon'
+}
+
+export default async function serve ({ outDir = 'dist', port = 8080 }) {
+  outDir = resolve(outDir)
+  const meta = JSON.parse(await readFile(join(outDir, 'bankai.json'), 'utf8'))
+  const mod = await import(pathToFileURL(meta.entry))
+  const links = assetLinks(meta.assets)
+
+  const server = createServer(async (req, res) => {
+    const url = new URL(req.url, 'http://localhost')
+    const pathname = decodeURIComponent(url.pathname)
+
+    // static asset?
+    const file = normalize(join(outDir, pathname))
+    if (file.startsWith(outDir) && extname(pathname)) {
+      if (await isFile(file)) return sendFile(req, res, file, pathname)
+      if (MIME[extname(pathname)]) {
+        // a missing asset is a miss, not a page
+        res.writeHead(404, { 'content-type': 'text/plain' })
+        return res.end('not found: ' + pathname)
+      }
+    }
+
+    // page: hints first, then stream
+    try {
+      const app = resolveApp(mod, meta.entry)
+      const state = {}
+
+      if (links.length && res.writeEarlyHints) {
+        res.writeEarlyHints({ link: links })
+      }
+      res.writeHead(200, {
+        'content-type': 'text/html; charset=utf-8',
+        link: links.join(', ')
+      })
+      res.write(documentHead({ title: meta.title, ...meta.assets }))
+      for await (const chunk of app.toStream(req.url, state)) {
+        res.write(chunk)
+      }
+      res.end(documentTail(state))
+    } catch (err) {
+      console.error(err)
+      if (!res.headersSent) res.writeHead(500, { 'content-type': 'text/plain' })
+      res.end('bankai: render error')
+    }
+  })
+
+  await new Promise((resolveListen) => server.listen(port, resolveListen))
+  return {
+    server,
+    port: server.address().port,
+    origin: `http://localhost:${server.address().port}`,
+    close: () => new Promise((resolveClose) => server.close(resolveClose))
+  }
+}
+
+async function isFile (path) {
+  try {
+    return (await stat(path)).isFile()
+  } catch (e) {
+    return false
+  }
+}
+
+async function sendFile (req, res, file, pathname) {
+  const headers = {
+    'content-type': MIME[extname(file)] || 'application/octet-stream',
+    // hashed build assets are immutable; everything else revalidates
+    'cache-control': pathname.startsWith('/assets/')
+      ? 'public, max-age=31536000, immutable'
+      : 'no-cache',
+    vary: 'accept-encoding'
+  }
+
+  // negotiate precompressed siblings written at build time
+  const accepted = String(req.headers['accept-encoding'] || '')
+  for (const [encoding, ext] of [['br', '.br'], ['gzip', '.gz']]) {
+    if (accepted.includes(encoding) && await isFile(file + ext)) {
+      headers['content-encoding'] = encoding
+      res.writeHead(200, headers)
+      createReadStream(file + ext).pipe(res)
+      return
+    }
+  }
+
+  res.writeHead(200, headers)
+  createReadStream(file).pipe(res)
+}