@rsc-kit/core 0.29.10 → 0.30.0

package/dist/js/inlinePayload.js

@@ -0,0 +1,56 @@
+// The payload a document carries for itself - see ../inlineFlight.ts.
+//
+// The server writes each chunk of the render's payload into the document as a
+// script, `self.__rsc_f.push(chunk)`, and a null once it has finished. This
+// turns those into the stream the runtime decodes, as if it had fetched it:
+// what arrived before the runtime ran, then each chunk as it is parsed.
+/**
+ * The document's own payload as a response, or null when it carries none -
+ * a page from a file the build wrote, a server that writes none - and the
+ * runtime fetches it, as it always did.
+ */
+export function inlinePayload() {
+    const w = window;
+    const queue = w.__rsc_f;
+    if (!queue || typeof queue.push !== "function")
+        return null;
+    const encoder = new TextEncoder();
+    const bytes = (chunk) => typeof chunk === "string"
+        ? encoder.encode(chunk)
+        : Uint8Array.from(atob(chunk.b), (c) => c.charCodeAt(0));
+    const body = new ReadableStream({
+        start(controller) {
+            let ended = false;
+            const take = (chunk) => {
+                if (ended)
+                    return;
+                if (chunk === null) {
+                    ended = true;
+                    controller.close();
+                    return;
+                }
+                controller.enqueue(bytes(chunk));
+            };
+            for (let i = 0; i < queue.length; i++)
+                take(queue[i]);
+            queue.length = 0;
+            queue.push = (chunk) => {
+                take(chunk);
+                return 0;
+            };
+            // A document cut off before the server's end marker: what arrived is
+            // all there is, and the decoder is told so rather than left waiting.
+            const finished = () => take(null);
+            if (document.readyState === "loading")
+                document.addEventListener("DOMContentLoaded", finished, { once: true });
+            else
+                finished();
+        },
+    });
+    const headers = { "Content-Type": "text/x-component", "X-RSC-Segment-Depth": "0" };
+    if (typeof w.__rsc_l === "string")
+        headers["X-RSC-Layouts"] = w.__rsc_l;
+    delete w.__rsc_l;
+    return new Response(body, { headers });
+}
+//# sourceMappingURL=inlinePayload.js.map

package/dist/js/inlinePayload.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inlinePayload.js","sourceRoot":"","sources":["../../src/js/inlinePayload.ts"],"names":[],"mappings":"AAAA,sEAAsE;AACtE,EAAE;AACF,8EAA8E;AAC9E,4EAA4E;AAC5E,4EAA4E;AAC5E,wEAAwE;AAQxE;;;;GAIG;AACH,MAAM,UAAU,aAAa;IAC3B,MAAM,CAAC,GAAG,MAA0D,CAAC;IACrE,MAAM,KAAK,GAAG,CAAC,CAAC,OAAO,CAAC;IAExB,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,CAAC,IAAI,KAAK,UAAU;QAAE,OAAO,IAAI,CAAC;IAE5D,MAAM,OAAO,GAAG,IAAI,WAAW,EAAE,CAAC;IAClC,MAAM,KAAK,GAAG,CAAC,KAAc,EAAc,EAAE,CAC3C,OAAO,KAAK,KAAK,QAAQ;QACvB,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC;QACvB,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAE,KAAuB,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;IAEhF,MAAM,IAAI,GAAG,IAAI,cAAc,CAAa;QAC1C,KAAK,CAAC,UAAU;YACd,IAAI,KAAK,GAAG,KAAK,CAAC;YAClB,MAAM,IAAI,GAAG,CAAC,KAAc,EAAE,EAAE;gBAC9B,IAAI,KAAK;oBAAE,OAAO;gBAClB,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;oBACnB,KAAK,GAAG,IAAI,CAAC;oBACb,UAAU,CAAC,KAAK,EAAE,CAAC;oBAEnB,OAAO;gBACT,CAAC;gBACD,UAAU,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;YACnC,CAAC,CAAC;YAEF,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE;gBAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;YACtD,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;YACjB,KAAK,CAAC,IAAI,GAAG,CAAC,KAAc,EAAE,EAAE;gBAC9B,IAAI,CAAC,KAAK,CAAC,CAAC;gBAEZ,OAAO,CAAC,CAAC;YACX,CAAC,CAAC;YAEF,qEAAqE;YACrE,qEAAqE;YACrE,MAAM,QAAQ,GAAG,GAAG,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAElC,IAAI,QAAQ,CAAC,UAAU,KAAK,SAAS;gBAAE,QAAQ,CAAC,gBAAgB,CAAC,kBAAkB,EAAE,QAAQ,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;;gBAC1G,QAAQ,EAAE,CAAC;QAClB,CAAC;KACF,CAAC,CAAC;IAEH,MAAM,OAAO,GAA2B,EAAE,cAAc,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,GAAG,EAAE,CAAC;IAE3G,IAAI,OAAO,CAAC,CAAC,OAAO,KAAK,QAAQ;QAAE,OAAO,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC;IAExE,OAAO,CAAC,CAAC,OAAO,CAAC;IAEjB,OAAO,IAAI,QAAQ,CAAC,IAAI,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;AACzC,CAAC","sourcesContent":["// The payload a document carries for itself - see ../inlineFlight.ts.\n//\n// The server writes each chunk of the render's payload into the document as a\n// script, `self.__rsc_f.push(chunk)`, and a null once it has finished. This\n// turns those into the stream the runtime decodes, as if it had fetched it:\n// what arrived before the runtime ran, then each chunk as it is parsed.\n\ninterface Queue {\n  push(chunk: unknown): number;\n  length: number;\n  [index: number]: unknown;\n}\n\n/**\n * The document's own payload as a response, or null when it carries none -\n * a page from a file the build wrote, a server that writes none - and the\n * runtime fetches it, as it always did.\n */\nexport function inlinePayload(): Response | null {\n  const w = window as unknown as { __rsc_f?: Queue; __rsc_l?: string };\n  const queue = w.__rsc_f;\n\n  if (!queue || typeof queue.push !== \"function\") return null;\n\n  const encoder = new TextEncoder();\n  const bytes = (chunk: unknown): Uint8Array =>\n    typeof chunk === \"string\"\n      ? encoder.encode(chunk)\n      : Uint8Array.from(atob((chunk as { b: string }).b), (c) => c.charCodeAt(0));\n\n  const body = new ReadableStream<Uint8Array>({\n    start(controller) {\n      let ended = false;\n      const take = (chunk: unknown) => {\n        if (ended) return;\n        if (chunk === null) {\n          ended = true;\n          controller.close();\n\n          return;\n        }\n        controller.enqueue(bytes(chunk));\n      };\n\n      for (let i = 0; i < queue.length; i++) take(queue[i]);\n      queue.length = 0;\n      queue.push = (chunk: unknown) => {\n        take(chunk);\n\n        return 0;\n      };\n\n      // A document cut off before the server's end marker: what arrived is\n      // all there is, and the decoder is told so rather than left waiting.\n      const finished = () => take(null);\n\n      if (document.readyState === \"loading\") document.addEventListener(\"DOMContentLoaded\", finished, { once: true });\n      else finished();\n    },\n  });\n\n  const headers: Record<string, string> = { \"Content-Type\": \"text/x-component\", \"X-RSC-Segment-Depth\": \"0\" };\n\n  if (typeof w.__rsc_l === \"string\") headers[\"X-RSC-Layouts\"] = w.__rsc_l;\n\n  delete w.__rsc_l;\n\n  return new Response(body, { headers });\n}\n"]}

