@nifrajs/web 5.5.0 → 5.6.0

package/dist/internal/ppr/contract.d.ts

@@ -0,0 +1,177 @@
+/**
+ * What the page executor and `createWebApp` know of partial prerendering. Everything here is small and
+ * imports no runtime code: the server, its options and the hole HTML validator load only through
+ * `partialPrerendering` (`@nifrajs/web/ppr`), so an app without it carries none of them.
+ */
+import type { BoundaryRegistration, BoundaryRequestCtx, BoundaryStates, ShellCtx } from "../../boundary.js";
+import type { CspPolicy } from "../../csp.js";
+import type { RevalidateTags } from "../../isr.js";
+import type { RouteEntry, RouteModule } from "../../manifest.js";
+import type { RenderAdapter } from "../../render-seam.js";
+import type { LoadedLayoutModules } from "../render-document.js";
+import type { PprAdmissionStats } from "./admission.js";
+import type { ResolvedPprOptions } from "./options.js";
+/** An app built with `experimental.ppr` carries its {@link PprServer} under this key. */
+export declare const PPR_SERVER: unique symbol;
+/** The key of a {@link PprSetup}'s factory. */
+export declare const PPR_SETUP: unique symbol;
+/** Where the runtime's cancel beacon goes, under the app's base path. */
+export declare const PPR_CANCEL_PATH = "/__nifra/ppr/cancel";
+interface HoleFields {
+    readonly interactive?: boolean;
+    readonly timeout?: number;
+}
+/** A hole filled per visitor. */
+export type DynamicHole = Extract<BoundaryRegistration, {
+    readonly mode: "dynamic";
+}> & HoleFields;
+/** A hole built once for every visitor, with its loader entry's freshness merged in. */
+export type SharedHole = Extract<BoundaryRegistration, {
+    readonly mode: "shared";
+}> & HoleFields & {
+    readonly revalidate: number;
+    readonly revalidateTags?: RevalidateTags | undefined;
+};
+/** The boundary fields partial prerendering reads beyond the neutral registration. */
+export type HoleRegistration = DynamicHole | SharedHole;
+export declare const isHole: (boundary: BoundaryRegistration) => boundary is HoleRegistration;
+/** The key `serverHole()` stores a hole's server component under, on the hole's `render`. */
+export declare const SERVER_HOLE: unique symbol;
+/** The server component a hole's `render` names, or `undefined` for an ordinary `render`. */
+export declare const serverHoleComponent: (render: unknown) => object | undefined;
+/** What the page executor hands over for one PPR request. */
+export interface PprRequest {
+    readonly routeId: string;
+    /** The request's pathname, without search: the shell renders it, so it is part of the key. */
+    readonly path: string;
+    readonly locale: string | undefined;
+    /** The declared variations this request selected, by name; part of the shell key. */
+    readonly variations: Readonly<Record<string, string>>;
+    readonly request: Request;
+    /** The route's dynamic and shared boundaries, in declaration order, with their merged (guarded)
+     * loaders. */
+    readonly holes: readonly HoleRegistration[];
+    readonly holeContext: Omit<BoundaryRequestCtx, "signal" | "live">;
+    /** What the shell loader and every shared hole loader get, but the build's signal. */
+    readonly shellContext: Omit<ShellCtx, "signal">;
+    readonly loadShell: (signal: AbortSignal) => Promise<unknown>;
+    /** Render the full document for `shellData` with every hole pending, under no nonce. */
+    readonly renderShellDocument: (shellData: unknown, states: BoundaryStates) => Promise<string>;
+    /** The route's `revalidate`, in seconds: an older shell is served while one rebuild runs. */
+    readonly revalidate: number | undefined;
+    /** The route's `revalidateTags` for this request, read only when a shell is built. */
+    readonly tags: () => readonly string[];
+    /** A shared hole's `revalidateTags` for this request, read only when its entry is built. */
+    readonly holeTags: (hole: SharedHole) => readonly string[];
+    /** Keeps the platform alive for work that outlives the response, where the platform needs it. */
+    readonly waitUntil?: ((promise: Promise<unknown>) => void) | undefined;
+    /** The holes the client holds as hosts: a data request sends each one's fill. A hole that shows a
+     * server component always gets its fill. */
+    readonly fill?: ReadonlySet<string>;
+    /** Render a hole's server component for this visitor, when the app's server components list it. */
+    readonly component?: (hole: string, component: object, input: unknown, signal: AbortSignal) => Promise<{
+        readonly html: string;
+    }>;
+    /** Holes the client keeps: none of them loads, and each state says it was kept. */
+    readonly kept?: ReadonlySet<string>;
+    /** A live load: each hole's keys, and which holes loaded. */
+    readonly live?: HoleLive;
+}
+/** A live load's view of one response's holes. Owners are named by hole. */
+export interface HoleLive {
+    /** `ctx.live` for one hole's loader. */
+    collector(hole: string): (...keys: string[]) => void;
+    /** Close one hole's collector once its loader settled. */
+    seal(hole: string): void;
+    /** Called once, after every hole that ran settled, with the holes that loaded. */
+    done(loaded: readonly string[]): void;
+}
+/** The shell cannot be served now; the caller renders the page whole for this request. */
+export declare class PprShellUnavailable extends Error {
+    constructor(message: string);
+}
+/** Thrown when a route's shell has no passing import-check record. */
+export declare class PprShellUnchecked extends PprShellUnavailable {
+    constructor(routeId: string);
+}
+/** Thrown when a route already runs `shellBuildConcurrency` shell builds: no request waits on one. */
+export declare class PprShellBusy extends PprShellUnavailable {
+    constructor(routeId: string);
+}
+/** Thrown for a key seen fewer than `shellAfterRequests` times in a full store: the page streams whole. */
+export declare class PprShellCold extends PprShellUnavailable {
+    constructor(routeId: string);
+}
+/**
+ * How a response that is not a streamed document gets its holes. `"deferred"`: each hole runs under
+ * admission and its own deadline, and its state carries the result as a deferred value (a soft
+ * navigation's data request). `"settled"`: the same, awaited (the blocking render). `"omitted"`: no
+ * hole runs and every state is an empty host (a prefetch, which must not start work its navigation
+ * cannot cancel).
+ */
+export type HoleStatesMode = "deferred" | "settled" | "omitted";
+export interface PprServerStats extends PprAdmissionStats {
+    /** Responses aborted because unsent bytes went over `maxUnsentBytes` (`ppr.slow_aborted`). */
+    readonly slowAborted: number;
+    /** Frame bytes queued for clients across every live PPR stream. */
+    readonly unsentBytes: number;
+}
+export interface PprServer {
+    /** Stream one PPR document: the shared shell at once, then each hole as it settles. */
+    respond(request: PprRequest): Promise<Response>;
+    /** The shell data a soft navigation's data request carries. */
+    shellData(request: PprRequest): Promise<unknown>;
+    /** The hole states of a data request or a blocking render; `signal` is the request's. */
+    holeStates(request: PprRequest, mode: HoleStatesMode, signal: AbortSignal): Promise<BoundaryStates>;
+    /** Abort the response that printed `token`. Unknown tokens do nothing. */
+    cancel(token: string): boolean;
+    /**
+     * Drop every shell and shared hole frame carrying `tag`. A build of either that started before the
+     * call is not stored when it finishes, so an entry built from data read before the purge never
+     * outlives it.
+     */
+    invalidateTag(tag: string): Promise<void>;
+    stats(): PprServerStats;
+}
+/** What `createWebApp` gives a {@link PprSetup}: the parts of the app a PPR server depends on. */
+export interface PprEnvironment {
+    readonly adapter: RenderAdapter;
+    readonly csp?: CspPolicy;
+    /** Part of every shell key, so a shell built by one deployment is never served by another. */
+    readonly deployment: string;
+    /** The app authorizes scripts with a per-request nonce, which would make every shell unique. */
+    readonly perRequestNonce: boolean;
+}
+/** One app's partial prerendering, as the page executor uses it. */
+export interface PprIntegration {
+    readonly server: PprServer;
+    /** The configured public origin a shell may use; never a visitor's Host. */
+    readonly origin?: string;
+    /** Where the runtime's cancel beacon posts, and its handler. */
+    readonly cancelPath: string;
+    cancel(request: Request): Promise<Response>;
+    /**
+     * The streamed document, with the headers middleware and gates wrote, or how this request renders
+     * whole instead: `"settled"` for a listed bot or a shell that is unchecked or at its build limit,
+     * `"deferred"`, each hole streamed as it settles, for a key with no shell yet.
+     */
+    stream(request: PprRequest, written: () => Readonly<Record<string, string>> | undefined): Promise<Response | "settled" | "deferred">;
+    /** The shell data, or the shell loader's own output when the shell cannot be served now. */
+    shellData(request: PprRequest, signal: AbortSignal): Promise<unknown>;
+    /** `variations` as the shell's own query string. */
+    variationQuery(variations: Readonly<Record<string, string>>): string;
+    /** Throws for a route the PPR rules keep off the PPR path: its layouts, holes and their limits. */
+    assertRoute(route: RouteEntry, layouts: LoadedLayoutModules, boundaries: readonly BoundaryRegistration[]): void;
+    /** The declared variations `search` selects. */
+    variationsOf(declared: RouteModule["shellVariations"], search: string): Readonly<Record<string, string>>;
+}
+/** What `partialPrerendering()` returns for `createWebApp({ experimental: { ppr } })`. */
+export interface PprSetup {
+    readonly [PPR_SETUP]: (environment: PprEnvironment) => PprIntegration;
+}
+/** `variations` as a query string, sorted by name: the shell key part and the shell's own search. */
+export declare const variationQuery: (variations: Readonly<Record<string, string>>) => string;
+/** Whether `request` gets the blocking render under `options`. */
+export declare function wantsBlockingRender(options: ResolvedPprOptions, request: Request): boolean;
+export {};
+//# sourceMappingURL=contract.d.ts.map

