@farm.js/core 0.1.15 → 0.1.17

package/dist/plugin.d.mts

@@ -1,5 +1,6 @@
-export { r as EndpointMCPMetadata, s as EndpointMCPOptions, a as EndpointOpenAPIMetadata, a3 as PluginLocalAPI, a2 as PluginLocalAPIEndpoint, a1 as PluginRoutes, P as PluginRoutesFactory, _ as RouteDefinition, W as RouteMethod, a7 as RouteSchema } from './route-C6UClI1z.mjs';
-export { c9 as APIHandlerLifecyclePayload, c5 as APIRouteDiscoveredPayload, cc as BundleLifecyclePayload, B as BundleResultPayload, ca as ErrorLifecyclePayload, fa as FARM_NODE_RESPONSE_END_PENDING, a as FarmPlugin, b$ as FarmPluginBuildHooks, c1 as FarmPluginClientConfig, d as FarmPluginContext, aV as FarmPluginDatabase, aW as FarmPluginDefinition, c0 as FarmPluginDevHooks, bY as FarmPluginDiscoveredRoute, bD as FarmPluginIntegrationContext, bE as FarmPluginLifecycle, b_ as FarmPluginRenderHooks, bI as FarmPluginRouteRuntimePayload, bZ as FarmPluginRouterHooks, bQ as FarmPluginRuntimeAfterEvent, bL as FarmPluginRuntimeBaseEvent, bP as FarmPluginRuntimeBeforeEvent, bT as FarmPluginRuntimeCloseEvent, bM as FarmPluginRuntimeContextEvent, bN as FarmPluginRuntimeEndpoint, bO as FarmPluginRuntimeEndpointEvent, bR as FarmPluginRuntimeErrorEvent, bU as FarmPluginRuntimeHooks, bH as FarmPluginRuntimeKind, bW as FarmPluginRuntimeRequestHandler, bV as FarmPluginRuntimeRequestOptions, bX as FarmPluginRuntimeSession, bS as FarmPluginRuntimeStartEvent, bJ as FarmPluginSetupContext, bK as FarmPluginStateContext, bF as FarmRequestPluginContext, bG as FarmRequestStore, aT as FarmRuntimeShutdownError, cb as HMRUpdatePayload, c4 as MiddlewareDiscoveredPayload, cd as NitroBuildLifecyclePayload, aU as PluginManager, bC as PluginRequestContext, c8 as RenderLifecyclePayload, c2 as RouteDiscoveredPayload, c6 as RouteMatchPayload, c7 as RouteMatchResultPayload, c3 as RoutesGeneratedPayload, ce as ShutdownPayload, aS as definePlugin, x as farmPlugin } from './client-plugins-C1EgdoJM.mjs';
+export { i as PluginLocalAPI, h as PluginLocalAPIEndpoint, g as PluginRoutes, P as PluginRoutesFactory, d as RouteDefinition, R as RouteMethod } from './route-B0XrsrFk.mjs';
+export { d as EndpointMCPMetadata, b as EndpointMCPOptions, f as EndpointOpenAPIMetadata, R as RouteSchema } from './endpoint-DAc96i93.mjs';
+export { ca as APIHandlerLifecyclePayload, c6 as APIRouteDiscoveredPayload, cd as BundleLifecyclePayload, B as BundleResultPayload, cb as ErrorLifecyclePayload, fb as FARM_NODE_RESPONSE_END_PENDING, a as FarmPlugin, c0 as FarmPluginBuildHooks, c2 as FarmPluginClientConfig, d as FarmPluginContext, aV as FarmPluginDatabase, aW as FarmPluginDefinition, c1 as FarmPluginDevHooks, bZ as FarmPluginDiscoveredRoute, bE as FarmPluginIntegrationContext, bF as FarmPluginLifecycle, b$ as FarmPluginRenderHooks, bJ as FarmPluginRouteRuntimePayload, b_ as FarmPluginRouterHooks, bR as FarmPluginRuntimeAfterEvent, bM as FarmPluginRuntimeBaseEvent, bQ as FarmPluginRuntimeBeforeEvent, bU as FarmPluginRuntimeCloseEvent, bN as FarmPluginRuntimeContextEvent, bO as FarmPluginRuntimeEndpoint, bP as FarmPluginRuntimeEndpointEvent, bS as FarmPluginRuntimeErrorEvent, bV as FarmPluginRuntimeHooks, bI as FarmPluginRuntimeKind, bX as FarmPluginRuntimeRequestHandler, bW as FarmPluginRuntimeRequestOptions, bY as FarmPluginRuntimeSession, bT as FarmPluginRuntimeStartEvent, bK as FarmPluginSetupContext, bL as FarmPluginStateContext, bG as FarmRequestPluginContext, bH as FarmRequestStore, aT as FarmRuntimeShutdownError, cc as HMRUpdatePayload, c5 as MiddlewareDiscoveredPayload, ce as NitroBuildLifecyclePayload, aU as PluginManager, bD as PluginRequestContext, c9 as RenderLifecyclePayload, c3 as RouteDiscoveredPayload, c7 as RouteMatchPayload, c8 as RouteMatchResultPayload, c4 as RoutesGeneratedPayload, cf as ShutdownPayload, aS as definePlugin, x as farmPlugin } from './client-plugins-JXXmZliS.mjs';
 import 'vite';
 import './lifecycle-DK06VuKP.mjs';
 import './env.mjs';
