@farm.js/core 0.1.48 → 0.1.50

package/dist/{chunk-A7DK663W.cjs → chunk-FACTMUPI.cjs}

@@ -9,7 +9,7 @@ var _chunkKBGZ5FD6cjs = require('./chunk-KBGZ5FD6.cjs');
 var _chunkP2355C6Ecjs = require('./chunk-P2355C6E.cjs');
 
 
-var _chunkEXHEPWFJcjs = require('./chunk-EXHEPWFJ.cjs');
+var _chunkYAXOEANDcjs = require('./chunk-YAXOEAND.cjs');
 
 
 var _chunkJZMZKABScjs = require('./chunk-JZMZKABS.cjs');
@@ -23,7 +23,7 @@ var _chunkSBDWCDS6cjs = require('./chunk-SBDWCDS6.cjs');
 
 
 
-var _chunkR2SEZEBCcjs = require('./chunk-R2SEZEBC.cjs');
+var _chunkOYNNA4DDcjs = require('./chunk-OYNNA4DD.cjs');
 
 
 var _chunkE7QOEV5Zcjs = require('./chunk-E7QOEV5Z.cjs');
@@ -32,7 +32,7 @@ var _chunkE7QOEV5Zcjs = require('./chunk-E7QOEV5Z.cjs');
 var _chunkY3WG64CPcjs = require('./chunk-Y3WG64CP.cjs');
 
 
-var _chunk6XFGJBYXcjs = require('./chunk-6XFGJBYX.cjs');
+var _chunkJYNNIGQOcjs = require('./chunk-JYNNIGQO.cjs');
 
 
 
@@ -44,7 +44,7 @@ var _chunkZ5MZDFX4cjs = require('./chunk-Z5MZDFX4.cjs');
 
 
 
-var _chunk5566GNEGcjs = require('./chunk-5566GNEG.cjs');
+var _chunkLIFUPCXWcjs = require('./chunk-LIFUPCXW.cjs');
 
 
 var _chunkHNAISJFDcjs = require('./chunk-HNAISJFD.cjs');