package/dist/internal/ppr/contract.d.ts.map

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

package/dist/internal/ppr/contract.js

@@ -0,0 +1,80 @@
+/** An app built with `experimental.ppr` carries its {@link PprServer} under this key. */
+export const PPR_SERVER = Symbol.for("nifra.web.ppr");
+/** The key of a {@link PprSetup}'s factory. */
+export const PPR_SETUP = Symbol.for("nifra.web.ppr.setup");
+/** Where the runtime's cancel beacon goes, under the app's base path. */
+export const PPR_CANCEL_PATH = "/__nifra/ppr/cancel";
+export const isHole = (boundary) => boundary.mode === "dynamic" || boundary.mode === "shared";
+/** The key `serverHole()` stores a hole's server component under, on the hole's `render`. */
+export const SERVER_HOLE = Symbol.for("nifra.web.server-hole");
+/** The server component a hole's `render` names, or `undefined` for an ordinary `render`. */
+export const serverHoleComponent = (render) => {
+    if (typeof render !== "function")
+        return undefined;
+    const component = Reflect.get(render, SERVER_HOLE);
+    return typeof component === "object" && component !== null ? component : undefined;
+};
+/** The shell cannot be served now; the caller renders the page whole for this request. */
+export class PprShellUnavailable extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "PprShellUnavailable";
+    }
+}
+/** Thrown when a route's shell has no passing import-check record. */
+export class PprShellUnchecked extends PprShellUnavailable {
+    constructor(routeId) {
+        super(`[nifra/web] ppr: route "${routeId}" has no passing shell import check; rendered blocking`);
+    }
+}
+/** Thrown when a route already runs `shellBuildConcurrency` shell builds: no request waits on one. */
+export class PprShellBusy extends PprShellUnavailable {
+    constructor(routeId) {
+        super(`[nifra/web] ppr: route "${routeId}" is at its shell build limit; rendered blocking`);
+    }
+}
+/** Thrown for a key seen fewer than `shellAfterRequests` times in a full store: the page streams whole. */
+export class PprShellCold extends PprShellUnavailable {
+    constructor(routeId) {
+        super(`[nifra/web] ppr: route "${routeId}" has no shell for this key yet; rendered whole`);
+    }
+}
+/** `variations` as a query string, sorted by name: the shell key part and the shell's own search. */
+export const variationQuery = (variations) => {
+    let query = "";
+    for (const name of Object.keys(variations).sort()) {
+        query += `${query === "" ? "" : "&"}${encodeURIComponent(name)}=${encodeURIComponent(variations[name] ?? "")}`;
+    }
+    return query;
+};
+// A browser's agent took the default rule about 0.5 us to test, and agents repeat. The bounds keep a
+// client that sends a new agent per request from growing the map.
+const MAX_REMEMBERED_AGENT = 256;
+const MAX_REMEMBERED_AGENTS = 1024;
+const agentAnswers = new WeakMap();
+/** Whether `request` gets the blocking render under `options`. */
+export function wantsBlockingRender(options, request) {
+    const rule = options.blockingFor;
+    if (typeof rule === "function")
+        return rule(request);
+    const agent = request.headers.get("user-agent");
+    if (agent === null)
+        return false;
+    if (agent.length > MAX_REMEMBERED_AGENT)
+        return rule.test(agent);
+    let answers = agentAnswers.get(rule);
+    if (answers === undefined) {
+        answers = new Map();
+        agentAnswers.set(rule, answers);
+    }
+    let answer = answers.get(agent);
+    if (answer === undefined) {
+        if (answers.size >= MAX_REMEMBERED_AGENTS)
+            answers.clear();
+        // No `g` or `y` flag (options refuse them), so a test reads no state and an answer holds.
+        answer = rule.test(agent);
+        answers.set(agent, answer);
+    }
+    return answer;
+}
+//# sourceMappingURL=contract.js.map

