@rsc-kit/core 0.22.8 → 0.23.0

package/dist/js/createViteRscApp.js

@@ -20,7 +20,7 @@ import { ServerRedirectError, noteRedirected, throwForFailedAction } from "./err
 import { fetchPagePayload } from "./pagePayload";
 import { claimRead, setQueryCodec } from "./queryClient";
 import { clearSegments, dropHidden, isHeld, prerenderSegment, restoreSegments, setSegment } from "./segmentStore";
-import { cancelPrefetch, isPrefetched, navigate, setApiRoutes, refresh, applyRevalidations, prefetch, retentionKey, setCallServer, setHeldLayouts, setStaticPayloads, setStaticRoutes, seedStaticChain, payloadUrl, setDeserializer, setInterceptManifest, getHeldLayouts, setNavigateHandler, setHeldHandlers, setPrerenderHandler, setReplaceRootHandler, setRestoreHandler, setVersion, } from "./navigate";
+import { cancelPrefetch, forgetOtherPages, isPrefetched, navigate, setApiRoutes, refresh, applyRevalidations, prefetch, retentionKey, setCallServer, setHeldLayouts, setStaticPayloads, setStaticRoutes, seedStaticChain, payloadUrl, setDeserializer, setInterceptManifest, getHeldLayouts, setNavigateHandler, setHeldHandlers, setPrerenderHandler, setReplaceRootHandler, setRestoreHandler, setVersion, } from "./navigate";
 /**
  * A redirect that travelled as an error: the digest of the error itself, or
  * of the cause React wraps it in when it reports client-rendering a boundary
@@ -114,7 +114,15 @@ export async function createViteRscApp(container = document, interceptEntries =
                 // state dropped, pending went false - and the page it redirected to
                 // arrived a frame later. A new chat's first message vanished from
                 // the thread and came back with its reply.
+                //
+                // Asked of the server, never revealed from what the router holds. The
+                // action may have changed anything the destination reads - a cookie,
+                // a membership, a row - and a page kept from before it, or prefetched
+                // before it, shows the world as it was: a sign-in that redirected
+                // back showed the page signed out until a reload. What a revalidating
+                // action already drops, a redirecting one drops too.
                 if (isSafeRedirect(err.location)) {
+                    forgetOtherPages();
                     try {
                         await navigate(err.location, { replace: true });
                     }

package/dist/js/createViteRscApp.js.map

@@ -1 +1 @@
-{"version":3,"file":"createViteRscApp.js","sourceRoot":"","sources":["../../src/js/createViteRscApp.ts"],"names":[],"mappings":"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","sourcesContent":["// Vite-engine client bootstrap. Uses @vitejs/plugin-rsc's browser runtime as\n// the Flight deserializer + action encoder, and drives the package's engine-agnostic\n// navigate.ts SPA engine (Link, prefetch, popstate) through it. This replaces\n// the bun engine's createRscApp + the hand-rolled webpack shim — the plugin\n// resolves client references itself.\nimport { SEARCH_PARAMS_FALLBACK } from \"./useSearchParams\";\nimport { recoverFromStaleAssets } from \"./staleAssets\";\nimport { afterHydration, replayEarlyClicks } from \"./earlyClicks\";\nimport { parseRedirectDigest } from \"../redirectDigest.js\";\nimport { showDevNotice } from \"./devNotice\";\nimport { caughtByLoading } from \"./fallbackReport\";\nimport { noteNavigation } from \"./segmentStore\";\nimport type { Route } from \"../routes.js\";\nimport { isSafeRedirect } from \"../safeUrl.js\";\nimport {\n  createFromReadableStream,\n  encodeReply,\n  setServerCallback,\n} from \"@vitejs/plugin-rsc/browser\";\nimport { createElement, startTransition } from \"react\";\nimport { createRoot, hydrateRoot } from \"react-dom/client\";\nimport { activityMarkersIn } from \"./activityMarkers\";\nimport { ActivityRoot } from \"./ActivityRouter\";\nimport { ServerRedirectError, noteRedirected, throwForFailedAction } from \"./errors\";\nimport { fetchPagePayload } from \"./pagePayload\";\nimport { claimRead, setQueryCodec } from \"./queryClient\";\nimport { clearSegments, dropHidden, isHeld, prerenderSegment, restoreSegments, setSegment } from \"./segmentStore\";\nimport type { ReactNode } from \"react\";\nimport {\n  cancelPrefetch,\n  isPrefetched,\n  navigate,\n  setApiRoutes,\n  refresh,\n  applyRevalidations,\n  prefetch,\n  retentionKey,\n  setCallServer,\n  setHeldLayouts,\n  setStaticPayloads,\n  setStaticRoutes,\n  seedStaticChain,\n  payloadUrl,\n  setDeserializer,\n  setInterceptManifest,\n  getHeldLayouts,\n  setNavigateHandler,\n  setHeldHandlers,\n  setPrerenderHandler,\n  setReplaceRootHandler,\n  setRestoreHandler,\n  setVersion,\n} from \"./navigate\";\n\n\n/**\n * A redirect that travelled as an error: the digest of the error itself, or\n * of the cause React wraps it in when it reports client-rendering a boundary\n * the server had already failed.\n */\nfunction isRedirect(error: unknown): boolean {\n  const digest = (error as { digest?: unknown } | null)?.digest;\n  const cause = (error as { cause?: { digest?: unknown } } | null)?.cause;\n\n  return parseRedirectDigest(digest) !== null || parseRedirectDigest(cause?.digest) !== null;\n}\n\nexport async function createViteRscApp(\n  container: Document | Element = document,\n  interceptEntries: { urlPattern: string; slot: string }[] = [],\n  options: { staticPayloads?: string | null; routes?: unknown[] | null; apiRoutes?: string[] } = {},\n): Promise<void> {\n  // The urls a route.ts answers: a link to one is an anchor, never a\n  // prefetch, never a payload fetch.\n  if (options.apiRoutes) setApiRoutes(options.apiRoutes);\n  // An exported build has no server to negotiate with, so payloads live at\n  // their own urls rather than behind a header on the page's url.\n  setStaticPayloads(options.staticPayloads ?? null);\n  // Only an exported build ships this: with no server to negotiate with, the\n  // client works out for itself how much of a page it still holds.\n  if (options.routes) setStaticRoutes(options.routes as never);\n  // The router has to recognise an intercepted link before it asks the server,\n  // so the patterns are baked into the generated browser entry. Without them\n  // every intercepted route falls through to a full-page navigation.\n  setInterceptManifest(interceptEntries);\n\n  async function callServer(id: string, args: unknown[]): Promise<unknown> {\n    // A read opened a slot before calling the reference, and this is the first\n    // point at which the id exists on the client — React keeps it private and\n    // hands it over only here. Claiming the slot enqueues the read for the\n    // batched GET instead of posting it.\n    const read = claimRead(id, args);\n\n    if (read) return await read;\n\n    const encoded = await encodeReply(args);\n\n    // encodeReply returns FormData as soon as an argument contains a File.\n    // Sending that as multipart would make PHP consume php://input while\n    // parsing it, leaving the action with an empty body — so serialize it to\n    // raw bytes under an opaque content-type and send the real one in\n    // X-RSC-Content-Type for the worker to rebuild FormData from.\n    let body: BodyInit;\n    let realContentType: string;\n\n    if (encoded instanceof FormData) {\n      const serialized = new Response(encoded);\n      body = await serialized.arrayBuffer();\n      realContentType =\n        serialized.headers.get(\"content-type\") ?? \"multipart/form-data\";\n    } else {\n      body = encoded as BodyInit;\n      realContentType = \"text/plain;charset=UTF-8\";\n    }\n\n    // Where the action was invoked from. The host resolves it to the\n    // components that render the page, so anything the action says it\n    // invalidated can come back with the answer instead of being fetched\n    // afterwards - and what comes back is for this page, not whichever is\n    // showing when it lands.\n    const from = window.location.pathname + window.location.search;\n\n    const res = await fetch(\"/_rsc/action\", {\n      method: \"POST\",\n      headers: {\n        \"X-RSC-Action\": id,\n        \"X-RSC-Referer\": from,\n        \"X-RSC-Content-Type\": realContentType,\n        \"Content-Type\": \"application/octet-stream\",\n        \"X-XSRF-TOKEN\": decodeURIComponent(\n          document.cookie.match(/XSRF-TOKEN=([^;]+)/)?.[1] ?? \"\",\n        ),\n      },\n      body,\n    });\n\n    // A failed action does not answer with a Flight stream, and the decoder\n    // cannot tell — it reports its own parse failure instead of what the\n    // server said.\n    try {\n      await throwForFailedAction(res);\n    } catch (err) {\n      // A redirect is an instruction, not something for a form to display:\n      // an expired session answers this way, and the destination is the login\n      // page rather than a message about one.\n      if (err instanceof ServerRedirectError) {\n        // The destination came off a response header, so it is checked here\n        // too — the engine refuses these at the source, but a proxy or a host\n        // in front of it can write whatever it likes. A navigation, not a\n        // document load: the layouts stay mounted and the history entry the\n        // form was on is replaced, the way a redirect after a POST should\n        // be - Back does not return to the submitted form.\n        //\n        // Awaited, so the action is still pending when the destination's\n        // tree is handed to React: the two are one transition, committed\n        // together. Not awaited, the action ended first - its optimistic\n        // state dropped, pending went false - and the page it redirected to\n        // arrived a frame later. A new chat's first message vanished from\n        // the thread and came back with its reply.\n        if (isSafeRedirect(err.location)) {\n          try {\n            await navigate(err.location as Route, { replace: true });\n          } catch {\n            // Announced by the navigation itself, as rsc-navigate-error. The\n            // action did redirect; that is still its answer.\n          }\n        }\n\n        // Performed, so resolved - not thrown. The call's answer is \"you are\n        // being taken somewhere\": an object saying so, the shape an action's\n        // result already has, so a caller reading result.validationErrors\n        // reads undefined rather than throwing. A caller that awaited the\n        // action in a plain startTransition had no catch for a throw, the\n        // rejection reached React, and the root unmounted to a white page\n        // on every logout.\n        noteRedirected(err.location);\n\n        return { redirected: err.location };\n      }\n\n      throw err;\n    }\n\n    const answer = await createFromReadableStream(res.body!, { callServer });\n\n    return unwrapRevalidated(answer, from);\n  }\n\n  /**\n   * Put anything the action re-rendered on screen, and hand back its result.\n   *\n   * The trees travel with the answer rather than being fetched afterwards, so\n   * the caller sees only what its action returned and never knows the page\n   * was updated around it.\n   */\n  function unwrapRevalidated(answer: unknown, from: string): unknown {\n    if (\n      answer === null ||\n      typeof answer !== \"object\" ||\n      !(\"__rscRevalidated\" in answer)\n    ) {\n      return answer;\n    }\n\n    const envelope = answer as {\n      __rscRevalidated: Record<string, unknown>;\n      result: unknown;\n    };\n\n    applyRevalidations(from, envelope.__rscRevalidated as Record<string, ReactNode>);\n\n    return envelope.result;\n  }\n\n  setDeserializer(createFromReadableStream as never);\n  // The query transport speaks Flight too, and reaches the runtime through here\n  // rather than importing it: a second import of the browser runtime from the\n  // client-component graph is a second client-reference registry, and the\n  // symptom is components that render as undefined with nothing logged.\n  setQueryCodec({\n    deserialize: (stream) =>\n      createFromReadableStream(stream, { callServer }) as Promise<unknown>,\n    encode: (args) => encodeReply(args) as Promise<string | FormData>,\n    // The way back when a read cannot ride in a url. Re-entering callServer is\n    // safe: the slot was cleared the moment the reference returned, so this\n    // takes the ordinary POST path rather than claiming a read again.\n    asAction: (id, args) => callServer(id, args),\n  });\n  setCallServer(callServer);\n  // The plugin's own \"use server\" client stubs route through its registered\n  // server callback — register the same transport there too.\n  setServerCallback(callServer as never);\n\n  // Link / Form / router live in a separate build graph and reach the SPA\n  // engine through these globals.\n  (window as unknown as { __rsc_navigate: typeof navigate }).__rsc_navigate =\n    navigate;\n  (window as unknown as { __rsc_prefetch: typeof prefetch }).__rsc_prefetch =\n    prefetch;\n  (\n    window as unknown as { __rsc_cancel_prefetch: typeof cancelPrefetch }\n  ).__rsc_cancel_prefetch = cancelPrefetch;\n  (\n    window as unknown as { __rsc_is_prefetched: typeof isPrefetched }\n  ).__rsc_is_prefetched = isPrefetched;\n  (window as unknown as { __rsc_refresh: typeof refresh }).__rsc_refresh =\n    refresh;\n\n  // Hydrate from the RSC endpoint (same url + X-RSC, no version header).\n  //\n  // Everything from here to the decode is failure handling, because this is\n  // the one request with nothing watching it. A page whose shell is already\n  // rendered looks fine while this fails, and its fallbacks stay on screen\n  // indefinitely with nothing reported anywhere.\n  const res = await fetchPagePayload(payloadUrl(window.location.href));\n\n  // Seed the router with the build this DOCUMENT is, so a redeploy is caught\n  // on the next navigation: the host answers 409 to a client of another\n  // build, and the document is loaded again. From the document's own meta\n  // first - a document a service worker served from its cache is the last\n  // build's, while the payload just fetched is this one's, and seeding from\n  // the payload would have the old client claim to be new. The header is\n  // the fallback for a document with no meta.\n  const documentBuild = document.querySelector('meta[name=\"rsc-kit:build\"]')?.getAttribute(\"content\");\n  const servedVersion = documentBuild || res.headers.get(\"X-RSC-Version\");\n\n  if (servedVersion) {\n    setVersion(servedVersion);\n  }\n\n  // The chain this page is built from, so the next navigation can say what is\n  // already mounted and be sent only what changed.\n  // A server says what this page is built from; a file server says nothing,\n  // so an exported build works it out from the table it was given.\n  const servedLayouts = res.headers.get(\"X-RSC-Layouts\");\n\n  if (servedLayouts !== null) {\n    setHeldLayouts(servedLayouts.split(\",\"));\n  } else if (!seedStaticChain(window.location.href)) {\n    setHeldLayouts([]);\n  }\n  const tree = await createFromReadableStream(res.body!, { callServer });\n\n  // Retaining the previous page behind <Activity> needs a wrapper above the\n  // page, and React will not hydrate a *document* container through one: the\n  // root child of a document has to be <html>, and wrapping it hangs the\n  // renderer outright (React 19.2.7). An app whose root layout owns <html>\n  // therefore hydrates the tree directly and navigations replace it, as before.\n  //\n  // Apps that hydrate into an element get retention. Giving it to document-\n  // rooted apps means SPA navigation returning only the changed segment rather\n  // than a whole document, which is an engine change, not a client one.\n  const retains = container !== document;\n\n  const shell = retains\n    ? createElement(ActivityRoot, {\n        initialKey: retentionKey(window.location.href, null),\n        initialTree: tree as ReactNode,\n      })\n    : (tree as ReactNode);\n\n  // A document that cannot be hydrated by this tree is client-rendered\n  // instead - a repaint, not a freeze. React 19.2 does not recover from a\n  // hydration mismatch at an <Activity>: it retries hydrating the boundary,\n  // mismatches again, and never returns to the main thread. Every segment\n  // boundary is an Activity, one per layout, so a document with none where\n  // the page has layouts is that mismatch, guaranteed, before React starts.\n  // What produced one: a parameterised route's PPR shell, rendered without\n  // a page key and, by a build before this one, without the Activities too.\n  // None rather than fewer: a boundary inside a Suspense hole the shell left\n  // unfinished has no marker and is client-rendered by React on its own,\n  // which is not a mismatch. The stale-asset reload does not apply - the\n  // document would come back the same.\n  const missing = retains && getHeldLayouts().length > 0 && activityMarkersIn(container) === 0;\n\n  if (missing) {\n    console.warn(\n      \"[rsc-kit] The document has no <Activity> boundaries where the page has layouts, so it cannot be hydrated; rendering the page instead. A PPR shell built by an earlier release lacks them - rebuild.\",\n    );\n  }\n\n  // The payload answered with an error status - the not-found page for a\n  // url the shell was served for anyway. It is not the document on screen,\n  // so it is rendered, not hydrated: a mismatch at an Activity is the loop\n  // above, and this one is certain.\n  const disagrees = !res.ok;\n\n  const onRecoverableError = (error: unknown, errorInfo: unknown) => {\n      // A client component whose chunk the server no longer has fails while\n      // hydrating, and React reports that as recoverable: the page is loaded\n      // again, with the current names.\n      if (recoverFromStaleAssets(error)) return;\n\n      // A redirect decided inside a boundary: the server's row carried it as\n      // the digest, React client-renders the boundary and reports that it\n      // did, and the RedirectBoundary is already performing it. Nothing to\n      // read in the console about a page doing what it was told.\n      if (isRedirect(error)) return;\n\n      // A PPR shell is served with its Suspense boundaries deliberately\n      // unfinished — the build aborts the render once the static part is out.\n      // React reports that as #419 and client-renders the boundary from the\n      // Flight payload, which is the intended path, not a fault to report.\n      const message = String((error as { message?: string })?.message ?? error);\n\n      if (\n        message.includes(\"419\") ||\n        message.includes(\"did not finish this Suspense boundary\")\n      ) {\n        return;\n      }\n\n      // A view transition the browser cancelled because the tab was not\n      // visible. React reports it here; the update still landed, and a tab\n      // in the background is not a fault in the page.\n      if (message.includes(\"Transition was aborted\")) return;\n\n      // A navigation another one overtook: its request was aborted, and a\n      // row of its payload that a component was still reading rejects with\n      // the abort. React recovers by rendering the root again synchronously\n      // and reports the recovery here as #520, with the abort as the cause.\n      // The page it recovered to is the one the second navigation asked for;\n      // the abort was the design, not a fault.\n      const cause = (error as { cause?: { name?: string; message?: string } } | null)?.cause;\n\n      if (\n        cause?.name === \"AbortError\" ||\n        /\\baborted\\b/i.test(cause?.message ?? \"\") ||\n        /\\baborted\\b/i.test(message)\n      ) {\n        return;\n      }\n      // A page whose query string was read under a boundary carries the\n      // fallback there; React reports the recovery on hydration. Under a\n      // boundary the developer wrote, that is the designed path and nothing\n      // is said. With nothing closer than a loading.tsx, the whole segment\n      // showed the fallback until the query arrived - said here, in the\n      // page and the console, for whoever is looking at either. Production\n      // has no stack to tell the two apart; the build's note on the route is\n      // the record there.\n      if (\n        (error as { digest?: string })?.digest === SEARCH_PARAMS_FALLBACK ||\n        message.includes(\"useSearchParams()\")\n      ) {\n        const stack = (errorInfo as { componentStack?: string } | null)\n          ?.componentStack;\n\n        if (!caughtByLoading(stack)) return;\n\n        const hint =\n          \"useSearchParams() was read on the server with nothing closer than a loading.tsx, so the \" +\n          \"whole segment showed that fallback until the query arrived. A <Suspense> around the \" +\n          \"component that reads keeps the rest of the page painted.\";\n\n        showDevNotice(hint, stack);\n        console.error(new Error(hint), errorInfo);\n\n        return;\n      }\n\n      console.error(error, errorInfo);\n  };\n\n  const rootOptions = {\n    onRecoverableError,\n    // A chunk the deploy no longer serves is not a fault in the page; the\n    // document is loaded again, and the new names come with it. Anything\n    // else is reported the way React would have.\n    onUncaughtError(error: unknown, errorInfo: unknown) {\n      if (recoverFromStaleAssets(error)) return;\n\n      console.error(error, errorInfo);\n    },\n    onCaughtError(error: unknown, errorInfo: unknown) {\n      if (recoverFromStaleAssets(error)) return;\n      // Caught by the RedirectBoundary, which is performing it.\n      if (isRedirect(error)) return;\n\n      console.error(error, errorInfo);\n    },\n  };\n\n  const root = missing || disagrees\n    ? (() => {\n        const created = createRoot(container as Element, rootOptions);\n\n        created.render(shell);\n\n        return created;\n      })()\n    : hydrateRoot(container, shell, rootOptions);\n\n  // Depth 0 is a whole document and replaces the root. Anything deeper is one\n  // segment: handing it to the boundary at that depth leaves the layouts above\n  // it mounted, which is the point of asking for a partial render at all.\n  setNavigateHandler((tree: unknown, key: string, segmentDepth: number, inPlaceOf?: string | null) => {\n    const newTree = tree as ReactNode;\n\n    // From here on the boundary animates; the seed commit before this did not.\n    noteNavigation();\n\n    if (segmentDepth > 0) {\n      setSegment(segmentDepth, key, newTree, inPlaceOf);\n\n      return;\n    }\n\n    clearSegments();\n    root.render(newTree);\n  });\n\n  // The whole document again, in place - revalidate(\"all\"). Not through the\n  // handler above: that clears the boundaries and renders the tree as a new\n  // page, and a boundary emptied re-keys its Activity to the current url and\n  // remounts everything under it. A port's \"added to cart\" went with the\n  // form's state that way, on every product reached by a link. Here the root\n  // takes the tree in a transition and each boundary hands its page the new\n  // children under the key it has - see replaceActive.\n  setReplaceRootHandler((tree: unknown) => {\n    startTransition(() => root.render(tree as ReactNode));\n  });\n\n  // Back and forward reveal a page the boundaries are still holding, with the\n  // form you were filling in still filled in, and without asking the server.\n  setRestoreHandler((key: string, maxAge?: number) =>\n    restoreSegments(key, maxAge),\n  );\n  setHeldHandlers(isHeld, dropHidden);\n\n  // A touch or a settled hover: the page is rendered hidden now, and the\n  // click reveals it. See warm() in navigate.ts and prerenderSegment.\n  setPrerenderHandler((tree: unknown, key: string, segmentDepth: number) => {\n    prerenderSegment(segmentDepth, key, tree as ReactNode);\n  });\n\n  window.addEventListener(\"popstate\", () => {\n    // restore: back and forward reveal the page you were on, with its state.\n    // Wherever the browser just went; not a literal this app wrote.\n    navigate(window.location.href as Route, { replace: true, restore: true });\n  });\n\n  history.replaceState(\n    { rscUrl: window.location.href },\n    \"\",\n    window.location.href,\n  );\n\n  // A tap held by the bootstrap script, navigated to once hydration has\n  // committed - not now: the runtime's script running is seconds before\n  // React can dispatch a click on a phone still downloading chunks, and\n  // a tap in that window would be the browser's. See earlyClicks.ts.\n  afterHydration(() => replayEarlyClicks((url) => navigate(url as Route)));\n}\n\n"]}
+{"version":3,"file":"createViteRscApp.js","sourceRoot":"","sources":["../../src/js/createViteRscApp.ts"],"names":[],"mappings":"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","sourcesContent":["// Vite-engine client bootstrap. Uses @vitejs/plugin-rsc's browser runtime as\n// the Flight deserializer + action encoder, and drives the package's engine-agnostic\n// navigate.ts SPA engine (Link, prefetch, popstate) through it. This replaces\n// the bun engine's createRscApp + the hand-rolled webpack shim — the plugin\n// resolves client references itself.\nimport { SEARCH_PARAMS_FALLBACK } from \"./useSearchParams\";\nimport { recoverFromStaleAssets } from \"./staleAssets\";\nimport { afterHydration, replayEarlyClicks } from \"./earlyClicks\";\nimport { parseRedirectDigest } from \"../redirectDigest.js\";\nimport { showDevNotice } from \"./devNotice\";\nimport { caughtByLoading } from \"./fallbackReport\";\nimport { noteNavigation } from \"./segmentStore\";\nimport type { Route } from \"../routes.js\";\nimport { isSafeRedirect } from \"../safeUrl.js\";\nimport {\n  createFromReadableStream,\n  encodeReply,\n  setServerCallback,\n} from \"@vitejs/plugin-rsc/browser\";\nimport { createElement, startTransition } from \"react\";\nimport { createRoot, hydrateRoot } from \"react-dom/client\";\nimport { activityMarkersIn } from \"./activityMarkers\";\nimport { ActivityRoot } from \"./ActivityRouter\";\nimport { ServerRedirectError, noteRedirected, throwForFailedAction } from \"./errors\";\nimport { fetchPagePayload } from \"./pagePayload\";\nimport { claimRead, setQueryCodec } from \"./queryClient\";\nimport { clearSegments, dropHidden, isHeld, prerenderSegment, restoreSegments, setSegment } from \"./segmentStore\";\nimport type { ReactNode } from \"react\";\nimport {\n  cancelPrefetch,\n  forgetOtherPages,\n  isPrefetched,\n  navigate,\n  setApiRoutes,\n  refresh,\n  applyRevalidations,\n  prefetch,\n  retentionKey,\n  setCallServer,\n  setHeldLayouts,\n  setStaticPayloads,\n  setStaticRoutes,\n  seedStaticChain,\n  payloadUrl,\n  setDeserializer,\n  setInterceptManifest,\n  getHeldLayouts,\n  setNavigateHandler,\n  setHeldHandlers,\n  setPrerenderHandler,\n  setReplaceRootHandler,\n  setRestoreHandler,\n  setVersion,\n} from \"./navigate\";\n\n\n/**\n * A redirect that travelled as an error: the digest of the error itself, or\n * of the cause React wraps it in when it reports client-rendering a boundary\n * the server had already failed.\n */\nfunction isRedirect(error: unknown): boolean {\n  const digest = (error as { digest?: unknown } | null)?.digest;\n  const cause = (error as { cause?: { digest?: unknown } } | null)?.cause;\n\n  return parseRedirectDigest(digest) !== null || parseRedirectDigest(cause?.digest) !== null;\n}\n\nexport async function createViteRscApp(\n  container: Document | Element = document,\n  interceptEntries: { urlPattern: string; slot: string }[] = [],\n  options: { staticPayloads?: string | null; routes?: unknown[] | null; apiRoutes?: string[] } = {},\n): Promise<void> {\n  // The urls a route.ts answers: a link to one is an anchor, never a\n  // prefetch, never a payload fetch.\n  if (options.apiRoutes) setApiRoutes(options.apiRoutes);\n  // An exported build has no server to negotiate with, so payloads live at\n  // their own urls rather than behind a header on the page's url.\n  setStaticPayloads(options.staticPayloads ?? null);\n  // Only an exported build ships this: with no server to negotiate with, the\n  // client works out for itself how much of a page it still holds.\n  if (options.routes) setStaticRoutes(options.routes as never);\n  // The router has to recognise an intercepted link before it asks the server,\n  // so the patterns are baked into the generated browser entry. Without them\n  // every intercepted route falls through to a full-page navigation.\n  setInterceptManifest(interceptEntries);\n\n  async function callServer(id: string, args: unknown[]): Promise<unknown> {\n    // A read opened a slot before calling the reference, and this is the first\n    // point at which the id exists on the client — React keeps it private and\n    // hands it over only here. Claiming the slot enqueues the read for the\n    // batched GET instead of posting it.\n    const read = claimRead(id, args);\n\n    if (read) return await read;\n\n    const encoded = await encodeReply(args);\n\n    // encodeReply returns FormData as soon as an argument contains a File.\n    // Sending that as multipart would make PHP consume php://input while\n    // parsing it, leaving the action with an empty body — so serialize it to\n    // raw bytes under an opaque content-type and send the real one in\n    // X-RSC-Content-Type for the worker to rebuild FormData from.\n    let body: BodyInit;\n    let realContentType: string;\n\n    if (encoded instanceof FormData) {\n      const serialized = new Response(encoded);\n      body = await serialized.arrayBuffer();\n      realContentType =\n        serialized.headers.get(\"content-type\") ?? \"multipart/form-data\";\n    } else {\n      body = encoded as BodyInit;\n      realContentType = \"text/plain;charset=UTF-8\";\n    }\n\n    // Where the action was invoked from. The host resolves it to the\n    // components that render the page, so anything the action says it\n    // invalidated can come back with the answer instead of being fetched\n    // afterwards - and what comes back is for this page, not whichever is\n    // showing when it lands.\n    const from = window.location.pathname + window.location.search;\n\n    const res = await fetch(\"/_rsc/action\", {\n      method: \"POST\",\n      headers: {\n        \"X-RSC-Action\": id,\n        \"X-RSC-Referer\": from,\n        \"X-RSC-Content-Type\": realContentType,\n        \"Content-Type\": \"application/octet-stream\",\n        \"X-XSRF-TOKEN\": decodeURIComponent(\n          document.cookie.match(/XSRF-TOKEN=([^;]+)/)?.[1] ?? \"\",\n        ),\n      },\n      body,\n    });\n\n    // A failed action does not answer with a Flight stream, and the decoder\n    // cannot tell — it reports its own parse failure instead of what the\n    // server said.\n    try {\n      await throwForFailedAction(res);\n    } catch (err) {\n      // A redirect is an instruction, not something for a form to display:\n      // an expired session answers this way, and the destination is the login\n      // page rather than a message about one.\n      if (err instanceof ServerRedirectError) {\n        // The destination came off a response header, so it is checked here\n        // too — the engine refuses these at the source, but a proxy or a host\n        // in front of it can write whatever it likes. A navigation, not a\n        // document load: the layouts stay mounted and the history entry the\n        // form was on is replaced, the way a redirect after a POST should\n        // be - Back does not return to the submitted form.\n        //\n        // Awaited, so the action is still pending when the destination's\n        // tree is handed to React: the two are one transition, committed\n        // together. Not awaited, the action ended first - its optimistic\n        // state dropped, pending went false - and the page it redirected to\n        // arrived a frame later. A new chat's first message vanished from\n        // the thread and came back with its reply.\n        //\n        // Asked of the server, never revealed from what the router holds. The\n        // action may have changed anything the destination reads - a cookie,\n        // a membership, a row - and a page kept from before it, or prefetched\n        // before it, shows the world as it was: a sign-in that redirected\n        // back showed the page signed out until a reload. What a revalidating\n        // action already drops, a redirecting one drops too.\n        if (isSafeRedirect(err.location)) {\n          forgetOtherPages();\n\n          try {\n            await navigate(err.location as Route, { replace: true });\n          } catch {\n            // Announced by the navigation itself, as rsc-navigate-error. The\n            // action did redirect; that is still its answer.\n          }\n        }\n\n        // Performed, so resolved - not thrown. The call's answer is \"you are\n        // being taken somewhere\": an object saying so, the shape an action's\n        // result already has, so a caller reading result.validationErrors\n        // reads undefined rather than throwing. A caller that awaited the\n        // action in a plain startTransition had no catch for a throw, the\n        // rejection reached React, and the root unmounted to a white page\n        // on every logout.\n        noteRedirected(err.location);\n\n        return { redirected: err.location };\n      }\n\n      throw err;\n    }\n\n    const answer = await createFromReadableStream(res.body!, { callServer });\n\n    return unwrapRevalidated(answer, from);\n  }\n\n  /**\n   * Put anything the action re-rendered on screen, and hand back its result.\n   *\n   * The trees travel with the answer rather than being fetched afterwards, so\n   * the caller sees only what its action returned and never knows the page\n   * was updated around it.\n   */\n  function unwrapRevalidated(answer: unknown, from: string): unknown {\n    if (\n      answer === null ||\n      typeof answer !== \"object\" ||\n      !(\"__rscRevalidated\" in answer)\n    ) {\n      return answer;\n    }\n\n    const envelope = answer as {\n      __rscRevalidated: Record<string, unknown>;\n      result: unknown;\n    };\n\n    applyRevalidations(from, envelope.__rscRevalidated as Record<string, ReactNode>);\n\n    return envelope.result;\n  }\n\n  setDeserializer(createFromReadableStream as never);\n  // The query transport speaks Flight too, and reaches the runtime through here\n  // rather than importing it: a second import of the browser runtime from the\n  // client-component graph is a second client-reference registry, and the\n  // symptom is components that render as undefined with nothing logged.\n  setQueryCodec({\n    deserialize: (stream) =>\n      createFromReadableStream(stream, { callServer }) as Promise<unknown>,\n    encode: (args) => encodeReply(args) as Promise<string | FormData>,\n    // The way back when a read cannot ride in a url. Re-entering callServer is\n    // safe: the slot was cleared the moment the reference returned, so this\n    // takes the ordinary POST path rather than claiming a read again.\n    asAction: (id, args) => callServer(id, args),\n  });\n  setCallServer(callServer);\n  // The plugin's own \"use server\" client stubs route through its registered\n  // server callback — register the same transport there too.\n  setServerCallback(callServer as never);\n\n  // Link / Form / router live in a separate build graph and reach the SPA\n  // engine through these globals.\n  (window as unknown as { __rsc_navigate: typeof navigate }).__rsc_navigate =\n    navigate;\n  (window as unknown as { __rsc_prefetch: typeof prefetch }).__rsc_prefetch =\n    prefetch;\n  (\n    window as unknown as { __rsc_cancel_prefetch: typeof cancelPrefetch }\n  ).__rsc_cancel_prefetch = cancelPrefetch;\n  (\n    window as unknown as { __rsc_is_prefetched: typeof isPrefetched }\n  ).__rsc_is_prefetched = isPrefetched;\n  (window as unknown as { __rsc_refresh: typeof refresh }).__rsc_refresh =\n    refresh;\n\n  // Hydrate from the RSC endpoint (same url + X-RSC, no version header).\n  //\n  // Everything from here to the decode is failure handling, because this is\n  // the one request with nothing watching it. A page whose shell is already\n  // rendered looks fine while this fails, and its fallbacks stay on screen\n  // indefinitely with nothing reported anywhere.\n  const res = await fetchPagePayload(payloadUrl(window.location.href));\n\n  // Seed the router with the build this DOCUMENT is, so a redeploy is caught\n  // on the next navigation: the host answers 409 to a client of another\n  // build, and the document is loaded again. From the document's own meta\n  // first - a document a service worker served from its cache is the last\n  // build's, while the payload just fetched is this one's, and seeding from\n  // the payload would have the old client claim to be new. The header is\n  // the fallback for a document with no meta.\n  const documentBuild = document.querySelector('meta[name=\"rsc-kit:build\"]')?.getAttribute(\"content\");\n  const servedVersion = documentBuild || res.headers.get(\"X-RSC-Version\");\n\n  if (servedVersion) {\n    setVersion(servedVersion);\n  }\n\n  // The chain this page is built from, so the next navigation can say what is\n  // already mounted and be sent only what changed.\n  // A server says what this page is built from; a file server says nothing,\n  // so an exported build works it out from the table it was given.\n  const servedLayouts = res.headers.get(\"X-RSC-Layouts\");\n\n  if (servedLayouts !== null) {\n    setHeldLayouts(servedLayouts.split(\",\"));\n  } else if (!seedStaticChain(window.location.href)) {\n    setHeldLayouts([]);\n  }\n  const tree = await createFromReadableStream(res.body!, { callServer });\n\n  // Retaining the previous page behind <Activity> needs a wrapper above the\n  // page, and React will not hydrate a *document* container through one: the\n  // root child of a document has to be <html>, and wrapping it hangs the\n  // renderer outright (React 19.2.7). An app whose root layout owns <html>\n  // therefore hydrates the tree directly and navigations replace it, as before.\n  //\n  // Apps that hydrate into an element get retention. Giving it to document-\n  // rooted apps means SPA navigation returning only the changed segment rather\n  // than a whole document, which is an engine change, not a client one.\n  const retains = container !== document;\n\n  const shell = retains\n    ? createElement(ActivityRoot, {\n        initialKey: retentionKey(window.location.href, null),\n        initialTree: tree as ReactNode,\n      })\n    : (tree as ReactNode);\n\n  // A document that cannot be hydrated by this tree is client-rendered\n  // instead - a repaint, not a freeze. React 19.2 does not recover from a\n  // hydration mismatch at an <Activity>: it retries hydrating the boundary,\n  // mismatches again, and never returns to the main thread. Every segment\n  // boundary is an Activity, one per layout, so a document with none where\n  // the page has layouts is that mismatch, guaranteed, before React starts.\n  // What produced one: a parameterised route's PPR shell, rendered without\n  // a page key and, by a build before this one, without the Activities too.\n  // None rather than fewer: a boundary inside a Suspense hole the shell left\n  // unfinished has no marker and is client-rendered by React on its own,\n  // which is not a mismatch. The stale-asset reload does not apply - the\n  // document would come back the same.\n  const missing = retains && getHeldLayouts().length > 0 && activityMarkersIn(container) === 0;\n\n  if (missing) {\n    console.warn(\n      \"[rsc-kit] The document has no <Activity> boundaries where the page has layouts, so it cannot be hydrated; rendering the page instead. A PPR shell built by an earlier release lacks them - rebuild.\",\n    );\n  }\n\n  // The payload answered with an error status - the not-found page for a\n  // url the shell was served for anyway. It is not the document on screen,\n  // so it is rendered, not hydrated: a mismatch at an Activity is the loop\n  // above, and this one is certain.\n  const disagrees = !res.ok;\n\n  const onRecoverableError = (error: unknown, errorInfo: unknown) => {\n      // A client component whose chunk the server no longer has fails while\n      // hydrating, and React reports that as recoverable: the page is loaded\n      // again, with the current names.\n      if (recoverFromStaleAssets(error)) return;\n\n      // A redirect decided inside a boundary: the server's row carried it as\n      // the digest, React client-renders the boundary and reports that it\n      // did, and the RedirectBoundary is already performing it. Nothing to\n      // read in the console about a page doing what it was told.\n      if (isRedirect(error)) return;\n\n      // A PPR shell is served with its Suspense boundaries deliberately\n      // unfinished — the build aborts the render once the static part is out.\n      // React reports that as #419 and client-renders the boundary from the\n      // Flight payload, which is the intended path, not a fault to report.\n      const message = String((error as { message?: string })?.message ?? error);\n\n      if (\n        message.includes(\"419\") ||\n        message.includes(\"did not finish this Suspense boundary\")\n      ) {\n        return;\n      }\n\n      // A view transition the browser cancelled because the tab was not\n      // visible. React reports it here; the update still landed, and a tab\n      // in the background is not a fault in the page.\n      if (message.includes(\"Transition was aborted\")) return;\n\n      // A navigation another one overtook: its request was aborted, and a\n      // row of its payload that a component was still reading rejects with\n      // the abort. React recovers by rendering the root again synchronously\n      // and reports the recovery here as #520, with the abort as the cause.\n      // The page it recovered to is the one the second navigation asked for;\n      // the abort was the design, not a fault.\n      const cause = (error as { cause?: { name?: string; message?: string } } | null)?.cause;\n\n      if (\n        cause?.name === \"AbortError\" ||\n        /\\baborted\\b/i.test(cause?.message ?? \"\") ||\n        /\\baborted\\b/i.test(message)\n      ) {\n        return;\n      }\n      // A page whose query string was read under a boundary carries the\n      // fallback there; React reports the recovery on hydration. Under a\n      // boundary the developer wrote, that is the designed path and nothing\n      // is said. With nothing closer than a loading.tsx, the whole segment\n      // showed the fallback until the query arrived - said here, in the\n      // page and the console, for whoever is looking at either. Production\n      // has no stack to tell the two apart; the build's note on the route is\n      // the record there.\n      if (\n        (error as { digest?: string })?.digest === SEARCH_PARAMS_FALLBACK ||\n        message.includes(\"useSearchParams()\")\n      ) {\n        const stack = (errorInfo as { componentStack?: string } | null)\n          ?.componentStack;\n\n        if (!caughtByLoading(stack)) return;\n\n        const hint =\n          \"useSearchParams() was read on the server with nothing closer than a loading.tsx, so the \" +\n          \"whole segment showed that fallback until the query arrived. A <Suspense> around the \" +\n          \"component that reads keeps the rest of the page painted.\";\n\n        showDevNotice(hint, stack);\n        console.error(new Error(hint), errorInfo);\n\n        return;\n      }\n\n      console.error(error, errorInfo);\n  };\n\n  const rootOptions = {\n    onRecoverableError,\n    // A chunk the deploy no longer serves is not a fault in the page; the\n    // document is loaded again, and the new names come with it. Anything\n    // else is reported the way React would have.\n    onUncaughtError(error: unknown, errorInfo: unknown) {\n      if (recoverFromStaleAssets(error)) return;\n\n      console.error(error, errorInfo);\n    },\n    onCaughtError(error: unknown, errorInfo: unknown) {\n      if (recoverFromStaleAssets(error)) return;\n      // Caught by the RedirectBoundary, which is performing it.\n      if (isRedirect(error)) return;\n\n      console.error(error, errorInfo);\n    },\n  };\n\n  const root = missing || disagrees\n    ? (() => {\n        const created = createRoot(container as Element, rootOptions);\n\n        created.render(shell);\n\n        return created;\n      })()\n    : hydrateRoot(container, shell, rootOptions);\n\n  // Depth 0 is a whole document and replaces the root. Anything deeper is one\n  // segment: handing it to the boundary at that depth leaves the layouts above\n  // it mounted, which is the point of asking for a partial render at all.\n  setNavigateHandler((tree: unknown, key: string, segmentDepth: number, inPlaceOf?: string | null) => {\n    const newTree = tree as ReactNode;\n\n    // From here on the boundary animates; the seed commit before this did not.\n    noteNavigation();\n\n    if (segmentDepth > 0) {\n      setSegment(segmentDepth, key, newTree, inPlaceOf);\n\n      return;\n    }\n\n    clearSegments();\n    root.render(newTree);\n  });\n\n  // The whole document again, in place - revalidate(\"all\"). Not through the\n  // handler above: that clears the boundaries and renders the tree as a new\n  // page, and a boundary emptied re-keys its Activity to the current url and\n  // remounts everything under it. A port's \"added to cart\" went with the\n  // form's state that way, on every product reached by a link. Here the root\n  // takes the tree in a transition and each boundary hands its page the new\n  // children under the key it has - see replaceActive.\n  setReplaceRootHandler((tree: unknown) => {\n    startTransition(() => root.render(tree as ReactNode));\n  });\n\n  // Back and forward reveal a page the boundaries are still holding, with the\n  // form you were filling in still filled in, and without asking the server.\n  setRestoreHandler((key: string, maxAge?: number) =>\n    restoreSegments(key, maxAge),\n  );\n  setHeldHandlers(isHeld, dropHidden);\n\n  // A touch or a settled hover: the page is rendered hidden now, and the\n  // click reveals it. See warm() in navigate.ts and prerenderSegment.\n  setPrerenderHandler((tree: unknown, key: string, segmentDepth: number) => {\n    prerenderSegment(segmentDepth, key, tree as ReactNode);\n  });\n\n  window.addEventListener(\"popstate\", () => {\n    // restore: back and forward reveal the page you were on, with its state.\n    // Wherever the browser just went; not a literal this app wrote.\n    navigate(window.location.href as Route, { replace: true, restore: true });\n  });\n\n  history.replaceState(\n    { rscUrl: window.location.href },\n    \"\",\n    window.location.href,\n  );\n\n  // A tap held by the bootstrap script, navigated to once hydration has\n  // committed - not now: the runtime's script running is seconds before\n  // React can dispatch a click on a phone still downloading chunks, and\n  // a tap in that window would be the browser's. See earlyClicks.ts.\n  afterHydration(() => replayEarlyClicks((url) => navigate(url as Route)));\n}\n\n"]}

package/dist/js/useAction.d.ts

@@ -0,0 +1,55 @@
+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;
+export type UseActionStatus = "idle" | "executing" | "hasSucceeded" | "hasErrored";
+export interface UseActionOptions<A extends AnyAction> {
+    /**
+     * Called inside the action's transition, before the action runs, with what
+     * it was called with - where React's `useOptimistic` setter goes. React
+     * puts the optimistic state back when the transition ends, so a failed
+     * action takes its change back on its own.
+     */
+    optimistic?: (...args: Parameters<A>) => void;
+    /** The action answered with data: no serverError, no validationErrors. */
+    onSuccess?: (data: DataOf<A>) => void;
+    /**
+     * The action refused or failed. With a serverError, that message; with
+     * 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;
+    /** After either, for state that tracks the call rather than its outcome. */
+    onSettled?: (result: ActionResult<DataOf<A>>) => void;
+}
+/**
+ * Call an action from a button rather than a form.
+ *
+ *     const { execute, isPending } = useAction(archivePost, {
+ *       optimistic: (input) => hide(input.id),
+ *       onError: (message) => toast.error(message),
+ *     })
+ *
+ *     <button disabled={isPending} onClick={() => execute({ id })}>Archive</button>
+ *
+ * The action's own types carry through: `execute` takes what the action's
+ * schema takes, and `onSuccess` is handed what its handler returns. A form does
+ * not need this - <Form> reads the same result on its own.
+ *
+ * Neither `execute` nor `executeAsync` throws. An action built on the action
+ * client returns its failures, and anything thrown on the way - the network,
+ * a server that answered with a page - becomes a serverError: left thrown,
+ * the transition never settled and an optimistic change stayed on screen as
+ * though the write had worked.
+ *
+ * An action that redirected settles nothing: no callback runs and no state is
+ * set, because the page is on its way somewhere else.
+ */
+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>>>;
+    isPending: boolean;
+    status: UseActionStatus;
+    result: ActionResult<DataOf<A>>;
+    reset: () => void;
+};
+export default useAction;