@@ -27,6 +28,8 @@ import './server-fn-error-DDh14a0V.mjs';
 import 'esbuild';
 import './image-config-Duob7wER.mjs';
 import './types-Z0aotQ8w.mjs';
+import './server-fn.mjs';
+import './server-query.mjs';
 import './types-DQnyD3VD.mjs';
 import './font.mjs';
 import './after.mjs';

package/dist/plugin.d.ts

@@ -1,5 +1,6 @@
-export { r as EndpointMCPMetadata, s as EndpointMCPOptions, a as EndpointOpenAPIMetadata, a3 as PluginLocalAPI, a2 as PluginLocalAPIEndpoint, a1 as PluginRoutes, P as PluginRoutesFactory, _ as RouteDefinition, W as RouteMethod, a7 as RouteSchema } from './route-CHBaW55F.js';
-export { c9 as APIHandlerLifecyclePayload, c5 as APIRouteDiscoveredPayload, cc as BundleLifecyclePayload, B as BundleResultPayload, ca as ErrorLifecyclePayload, fa as FARM_NODE_RESPONSE_END_PENDING, a as FarmPlugin, b$ as FarmPluginBuildHooks, c1 as FarmPluginClientConfig, d as FarmPluginContext, aV as FarmPluginDatabase, aW as FarmPluginDefinition, c0 as FarmPluginDevHooks, bY as FarmPluginDiscoveredRoute, bD as FarmPluginIntegrationContext, bE as FarmPluginLifecycle, b_ as FarmPluginRenderHooks, bI as FarmPluginRouteRuntimePayload, bZ as FarmPluginRouterHooks, bQ as FarmPluginRuntimeAfterEvent, bL as FarmPluginRuntimeBaseEvent, bP as FarmPluginRuntimeBeforeEvent, bT as FarmPluginRuntimeCloseEvent, bM as FarmPluginRuntimeContextEvent, bN as FarmPluginRuntimeEndpoint, bO as FarmPluginRuntimeEndpointEvent, bR as FarmPluginRuntimeErrorEvent, bU as FarmPluginRuntimeHooks, bH as FarmPluginRuntimeKind, bW as FarmPluginRuntimeRequestHandler, bV as FarmPluginRuntimeRequestOptions, bX as FarmPluginRuntimeSession, bS as FarmPluginRuntimeStartEvent, bJ as FarmPluginSetupContext, bK as FarmPluginStateContext, bF as FarmRequestPluginContext, bG as FarmRequestStore, aT as FarmRuntimeShutdownError, cb as HMRUpdatePayload, c4 as MiddlewareDiscoveredPayload, cd as NitroBuildLifecyclePayload, aU as PluginManager, bC as PluginRequestContext, c8 as RenderLifecyclePayload, c2 as RouteDiscoveredPayload, c6 as RouteMatchPayload, c7 as RouteMatchResultPayload, c3 as RoutesGeneratedPayload, ce as ShutdownPayload, aS as definePlugin, x as farmPlugin } from './client-plugins-CslwYp3E.js';
+export { i as PluginLocalAPI, h as PluginLocalAPIEndpoint, g as PluginRoutes, P as PluginRoutesFactory, d as RouteDefinition, R as RouteMethod } from './route-DOEpbyWZ.js';
+export { d as EndpointMCPMetadata, b as EndpointMCPOptions, f as EndpointOpenAPIMetadata, R as RouteSchema } from './endpoint-1zA994xL.js';
+export { ca as APIHandlerLifecyclePayload, c6 as APIRouteDiscoveredPayload, cd as BundleLifecyclePayload, B as BundleResultPayload, cb as ErrorLifecyclePayload, fb as FARM_NODE_RESPONSE_END_PENDING, a as FarmPlugin, c0 as FarmPluginBuildHooks, c2 as FarmPluginClientConfig, d as FarmPluginContext, aV as FarmPluginDatabase, aW as FarmPluginDefinition, c1 as FarmPluginDevHooks, bZ as FarmPluginDiscoveredRoute, bE as FarmPluginIntegrationContext, bF as FarmPluginLifecycle, b$ as FarmPluginRenderHooks, bJ as FarmPluginRouteRuntimePayload, b_ as FarmPluginRouterHooks, bR as FarmPluginRuntimeAfterEvent, bM as FarmPluginRuntimeBaseEvent, bQ as FarmPluginRuntimeBeforeEvent, bU as FarmPluginRuntimeCloseEvent, bN as FarmPluginRuntimeContextEvent, bO as FarmPluginRuntimeEndpoint, bP as FarmPluginRuntimeEndpointEvent, bS as FarmPluginRuntimeErrorEvent, bV as FarmPluginRuntimeHooks, bI as FarmPluginRuntimeKind, bX as FarmPluginRuntimeRequestHandler, bW as FarmPluginRuntimeRequestOptions, bY as FarmPluginRuntimeSession, bT as FarmPluginRuntimeStartEvent, bK as FarmPluginSetupContext, bL as FarmPluginStateContext, bG as FarmRequestPluginContext, bH as FarmRequestStore, aT as FarmRuntimeShutdownError, cc as HMRUpdatePayload, c5 as MiddlewareDiscoveredPayload, ce as NitroBuildLifecyclePayload, aU as PluginManager, bD as PluginRequestContext, c9 as RenderLifecyclePayload, c3 as RouteDiscoveredPayload, c7 as RouteMatchPayload, c8 as RouteMatchResultPayload, c4 as RoutesGeneratedPayload, cf as ShutdownPayload, aS as definePlugin, x as farmPlugin } from './client-plugins-C089bQhN.js';
 import 'vite';
 import './lifecycle-DK06VuKP.js';
 import './env.js';