package/dist/internal/ppr/contract.js.map

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

package/dist/internal/ppr/frames.d.ts

@@ -0,0 +1,71 @@
+/**
+ * A hole name: it becomes a DOM id, an attribute value, a hashed script and part of a renderer's id
+ * prefix, so it stays this narrow. No `--` and no trailing `-`: Svelte refuses an id prefix with `--`.
+ */
+export declare const HOLE_NAME: RegExp;
+/** What one hole sends: its server HTML, plus props when it hydrates, or the record of the server
+ * component it shows, without that HTML. An error carries the error slot's HTML only, never the
+ * thrown message. */
+export type HoleOutcome = {
+    readonly html: string;
+    readonly props?: unknown;
+    readonly component?: unknown;
+    readonly error?: undefined;
+} | {
+    readonly html: string;
+    readonly error: true;
+};
+/** A frame's JSON, as the runtime reads it to fill a host. */
+export type HoleFrameBody = {
+    readonly v: 1;
+    readonly html: string;
+    readonly props?: unknown;
+    readonly component?: unknown;
+    readonly error?: undefined;
+} | {
+    readonly v: 1;
+    readonly html: string;
+    readonly error: true;
+};
+export declare const assertHoleName: (name: string) => void;
+/** Refuse hole HTML that could run script or escape its host, with the policy server
+ * components already enforce. Throws; the caller sends that hole's error frame instead. */
+export declare const validateHoleHtml: (html: string) => void;
+/**
+ * The bytes that fill hole `name`: an inert JSON frame and the constant invoker. No `</script>` or
+ * comment opener in the HTML or props survives into the element. Throws a `RangeError` when the
+ * encoded frame exceeds `maxBytes`.
+ */
+export declare function encodeHoleFrame(name: string, outcome: HoleOutcome, maxBytes: number): string;
+/**
+ * The JSON of a frame {@link encodeHoleFrame} wrote: what a data request sends to refill a host. The
+ * opening tag holds no `>` before its end, and the escaped JSON no `</script>`.
+ */
+export declare function frameBodyOf(frame: string): HoleFrameBody;
+/**
+ * The per-response facts the runtime needs to send a cancel beacon. Inert JSON: never cached. `shared`
+ * names the holes whose frames serve every visitor, which the canary check scans with the shell.
+ */
+export declare const encodeRequestScript: (cancelUrl: string, token: string, holes: readonly string[], shared?: readonly string[]) => string;
+/**
+ * {@link encodeRequestScript} before and after the token, so a route's script is serialized once and
+ * each response adds only its token. Holds for a base64url token, which serializing leaves as it is.
+ * An escaped JSON string never holds `"token":"` (each of its quotes follows a backslash), so the
+ * key found is the token's.
+ */
+export declare function requestScriptAround(cancelUrl: string, holes: readonly string[], shared?: readonly string[]): readonly [string, string];
+/**
+ * Where {@link injectHoleFallbacks} puts each fallback, in document order. One pass over the shell
+ * finds every host: a search per hole, and another for its duplicate, read a large shell many times.
+ */
+export declare function holeFallbackInserts(shell: string, fallbacks: ReadonlyMap<string, string>): Array<{
+    readonly at: number;
+    readonly html: string;
+}>;
+/**
+ * Put each hole's fallback HTML into its empty host in a rendered shell, once per shell build. Every
+ * declared hole must have exactly one host and that host must be empty: the adapter renders
+ * it opaque, so anything inside would be framework output the fill would destroy.
+ */
+export declare function injectHoleFallbacks(shell: string, fallbacks: ReadonlyMap<string, string>): string;
+//# sourceMappingURL=frames.d.ts.map