package/dist/js/useAction.js

@@ -0,0 +1,79 @@
+"use client";
+import { useCallback, useLayoutEffect, useRef, useState, useTransition } from "react";
+/**
+ * Call an action from a button rather than a form.
+ *
+ *     const { execute, isPending } = useAction(archivePost, {
+ *       optimistic: (input) => hide(input.id),
+ *       onError: (message) => toast.error(message),
+ *     })
+ *
+ *     <button disabled={isPending} onClick={() => execute({ id })}>Archive</button>
+ *
+ * The action's own types carry through: `execute` takes what the action's
+ * schema takes, and `onSuccess` is handed what its handler returns. A form does
+ * not need this - <Form> reads the same result on its own.
+ *
+ * Neither `execute` nor `executeAsync` throws. An action built on the action
+ * client returns its failures, and anything thrown on the way - the network,
+ * a server that answered with a page - becomes a serverError: left thrown,
+ * the transition never settled and an optimistic change stayed on screen as
+ * though the write had worked.
+ *
+ * An action that redirected settles nothing: no callback runs and no state is
+ * set, because the page is on its way somewhere else.
+ */
+export function useAction(action, options = {}) {
+    const [isPending, startTransition] = useTransition();
+    const [result, setResult] = useState({});
+    const [settled, setSettled] = useState(null);
+    // Read when the action runs, not when execute was made: execute keeps one
+    // identity across renders, so an onClick built on it is not rebuilt, and a
+    // callback closing over newer state is still the one called.
+    const latest = useRef({ action, options });
+    useLayoutEffect(() => {
+        latest.current = { action, options };
+    });
+    const run = useCallback(async (args) => {
+        const { action, options } = latest.current;
+        options.optimistic?.(...args);
+        let next;
+        try {
+            next = (await action(...args));
+        }
+        catch (error) {
+            next = { serverError: error instanceof Error ? error.message : String(error) };
+        }
+        if (next.redirected !== undefined)
+            return next;
+        setResult(next);
+        setSettled(next.serverError !== undefined || next.validationErrors ? "hasErrored" : "hasSucceeded");
+        if (next.serverError !== undefined) {
+            options.onError?.(next.serverError, next);
+        }
+        else if (next.validationErrors) {
+            options.onError?.(Object.values(next.validationErrors).flat()[0] ?? "Invalid input.", next);
+        }
+        else {
+            options.onSuccess?.(next.data);
+        }
+        options.onSettled?.(next);
+        return next;
+    }, []);
+    const executeAsync = useCallback((...args) => new Promise((resolve) => {
+        startTransition(async () => {
+            resolve(await run(args));
+        });
+    }), [run]);
+    const execute = useCallback((...args) => {
+        void executeAsync(...args);
+    }, [executeAsync]);
+    const reset = useCallback(() => {
+        setResult({});
+        setSettled(null);
+    }, []);
+    const status = isPending ? "executing" : (settled ?? "idle");
+    return { execute, executeAsync, isPending, status, result, reset };
+}
+export default useAction;
+//# sourceMappingURL=useAction.js.map