@@ -27,6 +28,8 @@ import './server-fn-error-DDh14a0V.js';
 import 'esbuild';
 import './image-config-Duob7wER.js';
 import './types-Z0aotQ8w.js';
+import './server-fn.js';
+import './server-query.js';
 import './types-DQnyD3VD.js';
 import './font.js';
 import './after.js';

package/dist/plugin.mjs

@@ -4,12 +4,12 @@ import {
   PluginManager,
   definePlugin,
   farmPlugin
-} from "./chunk-JRF3C33L.mjs";
-import "./chunk-27JNCYEK.mjs";
+} from "./chunk-56DAX2BE.mjs";
+import "./chunk-EN7WTEAY.mjs";
 import "./chunk-DHDVMXYK.mjs";
 import "./chunk-ZMSZZXOR.mjs";
 import "./chunk-3NM6SRI6.mjs";
-import "./chunk-7ZWL7XOU.mjs";
+import "./chunk-76DG3LF3.mjs";
 import "./chunk-DAO7JGTS.mjs";
 import "./chunk-BOYNDCZL.mjs";
 import "./chunk-HLCDYJY7.mjs";
@@ -27,37 +27,37 @@ import "./chunk-JBSVKMC5.mjs";
 import "./chunk-7WPA7GBZ.mjs";
 import "./chunk-IILNZK5G.mjs";
 import "./chunk-OLYK7EAK.mjs";
-import "./chunk-Q3MDL7TM.mjs";
+import "./chunk-ZCNJKLA2.mjs";
 import "./chunk-G2KY33I6.mjs";
-import "./chunk-4L7SZOHZ.mjs";
+import "./chunk-YHOCRI4H.mjs";
 import "./chunk-QCFFHV5H.mjs";
-import "./chunk-FOGLGRDS.mjs";
-import "./chunk-KATQ6I56.mjs";
-import "./chunk-LUC2FAGW.mjs";
+import "./chunk-4OOBRCJX.mjs";
+import "./chunk-XWAYMDLB.mjs";
+import "./chunk-6VQIKZZO.mjs";
 import "./chunk-FA2W42OV.mjs";
-import "./chunk-6SCB2MXB.mjs";
-import "./chunk-MUUZJLCI.mjs";
-import "./chunk-ONUEYC6N.mjs";
+import "./chunk-SXHV42UQ.mjs";
+import "./chunk-EGJDUF4Q.mjs";
 import "./chunk-2UC36WAC.mjs";
+import "./chunk-ONUEYC6N.mjs";
 import "./chunk-UWPLULNK.mjs";
 import "./chunk-AELACLOB.mjs";
 import "./chunk-SEJ5N6SL.mjs";
 import "./chunk-JLCQGPXE.mjs";
 import "./chunk-FP2INE7H.mjs";
 import "./chunk-44SYJEG3.mjs";
-import "./chunk-B76DT5Y6.mjs";
-import "./chunk-NDD2YVGU.mjs";
+import "./chunk-57J3Y7Y3.mjs";
+import "./chunk-NRVGEI5I.mjs";
 import "./chunk-5TISYEQF.mjs";
 import "./chunk-R3DS7A2T.mjs";
 import "./chunk-IOEH4VWN.mjs";
-import "./chunk-ZHOIQC6U.mjs";
-import "./chunk-VO5SCWF5.mjs";
+import "./chunk-ATERBVHQ.mjs";
+import "./chunk-BNGS6KJ6.mjs";
 import "./chunk-CU625VAY.mjs";
 import "./chunk-JNGIWIY6.mjs";
 import "./chunk-FV45CKBC.mjs";
-import "./chunk-DPZUDPVJ.mjs";
+import "./chunk-XP777LRD.mjs";
 import "./chunk-I6XDAKWQ.mjs";
-import "./chunk-OWTIOHON.mjs";
+import "./chunk-SYGGPS4A.mjs";
 import "./chunk-W3B4PKAW.mjs";
 import "./chunk-5WI2S4CO.mjs";
 import "./chunk-EA5K5BKU.mjs";
@@ -69,7 +69,7 @@ import "./chunk-YMCXWPWK.mjs";
 import "./chunk-KI3MESHB.mjs";
 import "./chunk-QVKYGNVM.mjs";
 import "./chunk-Z2RZJZIZ.mjs";
-import "./chunk-UE75PB52.mjs";
+import "./chunk-YD4J4XCI.mjs";
 import "./chunk-54UPOYFS.mjs";
 import "./chunk-WNSDDRNU.mjs";
 import "./chunk-JPLUGGRV.mjs";
@@ -82,7 +82,7 @@ import "./chunk-YS3TRKCG.mjs";
 import "./chunk-SKNL7VA2.mjs";
 import "./chunk-2A3EQHXX.mjs";
 import "./chunk-JNZ4TDWM.mjs";
