@rsc-kit/core 0.29.10 → 0.30.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rsc-kit/core",
-  "version": "0.29.10",
+  "version": "0.30.1",
   "description": "React Server Components as a Vite plugin. Routing, streaming, server actions, typed urls and build-time prerendering — deploy to Bun, Node, Workers, Vercel or Deno.",
   "license": "MIT",
   "type": "module",

package/dist/bootPayloads.d.ts

@@ -1,18 +0,0 @@
-/** How long a payload waits for its browser. */
-export declare const BOOT_HOLD_MS = 10000;
-export interface HeldPayload {
-    payload: ReadableStream;
-    /** The headers the boot answer carries beside the payload: the layout chain, the depth. */
-    headers: Record<string, string>;
-    at: number;
-}
-/** A token no one can guess: 128 bits, url-safe. */
-export declare function bootToken(): string;
-/** Keep a render's payload for the boot fetch that follows its document. */
-export declare function holdBootPayload(token: string, payload: ReadableStream, headers: Record<string, string>, now?: number): void;
-/** The payload for a token, once. Null for a token not held, redeemed or expired. */
-export declare function takeBootPayload(token: string, now?: number): HeldPayload | null;
-/** How many are held, for tests. */
-export declare function heldBootPayloads(): number;
-/** Forget everything, for tests. */
-export declare function clearBootPayloads(): void;

package/dist/bootPayloads.js

@@ -1,81 +0,0 @@
-// One render per visit.
-//
-// Hydrating server components needs the serialised tree, not the HTML, and a
-// document does not carry its own payload - inlined, decode and hydration
-// become one long task (#231). So the client fetches it, and that fetch used
-// to render the whole page a second time: the same reads, the same queries,
-// a moment after the document's render had made exactly that payload and
-// thrown it away.
-//
-// Now the document's render keeps its payload here for the few seconds it
-// takes the browser to come back for it, under a token written into the
-// document that only that browser holds. The boot fetch redeems the token
-// and is answered with the payload the document was made from - which is
-// also the one it should hydrate against: two renders a moment apart could
-// disagree, and the one that made the HTML cannot.
-//
-// A token is redeemed once. A payload nobody comes back for - a route with
-// no runtime, a browser that left, a Worker isolate other than the one that
-// rendered - is cancelled when it expires, and the boot fetch that misses
-// renders as it always did. Missing costs a render; it never costs a wrong
-// answer.
-/** How long a payload waits for its browser. */
-export const BOOT_HOLD_MS = 10_000;
-/** At most this many held at once; the oldest is dropped first. */
-const MAX_HELD = 500;
-const held = new Map();
-/** A token no one can guess: 128 bits, url-safe. */
-export function bootToken() {
-    const bytes = new Uint8Array(16);
-    crypto.getRandomValues(bytes);
-    let out = "";
-    for (const b of bytes)
-        out += b.toString(16).padStart(2, "0");
-    return out;
-}
-/** Keep a render's payload for the boot fetch that follows its document. */
-export function holdBootPayload(token, payload, headers, now = Date.now()) {
-    sweep(now);
-    if (held.size >= MAX_HELD) {
-        const oldest = held.keys().next().value;
-        if (oldest !== undefined)
-            drop(oldest);
-    }
-    held.set(token, { payload, headers, at: now });
-}
-/** The payload for a token, once. Null for a token not held, redeemed or expired. */
-export function takeBootPayload(token, now = Date.now()) {
-    const found = held.get(token);
-    if (!found)
-        return null;
-    held.delete(token);
-    if (now - found.at >= BOOT_HOLD_MS) {
-        void found.payload.cancel().catch(() => { });
-        return null;
-    }
-    return found;
-}
-/** Let go of what nobody came back for. */
-function sweep(now) {
-    for (const [token, entry] of held) {
-        if (now - entry.at < BOOT_HOLD_MS)
-            break;
-        drop(token);
-    }
-}
-function drop(token) {
-    const entry = held.get(token);
-    held.delete(token);
-    if (entry)
-        void entry.payload.cancel().catch(() => { });
-}
-/** How many are held, for tests. */
-export function heldBootPayloads() {
-    return held.size;
-}
-/** Forget everything, for tests. */
-export function clearBootPayloads() {
-    for (const token of [...held.keys()])
-        drop(token);
-}
-//# sourceMappingURL=bootPayloads.js.map