@@ -60,7 +60,7 @@ function farmApiPlugin(options = {}) {
   const srcDir = _nullishCoalesce(options.srcDir, () => ( "src"));
   const apiDirFromRoot = _nullishCoalesce(options.apiDir, () => ( _path2.default.join(srcDir, "api")));
   const debug = _nullishCoalesce(options.debug, () => ( false));
-  const bodySizeLimit = _chunk5566GNEGcjs.resolveFarmServerConfig.call(void 0, {
+  const bodySizeLimit = _chunkLIFUPCXWcjs.resolveFarmServerConfig.call(void 0, {
     bodySizeLimit: options.bodySizeLimit
   }).bodySizeLimit;
   const basePath = options.basePath;
@@ -113,7 +113,7 @@ function farmApiPlugin(options = {}) {
     const existing = apiRoutesCache.get(routePath);
     const existingFile = _optionalChain([endpointSources, 'access', _ => _.get, 'call', _2 => _2(routePath), 'optionalAccess', _3 => _3.get, 'call', _4 => _4(normalizedMethod)]);
     if (existingFile) {
-      throw new (0, _chunkEXHEPWFJcjs.APIRouteConflictError)(routePath, normalizedMethod, existingFile, filePath);
+      throw new (0, _chunkYAXOEANDcjs.APIRouteConflictError)(routePath, normalizedMethod, existingFile, filePath);
     }
     if (existing) {
       if (!existing.methods.includes(normalizedMethod)) {
@@ -189,7 +189,7 @@ function farmApiPlugin(options = {}) {
   const createRouter = async () => {
     const plugins = options.plugins ? await (_nullishCoalesce(routePlugins, () => ( (routePlugins = Promise.resolve(options.plugins({ root: projectRoot })))))) : [];
     pluginMergedRoutes = plugins.length ? new Map(
-      _chunkR2SEZEBCcjs.mergePluginAPIRoutes.call(void 0, [...apiRoutesCache.values()], plugins, void 0, {
+      _chunkOYNNA4DDcjs.mergePluginAPIRoutes.call(void 0, [...apiRoutesCache.values()], plugins, void 0, {
         bodySizeLimit,
         // A plugin calling an app endpoint (an MCP tool, say) goes back through this server,
         // so the middleware that guards the endpoint's path runs for it.
@@ -209,7 +209,7 @@ function farmApiPlugin(options = {}) {
         const url = new URL(request.url);
         const method = request.method.toUpperCase();
         const pathname = url.pathname;
-        const match = _chunkR2SEZEBCcjs.matchAPIRouteAtBasePath.call(void 0, servedRoutes(), pathname, basePath);
+        const match = _chunkOYNNA4DDcjs.matchAPIRouteAtBasePath.call(void 0, servedRoutes(), pathname, basePath);
         if (!match) {
           return new Response(JSON.stringify({ error: "Not Found" }), {
             status: 404,
@@ -217,18 +217,18 @@ function farmApiPlugin(options = {}) {
           });
         }
         const { route, params } = match;
-        const endpoint = _chunkR2SEZEBCcjs.resolveAPIRouteEndpoint.call(void 0, route, method);
+        const endpoint = _chunkOYNNA4DDcjs.resolveAPIRouteEndpoint.call(void 0, route, method);
         if (!endpoint) {
           return new Response(JSON.stringify({ error: "Method Not Allowed" }), {
             status: 405,
             headers: {
-              Allow: _chunkR2SEZEBCcjs.getAllowedAPIRouteMethods.call(void 0, route).join(", "),
+              Allow: _chunkOYNNA4DDcjs.getAllowedAPIRouteMethods.call(void 0, route).join(", "),
               "Content-Type": "application/json"
             }
           });
         }
         try {
-          return await _chunkR2SEZEBCcjs.invokeAPIRouteEndpoint.call(void 0, endpoint, request, params, bodySizeLimit);
+          return await _chunkOYNNA4DDcjs.invokeAPIRouteEndpoint.call(void 0, endpoint, request, params, bodySizeLimit);
         } catch (error) {
           return new Response(JSON.stringify({ error: error.message || "Internal Server Error" }), {
             status: 500,
@@ -274,10 +274,10 @@ function farmApiPlugin(options = {}) {
           try {
             const relativePath = path.relative(apiDir, path.dirname(filePath));
             const routePath = "/api/" + (relativePath === "." ? "" : relativePath.replace(/\\/g, "/"));
-            const routeModule = await _chunk6XFGJBYXcjs.loadFarmDevModule.call(void 0, server, filePath);
+            const routeModule = await _chunkJYNNIGQOcjs.loadFarmDevModule.call(void 0, server, filePath);
             const endpoints = {};
             const availableMethods = [];
-            for (const method of _chunkR2SEZEBCcjs.API_ROUTE_METHODS) {
+            for (const method of _chunkOYNNA4DDcjs.API_ROUTE_METHODS) {
               if (routeModule[method]) {
                 availableMethods.push(method);
                 endpoints[method] = routeModule[method];
@@ -290,7 +290,7 @@ function farmApiPlugin(options = {}) {
               log(`API route discovered: ${availableMethods.join(", ")} ${routePath}`);
             }
           } catch (e) {
-            if (e instanceof _chunkEXHEPWFJcjs.APIRouteConflictError || e instanceof _chunkYTVSWXEZcjs.AmbiguousRouteError) throw e;
+            if (e instanceof _chunkYAXOEANDcjs.APIRouteConflictError || e instanceof _chunkYTVSWXEZcjs.AmbiguousRouteError) throw e;
             log(`API route load failed at ${filePath}: ${e.message}`);
           }
         }
@@ -306,7 +306,7 @@ function farmApiPlugin(options = {}) {
         for (const routesFile of routesFiles) {
           if (fs.existsSync(routesFile)) {
             try {
-              const routesModule = await _chunk6XFGJBYXcjs.loadFarmDevModule.call(void 0, server, routesFile);
+              const routesModule = await _chunkJYNNIGQOcjs.loadFarmDevModule.call(void 0, server, routesFile);
               for (const [exportName, exportValue] of Object.entries(routesModule)) {
                 const endpoint = exportValue;
                 if (endpoint && endpoint.__path) {
@@ -317,7 +317,7 @@ function farmApiPlugin(options = {}) {
                 }
               }
             } catch (e) {
-              if (e instanceof _chunkEXHEPWFJcjs.APIRouteConflictError || e instanceof _chunkYTVSWXEZcjs.AmbiguousRouteError) throw e;
+              if (e instanceof _chunkYAXOEANDcjs.APIRouteConflictError || e instanceof _chunkYTVSWXEZcjs.AmbiguousRouteError) throw e;
               log(`Root routes.ts load failed: ${e.message}`);
             }
             break;
@@ -332,7 +332,7 @@ function farmApiPlugin(options = {}) {
         const { getProgrammaticRouteManifest } = await import("./routes.cjs");
         for (const routeFile of routeFiles) {
           try {
-            const routesModule = await _chunk6XFGJBYXcjs.loadFarmDevModule.call(void 0, 
+            const routesModule = await _chunkJYNNIGQOcjs.loadFarmDevModule.call(void 0, 
               server,
               _chunkXN2MB4QZcjs.toViteModuleId.call(void 0, routeFile, server.config.root)
             );
@@ -348,7 +348,7 @@ function farmApiPlugin(options = {}) {
               }
             }
           } catch (e) {
-            if (e instanceof _chunkEXHEPWFJcjs.APIRouteConflictError || e instanceof _chunkYTVSWXEZcjs.AmbiguousRouteError) throw e;
+            if (e instanceof _chunkYAXOEANDcjs.APIRouteConflictError || e instanceof _chunkYTVSWXEZcjs.AmbiguousRouteError) throw e;
             log(`Programmatic routes file load failed at ${routeFile}: ${e.message}`);
           }
         }
@@ -400,7 +400,7 @@ function farmApiPlugin(options = {}) {
           const pathname = url.split("?")[0];
           const method = req.method || "GET";
           if (discoveryPromise) await waitForDiscovery();
-          if (!_chunkR2SEZEBCcjs.matchAPIRouteAtBasePath.call(void 0, servedRoutes(), pathname, basePath)) {
+          if (!_chunkOYNNA4DDcjs.matchAPIRouteAtBasePath.call(void 0, servedRoutes(), pathname, basePath)) {
             return next();
           }
           if (!apiRouterHandler) {
@@ -421,7 +421,7 @@ function farmApiPlugin(options = {}) {
             }
             const currentUrl = req.url || url;
             const currentPathname = currentUrl.split("?")[0];
-            if (currentPathname !== pathname && !_chunkR2SEZEBCcjs.matchAPIRouteAtBasePath.call(void 0, servedRoutes(), currentPathname, basePath)) {
+            if (currentPathname !== pathname && !_chunkOYNNA4DDcjs.matchAPIRouteAtBasePath.call(void 0, servedRoutes(), currentPathname, basePath)) {
               return next();
             }
             const fullUrl = _chunkHNAISJFDcjs.resolveFarmRequestURL.call(void 0, req);
@@ -433,7 +433,7 @@ function farmApiPlugin(options = {}) {
             }
             let body;
             if (method !== "GET" && method !== "HEAD") {
-              body = await _chunk5566GNEGcjs.readNodeRequestBody.call(void 0, req, bodySizeLimit);
+              body = await _chunkLIFUPCXWcjs.readNodeRequestBody.call(void 0, req, bodySizeLimit);
             }
             const request = new Request(fullUrl, {
               method,
@@ -448,7 +448,7 @@ function farmApiPlugin(options = {}) {
             logResponse(method, currentPathname, response.status, duration);
             await _chunkZ5MZDFX4cjs.sendWebResponse.call(void 0, res, response);
           } catch (error) {
-            const bodyErrorResponse = _chunk5566GNEGcjs.createFarmRequestBodyErrorResponse.call(void 0, error);
+            const bodyErrorResponse = _chunkLIFUPCXWcjs.createFarmRequestBodyErrorResponse.call(void 0, error);
             if (bodyErrorResponse) {
               await _chunkZ5MZDFX4cjs.sendWebResponse.call(void 0, res, bodyErrorResponse);
               return;
@@ -497,7 +497,7 @@ function farmApiPlugin(options = {}) {
         if (await _optionalChain([recoverFailedDiscovery, 'optionalCall', _9 => _9()])) return [];
         const previousState = snapshotRouteState();
         try {
-          const routesModule = await _chunk6XFGJBYXcjs.loadFarmDevModule.call(void 0, server, file);
+          const routesModule = await _chunkJYNNIGQOcjs.loadFarmDevModule.call(void 0, server, file);
           removeEndpointsFromFile(file);
           for (const [exportName, exportValue] of Object.entries(routesModule)) {
             const endpoint = exportValue;
@@ -525,7 +525,7 @@ function farmApiPlugin(options = {}) {
           log(`API router recreated`);
         } catch (e) {
           restoreRouteState(previousState);
-          if (e instanceof _chunkEXHEPWFJcjs.APIRouteConflictError || e instanceof _chunkYTVSWXEZcjs.AmbiguousRouteError) throw e;
+          if (e instanceof _chunkYAXOEANDcjs.APIRouteConflictError || e instanceof _chunkYTVSWXEZcjs.AmbiguousRouteError) throw e;
           log(`Root routes.ts HMR failed: ${e.message}`);
         }
         return [];
@@ -550,10 +550,10 @@ function farmApiPlugin(options = {}) {
             log(`API route file removed: ${routePath}`);
             return [];
           }
-          const routeModule = await _chunk6XFGJBYXcjs.loadFarmDevModule.call(void 0, server, file);
+          const routeModule = await _chunkJYNNIGQOcjs.loadFarmDevModule.call(void 0, server, file);
           removeEndpointsFromFile(file);
           const availableMethods = [];
-          for (const method of _chunkR2SEZEBCcjs.API_ROUTE_METHODS) {
+          for (const method of _chunkOYNNA4DDcjs.API_ROUTE_METHODS) {
             if (!routeModule[method]) continue;
             availableMethods.push(method);
             addEndpoint(routePath, file, method, routeModule[method]);
@@ -563,7 +563,7 @@ function farmApiPlugin(options = {}) {
           log(`API router recreated`);
         } catch (e) {
           restoreRouteState(previousState);
-          if (e instanceof _chunkEXHEPWFJcjs.APIRouteConflictError || e instanceof _chunkYTVSWXEZcjs.AmbiguousRouteError) throw e;
+          if (e instanceof _chunkYAXOEANDcjs.APIRouteConflictError || e instanceof _chunkYTVSWXEZcjs.AmbiguousRouteError) throw e;
           log(`API route HMR failed: ${e.message}`);
         }
         return [];

package/dist/chunk-G2KTRMWA.mjs

@@ -0,0 +1,40 @@
+// src/client/hash-target.ts
+function getHashTargetElement(hash) {
+  const fragment = hash.startsWith("#") ? hash.slice(1) : hash;
+  if (!fragment) return null;
+  let decoded = fragment;
+  try {
+    decoded = decodeURIComponent(fragment);
+  } catch {
+  }
+  return document.getElementById(decoded) || document.getElementById(fragment) || document.getElementsByName(decoded)[0] || null;
+}
+
+// src/client/navigation-delegate.ts
+var DELEGATES = /* @__PURE__ */ Symbol.for("farm.navigation.delegates");
+function delegateNavigation(delegate) {
+  const host = globalThis;
+  const delegates = host[DELEGATES] ?? (host[DELEGATES] = /* @__PURE__ */ new Set());
+  delegates.add(delegate);
+  return () => {
+    delegates.delete(delegate);
+  };
+}
+async function runFarmNavigationDelegates(context) {
+  const delegates = globalThis[DELEGATES];
+  if (!delegates?.size) return false;
+  for (const delegate of delegates) {
+    try {
+      if (await delegate(context) === true) return true;
+    } catch (error) {
+      console.error("[Farm.js] A navigation delegate failed; navigating in place.", error);
+    }
+  }
+  return false;
+}
+
+export {
+  getHashTargetElement,
+  delegateNavigation,
+  runFarmNavigationDelegates
+};

package/dist/{chunk-C6U66WWF.mjs → chunk-GFT5AHAT.mjs}

@@ -297,7 +297,20 @@ async function readFarmRequestBody(request, limit) {
   }
   return body;
 }
+var nodeRequestBodies = /* @__PURE__ */ new WeakMap();
 async function readNodeRequestBody(request, limit) {
+  let body = nodeRequestBodies.get(request);
+  if (!body) {
+    body = readNodeRequestBodyOnce(request, limit);
+    nodeRequestBodies.set(request, body);
+  }
+  const bytes = await body;
+  if (bytes.byteLength > limit) {
+    throw new FarmRequestBodyError("BODY_TOO_LARGE", 413, "Request body is too large");
+  }
+  return bytes;
+}
+async function readNodeRequestBodyOnce(request, limit) {
   const rawContentLength = request.headers["content-length"];
   const contentLength = Array.isArray(rawContentLength) ? rawContentLength[0] : rawContentLength;
   try {

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

@@ -16,14 +16,14 @@ var _chunk6ONBZGVHcjs = require('./chunk-6ONBZGVH.cjs');
 
 
 
-var _chunk5566GNEGcjs = require('./chunk-5566GNEG.cjs');
+var _chunkLIFUPCXWcjs = require('./chunk-LIFUPCXW.cjs');
 
 
 
 var _chunkB5BBTPJQcjs = require('./chunk-B5BBTPJQ.cjs');
 
 
-var _chunkJLS6ZLFMcjs = require('./chunk-JLS6ZLFM.cjs');
+var _chunkRHOR2J6Vcjs = require('./chunk-RHOR2J6V.cjs');
 
 
 var _chunkD22BUQKWcjs = require('./chunk-D22BUQKW.cjs');
@@ -147,7 +147,7 @@ function createFarmAiCatalogResponse(request, input = {}, requestUrl) {
   const body = JSON.stringify(
     card ? card.card : { specVersion: "1.0", entries: servers.map(({ entry }) => entry) }
   );
-  const etag = _chunk5566GNEGcjs.createFarmWeakETag.call(void 0, body);
+  const etag = _chunkLIFUPCXWcjs.createFarmWeakETag.call(void 0, body);
   const headers = {
     ...corsHeaders(),
     "Content-Type": card ? `${SERVER_CARD_TYPE}; charset=utf-8` : ard ? "application/json; charset=utf-8" : `${AI_CATALOG_TYPE}; charset=utf-8`,
@@ -156,7 +156,7 @@ function createFarmAiCatalogResponse(request, input = {}, requestUrl) {
     ETag: etag,
     "X-Content-Type-Options": "nosniff"
   };
-  if (_chunk5566GNEGcjs.matchesFarmIfNoneMatch.call(void 0, request.headers.get("if-none-match"), etag)) {
+  if (_chunkLIFUPCXWcjs.matchesFarmIfNoneMatch.call(void 0, request.headers.get("if-none-match"), etag)) {
     return new Response(null, { status: 304, headers });
   }
   _chunkWJFFPXCVcjs.emitFarmAgentRead.call(void 0, request, card ? "mcp-server-card" : "ai-catalog", 200);
@@ -282,7 +282,7 @@ function createFarmAppManifest(input) {
   return {
     schemaVersion: 1,
     app: app ? {
-      ...app.version ? { farm: _chunkJLS6ZLFMcjs.FARM_VERSION } : {},
+      ...app.version ? { farm: _chunkRHOR2J6Vcjs.FARM_VERSION } : {},
       ...app.renderer ? { renderer: input.renderer } : {},
       basePath: input.basePath,
       ...app.build ? { build: input.build } : {}
@@ -377,7 +377,7 @@ async function createFarmAppManifestResponse(request, input) {
     });
   }
   const body = JSON.stringify(createFarmAppManifest(input));
-  const etag = _chunk5566GNEGcjs.createFarmWeakETag.call(void 0, body);
+  const etag = _chunkLIFUPCXWcjs.createFarmWeakETag.call(void 0, body);
   const headers = {
     ...CORS_HEADERS,
     "content-type": "application/json; charset=utf-8",
@@ -385,7 +385,7 @@ async function createFarmAppManifestResponse(request, input) {
     etag,
     "x-content-type-options": "nosniff"
   };
-  if (_chunk5566GNEGcjs.matchesFarmIfNoneMatch.call(void 0, request.headers.get("if-none-match"), etag)) {
+  if (_chunkLIFUPCXWcjs.matchesFarmIfNoneMatch.call(void 0, request.headers.get("if-none-match"), etag)) {
     return new Response(null, { status: 304, headers });
   }
   return new Response(method === "HEAD" ? null : body, { status: 200, headers });

package/dist/{chunk-NW2BKDVT.mjs → chunk-HHFMECFO.mjs}

@@ -26,7 +26,7 @@ import {
   readNodeRequestBody,
   resolveFarmServerConfig,
   withFarmRequestClientAddress
-} from "./chunk-C6U66WWF.mjs";
+} from "./chunk-GFT5AHAT.mjs";
 import {
   clearRequestContext,
   deleteRequestContext,

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

@@ -2,15 +2,22 @@ import {
   FARM_RSC_INSTALL_HINT,
   findFarmAppPackageDir
 } from "./chunk-PXEXOQ5R.mjs";
+import {
+  createFarmDevLoopbackPlugin
+} from "./chunk-2GLQSIZD.mjs";
 import {
   resolveDeployOutputPath
-} from "./chunk-VJXLUTBM.mjs";
+} from "./chunk-2DEPNLXK.mjs";
 import {
+  farmDesktopDevGuardPlugin,
   loadFarmReactPlugin
-} from "./chunk-XLYXG73A.mjs";
+} from "./chunk-75WWOZ5C.mjs";
 import {
   loadTailwindVitePlugin
 } from "./chunk-XLLVWLWO.mjs";
+import {
+  resolveFarmPlatform
+} from "./chunk-SMUW7UST.mjs";
 
 // src/rsc-pipeline.ts
 import { readFileSync } from "fs";
@@ -91,6 +98,11 @@ async function createFarmRscViteConfig(userConfig, options) {
     experimental: { ...userConfig.experimental, serverComponents: true },
     port: options.port ?? userConfig.server?.port,
     plugins: [
+      ...options.command === "serve" && resolveFarmPlatform() === "desktop" ? [
+        farmDesktopDevGuardPlugin(
+          typeof userConfig.basePath === "string" ? userConfig.basePath : void 0
+        )
+      ] : [],
       ...tailwind ? [tailwind] : [],
       ...vitePlugins,
       viteRsc.default({ serverHandler: false, entries: FARM_RSC_ENTRIES }),
@@ -118,7 +130,13 @@ async function createFarmRscViteConfig(userConfig, options) {
 }
 async function createFarmRscDevServer(userConfig, options) {
   const { createServer } = await import("vite");
-  return createServer(await createFarmRscViteConfig(userConfig, { ...options, command: "serve" }));
+  const { host, ...configOptions } = options;
+  const config = await createFarmRscViteConfig(userConfig, { ...configOptions, command: "serve" });
+  return createServer({
+    ...config,
+    plugins: [...config.plugins ?? [], createFarmDevLoopbackPlugin()],
+    ...host === void 0 ? {} : { server: { ...config.server, host } }
+  });
 }
 async function buildFarmRsc(userConfig, options) {
   const { createBuilder } = await import("vite");

package/dist/{chunk-HUL4LTC6.cjs → chunk-HYN3LLG7.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 _chunkGOOK2J2Wcjs = require('./chunk-GOOK2J2W.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(_chunkGOOK2J2Wcjs.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(_chunkGOOK2J2Wcjs.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-HELQXYVI.cjs → chunk-I2DQGS56.cjs}

@@ -4,7 +4,8 @@
 var _chunkRI3EVPKDcjs = require('./chunk-RI3EVPKD.cjs');
 
 
-var _chunkV7KTQR4Ccjs = require('./chunk-V7KTQR4C.cjs');
+
+var _chunkQXJADAQBcjs = require('./chunk-QXJADAQB.cjs');
 
 
 
@@ -244,7 +245,7 @@ var SPARouter = class {
       );
       if (scroll) {
         if (url.hash) {
-          _optionalChain([_chunkV7KTQR4Ccjs.getHashTargetElement.call(void 0, url.hash), 'optionalAccess', _10 => _10.scrollIntoView, 'call', _11 => _11()]);
+          _optionalChain([_chunkQXJADAQBcjs.getHashTargetElement.call(void 0, url.hash), 'optionalAccess', _10 => _10.scrollIntoView, 'call', _11 => _11()]);
         } else {
           window.scrollTo(0, 0);
         }
@@ -252,11 +253,12 @@ var SPARouter = class {
       return;
     }
     const from = window.location.pathname + window.location.search;
-    if (await this.shouldBlockNavigation({
-      from,
-      to: fullPath,
-      action: replace ? "replace" : "push"
-    })) {
+    const action = replace ? "replace" : "push";
+    if (await this.shouldBlockNavigation({ from, to: fullPath, action })) {
+      return;
+    }
+    if (!(refresh && fullPath === from) && await _chunkQXJADAQBcjs.runFarmNavigationDelegates.call(void 0, { url: url.href, from, to: fullPath, action })) {
+      this.cancelActiveNavigation();
       return;
     }
     if (this.options.scrollRestoration) {
@@ -528,7 +530,7 @@ var SPARouter = class {
     }
     if (options.scroll) {
       if (options.url.hash) {
-        const element = _chunkV7KTQR4Ccjs.getHashTargetElement.call(void 0, options.url.hash);
+        const element = _chunkQXJADAQBcjs.getHashTargetElement.call(void 0, options.url.hash);
         if (element) {
           element.scrollIntoView();
         }
@@ -762,7 +764,7 @@ var SPARouter = class {
       }
       const destinationPath = window.location.pathname + window.location.search;
       if (window.location.hash) {
-        const target = _chunkV7KTQR4Ccjs.getHashTargetElement.call(void 0, window.location.hash);
+        const target = _chunkQXJADAQBcjs.getHashTargetElement.call(void 0, window.location.hash);
         if (target) {
           target.scrollIntoView();
         } else if (this.options.scrollRestoration) {