@rsc-kit/core 0.17.0 → 0.18.0

package/dist/barrelImports.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Rewrite the named imports in `code` whose package resolves to a barrel.
+ * `resolveEntry` answers a bare specifier with the file Vite would load for
+ * it, or null. Returns null when nothing changed.
+ */
+export declare function unrollBarrelImports(code: string, resolveEntry: (specifier: string) => string | null): string | null;

package/dist/barrelImports.js

@@ -0,0 +1,93 @@
+import { existsSync, readFileSync } from "node:fs";
+import { dirname, resolve } from "node:path";
+/**
+ * A named import from a barrel, rewritten to the module that owns the name.
+ *
+ * `import { ArrowRight } from 'lucide-react'` reaches a file that re-exports
+ * fifteen hundred icons, one module each. The browser gets the package
+ * pre-bundled; the server environments do not, on purpose - a package with
+ * a "use client" file stays as files so a client reference resolves to a
+ * real one - so Vite loaded and transformed every icon module on the first
+ * request. Measured: 3,700 transforms and twenty-five seconds before the
+ * first document, for thirteen icons. Next rewrites these imports for the
+ * same reason (optimizePackageImports); this does it for the packages it
+ * finds barrels in, by reading the barrel.
+ *
+ * The map from export name to file is read from the barrel's own
+ * `export { default as Name } from './x.mjs'` lines, once per barrel, so no
+ * package needs a table here. A name the barrel does not map that way - a
+ * component exported from the package's own source, say - is left on the
+ * original import and resolves as before.
+ */
+const REEXPORT = /export\s*\{([^}]*)\}\s*from\s*['"]([^'"]+)['"]/g;
+const NAMED_IMPORT = /^([ \t]*)import\s*(type\s+)?\{([^}]*)\}\s*from\s*(['"])([^'"]+)\4\s*;?[ \t]*$/gm;
+/** Which packages to unroll: a barrel is any entry whose exports are mostly re-exports of default exports. */
+const barrels = new Map();
+function readBarrel(entry) {
+    const cached = barrels.get(entry);
+    if (cached !== undefined)
+        return cached;
+    let map = null;
+    try {
+        const source = readFileSync(entry, "utf-8");
+        const found = new Map();
+        for (const m of source.matchAll(REEXPORT)) {
+            const file = resolve(dirname(entry), m[2]);
+            for (const spec of m[1].split(",")) {
+                const part = spec.trim().match(/^default\s+as\s+([A-Za-z_$][\w$]*)$/);
+                if (part)
+                    found.set(part[1], file);
+            }
+        }
+        // Under a hundred names is a module with a few re-exports, not a barrel
+        // worth unrolling; the cost this pays for is the long tail.
+        map = found.size >= 100 ? found : null;
+    }
+    catch {
+        map = null;
+    }
+    barrels.set(entry, map);
+    return map;
+}
+/**
+ * Rewrite the named imports in `code` whose package resolves to a barrel.
+ * `resolveEntry` answers a bare specifier with the file Vite would load for
+ * it, or null. Returns null when nothing changed.
+ */
+export function unrollBarrelImports(code, resolveEntry) {
+    if (!code.includes("import"))
+        return null;
+    let changed = false;
+    const out = code.replace(NAMED_IMPORT, (whole, indent, typeOnly, names, _q, specifier) => {
+        if (typeOnly || specifier.startsWith(".") || specifier.startsWith("/"))
+            return whole;
+        const entry = resolveEntry(specifier);
+        const map = entry && existsSync(entry) ? readBarrel(entry) : null;
+        if (!map)
+            return whole;
+        const kept = [];
+        const direct = [];
+        for (const spec of names.split(",")) {
+            const s = spec.trim();
+            if (!s)
+                continue;
+            const m = s.match(/^(?:type\s+)?([A-Za-z_$][\w$]*)(?:\s+as\s+([A-Za-z_$][\w$]*))?$/);
+            const exported = m?.[1];
+            const local = m?.[2] ?? exported;
+            const file = exported && !s.startsWith("type ") ? map.get(exported) : undefined;
+            if (file && local)
+                direct.push(`${indent}import ${local} from ${JSON.stringify(file)};`);
+            else
+                kept.push(s);
+        }
+        if (direct.length === 0)
+            return whole;
+        changed = true;
+        const rest = kept.length
+            ? `${indent}import { ${kept.join(", ")} } from ${JSON.stringify(specifier)};\n`
+            : "";
+        return rest + direct.join("\n");
+    });
+    return changed ? out : null;
+}
+//# sourceMappingURL=barrelImports.js.map

package/dist/barrelImports.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"barrelImports.js","sourceRoot":"","sources":["../src/barrelImports.ts"],"names":[],"mappings":"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","sourcesContent":["import { existsSync, readFileSync } from \"node:fs\";\nimport { dirname, resolve } from \"node:path\";\n\n/**\n * A named import from a barrel, rewritten to the module that owns the name.\n *\n * `import { ArrowRight } from 'lucide-react'` reaches a file that re-exports\n * fifteen hundred icons, one module each. The browser gets the package\n * pre-bundled; the server environments do not, on purpose - a package with\n * a \"use client\" file stays as files so a client reference resolves to a\n * real one - so Vite loaded and transformed every icon module on the first\n * request. Measured: 3,700 transforms and twenty-five seconds before the\n * first document, for thirteen icons. Next rewrites these imports for the\n * same reason (optimizePackageImports); this does it for the packages it\n * finds barrels in, by reading the barrel.\n *\n * The map from export name to file is read from the barrel's own\n * `export { default as Name } from './x.mjs'` lines, once per barrel, so no\n * package needs a table here. A name the barrel does not map that way - a\n * component exported from the package's own source, say - is left on the\n * original import and resolves as before.\n */\n\nconst REEXPORT = /export\\s*\\{([^}]*)\\}\\s*from\\s*['\"]([^'\"]+)['\"]/g;\nconst NAMED_IMPORT =\n  /^([ \\t]*)import\\s*(type\\s+)?\\{([^}]*)\\}\\s*from\\s*(['\"])([^'\"]+)\\4\\s*;?[ \\t]*$/gm;\n\n/** Which packages to unroll: a barrel is any entry whose exports are mostly re-exports of default exports. */\nconst barrels = new Map<string, Map<string, string> | null>();\n\nfunction readBarrel(entry: string): Map<string, string> | null {\n  const cached = barrels.get(entry);\n\n  if (cached !== undefined) return cached;\n\n  let map: Map<string, string> | null = null;\n\n  try {\n    const source = readFileSync(entry, \"utf-8\");\n    const found = new Map<string, string>();\n\n    for (const m of source.matchAll(REEXPORT)) {\n      const file = resolve(dirname(entry), m[2]);\n\n      for (const spec of m[1].split(\",\")) {\n        const part = spec.trim().match(/^default\\s+as\\s+([A-Za-z_$][\\w$]*)$/);\n\n        if (part) found.set(part[1], file);\n      }\n    }\n\n    // Under a hundred names is a module with a few re-exports, not a barrel\n    // worth unrolling; the cost this pays for is the long tail.\n    map = found.size >= 100 ? found : null;\n  } catch {\n    map = null;\n  }\n\n  barrels.set(entry, map);\n\n  return map;\n}\n\n/**\n * Rewrite the named imports in `code` whose package resolves to a barrel.\n * `resolveEntry` answers a bare specifier with the file Vite would load for\n * it, or null. Returns null when nothing changed.\n */\nexport function unrollBarrelImports(\n  code: string,\n  resolveEntry: (specifier: string) => string | null,\n): string | null {\n  if (!code.includes(\"import\")) return null;\n\n  let changed = false;\n\n  const out = code.replace(\n    NAMED_IMPORT,\n    (whole, indent: string, typeOnly, names: string, _q, specifier: string) => {\n      if (typeOnly || specifier.startsWith(\".\") || specifier.startsWith(\"/\"))\n        return whole;\n\n      const entry = resolveEntry(specifier);\n      const map = entry && existsSync(entry) ? readBarrel(entry) : null;\n\n      if (!map) return whole;\n\n      const kept: string[] = [];\n      const direct: string[] = [];\n\n      for (const spec of names.split(\",\")) {\n        const s = spec.trim();\n\n        if (!s) continue;\n\n        const m = s.match(\n          /^(?:type\\s+)?([A-Za-z_$][\\w$]*)(?:\\s+as\\s+([A-Za-z_$][\\w$]*))?$/,\n        );\n        const exported = m?.[1];\n        const local = m?.[2] ?? exported;\n        const file =\n          exported && !s.startsWith(\"type \") ? map.get(exported) : undefined;\n\n        if (file && local)\n          direct.push(`${indent}import ${local} from ${JSON.stringify(file)};`);\n        else kept.push(s);\n      }\n\n      if (direct.length === 0) return whole;\n\n      changed = true;\n\n      const rest = kept.length\n        ? `${indent}import { ${kept.join(\", \")} } from ${JSON.stringify(specifier)};\\n`\n        : \"\";\n\n      return rest + direct.join(\"\\n\");\n    },\n  );\n\n  return changed ? out : null;\n}\n"]}

package/dist/events.d.ts

@@ -0,0 +1,57 @@
+/**
+ * A route that streams: server-sent events from an async generator.
+ *
+ *     // app/api/orders/[id]/events/route.ts
+ *     export const GET = events(async function* ({ params, signal }) {
+ *       for await (const status of orderStatus((await params).id, { signal })) {
+ *         yield { status }
+ *       }
+ *     })
+ *
+ * An ordinary route.ts, so it lives beside its pages, runs the middleware.ts
+ * above it and takes the same params. What this adds is the framing - one
+ * `data:` line per yield, JSON - a keepalive comment every fifteen seconds
+ * so a proxy does not drop an idle stream, the headers a stream needs, and
+ * an end to the generator when the browser goes away, which is what `signal`
+ * is for. `useEvents` on the client reads it.
+ *
+ * Not a query. A query answers once and is cacheable; a stream answers for
+ * as long as the tab is open and is not. A server component cannot await a
+ * stream, so it has no place in the payload either.
+ */
+export interface EventsInput<P = Record<string, string>> {
+    params: Promise<P>;
+    searchParams: Promise<URLSearchParams>;
+    /** Aborted when the browser disconnects. Pass it on, or check `aborted`. */
+    signal: AbortSignal;
+    request: Request;
+}
+/** A message with a name or an id, for a client that listens by name or resumes. Made by `named()`. */
+export interface NamedEvent {
+    readonly [NAMED]: true;
+    event?: string;
+    id?: string;
+    data: unknown;
+}
+declare const NAMED: unique symbol;
+/**
+ * A message with a name or an id: `yield named('paid', order)`, or
+ * `named('paid', order, { id: order.id })` for one a client can resume from.
+ * Built by a function rather than by shape, so a message that happens to
+ * have a `data` key is still data, and the generator's own type stays the
+ * type of what it yields.
+ */
+export declare function named<D>(event: string, data: D, options?: {
+    id?: string;
+}): NamedEvent;
+/** How often a comment goes out on an idle stream, so a proxy keeps it open. */
+export declare const KEEPALIVE_MS = 15000;
+/** One message, framed. */
+export declare function frame(value: unknown): string;
+export declare function events<P = Record<string, string>, T = unknown>(produce: (input: EventsInput<P>) => AsyncIterable<T | NamedEvent>, options?: {
+    keepaliveMs?: number;
+}): (request: Request, input: {
+    params: Promise<P>;
+    searchParams: Promise<URLSearchParams>;
+}) => Response;
+export {};

package/dist/events.js

@@ -0,0 +1,113 @@
+/**
+ * A route that streams: server-sent events from an async generator.
+ *
+ *     // app/api/orders/[id]/events/route.ts
+ *     export const GET = events(async function* ({ params, signal }) {
+ *       for await (const status of orderStatus((await params).id, { signal })) {
+ *         yield { status }
+ *       }
+ *     })
+ *
+ * An ordinary route.ts, so it lives beside its pages, runs the middleware.ts
+ * above it and takes the same params. What this adds is the framing - one
+ * `data:` line per yield, JSON - a keepalive comment every fifteen seconds
+ * so a proxy does not drop an idle stream, the headers a stream needs, and
+ * an end to the generator when the browser goes away, which is what `signal`
+ * is for. `useEvents` on the client reads it.
+ *
+ * Not a query. A query answers once and is cacheable; a stream answers for
+ * as long as the tab is open and is not. A server component cannot await a
+ * stream, so it has no place in the payload either.
+ */
+const NAMED = Symbol.for("@rsc-kit/core.named-event");
+/**
+ * A message with a name or an id: `yield named('paid', order)`, or
+ * `named('paid', order, { id: order.id })` for one a client can resume from.
+ * Built by a function rather than by shape, so a message that happens to
+ * have a `data` key is still data, and the generator's own type stays the
+ * type of what it yields.
+ */
+export function named(event, data, options = {}) {
+    return { [NAMED]: true, event, id: options.id, data };
+}
+/** How often a comment goes out on an idle stream, so a proxy keeps it open. */
+export const KEEPALIVE_MS = 15_000;
+function isNamed(value) {
+    return (typeof value === "object" &&
+        value !== null &&
+        value[NAMED] === true);
+}
+/** One message, framed. */
+export function frame(value) {
+    const named = isNamed(value) ? value : null;
+    const lines = [];
+    if (named?.event)
+        lines.push(`event: ${named.event}`);
+    if (named?.id)
+        lines.push(`id: ${named.id}`);
+    lines.push(`data: ${JSON.stringify(named ? named.data : value)}`);
+    return lines.join("\n") + "\n\n";
+}
+export function events(produce, options = {}) {
+    const keepaliveMs = options.keepaliveMs ?? KEEPALIVE_MS;
+    return (request, input) => {
+        const controller = new AbortController();
+        const encoder = new TextEncoder();
+        request.signal.addEventListener("abort", () => controller.abort(), {
+            once: true,
+        });
+        const stream = new ReadableStream({
+            async start(sink) {
+                // The retry hint first, so a browser that loses the connection waits
+                // a moment rather than hammering.
+                sink.enqueue(encoder.encode("retry: 1000\n\n"));
+                const keepalive = setInterval(() => {
+                    try {
+                        sink.enqueue(encoder.encode(": keepalive\n\n"));
+                    }
+                    catch {
+                        // Closed between the check and the write; the loop below ends it.
+                    }
+                }, keepaliveMs);
+                try {
+                    for await (const value of produce({
+                        ...input,
+                        signal: controller.signal,
+                        request,
+                    })) {
+                        if (controller.signal.aborted)
+                            break;
+                        sink.enqueue(encoder.encode(frame(value)));
+                    }
+                }
+                catch (error) {
+                    if (!controller.signal.aborted)
+                        sink.error(error);
+                }
+                finally {
+                    clearInterval(keepalive);
+                    if (!controller.signal.aborted) {
+                        try {
+                            sink.close();
+                        }
+                        catch {
+                            // Already closed by the consumer.
+                        }
+                    }
+                }
+            },
+            cancel() {
+                controller.abort();
+            },
+        });
+        return new Response(stream, {
+            headers: {
+                "Content-Type": "text/event-stream; charset=utf-8",
+                "Cache-Control": "no-store",
+                // Nginx buffers by default, which turns a stream into one late burst.
+                "X-Accel-Buffering": "no",
+            },
+        });
+    };
+}
+//# sourceMappingURL=events.js.map

package/dist/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * A route that streams: server-sent events from an async generator.\n *\n *     // app/api/orders/[id]/events/route.ts\n *     export const GET = events(async function* ({ params, signal }) {\n *       for await (const status of orderStatus((await params).id, { signal })) {\n *         yield { status }\n *       }\n *     })\n *\n * An ordinary route.ts, so it lives beside its pages, runs the middleware.ts\n * above it and takes the same params. What this adds is the framing - one\n * `data:` line per yield, JSON - a keepalive comment every fifteen seconds\n * so a proxy does not drop an idle stream, the headers a stream needs, and\n * an end to the generator when the browser goes away, which is what `signal`\n * is for. `useEvents` on the client reads it.\n *\n * Not a query. A query answers once and is cacheable; a stream answers for\n * as long as the tab is open and is not. A server component cannot await a\n * stream, so it has no place in the payload either.\n */\n\nexport interface EventsInput<P = Record<string, string>> {\n  params: Promise<P>;\n  searchParams: Promise<URLSearchParams>;\n  /** Aborted when the browser disconnects. Pass it on, or check `aborted`. */\n  signal: AbortSignal;\n  request: Request;\n}\n\n/** A message with a name or an id, for a client that listens by name or resumes. Made by `named()`. */\nexport interface NamedEvent {\n  readonly [NAMED]: true;\n  event?: string;\n  id?: string;\n  data: unknown;\n}\n\nconst NAMED = Symbol.for(\"@rsc-kit/core.named-event\");\n\n/**\n * A message with a name or an id: `yield named('paid', order)`, or\n * `named('paid', order, { id: order.id })` for one a client can resume from.\n * Built by a function rather than by shape, so a message that happens to\n * have a `data` key is still data, and the generator's own type stays the\n * type of what it yields.\n */\nexport function named<D>(\n  event: string,\n  data: D,\n  options: { id?: string } = {},\n): NamedEvent {\n  return { [NAMED]: true, event, id: options.id, data };\n}\n\n/** How often a comment goes out on an idle stream, so a proxy keeps it open. */\nexport const KEEPALIVE_MS = 15_000;\n\nfunction isNamed(value: unknown): value is NamedEvent {\n  return (\n    typeof value === \"object\" &&\n    value !== null &&\n    (value as { [NAMED]?: true })[NAMED] === true\n  );\n}\n\n/** One message, framed. */\nexport function frame(value: unknown): string {\n  const named = isNamed(value) ? value : null;\n  const lines: string[] = [];\n\n  if (named?.event) lines.push(`event: ${named.event}`);\n  if (named?.id) lines.push(`id: ${named.id}`);\n  lines.push(`data: ${JSON.stringify(named ? named.data : value)}`);\n\n  return lines.join(\"\\n\") + \"\\n\\n\";\n}\n\nexport function events<P = Record<string, string>, T = unknown>(\n  produce: (input: EventsInput<P>) => AsyncIterable<T | NamedEvent>,\n  options: { keepaliveMs?: number } = {},\n): (\n  request: Request,\n  input: { params: Promise<P>; searchParams: Promise<URLSearchParams> },\n) => Response {\n  const keepaliveMs = options.keepaliveMs ?? KEEPALIVE_MS;\n\n  return (request, input) => {\n    const controller = new AbortController();\n    const encoder = new TextEncoder();\n\n    request.signal.addEventListener(\"abort\", () => controller.abort(), {\n      once: true,\n    });\n\n    const stream = new ReadableStream<Uint8Array>({\n      async start(sink) {\n        // The retry hint first, so a browser that loses the connection waits\n        // a moment rather than hammering.\n        sink.enqueue(encoder.encode(\"retry: 1000\\n\\n\"));\n\n        const keepalive = setInterval(() => {\n          try {\n            sink.enqueue(encoder.encode(\": keepalive\\n\\n\"));\n          } catch {\n            // Closed between the check and the write; the loop below ends it.\n          }\n        }, keepaliveMs);\n\n        try {\n          for await (const value of produce({\n            ...input,\n            signal: controller.signal,\n            request,\n          })) {\n            if (controller.signal.aborted) break;\n\n            sink.enqueue(encoder.encode(frame(value)));\n          }\n        } catch (error) {\n          if (!controller.signal.aborted) sink.error(error);\n        } finally {\n          clearInterval(keepalive);\n\n          if (!controller.signal.aborted) {\n            try {\n              sink.close();\n            } catch {\n              // Already closed by the consumer.\n            }\n          }\n        }\n      },\n      cancel() {\n        controller.abort();\n      },\n    });\n\n    return new Response(stream, {\n      headers: {\n        \"Content-Type\": \"text/event-stream; charset=utf-8\",\n        \"Cache-Control\": \"no-store\",\n        // Nginx buffers by default, which turns a stream into one late burst.\n        \"X-Accel-Buffering\": \"no\",\n      },\n    });\n  };\n}\n"]}

package/dist/host.d.ts

@@ -1,9 +1,19 @@
-export { revalidate } from './revalidate.js';
-export { redirect } from './redirect.js';
-export { matchIntercept, matchRoute, sharedDepth } from './routing.js';
-export type { MatchedRoute } from './routing.js';
-import type { MatchedRoute } from './routing.js';
-import type { RouteManifest } from './manifest.js';
+/**
+ * @internal For a host adapter that embeds the engine. An app imports this
+ * from `@rsc-kit/core/revalidate`.
+ */
+export { revalidate } from "./revalidate.js";
+/**
+ * @internal For a host adapter that embeds the engine. An app imports this
+ * from `@rsc-kit/core/redirect` - the one the guides teach, and the one an
+ * editor should offer first.
+ */
+export { redirect } from "./redirect.js";
+/** @internal For a host adapter. An app never matches its own routes. */
+export { matchIntercept, matchRoute, sharedDepth } from "./routing.js";
+export type { MatchedRoute } from "./routing.js";
+import type { MatchedRoute } from "./routing.js";
+import type { RouteManifest } from "./manifest.js";
 /** The built server bundle. Only the parts a host calls. */
 export interface RscEngine {
     /** The route table this bundle was built from. */