@rsc-kit/core 0.1.0

package/dist/embed.js

@@ -0,0 +1,119 @@
+// Putting the build output inside the binary.
+//
+// `bun build --compile` bundles the JavaScript it can see and nothing else, so
+// a compiled server renders pages and then 404s every stylesheet and every
+// client chunk — the page arrives, unstyled, and never hydrates. Nothing warns:
+// the server starts, the routes answer, and only the browser knows.
+//
+// Bun embeds a file when something imports it with `{ type: 'file' }`, so this
+// writes a module that imports each one and hands back the readers the host
+// already takes:
+//
+//     bun run embed        # after vite build && prerender
+//     bun build --compile server.ts --outfile app
+//
+// The generated module is the only thing that has to exist at compile time.
+// After that the binary carries the assets, the prerendered pages and the
+// engine, and runs anywhere with nothing beside it.
+import { existsSync, mkdirSync, readdirSync, statSync, writeFileSync } from 'node:fs';
+import { dirname, join, relative, resolve } from 'node:path';
+/** Every file under a directory, as paths relative to it. */
+function walk(dir, base = dir) {
+    if (!existsSync(dir))
+        return [];
+    const found = [];
+    for (const entry of readdirSync(dir)) {
+        const abs = join(dir, entry);
+        if (statSync(abs).isDirectory()) {
+            found.push(...walk(abs, base));
+        }
+        else {
+            found.push(relative(base, abs).replace(/\\/g, '/'));
+        }
+    }
+    return found;
+}
+/**
+ * Write the module that embeds the build.
+ *
+ * Returns what it found, so a build script can say so rather than producing a
+ * binary that is quietly missing half of itself.
+ */
+export function writeEmbedModule(options) {
+    const prefix = options.prefix ?? '/assets/';
+    const assetsDir = options.assets ? resolve(options.assets) : null;
+    const prerenderedDir = options.prerendered ? resolve(options.prerendered) : null;
+    const assetFiles = assetsDir ? walk(assetsDir) : [];
+    const pageFiles = prerenderedDir ? walk(prerenderedDir) : [];
+    const imports = [];
+    const assetEntries = [];
+    const pageEntries = [];
+    const outDir = dirname(resolve(options.out));
+    // Relative to the generated module. An absolute path is only true on the
+    // machine that wrote it, and a build that moves — a container, CI — would
+    // compile a binary whose every asset points at somewhere that does not exist.
+    const from = (abs) => {
+        const rel = relative(outDir, abs).replace(/\\/g, '/');
+        return rel.startsWith('.') ? rel : './' + rel;
+    };
+    // Sorted, so the same input produces the same module and the same binary.
+    assetFiles.sort().forEach((name, i) => {
+        imports.push(`import a${i} from ${JSON.stringify(from(join(assetsDir, name)))} with { type: 'file' }`);
+        assetEntries.push(`  ${JSON.stringify(prefix + name)}: a${i},`);
+    });
+    pageFiles.sort().forEach((name, i) => {
+        imports.push(`import p${i} from ${JSON.stringify(from(join(prerenderedDir, name)))} with { type: 'file' }`);
+        pageEntries.push(`  ${JSON.stringify(name)}: p${i},`);
+    });
+    const source = `// GENERATED — do not edit. Written by writeEmbedModule().
+//
+// Each import is what makes the file part of the binary. A path read at
+// runtime would not be: bun build --compile follows imports, not strings.
+${imports.join('\n')}
+
+export const assetPaths: Record<string, string> = {
+${assetEntries.join('\n')}
+}
+
+export const pagePaths: Record<string, string> = {
+${pageEntries.join('\n')}
+}
+
+export const TYPES: Record<string, string> = {
+  js: 'text/javascript; charset=utf-8',
+  css: 'text/css; charset=utf-8',
+  map: 'application/json; charset=utf-8',
+  svg: 'image/svg+xml',
+  woff2: 'font/woff2',
+}
+
+/** The \`assets\` reader, served from inside the binary. */
+export async function assets(pathname: string): Promise<Response | null> {
+  const path = assetPaths[pathname]
+
+  if (!path) return null
+
+  // .stream() rather than the file itself: a Response implementation that does
+  // not know what a BunFile is turns the body into the string "[object Blob]",
+  // which serves a stylesheet that parses as nothing and reports 200.
+  return new Response(Bun.file(path).stream(), {
+    headers: {
+      'Content-Type': TYPES[pathname.split('.').pop() ?? ''] ?? 'application/octet-stream',
+      // Content-hashed by the build, so this is safe.
+      'Cache-Control': 'public, max-age=31536000, immutable',
+    },
+  })
+}
+
+/** The \`prerendered\` reader, served from inside the binary. */
+export async function prerendered(name: string): Promise<string | null> {
+  const path = pagePaths[name]
+
+  return path ? await Bun.file(path).text() : null
+}
+`;
+    mkdirSync(dirname(resolve(options.out)), { recursive: true });
+    writeFileSync(resolve(options.out), source);
+    return { assets: assetFiles.length, prerendered: pageFiles.length };
+}
+//# sourceMappingURL=embed.js.map