package/dist/js/useAction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAction.js","sourceRoot":"","sources":["../../src/js/useAction.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AA+BtF;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,UAAU,SAAS,CAAsB,MAAS,EAAE,OAAO,GAAwB,EAAE;IAGzF,MAAM,CAAC,SAAS,EAAE,eAAe,CAAC,GAAG,aAAa,EAAE,CAAC;IACrD,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,QAAQ,CAAS,EAAE,CAAC,CAAC;IACjD,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,GAAG,QAAQ,CAAuC,IAAI,CAAC,CAAC;IAEnF,0EAA0E;IAC1E,2EAA2E;IAC3E,6DAA6D;IAC7D,MAAM,MAAM,GAAG,MAAM,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC;IAE3C,eAAe,CAAC,GAAG,EAAE;QACnB,MAAM,CAAC,OAAO,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;IACvC,CAAC,CAAC,CAAC;IAEH,MAAM,GAAG,GAAG,WAAW,CAAC,KAAK,EAAE,IAAmB,EAAmB,EAAE;QACrE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC,OAAO,CAAC;QAE3C,OAAO,CAAC,UAAU,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC;QAE9B,IAAI,IAAY,CAAC;QAEjB,IAAI,CAAC;YACH,IAAI,GAAG,CAAC,MAAM,MAAM,CAAC,GAAG,IAAI,CAAC,CAAW,CAAC;QAC3C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,GAAG,EAAE,WAAW,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;QACjF,CAAC;QAED,IAAI,IAAI,CAAC,UAAU,KAAK,SAAS;YAAE,OAAO,IAAI,CAAC;QAE/C,SAAS,CAAC,IAAI,CAAC,CAAC;QAChB,UAAU,CAAC,IAAI,CAAC,WAAW,KAAK,SAAS,IAAI,IAAI,CAAC,gBAAgB,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC;QAEpG,IAAI,IAAI,CAAC,WAAW,KAAK,SAAS,EAAE,CAAC;YACnC,OAAO,CAAC,OAAO,EAAE,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;QAC5C,CAAC;aAAM,IAAI,IAAI,CAAC,gBAAgB,EAAE,CAAC;YACjC,OAAO,CAAC,OAAO,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,gBAAgB,EAAE,IAAI,CAAC,CAAC;QAC9F,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,SAAS,EAAE,CAAC,IAAI,CAAC,IAAiB,CAAC,CAAC;QAC9C,CAAC;QAED,OAAO,CAAC,SAAS,EAAE,CAAC,IAAI,CAAC,CAAC;QAE1B,OAAO,IAAI,CAAC;IACd,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,MAAM,YAAY,GAAG,WAAW,CAC9B,CAAC,GAAG,IAAmB,EAAmB,EAAE,CAC1C,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QACtB,eAAe,CAAC,KAAK,IAAI,EAAE;YACzB,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;QAC3B,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,EACJ,CAAC,GAAG,CAAC,CACN,CAAC;IAEF,MAAM,OAAO,GAAG,WAAW,CACzB,CAAC,GAAG,IAAmB,EAAQ,EAAE;QAC/B,KAAK,YAAY,CAAC,GAAG,IAAI,CAAC,CAAC;IAC7B,CAAC,EACD,CAAC,YAAY,CAAC,CACf,CAAC;IAEF,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE;QAC7B,SAAS,CAAC,EAAE,CAAC,CAAC;QACd,UAAU,CAAC,IAAI,CAAC,CAAC;IACnB,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,MAAM,MAAM,GAAoB,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,OAAO,IAAI,MAAM,CAAC,CAAC;IAE9E,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;AACrE,CAAC;AAED,eAAe,SAAS,CAAC","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"]}

