@farm.js/core 0.1.15 → 0.1.17

package/dist/client.cjs

@@ -1617,6 +1617,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;
@@ -1635,6 +1637,7 @@ var _FarmDataCache = class _FarmDataCache {
   configure(config = {}) {
     this.generation++;
     this.entries.clear();
+    this.entriesByTag.clear();
     this.inflight.clear();
     this.invalidatedTagVersions.clear();
     this.activeGenerations.clear();
@@ -1801,14 +1804,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));
     }
@@ -1819,6 +1820,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();
@@ -1904,23 +1906,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;
@@ -1961,7 +1972,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);
@@ -2006,18 +2017,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++;
       }
@@ -2025,10 +2027,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) {
@@ -2058,19 +2060,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/client.d.mts

@@ -1,6 +1,6 @@
-import { r as ClientOptions, g as APIResult } from './api-client-C8d7BZNp.mjs';
-export { v as APIClient, h as APIClientError, b as APIClientOptions, i as APIClientSystemError, c as APIClientWithoutIntegrationsOptions, x as ApiClients, L as ClientHeaders, M as ClientLifecycleHooks, N as ClientRequestEvent, P as ClientResponseEvent, a9 as InferIntegrationOperationBody, aa as InferIntegrationOperationQuery, ab as InferIntegrationOperationResponse, a5 as IntegrationAPI, a0 as IntegrationClient, a1 as IntegrationClientAliases, a7 as IntegrationClientData, T as IntegrationClientError, a3 as IntegrationClientOptions, a4 as IntegrationClientRequestOptions, a2 as IntegrationClientRoot, a6 as IntegrationClients, a8 as IntegrationOperationResult, ac as IntegrationServerClient, ad as IntegrationServerClientAliases, ae as IntegrationServerClientOptions, af as IntegrationServerClientRequestOptions, ag as IntegrationServerClientRoot, ah as IntegrationServerRequestLike, u as RouteAPIClient, w as ServerAPIClient, S as ServerAPIClientOptions, d as ServerAPIClientWithoutIntegrationsOptions, z as createAPIClient, y as createApiClients, U as createIntegrationApi, Q as createIntegrationClient, V as createIntegrationClients, X as createIntegrationServerClient, W as createIntegrations, E as createServerAPIClient, Y as getIntegrationAPIManifest, Z as integrationClients, _ as integrationsClient, $ as integrationsServer } from './api-client-C8d7BZNp.mjs';
-export { J as FarmAPIStream } from './route-C6UClI1z.mjs';
+import { r as ClientOptions, g as APIResult } from './api-client-Cx54IR5g.mjs';
+export { v as APIClient, h as APIClientError, b as APIClientOptions, i as APIClientSystemError, c as APIClientWithoutIntegrationsOptions, x as ApiClients, L as ClientHeaders, M as ClientLifecycleHooks, N as ClientRequestEvent, P as ClientResponseEvent, a9 as InferIntegrationOperationBody, aa as InferIntegrationOperationQuery, ab as InferIntegrationOperationResponse, a5 as IntegrationAPI, a0 as IntegrationClient, a1 as IntegrationClientAliases, a7 as IntegrationClientData, T as IntegrationClientError, a3 as IntegrationClientOptions, a4 as IntegrationClientRequestOptions, a2 as IntegrationClientRoot, a6 as IntegrationClients, a8 as IntegrationOperationResult, ac as IntegrationServerClient, ad as IntegrationServerClientAliases, ae as IntegrationServerClientOptions, af as IntegrationServerClientRequestOptions, ag as IntegrationServerClientRoot, ah as IntegrationServerRequestLike, u as RouteAPIClient, w as ServerAPIClient, S as ServerAPIClientOptions, d as ServerAPIClientWithoutIntegrationsOptions, z as createAPIClient, y as createApiClients, U as createIntegrationApi, Q as createIntegrationClient, V as createIntegrationClients, X as createIntegrationServerClient, W as createIntegrations, E as createServerAPIClient, Y as getIntegrationAPIManifest, Z as integrationClients, _ as integrationsClient, $ as integrationsServer } from './api-client-Cx54IR5g.mjs';
+export { K as FarmAPIStream } from './endpoint-DAc96i93.mjs';
 import React__default, { ComponentType, FormHTMLAttributes, FormEvent, AnchorHTMLAttributes, RefObject } from 'react';
 export { RouteActionTarget, UseActionFormProps, UseActionReturn, UseServerFnOptions, useAction } from './server-fn-client.mjs';
 export { UseServerQueryOptions, UseServerQueryResult, useServerQuery } from './server-query-client.mjs';
@@ -8,19 +8,20 @@ export { a as FarmClientCacheEntry, b as FarmClientCacheKey, F as FarmClientCach
 export { F as FarmIntegrationAPI, c as FarmIntegrationAPIBodyFormat, e as FarmIntegrationAPIMethod, f as FarmIntegrationAPIOperation, g as FarmIntegrationAPIResponseFormat, a as api, d as defineIntegrationAPI, b as defineIntegrationAPIOperation, i as endpoint } from './integration-api-BbaiokCC.mjs';
 export { UseThemeResult, useTheme } from './theme/client.mjs';
 import { FarmRouterPathParams, FarmRouterPathParam, FarmRouterBuildOptions, FarmRouterRouteInput } from './router.mjs';
-import { i as FarmViewTransitionMode, e as FarmNavigationBlockerContext, F as FarmNavigationState } from './spa-router-csKR9Ebj.mjs';
-export { a as FarmNavigateOptions, d as FarmNavigationBlocker, f as FarmNavigationListener, h as FarmNavigationLocation, S as SPARouter, g as getRouter, n as navigateTo, p as prefetch, b as pushState, r as readPageState, c as replaceState } from './spa-router-csKR9Ebj.mjs';
+import { i as FarmViewTransitionMode, e as FarmNavigationBlockerContext, F as FarmNavigationState } from './spa-router-CQWiYGxS.mjs';
+export { a as FarmNavigateOptions, d as FarmNavigationBlocker, f as FarmNavigationListener, h as FarmNavigationLocation, S as SPARouter, g as getRouter, n as navigateTo, p as prefetch, b as pushState, r as readPageState, c as replaceState } from './spa-router-CQWiYGxS.mjs';
 import { b as FarmI18nLocale } from './types-Z0aotQ8w.mjs';
 export { F as FarmChunkRecoveryOptions, i as installChunkErrorRecovery, a as isChunkLoadError } from './chunk-recovery-lnQFzcQP.mjs';
 export { a as FarmClientHydrationCompleteEvent, b as FarmClientHydrationEvent, d as FarmClientHydrationMode, e as FarmClientHydrationSession, f as FarmClientLocation, g as FarmClientNavigationAction, h as FarmClientNavigationErrorEvent, i as FarmClientNavigationEvent, j as FarmClientNavigationLoadedEvent, k as FarmClientNavigationResolvedEvent, l as FarmClientNavigationSession, m as FarmClientPerformanceEvent, n as FarmClientPlugin, o as FarmClientPluginCloseEvent, p as FarmClientPluginEnforce, q as FarmClientPluginErrorEvent, r as FarmClientPluginErrorPhase, F as FarmClientPluginManager, s as FarmClientPluginManagerOptions, t as FarmClientPluginMetadata, u as FarmClientPluginRegistration, v as FarmClientPluginRouter, w as FarmClientPluginSetupEvent, x as FarmClientPluginStateEvent, c as createClientPluginManager } from './lifecycle-DK06VuKP.mjs';
 export { S as ServerQueryFetchOptions, f as fetchServerQuery, p as prefetchServerQuery } from './server-query-runtime-aP52iuL5.mjs';
 export { getTheme, setTheme, toggleTheme } from './theme/runtime.mjs';
 import './cache.mjs';
+import './route-B0XrsrFk.mjs';
 import './server-fn.mjs';
 import './server-fn-error-DDh14a0V.mjs';
 import './server-query.mjs';
 import './types-DQnyD3VD.mjs';
-import './client-plugins-C1EgdoJM.mjs';
+import './client-plugins-JXXmZliS.mjs';
 import './renderer.mjs';
 import './deployment.mjs';
 import 'http';
@@ -46,7 +47,7 @@ import './font.mjs';
 import './after.mjs';
 import 'node:http';
 import './island-CfGru1MO.mjs';
-import './render-plan-CNUlzylR.mjs';
+import './render-plan-BLIfc4jt.mjs';
 
 type MutationStatus = "idle" | "pending" | "success" | "error";
 type AnyMutationTarget = (...args: any[]) => Promise<any>;

package/dist/client.d.ts

@@ -1,6 +1,6 @@
-import { r as ClientOptions, g as APIResult } from './api-client-BWrEbxfO.js';
-export { v as APIClient, h as APIClientError, b as APIClientOptions, i as APIClientSystemError, c as APIClientWithoutIntegrationsOptions, x as ApiClients, L as ClientHeaders, M as ClientLifecycleHooks, N as ClientRequestEvent, P as ClientResponseEvent, a9 as InferIntegrationOperationBody, aa as InferIntegrationOperationQuery, ab as InferIntegrationOperationResponse, a5 as IntegrationAPI, a0 as IntegrationClient, a1 as IntegrationClientAliases, a7 as IntegrationClientData, T as IntegrationClientError, a3 as IntegrationClientOptions, a4 as IntegrationClientRequestOptions, a2 as IntegrationClientRoot, a6 as IntegrationClients, a8 as IntegrationOperationResult, ac as IntegrationServerClient, ad as IntegrationServerClientAliases, ae as IntegrationServerClientOptions, af as IntegrationServerClientRequestOptions, ag as IntegrationServerClientRoot, ah as IntegrationServerRequestLike, u as RouteAPIClient, w as ServerAPIClient, S as ServerAPIClientOptions, d as ServerAPIClientWithoutIntegrationsOptions, z as createAPIClient, y as createApiClients, U as createIntegrationApi, Q as createIntegrationClient, V as createIntegrationClients, X as createIntegrationServerClient, W as createIntegrations, E as createServerAPIClient, Y as getIntegrationAPIManifest, Z as integrationClients, _ as integrationsClient, $ as integrationsServer } from './api-client-BWrEbxfO.js';
-export { J as FarmAPIStream } from './route-CHBaW55F.js';
+import { r as ClientOptions, g as APIResult } from './api-client-DykpaKcY.js';
+export { v as APIClient, h as APIClientError, b as APIClientOptions, i as APIClientSystemError, c as APIClientWithoutIntegrationsOptions, x as ApiClients, L as ClientHeaders, M as ClientLifecycleHooks, N as ClientRequestEvent, P as ClientResponseEvent, a9 as InferIntegrationOperationBody, aa as InferIntegrationOperationQuery, ab as InferIntegrationOperationResponse, a5 as IntegrationAPI, a0 as IntegrationClient, a1 as IntegrationClientAliases, a7 as IntegrationClientData, T as IntegrationClientError, a3 as IntegrationClientOptions, a4 as IntegrationClientRequestOptions, a2 as IntegrationClientRoot, a6 as IntegrationClients, a8 as IntegrationOperationResult, ac as IntegrationServerClient, ad as IntegrationServerClientAliases, ae as IntegrationServerClientOptions, af as IntegrationServerClientRequestOptions, ag as IntegrationServerClientRoot, ah as IntegrationServerRequestLike, u as RouteAPIClient, w as ServerAPIClient, S as ServerAPIClientOptions, d as ServerAPIClientWithoutIntegrationsOptions, z as createAPIClient, y as createApiClients, U as createIntegrationApi, Q as createIntegrationClient, V as createIntegrationClients, X as createIntegrationServerClient, W as createIntegrations, E as createServerAPIClient, Y as getIntegrationAPIManifest, Z as integrationClients, _ as integrationsClient, $ as integrationsServer } from './api-client-DykpaKcY.js';
+export { K as FarmAPIStream } from './endpoint-1zA994xL.js';
 import React__default, { ComponentType, FormHTMLAttributes, FormEvent, AnchorHTMLAttributes, RefObject } from 'react';
 export { RouteActionTarget, UseActionFormProps, UseActionReturn, UseServerFnOptions, useAction } from './server-fn-client.js';
 export { UseServerQueryOptions, UseServerQueryResult, useServerQuery } from './server-query-client.js';
@@ -8,19 +8,20 @@ export { a as FarmClientCacheEntry, b as FarmClientCacheKey, F as FarmClientCach
 export { F as FarmIntegrationAPI, c as FarmIntegrationAPIBodyFormat, e as FarmIntegrationAPIMethod, f as FarmIntegrationAPIOperation, g as FarmIntegrationAPIResponseFormat, a as api, d as defineIntegrationAPI, b as defineIntegrationAPIOperation, i as endpoint } from './integration-api-BbaiokCC.js';
 export { UseThemeResult, useTheme } from './theme/client.js';
 import { FarmRouterPathParams, FarmRouterPathParam, FarmRouterBuildOptions, FarmRouterRouteInput } from './router.js';
-import { i as FarmViewTransitionMode, e as FarmNavigationBlockerContext, F as FarmNavigationState } from './spa-router-Y_2FSJQK.js';
-export { a as FarmNavigateOptions, d as FarmNavigationBlocker, f as FarmNavigationListener, h as FarmNavigationLocation, S as SPARouter, g as getRouter, n as navigateTo, p as prefetch, b as pushState, r as readPageState, c as replaceState } from './spa-router-Y_2FSJQK.js';
+import { i as FarmViewTransitionMode, e as FarmNavigationBlockerContext, F as FarmNavigationState } from './spa-router-Wjiw-8hB.js';
+export { a as FarmNavigateOptions, d as FarmNavigationBlocker, f as FarmNavigationListener, h as FarmNavigationLocation, S as SPARouter, g as getRouter, n as navigateTo, p as prefetch, b as pushState, r as readPageState, c as replaceState } from './spa-router-Wjiw-8hB.js';
 import { b as FarmI18nLocale } from './types-Z0aotQ8w.js';
 export { F as FarmChunkRecoveryOptions, i as installChunkErrorRecovery, a as isChunkLoadError } from './chunk-recovery-lnQFzcQP.js';
 export { a as FarmClientHydrationCompleteEvent, b as FarmClientHydrationEvent, d as FarmClientHydrationMode, e as FarmClientHydrationSession, f as FarmClientLocation, g as FarmClientNavigationAction, h as FarmClientNavigationErrorEvent, i as FarmClientNavigationEvent, j as FarmClientNavigationLoadedEvent, k as FarmClientNavigationResolvedEvent, l as FarmClientNavigationSession, m as FarmClientPerformanceEvent, n as FarmClientPlugin, o as FarmClientPluginCloseEvent, p as FarmClientPluginEnforce, q as FarmClientPluginErrorEvent, r as FarmClientPluginErrorPhase, F as FarmClientPluginManager, s as FarmClientPluginManagerOptions, t as FarmClientPluginMetadata, u as FarmClientPluginRegistration, v as FarmClientPluginRouter, w as FarmClientPluginSetupEvent, x as FarmClientPluginStateEvent, c as createClientPluginManager } from './lifecycle-DK06VuKP.js';
 export { S as ServerQueryFetchOptions, f as fetchServerQuery, p as prefetchServerQuery } from './server-query-runtime-DXRNhX_3.js';
 export { getTheme, setTheme, toggleTheme } from './theme/runtime.js';
 import './cache.js';
+import './route-DOEpbyWZ.js';
 import './server-fn.js';
 import './server-fn-error-DDh14a0V.js';
 import './server-query.js';
 import './types-DQnyD3VD.js';
-import './client-plugins-CslwYp3E.js';
+import './client-plugins-C089bQhN.js';
 import './renderer.js';
 import './deployment.js';
 import 'http';
@@ -46,7 +47,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';
 
 type MutationStatus = "idle" | "pending" | "success" | "error";
 type AnyMutationTarget = (...args: any[]) => Promise<any>;

package/dist/client.mjs

@@ -13,7 +13,7 @@ import {
   storageClientCacheAdapter,
   useFetcher,
   useMutation
-} from "./chunk-LZK5CXDW.mjs";
+} from "./chunk-KLSSO6YD.mjs";
 import {
   installChunkErrorRecovery,
   isChunkLoadError
@@ -23,7 +23,7 @@ import {
 } from "./chunk-SHB3GYXI.mjs";
 import {
   useServerQuery
-} from "./chunk-GSDIZACQ.mjs";
+} from "./chunk-FG5H2VCJ.mjs";
 import {
   useBlocker,
   useNavigation,
@@ -49,12 +49,12 @@ import {
   integrationClients,
   integrationsClient,
   integrationsServer
-} from "./chunk-KUO3GBPK.mjs";
+} from "./chunk-L6V3P73N.mjs";
 import "./chunk-72AK62H5.mjs";
 import {
   fetchServerQuery,
   prefetchServerQuery
-} from "./chunk-76MNRHTS.mjs";
+} from "./chunk-UUYF3CHN.mjs";
 import {
   getTheme,
   setTheme,
@@ -77,7 +77,7 @@ import "./chunk-5HGR3W6O.mjs";
 import {
   getFarmClientDataCache,
   normalizeFarmClientCacheKey
-} from "./chunk-HKLRP3BN.mjs";
+} from "./chunk-5SPPCN5J.mjs";
 import "./chunk-QVYLBY73.mjs";
 import "./chunk-KGB5UXJJ.mjs";
 import {
@@ -100,7 +100,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/config.d.mts

@@ -1,6 +1,7 @@
-import { q as FarmUserConfig } from './client-plugins-C1EgdoJM.mjs';
+import { q as FarmUserConfig } from './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';
@@ -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/config.d.ts

@@ -1,6 +1,7 @@
-import { q as FarmUserConfig } from './client-plugins-CslwYp3E.js';
+import { q as FarmUserConfig } from './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';
@@ -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/cron.mjs

@@ -11,9 +11,9 @@ import {
   mergeScheduledTasks,
   prepareFarmCronForNitro,
   resolveCronConfig
-} from "./chunk-4L7SZOHZ.mjs";
-import "./chunk-ONUEYC6N.mjs";
+} from "./chunk-YHOCRI4H.mjs";
 import "./chunk-2UC36WAC.mjs";
+import "./chunk-ONUEYC6N.mjs";
 import "./chunk-KI3MESHB.mjs";
 import "./chunk-QVKYGNVM.mjs";
 import "./chunk-CQ6OSQ3K.mjs";

package/dist/{devtools-PCGEBRSC.mjs → devtools-UFVTMQX5.mjs}

@@ -1,24 +1,24 @@
 import {
   getDeployTargetForPreset
-} from "./chunk-GNTPTTLA.mjs";
+} from "./chunk-QGVJVSNX.mjs";
 import "./chunk-XZNTNMHT.mjs";
 import "./chunk-FZC7EEPM.mjs";
 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 {
   resolveCronConfig
-} from "./chunk-4L7SZOHZ.mjs";
+} from "./chunk-YHOCRI4H.mjs";
 import "./chunk-QCFFHV5H.mjs";