package/dist/internal/ppr/frames.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frames.d.ts","sourceRoot":"","sources":["../../../src/internal/ppr/frames.ts"],"names":[],"mappings":"AAIA;;;GAGG;AACH,eAAO,MAAM,SAAS,EAAE,MAAqD,CAAA;AAE7E;;qBAEqB;AACrB,MAAM,MAAM,WAAW,GACnB;IACE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAA;IACxB,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAA;IAC5B,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,CAAA;CAC3B,GACD;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,IAAI,CAAA;CAAE,CAAA;AAEnD,8DAA8D;AAC9D,MAAM,MAAM,aAAa,GACrB;IACE,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAA;IACb,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAA;IACxB,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAA;IAC5B,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,CAAA;CAC3B,GACD;IAAE,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,IAAI,CAAA;CAAE,CAAA;AAElE,eAAO,MAAM,cAAc,GAAI,MAAM,MAAM,KAAG,IAM7C,CAAA;AAED;2FAC2F;AAC3F,eAAO,MAAM,gBAAgB,GAAI,MAAM,MAAM,KAAG,IAAmC,CAAA;AAWnF;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAmB5F;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,aAAa,CAIxD;AAED;;;GAGG;AACH,eAAO,MAAM,mBAAmB,GAC9B,WAAW,MAAM,EACjB,OAAO,MAAM,EACb,OAAO,SAAS,MAAM,EAAE,EACxB,SAAQ,SAAS,MAAM,EAAO,WAEyJ,CAAA;AAIzL;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,SAAS,MAAM,EAAE,EACxB,MAAM,GAAE,SAAS,MAAM,EAAO,GAC7B,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAI3B;AAID;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,GACrC,KAAK,CAAC;IAAE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAwBvD;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CASjG"}