package/dist/js/pagePayload.d.ts

@@ -11,4 +11,4 @@
  * a build. Nothing there can be imported by a test, which is how this handling
  * came to have none.
  */
-export declare function fetchPagePayload(url: string, fetchImpl?: typeof fetch, headers?: Record<string, string>): Promise<Response>;
+export declare function fetchPagePayload(url: string, fetchImpl?: typeof fetch): Promise<Response>;

package/dist/js/pagePayload.js

@@ -13,10 +13,10 @@ import { reportReachable } from "./onlineStore";
  * a build. Nothing there can be imported by a test, which is how this handling
  * came to have none.
  */
-export async function fetchPagePayload(url, fetchImpl = fetch, headers = {}) {
+export async function fetchPagePayload(url, fetchImpl = fetch) {
     let response;
     try {
-        response = await fetchImpl(url, { headers: { "X-RSC": "1", ...headers } });
+        response = await fetchImpl(url, { headers: { "X-RSC": "1" } });
     }
     catch (err) {
         // Nothing answered, so the app is offline as far as the router is

package/dist/js/pagePayload.js.map

@@ -1 +1 @@
-{"version":3,"file":"pagePayload.js","sourceRoot":"","sources":["../../src/js/pagePayload.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,MAAM,UAAU,CAAC;AACtE,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAEhD;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,GAAW,EACX,SAAS,GAAiB,KAAK,EAC/B,OAAO,GAA2B,EAAE;IAEpC,IAAI,QAAkB,CAAC;IAEvB,IAAI,CAAC;QACH,QAAQ,GAAG,MAAM,SAAS,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,EAAE,OAAO,EAAE,GAAG,EAAE,GAAG,OAAO,EAAE,EAAE,CAAC,CAAC;IAC7E,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,kEAAkE;QAClE,8CAA8C;QAC9C,eAAe,CAAC,KAAK,CAAC,CAAC;QACvB,mBAAmB,CAAC,kCAAkC,EAAE,GAAG,CAAC,CAAC;QAE7D,MAAM,GAAG,CAAC;IACZ,CAAC;IAED,wCAAwC;IACxC,eAAe,CAAC,IAAI,CAAC,CAAC;IAEtB,IAAI,CAAC;QACH,qBAAqB,CAAC,QAAQ,CAAC,CAAC;IAClC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,mBAAmB,CAAC,uCAAuC,EAAE,GAAG,CAAC,CAAC;QAElE,MAAM,GAAG,CAAC;IACZ,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC","sourcesContent":["import { reportClientFailure, throwForFailedPayload } from \"./errors\";\nimport { reportReachable } from \"./onlineStore\";\n\n/**\n * Fetch the payload the page hydrates from, and account for it failing.\n *\n * This is the one request with nothing watching it. A PPR route's shell is\n * real HTML with a 200, so a page whose payload never arrives looks like it\n * loaded and then sits on its Suspense fallbacks indefinitely — no error, no\n * fallback, nothing an app can react to.\n *\n * Kept apart from createViteRscApp because that module imports the Flight\n * browser runtime, which reaches a Vite virtual module that exists only inside\n * a build. Nothing there can be imported by a test, which is how this handling\n * came to have none.\n */\nexport async function fetchPagePayload(\n  url: string,\n  fetchImpl: typeof fetch = fetch,\n  headers: Record<string, string> = {},\n): Promise<Response> {\n  let response: Response;\n\n  try {\n    response = await fetchImpl(url, { headers: { \"X-RSC\": \"1\", ...headers } });\n  } catch (err) {\n    // Nothing answered, so the app is offline as far as the router is\n    // concerned — which is what useOffline reads.\n    reportReachable(false);\n    reportClientFailure(\"could not fetch the page payload\", err);\n\n    throw err;\n  }\n\n  // Something answered, whatever it said.\n  reportReachable(true);\n\n  try {\n    throwForFailedPayload(response);\n  } catch (err) {\n    reportClientFailure(\"the server could not render this page\", err);\n\n    throw err;\n  }\n\n  return response;\n}\n"]}
+{"version":3,"file":"pagePayload.js","sourceRoot":"","sources":["../../src/js/pagePayload.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,MAAM,UAAU,CAAC;AACtE,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAEhD;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,GAAW,EACX,SAAS,GAAiB,KAAK;IAE/B,IAAI,QAAkB,CAAC;IAEvB,IAAI,CAAC;QACH,QAAQ,GAAG,MAAM,SAAS,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,EAAE,OAAO,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC;IACjE,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,kEAAkE;QAClE,8CAA8C;QAC9C,eAAe,CAAC,KAAK,CAAC,CAAC;QACvB,mBAAmB,CAAC,kCAAkC,EAAE,GAAG,CAAC,CAAC;QAE7D,MAAM,GAAG,CAAC;IACZ,CAAC;IAED,wCAAwC;IACxC,eAAe,CAAC,IAAI,CAAC,CAAC;IAEtB,IAAI,CAAC;QACH,qBAAqB,CAAC,QAAQ,CAAC,CAAC;IAClC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,mBAAmB,CAAC,uCAAuC,EAAE,GAAG,CAAC,CAAC;QAElE,MAAM,GAAG,CAAC;IACZ,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC","sourcesContent":["import { reportClientFailure, throwForFailedPayload } from \"./errors\";\nimport { reportReachable } from \"./onlineStore\";\n\n/**\n * Fetch the payload the page hydrates from, and account for it failing.\n *\n * This is the one request with nothing watching it. A PPR route's shell is\n * real HTML with a 200, so a page whose payload never arrives looks like it\n * loaded and then sits on its Suspense fallbacks indefinitely — no error, no\n * fallback, nothing an app can react to.\n *\n * Kept apart from createViteRscApp because that module imports the Flight\n * browser runtime, which reaches a Vite virtual module that exists only inside\n * a build. Nothing there can be imported by a test, which is how this handling\n * came to have none.\n */\nexport async function fetchPagePayload(\n  url: string,\n  fetchImpl: typeof fetch = fetch,\n): Promise<Response> {\n  let response: Response;\n\n  try {\n    response = await fetchImpl(url, { headers: { \"X-RSC\": \"1\" } });\n  } catch (err) {\n    // Nothing answered, so the app is offline as far as the router is\n    // concerned — which is what useOffline reads.\n    reportReachable(false);\n    reportClientFailure(\"could not fetch the page payload\", err);\n\n    throw err;\n  }\n\n  // Something answered, whatever it said.\n  reportReachable(true);\n\n  try {\n    throwForFailedPayload(response);\n  } catch (err) {\n    reportClientFailure(\"the server could not render this page\", err);\n\n    throw err;\n  }\n\n  return response;\n}\n"]}

package/dist/js/useAction.d.ts

@@ -1,6 +1,9 @@
 import type { ActionResult } from "../action.js";
-type AnyAction = (...args: any[]) => Promise<ActionResult<any>>;
-type DataOf<A extends AnyAction> = Awaited<ReturnType<A>> extends ActionResult<infer D> ? D : never;
+type AnyAction = (...args: any[]) => Promise<ActionResult<any, any>>;
+type DataOf<A extends AnyAction> = Awaited<ReturnType<A>> extends ActionResult<infer D, any> ? D : never;
+type RefusalOf<A extends AnyAction> = Awaited<ReturnType<A>> extends ActionResult<any, infer R> ? R : never;
+/** The whole result, refusal type included - see `.refusal(schema)`. */
+type ResultOf<A extends AnyAction> = ActionResult<DataOf<A>, RefusalOf<A>>;
 export type UseActionStatus = "idle" | "executing" | "hasSucceeded" | "hasErrored";
 export interface UseActionOptions<A extends AnyAction> {
     /**
@@ -17,9 +20,9 @@ export interface UseActionOptions<A extends AnyAction> {
      * validationErrors, the first one - so a button with no field beside it
      * still has something to show.
      */
-    onError?: (message: string, result: ActionResult<DataOf<A>>) => void;
+    onError?: (message: string, result: ResultOf<A>) => void;
     /** After either, for state that tracks the call rather than its outcome. */
-    onSettled?: (result: ActionResult<DataOf<A>>) => void;
+    onSettled?: (result: ResultOf<A>) => void;
 }
 /**
  * Call an action from a button rather than a form.
@@ -46,10 +49,10 @@ export interface UseActionOptions<A extends AnyAction> {
  */
 export declare function useAction<A extends AnyAction>(action: A, options?: UseActionOptions<A>): {
     execute: (...args: Parameters<A>) => void;
-    executeAsync: (...args: Parameters<A>) => Promise<ActionResult<DataOf<A>>>;
+    executeAsync: (...args: Parameters<A>) => Promise<ResultOf<A>>;
     isPending: boolean;
     status: UseActionStatus;
-    result: ActionResult<DataOf<A>>;
+    result: ResultOf<A>;
     reset: () => void;
 };
 export default useAction;

package/dist/js/useAction.js.map

@@ -1 +1 @@
-{"version":3,"file":"useAction.js","sourceRoot":"","sources":["../../src/js/useAction.ts"],"names":[],"mappings":"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","sourcesContent":["\"use client\";\n\nimport { useCallback, useLayoutEffect, useRef, useState, useTransition } from \"react\";\nimport type { ActionResult } from \"../action.js\";\n\n// Any built action: createActionClient's handler(), with or without a schema.\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\ntype AnyAction = (...args: any[]) => Promise<ActionResult<any>>;\n\ntype DataOf<A extends AnyAction> = Awaited<ReturnType<A>> extends ActionResult<infer D> ? D : never;\n\nexport type UseActionStatus = \"idle\" | \"executing\" | \"hasSucceeded\" | \"hasErrored\";\n\nexport interface UseActionOptions<A extends AnyAction> {\n  /**\n   * Called inside the action's transition, before the action runs, with what\n   * it was called with - where React's `useOptimistic` setter goes. React\n   * puts the optimistic state back when the transition ends, so a failed\n   * action takes its change back on its own.\n   */\n  optimistic?: (...args: Parameters<A>) => void;\n  /** The action answered with data: no serverError, no validationErrors. */\n  onSuccess?: (data: DataOf<A>) => void;\n  /**\n   * The action refused or failed. With a serverError, that message; with\n   * validationErrors, the first one - so a button with no field beside it\n   * still has something to show.\n   */\n  onError?: (message: string, result: ActionResult<DataOf<A>>) => void;\n  /** After either, for state that tracks the call rather than its outcome. */\n  onSettled?: (result: ActionResult<DataOf<A>>) => void;\n}\n\n/**\n * Call an action from a button rather than a form.\n *\n *     const { execute, isPending } = useAction(archivePost, {\n *       optimistic: (input) => hide(input.id),\n *       onError: (message) => toast.error(message),\n *     })\n *\n *     <button disabled={isPending} onClick={() => execute({ id })}>Archive</button>\n *\n * The action's own types carry through: `execute` takes what the action's\n * schema takes, and `onSuccess` is handed what its handler returns. A form does\n * not need this - <Form> reads the same result on its own.\n *\n * Neither `execute` nor `executeAsync` throws. An action built on the action\n * client returns its failures, and anything thrown on the way - the network,\n * a server that answered with a page - becomes a serverError: left thrown,\n * the transition never settled and an optimistic change stayed on screen as\n * though the write had worked.\n *\n * An action that redirected settles nothing: no callback runs and no state is\n * set, because the page is on its way somewhere else.\n */\nexport function useAction<A extends AnyAction>(action: A, options: UseActionOptions<A> = {}) {\n  type Result = ActionResult<DataOf<A>>;\n\n  const [isPending, startTransition] = useTransition();\n  const [result, setResult] = useState<Result>({});\n  const [settled, setSettled] = useState<\"hasSucceeded\" | \"hasErrored\" | null>(null);\n\n  // Read when the action runs, not when execute was made: execute keeps one\n  // identity across renders, so an onClick built on it is not rebuilt, and a\n  // callback closing over newer state is still the one called.\n  const latest = useRef({ action, options });\n\n  useLayoutEffect(() => {\n    latest.current = { action, options };\n  });\n\n  const run = useCallback(async (args: Parameters<A>): Promise<Result> => {\n    const { action, options } = latest.current;\n\n    options.optimistic?.(...args);\n\n    let next: Result;\n\n    try {\n      next = (await action(...args)) as Result;\n    } catch (error) {\n      next = { serverError: error instanceof Error ? error.message : String(error) };\n    }\n\n    if (next.redirected !== undefined) return next;\n\n    setResult(next);\n    setSettled(next.serverError !== undefined || next.validationErrors ? \"hasErrored\" : \"hasSucceeded\");\n\n    if (next.serverError !== undefined) {\n      options.onError?.(next.serverError, next);\n    } else if (next.validationErrors) {\n      options.onError?.(Object.values(next.validationErrors).flat()[0] ?? \"Invalid input.\", next);\n    } else {\n      options.onSuccess?.(next.data as DataOf<A>);\n    }\n\n    options.onSettled?.(next);\n\n    return next;\n  }, []);\n\n  const executeAsync = useCallback(\n    (...args: Parameters<A>): Promise<Result> =>\n      new Promise((resolve) => {\n        startTransition(async () => {\n          resolve(await run(args));\n        });\n      }),\n    [run],\n  );\n\n  const execute = useCallback(\n    (...args: Parameters<A>): void => {\n      void executeAsync(...args);\n    },\n    [executeAsync],\n  );\n\n  const reset = useCallback(() => {\n    setResult({});\n    setSettled(null);\n  }, []);\n\n  const status: UseActionStatus = isPending ? \"executing\" : (settled ?? \"idle\");\n\n  return { execute, executeAsync, isPending, status, result, reset };\n}\n\nexport default useAction;\n"]}
+{"version":3,"file":"useAction.js","sourceRoot":"","sources":["../../src/js/useAction.ts"],"names":[],"mappings":"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","sourcesContent":["\"use client\";\n\nimport { useCallback, useLayoutEffect, useRef, useState, useTransition } from \"react\";\nimport type { ActionResult } from \"../action.js\";\n\n// Any built action: createActionClient's handler(), with or without a schema.\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\ntype AnyAction = (...args: any[]) => Promise<ActionResult<any, any>>;\n\ntype DataOf<A extends AnyAction> = Awaited<ReturnType<A>> extends ActionResult<infer D, any> ? D : never;\n\ntype RefusalOf<A extends AnyAction> = Awaited<ReturnType<A>> extends ActionResult<any, infer R> ? R : never;\n\n/** The whole result, refusal type included - see `.refusal(schema)`. */\ntype ResultOf<A extends AnyAction> = ActionResult<DataOf<A>, RefusalOf<A>>;\n\nexport type UseActionStatus = \"idle\" | \"executing\" | \"hasSucceeded\" | \"hasErrored\";\n\nexport interface UseActionOptions<A extends AnyAction> {\n  /**\n   * Called inside the action's transition, before the action runs, with what\n   * it was called with - where React's `useOptimistic` setter goes. React\n   * puts the optimistic state back when the transition ends, so a failed\n   * action takes its change back on its own.\n   */\n  optimistic?: (...args: Parameters<A>) => void;\n  /** The action answered with data: no serverError, no validationErrors. */\n  onSuccess?: (data: DataOf<A>) => void;\n  /**\n   * The action refused or failed. With a serverError, that message; with\n   * validationErrors, the first one - so a button with no field beside it\n   * still has something to show.\n   */\n  onError?: (message: string, result: ResultOf<A>) => void;\n  /** After either, for state that tracks the call rather than its outcome. */\n  onSettled?: (result: ResultOf<A>) => void;\n}\n\n/**\n * Call an action from a button rather than a form.\n *\n *     const { execute, isPending } = useAction(archivePost, {\n *       optimistic: (input) => hide(input.id),\n *       onError: (message) => toast.error(message),\n *     })\n *\n *     <button disabled={isPending} onClick={() => execute({ id })}>Archive</button>\n *\n * The action's own types carry through: `execute` takes what the action's\n * schema takes, and `onSuccess` is handed what its handler returns. A form does\n * not need this - <Form> reads the same result on its own.\n *\n * Neither `execute` nor `executeAsync` throws. An action built on the action\n * client returns its failures, and anything thrown on the way - the network,\n * a server that answered with a page - becomes a serverError: left thrown,\n * the transition never settled and an optimistic change stayed on screen as\n * though the write had worked.\n *\n * An action that redirected settles nothing: no callback runs and no state is\n * set, because the page is on its way somewhere else.\n */\nexport function useAction<A extends AnyAction>(action: A, options: UseActionOptions<A> = {}) {\n  type Result = ResultOf<A>;\n\n  const [isPending, startTransition] = useTransition();\n  const [result, setResult] = useState<Result>({});\n  const [settled, setSettled] = useState<\"hasSucceeded\" | \"hasErrored\" | null>(null);\n\n  // Read when the action runs, not when execute was made: execute keeps one\n  // identity across renders, so an onClick built on it is not rebuilt, and a\n  // callback closing over newer state is still the one called.\n  const latest = useRef({ action, options });\n\n  useLayoutEffect(() => {\n    latest.current = { action, options };\n  });\n\n  const run = useCallback(async (args: Parameters<A>): Promise<Result> => {\n    const { action, options } = latest.current;\n\n    options.optimistic?.(...args);\n\n    let next: Result;\n\n    try {\n      next = (await action(...args)) as Result;\n    } catch (error) {\n      next = { serverError: error instanceof Error ? error.message : String(error) };\n    }\n\n    if (next.redirected !== undefined) return next;\n\n    setResult(next);\n    setSettled(next.serverError !== undefined || next.validationErrors ? \"hasErrored\" : \"hasSucceeded\");\n\n    if (next.serverError !== undefined) {\n      options.onError?.(next.serverError, next);\n    } else if (next.validationErrors) {\n      options.onError?.(Object.values(next.validationErrors).flat()[0] ?? \"Invalid input.\", next);\n    } else {\n      options.onSuccess?.(next.data as DataOf<A>);\n    }\n\n    options.onSettled?.(next);\n\n    return next;\n  }, []);\n\n  const executeAsync = useCallback(\n    (...args: Parameters<A>): Promise<Result> =>\n      new Promise((resolve) => {\n        startTransition(async () => {\n          resolve(await run(args));\n        });\n      }),\n    [run],\n  );\n\n  const execute = useCallback(\n    (...args: Parameters<A>): void => {\n      void executeAsync(...args);\n    },\n    [executeAsync],\n  );\n\n  const reset = useCallback(() => {\n    setResult({});\n    setSettled(null);\n  }, []);\n\n  const status: UseActionStatus = isPending ? \"executing\" : (settled ?? \"idle\");\n\n  return { execute, executeAsync, isPending, status, result, reset };\n}\n\nexport default useAction;\n"]}

package/dist/testHost.d.ts

@@ -102,8 +102,12 @@ export declare const hostReply: {
     readonly unauthorized: (message?: string) => Reply;
     /** Send the visitor somewhere else, as the host's redirect does. */
     readonly redirect: (to: string, status?: number) => Reply;
-    /** Refuse with a status - a 404 for a record this caller cannot see, a 429. */
-    readonly refuse: (status: number, message?: string) => Reply;
+    /**
+     * Refuse with a status - a 404 for a record this caller cannot see, a 429 -
+     * and, optionally, data for the page to act on: what is blocking a delete.
+     * With data it reaches an action as `refuse()` does, as `result.refusal`.
+     */
+    readonly refuse: (status: number, message?: string, data?: unknown) => Reply;
     /** The input was refused, by field: an action returns these as validationErrors. */
     readonly invalid: (errors: Record<string, string[]>) => Reply;
     /** An unexpected failure, as an adapter answers a crash: an error, not a refusal. */

package/dist/testHost.js

@@ -40,8 +40,12 @@ export const hostReply = {
     unauthorized: (message) => reply({ unauthorized: true, error: message }),
     /** Send the visitor somewhere else, as the host's redirect does. */
     redirect: (to, status = 307) => reply({ redirect: to, redirectStatus: status }),
-    /** Refuse with a status - a 404 for a record this caller cannot see, a 429. */
-    refuse: (status, message = 'Refused.') => reply({ error: message, refusalStatus: status }),
+    /**
+     * Refuse with a status - a 404 for a record this caller cannot see, a 429 -
+     * and, optionally, data for the page to act on: what is blocking a delete.
+     * With data it reaches an action as `refuse()` does, as `result.refusal`.
+     */
+    refuse: (status, message = 'Refused.', data) => reply(data === undefined ? { error: message, refusalStatus: status } : { error: message, refusalStatus: status, refusalData: data }),
     /** The input was refused, by field: an action returns these as validationErrors. */
     invalid: (errors) => reply({ validationErrors: errors }),
     /** An unexpected failure, as an adapter answers a crash: an error, not a refusal. */

package/dist/testHost.js.map

@@ -1 +1 @@
-{"version":3,"file":"testHost.js","sourceRoot":"","sources":["../src/testHost.ts"],"names":[],"mappings":"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","sourcesContent":["// A backend for tests: answers rpc() calls and host middleware the way a Go\n// or Laravel host answers them over HTTP, without one running.\n//\n// The app under test talks to it through the real client, httpHostCalls,\n// handed a fetch that answers in-process. So a test exercises what ships -\n// batching, a redirect raised as the engine's own, an unauthenticated reply\n// becoming a 401 - and only the backend is stood in for.\n\nimport type { HostCallReply } from './hostCalls.js'\nimport { CHANGED_FUNCTION, memoryVersions } from './changed.js'\nimport type { ChangedAnswer, ChangedQuery } from './changed.js'\n\nconst REPLY = Symbol.for('rsc-kit.test-host-reply')\n/** Cookies a reply sets: sent as Set-Cookie headers, never in the body. */\nconst COOKIES = Symbol.for('rsc-kit.test-host-cookies')\n\n/** The name the engine asks a host's route guards under. */\nexport const HOST_MIDDLEWARE = '__rsc.middleware'\n\n/**\n * Tag versions for a test host, kept in the test.\n *\n *     const names = testChanges()\n *     const app = await createTestApp({ host: { ...names.host, 'Repos.list': () => repos } })\n *     names.changed('team:1:repos')          // what the backend's webhook would say\n *\n * `host` answers `__rsc.changed` the way an adapter does - holding the call up\n * to `wait` for a name to move - and `changed` moves one.\n */\n/**\n * The test host's answer to `__rsc.changed`: given what any test host is\n * given, answering a `ChangedAnswer`.\n *\n * Both halves matter. It takes `HostCallInput`, so an untyped host of\n * `HostHandler`s accepts it; it returns a `ChangedAnswer`, so a host typed\n * from the app's rsc-host.json - whose `__rsc.changed` must answer one -\n * accepts it too. Typed as `HostHandler`, it returned `unknown`, and\n * spreading it into a typed host did not compile.\n */\nexport interface ChangedHost {\n  [CHANGED_FUNCTION]: (call: HostCallInput) => Promise<ChangedAnswer>\n}\n\nexport function testChanges(): { host: ChangedHost; changed: (...names: string[]) => void } {\n  const source = memoryVersions()\n\n  return {\n    host: {\n      [CHANGED_FUNCTION]: async ({ args }) => {\n        const query = args[0] as Partial<ChangedQuery> | undefined\n\n        return { versions: await source.changed(query?.since ?? {}, Math.min(query?.wait ?? 0, 5_000)) }\n      },\n    },\n    changed: (...names) => void source.bump(names),\n  }\n}\n\n/** What a test handler is given: the call's arguments, and the headers the renderer forwarded. */\nexport interface HostCallInput {\n  args: unknown[]\n  /** The visitor's request headers the renderer passed on - the cookie, the Accept-Language. */\n  headers: Headers\n}\n\n/** Answers one function. Return a value for its result, or one of `hostReply`'s answers. */\nexport type HostHandler = (call: HostCallInput) => unknown\n\ntype Reply = Omit<HostCallReply, 'result'> & { [REPLY]: true }\n\n/** One of the protocol's own answers, from `hostReply`. */\nexport type HostReply = Reply\n\ndeclare global {\n  /**\n   * The backend's functions, as the build read them from rsc-host.json:\n   * each one's arguments and result. Written into .rsc-kit/rsc-env.d.ts;\n   * empty without a manifest.\n   */\n  // eslint-disable-next-line @typescript-eslint/no-empty-object-type\n  interface RscHostFunctions {}\n}\n\ntype Answer<T> = T | HostReply | Promise<T | HostReply>\n\ntype Guards = {\n  [HOST_MIDDLEWARE]?: (call: { args: [names: string[]]; headers: Headers }) => Answer<true>\n  [CHANGED_FUNCTION]?: (call: { args: [query: ChangedQuery]; headers: Headers }) => Answer<ChangedAnswer>\n}\n\n/**\n * The backend's functions, by the name rpc() calls them with.\n *\n * Typed from the app's rsc-host.json when it has one: a handler may only\n * answer for a function the backend has, is given its arguments, and returns\n * its result or one of `hostReply`'s answers - never a shape the backend\n * would not send, which is how a fake drifts from the real thing while its\n * tests stay green. Without a manifest, any name and any value.\n *\n * Route guards declared for the host are asked as `__rsc.middleware`\n * (`HOST_MIDDLEWARE`), with the guard names as the first argument; answer\n * `true` to let the page render.\n */\nexport type TestHost = [keyof RscHostFunctions] extends [never]\n  ? Record<string, HostHandler>\n  : {\n      [K in keyof RscHostFunctions]?: RscHostFunctions[K] extends { args: infer A extends unknown[]; result: infer R }\n        ? (call: { args: A; headers: Headers }) => Answer<R>\n        : never\n    } & Guards\n\nconst reply = (fields: Omit<Reply, typeof REPLY>): Reply => ({ ...fields, [REPLY]: true })\n\n/**\n * The protocol's own answers, for a handler to return.\n *\n *     host: {\n *       'Apps.list': ({ headers }) =>\n *         headers.get('cookie')?.includes('session=') ? [{ id: 1 }] : hostReply.unauthenticated(),\n *       'Apps.create': ({ args }) => hostReply.invalid({ name: ['Taken.'] }),\n *     }\n */\nexport const hostReply = {\n  /** No session: the page answers 401, an action its auth error. */\n  unauthenticated: (message?: string): Reply => reply({ unauthenticated: true, error: message }),\n  /** A session that still may not: 403. */\n  unauthorized: (message?: string): Reply => reply({ unauthorized: true, error: message }),\n  /** Send the visitor somewhere else, as the host's redirect does. */\n  redirect: (to: string, status = 307): Reply => reply({ redirect: to, redirectStatus: status }),\n  /** Refuse with a status - a 404 for a record this caller cannot see, a 429. */\n  refuse: (status: number, message = 'Refused.'): Reply => reply({ error: message, refusalStatus: status }),\n  /** The input was refused, by field: an action returns these as validationErrors. */\n  invalid: (errors: Record<string, string[]>): Reply => reply({ validationErrors: errors }),\n  /** An unexpected failure, as an adapter answers a crash: an error, not a refusal. */\n  fail: (message = 'Something went wrong.'): Reply => reply({ error: message }),\n  /** A result, and the regions of the page the call says it changed. */\n  revalidating: (result: unknown, ...targets: string[]): Reply =>\n    reply({ result, revalidate: targets } as Omit<Reply, typeof REPLY>),\n  /** A result, and cookies set on the response - a login's session: `'session=abc; Path=/; HttpOnly'`. */\n  settingCookies: (result: unknown, ...cookies: string[]): Reply =>\n    reply({ result, [COOKIES]: cookies } as unknown as Omit<Reply, typeof REPLY>),\n} as const\n\nfunction isReply(value: unknown): value is Reply {\n  return typeof value === 'object' && value !== null && (value as Record<symbol, unknown>)[REPLY] === true\n}\n\nasync function answer(host: TestHost, name: string, args: unknown[], headers: Headers): Promise<HostCallReply> {\n  // By a name only known at runtime: a typed host has no index signature.\n  const handler = (host as Record<string, HostHandler | undefined>)[name]\n\n  // Fails the call rather than answering null: a function the test forgot\n  // is a test that would otherwise pass against nothing.\n  if (!handler) {\n    return {\n      error:\n        name === HOST_MIDDLEWARE\n          ? `the page asked its host guards (${JSON.stringify(args[0])}) and the test host has no \"${HOST_MIDDLEWARE}\" handler`\n          : `the test host has no handler for ${JSON.stringify(name)}`,\n    }\n  }\n\n  const value = await handler({ args, headers })\n\n  if (isReply(value)) {\n    // Symbol keys survive the rest spread; COOKIES is read off by the fetch\n    // below, and JSON leaves it out of the body.\n    const { [REPLY]: _, ...fields } = value\n\n    return fields\n  }\n\n  return { result: value === undefined ? null : value }\n}\n\n/**\n * A fetch that answers the host-call endpoint from `host`: one call as\n * itself, a batch as `{ replies }`, in order.\n */\nexport function testHostFetch(host: TestHost): typeof fetch {\n  return (async (_input: RequestInfo | URL, init?: RequestInit) => {\n    const headers = new Headers(init?.headers)\n    const body = JSON.parse(String(init?.body ?? '{}')) as\n      | { function: string; args?: unknown[] }\n      | { calls: { function: string; args?: unknown[] }[] }\n\n    // The renderer's own headers are not the visitor's.\n    headers.delete('x-rsc-host-secret')\n    headers.delete('content-type')\n\n    const json = (value: unknown) =>\n      new Response(JSON.stringify(value), { headers: { 'content-type': 'application/json' } })\n\n    if ('calls' in body) {\n      return json({\n        replies: await Promise.all(body.calls.map((c) => answer(host, c.function, c.args ?? [], headers))),\n      })\n    }\n\n    const single = await answer(host, body.function, body.args ?? [], headers)\n    const cookies = (single as { [COOKIES]?: string[] })[COOKIES] ?? []\n    const response = json(single)\n\n    for (const cookie of cookies) response.headers.append('Set-Cookie', cookie)\n\n    return response\n  }) as typeof fetch\n}\n"]}
+{"version":3,"file":"testHost.js","sourceRoot":"","sources":["../src/testHost.ts"],"names":[],"mappings":"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","sourcesContent":["// A backend for tests: answers rpc() calls and host middleware the way a Go\n// or Laravel host answers them over HTTP, without one running.\n//\n// The app under test talks to it through the real client, httpHostCalls,\n// handed a fetch that answers in-process. So a test exercises what ships -\n// batching, a redirect raised as the engine's own, an unauthenticated reply\n// becoming a 401 - and only the backend is stood in for.\n\nimport type { HostCallReply } from './hostCalls.js'\nimport { CHANGED_FUNCTION, memoryVersions } from './changed.js'\nimport type { ChangedAnswer, ChangedQuery } from './changed.js'\n\nconst REPLY = Symbol.for('rsc-kit.test-host-reply')\n/** Cookies a reply sets: sent as Set-Cookie headers, never in the body. */\nconst COOKIES = Symbol.for('rsc-kit.test-host-cookies')\n\n/** The name the engine asks a host's route guards under. */\nexport const HOST_MIDDLEWARE = '__rsc.middleware'\n\n/**\n * Tag versions for a test host, kept in the test.\n *\n *     const names = testChanges()\n *     const app = await createTestApp({ host: { ...names.host, 'Repos.list': () => repos } })\n *     names.changed('team:1:repos')          // what the backend's webhook would say\n *\n * `host` answers `__rsc.changed` the way an adapter does - holding the call up\n * to `wait` for a name to move - and `changed` moves one.\n */\n/**\n * The test host's answer to `__rsc.changed`: given what any test host is\n * given, answering a `ChangedAnswer`.\n *\n * Both halves matter. It takes `HostCallInput`, so an untyped host of\n * `HostHandler`s accepts it; it returns a `ChangedAnswer`, so a host typed\n * from the app's rsc-host.json - whose `__rsc.changed` must answer one -\n * accepts it too. Typed as `HostHandler`, it returned `unknown`, and\n * spreading it into a typed host did not compile.\n */\nexport interface ChangedHost {\n  [CHANGED_FUNCTION]: (call: HostCallInput) => Promise<ChangedAnswer>\n}\n\nexport function testChanges(): { host: ChangedHost; changed: (...names: string[]) => void } {\n  const source = memoryVersions()\n\n  return {\n    host: {\n      [CHANGED_FUNCTION]: async ({ args }) => {\n        const query = args[0] as Partial<ChangedQuery> | undefined\n\n        return { versions: await source.changed(query?.since ?? {}, Math.min(query?.wait ?? 0, 5_000)) }\n      },\n    },\n    changed: (...names) => void source.bump(names),\n  }\n}\n\n/** What a test handler is given: the call's arguments, and the headers the renderer forwarded. */\nexport interface HostCallInput {\n  args: unknown[]\n  /** The visitor's request headers the renderer passed on - the cookie, the Accept-Language. */\n  headers: Headers\n}\n\n/** Answers one function. Return a value for its result, or one of `hostReply`'s answers. */\nexport type HostHandler = (call: HostCallInput) => unknown\n\ntype Reply = Omit<HostCallReply, 'result'> & { [REPLY]: true }\n\n/** One of the protocol's own answers, from `hostReply`. */\nexport type HostReply = Reply\n\ndeclare global {\n  /**\n   * The backend's functions, as the build read them from rsc-host.json:\n   * each one's arguments and result. Written into .rsc-kit/rsc-env.d.ts;\n   * empty without a manifest.\n   */\n  // eslint-disable-next-line @typescript-eslint/no-empty-object-type\n  interface RscHostFunctions {}\n}\n\ntype Answer<T> = T | HostReply | Promise<T | HostReply>\n\ntype Guards = {\n  [HOST_MIDDLEWARE]?: (call: { args: [names: string[]]; headers: Headers }) => Answer<true>\n  [CHANGED_FUNCTION]?: (call: { args: [query: ChangedQuery]; headers: Headers }) => Answer<ChangedAnswer>\n}\n\n/**\n * The backend's functions, by the name rpc() calls them with.\n *\n * Typed from the app's rsc-host.json when it has one: a handler may only\n * answer for a function the backend has, is given its arguments, and returns\n * its result or one of `hostReply`'s answers - never a shape the backend\n * would not send, which is how a fake drifts from the real thing while its\n * tests stay green. Without a manifest, any name and any value.\n *\n * Route guards declared for the host are asked as `__rsc.middleware`\n * (`HOST_MIDDLEWARE`), with the guard names as the first argument; answer\n * `true` to let the page render.\n */\nexport type TestHost = [keyof RscHostFunctions] extends [never]\n  ? Record<string, HostHandler>\n  : {\n      [K in keyof RscHostFunctions]?: RscHostFunctions[K] extends { args: infer A extends unknown[]; result: infer R }\n        ? (call: { args: A; headers: Headers }) => Answer<R>\n        : never\n    } & Guards\n\nconst reply = (fields: Omit<Reply, typeof REPLY>): Reply => ({ ...fields, [REPLY]: true })\n\n/**\n * The protocol's own answers, for a handler to return.\n *\n *     host: {\n *       'Apps.list': ({ headers }) =>\n *         headers.get('cookie')?.includes('session=') ? [{ id: 1 }] : hostReply.unauthenticated(),\n *       'Apps.create': ({ args }) => hostReply.invalid({ name: ['Taken.'] }),\n *     }\n */\nexport const hostReply = {\n  /** No session: the page answers 401, an action its auth error. */\n  unauthenticated: (message?: string): Reply => reply({ unauthenticated: true, error: message }),\n  /** A session that still may not: 403. */\n  unauthorized: (message?: string): Reply => reply({ unauthorized: true, error: message }),\n  /** Send the visitor somewhere else, as the host's redirect does. */\n  redirect: (to: string, status = 307): Reply => reply({ redirect: to, redirectStatus: status }),\n  /**\n   * Refuse with a status - a 404 for a record this caller cannot see, a 429 -\n   * and, optionally, data for the page to act on: what is blocking a delete.\n   * With data it reaches an action as `refuse()` does, as `result.refusal`.\n   */\n  refuse: (status: number, message = 'Refused.', data?: unknown): Reply =>\n    reply(data === undefined ? { error: message, refusalStatus: status } : { error: message, refusalStatus: status, refusalData: data }),\n  /** The input was refused, by field: an action returns these as validationErrors. */\n  invalid: (errors: Record<string, string[]>): Reply => reply({ validationErrors: errors }),\n  /** An unexpected failure, as an adapter answers a crash: an error, not a refusal. */\n  fail: (message = 'Something went wrong.'): Reply => reply({ error: message }),\n  /** A result, and the regions of the page the call says it changed. */\n  revalidating: (result: unknown, ...targets: string[]): Reply =>\n    reply({ result, revalidate: targets } as Omit<Reply, typeof REPLY>),\n  /** A result, and cookies set on the response - a login's session: `'session=abc; Path=/; HttpOnly'`. */\n  settingCookies: (result: unknown, ...cookies: string[]): Reply =>\n    reply({ result, [COOKIES]: cookies } as unknown as Omit<Reply, typeof REPLY>),\n} as const\n\nfunction isReply(value: unknown): value is Reply {\n  return typeof value === 'object' && value !== null && (value as Record<symbol, unknown>)[REPLY] === true\n}\n\nasync function answer(host: TestHost, name: string, args: unknown[], headers: Headers): Promise<HostCallReply> {\n  // By a name only known at runtime: a typed host has no index signature.\n  const handler = (host as Record<string, HostHandler | undefined>)[name]\n\n  // Fails the call rather than answering null: a function the test forgot\n  // is a test that would otherwise pass against nothing.\n  if (!handler) {\n    return {\n      error:\n        name === HOST_MIDDLEWARE\n          ? `the page asked its host guards (${JSON.stringify(args[0])}) and the test host has no \"${HOST_MIDDLEWARE}\" handler`\n          : `the test host has no handler for ${JSON.stringify(name)}`,\n    }\n  }\n\n  const value = await handler({ args, headers })\n\n  if (isReply(value)) {\n    // Symbol keys survive the rest spread; COOKIES is read off by the fetch\n    // below, and JSON leaves it out of the body.\n    const { [REPLY]: _, ...fields } = value\n\n    return fields\n  }\n\n  return { result: value === undefined ? null : value }\n}\n\n/**\n * A fetch that answers the host-call endpoint from `host`: one call as\n * itself, a batch as `{ replies }`, in order.\n */\nexport function testHostFetch(host: TestHost): typeof fetch {\n  return (async (_input: RequestInfo | URL, init?: RequestInit) => {\n    const headers = new Headers(init?.headers)\n    const body = JSON.parse(String(init?.body ?? '{}')) as\n      | { function: string; args?: unknown[] }\n      | { calls: { function: string; args?: unknown[] }[] }\n\n    // The renderer's own headers are not the visitor's.\n    headers.delete('x-rsc-host-secret')\n    headers.delete('content-type')\n\n    const json = (value: unknown) =>\n      new Response(JSON.stringify(value), { headers: { 'content-type': 'application/json' } })\n\n    if ('calls' in body) {\n      return json({\n        replies: await Promise.all(body.calls.map((c) => answer(host, c.function, c.args ?? [], headers))),\n      })\n    }\n\n    const single = await answer(host, body.function, body.args ?? [], headers)\n    const cookies = (single as { [COOKIES]?: string[] })[COOKIES] ?? []\n    const response = json(single)\n\n    for (const cookie of cookies) response.headers.append('Set-Cookie', cookie)\n\n    return response\n  }) as typeof fetch\n}\n"]}

package/dist/vite.js

@@ -3023,10 +3023,9 @@ import { isSharedSection, sectionComponent } from ${JSON.stringify(join(packageD
 import { shareRender } from ${JSON.stringify(join(packageDir, "sharedRenders"))}
 import { PathnameProvider } from ${JSON.stringify(join(packageDir, "js/PathnameProvider"))}
 import { DefaultRouteError } from ${JSON.stringify(join(packageDir, "js/DefaultRouteError"))}
-import { requestFromCrawler, requestSearch, searchParams as requestSearchParams, withUrl } from ${JSON.stringify(join(packageDir, "request"))}
+import { requestFromCrawler, requestSearch, searchParams as requestSearchParams, withRequest, withUrl } from ${JSON.stringify(join(packageDir, "request"))}
 import { parseParams, parseSearchParams, parseBody, isSearchParamsError, isBodyError } from ${JSON.stringify(join(packageDir, "routeSchema"))}
 import { notFoundDigest, isNotFoundSignal } from ${JSON.stringify(join(packageDir, "notFound"))}
-import { bootToken } from ${JSON.stringify(join(packageDir, "bootPayloads"))}
 import { noteRequestRead, notePageProps, urlOf } from ${JSON.stringify(join(packageDir, "request"))}
 import { redirectDigest } from ${JSON.stringify(join(packageDir, "redirectDigest"))}
 import { cancelledByConsumer } from ${JSON.stringify(join(packageDir, "js/fallbackReport"))}
@@ -4538,7 +4537,7 @@ export async function handleRscHtmlStream(
   nonce?: string,
   pageKey = '',
   bootstrap = true,
-): Promise<{ htmlStream: ReadableStream; rscPayload: ReadableStream; bootToken?: string; clientChunks: unknown }> {
+): Promise<{ htmlStream: ReadableStream; rscPayload?: ReadableStream; clientChunks: unknown }> {
   await instrumented()
   applyHost()
   await runMiddleware(component, props)
@@ -4546,18 +4545,21 @@ export async function handleRscHtmlStream(
     await renderTree(component, props, layouts, loadings, parallelSlots, slotOverrides, 0, pageKey, bootstrap),
     { onError: flightOnError },
   )
-  // Written into the bootstrap script, so it is in the document before the
-  // runtime that reads it. Only where there is a runtime: a page shipping
-  // none never comes back for a payload.
-  const token = bootstrap ? bootToken() : undefined
-  // The same tree twice: one copy becomes the HTML, the other is the payload
-  // the browser comes back for to hydrate. The host holds it for that fetch
-  // - see bootPayloads.ts - so a visit renders once. Streamed, not read to a
-  // string: it used to be buffered whole here and never read by anyone.
-  const [forHtml, rscPayload] = flight.tee()
   const ssr = await (import.meta as any).viteRsc.loadModule('ssr', 'index')
-  const htmlStream = await ssr.handleSsr(forHtml, nonce, undefined, bootstrap, undefined, requestSearch(), requestFromCrawler(), token)
-  return { htmlStream, rscPayload, bootToken: token, clientChunks: {} }
+
+  // A page with no runtime hydrates nothing: straight into the HTML.
+  if (!bootstrap) {
+    const htmlStream = await ssr.handleSsr(flight, nonce, undefined, bootstrap, undefined, requestSearch(), requestFromCrawler())
+    return { htmlStream, clientChunks: {} }
+  }
+
+  // One render: the HTML from one copy, and from the other the payload the
+  // browser hydrates from, which the host streams into the document - see
+  // inlineFlight.ts. It used to be fetched by the browser, and that fetch
+  // rendered the whole page again.
+  const [forHtml, rscPayload] = flight.tee()
+  const htmlStream = await ssr.handleSsr(forHtml, nonce, undefined, bootstrap, undefined, requestSearch(), requestFromCrawler(), true)
+  return { htmlStream, rscPayload, clientChunks: {} }
 }
 
 /**
@@ -4641,7 +4643,7 @@ export async function handleRscResume(
   // hole by construction: at build the params never settled, so anything
   // reading them was postponed.
   params?: Record<string, string>,
-): Promise<{ htmlStream: ReadableStream; replayed: () => boolean; rscPayload: ReadableStream }> {
+): Promise<{ htmlStream: ReadableStream }> {
   await instrumented()
   applyHost()
   await runMiddleware(component, params ?? props)
@@ -4691,9 +4693,8 @@ export async function handleRscResume(
   // client-rendered. Set before the stream ends, because that is when
   // React reports it.
   let replayFailed = false
-  // The same tree twice, as handleRscHtmlStream: the holes for the HTML, and
-  // the payload the browser comes back for. The host holds the second for
-  // that fetch - one render per visit.
+  // The holes for the HTML, and the payload the browser hydrates from, from
+  // the same render.
   const [forHtml, rscPayload] = flight.tee()
   const htmlStream = await ssr.handleSsrResume(
     forHtml,
@@ -5650,6 +5651,43 @@ ${fallbackOrigin === false ? NO_FALLBACK_BODY : FALLBACK_BODY}}
  * Without a not-found.tsx this is the string it always was.
  */
 async function notFound(request: Request): Promise<Response> {
+  // In the request's own scope. The host opens one around everything it
+  // answers, and this is what is left once it has declined the url - so the
+  // scope it had has closed. not-found.tsx, and the layouts it renders in,
+  // read the request like any page: a cart badge, who is signed in. Outside
+  // a scope that was "No request in scope", and the visitor got the bare
+  // string below instead of the app.
+  //
+  // Only for a request that can show a page. A url no route owns, asked for
+  // by an <img>, a <script>, a stylesheet - a browser's /favicon.ico, which
+  // Lighthouse asks for on every run - cannot display not-found.tsx, and
+  // rendering it ran every layout above it, cookie reads and queries
+  // included, for an image request. Those get a plain 404 at once.
+  if (!pageSaidNotFound(request) && !wantsPage(request)) {
+    return new Response('Not found', { status: 404, headers: { 'Content-Type': 'text/plain; charset=utf-8' } })
+  }
+
+  return await withRequest(request, () => renderNotFound(request))
+}
+
+/**
+ * Whether the request can display a page: a navigation, an iframe, the
+ * router's own payload request, or - from a client that does not say where
+ * the answer goes - one that accepts HTML. Decided by what the request says
+ * it wants, never by the url's extension: a route serving /sitemap.xml never
+ * reaches this.
+ */
+function wantsPage(request: Request): boolean {
+  if (request.headers.get('X-RSC')) return true
+
+  const dest = request.headers.get('Sec-Fetch-Dest')
+
+  if (dest) return dest === 'document' || dest === 'iframe' || dest === 'frame'
+
+  return (request.headers.get('Accept') ?? '').includes('text/html')
+}
+
+async function renderNotFound(request: Request): Promise<Response> {
   ${notFoundComponent
         ? `
   // A navigation, not a document: answer with the not-found tree as a
@@ -5764,9 +5802,9 @@ export async function handleSsr(
   // A crawler's request: answered once everything has rendered - see
   // crawler.ts - so the host reads the page's final word on its status.
   whole = false,
-  // The boot token: the document's render kept its payload under it, and
-  // the runtime redeems it instead of asking for a second render.
-  bootToken?: string,
+  // The host streams the payload into this document - see inlineFlight.ts.
+  // Declared here so the runtime knows before its first chunk arrives.
+  inline = false,
 ): Promise<ReadableStream> {
   const root = withSearch(await createFromReadableStream(rscStream), search)
 
@@ -5777,9 +5815,8 @@ export async function handleSsr(
   // seconds before the runtime hydrates is held for it rather than given
   // to the browser as a document load. See earlyClicks.ts.
   const bootstrapScriptContent = bootstrap
-    ? (bootToken ? 'self.__rsc_boot=' + JSON.stringify(bootToken) + ';' : '') +
-      EARLY +
-      (await (import.meta as any).viteRsc.loadBootstrapScriptContent('index'))
+    ? (inline ? 'self.__rsc_f=self.__rsc_f||[];' : '') +
+      EARLY + (await (import.meta as any).viteRsc.loadBootstrapScriptContent('index'))
     : undefined
 
   // Without an onError handler React rejects each abortable task on its own,