@rsc-kit/core 0.25.0 → 0.27.0

package/dist/js/Changes.d.ts

@@ -0,0 +1,11 @@
+/**
+ * What a rendered region is live on, handed to the tab's watcher.
+ *
+ * Renders nothing. Rendered by `RefreshOn` beside the region it describes,
+ * so it arrives in the same payload - with the page, and again with the
+ * region each time it is refreshed, carrying the versions that render saw.
+ */
+export declare function Changes({ target, names, }: {
+    target: string;
+    names: Record<string, [number, string]>;
+}): null;

package/dist/js/Changes.js

@@ -0,0 +1,19 @@
+"use client";
+import { useEffect } from "react";
+import { register } from "./changesStore";
+/**
+ * What a rendered region is live on, handed to the tab's watcher.
+ *
+ * Renders nothing. Rendered by `RefreshOn` beside the region it describes,
+ * so it arrives in the same payload - with the page, and again with the
+ * region each time it is refreshed, carrying the versions that render saw.
+ */
+export function Changes({ target, names, }) {
+    const key = JSON.stringify(names);
+    useEffect(() => register({
+        target,
+        names: JSON.parse(key),
+    }), [target, key]);
+    return null;
+}
+//# sourceMappingURL=Changes.js.map

package/dist/js/Changes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Changes.js","sourceRoot":"","sources":["../../src/js/Changes.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAClC,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE1C;;;;;;GAMG;AACH,MAAM,UAAU,OAAO,CAAC,EACtB,MAAM,EACN,KAAK,GAIN;IACC,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAElC,SAAS,CACP,GAAG,EAAE,CACH,QAAQ,CAAC;QACP,MAAM;QACN,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAqC;KAC3D,CAAC,EACJ,CAAC,MAAM,EAAE,GAAG,CAAC,CACd,CAAC;IAEF,OAAO,IAAI,CAAC;AACd,CAAC","sourcesContent":["\"use client\";\n\nimport { useEffect } from \"react\";\nimport { register } from \"./changesStore\";\n\n/**\n * What a rendered region is live on, handed to the tab's watcher.\n *\n * Renders nothing. Rendered by `RefreshOn` beside the region it describes,\n * so it arrives in the same payload - with the page, and again with the\n * region each time it is refreshed, carrying the versions that render saw.\n */\nexport function Changes({\n  target,\n  names,\n}: {\n  target: string;\n  names: Record<string, [number, string]>;\n}) {\n  const key = JSON.stringify(names);\n\n  useEffect(\n    () =>\n      register({\n        target,\n        names: JSON.parse(key) as Record<string, [number, string]>,\n      }),\n    [target, key],\n  );\n\n  return null;\n}\n"]}

package/dist/js/changesStore.d.ts

@@ -0,0 +1,9 @@
+/** The names a region is live on, as the server rendered them: version at render and signature. */
+export interface Registration {
+    target: string;
+    names: Record<string, [version: number, signature: string]>;
+}
+/** Register what a rendered region is live on; the returned function forgets it. */
+export declare function register(entry: Registration): () => void;
+/** For tests. */
+export declare function resetChanges(): void;

package/dist/js/changesStore.js