-import "./chunk-IGO2HEV7.mjs";
+import "./chunk-F6SJAKFJ.mjs";
 import "./chunk-4SIYUGRY.mjs";
 import "./chunk-C4NCTZLM.mjs";
 import "./chunk-FUZEBRP3.mjs";

package/dist/{production-runtime-BDllolVh.d.mts → production-runtime-jcrTlRTb.d.mts}

@@ -1,4 +1,4 @@
-import { aj as ReadonlyMiddlewareStore, ak as FarmMiddlewareConfig, al as MiddlewareModule, am as MiddlewareConfig, an as MiddlewareContext } from './client-plugins-C1EgdoJM.mjs';
+import { aj as ReadonlyMiddlewareStore, ak as FarmMiddlewareConfig, al as MiddlewareModule, am as MiddlewareConfig, an as MiddlewareContext } from './client-plugins-JXXmZliS.mjs';
 import { R as ResolvedFarmI18nConfig } from './types-Z0aotQ8w.mjs';
 import { R as ResolvedFarmServerConfig } from './workflows-CR9ex-gz.mjs';
 

package/dist/{production-runtime-CsNn2-zx.d.ts → production-runtime-oKmC0WU-.d.ts}

@@ -1,4 +1,4 @@
-import { aj as ReadonlyMiddlewareStore, ak as FarmMiddlewareConfig, al as MiddlewareModule, am as MiddlewareConfig, an as MiddlewareContext } from './client-plugins-CslwYp3E.js';
+import { aj as ReadonlyMiddlewareStore, ak as FarmMiddlewareConfig, al as MiddlewareModule, am as MiddlewareConfig, an as MiddlewareContext } from './client-plugins-C089bQhN.js';
 import { R as ResolvedFarmI18nConfig } from './types-Z0aotQ8w.js';
 import { R as ResolvedFarmServerConfig } from './workflows-CR9ex-gz.js';
 

package/dist/{render-plan-CNUlzylR.d.mts → render-plan-BLIfc4jt.d.mts}

@@ -1,5 +1,5 @@
 import { F as FarmIslandStrategy } from './island-CfGru1MO.mjs';
-import './client-plugins-C1EgdoJM.mjs';
+import './client-plugins-JXXmZliS.mjs';
 
 /**
  * A build-time rendering decision consumed by the browser router.

package/dist/{render-plan-EG4hNFjy.d.ts → render-plan-DOB9cV-h.d.ts}

@@ -1,5 +1,5 @@
 import { F as FarmIslandStrategy } from './island-CfGru1MO.js';
-import './client-plugins-CslwYp3E.js';
+import './client-plugins-C089bQhN.js';
 
 /**
  * A build-time rendering decision consumed by the browser router.

package/dist/renderer-client.cjs

@@ -2805,6 +2805,8 @@ var _FarmDataCache = class _FarmDataCache {
   constructor(config = {}) {
     this.entries = /* @__PURE__ */ new Map();
     this.inflight = /* @__PURE__ */ new Map();
+    /** Local entries by tag, so tag counts and pruning never scan unrelated entries. */
+    this.entriesByTag = /* @__PURE__ */ new Map();
     this.invalidatedTagVersions = /* @__PURE__ */ new Map();
     this.activeGenerations = /* @__PURE__ */ new Set();
     this.version = 0;
