@farm.js/core 0.1.48 → 0.1.49

package/dist/{chunk-NRFUVDTH.mjs → chunk-DGVVVYKD.mjs}

@@ -23,7 +23,7 @@ import {
 } from "./chunk-LM2YOGDK.mjs";
 import {
   FARM_VERSION
-} from "./chunk-HRLYO2XJ.mjs";
+} from "./chunk-ACI52TCN.mjs";
 import {
   applyFarmBasePath
 } from "./chunk-SF3JB56B.mjs";

package/dist/{chunk-WUEDTW6E.cjs → chunk-FR4HJDI6.cjs}

@@ -10,6 +10,9 @@ var _chunkKZT2VHRQcjs = require('./chunk-KZT2VHRQ.cjs');
 var _chunk4S7M63WXcjs = require('./chunk-4S7M63WX.cjs');
 
 
+var _chunkZBS3GOQZcjs = require('./chunk-ZBS3GOQZ.cjs');
+
+
 var _chunkIXSMFKZ2cjs = require('./chunk-IXSMFKZ2.cjs');
 
 // src/rsc-pipeline.ts
@@ -91,6 +94,7 @@ async function createFarmRscViteConfig(userConfig, options) {
     experimental: { ...userConfig.experimental, serverComponents: true },
     port: _nullishCoalesce(options.port, () => ( _optionalChain([userConfig, 'access', _3 => _3.server, 'optionalAccess', _4 => _4.port]))),
     plugins: [
+      ...options.command === "serve" && _chunkZBS3GOQZcjs.resolveFarmPlatform.call(void 0, ) === "desktop" ? [farmRscDesktopDevGuardPlugin(userConfig.basePath)] : [],
       ...tailwind ? [tailwind] : [],
       ...vitePlugins,
       viteRsc.default({ serverHandler: false, entries: FARM_RSC_ENTRIES }),
@@ -116,6 +120,23 @@ async function createFarmRscViteConfig(userConfig, options) {
     mode: options.command === "build" ? "production" : "development"
   };
 }
+function farmRscDesktopDevGuardPlugin(basePath) {
+  return {
+    name: "farm:desktop-dev-guard",
+    enforce: "pre",
+    configureServer: {
+      order: "pre",
+      async handler(server) {
+        const { createFarmDesktopDevGuard } = await import("./dev-guard-PLHL6OTJ.cjs");
+        server.middlewares.use(
+          createFarmDesktopDevGuard(server, {
+            basePath: typeof basePath === "string" ? basePath : ""
+          })
+        );
+      }
+    }
+  };
+}
 async function createFarmRscDevServer(userConfig, options) {
   const { createServer } = await import("vite");
   return createServer(await createFarmRscViteConfig(userConfig, { ...options, command: "serve" }));

package/dist/{chunk-HUL4LTC6.cjs → chunk-HTLCLOXQ.cjs}

@@ -1,6 +1,6 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }
 
-var _chunkZGS3ZDF7cjs = require('./chunk-ZGS3ZDF7.cjs');
+var _chunkNPPT4RWFcjs = require('./chunk-NPPT4RWF.cjs');
 
 
 var _chunkWJFFPXCVcjs = require('./chunk-WJFFPXCV.cjs');
@@ -45,13 +45,12 @@ function resolveFarmInfraAnalytics(env = processEnv()) {
   if (!key || env[FARM_PRERENDER_ENV] === "1") return { off: null };
   const ingestionKey = INGESTION_KEY.test(key);
   const projectId = _optionalChain([env, 'access', _6 => _6.FARMJS_PROJECT_ID, 'optionalAccess', _7 => _7.trim, 'call', _8 => _8()]) || void 0;
-  if (!ingestionKey && !projectId) return { off: null };
   if (!ingestionKey && !API_KEY.test(key)) {
     return {
       off: "FARMJS_API_KEY isn't a Farm Infra API key (farmjs_\u2026) or write-only key (fti_\u2026)"
     };
   }
-  if (!ingestionKey && !PROJECT.test(projectId)) {
+  if (!ingestionKey && projectId && !PROJECT.test(projectId)) {
     return { off: "FARMJS_PROJECT_ID isn't a Farm Infra project ID (proj_\u2026)" };
   }
   if (env.FARMJS_ENVIRONMENT && !ENVIRONMENTS.includes(env.FARMJS_ENVIRONMENT)) {
@@ -71,7 +70,7 @@ function resolveFarmInfraAnalytics(env = processEnv()) {
     options: {
       endpoint: endpoint.href,
       key,
-      ...ingestionKey ? {} : { projectId, environment: defaultFarmInfraEnvironment(env) }
+      ...ingestionKey ? {} : { ...projectId ? { projectId } : {}, environment: defaultFarmInfraEnvironment(env) }
     }
   };
 }
@@ -95,13 +94,45 @@ function retryAt(value, now) {
   const date = Date.parse(value);
   return Number.isFinite(date) ? Math.max(now, Math.min(date, now + 864e5)) : now;
 }
+var REFUSALS = {
+  project: "project",
+  api_key_permission: "permission",
+  api_key_environment: "environment"
+};
+async function refusal(response) {
+  const reader = _optionalChain([response, 'access', _12 => _12.body, 'optionalAccess', _13 => _13.getReader, 'call', _14 => _14()]);
+  if (!reader) return void 0;
+  let text = "";
+  const decoder = new TextDecoder();
+  const deadline = Date.now() + 500;
+  try {
+    while (text.length < 1024 && Date.now() < deadline) {
+      let timer;
+      const chunk = await Promise.race([
+        reader.read(),
+        new Promise((resolve) => {
+          timer = setTimeout(() => resolve({ done: true }), deadline - Date.now());
+        })
+      ]).finally(() => clearTimeout(timer));
+      if (chunk.done) break;
+      text += decoder.decode(chunk.value, { stream: true });
+    }
+    const code = JSON.parse(text).error;
+    return typeof code === "string" && Object.prototype.hasOwnProperty.call(REFUSALS, code) ? REFUSALS[code] : void 0;
+  } catch (e2) {
+    return void 0;
+  } finally {
+    void reader.cancel().catch(() => {
+    });
+  }
+}
 function createFarmInfraAnalyticsExporter(options, send = (input, init) => fetch(input, init)) {
   const requestHeaders = {
     "content-type": "application/json",
     authorization: `Bearer ${options.key}`
   };
   if (!INGESTION_KEY.test(options.key)) {
-    requestHeaders["x-farm-project"] = options.projectId;
+    if (options.projectId) requestHeaders["x-farm-project"] = options.projectId;
     requestHeaders["x-farm-environment"] = _nullishCoalesce(options.environment, () => ( defaultFarmInfraEnvironment()));
   }
   const queue = [];
@@ -113,9 +144,9 @@ function createFarmInfraAnalyticsExporter(options, send = (input, init) => fetch
   let inFlight = /* @__PURE__ */ new Set();
   const diagnostic = (event) => {
     try {
-      void Promise.resolve(_optionalChain([options, 'access', _12 => _12.onDiagnostic, 'optionalCall', _13 => _13(event)])).catch(() => {
+      void Promise.resolve(_optionalChain([options, 'access', _15 => _15.onDiagnostic, 'optionalCall', _16 => _16(event)])).catch(() => {
       });
-    } catch (e2) {
+    } catch (e3) {
     }
   };
   const expired = (item, now) => !inFlight.has(item) && (now - item.enqueuedAt >= MAX_AGE || item.attempts >= MAX_ATTEMPTS);
@@ -161,7 +192,7 @@ function createFarmInfraAnalyticsExporter(options, send = (input, init) => fetch
       for (const item of batch) item.attempts++;
       inFlight = new Set(batch);
       active = new AbortController();
-      const timeout = setTimeout(() => _optionalChain([active, 'optionalAccess', _14 => _14.abort, 'call', _15 => _15()]), Math.min(TIMEOUT, deadline - Date.now()));
+      const timeout = setTimeout(() => _optionalChain([active, 'optionalAccess', _17 => _17.abort, 'call', _18 => _18()]), Math.min(TIMEOUT, deadline - Date.now()));
       let status;
       try {
         const response = await send(options.endpoint, {
@@ -172,7 +203,8 @@ function createFarmInfraAnalyticsExporter(options, send = (input, init) => fetch
           body
         });
         status = response.status;
-        void _optionalChain([response, 'access', _16 => _16.body, 'optionalAccess', _17 => _17.cancel, 'call', _18 => _18(), 'access', _19 => _19.catch, 'call', _20 => _20(() => {
+        const reason = status === 400 || status === 403 ? await refusal(response) : void 0;
+        void _optionalChain([response, 'access', _19 => _19.body, 'optionalAccess', _20 => _20.cancel, 'call', _21 => _21(), 'access', _22 => _22.catch, 'call', _23 => _23(() => {
         })]);
         if (response.ok) {
           remove(batch);
@@ -181,7 +213,7 @@ function createFarmInfraAnalyticsExporter(options, send = (input, init) => fetch
         if ([400, 401, 403, 404, 413, 415].includes(status) || status >= 300 && status < 400) {
           stopped = true;
           queue.length = 0;
-          diagnostic({ code: "disabled", status });
+          diagnostic({ code: "disabled", status, ...reason ? { reason } : {} });
           break;
         }
         if (status !== 408 && status !== 429 && status < 500) {
@@ -190,7 +222,7 @@ function createFarmInfraAnalyticsExporter(options, send = (input, init) => fetch
           continue;
         }
         notBefore = Math.max(notBefore, retryAt(response.headers.get("retry-after"), Date.now()));
-      } catch (e3) {
+      } catch (e4) {
       } finally {
         clearTimeout(timeout);
         active = void 0;
@@ -220,7 +252,7 @@ function createFarmInfraAnalyticsExporter(options, send = (input, init) => fetch
     closing = true;
     await flush();
     stopped = true;
-    _optionalChain([active, 'optionalAccess', _21 => _21.abort, 'call', _22 => _22()]);
+    _optionalChain([active, 'optionalAccess', _24 => _24.abort, 'call', _25 => _25()]);
     if (queue.length) diagnostic({ code: "dropped", count: queue.length });
     queue.length = 0;
   }
@@ -241,7 +273,7 @@ function requestEvent(metadata, method, status, durationMs) {
     id: uuid(),
     requestId: metadata.id,
     timestamp: (/* @__PURE__ */ new Date()).toISOString(),
-    route: routeTemplate(_chunkZGS3ZDF7cjs.getFarmRouteLabel.call(void 0, metadata.route)),
+    route: routeTemplate(_chunkNPPT4RWFcjs.getFarmRouteLabel.call(void 0, metadata.route)),
     agent: metadata.agent,
     kind: "request",
     method,
@@ -254,7 +286,7 @@ function toolEvent(metadata, event) {
     id: uuid(),
     requestId: metadata.id,
     timestamp: (/* @__PURE__ */ new Date()).toISOString(),
-    route: routeTemplate(_chunkZGS3ZDF7cjs.getFarmRouteLabel.call(void 0, metadata.route)),
+    route: routeTemplate(_chunkNPPT4RWFcjs.getFarmRouteLabel.call(void 0, metadata.route)),
     agent: metadata.agent,
     kind: "mcp.tool",
     tool: event.tool,
@@ -270,7 +302,7 @@ function farmInfraAnalyticsPlugin(options, send) {
     setup(context) {
       const state = { exporter: createFarmInfraAnalyticsExporter(options, send) };
       context.lifecycle.onShutdown(async () => {
-        _optionalChain([state, 'access', _23 => _23.unsubscribe, 'optionalCall', _24 => _24()]);
+        _optionalChain([state, 'access', _26 => _26.unsubscribe, 'optionalCall', _27 => _27()]);
         await state.exporter.close();
       });
       return state;
@@ -366,14 +398,25 @@ function linkedOptions(env, warn) {
   return {
     ...resolved.options,
     onDiagnostic(event) {
-      if (event.code === "disabled") {
-        warn(
-          `[Farm] Farm Infra analytics stopped: Farm Infra answered ${event.status}. Check FARMJS_API_KEY and FARMJS_PROJECT_ID, then restart the server.`
-        );
-      }
+      if (event.code !== "disabled") return;
+      if (event.reason === "environment") return;
+      warn(`[Farm] Farm Infra analytics stopped: ${stopReason(event)}`);
     }
   };
 }
+var KEYS_PAGE = "the API keys page (https://app.farmjs.dev/dashboard/settings)";
+function stopReason(event) {
+  if (event.reason === "project") {
+    return "FARMJS_API_KEY reaches more than one project. Set FARMJS_PROJECT_ID or use a key scoped to one project, then restart the server.";
+  }
+  if (event.reason === "permission") {
+    return `this key can't send analytics. Create a Site analytics key on ${KEYS_PAGE}, set it as FARMJS_API_KEY, then restart the server.`;
+  }
+  if (event.status === 401) {
+    return `Farm Infra answered 401: FARMJS_API_KEY was revoked or has expired. Create a new Site analytics key on ${KEYS_PAGE}, then restart the server.`;
+  }
+  return `Farm Infra answered ${event.status}. Check FARMJS_API_KEY and FARMJS_PROJECT_ID, then restart the server.`;
+}
 function createFarmInfraAnalyticsPlugin(env = processEnv(), warn = console.warn) {
   const options = linkedOptions(env, warn);
   return options ? farmInfraAnalyticsPlugin(options) : null;

package/dist/{chunk-N7SPZJLY.mjs → chunk-IVHPRF4W.mjs}

@@ -34,7 +34,7 @@ import {
   resolveFarmIsolatedClientHydrationMode,
   resolveModuleSourcePath,
   stripUseClientDirective
-} from "./chunk-TQWGOQ7O.mjs";
+} from "./chunk-Z3BXMMFF.mjs";
 import {
   loadTailwindVitePlugin
 } from "./chunk-XLLVWLWO.mjs";
@@ -55,7 +55,7 @@ import {
   parseFarmLayoutChainHeader,
   renderFarmLocaleAlternateLinks,
   stripRouteGroups
-} from "./chunk-NIPKC4DA.mjs";
+} from "./chunk-ZIBIE7AH.mjs";
 import {
   FARM_API_CATALOG_PATH,
   createFarmAiCatalogResponse,
@@ -70,7 +70,7 @@ import {
   resolveFarmMCPRouteLabel,
   resolveFarmMarkdownRouteLabel,
   setFarmRouteLabel
-} from "./chunk-NRFUVDTH.mjs";
+} from "./chunk-DGVVVYKD.mjs";
 import {
   FARM_DEFAULT_MCP_PATH
 } from "./chunk-KRRZJ77U.mjs";
@@ -233,7 +233,7 @@ import {
 } from "./chunk-LM2YOGDK.mjs";
 import {
   FARM_VERSION
-} from "./chunk-HRLYO2XJ.mjs";
+} from "./chunk-ACI52TCN.mjs";
 import {
   DEFAULT_FARM_API_BASE_PATH
 } from "./chunk-BLD5GVCG.mjs";
@@ -1441,7 +1441,7 @@ function farmPlugin(options = {}, initialPluginManager) {
     },
     async configureServer(viteServer) {
       if (resolveFarmPlatform() === "desktop") {
-        const { createFarmDesktopDevGuard } = await import("./dev-guard-MPZUJFIV.mjs");
+        const { createFarmDesktopDevGuard } = await import("./dev-guard-YO6KPIOQ.mjs");
         viteServer.middlewares.use(
           createFarmDesktopDevGuard(viteServer, { basePath: options.basePath || "" })
         );

package/dist/{chunk-6M3HXUBQ.mjs → chunk-J27BZO67.mjs}

@@ -8,6 +8,9 @@ import {
 import {
   loadFarmReactPlugin
 } from "./chunk-XLYXG73A.mjs";
+import {
+  resolveFarmPlatform
+} from "./chunk-LL7TDMOM.mjs";
 import {
   loadTailwindVitePlugin
 } from "./chunk-XLLVWLWO.mjs";
@@ -91,6 +94,7 @@ async function createFarmRscViteConfig(userConfig, options) {
     experimental: { ...userConfig.experimental, serverComponents: true },
     port: options.port ?? userConfig.server?.port,
     plugins: [
+      ...options.command === "serve" && resolveFarmPlatform() === "desktop" ? [farmRscDesktopDevGuardPlugin(userConfig.basePath)] : [],
       ...tailwind ? [tailwind] : [],
       ...vitePlugins,
       viteRsc.default({ serverHandler: false, entries: FARM_RSC_ENTRIES }),
@@ -116,6 +120,23 @@ async function createFarmRscViteConfig(userConfig, options) {
     mode: options.command === "build" ? "production" : "development"
   };
 }
+function farmRscDesktopDevGuardPlugin(basePath) {
+  return {
+    name: "farm:desktop-dev-guard",
+    enforce: "pre",
+    configureServer: {
+      order: "pre",
+      async handler(server) {
+        const { createFarmDesktopDevGuard } = await import("./dev-guard-YO6KPIOQ.mjs");
+        server.middlewares.use(
+          createFarmDesktopDevGuard(server, {
+            basePath: typeof basePath === "string" ? basePath : ""
+          })
+        );
+      }
+    }
+  };
+}
 async function createFarmRscDevServer(userConfig, options) {
   const { createServer } = await import("vite");
   return createServer(await createFarmRscViteConfig(userConfig, { ...options, command: "serve" }));

package/dist/{chunk-JLS6ZLFM.cjs → chunk-J5VCA45K.cjs}

@@ -1,5 +1,5 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true});// package.json
-var version = "0.1.48";
+var version = "0.1.49";
 
 // src/version.ts
 var FARM_VERSION = version;

package/dist/{chunk-ZGS3ZDF7.cjs → chunk-NPPT4RWF.cjs}

@@ -23,7 +23,7 @@ var _chunk5566GNEGcjs = require('./chunk-5566GNEG.cjs');
 var _chunkB5BBTPJQcjs = require('./chunk-B5BBTPJQ.cjs');
 
 
-var _chunkJLS6ZLFMcjs = require('./chunk-JLS6ZLFM.cjs');
+var _chunkJ5VCA45Kcjs = require('./chunk-J5VCA45K.cjs');
 
 
 var _chunkD22BUQKWcjs = require('./chunk-D22BUQKW.cjs');
@@ -282,7 +282,7 @@ function createFarmAppManifest(input) {
   return {
     schemaVersion: 1,
     app: app ? {
-      ...app.version ? { farm: _chunkJLS6ZLFMcjs.FARM_VERSION } : {},
+      ...app.version ? { farm: _chunkJ5VCA45Kcjs.FARM_VERSION } : {},
       ...app.renderer ? { renderer: input.renderer } : {},
       basePath: input.basePath,
       ...app.build ? { build: input.build } : {}

package/dist/{chunk-TFA6BUAE.cjs → chunk-OY5XDG24.cjs}

@@ -56,8 +56,8 @@ function createFarmDesktopGuard(options) {
   if (options.secret === options.handshakeToken) {
     throw new TypeError("[Farm] The desktop secret and handshake token must be different values.");
   }
-  const { secret } = options;
-  let handshakeToken = options.handshakeToken;
+  const { secret, handshakeToken } = options;
+  const handshakeState = _nullishCoalesce(options.handshakeState, () => ( {}));
   const basePath = normalizeBasePath(options.basePath);
   const handshakePath = `${basePath}${FARM_DESKTOP_HANDSHAKE_PATH}`;
   const home = `${basePath}/`;
@@ -81,10 +81,10 @@ function createFarmDesktopGuard(options) {
     if (pathname === handshakePath) {
       if (method !== "GET") return forbidden("handshake must be a GET");
       const token = _nullishCoalesce(new URLSearchParams(search).get(FARM_DESKTOP_HANDSHAKE_PARAM), () => ( ""));
-      if (handshakeToken === void 0 || !_chunkSHIWRBFIcjs.farmSecretsMatch.call(void 0, token, handshakeToken)) {
+      if (handshakeState.handshakeUsed || !_chunkSHIWRBFIcjs.farmSecretsMatch.call(void 0, token, handshakeToken)) {
         return forbidden("invalid or used handshake token");
       }
-      handshakeToken = void 0;
+      handshakeState.handshakeUsed = true;
       return new Response(null, {
         status: 303,
         headers: {

package/dist/{chunk-N6SIQJEJ.mjs → chunk-RYDDUCNJ.mjs}

@@ -1,6 +1,6 @@
 import {
   getFarmRouteLabel
-} from "./chunk-NRFUVDTH.mjs";
+} from "./chunk-DGVVVYKD.mjs";
 import {
   classifyFarmAgent
 } from "./chunk-N77JBPLC.mjs";
@@ -45,13 +45,12 @@ function resolveFarmInfraAnalytics(env = processEnv()) {
   if (!key || env[FARM_PRERENDER_ENV] === "1") return { off: null };
   const ingestionKey = INGESTION_KEY.test(key);
   const projectId = env.FARMJS_PROJECT_ID?.trim() || void 0;
-  if (!ingestionKey && !projectId) return { off: null };
   if (!ingestionKey && !API_KEY.test(key)) {
     return {
       off: "FARMJS_API_KEY isn't a Farm Infra API key (farmjs_\u2026) or write-only key (fti_\u2026)"
     };
   }
-  if (!ingestionKey && !PROJECT.test(projectId)) {
+  if (!ingestionKey && projectId && !PROJECT.test(projectId)) {
     return { off: "FARMJS_PROJECT_ID isn't a Farm Infra project ID (proj_\u2026)" };
   }
   if (env.FARMJS_ENVIRONMENT && !ENVIRONMENTS.includes(env.FARMJS_ENVIRONMENT)) {
@@ -71,7 +70,7 @@ function resolveFarmInfraAnalytics(env = processEnv()) {
     options: {
       endpoint: endpoint.href,
       key,
-      ...ingestionKey ? {} : { projectId, environment: defaultFarmInfraEnvironment(env) }
+      ...ingestionKey ? {} : { ...projectId ? { projectId } : {}, environment: defaultFarmInfraEnvironment(env) }
     }
   };
 }
@@ -95,13 +94,45 @@ function retryAt(value, now) {
   const date = Date.parse(value);
   return Number.isFinite(date) ? Math.max(now, Math.min(date, now + 864e5)) : now;
 }
+var REFUSALS = {
+  project: "project",
+  api_key_permission: "permission",
+  api_key_environment: "environment"
+};
+async function refusal(response) {
+  const reader = response.body?.getReader();
+  if (!reader) return void 0;
+  let text = "";
+  const decoder = new TextDecoder();
+  const deadline = Date.now() + 500;
+  try {
+    while (text.length < 1024 && Date.now() < deadline) {
+      let timer;
+      const chunk = await Promise.race([
+        reader.read(),
+        new Promise((resolve) => {
+          timer = setTimeout(() => resolve({ done: true }), deadline - Date.now());
+        })
+      ]).finally(() => clearTimeout(timer));
+      if (chunk.done) break;
+      text += decoder.decode(chunk.value, { stream: true });
+    }
+    const code = JSON.parse(text).error;
+    return typeof code === "string" && Object.prototype.hasOwnProperty.call(REFUSALS, code) ? REFUSALS[code] : void 0;
+  } catch {
+    return void 0;
+  } finally {
+    void reader.cancel().catch(() => {
+    });
+  }
+}
 function createFarmInfraAnalyticsExporter(options, send = (input, init) => fetch(input, init)) {
   const requestHeaders = {
     "content-type": "application/json",
     authorization: `Bearer ${options.key}`
   };
   if (!INGESTION_KEY.test(options.key)) {
-    requestHeaders["x-farm-project"] = options.projectId;
+    if (options.projectId) requestHeaders["x-farm-project"] = options.projectId;
     requestHeaders["x-farm-environment"] = options.environment ?? defaultFarmInfraEnvironment();
   }
   const queue = [];
@@ -172,6 +203,7 @@ function createFarmInfraAnalyticsExporter(options, send = (input, init) => fetch
           body
         });
         status = response.status;
+        const reason = status === 400 || status === 403 ? await refusal(response) : void 0;
         void response.body?.cancel().catch(() => {
         });
         if (response.ok) {
@@ -181,7 +213,7 @@ function createFarmInfraAnalyticsExporter(options, send = (input, init) => fetch
         if ([400, 401, 403, 404, 413, 415].includes(status) || status >= 300 && status < 400) {
           stopped = true;
           queue.length = 0;
-          diagnostic({ code: "disabled", status });
+          diagnostic({ code: "disabled", status, ...reason ? { reason } : {} });
           break;
         }
         if (status !== 408 && status !== 429 && status < 500) {
@@ -366,14 +398,25 @@ function linkedOptions(env, warn) {
   return {
     ...resolved.options,
     onDiagnostic(event) {
-      if (event.code === "disabled") {
-        warn(
-          `[Farm] Farm Infra analytics stopped: Farm Infra answered ${event.status}. Check FARMJS_API_KEY and FARMJS_PROJECT_ID, then restart the server.`
-        );
-      }
+      if (event.code !== "disabled") return;
+      if (event.reason === "environment") return;
+      warn(`[Farm] Farm Infra analytics stopped: ${stopReason(event)}`);
     }
   };
 }
+var KEYS_PAGE = "the API keys page (https://app.farmjs.dev/dashboard/settings)";
+function stopReason(event) {
+  if (event.reason === "project") {
+    return "FARMJS_API_KEY reaches more than one project. Set FARMJS_PROJECT_ID or use a key scoped to one project, then restart the server.";
+  }
+  if (event.reason === "permission") {
+    return `this key can't send analytics. Create a Site analytics key on ${KEYS_PAGE}, set it as FARMJS_API_KEY, then restart the server.`;
+  }
+  if (event.status === 401) {
+    return `Farm Infra answered 401: FARMJS_API_KEY was revoked or has expired. Create a new Site analytics key on ${KEYS_PAGE}, then restart the server.`;
+  }
+  return `Farm Infra answered ${event.status}. Check FARMJS_API_KEY and FARMJS_PROJECT_ID, then restart the server.`;
+}
 function createFarmInfraAnalyticsPlugin(env = processEnv(), warn = console.warn) {
   const options = linkedOptions(env, warn);
   return options ? farmInfraAnalyticsPlugin(options) : null;

package/dist/{chunk-C2R5RVLA.cjs → chunk-VCKGOXFI.cjs}

@@ -300,6 +300,76 @@ function composeFarmFullDocument(documentHtml, assets) {
   return /^\s*<!doctype/i.test(html) ? html : `<!DOCTYPE html>
 ${html}`;
 }
+var STREAMED_BODY_MARK = "<!--farm-streamed-body-->";
+function openFarmStreamedDocument(opening, assets) {
+  const { hoisted } = peelDocumentPrefix(opening);
+  const start = opening.search(/<!doctype|<html[\s>]/i);
+  const document = restoreHoistedHead(opening.slice(Math.max(start, 0)), hoisted);
+  const rootOpened = !/<body\b[^>]*>\s*<div\b[^>]*\sid=["']root["']/i.test(document);
+  const composed = composeFarmFullDocument(
+    `${document}${STREAMED_BODY_MARK}</body></html>`,
+    assets
+  );
+  return { html: composed.slice(0, composed.indexOf(STREAMED_BODY_MARK)), rootOpened };
+}
+function createFarmStreamedDocumentTransform(open, fragmentShell) {
+  let opening = "";
+  let mode = "pending";
+  let opened = false;
+  let closed = false;
+  let rootOpened = false;
+  const write = (text) => {
+    if (mode === "fragment") return text;
+    if (!opened) {
+      opening += text;
+      if (mode === "pending") {
+        const prefix = classifyFarmDocumentPrefix(opening);
+        if (prefix === "pending") return "";
+        if (prefix === "fragment") {
+          mode = "fragment";
+          const held = opening;
+          opening = "";
+          return fragmentShell + held;
+        }
+        mode = "document";
+      }
+      if (!/<body\b[^>]*>/i.test(opening)) return "";
+      opened = true;
+      text = opening;
+      opening = "";
+      const closeAt = text.search(/<\/body>/i);
+      const head = closeAt >= 0 ? text.slice(0, closeAt) : text;
+      const document = open(head);
+      rootOpened = document.rootOpened;
+      text = document.html + (closeAt >= 0 ? text.slice(closeAt) : "");
+    }
+    if (!closed) {
+      const closeAt = text.search(/<\/body>/i);
+      if (closeAt >= 0) {
+        closed = true;
+        text = text.slice(0, closeAt) + text.slice(closeAt).replace(/^<\/body>\s*(?:<\/html>)?(?:\s*<\/div>)*/i, "");
+      }
+    }
+    return text;
+  };
+  return {
+    write,
+    end() {
+      if (mode === "pending") {
+        mode = "fragment";
+        const held2 = opening;
+        opening = "";
+        return { text: fragmentShell + held2, document: false, rootOpened: false };
+      }
+      if (mode === "fragment") return { text: "", document: false, rootOpened: false };
+      if (opened) return { text: "", document: true, rootOpened };
+      const held = opening;
+      opening = "";
+      const text = write(`${held}<body>`);
+      return { text, document: true, rootOpened };
+    }
+  };
+}
 
 // src/middleware/may-handle.ts
 function hasFarmMiddlewareConfig(config) {
@@ -797,4 +867,6 @@ function serializeInlineValue(value) {
 
 
 
-exports.formatRouteSegment = formatRouteSegment; exports.createRouteDirectoryPattern = createRouteDirectoryPattern; exports.stripRouteGroups = stripRouteGroups; exports.getRouteGroupScope = getRouteGroupScope; exports.isInRouteGroupScope = isInRouteGroupScope; exports.getRouteDirectoryDepth = getRouteDirectoryDepth; exports.routeBoundaryCoversDirectory = routeBoundaryCoversDirectory; exports.createFarmLayoutSelector = createFarmLayoutSelector; exports.layoutsCanCoverSamePage = layoutsCanCoverSamePage; exports.getFarmServerTreeLayoutPatterns = getFarmServerTreeLayoutPatterns; exports.createFarmRouteRenderPlan = createFarmRouteRenderPlan; exports.getFarmFragmentCacheControl = getFarmFragmentCacheControl; exports.parseFarmLayoutChainHeader = parseFarmLayoutChainHeader; exports.getSharedLayoutPrefixLength = getSharedLayoutPrefixLength; exports.HOISTED_HEAD_ELEMENT = HOISTED_HEAD_ELEMENT; exports.extractFarmFullDocument = extractFarmFullDocument; exports.classifyFarmDocumentPrefix = classifyFarmDocumentPrefix; exports.removeFarmDocumentTitles = removeFarmDocumentTitles; exports.ensureFarmDocumentMeta = ensureFarmDocumentMeta; exports.composeFarmFullDocument = composeFarmFullDocument; exports.hasFarmMiddlewareConfig = hasFarmMiddlewareConfig; exports.configMiddlewareMayHandlePath = configMiddlewareMayHandlePath; exports.appMiddlewareMayHandlePath = appMiddlewareMayHandlePath; exports.farmPathGuardCoversPage = farmPathGuardCoversPage; exports.farmPathGuardCoversEndpoint = farmPathGuardCoversEndpoint; exports.renderFarmLocaleAlternateLinks = renderFarmLocaleAlternateLinks; exports.createLateRedirectRecovery = createLateRedirectRecovery; exports.createLateNotFoundRecovery = createLateNotFoundRecovery; exports.createFarmMetadataRouteResponse = createFarmMetadataRouteResponse; exports.resolveDefaultErrorStatus = resolveDefaultErrorStatus; exports.getDefaultErrorStatusText = getDefaultErrorStatusText; exports.createDefaultErrorMarkup = createDefaultErrorMarkup; exports.createFarmThemeDocumentParts = createFarmThemeDocumentParts; exports.applyFarmThemeDocument = applyFarmThemeDocument;
+
+
+exports.formatRouteSegment = formatRouteSegment; exports.createRouteDirectoryPattern = createRouteDirectoryPattern; exports.stripRouteGroups = stripRouteGroups; exports.getRouteGroupScope = getRouteGroupScope; exports.isInRouteGroupScope = isInRouteGroupScope; exports.getRouteDirectoryDepth = getRouteDirectoryDepth; exports.routeBoundaryCoversDirectory = routeBoundaryCoversDirectory; exports.createFarmLayoutSelector = createFarmLayoutSelector; exports.layoutsCanCoverSamePage = layoutsCanCoverSamePage; exports.getFarmServerTreeLayoutPatterns = getFarmServerTreeLayoutPatterns; exports.createFarmRouteRenderPlan = createFarmRouteRenderPlan; exports.getFarmFragmentCacheControl = getFarmFragmentCacheControl; exports.parseFarmLayoutChainHeader = parseFarmLayoutChainHeader; exports.getSharedLayoutPrefixLength = getSharedLayoutPrefixLength; exports.HOISTED_HEAD_ELEMENT = HOISTED_HEAD_ELEMENT; exports.extractFarmFullDocument = extractFarmFullDocument; exports.classifyFarmDocumentPrefix = classifyFarmDocumentPrefix; exports.removeFarmDocumentTitles = removeFarmDocumentTitles; exports.ensureFarmDocumentMeta = ensureFarmDocumentMeta; exports.composeFarmFullDocument = composeFarmFullDocument; exports.openFarmStreamedDocument = openFarmStreamedDocument; exports.createFarmStreamedDocumentTransform = createFarmStreamedDocumentTransform; exports.hasFarmMiddlewareConfig = hasFarmMiddlewareConfig; exports.configMiddlewareMayHandlePath = configMiddlewareMayHandlePath; exports.appMiddlewareMayHandlePath = appMiddlewareMayHandlePath; exports.farmPathGuardCoversPage = farmPathGuardCoversPage; exports.farmPathGuardCoversEndpoint = farmPathGuardCoversEndpoint; exports.renderFarmLocaleAlternateLinks = renderFarmLocaleAlternateLinks; exports.createLateRedirectRecovery = createLateRedirectRecovery; exports.createLateNotFoundRecovery = createLateNotFoundRecovery; exports.createFarmMetadataRouteResponse = createFarmMetadataRouteResponse; exports.resolveDefaultErrorStatus = resolveDefaultErrorStatus; exports.getDefaultErrorStatusText = getDefaultErrorStatusText; exports.createDefaultErrorMarkup = createDefaultErrorMarkup; exports.createFarmThemeDocumentParts = createFarmThemeDocumentParts; exports.applyFarmThemeDocument = applyFarmThemeDocument;