package/dist/testHost.d.ts

@@ -0,0 +1,53 @@
+import type { HostCallReply } from './hostCalls.js';
+declare const REPLY: unique symbol;
+/** The name the engine asks a host's route guards under. */
+export declare const HOST_MIDDLEWARE = "__rsc.middleware";
+/** What a test handler is given: the call's arguments, and the headers the renderer forwarded. */
+export interface HostCallInput {
+    args: unknown[];
+    /** The visitor's request headers the renderer passed on - the cookie, the Accept-Language. */
+    headers: Headers;
+}
+/** Answers one function. Return a value for its result, or one of `hostReply`'s answers. */
+export type HostHandler = (call: HostCallInput) => unknown;
+/**
+ * The backend's functions, by the name rpc() calls them with.
+ *
+ * Route guards declared for the host are asked as `__rsc.middleware`
+ * (`HOST_MIDDLEWARE`), with the guard names as the first argument; answer
+ * `true` to let the page render. Anything else refuses, as a real host's
+ * answer would.
+ */
+export type TestHost = Record<string, HostHandler>;
+type Reply = Omit<HostCallReply, 'result'> & {
+    [REPLY]: true;
+};
+/**
+ * The protocol's own answers, for a handler to return.
+ *
+ *     host: {
+ *       'Apps.list': ({ headers }) =>
+ *         headers.get('cookie')?.includes('session=') ? [{ id: 1 }] : hostReply.unauthenticated(),
+ *       'Apps.create': ({ args }) => hostReply.invalid({ name: ['Taken.'] }),
+ *     }
+ */
+export declare const hostReply: {
+    /** No session: the page answers 401, an action its auth error. */
+    readonly unauthenticated: (message?: string) => Reply;
+    /** A session that still may not: 403. */
+    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;
+    /** The input was refused, by field: an action returns these as validationErrors. */
+    readonly invalid: (errors: Record<string, string[]>) => Reply;
+    /** A result, and the regions of the page the call says it changed. */
+    readonly revalidating: (result: unknown, ...targets: string[]) => Reply;
+};
+/**
+ * A fetch that answers the host-call endpoint from `host`: one call as
+ * itself, a batch as `{ replies }`, in order.
+ */
+export declare function testHostFetch(host: TestHost): typeof fetch;
+export {};