package/dist/internal/ppr/frames.js

@@ -0,0 +1,119 @@
+import { validateComponentHTML } from "../../server-components/html.js";
+import { serializeData } from "../render-document.js";
+import { holeInvoker } from "./runtime.js";
+/**
+ * A hole name: it becomes a DOM id, an attribute value, a hashed script and part of a renderer's id
+ * prefix, so it stays this narrow. No `--` and no trailing `-`: Svelte refuses an id prefix with `--`.
+ */
+export const HOLE_NAME = /^(?=[a-z0-9-]{1,32}$)[a-z](?:-?[a-z0-9])*$/;
+export const assertHoleName = (name) => {
+    if (!HOLE_NAME.test(name)) {
+        throw new TypeError(`[nifra/web] ppr: hole name "${name}" must match ${HOLE_NAME.source} (it becomes a DOM id and a hashed script)`);
+    }
+};
+/** Refuse hole HTML that could run script or escape its host, with the policy server
+ * components already enforce. Throws; the caller sends that hole's error frame instead. */
+export const validateHoleHtml = (html) => validateComponentHTML(html);
+/**
+ * JSON safe inside a `<script>` element. Script data ends only at `</script`, and only `<!--` can
+ * move the tokenizer into its escaped states, so escaping `</` and `<!--` is enough; both escapes are
+ * plain JSON. Escaping every `<` and `>` instead, as `serializeData` does, made a 100 KB hole's frame
+ * 53% larger than its HTML; this makes it about 10% larger.
+ */
+const scriptJson = (value) => JSON.stringify(value).replaceAll("</", "<\\/").replaceAll("<!--", "<\\u0021--");
+/**
+ * The bytes that fill hole `name`: an inert JSON frame and the constant invoker. No `</script>` or
+ * comment opener in the HTML or props survives into the element. Throws a `RangeError` when the
+ * encoded frame exceeds `maxBytes`.
+ */
+export function encodeHoleFrame(name, outcome, maxBytes) {
+    const body = outcome.error === true
+        ? { v: 1, error: true, html: outcome.html }
+        : outcome.component !== undefined
+            ? { v: 1, html: outcome.html, component: outcome.component }
+            : outcome.props === undefined
+                ? { v: 1, html: outcome.html }
+                : { v: 1, html: outcome.html, props: outcome.props };
+    const frame = `<script type="application/json" id="nifra-ppr:${name}">${scriptJson(body)}</script><script>${holeInvoker(name)}</script>`;
+    // UTF-8 needs at least one and at most three bytes per UTF-16 unit, so only a frame between the two
+    // bounds is encoded to measure it.
+    if (frame.length > maxBytes ||
+        (frame.length * 3 > maxBytes && new TextEncoder().encode(frame).length > maxBytes)) {
+        throw new RangeError(`[nifra/web] ppr: hole "${name}" frame exceeds ${maxBytes} bytes`);
+    }
+    return frame;
+}
+/**
+ * The JSON of a frame {@link encodeHoleFrame} wrote: what a data request sends to refill a host. The
+ * opening tag holds no `>` before its end, and the escaped JSON no `</script>`.
+ */
+export function frameBodyOf(frame) {
+    const start = frame.indexOf(">") + 1;
+    // biome-ignore lint/plugin/requireSafetyCommentForTypeAssertion: encodeHoleFrame wrote this JSON from a HoleFrameBody.
+    return JSON.parse(frame.slice(start, frame.indexOf("</script>", start)));
+}
+/**
+ * The per-response facts the runtime needs to send a cancel beacon. Inert JSON: never cached. `shared`
+ * names the holes whose frames serve every visitor, which the canary check scans with the shell.
+ */
+export const encodeRequestScript = (cancelUrl, token, holes, shared = []) => `<script type="application/json" id="nifra-ppr-req">${serializeData(shared.length === 0 ? { cancel: cancelUrl, token, holes } : { cancel: cancelUrl, token, holes, shared })}</script>`;
+const TOKEN_KEY = '"token":"';
+/**
+ * {@link encodeRequestScript} before and after the token, so a route's script is serialized once and
+ * each response adds only its token. Holds for a base64url token, which serializing leaves as it is.
+ * An escaped JSON string never holds `"token":"` (each of its quotes follows a backslash), so the
+ * key found is the token's.
+ */
+export function requestScriptAround(cancelUrl, holes, shared = []) {
+    const script = encodeRequestScript(cancelUrl, "", holes, shared);
+    const at = script.indexOf(TOKEN_KEY) + TOKEN_KEY.length;
+    return [script.slice(0, at), script.slice(at)];
+}
+const HOST = 'data-nifra-hole="';
+/**
+ * Where {@link injectHoleFallbacks} puts each fallback, in document order. One pass over the shell
+ * finds every host: a search per hole, and another for its duplicate, read a large shell many times.
+ */
+export function holeFallbackInserts(shell, fallbacks) {
+    // A declared hole's host, as the index after its name's closing quote; -1 once it has two.
+    const hosts = new Map();
+    for (let at = shell.indexOf(HOST); at !== -1; at = shell.indexOf(HOST, at + HOST.length)) {
+        const end = shell.indexOf('"', at + HOST.length);
+        if (end === -1)
+            break;
+        const name = shell.slice(at + HOST.length, end);
+        if (fallbacks.has(name))
+            hosts.set(name, hosts.has(name) ? -1 : end + 1);
+    }
+    const inserts = [];
+    for (const [name, html] of fallbacks) {
+        const after = hosts.get(name);
+        if (after === undefined)
+            throw new TypeError(`[nifra/web] ppr: hole "${name}" has no host in the shell`);
+        if (after === -1) {
+            throw new TypeError(`[nifra/web] ppr: hole "${name}" has more than one host in the shell`);
+        }
+        const close = shell.indexOf(">", after);
+        if (close === -1 || !shell.startsWith("</", close + 1)) {
+            throw new TypeError(`[nifra/web] ppr: hole "${name}"'s host must render empty`);
+        }
+        inserts.push({ at: close + 1, html });
+    }
+    return inserts.sort((a, b) => a.at - b.at);
+}
+/**
+ * Put each hole's fallback HTML into its empty host in a rendered shell, once per shell build. Every
+ * declared hole must have exactly one host and that host must be empty: the adapter renders
+ * it opaque, so anything inside would be framework output the fill would destroy.
+ */
+export function injectHoleFallbacks(shell, fallbacks) {
+    const inserts = holeFallbackInserts(shell, fallbacks);
+    let out = "";
+    let from = 0;
+    for (const insert of inserts) {
+        out += shell.slice(from, insert.at) + insert.html;
+        from = insert.at;
+    }
+    return out + shell.slice(from);
+}
+//# sourceMappingURL=frames.js.map

