@rsc-kit/core 0.18.1 → 0.20.0

package/dist/clientPackages.js

@@ -0,0 +1,234 @@
+// Dependencies with "use client" files that plugin-rsc would leave external.
+//
+// plugin-rsc bundles a dependency into the server graphs - and so sees its
+// directives - only when the dependency declares react as a peer. That is
+// the right signal for a library written for React. It misses the package
+// that imports react and never says so: a component wrapper generated by a
+// tool, a workspace package with react under dependencies, a published
+// package whose author forgot. Left external, its "use client" is a string
+// nobody reads, the rsc environment loads it under the react-server
+// condition, and the first useState inside it fails at render with an error
+// that names React and not the package.
+//
+// So the direct dependencies are read once at config time: any that plugin-rsc
+// would not bundle, and that carries a "use client" directive in one of its
+// files, is bundled here. Direct dependencies only - a directive two levels
+// down is the concern of the package between, which declared it.
+import { existsSync, readdirSync, readFileSync, realpathSync, statSync, openSync, readSync, closeSync } from "node:fs";
+import { dirname, join } from "node:path";
+/** A directive at the top of a file: comments may precede it, code may not. */
+const DIRECTIVE = /^(?:\s|\/\/[^\n]*\n|\/\*[\s\S]*?\*\/)*(?:'use client'|"use client")\s*;?/;
+const SOURCE = /\.(?:m?js|cjs|jsx)$/;
+/** The most files read per package before giving up: a bound, not a budget. */
+const FILE_CAP = 3000;
+/** Enough of a file to hold a licence header and the directive after it. */
+const HEAD_BYTES = 2048;
+/** The packages plugin-rsc handles itself, and this one. */
+const OWN = new Set(["react", "react-dom", "react-server-dom-webpack", "@vitejs/plugin-rsc"]);
+function readJson(path) {
+    try {
+        return JSON.parse(readFileSync(path, "utf8"));
+    }
+    catch {
+        return null;
+    }
+}
+/** Where `name` is installed, walking up from `from` the way resolution does. */
+export function packageDir(name, from) {
+    let dir = from;
+    for (;;) {
+        const candidate = join(dir, "node_modules", name);
+        if (existsSync(join(candidate, "package.json")))
+            return candidate;
+        const parent = dirname(dir);
+        if (parent === dir)
+            return null;
+        dir = parent;
+    }
+}
+function realpathOf(path) {
+    try {
+        return realpathSync(path);
+    }
+    catch {
+        return path;
+    }
+}
+function headOf(path) {
+    const fd = openSync(path, "r");
+    try {
+        const buffer = Buffer.alloc(HEAD_BYTES);
+        const read = readSync(fd, buffer, 0, HEAD_BYTES, 0);
+        return buffer.toString("utf8", 0, read);
+    }
+    finally {
+        closeSync(fd);
+    }
+}
+/** Whether any source file under `dir` opens with "use client". */
+export function hasClientDirective(dir) {
+    return someSourceFile(dir, (path) => DIRECTIVE.test(headOf(path)));
+}
+/** An import of react-dom's server renderer, static or dynamic, ESM or CJS. */
+const SERVER_RENDERER_IMPORT = /["']react-dom\/server(?:\.[a-z]+)?["']/;
+/** The largest file worth reading whole for an import: a bundled dist, not a data table. */
+const WHOLE_FILE_CAP = 512 * 1024;
+/**
+ * Whether any source file under `dir` imports react-dom/server.
+ *
+ * For a dependency left external where server components render: its
+ * imports are never resolved by the build, so the renderer stub that names
+ * the app file for a direct import never sees this one. @react-email/render
+ * is the usual case - an action imports it, the build says nothing, and the
+ * first call throws React's refusal at a visitor.
+ */
+export function importsServerRenderer(dir) {
+    return someSourceFile(dir, (path) => {
+        try {
+            if (statSync(path).size > WHOLE_FILE_CAP)
+                return false;
+            return SERVER_RENDERER_IMPORT.test(readFileSync(path, "utf8"));
+        }
+        catch {
+            return false;
+        }
+    });
+}
+/** Whether `test` holds for some source file under `dir`, within the cap. */
+function someSourceFile(dir, test) {
+    const pending = [dir];
+    let seen = 0;
+    while (pending.length) {
+        const current = pending.pop();
+        let entries;
+        try {
+            entries = readdirSync(current);
+        }
+        catch {
+            continue;
+        }
+        for (const entry of entries) {
+            if (entry === "node_modules" || entry.startsWith("."))
+                continue;
+            const path = join(current, entry);
+            let stat;
+            try {
+                stat = statSync(path);
+            }
+            catch {
+                continue;
+            }
+            if (stat.isDirectory()) {
+                pending.push(path);
+                continue;
+            }
+            if (!SOURCE.test(entry))
+                continue;
+            if (++seen > FILE_CAP)
+                return false;
+            try {
+                if (test(path))
+                    return true;
+            }
+            catch {
+                // Unreadable is neither.
+            }
+        }
+    }
+    return false;
+}
+/** Whether a package says it uses React, as a peer or as a dependency. */
+function usesReact(manifest) {
+    return !!manifest && ("react" in (manifest.peerDependencies ?? {}) || "react" in (manifest.dependencies ?? {}));
+}
+/**
+ * The dependencies of a bundled package that use React, and theirs.
+ *
+ * Bundling the package that carries the directive is not enough: the
+ * runtime it calls into - @stencil/react-output-target under a generated
+ * wrapper - is its own package, with react as a peer, and plugin-rsc's
+ * crawl never reached it because it only descends through packages that
+ * declared React. Left external, that runtime loads React through Node
+ * while everything else gets it through Vite: two copies, and the hooks
+ * dispatcher is null in one of them. Every React-using dependency under
+ * a bundled package is bundled with it.
+ */
+function reactDependenciesOf(dir, into, seen) {
+    const manifest = readJson(join(dir, "package.json"));
+    for (const name of Object.keys(manifest?.dependencies ?? {})) {
+        if (OWN.has(name) || seen.has(name))
+            continue;
+        seen.add(name);
+        // From where the package really is: under Bun's store a symlink in the
+        // app's node_modules points into .bun/<pkg>@<v>/node_modules/<pkg>, and
+        // the dependency sits beside it there, not beside the symlink.
+        const depDir = packageDir(name, realpathOf(dir));
+        if (!depDir || !usesReact(readJson(join(depDir, "package.json"))))
+            continue;
+        into.add(name);
+        reactDependenciesOf(depDir, into, seen);
+    }
+}
+/**
+ * Where a package is, anywhere in the project's dependency graph.
+ *
+ * For a polyfill a dependency of a dependency needs: not hoisted to the
+ * project under a strict store, so not resolvable from the project by
+ * name, and still what has to be evaluated first. A breadth-first walk of
+ * the manifests, from each package's real path, bounded in depth. The
+ * entry file is what `main` names, or index.js.
+ */
+export function packageEntryInGraph(root, name, depth = 5) {
+    const seen = new Set();
+    let frontier = [root];
+    for (let level = 0; level <= depth && frontier.length; level++) {
+        const next = [];
+        for (const dir of frontier) {
+            const found = packageDir(name, realpathOf(dir));
+            if (found) {
+                const manifest = readJson(join(found, "package.json"));
+                const entry = join(found, manifest?.main ?? "index.js");
+                return existsSync(entry) ? entry : existsSync(entry + ".js") ? entry + ".js" : null;
+            }
+            const manifest = readJson(join(dir, "package.json"));
+            for (const dep of Object.keys(manifest?.dependencies ?? {})) {
+                if (seen.has(dep))
+                    continue;
+                seen.add(dep);
+                const depDir = packageDir(dep, realpathOf(dir));
+                if (depDir)
+                    next.push(depDir);
+            }
+        }
+        frontier = next;
+    }
+    return null;
+}
+/**
+ * The direct dependencies of the project at `root` that plugin-rsc would
+ * leave external and that carry a "use client" file - and the React-using
+ * dependencies under each, which have to be bundled with it.
+ */
+export function clientPackages(root) {
+    const own = readJson(join(root, "package.json"));
+    if (!own?.dependencies)
+        return [];
+    const found = new Set();
+    for (const name of Object.keys(own.dependencies)) {
+        if (OWN.has(name) || name.startsWith("@rsc-kit/"))
+            continue;
+        const dir = packageDir(name, root);
+        if (!dir)
+            continue;
+        const manifest = readJson(join(dir, "package.json"));
+        // plugin-rsc's own rule: react as a peer, and the package is bundled already.
+        if (manifest?.peerDependencies && "react" in manifest.peerDependencies)
+            continue;
+        if (!hasClientDirective(dir))
+            continue;
+        found.add(name);
+        reactDependenciesOf(dir, found, new Set([name]));
+    }
+    return [...found].sort();
+}
+//# sourceMappingURL=clientPackages.js.map

package/dist/clientPackages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clientPackages.js","sourceRoot":"","sources":["../src/clientPackages.ts"],"names":[],"mappings":"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","sourcesContent":["// Dependencies with \"use client\" files that plugin-rsc would leave external.\n//\n// plugin-rsc bundles a dependency into the server graphs - and so sees its\n// directives - only when the dependency declares react as a peer. That is\n// the right signal for a library written for React. It misses the package\n// that imports react and never says so: a component wrapper generated by a\n// tool, a workspace package with react under dependencies, a published\n// package whose author forgot. Left external, its \"use client\" is a string\n// nobody reads, the rsc environment loads it under the react-server\n// condition, and the first useState inside it fails at render with an error\n// that names React and not the package.\n//\n// So the direct dependencies are read once at config time: any that plugin-rsc\n// would not bundle, and that carries a \"use client\" directive in one of its\n// files, is bundled here. Direct dependencies only - a directive two levels\n// down is the concern of the package between, which declared it.\n\nimport { existsSync, readdirSync, readFileSync, realpathSync, statSync, openSync, readSync, closeSync } from \"node:fs\";\nimport { dirname, join } from \"node:path\";\n\n/** A directive at the top of a file: comments may precede it, code may not. */\nconst DIRECTIVE = /^(?:\\s|\\/\\/[^\\n]*\\n|\\/\\*[\\s\\S]*?\\*\\/)*(?:'use client'|\"use client\")\\s*;?/;\n\nconst SOURCE = /\\.(?:m?js|cjs|jsx)$/;\n\n/** The most files read per package before giving up: a bound, not a budget. */\nconst FILE_CAP = 3000;\n\n/** Enough of a file to hold a licence header and the directive after it. */\nconst HEAD_BYTES = 2048;\n\n/** The packages plugin-rsc handles itself, and this one. */\nconst OWN = new Set([\"react\", \"react-dom\", \"react-server-dom-webpack\", \"@vitejs/plugin-rsc\"]);\n\ninterface PackageJson {\n  name?: string;\n  dependencies?: Record<string, string>;\n  peerDependencies?: Record<string, string>;\n}\n\nfunction readJson(path: string): PackageJson | null {\n  try {\n    return JSON.parse(readFileSync(path, \"utf8\")) as PackageJson;\n  } catch {\n    return null;\n  }\n}\n\n/** Where `name` is installed, walking up from `from` the way resolution does. */\nexport function packageDir(name: string, from: string): string | null {\n  let dir = from;\n\n  for (;;) {\n    const candidate = join(dir, \"node_modules\", name);\n\n    if (existsSync(join(candidate, \"package.json\"))) return candidate;\n\n    const parent = dirname(dir);\n\n    if (parent === dir) return null;\n\n    dir = parent;\n  }\n}\n\nfunction realpathOf(path: string): string {\n  try {\n    return realpathSync(path);\n  } catch {\n    return path;\n  }\n}\n\nfunction headOf(path: string): string {\n  const fd = openSync(path, \"r\");\n\n  try {\n    const buffer = Buffer.alloc(HEAD_BYTES);\n    const read = readSync(fd, buffer, 0, HEAD_BYTES, 0);\n\n    return buffer.toString(\"utf8\", 0, read);\n  } finally {\n    closeSync(fd);\n  }\n}\n\n/** Whether any source file under `dir` opens with \"use client\". */\nexport function hasClientDirective(dir: string): boolean {\n  return someSourceFile(dir, (path) => DIRECTIVE.test(headOf(path)));\n}\n\n/** An import of react-dom's server renderer, static or dynamic, ESM or CJS. */\nconst SERVER_RENDERER_IMPORT = /[\"']react-dom\\/server(?:\\.[a-z]+)?[\"']/;\n\n/** The largest file worth reading whole for an import: a bundled dist, not a data table. */\nconst WHOLE_FILE_CAP = 512 * 1024;\n\n/**\n * Whether any source file under `dir` imports react-dom/server.\n *\n * For a dependency left external where server components render: its\n * imports are never resolved by the build, so the renderer stub that names\n * the app file for a direct import never sees this one. @react-email/render\n * is the usual case - an action imports it, the build says nothing, and the\n * first call throws React's refusal at a visitor.\n */\nexport function importsServerRenderer(dir: string): boolean {\n  return someSourceFile(dir, (path) => {\n    try {\n      if (statSync(path).size > WHOLE_FILE_CAP) return false;\n\n      return SERVER_RENDERER_IMPORT.test(readFileSync(path, \"utf8\"));\n    } catch {\n      return false;\n    }\n  });\n}\n\n/** Whether `test` holds for some source file under `dir`, within the cap. */\nfunction someSourceFile(dir: string, test: (path: string) => boolean): boolean {\n  const pending = [dir];\n  let seen = 0;\n\n  while (pending.length) {\n    const current = pending.pop()!;\n    let entries: string[];\n\n    try {\n      entries = readdirSync(current);\n    } catch {\n      continue;\n    }\n\n    for (const entry of entries) {\n      if (entry === \"node_modules\" || entry.startsWith(\".\")) continue;\n\n      const path = join(current, entry);\n      let stat;\n\n      try {\n        stat = statSync(path);\n      } catch {\n        continue;\n      }\n\n      if (stat.isDirectory()) {\n        pending.push(path);\n        continue;\n      }\n\n      if (!SOURCE.test(entry)) continue;\n      if (++seen > FILE_CAP) return false;\n\n      try {\n        if (test(path)) return true;\n      } catch {\n        // Unreadable is neither.\n      }\n    }\n  }\n\n  return false;\n}\n\n/** Whether a package says it uses React, as a peer or as a dependency. */\nfunction usesReact(manifest: PackageJson | null): boolean {\n  return !!manifest && (\"react\" in (manifest.peerDependencies ?? {}) || \"react\" in (manifest.dependencies ?? {}));\n}\n\n/**\n * The dependencies of a bundled package that use React, and theirs.\n *\n * Bundling the package that carries the directive is not enough: the\n * runtime it calls into - @stencil/react-output-target under a generated\n * wrapper - is its own package, with react as a peer, and plugin-rsc's\n * crawl never reached it because it only descends through packages that\n * declared React. Left external, that runtime loads React through Node\n * while everything else gets it through Vite: two copies, and the hooks\n * dispatcher is null in one of them. Every React-using dependency under\n * a bundled package is bundled with it.\n */\nfunction reactDependenciesOf(dir: string, into: Set<string>, seen: Set<string>): void {\n  const manifest = readJson(join(dir, \"package.json\"));\n\n  for (const name of Object.keys(manifest?.dependencies ?? {})) {\n    if (OWN.has(name) || seen.has(name)) continue;\n\n    seen.add(name);\n\n    // From where the package really is: under Bun's store a symlink in the\n    // app's node_modules points into .bun/<pkg>@<v>/node_modules/<pkg>, and\n    // the dependency sits beside it there, not beside the symlink.\n    const depDir = packageDir(name, realpathOf(dir));\n\n    if (!depDir || !usesReact(readJson(join(depDir, \"package.json\")))) continue;\n\n    into.add(name);\n    reactDependenciesOf(depDir, into, seen);\n  }\n}\n\n/**\n * Where a package is, anywhere in the project's dependency graph.\n *\n * For a polyfill a dependency of a dependency needs: not hoisted to the\n * project under a strict store, so not resolvable from the project by\n * name, and still what has to be evaluated first. A breadth-first walk of\n * the manifests, from each package's real path, bounded in depth. The\n * entry file is what `main` names, or index.js.\n */\nexport function packageEntryInGraph(root: string, name: string, depth = 5): string | null {\n  const seen = new Set<string>();\n  let frontier = [root];\n\n  for (let level = 0; level <= depth && frontier.length; level++) {\n    const next: string[] = [];\n\n    for (const dir of frontier) {\n      const found = packageDir(name, realpathOf(dir));\n\n      if (found) {\n        const manifest = readJson(join(found, \"package.json\")) as (PackageJson & { main?: string }) | null;\n        const entry = join(found, manifest?.main ?? \"index.js\");\n\n        return existsSync(entry) ? entry : existsSync(entry + \".js\") ? entry + \".js\" : null;\n      }\n\n      const manifest = readJson(join(dir, \"package.json\"));\n\n      for (const dep of Object.keys(manifest?.dependencies ?? {})) {\n        if (seen.has(dep)) continue;\n\n        seen.add(dep);\n\n        const depDir = packageDir(dep, realpathOf(dir));\n\n        if (depDir) next.push(depDir);\n      }\n    }\n\n    frontier = next;\n  }\n\n  return null;\n}\n\n/**\n * The direct dependencies of the project at `root` that plugin-rsc would\n * leave external and that carry a \"use client\" file - and the React-using\n * dependencies under each, which have to be bundled with it.\n */\nexport function clientPackages(root: string): string[] {\n  const own = readJson(join(root, \"package.json\"));\n\n  if (!own?.dependencies) return [];\n\n  const found = new Set<string>();\n\n  for (const name of Object.keys(own.dependencies)) {\n    if (OWN.has(name) || name.startsWith(\"@rsc-kit/\")) continue;\n\n    const dir = packageDir(name, root);\n\n    if (!dir) continue;\n\n    const manifest = readJson(join(dir, \"package.json\"));\n\n    // plugin-rsc's own rule: react as a peer, and the package is bundled already.\n    if (manifest?.peerDependencies && \"react\" in manifest.peerDependencies) continue;\n\n    if (!hasClientDirective(dir)) continue;\n\n    found.add(name);\n    reactDependenciesOf(dir, found, new Set([name]));\n  }\n\n  return [...found].sort();\n}\n"]}

package/dist/compress.d.ts

@@ -0,0 +1,12 @@
+/** Whether this answer is one to compress at all. */
+export declare function shouldCompress(request: Request, response: Response): boolean;
+/**
+ * The response, gzipped if the request accepts it and the answer is worth it.
+ *
+ * `storedKey` names an answer the build wrote - the same bytes for every
+ * visitor - so it is compressed once and kept; everything else is streamed
+ * through the compressor as it is produced.
+ */
+export declare function compressed(request: Request, response: Response, storedKey?: string): Promise<Response>;
+/** For a test, or a redeploy that reuses the process: forget the stored bytes. */
+export declare function forgetCompressed(): void;

package/dist/compress.js

@@ -0,0 +1,134 @@
+// Compression for what the host answers, where nothing in front of it will.
+//
+// Behind Cloudflare, Vercel or nginx the platform compresses and this never
+// runs. A bun or node server answering the internet by itself sent every
+// byte raw - a 90 kB document and 145 kB of stylesheet at their full size -
+// and that alone was the mobile Lighthouse regression a port measured:
+// first paint at 3.8 s where 1.2 s was the baseline. Public assets are
+// precompressed by the build and served by Nitro with their encoding; the
+// pages, payloads, stored answers and api routes come through here.
+//
+// gzip, flushed on every chunk. A streamed page is a shell followed by the
+// holes as they fill, and a compressor left to its own buffer would hold
+// the shell back until enough had accumulated - so each write is flushed
+// out, which costs a little ratio and keeps the stream a stream.
+import { deflate } from "./compressRuntime.js";
+/** What is worth compressing: text of every kind, and the formats that are text. */
+const COMPRESSIBLE = /^(?:text\/|application\/(?:json|javascript|xml|manifest\+json|rss\+xml|atom\+xml)|image\/svg\+xml)/i;
+/** Answers too small to be worth a compressor's frame. */
+const MIN_BYTES = 1024;
+/** Stored answers, compressed once: the same bytes go to every visitor who accepts gzip. */
+const stored = new Map();
+const STORED_CAP = 1000;
+function acceptsGzip(request) {
+    const accept = request.headers.get("accept-encoding") ?? "";
+    return /(?:^|,)\s*(?:gzip|\*)\s*(?:;\s*q=(?!0(?:\.0*)?\s*(?:,|$)))?/i.test(accept);
+}
+/** Whether this answer is one to compress at all. */
+export function shouldCompress(request, response) {
+    if (response.body === null || request.method === "HEAD")
+        return false;
+    if (response.status === 204 || response.status === 304 || response.status < 200)
+        return false;
+    if (response.headers.has("content-encoding"))
+        return false;
+    if (/\bno-transform\b/i.test(response.headers.get("cache-control") ?? ""))
+        return false;
+    if (!COMPRESSIBLE.test(response.headers.get("content-type") ?? ""))
+        return false;
+    const length = Number(response.headers.get("content-length"));
+    if (Number.isFinite(length) && length > 0 && length < MIN_BYTES)
+        return false;
+    return acceptsGzip(request);
+}
+function withEncoding(response, body) {
+    const headers = new Headers(response.headers);
+    headers.set("Content-Encoding", "gzip");
+    headers.delete("Content-Length");
+    const vary = headers.get("Vary");
+    if (!vary)
+        headers.set("Vary", "Accept-Encoding");
+    else if (!/\baccept-encoding\b/i.test(vary) && vary.trim() !== "*")
+        headers.set("Vary", vary + ", Accept-Encoding");
+    return new Response(body, { status: response.status, statusText: response.statusText, headers });
+}
+/**
+ * The response, gzipped if the request accepts it and the answer is worth it.
+ *
+ * `storedKey` names an answer the build wrote - the same bytes for every
+ * visitor - so it is compressed once and kept; everything else is streamed
+ * through the compressor as it is produced.
+ */
+export async function compressed(request, response, storedKey) {
+    if (!shouldCompress(request, response))
+        return response;
+    const gzip = await deflate();
+    if (!gzip)
+        return response;
+    if (storedKey !== undefined) {
+        let bytes = stored.get(storedKey);
+        if (!bytes) {
+            bytes = await gzip.whole(new Uint8Array(await response.arrayBuffer()));
+            if (stored.size >= STORED_CAP)
+                stored.clear();
+            stored.set(storedKey, bytes);
+        }
+        return withEncoding(response, bytes);
+    }
+    // A Response made from a string or JSON carries no Content-Length for the
+    // check above to read, so the body is peeked: what arrives before the
+    // first kilobyte decides. An answer that ends inside it - /api/health, a
+    // 15-byte "ok" - goes out as it was; anything longer is compressed from
+    // its first byte, the peeked part included, and keeps streaming.
+    const reader = response.body.getReader();
+    const peeked = [];
+    let size = 0;
+    let ended = false;
+    while (size < MIN_BYTES) {
+        const { done, value } = await reader.read();
+        if (done) {
+            ended = true;
+            break;
+        }
+        peeked.push(value);
+        size += value.byteLength;
+    }
+    if (ended) {
+        return new Response(size === 0 ? null : concat(peeked, size), {
+            status: response.status,
+            statusText: response.statusText,
+            headers: response.headers,
+        });
+    }
+    const rest = new ReadableStream({
+        start(controller) {
+            for (const chunk of peeked)
+                controller.enqueue(chunk);
+        },
+        async pull(controller) {
+            const { done, value } = await reader.read();
+            if (done)
+                controller.close();
+            else
+                controller.enqueue(value);
+        },
+        cancel(reason) {
+            return reader.cancel(reason);
+        },
+    });
+    return withEncoding(response, gzip.stream(rest));
+}
+function concat(chunks, size) {
+    const out = new Uint8Array(size);
+    let at = 0;
+    for (const chunk of chunks) {
+        out.set(chunk, at);
+        at += chunk.byteLength;
+    }
+    return out;
+}
+/** For a test, or a redeploy that reuses the process: forget the stored bytes. */
+export function forgetCompressed() {
+    stored.clear();
+}
+//# sourceMappingURL=compress.js.map

package/dist/compress.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compress.js","sourceRoot":"","sources":["../src/compress.ts"],"names":[],"mappings":"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","sourcesContent":["// Compression for what the host answers, where nothing in front of it will.\n//\n// Behind Cloudflare, Vercel or nginx the platform compresses and this never\n// runs. A bun or node server answering the internet by itself sent every\n// byte raw - a 90 kB document and 145 kB of stylesheet at their full size -\n// and that alone was the mobile Lighthouse regression a port measured:\n// first paint at 3.8 s where 1.2 s was the baseline. Public assets are\n// precompressed by the build and served by Nitro with their encoding; the\n// pages, payloads, stored answers and api routes come through here.\n//\n// gzip, flushed on every chunk. A streamed page is a shell followed by the\n// holes as they fill, and a compressor left to its own buffer would hold\n// the shell back until enough had accumulated - so each write is flushed\n// out, which costs a little ratio and keeps the stream a stream.\n\nimport { deflate } from \"./compressRuntime.js\";\n\n/** What is worth compressing: text of every kind, and the formats that are text. */\nconst COMPRESSIBLE = /^(?:text\\/|application\\/(?:json|javascript|xml|manifest\\+json|rss\\+xml|atom\\+xml)|image\\/svg\\+xml)/i;\n\n/** Answers too small to be worth a compressor's frame. */\nconst MIN_BYTES = 1024;\n\n/** Stored answers, compressed once: the same bytes go to every visitor who accepts gzip. */\nconst stored = new Map<string, Uint8Array>();\n\nconst STORED_CAP = 1000;\n\nfunction acceptsGzip(request: Request): boolean {\n  const accept = request.headers.get(\"accept-encoding\") ?? \"\";\n\n  return /(?:^|,)\\s*(?:gzip|\\*)\\s*(?:;\\s*q=(?!0(?:\\.0*)?\\s*(?:,|$)))?/i.test(accept);\n}\n\n/** Whether this answer is one to compress at all. */\nexport function shouldCompress(request: Request, response: Response): boolean {\n  if (response.body === null || request.method === \"HEAD\") return false;\n  if (response.status === 204 || response.status === 304 || response.status < 200) return false;\n  if (response.headers.has(\"content-encoding\")) return false;\n  if (/\\bno-transform\\b/i.test(response.headers.get(\"cache-control\") ?? \"\")) return false;\n  if (!COMPRESSIBLE.test(response.headers.get(\"content-type\") ?? \"\")) return false;\n\n  const length = Number(response.headers.get(\"content-length\"));\n\n  if (Number.isFinite(length) && length > 0 && length < MIN_BYTES) return false;\n\n  return acceptsGzip(request);\n}\n\nfunction withEncoding(response: Response, body: BodyInit): Response {\n  const headers = new Headers(response.headers);\n\n  headers.set(\"Content-Encoding\", \"gzip\");\n  headers.delete(\"Content-Length\");\n\n  const vary = headers.get(\"Vary\");\n\n  if (!vary) headers.set(\"Vary\", \"Accept-Encoding\");\n  else if (!/\\baccept-encoding\\b/i.test(vary) && vary.trim() !== \"*\") headers.set(\"Vary\", vary + \", Accept-Encoding\");\n\n  return new Response(body, { status: response.status, statusText: response.statusText, headers });\n}\n\n/**\n * The response, gzipped if the request accepts it and the answer is worth it.\n *\n * `storedKey` names an answer the build wrote - the same bytes for every\n * visitor - so it is compressed once and kept; everything else is streamed\n * through the compressor as it is produced.\n */\nexport async function compressed(\n  request: Request,\n  response: Response,\n  storedKey?: string,\n): Promise<Response> {\n  if (!shouldCompress(request, response)) return response;\n\n  const gzip = await deflate();\n\n  if (!gzip) return response;\n\n  if (storedKey !== undefined) {\n    let bytes = stored.get(storedKey);\n\n    if (!bytes) {\n      bytes = await gzip.whole(new Uint8Array(await response.arrayBuffer()));\n\n      if (stored.size >= STORED_CAP) stored.clear();\n\n      stored.set(storedKey, bytes);\n    }\n\n    return withEncoding(response, bytes as unknown as BodyInit);\n  }\n\n  // A Response made from a string or JSON carries no Content-Length for the\n  // check above to read, so the body is peeked: what arrives before the\n  // first kilobyte decides. An answer that ends inside it - /api/health, a\n  // 15-byte \"ok\" - goes out as it was; anything longer is compressed from\n  // its first byte, the peeked part included, and keeps streaming.\n  const reader = response.body!.getReader();\n  const peeked: Uint8Array[] = [];\n  let size = 0;\n  let ended = false;\n\n  while (size < MIN_BYTES) {\n    const { done, value } = await reader.read();\n\n    if (done) {\n      ended = true;\n      break;\n    }\n\n    peeked.push(value);\n    size += value.byteLength;\n  }\n\n  if (ended) {\n    return new Response(size === 0 ? null : (concat(peeked, size) as unknown as BodyInit), {\n      status: response.status,\n      statusText: response.statusText,\n      headers: response.headers,\n    });\n  }\n\n  const rest = new ReadableStream<Uint8Array>({\n    start(controller) {\n      for (const chunk of peeked) controller.enqueue(chunk);\n    },\n    async pull(controller) {\n      const { done, value } = await reader.read();\n\n      if (done) controller.close();\n      else controller.enqueue(value);\n    },\n    cancel(reason) {\n      return reader.cancel(reason);\n    },\n  });\n\n  return withEncoding(response, gzip.stream(rest));\n}\n\nfunction concat(chunks: Uint8Array[], size: number): Uint8Array {\n  const out = new Uint8Array(size);\n  let at = 0;\n\n  for (const chunk of chunks) {\n    out.set(chunk, at);\n    at += chunk.byteLength;\n  }\n\n  return out;\n}\n\n/** For a test, or a redeploy that reuses the process: forget the stored bytes. */\nexport function forgetCompressed(): void {\n  stored.clear();\n}\n"]}

package/dist/compressRuntime.d.ts

@@ -0,0 +1,8 @@
+export interface Deflater {
+    /** One buffer in, one out: for an answer known whole. */
+    whole(bytes: Uint8Array): Promise<Uint8Array>;
+    /** A stream through the compressor, every chunk flushed as it arrives. */
+    stream(body: ReadableStream<Uint8Array>): ReadableStream<Uint8Array>;
+}
+/** The runtime's compressor, or null where there is none. */
+export declare function deflate(): Promise<Deflater | null>;

package/dist/compressRuntime.js

@@ -0,0 +1,62 @@
+// The compressor, from whichever runtime has one.
+//
+// node:zlib on Node and Bun - imported once, lazily, so the host loads on a
+// Worker (which has no zlib and needs none: the platform compresses) and
+// simply answers uncompressed there. Not the web CompressionStream: neither
+// runtime lets a caller flush it per chunk, and a streamed page held back
+// in a compressor's buffer is a page that stopped streaming.
+let loading = null;
+function onWorkers() {
+    return typeof navigator !== "undefined" && navigator.userAgent === "Cloudflare-Workers";
+}
+function deflaterFrom(zlib) {
+    return {
+        whole(bytes) {
+            return new Promise((resolve, reject) => {
+                zlib.gzip(bytes, (error, out) => (error ? reject(error) : resolve(new Uint8Array(out))));
+            });
+        },
+        stream(body) {
+            const gz = zlib.createGzip({ flush: zlib.constants.Z_SYNC_FLUSH });
+            const reader = body.getReader();
+            return new ReadableStream({
+                start(controller) {
+                    gz.on("data", (chunk) => controller.enqueue(new Uint8Array(chunk)));
+                    gz.on("end", () => controller.close());
+                    gz.on("error", (error) => controller.error(error));
+                    void (async () => {
+                        try {
+                            for (;;) {
+                                const { done, value } = await reader.read();
+                                if (done)
+                                    break;
+                                // Back-pressure from the compressor: wait for drain rather
+                                // than queueing an unbounded amount in front of it.
+                                if (!gz.write(value))
+                                    await new Promise((resolve) => gz.once("drain", resolve));
+                            }
+                            gz.end();
+                        }
+                        catch (error) {
+                            gz.destroy(error);
+                        }
+                    })();
+                },
+                cancel(reason) {
+                    gz.destroy();
+                    return reader.cancel(reason);
+                },
+            });
+        },
+    };
+}
+/** The runtime's compressor, or null where there is none. */
+export function deflate() {
+    if (loading)
+        return loading;
+    loading = onWorkers()
+        ? Promise.resolve(null)
+        : import("node:zlib").then((zlib) => deflaterFrom(zlib), () => null);
+    return loading;
+}
+//# sourceMappingURL=compressRuntime.js.map

package/dist/compressRuntime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compressRuntime.js","sourceRoot":"","sources":["../src/compressRuntime.ts"],"names":[],"mappings":"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","sourcesContent":["// The compressor, from whichever runtime has one.\n//\n// node:zlib on Node and Bun - imported once, lazily, so the host loads on a\n// Worker (which has no zlib and needs none: the platform compresses) and\n// simply answers uncompressed there. Not the web CompressionStream: neither\n// runtime lets a caller flush it per chunk, and a streamed page held back\n// in a compressor's buffer is a page that stopped streaming.\n\nexport interface Deflater {\n  /** One buffer in, one out: for an answer known whole. */\n  whole(bytes: Uint8Array): Promise<Uint8Array>;\n  /** A stream through the compressor, every chunk flushed as it arrives. */\n  stream(body: ReadableStream<Uint8Array>): ReadableStream<Uint8Array>;\n}\n\ntype Zlib = typeof import(\"node:zlib\");\n\nlet loading: Promise<Deflater | null> | null = null;\n\nfunction onWorkers(): boolean {\n  return typeof navigator !== \"undefined\" && navigator.userAgent === \"Cloudflare-Workers\";\n}\n\nfunction deflaterFrom(zlib: Zlib): Deflater {\n  return {\n    whole(bytes) {\n      return new Promise((resolve, reject) => {\n        zlib.gzip(bytes, (error, out) => (error ? reject(error) : resolve(new Uint8Array(out))));\n      });\n    },\n\n    stream(body) {\n      const gz = zlib.createGzip({ flush: zlib.constants.Z_SYNC_FLUSH });\n      const reader = body.getReader();\n\n      return new ReadableStream<Uint8Array>({\n        start(controller) {\n          gz.on(\"data\", (chunk: Buffer) => controller.enqueue(new Uint8Array(chunk)));\n          gz.on(\"end\", () => controller.close());\n          gz.on(\"error\", (error: Error) => controller.error(error));\n\n          void (async () => {\n            try {\n              for (;;) {\n                const { done, value } = await reader.read();\n\n                if (done) break;\n\n                // Back-pressure from the compressor: wait for drain rather\n                // than queueing an unbounded amount in front of it.\n                if (!gz.write(value)) await new Promise<void>((resolve) => gz.once(\"drain\", resolve));\n              }\n\n              gz.end();\n            } catch (error) {\n              gz.destroy(error as Error);\n            }\n          })();\n        },\n        cancel(reason) {\n          gz.destroy();\n\n          return reader.cancel(reason);\n        },\n      });\n    },\n  };\n}\n\n/** The runtime's compressor, or null where there is none. */\nexport function deflate(): Promise<Deflater | null> {\n  if (loading) return loading;\n\n  loading = onWorkers()\n    ? Promise.resolve(null)\n    : import(\"node:zlib\").then(\n        (zlib) => deflaterFrom(zlib),\n        () => null,\n      );\n\n  return loading;\n}\n"]}

package/dist/files.d.ts

@@ -24,7 +24,27 @@ export declare function prerenderedFrom(dir: string): (name: string) => Promise<
  * this host has no filesystem to have frozen it on. Every page renders live,
  * which is what happens today everywhere.
  */
+/**
+ * Where a compiled binary puts the frozen pages.
+ *
+ * `bun build --compile` embeds what is imported statically and nothing a
+ * computed import names, so the walk below finds no directory and no
+ * module inside a binary. The build writes `compile.mjs` beside the
+ * server: it imports the inline module by name - which embeds it - and
+ * hands the pages over here before importing the server. Shared as a
+ * global under a registered symbol, because the wrapper and this module
+ * are bundled apart.
+ */
+export declare const EMBEDDED_PAGES: unique symbol;
 export declare function prerenderedBeside(moduleUrl: string, dirName: string, levels?: number): (name: string) => Promise<string | null>;
+/**
+ * The entry a binary is compiled from, written beside the server.
+ *
+ * Two imports, in this order: the inline module first, so its pages are
+ * handed over before the server's first request; the server second. Bun
+ * embeds both. `bun build --compile .output/server/compile.mjs`.
+ */
+export declare function compileEntrySource(dirName: string): string;
 /** The name the build writes the inline module under, beside the stored pages' directory. */
 export declare function inlineModuleName(dirName: string): string;
 /**

package/dist/files.js

@@ -96,9 +96,28 @@ export function prerenderedFrom(dir) {
  * this host has no filesystem to have frozen it on. Every page renders live,
  * which is what happens today everywhere.
  */
+/**
+ * Where a compiled binary puts the frozen pages.
+ *
+ * `bun build --compile` embeds what is imported statically and nothing a
+ * computed import names, so the walk below finds no directory and no
+ * module inside a binary. The build writes `compile.mjs` beside the
+ * server: it imports the inline module by name - which embeds it - and
+ * hands the pages over here before importing the server. Shared as a
+ * global under a registered symbol, because the wrapper and this module
+ * are bundled apart.
+ */
+export const EMBEDDED_PAGES = Symbol.for('rsc-kit.embedded-pages');
+function embeddedPages() {
+    const pages = globalThis[EMBEDDED_PAGES];
+    return pages && typeof pages === 'object' ? pages : null;
+}
 export function prerenderedBeside(moduleUrl, dirName, levels = 4) {
     let reader = null;
     const resolveDir = async () => {
+        const embedded = embeddedPages();
+        if (embedded)
+            return async (name) => embedded[name] ?? null;
         let dir = null;
         try {
             const { fileURLToPath } = await import('node:url');
@@ -170,6 +189,25 @@ function safeUrl(relative, base) {
         return null;
     }
 }
+/**
+ * The entry a binary is compiled from, written beside the server.
+ *
+ * Two imports, in this order: the inline module first, so its pages are
+ * handed over before the server's first request; the server second. Bun
+ * embeds both. `bun build --compile .output/server/compile.mjs`.
+ */
+export function compileEntrySource(dirName) {
+    return ('// The entry to compile into one binary: bun build --compile .output/server/compile.mjs\n' +
+        '//\n' +
+        '// A binary carries what is imported by name. The server reads its frozen pages\n' +
+        '// through a computed import, which a compile cannot see - imported here, they\n' +
+        '// travel inside the binary and are handed to the server before it starts.\n' +
+        `import pages from "./${inlineModuleName(dirName)}";\n` +
+        '\n' +
+        `globalThis[Symbol.for("rsc-kit.embedded-pages")] = pages;\n` +
+        '\n' +
+        'await import("./index.mjs");\n');
+}
 /** The name the build writes the inline module under, beside the stored pages' directory. */
 export function inlineModuleName(dirName) {
     return `${dirName}-inline.mjs`;