package/dist/embed.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"embed.js","sourceRoot":"","sources":["../src/embed.ts"],"names":[],"mappings":"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"}

package/dist/errors.d.ts

@@ -0,0 +1,24 @@
+/**
+ * The worker's own error types.
+ *
+ * A separate set from `src/js/errors.ts` on purpose: these are thrown inside
+ * the worker and turned into HTTP statuses, so they never reach the browser as
+ * objects — the client reconstructs its own from the response. The public
+ * `@rsc-kit/core/errors` specifier is the client's module, because that is
+ * the one an `instanceof` in a component has to match.
+ */
+export declare class ServerValidationError extends Error {
+    readonly errors: Record<string, string[]>;
+    constructor(message: string, errors: Record<string, string[]>);
+}
+export declare class ServerAuthenticationError extends Error {
+    constructor(message?: string);
+}
+export declare class ServerAuthorizationError extends Error {
+    constructor(message?: string);
+}
+export declare class ServerRedirectError extends Error {
+    readonly location: string;
+    constructor(location: string);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,qBAAa,qBAAsB,SAAQ,KAAK;IAC9C,SAAgB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IAEjD,YAAY,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,EAI5D;CACF;AAED,qBAAa,yBAA0B,SAAQ,KAAK;IAClD,YAAY,OAAO,GAAE,MAA2B,EAG/C;CACF;AAED,qBAAa,wBAAyB,SAAQ,KAAK;IACjD,YAAY,OAAO,GAAE,MAAuC,EAG3D;CACF;AAED,qBAAa,mBAAoB,SAAQ,KAAK;IAC5C,SAAgB,QAAQ,EAAE,MAAM,CAAC;IAEjC,YAAY,QAAQ,EAAE,MAAM,EAI3B;CACF"}

package/dist/errors.js

@@ -0,0 +1,38 @@
+/**
+ * The worker's own error types.
+ *
+ * A separate set from `src/js/errors.ts` on purpose: these are thrown inside
+ * the worker and turned into HTTP statuses, so they never reach the browser as
+ * objects — the client reconstructs its own from the response. The public
+ * `@rsc-kit/core/errors` specifier is the client's module, because that is
+ * the one an `instanceof` in a component has to match.
+ */
+export class ServerValidationError extends Error {
+    errors;
+    constructor(message, errors) {
+        super(message);
+        this.name = "ServerValidationError";
+        this.errors = errors;
+    }
+}
+export class ServerAuthenticationError extends Error {
+    constructor(message = "Unauthenticated.") {
+        super(message);
+        this.name = "ServerAuthenticationError";
+    }
+}
+export class ServerAuthorizationError extends Error {
+    constructor(message = "This action is unauthorized.") {
+        super(message);
+        this.name = "ServerAuthorizationError";
+    }
+}
+export class ServerRedirectError extends Error {
+    location;
+    constructor(location) {
+        super(`Redirect to ${location}`);
+        this.name = "ServerRedirectError";
+        this.location = location;
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,MAAM,OAAO,qBAAsB,SAAQ,KAAK;IAC9B,MAAM,CAA2B;IAEjD,YAAY,OAAe,EAAE,MAAgC;QAC3D,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAC;QACpC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;CACF;AAED,MAAM,OAAO,yBAA0B,SAAQ,KAAK;IAClD,YAAY,OAAO,GAAW,kBAAkB;QAC9C,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,2BAA2B,CAAC;IAC1C,CAAC;CACF;AAED,MAAM,OAAO,wBAAyB,SAAQ,KAAK;IACjD,YAAY,OAAO,GAAW,8BAA8B;QAC1D,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,0BAA0B,CAAC;IACzC,CAAC;CACF;AAED,MAAM,OAAO,mBAAoB,SAAQ,KAAK;IAC5B,QAAQ,CAAS;IAEjC,YAAY,QAAgB;QAC1B,KAAK,CAAC,eAAe,QAAQ,EAAE,CAAC,CAAC;QACjC,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;QAClC,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;CACF"}

package/dist/export.d.ts

@@ -0,0 +1,41 @@
+import type { PrerenderResult } from './prerender.js';
+import type { RouteManifest } from './manifest.js';
+export interface ExportOptions {
+    /** What prerender() decided, so this can refuse what it cannot serve. */
+    results: PrerenderResult[];
+    /** Reads what prerender() wrote. `prerenderedFrom` in `@rsc-kit/core/files`. */
+    read: (name: string) => Promise<string | null> | string | null;
+    /**
+     * Writes the site, keyed by its url path — `docs/index.html`, not an
+     * absolute one. `writeTo` in `@rsc-kit/core/files` puts those under a
+     * directory; a deploy that uploads straight to a bucket writes keys.
+     */
+    write: (path: string, contents: string) => Promise<void> | void;
+    /** The route table, for what the build decided about payload urls. */
+    manifest: RouteManifest;
+    /**
+     * Brings the browser bundle along, if this export has to carry it.
+     *
+     * A callback rather than a directory pair: copying a tree of built files is
+     * a filesystem operation by nature, and a deploy that uploads them has its
+     * own tooling for it. `copyAssets` in `@rsc-kit/core/files` does the local one.
+     */
+    assets?: () => Promise<void> | void;
+    /**
+     * Export anyway, leaving out whatever is not static.
+     *
+     * The result is a site with holes in it, which is sometimes what you want
+     * while moving an app towards being exportable. It is never the default,
+     * because the holes are 404s at urls that worked before.
+     */
+    force?: boolean;
+}
+export declare class NotExportable extends Error {
+    readonly refused: PrerenderResult[];
+    constructor(refused: PrerenderResult[]);
+}
+export declare function exportSite(options: ExportOptions): Promise<{
+    pages: number;
+    refused: PrerenderResult[];
+}>;
+//# sourceMappingURL=export.d.ts.map

package/dist/export.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"export.d.ts","sourceRoot":"","sources":["../src/export.ts"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAA;AACrD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAA;AAElD,MAAM,WAAW,aAAa;IAC5B,yEAAyE;IACzE,OAAO,EAAE,eAAe,EAAE,CAAA;IAC1B,gFAAgF;IAChF,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,GAAG,MAAM,GAAG,IAAI,CAAA;IAC9D;;;;OAIG;IACH,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAA;IAC/D,sEAAsE;IACtE,QAAQ,EAAE,aAAa,CAAA;IACvB;;;;;;OAMG;IACH,MAAM,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAA;IACnC;;;;;;OAMG;IACH,KAAK,CAAC,EAAE,OAAO,CAAA;CAChB;AAED,qBAAa,aAAc,SAAQ,KAAK;aACV,OAAO,EAAE,eAAe,EAAE;IAAtD,YAA4B,OAAO,EAAE,eAAe,EAAE,EAQrD;CACF;AAYD,wBAAsB,UAAU,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,eAAe,EAAE,CAAA;CAAE,CAAC,CAiF/G"}

package/dist/export.js

@@ -0,0 +1,100 @@
+// Writing the whole site out as files, for a host that only serves files.
+//
+// Everything a server was doing has to have happened already, which makes the
+// refusals the important part. A site exported with a route missing, or with a
+// shell nothing will ever fill, does not fail at build time and does not fail
+// on load — it serves a page that sits there, or a 404 for a url that worked
+// yesterday. So anything that is not fully static stops the export and says
+// which routes and why.
+//
+// Layout is a directory per route with an index inside it, so urls stay
+// extensionless, and the Flight payload sits beside it under a filename the
+// client was built to ask for.
+//
+//   out/index.html            /
+//   out/index.rsc
+//   out/docs/index.html       /docs
+//   out/docs/index.rsc
+//   out/assets/…              the browser bundle
+import { pathKey } from './prerender.js';
+export class NotExportable extends Error {
+    refused;
+    constructor(refused) {
+        super('This site cannot be exported as it is. A static host runs nothing, so these routes have ' +
+            'no way to finish rendering:\n\n' +
+            refused.map((r) => `  ${r.url} — ${r.reason ?? describe(r.type)}`).join('\n') +
+            '\n\nMake them static, or pass force to export the rest and leave these out.');
+        this.refused = refused;
+        this.name = 'NotExportable';
+    }
+}
+function describe(type) {
+    if (type === 'shell') {
+        // Worth spelling out: a shell looks like a working page in the build
+        // output, and on a static host it is a page that loads and stays empty.
+        return 'only a shell was stored, and nothing on a static host will fill it';
+    }
+    return 'failed to render';
+}
+export async function exportSite(options) {
+    const { results, read, write, manifest, assets, force = false } = options;
+    // A guarded route is frozen on purpose — the content is the same for
+    // everyone allowed to see it — but the guard runs when the page is served,
+    // and a static host serves without running anything. Exporting one publishes
+    // the page to whoever asks, which is the opposite of what the guard said.
+    const guarded = new Set(manifest.routes
+        .filter((route) => route.middleware?.length)
+        .map((route) => route.component));
+    const refused = results
+        .filter((r) => r.type !== 'frozen' || guarded.has(r.component))
+        .map((r) => r.type === 'frozen' && guarded.has(r.component)
+        ? { ...r, reason: 'guarded, and a static host has nothing to run the guard' }
+        : r);
+    if (refused.length > 0 && !force)
+        throw new NotExportable(refused);
+    // The client has to ask for payloads by url, because a static host cannot
+    // read the header that would otherwise select one. That is decided by the
+    // build, so a site exported from a server build ships a client asking the
+    // wrong way — every navigation silently falls back to a full page load.
+    const payloadName = manifest.build?.payloadName;
+    if (!payloadName) {
+        throw new Error('This build was made for a server, so its client asks for payloads with a header rather ' +
+            "than by url. Build with output: 'export' before exporting.");
+    }
+    const copy = async (name, into) => {
+        const contents = await read(name);
+        // Missing where the results said it would be: the prerender output and the
+        // results it returned disagree, which is not something to paper over with
+        // a half-written site.
+        if (contents === null) {
+            throw new Error(`Nothing to export at ${name}. Prerender and export must read the same output.`);
+        }
+        await write(into, contents);
+    };
+    let pages = 0;
+    for (const result of results) {
+        if (result.type !== 'frozen')
+            continue;
+        const key = pathKey(result.url);
+        // The root is the out dir itself; everything else is a directory with an
+        // index, so /docs stays /docs rather than becoming /docs.html.
+        const dir = key === 'index' ? '' : `${key}/`;
+        await copy(`${key}.html`, `${dir}index.html`);
+        await copy(`${key}.flight`, `${dir}${payloadName}`);
+        // One file per depth a client might already hold, addressed by name
+        // because a file server cannot vary on a header. Without these every
+        // navigation is a whole document, which replaces the root and unmounts
+        // the pages retained behind it — so going back does not restore the form
+        // you were filling in.
+        for (let depth = 1;; depth++) {
+            const variant = await read(`${key}.seg${depth}.flight`);
+            if (variant === null)
+                break;
+            await write(`${dir}${payloadName.replace(/^index\./, `index.seg${depth}.`)}`, variant);
+        }
+        pages++;
+    }
+    await assets?.();
+    return { pages, refused };
+}
+//# sourceMappingURL=export.js.map

package/dist/export.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"export.js","sourceRoot":"","sources":["../src/export.ts"],"names":[],"mappings":"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"}

package/dist/files.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Serve built browser assets out of the build's public directory.
+ *
+ * `dir` is the browser's root, not the asset folder: a request for
+ * /assets/x.js reads <dir>/assets/x.js. Stripping the prefix instead reads
+ * <dir>/x.js, which is a 404 for every asset and a page that renders and then
+ * never hydrates — nothing logs, because the failed request is the browser's.
+ *
+ * In production these belong in front of the application, on whatever already
+ * serves static files. This exists so a development server and a single-file
+ * binary do not each write it.
+ */
+export declare function assetsFrom(dir: string, prefix?: string): (pathname: string) => Promise<Response | null>;
+/**
+ * Read what the prerenderer wrote, from a directory.
+ *
+ * Missing is an answer, not an error: a partial prerender is a valid state,
+ * and anything not found here is rendered on demand instead.
+ */
+export declare function prerenderedFrom(dir: string): (name: string) => Promise<string | null>;
+/**
+ * Write build output into a directory.
+ *
+ * The sink `prerender` and `exportSite` take. Names are relative and may
+ * contain directories — `docs/index.html` — so each one's parent is created
+ * as it goes.
+ */
+export declare function writeTo(dir: string): ((name: string, contents: string) => Promise<void>) & {
+    dir: string;
+};
+/**
+ * Copy the built browser bundle into an exported site.
+ *
+ * Separate from the export itself because copying a tree of files is a
+ * filesystem operation by nature — a deploy that uploads them to a bucket
+ * has its own way to do that, and passes its own callback instead.
+ */
+export declare function copyAssets(from: string, to: string, url?: string): () => Promise<void>;
+//# sourceMappingURL=files.d.ts.map

package/dist/files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"files.d.ts","sourceRoot":"","sources":["../src/files.ts"],"names":[],"mappings":"AAqBA;;;;;;;;;;;GAWG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,SAAa,cACjC,MAAM,KAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAqB1D;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,UA2BrB,MAAM,KAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAWpD;AAYD;;;;;;GAMG;AACH,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG;IAAE,GAAG,EAAE,MAAM,CAAA;CAAE,CAY1G;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,GAAG,SAAa,SAClD,OAAO,CAAC,IAAI,CAAC,CAU/B"}

package/dist/files.js

@@ -0,0 +1,146 @@
+// Reading built output off a disk.
+//
+// Kept apart from the host on purpose: it is the only part of serving an RSC
+// app that assumes a filesystem, and plenty of places to run one do not have
+// a filesystem. A Worker reads its assets from a binding, a Deno Deploy app
+// from KV, a CDN from itself. Those hosts pass their own readers and never
+// load this module — and because nothing in `@rsc-kit/core/host` imports it, a
+// bundle for one of them contains no reference to `node:fs` at all.
+//
+//   import { createRscHandler } from '@rsc-kit/core/host'
+//   import { assetsFrom, prerenderedFrom } from '@rsc-kit/core/files'
+//
+//   createRscHandler({
+//     engine,
+//     assets: assetsFrom('./build/public'),
+//     prerendered: prerenderedFrom('./build/static'),
+//   })
+import { cp, mkdir, readdir, readFile, writeFile } from 'node:fs/promises';
+import { dirname, join } from 'node:path';
+/**
+ * Serve built browser assets out of the build's public directory.
+ *
+ * `dir` is the browser's root, not the asset folder: a request for
+ * /assets/x.js reads <dir>/assets/x.js. Stripping the prefix instead reads
+ * <dir>/x.js, which is a 404 for every asset and a page that renders and then
+ * never hydrates — nothing logs, because the failed request is the browser's.
+ *
+ * In production these belong in front of the application, on whatever already
+ * serves static files. This exists so a development server and a single-file
+ * binary do not each write it.
+ */
+export function assetsFrom(dir, prefix = '/assets/') {
+    return async (pathname) => {
+        if (!pathname.startsWith(prefix))
+            return null;
+        // No traversal out of the asset directory, whatever the url claims.
+        if (pathname.includes('..'))
+            return null;
+        try {
+            const bytes = await readFile(join(dir, pathname));
+            return new Response(bytes, {
+                headers: {
+                    'Content-Type': contentTypeOf(pathname),
+                    // Content-hashed by the build, so this is safe and is the difference
+                    // between a warm navigation and a cold one.
+                    'Cache-Control': 'public, max-age=31536000, immutable',
+                },
+            });
+        }
+        catch {
+            return null;
+        }
+    };
+}
+/**
+ * Read what the prerenderer wrote, from a directory.
+ *
+ * Missing is an answer, not an error: a partial prerender is a valid state,
+ * and anything not found here is rendered on demand instead.
+ */
+export function prerenderedFrom(dir) {
+    /**
+     * What is on disk, listed once.
+     *
+     * A miss used to be a thrown ENOENT, and misses are the common case: the
+     * host asks for `{url}.html`, then `{url}.ppr.html`, then the route's
+     * pattern — so every request to a page served by a pattern shell threw and
+     * caught two exceptions before finding anything. Measured at 3,000 req/s
+     * against 28,000 for the same page read from memory.
+     *
+     * Only existence is cached, never contents: a file that is there is still
+     * read on every request, so a redeploy that rewrites one is picked up. What
+     * a running server will not notice is a page appearing that was not there at
+     * boot — which is a build artefact, and the build has finished.
+     */
+    let present = null;
+    const listing = async () => {
+        present ??= readdir(dir, { recursive: true })
+            .then((names) => new Set(names.map((n) => String(n).replace(/\\/g, '/'))))
+            // An absent directory is an empty one: a partial prerender is a valid
+            // state, and everything falls through to being rendered.
+            .catch(() => new Set());
+        return await present;
+    };
+    return async (name) => {
+        if (name.includes('..'))
+            return null;
+        if (!(await listing()).has(name))
+            return null;
+        try {
+            return await readFile(join(dir, name), 'utf-8');
+        }
+        catch {
+            return null;
+        }
+    };
+}
+function contentTypeOf(pathname) {
+    if (pathname.endsWith('.js'))
+        return 'text/javascript; charset=utf-8';
+    if (pathname.endsWith('.css'))
+        return 'text/css; charset=utf-8';
+    if (pathname.endsWith('.map'))
+        return 'application/json; charset=utf-8';
+    if (pathname.endsWith('.svg'))
+        return 'image/svg+xml';
+    if (pathname.endsWith('.woff2'))
+        return 'font/woff2';
+    return 'application/octet-stream';
+}
+/**
+ * Write build output into a directory.
+ *
+ * The sink `prerender` and `exportSite` take. Names are relative and may
+ * contain directories — `docs/index.html` — so each one's parent is created
+ * as it goes.
+ */
+export function writeTo(dir) {
+    const write = async (name, contents) => {
+        const path = join(dir, name);
+        await mkdir(dirname(path), { recursive: true });
+        await writeFile(path, contents);
+    };
+    // Where it wrote, for a caller that has to read it back. The embeddable
+    // module has to list these files, and being told the directory a second time
+    // is a second place for it to be wrong.
+    return Object.assign(write, { dir });
+}
+/**
+ * Copy the built browser bundle into an exported site.
+ *
+ * Separate from the export itself because copying a tree of files is a
+ * filesystem operation by nature — a deploy that uploads them to a bucket
+ * has its own way to do that, and passes its own callback instead.
+ */
+export function copyAssets(from, to, url = '/assets/') {
+    return async () => {
+        const at = url.replace(/^\/+|\/+$/g, '');
+        if (at === '')
+            return;
+        const target = join(to, at);
+        await mkdir(dirname(target), { recursive: true });
+        await cp(from, target, { recursive: true });
+    };
+}
+//# sourceMappingURL=files.js.map

package/dist/files.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"files.js","sourceRoot":"","sources":["../src/files.ts"],"names":[],"mappings":"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"}

package/dist/headers.d.ts

@@ -0,0 +1,81 @@
+export declare const HEADER: {
+    /**
+     * Present on a request for a Flight payload rather than the document. One
+     * url serves both, which is why every answer must Vary on it.
+     */
+    readonly rsc: 'X-RSC';
+    /** The layout chain the client has mounted, outermost first, comma-separated. */
+    readonly segments: 'X-RSC-Segments';
+    /** The boundary the answer replaces. 0 means a whole document. */
+    readonly segmentDepth: 'X-RSC-Segment-Depth';
+    /** The chain to send back next time. */
+    readonly layouts: 'X-RSC-Layouts';
+    /** Identifies the build, so a client can notice it is talking to an old one. */
+    readonly version: 'X-RSC-Version';
+    /** The slot an intercepted navigation is targeting. */
+    readonly intercept: 'X-RSC-Intercept';
+    /** Where the navigation or action came from. */
+    readonly referer: 'X-RSC-Referer';
+    /** One named region of the current page to render and return alone. */
+    readonly revalidate: 'X-RSC-Revalidate';
+    /** The server reference being invoked. */
+    readonly action: 'X-RSC-Action';
+    /**
+     * Go here instead.
+     *
+     * Used for a redirect the client has to perform itself: a failed action, and
+     * a navigation whose render redirected. Never a 3xx for those — `fetch`
+     * follows one transparently, so the client would get the destination's HTML
+     * where it expected a Flight payload and decode it as one.
+     */
+    readonly redirect: 'X-RSC-Redirect';
+    /**
+     * The body's real type.
+     *
+     * The body itself goes out as application/octet-stream so a host that parses
+     * multipart cannot consume it before the action does — reading Content-Type
+     * instead leaves an upload undecodable.
+     */
+    readonly contentType: 'X-RSC-Content-Type';
+    /**
+     * Where the browser posts server actions.
+     *
+     * Not a convention this can choose: the client runtime posts here
+     * unconditionally.
+     */
+    readonly actionPath: '/_rsc/action';
+};
+/** Flight payload. */
+export declare const FLIGHT_TYPE = "text/x-component; charset=utf-8";
+/** A rendered document. */
+export declare const HTML_TYPE = "text/html; charset=utf-8";
+/**
+ * Every request header that changes what a response body contains.
+ *
+ * One url answers with a whole document, a partial payload, a named region or
+ * an interceptor depending on these — so a cache keyed on the url alone, or on
+ * `X-RSC` alone, will hand one client another's answer. They are materially
+ * different bodies, not variations in presentation.
+ */
+export declare const VARY_ON_RSC: string;
+/**
+ * What a response says about being stored, when it must not be.
+ *
+ * `Vary` alone is not enough on the platform this targets. Cloudflare ignores
+ * `Vary` for everything except `Accept-Encoding`, and this package ships a
+ * Workers story as a headline feature — so one url answering with a document,
+ * a Flight payload, a segment and an interceptor, keyed only on the url, hands
+ * one visitor another's body. Anything narrowed by a request header, and
+ * anything behind a guard, says outright that it is not to be stored.
+ */
+export declare const PER_CLIENT = "private, no-store";
+/**
+ * And what a frozen, unguarded page says.
+ *
+ * Explicit rather than absent: with no directive at all, whether an
+ * intermediary stores it comes down to that intermediary's heuristics, which
+ * is not a decision this package should be leaving to chance in either
+ * direction.
+ */
+export declare const REVALIDATE = "public, max-age=0, must-revalidate";
+//# sourceMappingURL=headers.d.ts.map

package/dist/headers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"headers.d.ts","sourceRoot":"","sources":["../src/headers.ts"],"names":[],"mappings":"AAUA,eAAO,MAAM,MAAM;IACjB;;;OAGG;aACH,GAAG,EAAE,OAAO;IAEZ,iFAAiF;aACjF,QAAQ,EAAE,gBAAgB;IAE1B,kEAAkE;aAClE,YAAY,EAAE,qBAAqB;IAEnC,wCAAwC;aACxC,OAAO,EAAE,eAAe;IAExB,gFAAgF;aAChF,OAAO,EAAE,eAAe;IAExB,uDAAuD;aACvD,SAAS,EAAE,iBAAiB;IAE5B,gDAAgD;aAChD,OAAO,EAAE,eAAe;IAExB,uEAAuE;aACvE,UAAU,EAAE,kBAAkB;IAE9B,0CAA0C;aAC1C,MAAM,EAAE,cAAc;IAEtB;;;;;;;OAOG;aACH,QAAQ,EAAE,gBAAgB;IAE1B;;;;;;OAMG;aACH,WAAW,EAAE,oBAAoB;IAEjC;;;;;OAKG;aACH,UAAU,EAAE,cAAc;CAClB,CAAA;AAEV,sBAAsB;AACtB,eAAO,MAAM,WAAW,oCAAoC,CAAA;AAE5D,2BAA2B;AAC3B,eAAO,MAAM,SAAS,6BAA6B,CAAA;AAEnD;;;;;;;GAOG;AACH,eAAO,MAAM,WAAW,QAMZ,CAAA;AAEZ;;;;;;;;;GASG;AACH,eAAO,MAAM,UAAU,sBAAsB,CAAA;AAE7C;;;;;;;GAOG;AACH,eAAO,MAAM,UAAU,uCAAuC,CAAA"}