@rsc-kit/core 0.29.5 → 0.29.7

package/dist/typegen.d.ts

@@ -9,3 +9,11 @@
  * build and cannot be stale - and every one is put back as it was.
  */
 export declare function typegen(root?: string, check?: boolean): Promise<string[]>;
+/**
+ * What a build of the app in `root` will produce - `{ output: "server", ... }`
+ * or `{ output: "export", dir }` - read before building, from the app's own
+ * Vite config, evaluated the way a build evaluates it. A value computed in
+ * the config, or RSC_OUTPUT in the environment, resolves exactly as the build
+ * resolves it, because it is the same code deciding.
+ */
+export declare function appInfo(root?: string): Promise<Record<string, unknown>>;

package/dist/typegen.js

@@ -87,4 +87,38 @@ if (import.meta.url === pathToFileURL(process.argv[1] ?? "").href || process.arg
         exit(1);
     });
 }
+/**
+ * What a build of the app in `root` will produce - `{ output: "server", ... }`
+ * or `{ output: "export", dir }` - read before building, from the app's own
+ * Vite config, evaluated the way a build evaluates it. A value computed in
+ * the config, or RSC_OUTPUT in the environment, resolves exactly as the build
+ * resolves it, because it is the same code deciding.
+ */
+export async function appInfo(root = cwd()) {
+    const local = createRequire(join(root, "package.json"));
+    let vitePath;
+    try {
+        vitePath = local.resolve("vite");
+    }
+    catch {
+        throw new Error("No vite installed in " + root + ". Run this from the app's directory.");
+    }
+    const vite = (await import(pathToFileURL(vitePath).href));
+    // From inside the app, as a build runs: rscKit() takes its project root
+    // from the working directory when the config creates it.
+    const from = cwd();
+    process.chdir(root);
+    try {
+        const loaded = await vite.loadConfigFromFile({ command: "build", mode: "production" }, undefined, root);
+        if (!loaded)
+            throw new Error("No vite.config found in " + root + ".");
+        const plugin = (await flatten(loaded.config.plugins ?? [])).find((p) => p.name === "rsc-kit");
+        if (!plugin?.api?.info)
+            throw new Error("The vite.config in " + root + " does not use rscKit().");
+        return plugin.api.info();
+    }
+    finally {
+        process.chdir(from);
+    }
+}
 //# sourceMappingURL=typegen.js.map

package/dist/typegen.js.map