@@ -2823,6 +2825,7 @@ var _FarmDataCache = class _FarmDataCache {
   configure(config = {}) {
     this.generation++;
     this.entries.clear();
+    this.entriesByTag.clear();
     this.inflight.clear();
     this.invalidatedTagVersions.clear();
     this.activeGenerations.clear();
@@ -2989,14 +2992,12 @@ var _FarmDataCache = class _FarmDataCache {
     return entry;
   }
   delete(key) {
-    const deleted = this.entries.delete(key);
-    if (deleted) this.pruneInvalidatedTagVersions();
+    const deleted = this.deleteLocalEntry(key);
     emitFarmEvent({ type: "cache.delete", key, deleted });
     return deleted;
   }
   async deleteAsync(key) {
-    const deleted = this.entries.delete(key);
-    if (deleted) this.pruneInvalidatedTagVersions();
+    const deleted = this.deleteLocalEntry(key);
     if (this.adapter) {
       await this.adapter.delete(this.createAdapterKey(key));
     }
@@ -3007,6 +3008,7 @@ var _FarmDataCache = class _FarmDataCache {
     const count = this.entries.size;
     this.generation++;
     this.entries.clear();
+    this.entriesByTag.clear();
     this.inflight.clear();
     this.invalidatedTagVersions.clear();
     this.activeGenerations.clear();
@@ -3092,23 +3094,32 @@ var _FarmDataCache = class _FarmDataCache {
       return cached.value;
     }
     const inflight = this.inflight.get(key);
-    if (inflight) {
+    if (inflight && !this.wasInvalidatedSince(inflight.tags, inflight.startVersion)) {
       emitFarmEvent({ type: "cache.dedupe", key });
-      return inflight;
+      return inflight.promise;
     }
     const tags = Array.from(normalizeCacheOptionsTags(options));
     const generation = this.generation;
+    const startVersion = this.version;
     const promise = this.fillCacheEntry(key, producer, options, tags, generation).catch((error) => {
       emitFarmEvent({ type: "cache.error", key, operation: "set", error });
       throw error;
     }).finally(() => {
-      if (this.inflight.get(key) === promise) {
+      if (this.inflight.get(key)?.promise === promise) {
         this.inflight.delete(key);
       }
     });
-    this.inflight.set(key, promise);
+    this.inflight.set(key, { promise, tags, startVersion });
     return promise;
   }
+  /** A fill that started before one of its tags was invalidated cannot satisfy later readers. */
+  wasInvalidatedSince(tags, version) {
+    for (const tag of tags) {
+      const invalidatedVersion = this.invalidatedTagVersions.get(tag);
+      if (invalidatedVersion !== void 0 && invalidatedVersion > version) return true;
+    }
+    return false;
+  }
   async fillCacheEntry(key, producer, options, tags, generation) {
     const adapter = this.adapter;
     const namespace = this.namespace;
@@ -3149,7 +3160,7 @@ var _FarmDataCache = class _FarmDataCache {
       return value;
     } finally {
       this.activeGenerations.delete(activeGeneration);
-      this.pruneInvalidatedTagVersions();
+      this.pruneInvalidatedTagVersions(activeGeneration.tags);
       if (leaseToken && adapter?.releaseLease) {
         try {
           await adapter.releaseLease(leaseKey, leaseToken);
@@ -3194,18 +3205,9 @@ var _FarmDataCache = class _FarmDataCache {
     }
     return void 0;
   }
-  countEntriesForTag(tag) {
-    let count = 0;
-    for (const entry of this.entries.values()) {
-      if (entry.tags.has(tag)) {
-        count++;
-      }
-    }
-    return count;
-  }
   countEntriesForTags(tags) {
     let count = 0;
-    for (const entry of this.entries.values()) {
+    for (const entry of this.entriesByTag.get(tags[0]) ?? []) {
       if (tags.every((tag) => entry.tags.has(tag))) {
         count++;
       }
@@ -3213,10 +3215,10 @@ var _FarmDataCache = class _FarmDataCache {
     return count;
   }
   invalidateTag(normalizedTag) {
-    const count = this.countEntriesForTag(normalizedTag);
+    const count = this.entriesByTag.get(normalizedTag)?.size ?? 0;
     this.invalidatedTagVersions.delete(normalizedTag);
     this.invalidatedTagVersions.set(normalizedTag, ++this.version);
-    this.pruneInvalidatedTagVersions();
+    this.pruneInvalidatedTagVersions([normalizedTag]);
     return count;
   }
   toPublicEntry(entry) {
@@ -3246,19 +3248,51 @@ var _FarmDataCache = class _FarmDataCache {
     this.entries.set(key, entry);
   }
   storeLocalEntry(entry) {
-    this.entries.delete(entry.key);
+    const removed = [];
+    const replaced = this.detachLocalEntry(entry.key);
+    if (replaced) removed.push(replaced);
     this.entries.set(entry.key, entry);
+    for (const tag of entry.tags) {
+      let tagged = this.entriesByTag.get(tag);
+      if (!tagged) this.entriesByTag.set(tag, tagged = /* @__PURE__ */ new Set());
+      tagged.add(entry);
+    }
     while (this.entries.size > this.maxEntries) {
       const oldestKey = this.entries.keys().next().value;
       if (oldestKey === void 0) break;
-      this.entries.delete(oldestKey);
+      removed.push(this.detachLocalEntry(oldestKey));
     }
-    this.pruneInvalidatedTagVersions();
+    for (const removedEntry of removed) this.pruneInvalidatedTagVersions(removedEntry.tags);
   }
-  pruneInvalidatedTagVersions() {
-    tags: for (const [tag, invalidatedVersion] of this.invalidatedTagVersions) {
-      for (const entry of this.entries.values()) {
-        if (entry.tags.has(tag) && entry.createdVersion < invalidatedVersion) continue tags;
+  deleteLocalEntry(key) {
+    const entry = this.detachLocalEntry(key);
+    if (!entry) return false;
+    this.pruneInvalidatedTagVersions(entry.tags);
+    return true;
+  }
+  detachLocalEntry(key) {
+    const entry = this.entries.get(key);
+    if (!entry) return void 0;
+    this.entries.delete(key);
+    for (const tag of entry.tags) {
+      const tagged = this.entriesByTag.get(tag);
+      if (!tagged) continue;
+      tagged.delete(entry);
+      if (tagged.size === 0) this.entriesByTag.delete(tag);
+    }
+    return entry;
+  }
+  /**
+   * Drop invalidation versions that no local entry or active fill can be stale against.
+   * Callers pass only the tags whose dependents just changed, so the cost is bounded by
+   * the entries sharing those tags rather than by the whole cache.
+   */
+  pruneInvalidatedTagVersions(tags) {
+    tags: for (const tag of tags) {
+      const invalidatedVersion = this.invalidatedTagVersions.get(tag);
+      if (invalidatedVersion === void 0) continue;
+      for (const entry of this.entriesByTag.get(tag) ?? []) {
+        if (entry.createdVersion < invalidatedVersion) continue tags;
       }
       for (const generation of this.activeGenerations) {
         if (generation.tags.has(tag) && generation.createdVersion < invalidatedVersion)

package/dist/renderer-client.d.mts

@@ -1,14 +1,15 @@
 import { FarmRouterRouteInput } from './router.mjs';
-import { F as FarmNavigationState, a as FarmNavigateOptions } from './spa-router-csKR9Ebj.mjs';
+import { F as FarmNavigationState, a as FarmNavigateOptions } from './spa-router-CQWiYGxS.mjs';
 import { F as FarmClientCacheStatus } from './client-cache-di_Nasxa.mjs';
 import { ServerFn } from './server-fn.mjs';
 import { ServerQuery } from './server-query.mjs';
 import { S as ServerQueryFetchOptions } from './server-query-runtime-aP52iuL5.mjs';
 import { F as FarmThemeSnapshot, a as FarmThemePreference } from './types-DQnyD3VD.mjs';
 import { F as FarmI18nClientSnapshot, a as FarmTranslator, b as FarmI18nLocale } from './types-Z0aotQ8w.mjs';
-import './client-plugins-C1EgdoJM.mjs';
+import './client-plugins-JXXmZliS.mjs';
 import './lifecycle-DK06VuKP.mjs';
-import './route-C6UClI1z.mjs';
+import './route-B0XrsrFk.mjs';
+import './endpoint-DAc96i93.mjs';
 import './cache.mjs';
 import './renderer.mjs';
 import './deployment.mjs';
@@ -38,7 +39,7 @@ import './font.mjs';
 import './after.mjs';
 import 'node:http';
 import './island-CfGru1MO.mjs';
-import './render-plan-CNUlzylR.mjs';
+import './render-plan-BLIfc4jt.mjs';
 
 interface FarmClientStore<TSnapshot> {
     getSnapshot(): TSnapshot;

package/dist/renderer-client.d.ts

@@ -1,14 +1,15 @@
 import { FarmRouterRouteInput } from './router.js';
-import { F as FarmNavigationState, a as FarmNavigateOptions } from './spa-router-Y_2FSJQK.js';
+import { F as FarmNavigationState, a as FarmNavigateOptions } from './spa-router-Wjiw-8hB.js';
 import { F as FarmClientCacheStatus } from './client-cache-Deoqq-nM.js';
 import { ServerFn } from './server-fn.js';
 import { ServerQuery } from './server-query.js';
 import { S as ServerQueryFetchOptions } from './server-query-runtime-DXRNhX_3.js';
 import { F as FarmThemeSnapshot, a as FarmThemePreference } from './types-DQnyD3VD.js';
 import { F as FarmI18nClientSnapshot, a as FarmTranslator, b as FarmI18nLocale } from './types-Z0aotQ8w.js';
-import './client-plugins-CslwYp3E.js';
+import './client-plugins-C089bQhN.js';
 import './lifecycle-DK06VuKP.js';
-import './route-CHBaW55F.js';
+import './route-DOEpbyWZ.js';
+import './endpoint-1zA994xL.js';
 import './cache.js';
 import './renderer.js';
 import './deployment.js';
@@ -38,7 +39,7 @@ import './font.js';
 import './after.js';
 import 'node:http';
 import './island-CfGru1MO.js';
-import './render-plan-EG4hNFjy.js';
+import './render-plan-DOB9cV-h.js';
 
 interface FarmClientStore<TSnapshot> {
     getSnapshot(): TSnapshot;

package/dist/renderer-client.mjs

@@ -6,7 +6,7 @@ import {
   attachRevalidationListeners,
   createServerQueryCallKey,
   fetchServerQuery
-} from "./chunk-76MNRHTS.mjs";
+} from "./chunk-UUYF3CHN.mjs";
 import {
   getTheme,
   setTheme,
@@ -30,7 +30,7 @@ import "./chunk-2PQNJXFM.mjs";
 import "./chunk-5HGR3W6O.mjs";
 import {
   getFarmClientDataCache
-} from "./chunk-HKLRP3BN.mjs";
+} from "./chunk-5SPPCN5J.mjs";
 import "./chunk-QVYLBY73.mjs";
 import "./chunk-KGB5UXJJ.mjs";
 import {
@@ -40,7 +40,7 @@ import "./chunk-YS3TRKCG.mjs";
 import "./chunk-SKNL7VA2.mjs";
 import "./chunk-2A3EQHXX.mjs";
 import "./chunk-JNZ4TDWM.mjs";
-import "./chunk-IGO2HEV7.mjs";
+import "./chunk-F6SJAKFJ.mjs";
 import "./chunk-4SIYUGRY.mjs";
 import "./chunk-C4NCTZLM.mjs";
 import "./chunk-FUZEBRP3.mjs";

package/dist/{request-Blh_f7Z3.d.mts → request-Cr53NRHr.d.mts}

@@ -1,4 +1,4 @@
-import './client-plugins-C1EgdoJM.mjs';
+import './client-plugins-JXXmZliS.mjs';
 
 interface FarmRequestURLOptions {
     origin?: string | URL;

package/dist/{request-DsVSQVfD.d.ts → request-Dt2gNuQD.d.ts}

@@ -1,4 +1,4 @@
-import './client-plugins-CslwYp3E.js';
+import './client-plugins-C089bQhN.js';
 
 interface FarmRequestURLOptions {
     origin?: string | URL;

package/dist/request.d.mts

@@ -1,7 +1,8 @@
-export { g as getCurrentRequest } from './request-Blh_f7Z3.mjs';
-import './client-plugins-C1EgdoJM.mjs';
+export { g as getCurrentRequest } from './request-Cr53NRHr.mjs';
+import './client-plugins-JXXmZliS.mjs';
 import './lifecycle-DK06VuKP.mjs';
-import './route-C6UClI1z.mjs';
+import './route-B0XrsrFk.mjs';
+import './endpoint-DAc96i93.mjs';
 import './cache.mjs';
 import './renderer.mjs';
 import './deployment.mjs';
@@ -28,6 +29,8 @@ import './server-fn-error-DDh14a0V.mjs';
 import 'esbuild';
 import './image-config-Duob7wER.mjs';
 import './types-Z0aotQ8w.mjs';
+import './server-fn.mjs';
+import './server-query.mjs';
 import './types-DQnyD3VD.mjs';
 import './font.mjs';
 import './after.mjs';

package/dist/request.d.ts

@@ -1,7 +1,8 @@
-export { g as getCurrentRequest } from './request-DsVSQVfD.js';
-import './client-plugins-CslwYp3E.js';
+export { g as getCurrentRequest } from './request-Dt2gNuQD.js';
+import './client-plugins-C089bQhN.js';
 import './lifecycle-DK06VuKP.js';
-import './route-CHBaW55F.js';
+import './route-DOEpbyWZ.js';
+import './endpoint-1zA994xL.js';
 import './cache.js';
 import './renderer.js';
 import './deployment.js';
@@ -28,6 +29,8 @@ import './server-fn-error-DDh14a0V.js';
 import 'esbuild';
 import './image-config-Duob7wER.js';
 import './types-Z0aotQ8w.js';
+import './server-fn.js';
+import './server-query.js';
 import './types-DQnyD3VD.js';
 import './font.js';
 import './after.js';

package/dist/route-B0XrsrFk.d.mts

@@ -0,0 +1,128 @@
+import { E as EndpointMiddlewareResult, R as RouteSchema, a as RouteSchemaOutput, b as EndpointMCPOptions, A as AnyEndpointMiddleware, I as InferEndpointMiddlewareContext, T as TypedEndpoint, c as RouteSchemaInput } from './endpoint-DAc96i93.mjs';
+
+type RouteMethod = "GET" | "HEAD" | "QUERY" | "POST" | "PUT" | "PATCH" | "DELETE" | "OPTIONS";
+type RoutePathParams<Path extends string> = Path extends `${infer Head}/${infer Tail}` ? RoutePathParams<Head> & RoutePathParams<Tail> : Path extends `[[...${infer Name}]]` ? {
+    [K in Name]?: string[];
+} : Path extends `[...${infer Name}]` ? {
+    [K in Name]: string[];
+} : Path extends `[${infer Name}]` ? {
+    [K in Name]: string;
+} : {};
+interface RouteInputSchemas {
+    body?: RouteSchema;
+    query?: RouteSchema;
+    params?: RouteSchema;
+    headers?: RouteSchema;
+}
+type Input<I, K extends PropertyKey> = K extends keyof I ? RouteSchemaInput<I[K]> : never;
+type Output<I, K extends PropertyKey, Fallback = unknown> = K extends keyof I ? RouteSchemaOutput<I[K]> : Fallback;
+/** JSON responses have wire types, not server-side instances such as Date. */
+type RouteJSON<T> = T extends Response ? unknown : T extends {
+    toJSON(): infer J;
+} ? RouteJSON<J> : T extends bigint | symbol | ((...args: any[]) => any) ? never : T extends readonly (infer V)[] ? RouteJSON<V>[] : T extends object ? {
+    [K in keyof T]: RouteJSON<T[K]>;
+} : T;
+type RouteDefinition<P extends string = string, M extends RouteMethod = RouteMethod, E = any> = {
+    readonly path: P;
+    readonly method: M;
+    readonly endpoint: E;
+};
+type RouteEndpoint<P extends string, I extends RouteInputSchemas, R> = TypedEndpoint<Output<I, "body">, Input<I, "query">, RouteJSON<R>, Input<I, "headers">, never, Input<I, "body">> & {
+    __types: {
+        params: RoutePathParams<P>;
+        inputHeaders: Input<I, "headers">;
+    };
+};
+type TrimStart<P extends string> = P extends `/${infer Rest}` ? TrimStart<Rest> : P;
+type Join<P extends string, C extends string> = C extends "" ? P : `${P}/${TrimStart<C>}`;
+type ParamsCheck<P extends string, I extends RouteInputSchemas> = I extends {
+    params: infer S;
+} ? Exclude<keyof RoutePathParams<P>, keyof RouteSchemaOutput<S>> extends never ? Exclude<keyof RouteSchemaOutput<S>, keyof RoutePathParams<P>> extends never ? unknown : {
+    __error_unknown_route_params: never;
+} : {
+    __error_missing_route_params: never;
+} : unknown;
+type RouteMiddlewareResults = readonly (EndpointMiddlewareResult | Promise<EndpointMiddlewareResult>)[];
+type RouteMiddlewares<Results extends readonly unknown[]> = {
+    readonly [K in keyof Results]: (context: Parameters<AnyEndpointMiddleware>[0]) => Results[K];
+};
+type RouteOptions<P extends string, I extends RouteInputSchemas, O extends RouteSchema | undefined, R, MiddlewareResults extends RouteMiddlewareResults = RouteMiddlewareResults> = {
+    input?: I & ParamsCheck<P, I>;
+    /** Validate plain JSON handler results. Raw Response/stream results are never buffered. */
+    output?: O;
+    /** Opt this app-owned endpoint into an installed MCP transport. */
+    mcp?: EndpointMCPOptions;
+    middleware?: RouteMiddlewares<MiddlewareResults>;
+    handler(request: Request, context: {
+        input: {
+            body: Output<I, "body">;
+            query: Output<I, "query", Record<string, string | string[]>>;
+            headers: Output<I, "headers", Record<string, string>>;
+            params: Output<I, "params", RoutePathParams<P>>;
+        };
+        params: Output<I, "params", RoutePathParams<P>>;
+        context: Readonly<InferEndpointMiddlewareContext<RouteMiddlewares<MiddlewareResults>>>;
+    }): R | Promise<R>;
+};
+type RouteBuilder<P extends string, M extends RouteMethod> = <const C extends string, const MiddlewareResults extends RouteMiddlewareResults, const I extends RouteInputSchemas = {}, O extends RouteSchema | undefined = undefined, R = unknown>(path: C, options: RouteOptions<Join<P, C>, I, O, R, MiddlewareResults>) => RouteDefinition<Join<P, C>, M, RouteEndpoint<Join<P, C>, I, Extract<Awaited<R>, Response> extends never ? O extends RouteSchema ? RouteSchemaOutput<O> : Awaited<R> : unknown>>;
+type RouteFactory<P extends string = ""> = {
+    [M in Lowercase<RouteMethod>]: RouteBuilder<P, Uppercase<M> & RouteMethod>;
+} & {
+    /** Return a new builder; never mutate the parent scope. */
+    scope<const C extends string>(path: C): RouteFactory<Join<P, C>>;
+};
+type PluginRoutes = readonly RouteDefinition[];
+interface PluginLocalAPIEndpoint {
+    readonly path: string;
+    readonly method: RouteMethod;
+    readonly input: Readonly<RouteInputSchemas>;
+    readonly output?: RouteSchema;
+    readonly mcp?: EndpointMCPOptions;
+    invoke(request: Request, params?: Readonly<Record<string, string | string[]>>): Promise<Response>;
+}
+/**
+ * Read-only access to app-owned API endpoints while plugin routes are mounted.
+ * Plugin routes are intentionally excluded so a plugin cannot recurse through
+ * itself or depend on plugin registration order.
+ */
+interface PluginLocalAPI {
+    /** False during type-only route discovery, where app endpoint modules are unavailable. */
+    readonly available: boolean;
+    get(method: RouteMethod, path: string): PluginLocalAPIEndpoint | undefined;
+    /** Enumerate app-owned endpoints. Plugin routes are excluded. */
+    list(): readonly PluginLocalAPIEndpoint[];
+}
+type PluginRoutesFactory<R extends PluginRoutes = PluginRoutes> = (context: {
+    route: RouteFactory;
+    api: PluginLocalAPI;
+}) => R;
+declare function createRouteFactory(): RouteFactory;
+type UnionToIntersection<U> = (U extends unknown ? (v: U) => void : never) extends (v: infer I) => void ? I : never;
+type RouteTree<P extends string, M extends string, E> = P extends `${infer Head}/${infer Tail}` ? {
+    [K in Head]: RouteTree<Tail, M, E>;
+} : P extends "" ? {
+    [K in Lowercase<M>]: E;
+} : {
+    [K in P]: {
+        [Method in Lowercase<M>]: E;
+    };
+};
+type HasMethodSegment<P extends string> = P extends `${infer H}/${infer T}` ? H extends Lowercase<RouteMethod> ? true : HasMethodSegment<T> : P extends Lowercase<RouteMethod> ? true : false;
+type DefinitionTree<D> = D extends RouteDefinition<infer P, infer M, infer E> ? string extends P ? {} : (P extends `/api/integrations${string}` ? true : HasMethodSegment<P>) extends true ? {
+    [K in P extends `/api/${infer C}` ? `/${C}` : "/"]: {
+        [Method in Lowercase<M>]: E;
+    };
+} : RouteTree<P extends `/api/${infer C}` ? C : "", M, E> : {};
+type PluginAPIRouter<C> = C extends {
+    plugins: readonly (infer P)[];
+} ? UnionToIntersection<P extends {
+    routes?: PluginRoutesFactory<infer R>;
+} ? DefinitionTree<R[number]> : {}> : {};
+declare function resolvePluginRoutes(plugins?: readonly {
+    name: string;
+    routes?: PluginRoutesFactory;
+}[], context?: {
+    api?: PluginLocalAPI;
+}): PluginRoutes;
+
+export { type PluginRoutesFactory as P, type RouteMethod as R, type RoutePathParams as a, type RouteInputSchemas as b, type RouteJSON as c, type RouteDefinition as d, type RouteOptions as e, type RouteFactory as f, type PluginRoutes as g, type PluginLocalAPIEndpoint as h, type PluginLocalAPI as i, createRouteFactory as j, type PluginAPIRouter as k, resolvePluginRoutes as r };