package/dist/testHost.js

@@ -0,0 +1,76 @@
+// A backend for tests: answers rpc() calls and host middleware the way a Go
+// or Laravel host answers them over HTTP, without one running.
+//
+// The app under test talks to it through the real client, httpHostCalls,
+// handed a fetch that answers in-process. So a test exercises what ships -
+// batching, a redirect raised as the engine's own, an unauthenticated reply
+// becoming a 401 - and only the backend is stood in for.
+const REPLY = Symbol.for('rsc-kit.test-host-reply');
+/** The name the engine asks a host's route guards under. */
+export const HOST_MIDDLEWARE = '__rsc.middleware';
+const reply = (fields) => ({ ...fields, [REPLY]: true });
+/**
+ * The protocol's own answers, for a handler to return.
+ *
+ *     host: {
+ *       'Apps.list': ({ headers }) =>
+ *         headers.get('cookie')?.includes('session=') ? [{ id: 1 }] : hostReply.unauthenticated(),
+ *       'Apps.create': ({ args }) => hostReply.invalid({ name: ['Taken.'] }),
+ *     }
+ */
+export const hostReply = {
+    /** No session: the page answers 401, an action its auth error. */
+    unauthenticated: (message) => reply({ unauthenticated: true, error: message }),
+    /** A session that still may not: 403. */
+    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 }),
+    /** The input was refused, by field: an action returns these as validationErrors. */
+    invalid: (errors) => reply({ validationErrors: errors }),
+    /** A result, and the regions of the page the call says it changed. */
+    revalidating: (result, ...targets) => reply({ result, revalidate: targets }),
+};
+function isReply(value) {
+    return typeof value === 'object' && value !== null && value[REPLY] === true;
+}
+async function answer(host, name, args, headers) {
+    const handler = host[name];
+    // Fails the call rather than answering null: a function the test forgot
+    // is a test that would otherwise pass against nothing.
+    if (!handler) {
+        return {
+            error: name === HOST_MIDDLEWARE
+                ? `the page asked its host guards (${JSON.stringify(args[0])}) and the test host has no "${HOST_MIDDLEWARE}" handler`
+                : `the test host has no handler for ${JSON.stringify(name)}`,
+        };
+    }
+    const value = await handler({ args, headers });
+    if (isReply(value)) {
+        const { [REPLY]: _, ...fields } = value;
+        return fields;
+    }
+    return { result: value === undefined ? null : value };
+}
+/**
+ * A fetch that answers the host-call endpoint from `host`: one call as
+ * itself, a batch as `{ replies }`, in order.
+ */
+export function testHostFetch(host) {
+    return (async (_input, init) => {
+        const headers = new Headers(init?.headers);
+        const body = JSON.parse(String(init?.body ?? '{}'));
+        // The renderer's own headers are not the visitor's.
+        headers.delete('x-rsc-host-secret');
+        headers.delete('content-type');
+        const json = (value) => new Response(JSON.stringify(value), { headers: { 'content-type': 'application/json' } });
+        if ('calls' in body) {
+            return json({
+                replies: await Promise.all(body.calls.map((c) => answer(host, c.function, c.args ?? [], headers))),
+            });
+        }
+        return json(await answer(host, body.function, body.args ?? [], headers));
+    });
+}
+//# sourceMappingURL=testHost.js.map