@@ -1 +1 @@
-{"version":3,"file":"typegen.js","sourceRoot":"","sources":["../src/typegen.ts"],"names":[],"mappings":"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","sourcesContent":["#!/usr/bin/env node\n// rsc-kit-typegen: write the route types without starting Vite.\n//\n// The types - every url the app has, for <Link href> and redirect() - are\n// written when the dev server or a build starts, and again when a dev server\n// sees a route added. A typecheck run with neither, by an agent or in CI,\n// read the types from the last start: a route added since failed with\n// '\"/admin\"' is not assignable to type Route until something started Vite.\n//\n// The app's own vite.config is loaded, through the app's own Vite, so the\n// plugin's options - sourceDir, outDir, a host's route file - are the ones it\n// builds with. Only the plugin's config step runs, which is what writes them.\n\nimport { existsSync, readFileSync, writeFileSync } from \"node:fs\";\nimport { createRequire } from \"node:module\";\nimport { join, relative } from \"node:path\";\nimport { cwd, exit, stderr, stdout } from \"node:process\";\nimport { pathToFileURL } from \"node:url\";\n\ninterface PluginLike {\n  name?: string;\n  config?: (config: object, env: { command: string; mode: string }) => unknown;\n  api?: { generatedFiles?: () => string[] };\n}\n\nasync function flatten(option: unknown): Promise<PluginLike[]> {\n  const value = await option;\n\n  if (Array.isArray(value)) return (await Promise.all(value.map(flatten))).flat();\n\n  return value && typeof value === \"object\" ? [value as PluginLike] : [];\n}\n\n/**\n * Write the types; or, with `check`, say which committed generated files are\n * not what the backend and the route tree produce now, and change nothing.\n *\n * For CI: `rsc-kit-typegen --check` fails when rsc-host.json or the types were\n * committed and the backend has moved on since. Only files that were already\n * there are compared - one that is not committed is written fresh by every\n * build and cannot be stale - and every one is put back as it was.\n */\nexport async function typegen(root = cwd(), check = false): Promise<string[]> {\n  const local = createRequire(join(root, \"package.json\"));\n  let vitePath: string;\n\n  try {\n    vitePath = local.resolve(\"vite\");\n  } catch {\n    throw new Error(\"No vite installed in \" + root + \". Run this from the app's directory.\");\n  }\n\n  const vite = (await import(pathToFileURL(vitePath).href)) as {\n    loadConfigFromFile: (\n      env: { command: string; mode: string },\n      file?: string,\n      root?: string,\n    ) => Promise<{ config: { plugins?: unknown[] } } | null>;\n  };\n\n  // As a build would: a manifest command that fails is a failure, not a\n  // warning, when the question is whether what is committed is current.\n  const env = check ? { command: \"build\", mode: \"production\" } : { command: \"serve\", mode: \"development\" };\n  const loaded = await vite.loadConfigFromFile(env, undefined, root);\n\n  if (!loaded) throw new Error(\"No vite.config found in \" + root + \".\");\n\n  const plugin = (await flatten(loaded.config.plugins ?? [])).find((p) => p.name === \"rsc-kit\");\n\n  if (!plugin?.config) throw new Error(\"The vite.config in \" + root + \" does not use rscKit().\");\n\n  if (!check) {\n    await plugin.config({}, env);\n\n    return [];\n  }\n\n  const files = plugin.api?.generatedFiles?.() ?? [];\n  const before = new Map(files.filter((f) => existsSync(f)).map((f) => [f, readFileSync(f, \"utf-8\")]));\n\n  try {\n    await plugin.config({}, env);\n\n    return [...before].filter(([f, text]) => !existsSync(f) || readFileSync(f, \"utf-8\") !== text).map(([f]) => f);\n  } finally {\n    for (const [f, text] of before) writeFileSync(f, text);\n  }\n}\n\n// Run as a command, not when imported.\nif (import.meta.url === pathToFileURL(process.argv[1] ?? \"\").href || process.argv[1]?.endsWith(\"rsc-kit-typegen\")) {\n  const check = process.argv.includes(\"--check\");\n\n  typegen(cwd(), check)\n    .then((stale) => {\n      if (!check) {\n        stdout.write(\"rsc-kit: route types written\\n\");\n\n        return;\n      }\n\n      if (stale.length === 0) {\n        stdout.write(\"rsc-kit: generated files are current\\n\");\n\n        return;\n      }\n\n      stderr.write(\n        \"rsc-kit-typegen --check: these are committed and no longer what the backend and the routes produce:\\n\" +\n          stale.map((f) => \"  \" + relative(cwd(), f)).join(\"\\n\") +\n          \"\\nRun rsc-kit-typegen and commit the result.\\n\",\n      );\n      exit(1);\n    })\n    .catch((error: unknown) => {\n      stderr.write(\"rsc-kit-typegen: \" + (error instanceof Error ? error.message : String(error)) + \"\\n\");\n      exit(1);\n    });\n}\n"]}
+{"version":3,"file":"typegen.js","sourceRoot":"","sources":["../src/typegen.ts"],"names":[],"mappings":"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","sourcesContent":["#!/usr/bin/env node\n// rsc-kit-typegen: write the route types without starting Vite.\n//\n// The types - every url the app has, for <Link href> and redirect() - are\n// written when the dev server or a build starts, and again when a dev server\n// sees a route added. A typecheck run with neither, by an agent or in CI,\n// read the types from the last start: a route added since failed with\n// '\"/admin\"' is not assignable to type Route until something started Vite.\n//\n// The app's own vite.config is loaded, through the app's own Vite, so the\n// plugin's options - sourceDir, outDir, a host's route file - are the ones it\n// builds with. Only the plugin's config step runs, which is what writes them.\n\nimport { existsSync, readFileSync, writeFileSync } from \"node:fs\";\nimport { createRequire } from \"node:module\";\nimport { join, relative } from \"node:path\";\nimport { cwd, exit, stderr, stdout } from \"node:process\";\nimport { pathToFileURL } from \"node:url\";\n\ninterface PluginLike {\n  name?: string;\n  config?: (config: object, env: { command: string; mode: string }) => unknown;\n  api?: { generatedFiles?: () => string[]; info?: () => Record<string, unknown> };\n}\n\nasync function flatten(option: unknown): Promise<PluginLike[]> {\n  const value = await option;\n\n  if (Array.isArray(value)) return (await Promise.all(value.map(flatten))).flat();\n\n  return value && typeof value === \"object\" ? [value as PluginLike] : [];\n}\n\n/**\n * Write the types; or, with `check`, say which committed generated files are\n * not what the backend and the route tree produce now, and change nothing.\n *\n * For CI: `rsc-kit-typegen --check` fails when rsc-host.json or the types were\n * committed and the backend has moved on since. Only files that were already\n * there are compared - one that is not committed is written fresh by every\n * build and cannot be stale - and every one is put back as it was.\n */\nexport async function typegen(root = cwd(), check = false): Promise<string[]> {\n  const local = createRequire(join(root, \"package.json\"));\n  let vitePath: string;\n\n  try {\n    vitePath = local.resolve(\"vite\");\n  } catch {\n    throw new Error(\"No vite installed in \" + root + \". Run this from the app's directory.\");\n  }\n\n  const vite = (await import(pathToFileURL(vitePath).href)) as {\n    loadConfigFromFile: (\n      env: { command: string; mode: string },\n      file?: string,\n      root?: string,\n    ) => Promise<{ config: { plugins?: unknown[] } } | null>;\n  };\n\n  // As a build would: a manifest command that fails is a failure, not a\n  // warning, when the question is whether what is committed is current.\n  const env = check ? { command: \"build\", mode: \"production\" } : { command: \"serve\", mode: \"development\" };\n  const loaded = await vite.loadConfigFromFile(env, undefined, root);\n\n  if (!loaded) throw new Error(\"No vite.config found in \" + root + \".\");\n\n  const plugin = (await flatten(loaded.config.plugins ?? [])).find((p) => p.name === \"rsc-kit\");\n\n  if (!plugin?.config) throw new Error(\"The vite.config in \" + root + \" does not use rscKit().\");\n\n  if (!check) {\n    await plugin.config({}, env);\n\n    return [];\n  }\n\n  const files = plugin.api?.generatedFiles?.() ?? [];\n  const before = new Map(files.filter((f) => existsSync(f)).map((f) => [f, readFileSync(f, \"utf-8\")]));\n\n  try {\n    await plugin.config({}, env);\n\n    return [...before].filter(([f, text]) => !existsSync(f) || readFileSync(f, \"utf-8\") !== text).map(([f]) => f);\n  } finally {\n    for (const [f, text] of before) writeFileSync(f, text);\n  }\n}\n\n// Run as a command, not when imported.\nif (import.meta.url === pathToFileURL(process.argv[1] ?? \"\").href || process.argv[1]?.endsWith(\"rsc-kit-typegen\")) {\n  const check = process.argv.includes(\"--check\");\n\n  typegen(cwd(), check)\n    .then((stale) => {\n      if (!check) {\n        stdout.write(\"rsc-kit: route types written\\n\");\n\n        return;\n      }\n\n      if (stale.length === 0) {\n        stdout.write(\"rsc-kit: generated files are current\\n\");\n\n        return;\n      }\n\n      stderr.write(\n        \"rsc-kit-typegen --check: these are committed and no longer what the backend and the routes produce:\\n\" +\n          stale.map((f) => \"  \" + relative(cwd(), f)).join(\"\\n\") +\n          \"\\nRun rsc-kit-typegen and commit the result.\\n\",\n      );\n      exit(1);\n    })\n    .catch((error: unknown) => {\n      stderr.write(\"rsc-kit-typegen: \" + (error instanceof Error ? error.message : String(error)) + \"\\n\");\n      exit(1);\n    });\n}\n\n/**\n * What a build of the app in `root` will produce - `{ output: \"server\", ... }`\n * or `{ output: \"export\", dir }` - read before building, from the app's own\n * Vite config, evaluated the way a build evaluates it. A value computed in\n * the config, or RSC_OUTPUT in the environment, resolves exactly as the build\n * resolves it, because it is the same code deciding.\n */\nexport async function appInfo(root = cwd()): Promise<Record<string, unknown>> {\n  const local = createRequire(join(root, \"package.json\"));\n  let vitePath: string;\n\n  try {\n    vitePath = local.resolve(\"vite\");\n  } catch {\n    throw new Error(\"No vite installed in \" + root + \". Run this from the app's directory.\");\n  }\n\n  const vite = (await import(pathToFileURL(vitePath).href)) as {\n    loadConfigFromFile: (\n      env: { command: string; mode: string },\n      file?: string,\n      root?: string,\n    ) => Promise<{ config: { plugins?: unknown[] } } | null>;\n  };\n  // From inside the app, as a build runs: rscKit() takes its project root\n  // from the working directory when the config creates it.\n  const from = cwd();\n\n  process.chdir(root);\n\n  try {\n    const loaded = await vite.loadConfigFromFile({ command: \"build\", mode: \"production\" }, undefined, root);\n\n    if (!loaded) throw new Error(\"No vite.config found in \" + root + \".\");\n\n    const plugin = (await flatten(loaded.config.plugins ?? [])).find((p) => p.name === \"rsc-kit\");\n\n    if (!plugin?.api?.info) throw new Error(\"The vite.config in \" + root + \" does not use rscKit().\");\n\n    return plugin.api.info();\n  } finally {\n    process.chdir(from);\n  }\n}\n\n"]}