package/dist/internal/ppr/frames.js.map

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

package/dist/internal/ppr/integration.d.ts

@@ -0,0 +1,19 @@
+import type { CacheStore } from "../../isr.js";
+import type { ShellCheckRecord } from "./compile-shell.js";
+import { type PprEnvironment, type PprIntegration } from "./contract.js";
+import type { ResolvedPprOptions } from "./options.js";
+/** Where shells are shared beyond the process, as `partialPrerendering` checked them. */
+export interface PprSharing {
+    readonly store: CacheStore | undefined;
+    readonly storeSecret: string | undefined;
+    readonly deployment: string | undefined;
+}
+/**
+ * The deployment every shell key names. The client entry changes with each client build; each route's
+ * checked shell hash changes with its shell code, which the client entry does not see; the
+ * platform's own name, when given, covers the rest.
+ */
+export declare function shellDeployment(clientEntry: string, shellChecks: ShellCheckRecord | "unchecked-development", named: string | undefined): string;
+/** One app's partial prerendering, made when `createWebApp` reaches its `experimental.ppr`. */
+export declare function createPprIntegration(options: ResolvedPprOptions, shellChecks: ShellCheckRecord | "unchecked-development", origin: string | undefined, environment: PprEnvironment, sharing?: PprSharing): PprIntegration;
+//# sourceMappingURL=integration.d.ts.map