@@ -0,0 +1,178 @@
+// The tab's side of live sections: what the page is showing, on one stream.
+//
+// Every section or page rendered with `live` registers its names here, with
+// the version each was at and its signature. The union is what the stream
+// watches; a version that moved refreshes exactly the regions live on that
+// name, through the same refresh() a page calls itself. One stream per tab
+// however many regions, reopened only when the set of names changes, closed
+// while the tab is hidden and caught up when it is seen again.
+import { refresh, refreshOnChange } from "./router";
+const CHANGES_PATH = "/_rsc/changes";
+const registrations = new Set();
+let source = null;
+let openedWith = "";
+let settle;
+let retry;
+let failures = 0;
+let listening = false;
+/** Register what a rendered region is live on; the returned function forgets it. */
+export function register(entry) {
+    registrations.add(entry);
+    schedule();
+    return () => {
+        registrations.delete(entry);
+        schedule();
+    };
+}
+function listen() {
+    if (listening || typeof document === "undefined")
+        return;
+    listening = true;
+    document.addEventListener("visibilitychange", () => {
+        if (!document.hidden)
+            return schedule();
+        // Hidden tabs do not hold a connection. Nothing is missed: seen again,
+        // the stream reopens at the versions this tab holds and every name that
+        // moved meanwhile is reported at once.
+        if (source)
+            note("refreshOn paused: tab hidden. It catches up when the tab is shown.");
+        close();
+    });
+    window.addEventListener("online", schedule);
+}
+/** Many regions register in one commit; one reconcile serves them all. */
+function schedule() {
+    listen();
+    clearTimeout(settle);
+    settle = setTimeout(reconcile, 20);
+}
+/** Every name any region is live on, at the lowest version held - the one furthest behind decides. */
+function union() {
+    const held = new Map();
+    for (const { names } of registrations) {
+        for (const [name, [version, signature]] of Object.entries(names)) {
+            const seen = held.get(name);
+            if (!seen || version < seen[0])
+                held.set(name, [version, signature]);
+        }
+    }
+    return [...held]
+        .map(([name, [version, signature]]) => [
+        name,
+        version,
+        signature,
+    ])
+        .sort((a, b) => (a[0] < b[0] ? -1 : 1));
+}
+function reconcile() {
+    const entries = union();
+    if (entries.length === 0 ||
+        (typeof document !== "undefined" && document.hidden) ||
+        typeof EventSource === "undefined") {
+        close();
+        return;
+    }
+    const key = JSON.stringify(entries);
+    // Something changed: a region came or went, or one re-rendered at a new
+    // version. Either way the set is new, and a failed stream gets a fresh try.
+    if (key !== openedWith)
+        failures = 0;
+    if (source && key === openedWith)
+        return;
+    if (import.meta.env?.DEV) {
+        const lines = [...registrations].map(({ target, names }) => `  ${target}: ${Object.entries(names)
+            .map(([name, [version]]) => `${name} @${version}`)
+            .join(", ")}`);
+        note(`refreshOn watching, by region:\n${lines.join("\n")}`);
+    }
+    open(key, entries);
+}
+/**
+ * Development only: what the page refreshes on, and why it stopped. A region
+ * that declared refreshOn but is missing from the list rendered no names -
+ * the server said why, once, in its own log.
+ */
+function note(message) {
+    if (import.meta.env?.DEV)
+        console.info("[rsc-kit] " + message);
+}
+function open(key, entries) {
+    close();
+    openedWith = key;
+    const stream = new EventSource(CHANGES_PATH + "?w=" + encodeURIComponent(JSON.stringify(entries)));
+    source = stream;
+    stream.onopen = () => {
+        failures = 0;
+    };
+    stream.onmessage = (event) => {
+        let moved;
+        try {
+            moved = JSON.parse(event.data);
+        }
+        catch {
+            return;
+        }
+        if (typeof moved.name === "string" && typeof moved.version === "number")
+            apply(moved.name, moved.version);
+    };
+    stream.onerror = () => {
+        // CONNECTING: the browser is retrying a dropped connection itself. CLOSED:
+        // an error answer - a 403 for names signed by another deploy, a 502 - and
+        // only a new stream comes back. Three in a row and the page is left alone
+        // until something re-renders and registers afresh.
+        if (stream.readyState !== EventSource.CLOSED)
+            return;
+        stream.close();
+        if (source === stream)
+            source = null;
+        if (++failures > 3)
+            return;
+        retry = setTimeout(() => open(openedWith, entries), Math.min(30_000, 1000 * 2 ** (failures - 1)));
+    };
+}
+function close() {
+    clearTimeout(retry);
+    source?.close();
+    source = null;
+    openedWith = "";
+}
+/** Regions to refresh this tick, each with the changes that moved it: `stock@5`. */
+let pending = null;
+/** A version moved: every region on the name at another version refreshes, once per tick. */
+function apply(name, version) {
+    for (const entry of registrations) {
+        const held = entry.names[name];
+        if (!held || held[0] === version)
+            continue;
+        held[0] = version;
+        const changes = (pending ??= new Map()).get(entry.target) ?? new Set();
+        changes.add(name + "@" + version);
+        pending.set(entry.target, changes);
+    }
+    if (!pending)
+        return;
+    queueMicrotask(() => {
+        const targets = pending;
+        pending = null;
+        if (!targets)
+            return;
+        // The page re-renders its sections with it, so refreshing both is twice.
+        if (targets.has("page")) {
+            void refresh("page").catch(() => { });
+            return;
+        }
+        // Saying which change asked lets every tab asking about the same one
+        // share a single render of a shared section.
+        for (const [target, changes] of targets) {
+            void refreshOnChange(target, [...changes].sort().join(",")).catch(() => { });
+        }
+    });
+}
+/** For tests. */
+export function resetChanges() {
+    registrations.clear();
+    close();
+    failures = 0;
+    pending = null;
+}
+//# sourceMappingURL=changesStore.js.map