-import "./chunk-FOGLGRDS.mjs";
+import "./chunk-4OOBRCJX.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-AELACLOB.mjs";
 import "./chunk-JLCQGPXE.mjs";
 import "./chunk-FP2INE7H.mjs";

package/dist/docs.cjs

@@ -3468,6 +3468,7 @@ function createFarmDocsHandler(docs, options) {
     if (!isFarmDocsRequest(docs, request)) return null;
     const page = loadPage(contentDir, docs, request);
     if (!page) return null;
+    const negotiatesAccept = !requestUrl.pathname.endsWith(".md");
     if (shouldReturnMarkdown(request)) {
       const origin = new URL(request.url).origin;
       return omitFarmDocsHeadBody(
@@ -3482,7 +3483,8 @@ function createFarmDocsHandler(docs, options) {
             status: 200,
             headers: {
               "Content-Type": "text/markdown; charset=utf-8",
-              "Cache-Control": "public, max-age=60"
+              "Cache-Control": "public, max-age=60",
+              ...negotiatesAccept ? { Vary: "Accept" } : {}
             }
           }
         )
@@ -3512,6 +3514,7 @@ function createFarmDocsHandler(docs, options) {
           headers: {
             "Content-Type": "text/html; charset=utf-8",
             "Cache-Control": "public, s-maxage=60, stale-while-revalidate=300",
+            Vary: "Accept",
             ...fontPreloadHeader ? { Link: fontPreloadHeader } : {}
           }
         }
@@ -4635,11 +4638,25 @@ function normalizeMatcher(matcher) {
 }
 __name(normalizeMatcher, "normalizeMatcher");
 
+// src/utils/runtime-env.ts
+function getFarmRuntimeBindings() {
+  const runtimeBindings = globalThis.__env__;
+  return runtimeBindings && typeof runtimeBindings === "object" ? runtimeBindings : void 0;
+}
+__name(getFarmRuntimeBindings, "getFarmRuntimeBindings");
+function readFarmEnvironmentValue(name) {
+  const runtimeValue = getFarmRuntimeBindings()?.[name];
+  if (typeof runtimeValue === "string") return runtimeValue;
+  return typeof process !== "undefined" ? process.env?.[name] : void 0;
+}
+__name(readFarmEnvironmentValue, "readFarmEnvironmentValue");
+
 // src/workflows.ts
 var import_node_path6 = require("path");
 
 // src/env.ts
 var FARM_ENV_SYMBOL = /* @__PURE__ */ Symbol.for("farm.env");
+var FARM_ENV_RUNTIME_SYMBOL = /* @__PURE__ */ Symbol.for("farm.env.runtime");
 var farmEnvGlobal = globalThis;
 var currentEnv = getInitialEnv();
 var env = createEnvProxy("server");
@@ -4653,7 +4670,7 @@ function createEnvProxy(scope) {
           return void 0;
         }
         const env2 = getEnvScope(scope);
-        return env2[property];
+        return scope === "server" ? readServerEnvKey(env2, property) : env2[property];
       },
       ownKeys() {
         return Reflect.ownKeys(getEnvScope(scope));
@@ -4677,12 +4694,74 @@ function createEnvProxy(scope) {
 }
 __name(createEnvProxy, "createEnvProxy");
 function getEnvScope(scope) {
+  const env2 = getCurrentEnv();
   if (scope === "server") {
     assertServerEnvAccess();
+    readRuntimeServerEnv(env2);
   }
-  return getCurrentEnv()[scope] || {};
+  return env2[scope] || {};
 }
 __name(getEnvScope, "getEnvScope");
+function readServerEnvKey(server, key) {
+  const value = server[key];
+  if (value === void 0) {
+    const state = getCurrentEnv()[FARM_ENV_RUNTIME_SYMBOL];
+    if (state && key in state.pending && !state.warned.has(key)) {
+      state.warned.add(key);
+      console.warn(
+        `[Farm] Server env "${key}" was set when this app was built but is not set where the server runs, so it reads as undefined. Farm reads server env at runtime and does not store it in the build output; set "${key}" in the server's environment.`
+      );
+    }
+  }
+  return value;
+}
+__name(readServerEnvKey, "readServerEnvKey");
+function readRuntimeServerEnv(env2) {
+  const state = env2[FARM_ENV_RUNTIME_SYMBOL];
+  if (!state) return;
+  for (const [key, type] of Object.entries(state.pending)) {
+    const raw = readFarmEnvironmentValue(key);
+    if (raw === void 0) continue;
+    env2.server[key] = coerceRuntimeEnvValue(raw, type);
+    delete state.pending[key];
+  }
+}
+__name(readRuntimeServerEnv, "readRuntimeServerEnv");
+function coerceRuntimeEnvValue(raw, type) {
+  if (type === "number") {
+    const value = Number(raw);
+    return raw.trim() !== "" && Number.isFinite(value) ? value : raw;
+  }
+  if (type === "boolean") {
+    if (/^(true|1)$/i.test(raw.trim())) return true;
+    if (/^(false|0|)$/i.test(raw.trim())) return false;
+    return raw;
+  }
+  if (type === "json") {
+    try {
+      return JSON.parse(raw);
+    } catch {
+      return raw;
+    }
+  }
+  return raw;
+}
+__name(coerceRuntimeEnvValue, "coerceRuntimeEnvValue");
+function prepareEnv(env2) {
+  const normalized = normalizeResolvedEnv(env2);
+  const runtime = env2.runtime?.server;
+  if (!isRecord(runtime) || Object.keys(runtime).length === 0) return normalized;
+  const prepared = { server: { ...normalized.server }, public: normalized.public };
+  Object.defineProperty(prepared, FARM_ENV_RUNTIME_SYMBOL, {
+    value: {
+      pending: { ...runtime },
+      warned: /* @__PURE__ */ new Set()
+    },
+    enumerable: false
+  });
+  return prepared;
+}
+__name(prepareEnv, "prepareEnv");
 function assertServerEnvAccess() {
   if (typeof window !== "undefined") {
     throw new Error("Farm server env is not available in the browser. Use publicEnv.");
@@ -4713,7 +4792,7 @@ __name(getCurrentEnv, "getCurrentEnv");
 function getInjectedEnv() {
   try {
     if (typeof __FARM_ENV__ !== "undefined" && __FARM_ENV__) {
-      return normalizeResolvedEnv(__FARM_ENV__);
+      return prepareEnv(__FARM_ENV__);
     }
   } catch {
   }

package/dist/docs.mjs

@@ -4,7 +4,7 @@ import {
   createFarmDocsAdapterHandler,
   hasFarmDocsRuntimeAdapter,
   isFarmDocsAPIRequest
-} from "./chunk-NJ47VORC.mjs";
+} from "./chunk-UTBVHYS3.mjs";
 import {
   createFarmDocsHandler,
   discoverFarmDocsPages,
@@ -13,10 +13,10 @@ import {
   isFarmDocsRequest,
   loadFarmDocsPage,
   resolveFarmDocsContentDir
-} from "./chunk-MOQNHLTS.mjs";
+} from "./chunk-5QOEPUYE.mjs";
 import "./chunk-UP4CW6WP.mjs";
 import "./chunk-TFQG7TBC.mjs";
-import "./chunk-GNTPTTLA.mjs";
+import "./chunk-QGVJVSNX.mjs";
 import "./chunk-XZNTNMHT.mjs";
 import "./chunk-TVGP4BBZ.mjs";
 import "./chunk-FZC7EEPM.mjs";
@@ -24,16 +24,16 @@ 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-4OOBRCJX.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-AELACLOB.mjs";
 import "./chunk-JLCQGPXE.mjs";
 import "./chunk-FP2INE7H.mjs";