package/dist/bootPayloads.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"bootPayloads.js","sourceRoot":"","sources":["../src/bootPayloads.ts"],"names":[],"mappings":"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","sourcesContent":["// One render per visit.\n//\n// Hydrating server components needs the serialised tree, not the HTML, and a\n// document does not carry its own payload - inlined, decode and hydration\n// become one long task (#231). So the client fetches it, and that fetch used\n// to render the whole page a second time: the same reads, the same queries,\n// a moment after the document's render had made exactly that payload and\n// thrown it away.\n//\n// Now the document's render keeps its payload here for the few seconds it\n// takes the browser to come back for it, under a token written into the\n// document that only that browser holds. The boot fetch redeems the token\n// and is answered with the payload the document was made from - which is\n// also the one it should hydrate against: two renders a moment apart could\n// disagree, and the one that made the HTML cannot.\n//\n// A token is redeemed once. A payload nobody comes back for - a route with\n// no runtime, a browser that left, a Worker isolate other than the one that\n// rendered - is cancelled when it expires, and the boot fetch that misses\n// renders as it always did. Missing costs a render; it never costs a wrong\n// answer.\n\n/** How long a payload waits for its browser. */\nexport const BOOT_HOLD_MS = 10_000;\n\n/** At most this many held at once; the oldest is dropped first. */\nconst MAX_HELD = 500;\n\nexport interface HeldPayload {\n  payload: ReadableStream;\n  /** The headers the boot answer carries beside the payload: the layout chain, the depth. */\n  headers: Record<string, string>;\n  at: number;\n}\n\nconst held = new Map<string, HeldPayload>();\n\n/** A token no one can guess: 128 bits, url-safe. */\nexport function bootToken(): string {\n  const bytes = new Uint8Array(16);\n\n  crypto.getRandomValues(bytes);\n\n  let out = \"\";\n\n  for (const b of bytes) out += b.toString(16).padStart(2, \"0\");\n\n  return out;\n}\n\n/** Keep a render's payload for the boot fetch that follows its document. */\nexport function holdBootPayload(\n  token: string,\n  payload: ReadableStream,\n  headers: Record<string, string>,\n  now = Date.now(),\n): void {\n  sweep(now);\n\n  if (held.size >= MAX_HELD) {\n    const oldest = held.keys().next().value;\n\n    if (oldest !== undefined) drop(oldest);\n  }\n\n  held.set(token, { payload, headers, at: now });\n}\n\n/** The payload for a token, once. Null for a token not held, redeemed or expired. */\nexport function takeBootPayload(token: string, now = Date.now()): HeldPayload | null {\n  const found = held.get(token);\n\n  if (!found) return null;\n\n  held.delete(token);\n\n  if (now - found.at >= BOOT_HOLD_MS) {\n    void found.payload.cancel().catch(() => {});\n\n    return null;\n  }\n\n  return found;\n}\n\n/** Let go of what nobody came back for. */\nfunction sweep(now: number): void {\n  for (const [token, entry] of held) {\n    if (now - entry.at < BOOT_HOLD_MS) break;\n\n    drop(token);\n  }\n}\n\nfunction drop(token: string): void {\n  const entry = held.get(token);\n\n  held.delete(token);\n\n  if (entry) void entry.payload.cancel().catch(() => {});\n}\n\n/** How many are held, for tests. */\nexport function heldBootPayloads(): number {\n  return held.size;\n}\n\n/** Forget everything, for tests. */\nexport function clearBootPayloads(): void {\n  for (const token of [...held.keys()]) drop(token);\n}\n"]}