package/dist/js/changesStore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"changesStore.js","sourceRoot":"","sources":["../../src/js/changesStore.ts"],"names":[],"mappings":"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","sourcesContent":["// The tab's side of live sections: what the page is showing, on one stream.\n//\n// Every section or page rendered with `live` registers its names here, with\n// the version each was at and its signature. The union is what the stream\n// watches; a version that moved refreshes exactly the regions live on that\n// name, through the same refresh() a page calls itself. One stream per tab\n// however many regions, reopened only when the set of names changes, closed\n// while the tab is hidden and caught up when it is seen again.\n\nimport { refresh, refreshOnChange } from \"./router\";\n\n/** The names a region is live on, as the server rendered them: version at render and signature. */\nexport interface Registration {\n  target: string;\n  names: Record<string, [version: number, signature: string]>;\n}\n\nconst CHANGES_PATH = \"/_rsc/changes\";\n\nconst registrations = new Set<Registration>();\n\nlet source: EventSource | null = null;\nlet openedWith = \"\";\nlet settle: ReturnType<typeof setTimeout> | undefined;\nlet retry: ReturnType<typeof setTimeout> | undefined;\nlet failures = 0;\nlet listening = false;\n\n/** Register what a rendered region is live on; the returned function forgets it. */\nexport function register(entry: Registration): () => void {\n  registrations.add(entry);\n  schedule();\n\n  return () => {\n    registrations.delete(entry);\n    schedule();\n  };\n}\n\nfunction listen(): void {\n  if (listening || typeof document === \"undefined\") return;\n\n  listening = true;\n  document.addEventListener(\"visibilitychange\", () => {\n    if (!document.hidden) return schedule();\n\n    // Hidden tabs do not hold a connection. Nothing is missed: seen again,\n    // the stream reopens at the versions this tab holds and every name that\n    // moved meanwhile is reported at once.\n    if (source)\n      note(\n        \"refreshOn paused: tab hidden. It catches up when the tab is shown.\",\n      );\n    close();\n  });\n  window.addEventListener(\"online\", schedule);\n}\n\n/** Many regions register in one commit; one reconcile serves them all. */\nfunction schedule(): void {\n  listen();\n  clearTimeout(settle);\n  settle = setTimeout(reconcile, 20);\n}\n\n/** Every name any region is live on, at the lowest version held - the one furthest behind decides. */\nfunction union(): [string, number, string][] {\n  const held = new Map<string, [number, string]>();\n\n  for (const { names } of registrations) {\n    for (const [name, [version, signature]] of Object.entries(names)) {\n      const seen = held.get(name);\n\n      if (!seen || version < seen[0]) held.set(name, [version, signature]);\n    }\n  }\n\n  return [...held]\n    .map(([name, [version, signature]]): [string, number, string] => [\n      name,\n      version,\n      signature,\n    ])\n    .sort((a, b) => (a[0] < b[0] ? -1 : 1));\n}\n\nfunction reconcile(): void {\n  const entries = union();\n\n  if (\n    entries.length === 0 ||\n    (typeof document !== \"undefined\" && document.hidden) ||\n    typeof EventSource === \"undefined\"\n  ) {\n    close();\n\n    return;\n  }\n\n  const key = JSON.stringify(entries);\n\n  // Something changed: a region came or went, or one re-rendered at a new\n  // version. Either way the set is new, and a failed stream gets a fresh try.\n  if (key !== openedWith) failures = 0;\n  if (source && key === openedWith) return;\n\n  if (import.meta.env?.DEV) {\n    const lines = [...registrations].map(\n      ({ target, names }) =>\n        `  ${target}: ${Object.entries(names)\n          .map(([name, [version]]) => `${name} @${version}`)\n          .join(\", \")}`,\n    );\n\n    note(`refreshOn watching, by region:\\n${lines.join(\"\\n\")}`);\n  }\n\n  open(key, entries);\n}\n\n/**\n * Development only: what the page refreshes on, and why it stopped. A region\n * that declared refreshOn but is missing from the list rendered no names -\n * the server said why, once, in its own log.\n */\nfunction note(message: string): void {\n  if (import.meta.env?.DEV) console.info(\"[rsc-kit] \" + message);\n}\n\nfunction open(key: string, entries: [string, number, string][]): void {\n  close();\n  openedWith = key;\n\n  const stream = new EventSource(\n    CHANGES_PATH + \"?w=\" + encodeURIComponent(JSON.stringify(entries)),\n  );\n\n  source = stream;\n\n  stream.onopen = () => {\n    failures = 0;\n  };\n\n  stream.onmessage = (event: MessageEvent) => {\n    let moved: { name?: unknown; version?: unknown };\n\n    try {\n      moved = JSON.parse(event.data as string) as {\n        name?: unknown;\n        version?: unknown;\n      };\n    } catch {\n      return;\n    }\n\n    if (typeof moved.name === \"string\" && typeof moved.version === \"number\")\n      apply(moved.name, moved.version);\n  };\n\n  stream.onerror = () => {\n    // CONNECTING: the browser is retrying a dropped connection itself. CLOSED:\n    // an error answer - a 403 for names signed by another deploy, a 502 - and\n    // only a new stream comes back. Three in a row and the page is left alone\n    // until something re-renders and registers afresh.\n    if (stream.readyState !== EventSource.CLOSED) return;\n\n    stream.close();\n    if (source === stream) source = null;\n    if (++failures > 3) return;\n\n    retry = setTimeout(\n      () => open(openedWith, entries),\n      Math.min(30_000, 1000 * 2 ** (failures - 1)),\n    );\n  };\n}\n\nfunction close(): void {\n  clearTimeout(retry);\n  source?.close();\n  source = null;\n  openedWith = \"\";\n}\n\n/** Regions to refresh this tick, each with the changes that moved it: `stock@5`. */\nlet pending: Map<string, Set<string>> | null = null;\n\n/** A version moved: every region on the name at another version refreshes, once per tick. */\nfunction apply(name: string, version: number): void {\n  for (const entry of registrations) {\n    const held = entry.names[name];\n\n    if (!held || held[0] === version) continue;\n\n    held[0] = version;\n\n    const changes =\n      (pending ??= new Map()).get(entry.target) ?? new Set<string>();\n\n    changes.add(name + \"@\" + version);\n    pending.set(entry.target, changes);\n  }\n\n  if (!pending) return;\n\n  queueMicrotask(() => {\n    const targets = pending;\n\n    pending = null;\n    if (!targets) return;\n\n    // The page re-renders its sections with it, so refreshing both is twice.\n    if (targets.has(\"page\")) {\n      void refresh(\"page\").catch(() => {});\n\n      return;\n    }\n\n    // Saying which change asked lets every tab asking about the same one\n    // share a single render of a shared section.\n    for (const [target, changes] of targets) {\n      void refreshOnChange(target, [...changes].sort().join(\",\")).catch(\n        () => {},\n      );\n    }\n  });\n}\n\n/** For tests. */\nexport function resetChanges(): void {\n  registrations.clear();\n  close();\n  failures = 0;\n  pending = null;\n}\n"]}