package/dist/testHost.js.map

@@ -0,0 +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'\n\nconst REPLY = Symbol.for('rsc-kit.test-host-reply')\n\n/** The name the engine asks a host's route guards under. */\nexport const HOST_MIDDLEWARE = '__rsc.middleware'\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\n/**\n * The backend's functions, by the name rpc() calls them with.\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. Anything else refuses, as a real host's\n * answer would.\n */\nexport type TestHost = Record<string, HostHandler>\n\ntype Reply = Omit<HostCallReply, 'result'> & { [REPLY]: true }\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  /** 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} 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  const handler = host[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    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    return json(await answer(host, body.function, body.args ?? [], headers))\n  }) as typeof fetch\n}\n"]}

package/dist/testing.d.ts

@@ -1,3 +1,5 @@
+import { type TestHost } from './testHost.js';
+export { hostReply, HOST_MIDDLEWARE, type HostCallInput, type HostHandler, type TestHost } from './testHost.js';
 export interface TestApp {
     /** A path, not a url. The origin is whatever the app was told it is. */
     fetch(path: string, init?: RequestInit): Promise<Response>;
@@ -18,6 +20,12 @@ export interface TestAppOptions {
     build?: boolean;
     /** The origin requests are made against. Nothing reads it; it is a url. */
     origin?: string;
+    /**
+     * The backend, answered in the test: rpc() calls and host guards by name.
+     * The app reaches it through the same client it uses against a real one,
+     * so nothing listens and RSC_BACKEND is not called. See `hostReply`.
+     */
+    host?: TestHost;
 }
 /**
  * A file the build put in .output/public, answered the way Nitro's static

package/dist/testing.js

@@ -19,6 +19,9 @@ import { spawnSync } from 'node:child_process';
 import { existsSync, readFileSync, readdirSync, statSync } from 'node:fs';
 import { extname, join, resolve, sep } from 'node:path';
 import { pathToFileURL } from 'node:url';
+import { httpHostCalls } from './hostCalls.js';
+import { testHostFetch } from './testHost.js';
+export { hostReply, HOST_MIDDLEWARE } from './testHost.js';
 /**
  * Where the build put the server bundle.
  *
@@ -169,10 +172,20 @@ export async function createTestApp(options = {}) {
     if (typeof entry.default !== 'function') {
         throw new Error(`[rsc-kit] ${bundle} does not export a request handler.`);
     }
+    const host = options.host
+        ? httpHostCalls({ endpoint: 'http://test-host/__rsc/host-call', secret: 'test', fetch: testHostFetch(options.host) })
+        : null;
+    if (host && !entry.installHostFn) {
+        throw new Error(`[rsc-kit] ${bundle} cannot take a host. Rebuild against the current @rsc-kit/core.`);
+    }
     return {
         bundle,
         fetch: async (path, init) => {
             const request = new Request(new URL(path, origin), init);
+            // Per request, not once: the loaded bundle is shared by every app a
+            // run creates, and the host is this app's.
+            if (host)
+                entry.installHostFn(host);
             return staticFile(root, request) ?? entry.default(request);
         },
     };