package/dist/internal/ppr/integration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"integration.d.ts","sourceRoot":"","sources":["../../../src/internal/ppr/integration.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAC9C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AAC1D,OAAO,EAEL,KAAK,cAAc,EACnB,KAAK,cAAc,EAMpB,MAAM,eAAe,CAAA;AACtB,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAA;AAetD,yFAAyF;AACzF,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,KAAK,EAAE,UAAU,GAAG,SAAS,CAAA;IACtC,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,CAAA;IACxC,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,CAAA;CACxC;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,gBAAgB,GAAG,uBAAuB,EACvD,KAAK,EAAE,MAAM,GAAG,SAAS,GACxB,MAAM,CAUR;AAED,+FAA+F;AAC/F,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,kBAAkB,EAC3B,WAAW,EAAE,gBAAgB,GAAG,uBAAuB,EACvD,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,WAAW,EAAE,cAAc,EAC3B,OAAO,GAAE,UAAgF,GACxF,cAAc,CAyEhB"}

package/dist/internal/ppr/integration.js

@@ -0,0 +1,106 @@
+import { readBoundedBytes, TransportCodecError } from "@nifrajs/core/transport-codec";
+import { PPR_CANCEL_PATH, PprShellCold, PprShellUnavailable, PprShellUnchecked, variationQuery, wantsBlockingRender, } from "./contract.js";
+import { assertPprRoute, variationsOf } from "./route-rules.js";
+import { createPprServer } from "./server.js";
+import { digest, sharedShellStore } from "./shell-store.js";
+// The stream sets its own type, caching and CSP; a middleware or gate header joins the rest.
+const OWN_HEADERS = new Set([
+    "content-type",
+    "cache-control",
+    "content-security-policy",
+    "content-length",
+]);
+const MAX_CANCEL_BYTES = 64;
+/**
+ * The deployment every shell key names. The client entry changes with each client build; each route's
+ * checked shell hash changes with its shell code, which the client entry does not see; the
+ * platform's own name, when given, covers the rest.
+ */
+export function shellDeployment(clientEntry, shellChecks, named) {
+    if (shellChecks === "unchecked-development" && named === undefined)
+        return clientEntry;
+    const routes = shellChecks === "unchecked-development"
+        ? ""
+        : Object.keys(shellChecks.routes)
+            .sort()
+            .map((id) => `${id}=${shellChecks.routes[id]}`)
+            .join(",");
+    return `${clientEntry}~${digest(`${routes}|${named ?? ""}`)}`;
+}
+/** One app's partial prerendering, made when `createWebApp` reaches its `experimental.ppr`. */
+export function createPprIntegration(options, shellChecks, origin, environment, sharing = { store: undefined, storeSecret: undefined, deployment: undefined }) {
+    const { perRequestNonce, ...app } = environment;
+    if (perRequestNonce) {
+        throw new TypeError("[nifra/web] experimental.ppr needs `csp: createCspPolicy(...)`, not `nonce`: a per-request nonce would make every shell unique");
+    }
+    const deployment = shellDeployment(app.deployment, shellChecks, sharing.deployment);
+    const server = createPprServer({
+        ...app,
+        deployment,
+        clientEntry: app.deployment,
+        options,
+        cancelUrl: PPR_CANCEL_PATH,
+        shellChecks,
+        shared: sharing.store === undefined || sharing.storeSecret === undefined
+            ? undefined
+            : sharedShellStore(sharing.store, sharing.storeSecret, deployment),
+    });
+    const uncheckedWarned = new Set();
+    return {
+        server,
+        // biome-ignore lint/plugin/noConditionalEmptyObjectSpread: an app with no configured origin has none, which shell meta reads as absent.
+        ...(origin === undefined ? {} : { origin }),
+        cancelPath: PPR_CANCEL_PATH,
+        // A beacon carries one 22-character token; anything longer is not one. The token is unguessable,
+        // so the answer is the same whether it named a live response or not.
+        async cancel(request) {
+            const length = Number(request.headers.get("content-length") ?? "NaN");
+            if (!(length > 0 && length <= MAX_CANCEL_BYTES))
+                return new Response(null, { status: 400 });
+            let token;
+            try {
+                // The header is a claim; the cap holds on the bytes that arrive.
+                token = await readBoundedBytes(new Response(request.body, { headers: request.headers }), {
+                    maxBytes: MAX_CANCEL_BYTES,
+                });
+            }
+            catch (error) {
+                if (error instanceof TransportCodecError)
+                    return new Response(null, { status: 400 });
+                throw error;
+            }
+            server.cancel(new TextDecoder().decode(token));
+            return new Response(null, { status: 204 });
+        },
+        async stream(request, written) {
+            if (wantsBlockingRender(options, request.request))
+                return "settled";
+            let response;
+            try {
+                response = await server.respond(request);
+            }
+            catch (error) {
+                if (!(error instanceof PprShellUnavailable))
+                    throw error;
+                if (error instanceof PprShellCold)
+                    return "deferred";
+                if (error instanceof PprShellUnchecked && !uncheckedWarned.has(request.routeId)) {
+                    uncheckedWarned.add(request.routeId);
+                    console.warn(error.message);
+                }
+                return "settled";
+            }
+            for (const [name, value] of Object.entries(written() ?? {}))
+                if (!OWN_HEADERS.has(name))
+                    response.headers.set(name, value);
+            return response;
+        },
+        shellData: (request, signal) => server
+            .shellData(request)
+            .catch((error) => error instanceof PprShellUnavailable ? request.loadShell(signal) : Promise.reject(error)),
+        variationQuery,
+        assertRoute: (route, layouts, boundaries) => assertPprRoute(route, layouts, boundaries, options),
+        variationsOf,
+    };
+}
+//# sourceMappingURL=integration.js.map

package/dist/internal/ppr/integration.js.map

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