package/dist/js/navigate.d.ts

@@ -139,7 +139,7 @@ export declare function applyRevalidated(target: string, tree: ReactNode): void;
  * form leaves the layouts alone, which is what makes it cheap and also why a
  * count living in a layout will not move until you ask for 'all'.
  */
-export declare function refresh(target?: string): Promise<void>;
+export declare function refresh(target?: string, changedBy?: string): Promise<void>;
 /**
  * Fetch a page's payload ahead of the navigation that may ask for it.
  *

package/dist/js/navigate.js

@@ -957,7 +957,7 @@ export function applyRevalidated(target, tree) {
  * form leaves the layouts alone, which is what makes it cheap and also why a
  * count living in a layout will not move until you ask for 'all'.
  */
-export async function refresh(target = "page") {
+export async function refresh(target = "page", changedBy) {
     const url = window.location.pathname + window.location.search;
     // Asked because the data moved on; what was fetched or held before is
     // from before.
@@ -968,6 +968,9 @@ export async function refresh(target = "page") {
                 "X-RSC": "true",
                 "X-RSC-Version": version,
                 "X-RSC-Revalidate": target,
+                // Which change asked: tabs asking about the same one share a render
+                // of a shared section. Only ever set by the watcher.
+                ...(changedBy ? { "X-RSC-Changed": changedBy } : {}),
             },
         });
         if (!response.ok) {