@rsc-kit/core 0.16.3 → 0.18.0

package/dist/request.js

@@ -36,6 +36,9 @@ const SCOPE = Symbol.for("@rsc-kit/core.request-scope");
  */
 const NOT_A_CALLER = new Set([
     "never",
+    "cache",
+    "noteAwaiter",
+    "withHelper",
     "noteRequestRead",
     "recordRead",
     "caller",
@@ -76,11 +79,16 @@ const ACCESSORS = new Set([
 function caller(own) {
     const stack = new Error().stack ?? "";
     let accessors = 0;
+    let helper = null;
     for (const line of stack.split("\n")) {
         const match = /^\s*at (?:async )?([^\s(]+)/.exec(line);
         if (!match)
             continue;
         const name = match[1].split(".").pop();
+        // A frame with no function name prints its location instead - `js:6054:8`
+        // - which is not a name to report.
+        if (!/^[\w$]+$/.test(name))
+            continue;
         if (ACCESSORS.has(name))
             accessors++;
         if (NOT_A_CALLER.has(name) ||
@@ -88,11 +96,22 @@ function caller(own) {
             name === "Object" ||
             name === "Promise")
             continue;
-        if (/^[a-z_$]/.test(name) && !/^use[A-Z]/.test(name))
+        const nested = accessors > (ACCESSORS.has(own) ? 1 : 0);
+        // A function that is not a component - getCurrentUser, wrapped in
+        // cache() - is the shared helper the read lives in. Named, because with
+        // cache() the read runs once, on whichever component called first, and
+        // every other caller of the helper is invisible to the stack. The helper
+        // is what they have in common.
+        if (/^[a-z_$]/.test(name) && !/^use[A-Z]/.test(name)) {
+            helper ??= name;
             continue;
-        return { name, nested: accessors > (ACCESSORS.has(own) ? 1 : 0) };
+        }
+        return {
+            name: helper && helper !== name ? `${helper} (from ${name})` : name,
+            nested,
+        };
     }
-    return { name: null, nested: accessors > (ACCESSORS.has(own) ? 1 : 0) };
+    return { name: helper, nested: accessors > (ACCESSORS.has(own) ? 1 : 0) };
 }
 function recordRead(store, by) {
     if (!store.readBy.includes(by))
@@ -105,6 +124,8 @@ function recordRead(store, by) {
     const entry = name ? `${by} in ${name}` : by;
     if (!store.readWhere.includes(entry))
         store.readWhere.push(entry);
+    if (store.inHelper)
+        (store.readVia ??= new Map()).set(entry, store.inHelper);
 }
 const globals = globalThis;
 let ready = null;
@@ -399,6 +420,10 @@ export async function withRequest(from, run) {
         read: false,
         readBy: [],
         readWhere: [],
+        fallbacks: [],
+        awaiters: new Map(),
+        inHelper: null,
+        readVia: new Map(),
     };
     return await scope().run(store, run);
 }
@@ -450,10 +475,71 @@ export function requestWasRead() {
 export function requestReadBy() {
     return scope()?.getStore()?.readBy ?? [];
 }
-/** The same reads, each with the component that made it: `cookies() in RootLayout`. */
+/** A read React caught at a boundary during SSR: `useSearchParams() in Query`. */
+export function noteFallback(text) {
+    const store = scope()?.getStore();
+    if (!store)
+        return;
+    store.fallbacks ??= [];
+    if (!store.fallbacks.includes(text))
+        store.fallbacks.push(text);
+}
+/** The reads caught at a boundary during this render, with their components. */
+export function requestFallbacks() {
+    return scope()?.getStore()?.fallbacks ?? [];
+}
+/**
+ * A component called a cache()-wrapped helper. Recorded on every call, hit
+ * or miss, so a read the helper makes can name everyone who waited for it.
+ */
+export function noteAwaiter(helper) {
+    const store = scope()?.getStore();
+    if (!store)
+        return;
+    const { name } = caller("cache");
+    if (!name)
+        return;
+    store.awaiters ??= new Map();
+    const list = store.awaiters.get(helper) ?? [];
+    if (!list.includes(name))
+        list.push(name);
+    store.awaiters.set(helper, list);
+}
+/** Run a cache()-wrapped helper's body, so a read inside it is filed under the helper. */
+export function withHelper(helper, run) {
+    const store = scope()?.getStore();
+    if (!store)
+        return run();
+    const before = store.inHelper;
+    store.inHelper = helper;
+    try {
+        return run();
+    }
+    finally {
+        store.inHelper = before;
+    }
+}
+/**
+ * The same reads, each with the component that made it: `cookies() in
+ * RootLayout`. A read inside a cached helper with more than one awaiter
+ * names them all - `connection() awaited by AuthLinks, AuthDialogSlot` -
+ * because the stack saw only the first, and the first is rarely the one
+ * that blocks.
+ */
 export function requestReadWhere() {
     const store = scope()?.getStore();
-    return store?.readWhere?.length ? store.readWhere : (store?.readBy ?? []);
+    if (!store?.readWhere?.length)
+        return store?.readBy ?? [];
+    return store.readWhere.map((entry) => {
+        const helper = store.readVia?.get(entry);
+        const awaiters = helper ? store.awaiters?.get(helper) : undefined;
+        if (!awaiters || awaiters.length < 2)
+            return entry;
+        const names = awaiters.length === 2
+            ? awaiters.join(" and ")
+            : awaiters.slice(0, -1).join(", ") + " and " + awaiters.at(-1);
+        return `${entry.split(" in ")[0]} awaited by ${names}`;
+    });
 }
 /**
  * The query string, as a page receives it.

package/dist/request.js.map

@@ -1 +1 @@
-{"version":3,"file":"request.js","sourceRoot":"","sources":["../src/request.ts"],"names":[],"mappings":"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","sourcesContent":["// Reading the request from inside a render.\n//\n//   import { headers, cookies } from '@rsc-kit/core/request'\n//\n//   export default async function middleware() {\n//     const locale = cookies().get('locale') ?? negotiate(headers().get('accept-language'))\n//     if (!locale) redirect('/en')\n//   }\n//\n// Server components have no arguments beyond their props, and middleware has\n// none at all, so without this an app on a JavaScript host cannot see a header\n// — no locale negotiation, no subdomain, no cookie. The Laravel host escaped\n// that through rpc(), because PHP has the request; this is the same thing for\n// everyone else.\n//\n// Read-only on purpose. Setting a cookie means writing a response header, and\n// by the time a component renders the shell may already have been flushed — an\n// API that appears to set one and silently does not is worse than not having\n// it. Set them in the host, which owns the response.\n//\n// Asynchronous on purpose too, and not for ergonomics. A build has no request,\n// so a read there suspends and never settles — which is the same thing the\n// prerender probe does to a host call. Anything still waiting when the probe's\n// budget expires becomes a fallback in the frozen shell, so a read inside a\n// Suspense boundary leaves the shell frozen and makes only that boundary\n// dynamic. Reading synchronously could only mark the whole route dynamic,\n// because there would be nothing to suspend on.\n//\n// Scoped to the request, on the same store cache() uses. Two requests in\n// flight cannot see each other's headers.\n\nimport { resolveScope } from \"./revalidate.js\";\n\n/** What a host can supply: a real Request, or the parts of one. */\nexport type RequestLike =\n  Request | { url: string; headers: Record<string, string> } | null;\n\ninterface Slot {\n  /** False during a build: there is nothing to answer with. */\n  request: boolean;\n  url: string | null;\n  /**\n   * Held as Headers rather than as a Request.\n   *\n   * `new Request(url, { headers })` drops Cookie: a spec-compliant Headers\n   * built with the \"request\" guard refuses the forbidden header names, and\n   * Cookie is one of them. `new Headers()` has no guard and keeps it. Bun\n   * happens to allow both, which is why rebuilding a Request looked fine until\n   * it ran anywhere stricter — and what it loses is every cookie, silently.\n   */\n  headers: Headers;\n  original: Request | null;\n  /**\n   * Whether anything asked. Only for the build's report — the classification\n   * comes from the suspension, not from this.\n   */\n  read: boolean;\n  /**\n   * What read it, in the order they did.\n   *\n   * Only the name of the accessor — `cookies()`, `headers()` — which is enough\n   * for the build to say why a page could not be frozen. Without it the answer\n   * is \"something in this page reached for the request\", and finding which is\n   * the part that takes an afternoon.\n   */\n  readBy: string[];\n  /**\n   * The same reads with the component that made each one - `cookies() in\n   * RootLayout` - taken from the stack at the moment of the read, which is\n   * still the component's own call: an accessor runs synchronously up to\n   * the point it suspends. Only the build reads this. \"Reads the request\" is\n   * a category; this is the line to open.\n   */\n  readWhere: string[];\n}\n\nconst SCOPE = Symbol.for(\"@rsc-kit/core.request-scope\");\n\n/**\n * The accessors themselves and the plumbing under them: frames to walk past\n * on the way to the component that called.\n */\nconst NOT_A_CALLER = new Set([\n  \"never\",\n  \"noteRequestRead\",\n  \"recordRead\",\n  \"caller\",\n  \"slot\",\n  \"cookies\",\n  \"headers\",\n  \"connection\",\n  \"searchParams\",\n  \"request\",\n  \"url\",\n  \"parseParams\",\n  \"parseSearchParams\",\n  \"parseBody\",\n  \"get\",\n  \"set\",\n  \"has\",\n]);\n\n/** The accessors a component calls by name. One calling another is plumbing, not a second read. */\nconst ACCESSORS = new Set([\n  \"cookies\",\n  \"headers\",\n  \"connection\",\n  \"searchParams\",\n  \"request\",\n  \"url\",\n]);\n\n/**\n * The nearest named function above the accessor on the stack, and whether\n * another accessor sits between: `cookies()` reads through `headers()`, and\n * that inner read is not a second thing the component did.\n *\n * Read from a thrown-away Error: the one thing a build cannot otherwise learn\n * is which component reached for the request, and the stack knows. Function\n * names survive a server bundle, which is not minified, so this is\n * `RootLayout` and not a line number in a chunk. Internal names are walked\n * past; an anonymous frame is skipped rather than reported as `<anonymous>`.\n */\nfunction caller(own: string): { name: string | null; nested: boolean } {\n  const stack = new Error().stack ?? \"\";\n  let accessors = 0;\n\n  for (const line of stack.split(\"\\n\")) {\n    const match = /^\\s*at (?:async )?([^\\s(]+)/.exec(line);\n\n    if (!match) continue;\n\n    const name = match[1]!.split(\".\").pop()!;\n\n    if (ACCESSORS.has(name)) accessors++;\n    if (\n      NOT_A_CALLER.has(name) ||\n      name === \"<anonymous>\" ||\n      name === \"Object\" ||\n      name === \"Promise\"\n    )\n      continue;\n    if (/^[a-z_$]/.test(name) && !/^use[A-Z]/.test(name)) continue;\n\n    return { name, nested: accessors > (ACCESSORS.has(own) ? 1 : 0) };\n  }\n\n  return { name: null, nested: accessors > (ACCESSORS.has(own) ? 1 : 0) };\n}\n\nfunction recordRead(store: Slot, by: string): void {\n  if (!store.readBy.includes(by)) store.readBy.push(by);\n\n  // Older stores, written by a bundle built before this field existed.\n  store.readWhere ??= [];\n\n  const { name, nested } = caller(by.replace(/\\(.*$/, \"\"));\n\n  if (nested) return;\n\n  const entry = name ? `${by} in ${name}` : by;\n\n  if (!store.readWhere.includes(entry)) store.readWhere.push(entry);\n}\n\nconst globals = globalThis as Record<symbol | string, unknown>;\n\nlet ready: Promise<void> | null = null;\n\ninterface Scope {\n  getStore(): Slot | undefined;\n  run<T>(store: Slot, fn: () => T): T;\n}\n\nfunction scope(): Scope | null {\n  return (globals[SCOPE] as Scope | undefined) ?? null;\n}\n\nfunction slot(): Slot {\n  const store = scope()?.getStore();\n\n  if (!store) {\n    throw new Error(\n      \"No request in scope. headers() and cookies() are for a render — middleware, a layout, \" +\n        \"a page — and there is nothing to read outside one.\",\n    );\n  }\n\n  store.read = true;\n\n  return store;\n}\n\n/**\n * The request's headers.\n *\n * Empty during a build, where there is no request: the page is marked as\n * needing one instead, and rendered on demand rather than frozen.\n */\nexport async function headers(): Promise<Headers> {\n  const store = slot();\n\n  return store.request ? store.headers : never(\"headers()\");\n}\n\n/** How a cookie should be written. The names browsers use. */\nexport interface CookieOptions {\n  path?: string;\n  domain?: string;\n  maxAge?: number;\n  expires?: Date;\n  httpOnly?: boolean;\n  secure?: boolean;\n  sameSite?: \"strict\" | \"lax\" | \"none\";\n  partitioned?: boolean;\n}\n\nexport interface Cookies {\n  get(name: string): string | undefined;\n  has(name: string): boolean;\n  getAll(): Record<string, string>;\n  /**\n   * Write one on the response.\n   *\n   * Only from a server action, which has a response of its own that has not\n   * been sent. A render has already flushed its headers by the time a\n   * component runs — that is what makes the first paint fast — so this throws\n   * there rather than appearing to work.\n   */\n  set(name: string, value: string, options?: CookieOptions): void;\n  /** Write one that expires immediately. Same rule about where. */\n  delete(name: string, options?: CookieOptions): void;\n}\n\n/** Kept for the name it had when it could only read. */\nexport type ReadonlyCookies = Cookies;\n\n/**\n * The response being built, while it can still be changed.\n *\n * Open from the moment a request is picked up until the host constructs its\n * Response, and sealed the instant it does. Middleware runs inside that window\n * — before any rendering starts — so a header set there is on the answer. A\n * component runs after it, during streaming, where the status line and headers\n * are already on the wire; setting one there is refused rather than dropped.\n */\ninterface Draft {\n  headers: Headers;\n  sealed: boolean;\n}\n\nconst DRAFT = Symbol.for(\"@rsc-kit/core.response-draft\");\n\nlet draftReady: Promise<void> | null = null;\n\ninterface DraftScope {\n  getStore(): Draft | undefined;\n  run<T>(store: Draft, fn: () => T): T;\n}\n\nfunction draft(): DraftScope | null {\n  return (globals[DRAFT] as DraftScope | undefined) ?? null;\n}\n\n/** The open draft, or an explanation of why there is not one. */\nfunction writable(what: string): Draft {\n  const open = draft()?.getStore();\n\n  if (!open) {\n    throw new Error(\n      `${what} needs a response that has not been sent. Middleware and server actions have one; ` +\n        \"a script outside a request does not.\",\n    );\n  }\n\n  if (open.sealed) {\n    throw new Error(\n      `${what} was called after the response had been sent. Headers go out before the render ` +\n        \"starts — that is what makes the first paint fast — so set them in middleware, which \" +\n        \"runs before it.\",\n    );\n  }\n\n  return open;\n}\n\n/**\n * Headers to put on the answer.\n *\n * Mutate it as you would any Headers. `append` is the one to reach for when a\n * header may legitimately appear twice; `set` replaces.\n */\n/**\n * The draft's headers, refusing writes once the response has gone.\n *\n * A proxy rather than the Headers itself: returning the live object means code\n * that captured it before the response was built can go on mutating a thing\n * nobody will read. Nothing in this package does that — the host copies the\n * headers onto the response the instant it seals — but \"safe because of the\n * order two other functions happen to run in\" is not a property, and an app\n * holding the object across an await would find writes silently doing nothing.\n */\nfunction sealable(draft: Draft): Headers {\n  const guard =\n    (method: \"set\" | \"append\" | \"delete\") =>\n    (...args: [string, string]) => {\n      writable(\"responseHeaders()\");\n\n      return (draft.headers[method] as (...a: string[]) => void)(...args);\n    };\n\n  const proxy: Headers = new Proxy(draft.headers, {\n    get(target, property, receiver) {\n      if (\n        property === \"set\" ||\n        property === \"append\" ||\n        property === \"delete\"\n      ) {\n        return guard(property);\n      }\n\n      // A maplike forEach passes the object it was called on as the third\n      // callback argument, and binding to the target makes that the raw\n      // Headers — a live, unguarded reference handed out by the very method\n      // meant to be read-only. Substituted for the proxy so there is no way\n      // through.\n      if (property === \"forEach\") {\n        return (\n          fn: (value: string, key: string, parent: Headers) => void,\n          thisArg?: unknown,\n        ) =>\n          target.forEach((value, key) => fn.call(thisArg, value, key, proxy));\n      }\n\n      const value = Reflect.get(target, property, receiver);\n\n      return typeof value === \"function\" ? value.bind(target) : value;\n    },\n  });\n\n  return proxy;\n}\n\nexport function responseHeaders(): Headers {\n  return sealable(writable(\"responseHeaders()\"));\n}\n\n/**\n * Run a request with a response that can still be changed, and take what was\n * put on it.\n *\n * `seal()` is called by the host the moment it builds the Response, so\n * anything set afterwards is refused instead of silently going nowhere.\n */\nexport async function withResponseDraft<T>(\n  run: (draft: { taken: () => Headers; seal: () => void }) => Promise<T>,\n): Promise<T> {\n  if (!globals[DRAFT]) {\n    draftReady ??= resolveScope().then((resolved) => {\n      globals[DRAFT] ??= resolved as unknown as DraftScope;\n    });\n\n    await draftReady;\n  }\n\n  const open: Draft = { headers: new Headers(), sealed: false };\n\n  return await draft()!.run(open, () =>\n    run({\n      taken: () => open.headers,\n      seal: () => {\n        open.sealed = true;\n      },\n    }),\n  );\n}\n\n/**\n * A cookie name, as RFC 6265 defines one: a token, so no separators at all.\n *\n * Checked rather than escaped because there is no escaping — a name is not a\n * quoted string. An app that derives one from user input (`pref_${key}`) would\n * otherwise let that input close the pair and open another: a name of\n * `session=attacker; Path=/; HttpOnly; x` serializes to a header whose *first*\n * pair is a session cookie the caller chose, and the browser reads the first.\n */\nconst COOKIE_NAME = /^[!#$%&'*+\\-.^_`|~0-9A-Za-z]+$/;\n\n/** No separator may appear in an attribute either, for the same reason. */\nconst COOKIE_ATTRIBUTE = /[;,\\r\\n]/;\n\n/** `name=value; Path=/; HttpOnly` — the header a browser expects. */\nexport function serializeCookie(cookie: {\n  name: string;\n  value: string;\n  options: CookieOptions;\n}): string {\n  if (!COOKIE_NAME.test(cookie.name)) {\n    throw new Error(\n      `Not a usable cookie name: ${JSON.stringify(cookie.name)}. ` +\n        \"A name is a token — letters, digits and !#$%&'*+-.^_`|~ — with no spaces, \" +\n        \"semicolons or equals signs. Nothing escapes them, so one cannot be encoded around.\",\n    );\n  }\n\n  if (cookie.options.sameSite !== undefined) {\n    const value = String(cookie.options.sameSite).toLowerCase();\n\n    if (value !== \"strict\" && value !== \"lax\" && value !== \"none\") {\n      throw new Error(\n        `Not a SameSite value: ${JSON.stringify(cookie.options.sameSite)}. ` +\n          \"It is written into the header as given, so anything else becomes further attributes.\",\n      );\n    }\n  }\n\n  for (const [attribute, value] of [\n    [\"path\", cookie.options.path],\n    [\"domain\", cookie.options.domain],\n    // Trusted because it is typed as a Date — but a cast reaches this, and the\n    // result lands in the header verbatim like the others.\n    [\"expires\", cookie.options.expires?.toUTCString()],\n  ] as const) {\n    if (typeof value === \"string\" && COOKIE_ATTRIBUTE.test(value)) {\n      throw new Error(\n        `The cookie ${attribute} ${JSON.stringify(value)} contains a separator. ` +\n          \"It would be read as further attributes rather than as part of this one.\",\n      );\n    }\n  }\n\n  const parts = [`${cookie.name}=${encodeURIComponent(cookie.value)}`];\n  const o = cookie.options;\n\n  if (o.maxAge !== undefined) parts.push(`Max-Age=${Math.floor(o.maxAge)}`);\n  if (o.expires) parts.push(`Expires=${o.expires.toUTCString()}`);\n  // Defaulted, because a cookie without one is scoped to the path that set it\n  // — a session written by POST /_rsc/action would not be sent for any page.\n  parts.push(`Path=${o.path ?? \"/\"}`);\n  if (o.domain) parts.push(`Domain=${o.domain}`);\n  if (o.sameSite)\n    parts.push(`SameSite=${o.sameSite[0].toUpperCase()}${o.sameSite.slice(1)}`);\n  if (o.secure) parts.push(\"Secure\");\n  if (o.httpOnly) parts.push(\"HttpOnly\");\n  if (o.partitioned) parts.push(\"Partitioned\");\n\n  return parts.join(\"; \");\n}\n\nexport async function cookies(): Promise<Cookies> {\n  // Named before the await, because `headers()` never settles during a build —\n  // nothing after this line runs there, and the reason would be recorded as\n  // headers() for a call nobody wrote.\n  const store = slot();\n\n  if (!store.request) recordRead(store, \"cookies()\");\n\n  const parsed = parseCookies((await headers()).get(\"cookie\") ?? \"\");\n\n  const write = (\n    name: string,\n    value: string,\n    options: CookieOptions = {},\n  ): void => {\n    // Appended, never set: several cookies on one response are several\n    // Set-Cookie headers, and replacing would leave only the last.\n    writable(\"cookies().set()\").headers.append(\n      \"Set-Cookie\",\n      serializeCookie({ name, value, options }),\n    );\n  };\n\n  return {\n    get: (name) => parsed[name],\n    has: (name) => name in parsed,\n    getAll: () => ({ ...parsed }),\n    set: write,\n    // Expired rather than removed: a browser drops a cookie when it is told\n    // one has already passed, and there is no other way to say it.\n    delete: (name, options = {}) => write(name, \"\", { ...options, maxAge: 0 }),\n  };\n}\n\n/**\n * The whole request, for a host-specific need the accessors do not cover.\n *\n * Null on a host that forwards only the parts — the worker behind Laravel has\n * a socket, not a request. Use headers() and cookies(), which work everywhere.\n */\nexport async function request(): Promise<Request | null> {\n  const store = slot();\n\n  return store.request ? store.original : never(\"request()\");\n}\n\n/**\n * Mark everything below as belonging to the request, not to the build.\n *\n *     export default async function Orders() {\n *       await connection()\n *\n *       const rows = await db.query('select * from orders')\n *\n *       return <ul>{rows.map(...)}</ul>\n *     }\n *\n * At build time this never resolves, so nothing after it runs: the query is not\n * made, the boundary above becomes a hole, and the rest of the page still\n * freezes. At request time it resolves immediately and the component runs\n * normally.\n *\n * **Once is enough.** It is a barrier, not a wrapper — everything after it in\n * this component belongs to the request, however many calls that is. Repeating\n * it before each query does nothing.\n *\n * It needs a boundary above it. With a <Suspense> or a loading.tsx there is a\n * fallback to store and the page becomes a shell; with neither, nothing can\n * paint and the build refuses the route rather than storing a blank.\n *\n * Reach for it when the build should not run something — a database the build\n * machine cannot see, or a value that must differ per visitor. A query the\n * build CAN run, whose answer is the same for everyone, wants none of this: it\n * should be frozen.\n *\n * The same name and behaviour as Next's `connection()`.\n */\nexport async function connection(): Promise<void> {\n  const store = slot();\n\n  // No request means a build. Suspend rather than continue, the same way\n  // headers() and cookies() do.\n  if (!store.request) return never(\"connection()\");\n}\n\n/** The url this request was made to, whichever way the host supplied it. */\nexport async function url(): Promise<string | null> {\n  const store = slot();\n\n  return store.request ? store.url : never(\"url()\");\n}\n\nfunction parseCookies(header: string): Record<string, string> {\n  const out: Record<string, string> = {};\n\n  for (const part of header.split(\";\")) {\n    const eq = part.indexOf(\"=\");\n\n    if (eq === -1) continue;\n\n    const name = part.slice(0, eq).trim();\n\n    if (!name) continue;\n\n    // Decoded because that is how they were written. A malformed escape is\n    // left as it arrived rather than throwing the render away.\n    const raw = part.slice(eq + 1).trim();\n\n    try {\n      out[name] = decodeURIComponent(raw);\n    } catch {\n      out[name] = raw;\n    }\n  }\n\n  return out;\n}\n\n/**\n * Run one request with its headers readable.\n *\n * `null` is the build: a scope with nothing in it, so a page that reads is\n * caught rather than silently frozen holding whatever the machine that built\n * it happened to send.\n */\nexport async function withRequest<T>(\n  from: RequestLike,\n  run: () => Promise<T>,\n): Promise<T> {\n  if (!globals[SCOPE]) {\n    ready ??= resolveScope().then((resolved) => {\n      globals[SCOPE] ??= resolved as unknown as Scope;\n    });\n\n    await ready;\n  }\n\n  const isRequest = from instanceof Request;\n  const store: Slot = {\n    request: from !== null,\n    url: from ? (isRequest ? from.url : from.url) : null,\n    headers: from\n      ? isRequest\n        ? from.headers\n        : new Headers(from.headers)\n      : new Headers(),\n    original: isRequest ? from : null,\n    read: false,\n    readBy: [],\n    readWhere: [],\n  };\n\n  return await scope()!.run(store, run);\n}\n\n/**\n * A promise that never settles, so the caller suspends.\n *\n * What a read does during a build. React treats it exactly as it treats a host\n * call that never answers: the component suspends, its Suspense fallback goes\n * into the shell, and the probe's budget decides the rest.\n */\n/**\n * Record a read without suspending on it.\n *\n * For a reader that CAN answer during a build but whose answer would be wrong\n * to store — an api route's query string, which exists and is empty, and which\n * the build has no business freezing an answer to. `never()` is for a reader\n * with nothing to return; this is for one that has something and should still\n * be noticed.\n *\n * A no-op outside a render scope, so a handler called at request time pays a\n * property read and nothing else.\n */\nexport function noteRequestRead(by: string): void {\n  const store = scope()?.getStore();\n\n  if (!store) return;\n\n  recordRead(store, by);\n}\n\nfunction never(by: string): Promise<never> {\n  const store = slot();\n\n  store.read = true;\n  recordRead(store, by);\n\n  return new Promise(() => {});\n}\n\n/**\n * Whether anything read the request during the scope that is open.\n *\n * For the prerenderer, which opens one with no request and asks afterwards.\n */\nexport function requestWasRead(): boolean {\n  return scope()?.getStore()?.read ?? false;\n}\n\n/**\n * What reached for the request during the scope that is open.\n *\n * For the build, which asks afterwards so it can say why a page is rendered per\n * visitor rather than only that it is.\n */\nexport function requestReadBy(): string[] {\n  return scope()?.getStore()?.readBy ?? [];\n}\n\n/** The same reads, each with the component that made it: `cookies() in RootLayout`. */\nexport function requestReadWhere(): string[] {\n  const store = scope()?.getStore();\n\n  return store?.readWhere?.length ? store.readWhere : (store?.readBy ?? []);\n}\n\n/**\n * The query string, as a page receives it.\n *\n * Derived from the request rather than passed down the render, so no host has\n * to forward it separately — and so it suspends during a build for the same\n * reason every other read does. A frozen page cannot know the query it will be\n * asked for.\n */\nexport async function searchParams(): Promise<URLSearchParams> {\n  // Named before the await, so the build reports the call someone wrote rather\n  // than url(), which this happens to be built on.\n  const store = slot();\n\n  if (!store.request && !store.readBy.includes(\"searchParams()\")) {\n    store.readBy.push(\"searchParams()\");\n  }\n\n  const from = await url();\n\n  return from ? new URL(from).searchParams : new URLSearchParams();\n}\n"]}
+{"version":3,"file":"request.js","sourceRoot":"","sources":["../src/request.ts"],"names":[],"mappings":"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","sourcesContent":["// Reading the request from inside a render.\n//\n//   import { headers, cookies } from '@rsc-kit/core/request'\n//\n//   export default async function middleware() {\n//     const locale = cookies().get('locale') ?? negotiate(headers().get('accept-language'))\n//     if (!locale) redirect('/en')\n//   }\n//\n// Server components have no arguments beyond their props, and middleware has\n// none at all, so without this an app on a JavaScript host cannot see a header\n// — no locale negotiation, no subdomain, no cookie. The Laravel host escaped\n// that through rpc(), because PHP has the request; this is the same thing for\n// everyone else.\n//\n// Read-only on purpose. Setting a cookie means writing a response header, and\n// by the time a component renders the shell may already have been flushed — an\n// API that appears to set one and silently does not is worse than not having\n// it. Set them in the host, which owns the response.\n//\n// Asynchronous on purpose too, and not for ergonomics. A build has no request,\n// so a read there suspends and never settles — which is the same thing the\n// prerender probe does to a host call. Anything still waiting when the probe's\n// budget expires becomes a fallback in the frozen shell, so a read inside a\n// Suspense boundary leaves the shell frozen and makes only that boundary\n// dynamic. Reading synchronously could only mark the whole route dynamic,\n// because there would be nothing to suspend on.\n//\n// Scoped to the request, on the same store cache() uses. Two requests in\n// flight cannot see each other's headers.\n\nimport { resolveScope } from \"./revalidate.js\";\n\n/** What a host can supply: a real Request, or the parts of one. */\nexport type RequestLike =\n  Request | { url: string; headers: Record<string, string> } | null;\n\ninterface Slot {\n  /** False during a build: there is nothing to answer with. */\n  request: boolean;\n  url: string | null;\n  /**\n   * Held as Headers rather than as a Request.\n   *\n   * `new Request(url, { headers })` drops Cookie: a spec-compliant Headers\n   * built with the \"request\" guard refuses the forbidden header names, and\n   * Cookie is one of them. `new Headers()` has no guard and keeps it. Bun\n   * happens to allow both, which is why rebuilding a Request looked fine until\n   * it ran anywhere stricter — and what it loses is every cookie, silently.\n   */\n  headers: Headers;\n  original: Request | null;\n  /**\n   * Whether anything asked. Only for the build's report — the classification\n   * comes from the suspension, not from this.\n   */\n  read: boolean;\n  /**\n   * What read it, in the order they did.\n   *\n   * Only the name of the accessor — `cookies()`, `headers()` — which is enough\n   * for the build to say why a page could not be frozen. Without it the answer\n   * is \"something in this page reached for the request\", and finding which is\n   * the part that takes an afternoon.\n   */\n  readBy: string[];\n  /**\n   * The same reads with the component that made each one - `cookies() in\n   * RootLayout` - taken from the stack at the moment of the read, which is\n   * still the component's own call: an accessor runs synchronously up to\n   * the point it suspends. Only the build reads this. \"Reads the request\" is\n   * a category; this is the line to open.\n   */\n  readWhere: string[];\n  /**\n   * Reads the server could not answer and React caught at a boundary - the\n   * fallback is what got stored - with the component that made each:\n   * `useSearchParams() in Query`. Noted by the SSR entry, read by the build,\n   * which attaches them to the route so a page stored as its own loading\n   * screen says why.\n   */\n  fallbacks: string[];\n  /**\n   * For a read made inside a cache()-wrapped helper: the components that\n   * awaited that helper, first caller included. The helper runs once, so\n   * the stack at the read names only whoever got there first; every later\n   * awaiter is a cache hit that never reaches the accessor. The one above\n   * every boundary is usually one of the later ones.\n   */\n  awaiters: Map<unknown, string[]>;\n  /** The cache()-wrapped helper whose body is running, while it runs. */\n  inHelper: unknown;\n  /** readWhere entry -> the helper it was read inside. */\n  readVia: Map<string, unknown>;\n}\n\nconst SCOPE = Symbol.for(\"@rsc-kit/core.request-scope\");\n\n/**\n * The accessors themselves and the plumbing under them: frames to walk past\n * on the way to the component that called.\n */\nconst NOT_A_CALLER = new Set([\n  \"never\",\n  \"cache\",\n  \"noteAwaiter\",\n  \"withHelper\",\n  \"noteRequestRead\",\n  \"recordRead\",\n  \"caller\",\n  \"slot\",\n  \"cookies\",\n  \"headers\",\n  \"connection\",\n  \"searchParams\",\n  \"request\",\n  \"url\",\n  \"parseParams\",\n  \"parseSearchParams\",\n  \"parseBody\",\n  \"get\",\n  \"set\",\n  \"has\",\n]);\n\n/** The accessors a component calls by name. One calling another is plumbing, not a second read. */\nconst ACCESSORS = new Set([\n  \"cookies\",\n  \"headers\",\n  \"connection\",\n  \"searchParams\",\n  \"request\",\n  \"url\",\n]);\n\n/**\n * The nearest named function above the accessor on the stack, and whether\n * another accessor sits between: `cookies()` reads through `headers()`, and\n * that inner read is not a second thing the component did.\n *\n * Read from a thrown-away Error: the one thing a build cannot otherwise learn\n * is which component reached for the request, and the stack knows. Function\n * names survive a server bundle, which is not minified, so this is\n * `RootLayout` and not a line number in a chunk. Internal names are walked\n * past; an anonymous frame is skipped rather than reported as `<anonymous>`.\n */\nfunction caller(own: string): { name: string | null; nested: boolean } {\n  const stack = new Error().stack ?? \"\";\n  let accessors = 0;\n  let helper: string | null = null;\n\n  for (const line of stack.split(\"\\n\")) {\n    const match = /^\\s*at (?:async )?([^\\s(]+)/.exec(line);\n\n    if (!match) continue;\n\n    const name = match[1]!.split(\".\").pop()!;\n\n    // A frame with no function name prints its location instead - `js:6054:8`\n    // - which is not a name to report.\n    if (!/^[\\w$]+$/.test(name)) continue;\n\n    if (ACCESSORS.has(name)) accessors++;\n    if (\n      NOT_A_CALLER.has(name) ||\n      name === \"<anonymous>\" ||\n      name === \"Object\" ||\n      name === \"Promise\"\n    )\n      continue;\n\n    const nested = accessors > (ACCESSORS.has(own) ? 1 : 0);\n\n    // A function that is not a component - getCurrentUser, wrapped in\n    // cache() - is the shared helper the read lives in. Named, because with\n    // cache() the read runs once, on whichever component called first, and\n    // every other caller of the helper is invisible to the stack. The helper\n    // is what they have in common.\n    if (/^[a-z_$]/.test(name) && !/^use[A-Z]/.test(name)) {\n      helper ??= name;\n\n      continue;\n    }\n\n    return {\n      name: helper && helper !== name ? `${helper} (from ${name})` : name,\n      nested,\n    };\n  }\n\n  return { name: helper, nested: accessors > (ACCESSORS.has(own) ? 1 : 0) };\n}\n\nfunction recordRead(store: Slot, by: string): void {\n  if (!store.readBy.includes(by)) store.readBy.push(by);\n\n  // Older stores, written by a bundle built before this field existed.\n  store.readWhere ??= [];\n\n  const { name, nested } = caller(by.replace(/\\(.*$/, \"\"));\n\n  if (nested) return;\n\n  const entry = name ? `${by} in ${name}` : by;\n\n  if (!store.readWhere.includes(entry)) store.readWhere.push(entry);\n  if (store.inHelper) (store.readVia ??= new Map()).set(entry, store.inHelper);\n}\n\nconst globals = globalThis as Record<symbol | string, unknown>;\n\nlet ready: Promise<void> | null = null;\n\ninterface Scope {\n  getStore(): Slot | undefined;\n  run<T>(store: Slot, fn: () => T): T;\n}\n\nfunction scope(): Scope | null {\n  return (globals[SCOPE] as Scope | undefined) ?? null;\n}\n\nfunction slot(): Slot {\n  const store = scope()?.getStore();\n\n  if (!store) {\n    throw new Error(\n      \"No request in scope. headers() and cookies() are for a render — middleware, a layout, \" +\n        \"a page — and there is nothing to read outside one.\",\n    );\n  }\n\n  store.read = true;\n\n  return store;\n}\n\n/**\n * The request's headers.\n *\n * Empty during a build, where there is no request: the page is marked as\n * needing one instead, and rendered on demand rather than frozen.\n */\nexport async function headers(): Promise<Headers> {\n  const store = slot();\n\n  return store.request ? store.headers : never(\"headers()\");\n}\n\n/** How a cookie should be written. The names browsers use. */\nexport interface CookieOptions {\n  path?: string;\n  domain?: string;\n  maxAge?: number;\n  expires?: Date;\n  httpOnly?: boolean;\n  secure?: boolean;\n  sameSite?: \"strict\" | \"lax\" | \"none\";\n  partitioned?: boolean;\n}\n\nexport interface Cookies {\n  get(name: string): string | undefined;\n  has(name: string): boolean;\n  getAll(): Record<string, string>;\n  /**\n   * Write one on the response.\n   *\n   * Only from a server action, which has a response of its own that has not\n   * been sent. A render has already flushed its headers by the time a\n   * component runs — that is what makes the first paint fast — so this throws\n   * there rather than appearing to work.\n   */\n  set(name: string, value: string, options?: CookieOptions): void;\n  /** Write one that expires immediately. Same rule about where. */\n  delete(name: string, options?: CookieOptions): void;\n}\n\n/** Kept for the name it had when it could only read. */\nexport type ReadonlyCookies = Cookies;\n\n/**\n * The response being built, while it can still be changed.\n *\n * Open from the moment a request is picked up until the host constructs its\n * Response, and sealed the instant it does. Middleware runs inside that window\n * — before any rendering starts — so a header set there is on the answer. A\n * component runs after it, during streaming, where the status line and headers\n * are already on the wire; setting one there is refused rather than dropped.\n */\ninterface Draft {\n  headers: Headers;\n  sealed: boolean;\n}\n\nconst DRAFT = Symbol.for(\"@rsc-kit/core.response-draft\");\n\nlet draftReady: Promise<void> | null = null;\n\ninterface DraftScope {\n  getStore(): Draft | undefined;\n  run<T>(store: Draft, fn: () => T): T;\n}\n\nfunction draft(): DraftScope | null {\n  return (globals[DRAFT] as DraftScope | undefined) ?? null;\n}\n\n/** The open draft, or an explanation of why there is not one. */\nfunction writable(what: string): Draft {\n  const open = draft()?.getStore();\n\n  if (!open) {\n    throw new Error(\n      `${what} needs a response that has not been sent. Middleware and server actions have one; ` +\n        \"a script outside a request does not.\",\n    );\n  }\n\n  if (open.sealed) {\n    throw new Error(\n      `${what} was called after the response had been sent. Headers go out before the render ` +\n        \"starts — that is what makes the first paint fast — so set them in middleware, which \" +\n        \"runs before it.\",\n    );\n  }\n\n  return open;\n}\n\n/**\n * Headers to put on the answer.\n *\n * Mutate it as you would any Headers. `append` is the one to reach for when a\n * header may legitimately appear twice; `set` replaces.\n */\n/**\n * The draft's headers, refusing writes once the response has gone.\n *\n * A proxy rather than the Headers itself: returning the live object means code\n * that captured it before the response was built can go on mutating a thing\n * nobody will read. Nothing in this package does that — the host copies the\n * headers onto the response the instant it seals — but \"safe because of the\n * order two other functions happen to run in\" is not a property, and an app\n * holding the object across an await would find writes silently doing nothing.\n */\nfunction sealable(draft: Draft): Headers {\n  const guard =\n    (method: \"set\" | \"append\" | \"delete\") =>\n    (...args: [string, string]) => {\n      writable(\"responseHeaders()\");\n\n      return (draft.headers[method] as (...a: string[]) => void)(...args);\n    };\n\n  const proxy: Headers = new Proxy(draft.headers, {\n    get(target, property, receiver) {\n      if (\n        property === \"set\" ||\n        property === \"append\" ||\n        property === \"delete\"\n      ) {\n        return guard(property);\n      }\n\n      // A maplike forEach passes the object it was called on as the third\n      // callback argument, and binding to the target makes that the raw\n      // Headers — a live, unguarded reference handed out by the very method\n      // meant to be read-only. Substituted for the proxy so there is no way\n      // through.\n      if (property === \"forEach\") {\n        return (\n          fn: (value: string, key: string, parent: Headers) => void,\n          thisArg?: unknown,\n        ) =>\n          target.forEach((value, key) => fn.call(thisArg, value, key, proxy));\n      }\n\n      const value = Reflect.get(target, property, receiver);\n\n      return typeof value === \"function\" ? value.bind(target) : value;\n    },\n  });\n\n  return proxy;\n}\n\nexport function responseHeaders(): Headers {\n  return sealable(writable(\"responseHeaders()\"));\n}\n\n/**\n * Run a request with a response that can still be changed, and take what was\n * put on it.\n *\n * `seal()` is called by the host the moment it builds the Response, so\n * anything set afterwards is refused instead of silently going nowhere.\n */\nexport async function withResponseDraft<T>(\n  run: (draft: { taken: () => Headers; seal: () => void }) => Promise<T>,\n): Promise<T> {\n  if (!globals[DRAFT]) {\n    draftReady ??= resolveScope().then((resolved) => {\n      globals[DRAFT] ??= resolved as unknown as DraftScope;\n    });\n\n    await draftReady;\n  }\n\n  const open: Draft = { headers: new Headers(), sealed: false };\n\n  return await draft()!.run(open, () =>\n    run({\n      taken: () => open.headers,\n      seal: () => {\n        open.sealed = true;\n      },\n    }),\n  );\n}\n\n/**\n * A cookie name, as RFC 6265 defines one: a token, so no separators at all.\n *\n * Checked rather than escaped because there is no escaping — a name is not a\n * quoted string. An app that derives one from user input (`pref_${key}`) would\n * otherwise let that input close the pair and open another: a name of\n * `session=attacker; Path=/; HttpOnly; x` serializes to a header whose *first*\n * pair is a session cookie the caller chose, and the browser reads the first.\n */\nconst COOKIE_NAME = /^[!#$%&'*+\\-.^_`|~0-9A-Za-z]+$/;\n\n/** No separator may appear in an attribute either, for the same reason. */\nconst COOKIE_ATTRIBUTE = /[;,\\r\\n]/;\n\n/** `name=value; Path=/; HttpOnly` — the header a browser expects. */\nexport function serializeCookie(cookie: {\n  name: string;\n  value: string;\n  options: CookieOptions;\n}): string {\n  if (!COOKIE_NAME.test(cookie.name)) {\n    throw new Error(\n      `Not a usable cookie name: ${JSON.stringify(cookie.name)}. ` +\n        \"A name is a token — letters, digits and !#$%&'*+-.^_`|~ — with no spaces, \" +\n        \"semicolons or equals signs. Nothing escapes them, so one cannot be encoded around.\",\n    );\n  }\n\n  if (cookie.options.sameSite !== undefined) {\n    const value = String(cookie.options.sameSite).toLowerCase();\n\n    if (value !== \"strict\" && value !== \"lax\" && value !== \"none\") {\n      throw new Error(\n        `Not a SameSite value: ${JSON.stringify(cookie.options.sameSite)}. ` +\n          \"It is written into the header as given, so anything else becomes further attributes.\",\n      );\n    }\n  }\n\n  for (const [attribute, value] of [\n    [\"path\", cookie.options.path],\n    [\"domain\", cookie.options.domain],\n    // Trusted because it is typed as a Date — but a cast reaches this, and the\n    // result lands in the header verbatim like the others.\n    [\"expires\", cookie.options.expires?.toUTCString()],\n  ] as const) {\n    if (typeof value === \"string\" && COOKIE_ATTRIBUTE.test(value)) {\n      throw new Error(\n        `The cookie ${attribute} ${JSON.stringify(value)} contains a separator. ` +\n          \"It would be read as further attributes rather than as part of this one.\",\n      );\n    }\n  }\n\n  const parts = [`${cookie.name}=${encodeURIComponent(cookie.value)}`];\n  const o = cookie.options;\n\n  if (o.maxAge !== undefined) parts.push(`Max-Age=${Math.floor(o.maxAge)}`);\n  if (o.expires) parts.push(`Expires=${o.expires.toUTCString()}`);\n  // Defaulted, because a cookie without one is scoped to the path that set it\n  // — a session written by POST /_rsc/action would not be sent for any page.\n  parts.push(`Path=${o.path ?? \"/\"}`);\n  if (o.domain) parts.push(`Domain=${o.domain}`);\n  if (o.sameSite)\n    parts.push(`SameSite=${o.sameSite[0].toUpperCase()}${o.sameSite.slice(1)}`);\n  if (o.secure) parts.push(\"Secure\");\n  if (o.httpOnly) parts.push(\"HttpOnly\");\n  if (o.partitioned) parts.push(\"Partitioned\");\n\n  return parts.join(\"; \");\n}\n\nexport async function cookies(): Promise<Cookies> {\n  // Named before the await, because `headers()` never settles during a build —\n  // nothing after this line runs there, and the reason would be recorded as\n  // headers() for a call nobody wrote.\n  const store = slot();\n\n  if (!store.request) recordRead(store, \"cookies()\");\n\n  const parsed = parseCookies((await headers()).get(\"cookie\") ?? \"\");\n\n  const write = (\n    name: string,\n    value: string,\n    options: CookieOptions = {},\n  ): void => {\n    // Appended, never set: several cookies on one response are several\n    // Set-Cookie headers, and replacing would leave only the last.\n    writable(\"cookies().set()\").headers.append(\n      \"Set-Cookie\",\n      serializeCookie({ name, value, options }),\n    );\n  };\n\n  return {\n    get: (name) => parsed[name],\n    has: (name) => name in parsed,\n    getAll: () => ({ ...parsed }),\n    set: write,\n    // Expired rather than removed: a browser drops a cookie when it is told\n    // one has already passed, and there is no other way to say it.\n    delete: (name, options = {}) => write(name, \"\", { ...options, maxAge: 0 }),\n  };\n}\n\n/**\n * The whole request, for a host-specific need the accessors do not cover.\n *\n * Null on a host that forwards only the parts — the worker behind Laravel has\n * a socket, not a request. Use headers() and cookies(), which work everywhere.\n */\nexport async function request(): Promise<Request | null> {\n  const store = slot();\n\n  return store.request ? store.original : never(\"request()\");\n}\n\n/**\n * Mark everything below as belonging to the request, not to the build.\n *\n *     export default async function Orders() {\n *       await connection()\n *\n *       const rows = await db.query('select * from orders')\n *\n *       return <ul>{rows.map(...)}</ul>\n *     }\n *\n * At build time this never resolves, so nothing after it runs: the query is not\n * made, the boundary above becomes a hole, and the rest of the page still\n * freezes. At request time it resolves immediately and the component runs\n * normally.\n *\n * **Once is enough.** It is a barrier, not a wrapper — everything after it in\n * this component belongs to the request, however many calls that is. Repeating\n * it before each query does nothing.\n *\n * It needs a boundary above it. With a <Suspense> or a loading.tsx there is a\n * fallback to store and the page becomes a shell; with neither, nothing can\n * paint and the build refuses the route rather than storing a blank.\n *\n * Reach for it when the build should not run something — a database the build\n * machine cannot see, or a value that must differ per visitor. A query the\n * build CAN run, whose answer is the same for everyone, wants none of this: it\n * should be frozen.\n *\n * The same name and behaviour as Next's `connection()`.\n */\nexport async function connection(): Promise<void> {\n  const store = slot();\n\n  // No request means a build. Suspend rather than continue, the same way\n  // headers() and cookies() do.\n  if (!store.request) return never(\"connection()\");\n}\n\n/** The url this request was made to, whichever way the host supplied it. */\nexport async function url(): Promise<string | null> {\n  const store = slot();\n\n  return store.request ? store.url : never(\"url()\");\n}\n\nfunction parseCookies(header: string): Record<string, string> {\n  const out: Record<string, string> = {};\n\n  for (const part of header.split(\";\")) {\n    const eq = part.indexOf(\"=\");\n\n    if (eq === -1) continue;\n\n    const name = part.slice(0, eq).trim();\n\n    if (!name) continue;\n\n    // Decoded because that is how they were written. A malformed escape is\n    // left as it arrived rather than throwing the render away.\n    const raw = part.slice(eq + 1).trim();\n\n    try {\n      out[name] = decodeURIComponent(raw);\n    } catch {\n      out[name] = raw;\n    }\n  }\n\n  return out;\n}\n\n/**\n * Run one request with its headers readable.\n *\n * `null` is the build: a scope with nothing in it, so a page that reads is\n * caught rather than silently frozen holding whatever the machine that built\n * it happened to send.\n */\nexport async function withRequest<T>(\n  from: RequestLike,\n  run: () => Promise<T>,\n): Promise<T> {\n  if (!globals[SCOPE]) {\n    ready ??= resolveScope().then((resolved) => {\n      globals[SCOPE] ??= resolved as unknown as Scope;\n    });\n\n    await ready;\n  }\n\n  const isRequest = from instanceof Request;\n  const store: Slot = {\n    request: from !== null,\n    url: from ? (isRequest ? from.url : from.url) : null,\n    headers: from\n      ? isRequest\n        ? from.headers\n        : new Headers(from.headers)\n      : new Headers(),\n    original: isRequest ? from : null,\n    read: false,\n    readBy: [],\n    readWhere: [],\n    fallbacks: [],\n    awaiters: new Map(),\n    inHelper: null,\n    readVia: new Map(),\n  };\n\n  return await scope()!.run(store, run);\n}\n\n/**\n * A promise that never settles, so the caller suspends.\n *\n * What a read does during a build. React treats it exactly as it treats a host\n * call that never answers: the component suspends, its Suspense fallback goes\n * into the shell, and the probe's budget decides the rest.\n */\n/**\n * Record a read without suspending on it.\n *\n * For a reader that CAN answer during a build but whose answer would be wrong\n * to store — an api route's query string, which exists and is empty, and which\n * the build has no business freezing an answer to. `never()` is for a reader\n * with nothing to return; this is for one that has something and should still\n * be noticed.\n *\n * A no-op outside a render scope, so a handler called at request time pays a\n * property read and nothing else.\n */\nexport function noteRequestRead(by: string): void {\n  const store = scope()?.getStore();\n\n  if (!store) return;\n\n  recordRead(store, by);\n}\n\nfunction never(by: string): Promise<never> {\n  const store = slot();\n\n  store.read = true;\n  recordRead(store, by);\n\n  return new Promise(() => {});\n}\n\n/**\n * Whether anything read the request during the scope that is open.\n *\n * For the prerenderer, which opens one with no request and asks afterwards.\n */\nexport function requestWasRead(): boolean {\n  return scope()?.getStore()?.read ?? false;\n}\n\n/**\n * What reached for the request during the scope that is open.\n *\n * For the build, which asks afterwards so it can say why a page is rendered per\n * visitor rather than only that it is.\n */\nexport function requestReadBy(): string[] {\n  return scope()?.getStore()?.readBy ?? [];\n}\n\n/** A read React caught at a boundary during SSR: `useSearchParams() in Query`. */\nexport function noteFallback(text: string): void {\n  const store = scope()?.getStore();\n\n  if (!store) return;\n\n  store.fallbacks ??= [];\n\n  if (!store.fallbacks.includes(text)) store.fallbacks.push(text);\n}\n\n/** The reads caught at a boundary during this render, with their components. */\nexport function requestFallbacks(): string[] {\n  return scope()?.getStore()?.fallbacks ?? [];\n}\n\n/**\n * A component called a cache()-wrapped helper. Recorded on every call, hit\n * or miss, so a read the helper makes can name everyone who waited for it.\n */\nexport function noteAwaiter(helper: unknown): void {\n  const store = scope()?.getStore();\n\n  if (!store) return;\n\n  const { name } = caller(\"cache\");\n\n  if (!name) return;\n\n  store.awaiters ??= new Map();\n\n  const list = store.awaiters.get(helper) ?? [];\n\n  if (!list.includes(name)) list.push(name);\n\n  store.awaiters.set(helper, list);\n}\n\n/** Run a cache()-wrapped helper's body, so a read inside it is filed under the helper. */\nexport function withHelper<T>(helper: unknown, run: () => T): T {\n  const store = scope()?.getStore();\n\n  if (!store) return run();\n\n  const before = store.inHelper;\n\n  store.inHelper = helper;\n\n  try {\n    return run();\n  } finally {\n    store.inHelper = before;\n  }\n}\n\n/**\n * The same reads, each with the component that made it: `cookies() in\n * RootLayout`. A read inside a cached helper with more than one awaiter\n * names them all - `connection() awaited by AuthLinks, AuthDialogSlot` -\n * because the stack saw only the first, and the first is rarely the one\n * that blocks.\n */\nexport function requestReadWhere(): string[] {\n  const store = scope()?.getStore();\n\n  if (!store?.readWhere?.length) return store?.readBy ?? [];\n\n  return store.readWhere.map((entry) => {\n    const helper = store.readVia?.get(entry);\n    const awaiters = helper ? store.awaiters?.get(helper) : undefined;\n\n    if (!awaiters || awaiters.length < 2) return entry;\n\n    const names =\n      awaiters.length === 2\n        ? awaiters.join(\" and \")\n        : awaiters.slice(0, -1).join(\", \") + \" and \" + awaiters.at(-1);\n\n    return `${entry.split(\" in \")[0]} awaited by ${names}`;\n  });\n}\n\n/**\n * The query string, as a page receives it.\n *\n * Derived from the request rather than passed down the render, so no host has\n * to forward it separately — and so it suspends during a build for the same\n * reason every other read does. A frozen page cannot know the query it will be\n * asked for.\n */\nexport async function searchParams(): Promise<URLSearchParams> {\n  // Named before the await, so the build reports the call someone wrote rather\n  // than url(), which this happens to be built on.\n  const store = slot();\n\n  if (!store.request && !store.readBy.includes(\"searchParams()\")) {\n    store.readBy.push(\"searchParams()\");\n  }\n\n  const from = await url();\n\n  return from ? new URL(from).searchParams : new URLSearchParams();\n}\n"]}

package/dist/revalidate.d.ts

@@ -1,3 +1,4 @@
+import type { RevalidateTarget } from "./routes.js";
 /** What this needs from a runtime: somewhere to keep per-action state. */
 interface Scope {
     getStore(): Set<string> | undefined;
@@ -21,15 +22,16 @@ export declare function resolveScope(from?: Record<string, unknown>): Promise<Sc
  * Mark a region of the current page for re-rendering.
  *
  * `'page'` and `'all'` re-render the page or the whole document; any other
- * name is a section or a parallel slot. Unknown names are refused by the
- * renderer with the names it does know, rather than quietly refreshing
- * nothing.
+ * name is a section or a parallel slot. The names are typed to the ones the
+ * build found, so a typo stops compiling; a name that reaches the renderer
+ * unknown anyway is refused with the names it does know, rather than quietly
+ * refreshing nothing.
  *
  * Outside an action this does nothing rather than throwing: it is reasonable
  * for shared code to mark, and unreasonable for that to fail when the same
  * function is called during an ordinary render.
  */
-export declare function revalidate(target: string): void;
+export declare function revalidate(target: RevalidateTarget): void;
 /** Whether anything is listening, for a host that wants to warn about the rest. */
 export declare function isRevalidating(): boolean;
 /**

package/dist/revalidate.js

@@ -28,7 +28,7 @@
  * The engine installs its host callable on globalThis for exactly this
  * reason. This is the same crossing.
  */
-const SCOPE = Symbol.for('@rsc-kit/core.revalidation-scope');
+const SCOPE = Symbol.for("@rsc-kit/core.revalidation-scope");
 const globals = globalThis;
 let ready = null;
 let warned = false;
@@ -52,7 +52,7 @@ from = globals) {
     const Ambient = from.AsyncLocalStorage;
     if (Ambient)
         return new Ambient();
-    const { AsyncLocalStorage } = await import('node:async_hooks');
+    const { AsyncLocalStorage } = await import("node:async_hooks");
     return new AsyncLocalStorage();
 }
 /** The scope, once resolved. Null before the first action runs. */
@@ -63,9 +63,10 @@ function scope() {
  * Mark a region of the current page for re-rendering.
  *
  * `'page'` and `'all'` re-render the page or the whole document; any other
- * name is a section or a parallel slot. Unknown names are refused by the
- * renderer with the names it does know, rather than quietly refreshing
- * nothing.
+ * name is a section or a parallel slot. The names are typed to the ones the
+ * build found, so a typo stops compiling; a name that reaches the renderer
+ * unknown anyway is refused with the names it does know, rather than quietly
+ * refreshing nothing.
  *
  * Outside an action this does nothing rather than throwing: it is reasonable
  * for shared code to mark, and unreasonable for that to fail when the same

package/dist/revalidate.js.map

@@ -1 +1 @@
-{"version":3,"file":"revalidate.js","sourceRoot":"","sources":["../src/revalidate.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAC5D,EAAE;AACF,8EAA8E;AAC9E,wEAAwE;AACxE,2EAA2E;AAC3E,8EAA8E;AAC9E,wEAAwE;AACxE,EAAE;AACF,iBAAiB;AACjB,4CAA4C;AAC5C,iCAAiC;AACjC,qEAAqE;AACrE,0BAA0B;AAC1B,MAAM;AACN,EAAE;AACF,6EAA6E;AAC7E,8EAA8E;AAC9E,uCAAuC;AAQvC;;;;;;;;;;;GAWG;AACH,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,kCAAkC,CAAC,CAAA;AAE5D,MAAM,OAAO,GAAG,UAA8C,CAAA;AAE9D,IAAI,KAAK,GAAyB,IAAI,CAAA;AACtC,IAAI,MAAM,GAAG,KAAK,CAAA;AAElB;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY;AAChC,4EAA4E;AAC5E,kCAAkC;AAClC,IAAI,GAA4B,OAAO;IAEvC,MAAM,OAAO,GAAG,IAAI,CAAC,iBAAkD,CAAA;IAEvE,IAAI,OAAO;QAAE,OAAO,IAAI,OAAO,EAAE,CAAA;IAEjC,MAAM,EAAE,iBAAiB,EAAE,GAAG,MAAM,MAAM,CAAC,kBAAkB,CAAC,CAAA;IAE9D,OAAO,IAAI,iBAAiB,EAAwB,CAAA;AACtD,CAAC;AAED,mEAAmE;AACnE,SAAS,KAAK;IACZ,OAAQ,OAAO,CAAC,KAAK,CAAuB,IAAI,IAAI,CAAA;AACtD,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,UAAU,CAAC,MAAc;IACvC,KAAK,EAAE,EAAE,QAAQ,EAAE,EAAE,GAAG,CAAC,MAAM,CAAC,CAAA;AAClC,CAAC;AAED,mFAAmF;AACnF,MAAM,UAAU,cAAc;IAC5B,OAAO,KAAK,EAAE,EAAE,QAAQ,EAAE,KAAK,SAAS,CAAA;AAC1C,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,GAA0C;IAE1C,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACpB,uEAAuE;QACvE,kEAAkE;QAClE,KAAK,KAAK,YAAY,EAAE,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE;YACzC,OAAO,CAAC,KAAK,CAAC,KAAK,QAAQ,CAAA;QAC7B,CAAC,CAAC,CAAA;QAEF,MAAM,KAAK,CAAA;IACb,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,GAAG,EAAU,CAAA;IAEhC,OAAO,MAAM,KAAK,EAAG,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAA;AACjE,CAAC","sourcesContent":["// Marking part of a page stale from inside a server action.\n//\n// The point is one round trip. An action that changes an order could tell the\n// browser to go and re-fetch something, but then the answer the user is\n// waiting on arrives before the screen is right, and the fix costs another\n// request. Marking instead lets the action's own answer carry the re-rendered\n// region back with it — the client applies it and never knows it asked.\n//\n//   'use server'\n//   export async function addOrder(order) {\n//     await orders.insert(order)\n//     revalidate('orders')       // the section or slot by that name\n//     return { ok: true }\n//   }\n//\n// Scoped to the action that is running, not global, because two requests can\n// be in flight at once and marking is per-request state. In Laravel this is a\n// `scoped()` binding on the container.\n\n/** What this needs from a runtime: somewhere to keep per-action state. */\ninterface Scope {\n  getStore(): Set<string> | undefined\n  run<T>(store: Set<string>, fn: () => T): T\n}\n\n/**\n * One store, however many copies of this module exist.\n *\n * The app's actions are bundled into the server bundle; the host that runs\n * them is not. So this module is loaded twice, and two scopes mean the action\n * marks in one and the host reads the other — everything appears to work, the\n * action's answer simply never carries anything back, and no error is raised\n * on either side.\n *\n * The engine installs its host callable on globalThis for exactly this\n * reason. This is the same crossing.\n */\nconst SCOPE = Symbol.for('@rsc-kit/core.revalidation-scope')\n\nconst globals = globalThis as Record<symbol | string, unknown>\n\nlet ready: Promise<void> | null = null\nlet warned = false\n\n/**\n * AsyncLocalStorage, wherever this happens to be running.\n *\n * The global first, because that is where a Worker has it — and where the\n * engine puts it, since @vitejs/plugin-rsc assigns\n * `globalThis.AsyncLocalStorage` for React's edge build. Then the module,\n * which is where Node, Bun and Deno have it.\n *\n * There is no third branch on purpose. The engine bundle imports\n * `node:async_hooks` statically, so async context is a requirement of the\n * whole system rather than of this file: a runtime without it cannot load the\n * engine at all, and a fallback here would be code that can never run.\n */\nexport async function resolveScope(\n  // Injectable so the branch a Worker takes can be tested from a runtime that\n  // would otherwise never reach it.\n  from: Record<string, unknown> = globals,\n): Promise<Scope> {\n  const Ambient = from.AsyncLocalStorage as (new () => Scope) | undefined\n\n  if (Ambient) return new Ambient()\n\n  const { AsyncLocalStorage } = await import('node:async_hooks')\n\n  return new AsyncLocalStorage<Set<string>>() as Scope\n}\n\n/** The scope, once resolved. Null before the first action runs. */\nfunction scope(): Scope | null {\n  return (globals[SCOPE] as Scope | undefined) ?? null\n}\n\n/**\n * Mark a region of the current page for re-rendering.\n *\n * `'page'` and `'all'` re-render the page or the whole document; any other\n * name is a section or a parallel slot. Unknown names are refused by the\n * renderer with the names it does know, rather than quietly refreshing\n * nothing.\n *\n * Outside an action this does nothing rather than throwing: it is reasonable\n * for shared code to mark, and unreasonable for that to fail when the same\n * function is called during an ordinary render.\n */\nexport function revalidate(target: string): void {\n  scope()?.getStore()?.add(target)\n}\n\n/** Whether anything is listening, for a host that wants to warn about the rest. */\nexport function isRevalidating(): boolean {\n  return scope()?.getStore() !== undefined\n}\n\n/**\n * Run an action with somewhere for its marks to go, and collect them.\n *\n * The marks are read *after* the action has run, because what it invalidated\n * is only known once its work is done.\n */\nexport async function withRevalidation<T>(\n  run: (taken: () => string[]) => Promise<T>,\n): Promise<T> {\n  if (!globals[SCOPE]) {\n    // Resolved once and shared, for the same reason the scope itself is: a\n    // second copy of this module must not end up with a second scope.\n    ready ??= resolveScope().then((resolved) => {\n      globals[SCOPE] ??= resolved\n    })\n\n    await ready\n  }\n\n  const marked = new Set<string>()\n\n  return await scope()!.run(marked, () => run(() => [...marked]))\n}\n"]}
+{"version":3,"file":"revalidate.js","sourceRoot":"","sources":["../src/revalidate.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAC5D,EAAE;AACF,8EAA8E;AAC9E,wEAAwE;AACxE,2EAA2E;AAC3E,8EAA8E;AAC9E,wEAAwE;AACxE,EAAE;AACF,iBAAiB;AACjB,4CAA4C;AAC5C,iCAAiC;AACjC,qEAAqE;AACrE,0BAA0B;AAC1B,MAAM;AACN,EAAE;AACF,6EAA6E;AAC7E,8EAA8E;AAC9E,uCAAuC;AAUvC;;;;;;;;;;;GAWG;AACH,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,kCAAkC,CAAC,CAAC;AAE7D,MAAM,OAAO,GAAG,UAA8C,CAAC;AAE/D,IAAI,KAAK,GAAyB,IAAI,CAAC;AACvC,IAAI,MAAM,GAAG,KAAK,CAAC;AAEnB;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY;AAChC,4EAA4E;AAC5E,kCAAkC;AAClC,IAAI,GAA4B,OAAO;IAEvC,MAAM,OAAO,GAAG,IAAI,CAAC,iBAAkD,CAAC;IAExE,IAAI,OAAO;QAAE,OAAO,IAAI,OAAO,EAAE,CAAC;IAElC,MAAM,EAAE,iBAAiB,EAAE,GAAG,MAAM,MAAM,CAAC,kBAAkB,CAAC,CAAC;IAE/D,OAAO,IAAI,iBAAiB,EAAwB,CAAC;AACvD,CAAC;AAED,mEAAmE;AACnE,SAAS,KAAK;IACZ,OAAQ,OAAO,CAAC,KAAK,CAAuB,IAAI,IAAI,CAAC;AACvD,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,UAAU,CAAC,MAAwB;IACjD,KAAK,EAAE,EAAE,QAAQ,EAAE,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;AACnC,CAAC;AAED,mFAAmF;AACnF,MAAM,UAAU,cAAc;IAC5B,OAAO,KAAK,EAAE,EAAE,QAAQ,EAAE,KAAK,SAAS,CAAC;AAC3C,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,GAA0C;IAE1C,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACpB,uEAAuE;QACvE,kEAAkE;QAClE,KAAK,KAAK,YAAY,EAAE,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE;YACzC,OAAO,CAAC,KAAK,CAAC,KAAK,QAAQ,CAAC;QAC9B,CAAC,CAAC,CAAC;QAEH,MAAM,KAAK,CAAC;IACd,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,GAAG,EAAU,CAAC;IAEjC,OAAO,MAAM,KAAK,EAAG,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;AAClE,CAAC","sourcesContent":["// Marking part of a page stale from inside a server action.\n//\n// The point is one round trip. An action that changes an order could tell the\n// browser to go and re-fetch something, but then the answer the user is\n// waiting on arrives before the screen is right, and the fix costs another\n// request. Marking instead lets the action's own answer carry the re-rendered\n// region back with it — the client applies it and never knows it asked.\n//\n//   'use server'\n//   export async function addOrder(order) {\n//     await orders.insert(order)\n//     revalidate('orders')       // the section or slot by that name\n//     return { ok: true }\n//   }\n//\n// Scoped to the action that is running, not global, because two requests can\n// be in flight at once and marking is per-request state. In Laravel this is a\n// `scoped()` binding on the container.\n\nimport type { RevalidateTarget } from \"./routes.js\";\n\n/** What this needs from a runtime: somewhere to keep per-action state. */\ninterface Scope {\n  getStore(): Set<string> | undefined;\n  run<T>(store: Set<string>, fn: () => T): T;\n}\n\n/**\n * One store, however many copies of this module exist.\n *\n * The app's actions are bundled into the server bundle; the host that runs\n * them is not. So this module is loaded twice, and two scopes mean the action\n * marks in one and the host reads the other — everything appears to work, the\n * action's answer simply never carries anything back, and no error is raised\n * on either side.\n *\n * The engine installs its host callable on globalThis for exactly this\n * reason. This is the same crossing.\n */\nconst SCOPE = Symbol.for(\"@rsc-kit/core.revalidation-scope\");\n\nconst globals = globalThis as Record<symbol | string, unknown>;\n\nlet ready: Promise<void> | null = null;\nlet warned = false;\n\n/**\n * AsyncLocalStorage, wherever this happens to be running.\n *\n * The global first, because that is where a Worker has it — and where the\n * engine puts it, since @vitejs/plugin-rsc assigns\n * `globalThis.AsyncLocalStorage` for React's edge build. Then the module,\n * which is where Node, Bun and Deno have it.\n *\n * There is no third branch on purpose. The engine bundle imports\n * `node:async_hooks` statically, so async context is a requirement of the\n * whole system rather than of this file: a runtime without it cannot load the\n * engine at all, and a fallback here would be code that can never run.\n */\nexport async function resolveScope(\n  // Injectable so the branch a Worker takes can be tested from a runtime that\n  // would otherwise never reach it.\n  from: Record<string, unknown> = globals,\n): Promise<Scope> {\n  const Ambient = from.AsyncLocalStorage as (new () => Scope) | undefined;\n\n  if (Ambient) return new Ambient();\n\n  const { AsyncLocalStorage } = await import(\"node:async_hooks\");\n\n  return new AsyncLocalStorage<Set<string>>() as Scope;\n}\n\n/** The scope, once resolved. Null before the first action runs. */\nfunction scope(): Scope | null {\n  return (globals[SCOPE] as Scope | undefined) ?? null;\n}\n\n/**\n * Mark a region of the current page for re-rendering.\n *\n * `'page'` and `'all'` re-render the page or the whole document; any other\n * name is a section or a parallel slot. The names are typed to the ones the\n * build found, so a typo stops compiling; a name that reaches the renderer\n * unknown anyway is refused with the names it does know, rather than quietly\n * refreshing nothing.\n *\n * Outside an action this does nothing rather than throwing: it is reasonable\n * for shared code to mark, and unreasonable for that to fail when the same\n * function is called during an ordinary render.\n */\nexport function revalidate(target: RevalidateTarget): void {\n  scope()?.getStore()?.add(target);\n}\n\n/** Whether anything is listening, for a host that wants to warn about the rest. */\nexport function isRevalidating(): boolean {\n  return scope()?.getStore() !== undefined;\n}\n\n/**\n * Run an action with somewhere for its marks to go, and collect them.\n *\n * The marks are read *after* the action has run, because what it invalidated\n * is only known once its work is done.\n */\nexport async function withRevalidation<T>(\n  run: (taken: () => string[]) => Promise<T>,\n): Promise<T> {\n  if (!globals[SCOPE]) {\n    // Resolved once and shared, for the same reason the scope itself is: a\n    // second copy of this module must not end up with a second scope.\n    ready ??= resolveScope().then((resolved) => {\n      globals[SCOPE] ??= resolved;\n    });\n\n    await ready;\n  }\n\n  const marked = new Set<string>();\n\n  return await scope()!.run(marked, () => run(() => [...marked]));\n}\n"]}

package/dist/routes.d.ts

@@ -36,6 +36,19 @@ export type Href = Unregistered extends true ? string : Filled<RoutePattern> | `
 /** Augmented by the generated `rsc-routes.d.ts`, like `Register`. */
 export interface RegisterApi {
 }
+/** Augmented by the generated `rsc-routes.d.ts`, like `Register`. */
+export interface RegisterRegions {
+}
+/** The region names the build found: section names and slot names. */
+export type RegionName = RegisterRegions extends {
+    regions: infer R extends string;
+} ? R : string;
+type NoRegions = string extends RegionName ? true : false;
+/**
+ * What `revalidate()` takes: the page, the whole document, or a region by
+ * name. `string` until the build has written the types.
+ */
+export type RevalidateTarget = NoRegions extends true ? string : "page" | "all" | RegionName;
 /** The api route patterns this app declared: `'/api/orders/[id]'`. */
 export type ApiPattern = RegisterApi extends {
     apis: infer R extends string;
@@ -71,17 +84,17 @@ type SearchMap = Register extends {
 type StripQuery<H extends string> = H extends `${infer P}?${string}` ? P : H extends `${infer P}#${string}` ? P : H;
 /** The pattern a written href belongs to: `/posts/hello` is `/posts/[slug]`. */
 type PatternOf<H extends string> = RoutePattern extends infer P ? P extends string ? StripQuery<H> extends Filled<P> ? P : never : never : never;
-type IsUnion<T, U = T> = T extends unknown ? ([U] extends [T] ? false : true) : never;
+type IsUnion<T, U = T> = T extends unknown ? [U] extends [T] ? false : true : never;
 type SchemaFor<P> = P extends keyof SearchMap ? SearchMap[P] : undefined;
 type InputOf<S> = S extends {
-    '~standard': {
+    "~standard": {
         types?: {
             input: infer I;
         };
     };
 } ? I : never;
 type OutputOf<S> = S extends {
-    '~standard': {
+    "~standard": {
         types?: {
             output: infer O;
         };

package/dist/routes.js

@@ -59,14 +59,14 @@ export function searchString(search) {
 export function withSearch(path, search) {
     if (!search)
         return path;
-    const hashAt = path.indexOf('#');
-    const hash = hashAt === -1 ? '' : path.slice(hashAt);
+    const hashAt = path.indexOf("#");
+    const hash = hashAt === -1 ? "" : path.slice(hashAt);
     const before = hashAt === -1 ? path : path.slice(0, hashAt);
-    const queryAt = before.indexOf('?');
+    const queryAt = before.indexOf("?");
     const base = queryAt === -1 ? before : before.slice(0, queryAt);
-    const existing = queryAt === -1 ? '' : before.slice(queryAt + 1);
+    const existing = queryAt === -1 ? "" : before.slice(queryAt + 1);
     const added = searchString(search);
-    const query = [existing, added].filter(Boolean).join('&');
+    const query = [existing, added].filter(Boolean).join("&");
     return query ? `${base}?${query}${hash}` : `${base}${hash}`;
 }
 /**

package/dist/routes.js.map

@@ -1 +1 @@
-{"version":3,"file":"routes.js","sourceRoot":"","sources":["../src/routes.ts"],"names":[],"mappings":"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","sourcesContent":["// Typed routes: the urls this app can actually answer, as a type.\n//\n// Laravel needs route() because the url lives in PHP and can move\n// independently of the name it is called by. Here the url *is* the file path,\n// so a name would be indirection that buys nothing. What is worth having is\n// the other half — a link to a page that does not exist should fail at build\n// time rather than in the browser.\n//\n// There is no route() builder to go with this, deliberately. A template\n// literal is checked the same way — `/posts/${slug}` compiles and\n// `/postz/${slug}` does not — so a builder would only wrap what the language\n// already does. Encoding a value that is not url-safe is `encodeURIComponent`\n// in the template, the same as anywhere else.\n//\n// The build already walks app/ and knows every route's segments, so it writes\n// one line into the app's source dir:\n//\n//   declare module '@rsc-kit/core/routes' {\n//     interface Register { routes: '/' | '/posts/[slug]' }\n//   }\n//\n// Everything below is derived from that union. An app that never runs the\n// generator — a generic host, a Laravel app that has not rebuilt — registers\n// nothing, `RoutePattern` stays `string`, and every url-taking API is exactly\n// as permissive as it was before. That fallback is the reason this can ship\n// without a flag.\n\n/**\n * Augmented by the generated `rsc-routes.d.ts`. Empty here on purpose.\n *\n * Declaration merging rather than a generic parameter, because the routes are\n * a property of the project, not of each call site — threading them through\n * every component that renders a Link is not a thing anyone would do twice.\n */\nexport interface Register {}\n\n/** The route patterns this app declared: `'/posts/[slug]'`. */\nexport type RoutePattern = Register extends { routes: infer R extends string } ? R : string\n\n/** Whether anything was registered. `string` means the generator never ran. */\ntype Unregistered = string extends RoutePattern ? true : false\n\n/**\n * A pattern with its dynamic segments opened up: `/posts/[slug]` accepts\n * `/posts/anything`.\n *\n * Catch-all and single params both become `${string}`, which for a catch-all\n * also swallows the slashes — `/docs/[...path]` accepts `/docs/a/b/c`.\n */\ntype Filled<P extends string> = P extends `${infer A}[...${string}]${infer B}`\n  ? `${A}${string}${Filled<B>}`\n  : P extends `${infer A}[${string}]${infer B}`\n    ? `${A}${string}${Filled<B>}`\n    : P\n\n/**\n * Not a route, but a legitimate href: another site, a mail client, a phone\n * number, an anchor on this page, a bare query string.\n */\ntype OffRoute = `${string}://${string}` | `mailto:${string}` | `tel:${string}` | `#${string}` | `?${string}`\n\n/**\n * A url this app can answer, or one that deliberately leaves it.\n *\n * Cast when the destination is computed rather than written:\n * `href={path as Href}`.\n */\nexport type Href = Unregistered extends true\n  ? string\n  : Filled<RoutePattern> | `${Filled<RoutePattern>}?${string}` | `${Filled<RoutePattern>}#${string}` | OffRoute\n\n// ── Api routes ───────────────────────────────────────────────────────────────\n//\n// Their own union rather than part of Href, because they are not pages and a\n// link to one is almost always a mistake — an <a href=\"/api/orders\"> navigates\n// the browser away to a json document. Keeping them apart means `Link` refuses\n// an api url and `apiUrl()` refuses a page, which is the pair of mistakes worth\n// catching.\n\n/** Augmented by the generated `rsc-routes.d.ts`, like `Register`. */\nexport interface RegisterApi {}\n\n/** The api route patterns this app declared: `'/api/orders/[id]'`. */\nexport type ApiPattern = RegisterApi extends { apis: infer R extends string } ? R : string\n\ntype NoApis = string extends ApiPattern ? true : false\n\n/**\n * A url an api route in this app answers.\n *\n * `/api/orders/[id]` accepts `/api/orders/42`, and a query string is allowed\n * because that is how a GET is parameterised.\n */\nexport type ApiHref = NoApis extends true\n  ? string\n  : Filled<ApiPattern> | `${Filled<ApiPattern>}?${string}`\n\n/**\n * An api url, checked against the routes the build found.\n *\n *     await fetch(apiUrl(`/api/orders/${id}`))\n *\n * A function rather than a bare type so it can be used inline at a call site\n * that is typed `string` — `fetch` takes any string, so nothing would check the\n * argument without somewhere to put the type. It returns what it was given.\n *\n * Wrong path, and it stops compiling. Renamed the directory, and every call\n * site says so rather than one of them 404ing in production.\n */\nexport function apiUrl(href: ApiHref): string {\n  return href\n}\n\n// ── Search params, typed per route ───────────────────────────────────────────\n//\n// A page that exports a `searchParams` schema has said what its query string\n// means. The generated file records that schema per pattern:\n//\n//   interface Register {\n//     search: { '/search': SearchExportOf<typeof import('../src/app/search/page')> }\n//   }\n//\n// and from there a link to `/search` is checked against the same schema the\n// page parses with — a `page` that must be a number is a number on the link,\n// a `q` the page requires is required to write the link, and a key the page\n// never reads does not compile. One schema, both ends. A route that exports\n// none takes anything; an href that is not a single route (computed, cast, or\n// off-site) takes anything too, because there is nothing to check it against.\n\n/** What a page module contributes: its `searchParams` export, or nothing. For the generated file. */\nexport type SearchExportOf<M> = M extends { searchParams: infer S } ? S : undefined\n\ntype SearchMap = Register extends { search: infer M } ? M : {}\n\ntype StripQuery<H extends string> = H extends `${infer P}?${string}` ? P : H extends `${infer P}#${string}` ? P : H\n\n/** The pattern a written href belongs to: `/posts/hello` is `/posts/[slug]`. */\ntype PatternOf<H extends string> = RoutePattern extends infer P\n  ? P extends string\n    ? StripQuery<H> extends Filled<P>\n      ? P\n      : never\n    : never\n  : never\n\ntype IsUnion<T, U = T> = T extends unknown ? ([U] extends [T] ? false : true) : never\n\ntype SchemaFor<P> = P extends keyof SearchMap ? SearchMap[P] : undefined\n\ntype InputOf<S> = S extends { '~standard': { types?: { input: infer I } } } ? I : never\ntype OutputOf<S> = S extends { '~standard': { types?: { output: infer O } } } ? O : never\n\ntype OptionalKeys<T> = { [K in keyof T]-?: {} extends Pick<T, K> ? K : never }[keyof T]\ntype RequiredKeys<T> = Exclude<keyof T, OptionalKeys<T>>\ntype Simplify<T> = { [K in keyof T]: T[K] } & {}\n\n/**\n * What a link may write for a schema: the keys the schema's input requires\n * are required, the rest optional, and every value is the schema's OUTPUT\n * type. Output rather than input because `z.coerce.number()` takes `unknown`\n * in - that is what coercion means - and a link typed by it would accept\n * `page: 'two'`. The output is the number the page will actually see.\n */\ntype LinkInputOf<S> = Simplify<\n  { [K in RequiredKeys<InputOf<S>> & keyof OutputOf<S>]: OutputOf<S>[K] } & {\n    [K in OptionalKeys<InputOf<S>> & keyof OutputOf<S>]?: OutputOf<S>[K]\n  }\n>\n\ntype Scalar = string | number | boolean | null | undefined\n\n/** What a link may carry when nothing declares otherwise. */\nexport type LooseSearch = Record<string, Scalar | readonly (string | number)[]>\n\n/**\n * The search params a link to `H` may carry.\n *\n * The page's schema input when `H` is one declared route with a schema;\n * otherwise anything. \"One route\" matters: `path as Href` is every route at\n * once, and a link that could go anywhere cannot be held to one page's schema.\n */\nexport type SearchFor<H extends string> = Unregistered extends true\n  ? LooseSearch\n  : IsUnion<H> extends true\n    ? LooseSearch\n    : [PatternOf<H>] extends [never]\n      ? LooseSearch\n      : SchemaFor<PatternOf<H>> extends undefined\n        ? LooseSearch\n        : LinkInputOf<SchemaFor<PatternOf<H>>>\n\n/**\n * The `search` prop, required exactly when the page's schema has a required\n * key. A page that needs `q` is not reachable without one, so the link that\n * omits it is the bug — caught here rather than on the page's error boundary.\n */\nexport type SearchProp<H extends string> = {} extends SearchFor<H>\n  ? { search?: SearchFor<H> }\n  : { search: SearchFor<H> }\n\n/** A query string from an object: scalars stringified, arrays repeated, null and undefined dropped. */\nexport function searchString(search: object): string {\n  const params = new URLSearchParams()\n\n  for (const [key, value] of Object.entries(search)) {\n    if (value === null || value === undefined) continue\n\n    if (Array.isArray(value)) {\n      for (const item of value) params.append(key, String(item))\n    } else {\n      params.set(key, String(value))\n    }\n  }\n\n  return params.toString()\n}\n\n/** `path` with `search` appended, keeping any query and hash already on it. */\nexport function withSearch(path: string, search: object | undefined): string {\n  if (!search) return path\n\n  const hashAt = path.indexOf('#')\n  const hash = hashAt === -1 ? '' : path.slice(hashAt)\n  const before = hashAt === -1 ? path : path.slice(0, hashAt)\n  const queryAt = before.indexOf('?')\n  const base = queryAt === -1 ? before : before.slice(0, queryAt)\n  const existing = queryAt === -1 ? '' : before.slice(queryAt + 1)\n  const added = searchString(search)\n  const query = [existing, added].filter(Boolean).join('&')\n\n  return query ? `${base}?${query}${hash}` : `${base}${hash}`\n}\n\n/**\n * A typed url with its search params, for the places that take a string.\n *\n *     visit(href('/search', { q: 'shoes', page: 2 }))\n *\n * `Link` has the same check on its own `search` prop. This is for `visit`,\n * `prefetch`, `redirect` and anything else that wants the finished string.\n */\nexport function href<H extends Href>(\n  path: H,\n  ...rest: {} extends SearchFor<H> ? [search?: SearchFor<H>] : [search: SearchFor<H>]\n): Href {\n  return withSearch(path, rest[0] as object | undefined) as Href\n}\n"]}
+{"version":3,"file":"routes.js","sourceRoot":"","sources":["../src/routes.ts"],"names":[],"mappings":"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","sourcesContent":["// Typed routes: the urls this app can actually answer, as a type.\n//\n// Laravel needs route() because the url lives in PHP and can move\n// independently of the name it is called by. Here the url *is* the file path,\n// so a name would be indirection that buys nothing. What is worth having is\n// the other half — a link to a page that does not exist should fail at build\n// time rather than in the browser.\n//\n// There is no route() builder to go with this, deliberately. A template\n// literal is checked the same way — `/posts/${slug}` compiles and\n// `/postz/${slug}` does not — so a builder would only wrap what the language\n// already does. Encoding a value that is not url-safe is `encodeURIComponent`\n// in the template, the same as anywhere else.\n//\n// The build already walks app/ and knows every route's segments, so it writes\n// one line into the app's source dir:\n//\n//   declare module '@rsc-kit/core/routes' {\n//     interface Register { routes: '/' | '/posts/[slug]' }\n//   }\n//\n// Everything below is derived from that union. An app that never runs the\n// generator — a generic host, a Laravel app that has not rebuilt — registers\n// nothing, `RoutePattern` stays `string`, and every url-taking API is exactly\n// as permissive as it was before. That fallback is the reason this can ship\n// without a flag.\n\n/**\n * Augmented by the generated `rsc-routes.d.ts`. Empty here on purpose.\n *\n * Declaration merging rather than a generic parameter, because the routes are\n * a property of the project, not of each call site — threading them through\n * every component that renders a Link is not a thing anyone would do twice.\n */\nexport interface Register {}\n\n/** The route patterns this app declared: `'/posts/[slug]'`. */\nexport type RoutePattern = Register extends { routes: infer R extends string }\n  ? R\n  : string;\n\n/** Whether anything was registered. `string` means the generator never ran. */\ntype Unregistered = string extends RoutePattern ? true : false;\n\n/**\n * A pattern with its dynamic segments opened up: `/posts/[slug]` accepts\n * `/posts/anything`.\n *\n * Catch-all and single params both become `${string}`, which for a catch-all\n * also swallows the slashes — `/docs/[...path]` accepts `/docs/a/b/c`.\n */\ntype Filled<P extends string> = P extends `${infer A}[...${string}]${infer B}`\n  ? `${A}${string}${Filled<B>}`\n  : P extends `${infer A}[${string}]${infer B}`\n    ? `${A}${string}${Filled<B>}`\n    : P;\n\n/**\n * Not a route, but a legitimate href: another site, a mail client, a phone\n * number, an anchor on this page, a bare query string.\n */\ntype OffRoute =\n  | `${string}://${string}`\n  | `mailto:${string}`\n  | `tel:${string}`\n  | `#${string}`\n  | `?${string}`;\n\n/**\n * A url this app can answer, or one that deliberately leaves it.\n *\n * Cast when the destination is computed rather than written:\n * `href={path as Href}`.\n */\nexport type Href = Unregistered extends true\n  ? string\n  : | Filled<RoutePattern>\n    | `${Filled<RoutePattern>}?${string}`\n    | `${Filled<RoutePattern>}#${string}`\n    | OffRoute;\n\n// ── Api routes ───────────────────────────────────────────────────────────────\n//\n// Their own union rather than part of Href, because they are not pages and a\n// link to one is almost always a mistake — an <a href=\"/api/orders\"> navigates\n// the browser away to a json document. Keeping them apart means `Link` refuses\n// an api url and `apiUrl()` refuses a page, which is the pair of mistakes worth\n// catching.\n\n/** Augmented by the generated `rsc-routes.d.ts`, like `Register`. */\nexport interface RegisterApi {}\n\n// ── Regions a page can re-render on its own ──────────────────────────────────\n//\n// Every `section('name', …)` the build found, and every `@slot` directory.\n// `revalidate('orders')` is checked against them, so a name that matches no\n// section - a typo, or a section renamed since - stops compiling instead of\n// being refused by the renderer at runtime.\n\n/** Augmented by the generated `rsc-routes.d.ts`, like `Register`. */\nexport interface RegisterRegions {}\n\n/** The region names the build found: section names and slot names. */\nexport type RegionName = RegisterRegions extends {\n  regions: infer R extends string;\n}\n  ? R\n  : string;\n\ntype NoRegions = string extends RegionName ? true : false;\n\n/**\n * What `revalidate()` takes: the page, the whole document, or a region by\n * name. `string` until the build has written the types.\n */\nexport type RevalidateTarget = NoRegions extends true\n  ? string\n  : \"page\" | \"all\" | RegionName;\n\n/** The api route patterns this app declared: `'/api/orders/[id]'`. */\nexport type ApiPattern = RegisterApi extends { apis: infer R extends string }\n  ? R\n  : string;\n\ntype NoApis = string extends ApiPattern ? true : false;\n\n/**\n * A url an api route in this app answers.\n *\n * `/api/orders/[id]` accepts `/api/orders/42`, and a query string is allowed\n * because that is how a GET is parameterised.\n */\nexport type ApiHref = NoApis extends true\n  ? string\n  : Filled<ApiPattern> | `${Filled<ApiPattern>}?${string}`;\n\n/**\n * An api url, checked against the routes the build found.\n *\n *     await fetch(apiUrl(`/api/orders/${id}`))\n *\n * A function rather than a bare type so it can be used inline at a call site\n * that is typed `string` — `fetch` takes any string, so nothing would check the\n * argument without somewhere to put the type. It returns what it was given.\n *\n * Wrong path, and it stops compiling. Renamed the directory, and every call\n * site says so rather than one of them 404ing in production.\n */\nexport function apiUrl(href: ApiHref): string {\n  return href;\n}\n\n// ── Search params, typed per route ───────────────────────────────────────────\n//\n// A page that exports a `searchParams` schema has said what its query string\n// means. The generated file records that schema per pattern:\n//\n//   interface Register {\n//     search: { '/search': SearchExportOf<typeof import('../src/app/search/page')> }\n//   }\n//\n// and from there a link to `/search` is checked against the same schema the\n// page parses with — a `page` that must be a number is a number on the link,\n// a `q` the page requires is required to write the link, and a key the page\n// never reads does not compile. One schema, both ends. A route that exports\n// none takes anything; an href that is not a single route (computed, cast, or\n// off-site) takes anything too, because there is nothing to check it against.\n\n/** What a page module contributes: its `searchParams` export, or nothing. For the generated file. */\nexport type SearchExportOf<M> = M extends { searchParams: infer S }\n  ? S\n  : undefined;\n\ntype SearchMap = Register extends { search: infer M } ? M : {};\n\ntype StripQuery<H extends string> = H extends `${infer P}?${string}`\n  ? P\n  : H extends `${infer P}#${string}`\n    ? P\n    : H;\n\n/** The pattern a written href belongs to: `/posts/hello` is `/posts/[slug]`. */\ntype PatternOf<H extends string> = RoutePattern extends infer P\n  ? P extends string\n    ? StripQuery<H> extends Filled<P>\n      ? P\n      : never\n    : never\n  : never;\n\ntype IsUnion<T, U = T> = T extends unknown\n  ? [U] extends [T]\n    ? false\n    : true\n  : never;\n\ntype SchemaFor<P> = P extends keyof SearchMap ? SearchMap[P] : undefined;\n\ntype InputOf<S> = S extends { \"~standard\": { types?: { input: infer I } } }\n  ? I\n  : never;\ntype OutputOf<S> = S extends { \"~standard\": { types?: { output: infer O } } }\n  ? O\n  : never;\n\ntype OptionalKeys<T> = {\n  [K in keyof T]-?: {} extends Pick<T, K> ? K : never;\n}[keyof T];\ntype RequiredKeys<T> = Exclude<keyof T, OptionalKeys<T>>;\ntype Simplify<T> = { [K in keyof T]: T[K] } & {};\n\n/**\n * What a link may write for a schema: the keys the schema's input requires\n * are required, the rest optional, and every value is the schema's OUTPUT\n * type. Output rather than input because `z.coerce.number()` takes `unknown`\n * in - that is what coercion means - and a link typed by it would accept\n * `page: 'two'`. The output is the number the page will actually see.\n */\ntype LinkInputOf<S> = Simplify<\n  { [K in RequiredKeys<InputOf<S>> & keyof OutputOf<S>]: OutputOf<S>[K] } & {\n    [K in OptionalKeys<InputOf<S>> & keyof OutputOf<S>]?: OutputOf<S>[K];\n  }\n>;\n\ntype Scalar = string | number | boolean | null | undefined;\n\n/** What a link may carry when nothing declares otherwise. */\nexport type LooseSearch = Record<string, Scalar | readonly (string | number)[]>;\n\n/**\n * The search params a link to `H` may carry.\n *\n * The page's schema input when `H` is one declared route with a schema;\n * otherwise anything. \"One route\" matters: `path as Href` is every route at\n * once, and a link that could go anywhere cannot be held to one page's schema.\n */\nexport type SearchFor<H extends string> = Unregistered extends true\n  ? LooseSearch\n  : IsUnion<H> extends true\n    ? LooseSearch\n    : [PatternOf<H>] extends [never]\n      ? LooseSearch\n      : SchemaFor<PatternOf<H>> extends undefined\n        ? LooseSearch\n        : LinkInputOf<SchemaFor<PatternOf<H>>>;\n\n/**\n * The `search` prop, required exactly when the page's schema has a required\n * key. A page that needs `q` is not reachable without one, so the link that\n * omits it is the bug — caught here rather than on the page's error boundary.\n */\nexport type SearchProp<H extends string> =\n  {} extends SearchFor<H>\n    ? { search?: SearchFor<H> }\n    : { search: SearchFor<H> };\n\n/** A query string from an object: scalars stringified, arrays repeated, null and undefined dropped. */\nexport function searchString(search: object): string {\n  const params = new URLSearchParams();\n\n  for (const [key, value] of Object.entries(search)) {\n    if (value === null || value === undefined) continue;\n\n    if (Array.isArray(value)) {\n      for (const item of value) params.append(key, String(item));\n    } else {\n      params.set(key, String(value));\n    }\n  }\n\n  return params.toString();\n}\n\n/** `path` with `search` appended, keeping any query and hash already on it. */\nexport function withSearch(path: string, search: object | undefined): string {\n  if (!search) return path;\n\n  const hashAt = path.indexOf(\"#\");\n  const hash = hashAt === -1 ? \"\" : path.slice(hashAt);\n  const before = hashAt === -1 ? path : path.slice(0, hashAt);\n  const queryAt = before.indexOf(\"?\");\n  const base = queryAt === -1 ? before : before.slice(0, queryAt);\n  const existing = queryAt === -1 ? \"\" : before.slice(queryAt + 1);\n  const added = searchString(search);\n  const query = [existing, added].filter(Boolean).join(\"&\");\n\n  return query ? `${base}?${query}${hash}` : `${base}${hash}`;\n}\n\n/**\n * A typed url with its search params, for the places that take a string.\n *\n *     visit(href('/search', { q: 'shoes', page: 2 }))\n *\n * `Link` has the same check on its own `search` prop. This is for `visit`,\n * `prefetch`, `redirect` and anything else that wants the finished string.\n */\nexport function href<H extends Href>(\n  path: H,\n  ...rest: {} extends SearchFor<H>\n    ? [search?: SearchFor<H>]\n    : [search: SearchFor<H>]\n): Href {\n  return withSearch(path, rest[0] as object | undefined) as Href;\n}\n"]}

package/dist/routing.d.ts

@@ -1,4 +1,4 @@
-import type { ManifestApiRoute, ManifestRoute, RouteManifest } from './manifest.js';
+import type { ManifestApiRoute, ManifestRoute, RouteManifest } from "./manifest.js";
 /** A matched route and the params its url segments bound. */
 export interface MatchedRoute {
     route: ManifestRoute;
@@ -27,7 +27,7 @@ export declare function matchApiRoute(manifest: RouteManifest, pathname: string)
  * HEAD is included whenever GET is, because it is answered by GET.
  */
 export declare function allowFor(route: ManifestApiRoute): string;
-export declare function matchRoute(manifest: RouteManifest, pathname: string): MatchedRoute | null;
+export declare function matchRoute(manifest: RouteManifest, pathname: string, host?: string | null): MatchedRoute | null;
 /**
  * The interceptor registered for a slot, if this url has one.
  *