package/dist/vite.d.ts

@@ -405,6 +405,31 @@ export interface KnownAction {
  * its own - is its character code, so no two paths share an alias.
  */
 export declare function toAlias(name: string): string;
+/**
+ * Which of the two metadata exports a module actually has.
+ *
+ * Both are read separately because the generated entry names each one it
+ * mentions, and naming an export that is not there is a bundler warning on
+ * every build — `Import 'generateMetadata' will always be undefined`. Most
+ * pages export only the static object, so referencing both meant that warning
+ * for almost every route in an app.
+ */
+/**
+ * The root layout's metadataBase, read from the source. Wanted while the
+ * manifest is built, before there is a bundle to execute - the same reason
+ * generateStaticParams is detected by reading. A `new URL('…')` or a string
+ * literal; anything computed is not seen, and rscKit({ hosts }) says it.
+ */
+/**
+ * The app's single-binary step, as its package.json declares it: the script
+ * named compile, and the file its --outfile writes. Read from the app's own
+ * script, so a deploy runs what the app runs and never assumes a path. None
+ * when the app has no such script - a server it starts with node or bun.
+ */
+export declare function compileStep(root: string): {
+    compile?: string;
+    binary?: string;
+};
 /**
  * How the generated entry imports instrumentation.ts, as `__instrumentation`.
  *

package/dist/vite.js

@@ -2565,6 +2565,25 @@ function discover(dir) {
  * generateStaticParams is detected by reading. A `new URL('…')` or a string
  * literal; anything computed is not seen, and rscKit({ hosts }) says it.
  */
+/**
+ * The app's single-binary step, as its package.json declares it: the script
+ * named compile, and the file its --outfile writes. Read from the app's own
+ * script, so a deploy runs what the app runs and never assumes a path. None
+ * when the app has no such script - a server it starts with node or bun.
+ */
+export function compileStep(root) {
+    try {
+        const pkg = JSON.parse(readFileSync(join(root, "package.json"), "utf-8"));
+        const script = pkg.scripts?.compile;
+        if (!script)
+            return {};
+        const outfile = /--outfile[= ]+("[^"]+"|'[^']+'|\S+)/.exec(script)?.[1]?.replace(/^["']|["']$/g, "");
+        return outfile ? { compile: "compile", binary: outfile } : { compile: "compile" };
+    }
+    catch {
+        return {};
+    }
+}
 /** The root layout's metadataBase as the loaded app has it, whatever it was computed from. */
 async function loadedMetadataBase(engine, manifest) {
     const resolve = engine
@@ -2659,7 +2678,19 @@ function urlSchemaExports(absPath) {
  * generated is cheaper than something generated that returns early, and it
  * keeps every backend-shaped idea out of a runtime that has no backend.
  */
-const FALLBACK_CONSTS = `const FALLBACK_ORIGIN = __ORIGIN__
+const FALLBACK_CONSTS = `const FALLBACK_DEFAULT = __ORIGIN__
+
+// Where a url nothing here owns is handed on, read per request from the
+// environment this server runs in - RSC_BACKEND, or APP_URL beside a
+// host-call secret, exactly as host calls find their backend - so a build
+// carries no address and one binary runs against whichever backend its
+// deployment names. FALLBACK_DEFAULT is the development server's, or an
+// explicit rscKit({ devFallback }); a build never fills it from its own env.
+function fallbackOrigin(): string {
+  const env = (typeof process === 'undefined' ? {} : process.env) as Record<string, string | undefined>
+
+  return env.RSC_BACKEND || (env.RSC_HOST_CALL_SECRET ? env.APP_URL : '') || FALLBACK_DEFAULT
+}
 const FALLBACK_MARKER = 'x-rsc-renderer-fallback'
 const PROXIED_MARKER = 'x-rsc-proxied-by-backend'
 `;
@@ -2672,7 +2703,8 @@ const NO_FALLBACK_BODY = `  const answer = await devHandler(request)
 
   return await notFound(request)
 `;
-const FALLBACK_BODY = `  const answer = await devHandler(request)
+const FALLBACK_BODY = `  const FALLBACK_ORIGIN = fallbackOrigin()
+  const answer = await devHandler(request)
 
   if (answer) return answer
 
@@ -2694,7 +2726,15 @@ const FALLBACK_BODY = `  const answer = await devHandler(request)
   // Came from the backend's own proxy, so it has already been through that
   // route table and the answer there was no. Sending it back asks the same
   // question a second time.
-  if (!FALLBACK_ORIGIN || request.headers.has(PROXIED_MARKER)) {
+  // No backend named where this server runs: this app's own not-found, as
+  // an app without a backend answers - or a test's stand-in backend.
+  if (!FALLBACK_ORIGIN) {
+    if (backendForward) return await backendForward(request)
+
+    return await notFound(request)
+  }
+
+  if (request.headers.has(PROXIED_MARKER)) {
     return new Response('Not found', { status: 404 })
   }
 
@@ -3449,6 +3489,40 @@ export function installBackendForward(fn: ((request: Request) => Response | Prom
   backendForward = fn
 }
 
+/**
+ * Whether the backend answers, for /_rsc/health: null when there is no
+ * backend to ask, "ok" when it answered, and otherwise why not.
+ *
+ * Asks the route guards with none to run - every adapter passes an empty
+ * list, so the call runs no app code and touches no data, yet it goes all
+ * the way: the address, the network, the secret, the adapter. A port that is
+ * open but answering with the wrong secret is not ready, and this says so.
+ */
+export async function checkBackend(timeoutMs = 2000): Promise<string | null> {
+  if (typeof installHostCallsOnce === 'function') installHostCallsOnce()
+
+  const host = currentHost
+
+  if (!host) return null
+
+  let timer: ReturnType<typeof setTimeout> | undefined
+
+  try {
+    const answer = await Promise.race([
+      host('__rsc.middleware', []),
+      new Promise((_, reject) => {
+        timer = setTimeout(() => reject(new Error('no answer within ' + timeoutMs + 'ms')), timeoutMs)
+      }),
+    ])
+
+    return answer === true ? 'ok' : 'answered ' + JSON.stringify(answer) + ' to an empty guard check'
+  } catch (error) {
+    return error instanceof Error ? error.message : String(error)
+  } finally {
+    clearTimeout(timer)
+  }
+}
+
 export function installHostFn(fn: HostFn) {
   currentHost = fn
   // The host keeps the versions a page refreshes on, read through it.
@@ -5445,7 +5519,7 @@ export async function handleRscPprShell(
  * server rendering live pages it had already frozen. The gate is the mode, not
  * the file.
  */
-${fallbackOrigin ? FALLBACK_CONSTS.replace("__ORIGIN__", JSON.stringify(fallbackOrigin)) : ""}${NITRO_HOST_CALLS}
+${fallbackOrigin === false ? "" : FALLBACK_CONSTS.replace("__ORIGIN__", JSON.stringify(fallbackOrigin))}${NITRO_HOST_CALLS}
 let devHandler: ((request: Request) => Promise<Response | null>) | null = null
 
 export default async function handler(request: Request): Promise<Response> {
@@ -5479,6 +5553,7 @@ async function serve(request: Request): Promise<Response> {
       manifest,
       getStaticParams,
       installHostFn,
+      checkBackend,
       handleRsc,
       handleRscStream,
       handleRscHtmlStream,
@@ -5498,7 +5573,7 @@ async function serve(request: Request): Promise<Response> {
 ${NITRO_HANDLER_OPTIONS}${NITRO_PRERENDERED}    maxActionBody: ${maxActionBody === undefined ? "undefined" : String(maxActionBody)},
   })
 
-${fallbackOrigin ? FALLBACK_BODY : NO_FALLBACK_BODY}}
+${fallbackOrigin === false ? NO_FALLBACK_BODY : FALLBACK_BODY}}
 
 /**
  * The page for a url nothing answers.
@@ -6656,6 +6731,17 @@ export function rscKit(options = {}) {
         // For rsc-kit-typegen --check: every file the config step writes that an
         // app might commit, so a stale one can be named.
         api: {
+            /**
+             * What a build of this app will produce, known before building: for a
+             * deploy that has to plan - a binary or a folder, which script to run -
+             * before anything exists. `rsc-kit info --json` prints it; the build
+             * writes the same thing to .output/rsc-kit.json as it finishes.
+             */
+            info() {
+                return output === "export"
+                    ? { version: PACKAGE_VERSION, output: "export", dir: relative(projectRoot, exportPath) }
+                    : { version: PACKAGE_VERSION, output: "server", ...compileStep(projectRoot) };
+            },
             generatedFiles() {
                 return [
                     join(projectRoot, HOST_FILE),
@@ -6852,7 +6938,22 @@ export function rscKit(options = {}) {
                     backendEnv.APP_URL ??
                     "")
                 : "";
-            const fallbackOrigin = options.devFallback === false ? "" : (options.devFallback ?? detected);
+            // false turns forwarding off. A string from the config is fixed; what
+            // the env says is only the dev server's - a build reads its backend at
+            // runtime and bakes nothing in, so a binary is not tied to the machine
+            // that built it.
+            // Forwarding is for an app with a backend, and whether it has one is
+            // in its own files - rsc-host.json, a hostManifest, a hostCall - not in
+            // whatever environment it happened to be built in. A JavaScript-only
+            // app gets no forwarding code at all; it is the backend.
+            const declaresBackend = Boolean(options.hostManifest || options.hostCall || existsSync(join(projectRoot, HOST_FILE)));
+            const fallbackOrigin = options.devFallback === false
+                ? false
+                : typeof options.devFallback === "string"
+                    ? options.devFallback
+                    : env.command === "build"
+                        ? (declaresBackend ? "" : false)
+                        : (detected || (declaresBackend ? "" : false));
             writeGenerated(join(genDir, "entry.rsc.tsx"), generateEntryRsc(fallbackOrigin));
             writeGenerated(join(genDir, "entry.ssr.tsx"), generateEntrySsr());
             writeGenerated(join(genDir, "entry.browser.tsx"), generateEntryBrowser());
@@ -7348,6 +7449,15 @@ export function rscKit(options = {}) {
             // after the prerender, and an export taken any earlier left them out.
             if (output === "export")
                 await exportAfterPrerender(results, staticDir, clientOut ?? publicAssetsDir);
+            // What this build produced, where a deploy can read it without parsing
+            // vite.config.ts - which can turn export on through RSC_OUTPUT, or
+            // compute it - or knowing where rsc-kit keeps things inside .output.
+            // Written by the code that decided, so it cannot disagree with it.
+            if (clientOut) {
+                writeFileSync(join(dirname(clientOut), "rsc-kit.json"), JSON.stringify(output === "export"
+                    ? { version: PACKAGE_VERSION, output: "export", dir: relative(projectRoot, exportPath) }
+                    : { version: PACKAGE_VERSION, output: "server", ...compileStep(projectRoot) }, null, 2) + "\n");
+            }
         },
         configResolved(config) {
             // A build that is not a production build cannot work here, and the