@farm.js/core 0.1.39 → 0.1.41

package/dist/internal/production-runtime.d.mts

@@ -1,28 +1,30 @@
 export { _runWithAfterRequest } from '../after.mjs';
-import { aJ as FarmMCPCatalogDetails, cx as ResolvedFarmConfig, dO as FarmIntegrationsUserConfig, fR as APIRequestRuntime, bT as ResolvedFarmMCPConfig, aE as FarmMCPServerRegistration, fS as FarmLlmsTxtLink, I as FarmConfig, _ as FarmContextFactoryInput } from '../client-plugins-CsCuCLBz.mjs';
-export { g0 as FarmLlmsTxtUserConfig, g1 as ResolvedFarmLlmsTxtConfig, g6 as applyFarmCspNonceToResponse, fW as collectFarmLlmsTxtPages, fU as createFarmAgentRobots, g7 as createFarmCspNonce, fX as createFarmDefaultLlmsTxt, fV as createFarmDefaultSitemap, f_ as createFarmLlmsFullRenderer, fY as createFarmLlmsMarkdownReader, fT as createFarmMetadataRouteResponse, g as getFarmRedirectError, i as isFarmNotFoundError, b as isFarmRedirectError, g2 as manageFarmDocumentPreloads, g3 as manageFarmHtmlPreloads, g4 as manageFarmLinkHeaderPreloads, aI as registerFarmMCPServer, fZ as renderFarmLlmsFullTxt, g5 as reportFarmPreloadWarnings, f$ as resolveFarmLlmsTxtConfig, g8 as resolveFarmSecurityConfig, g9 as stampFarmCspNonce } from '../client-plugins-CsCuCLBz.mjs';
-export { m as mergeRouteRenderingDirectiveConfig } from '../route-rendering-BHyOfXjD.mjs';
-import { R as ResolvedFarmServerConfig } from '../workflows-jZ4BcdoZ.mjs';
-export { a as FarmServerConfig, y as bufferFarmRequestBody, z as cloneFarmRequestWithContext, A as createFarmNodeRequestAbortSignal, B as createFarmRequestBodyErrorResponse, C as matchesFarmIfNoneMatch, E as readFarmRequestBody, G as readNodeRequestBody, H as resolveFarmServerConfig } from '../workflows-jZ4BcdoZ.mjs';
-export { _ as _getRequestReadCount, a as _runWithCurrentRequest, b as _runWithFarmCspNonce, g as getCurrentRequest, r as resolveFarmWebRequestOrigin } from '../request-DfE02G_A.mjs';
+import { bi as FarmMCPCatalogDetails, cn as ResolvedFarmConfig, dE as FarmIntegrationsUserConfig, aW as StaticPathParams, cm as ResolvedFarmMCPConfig, bd as FarmMCPServerRegistration, fF as FarmLlmsTxtLink, a as FarmPlugin, ay as FarmConfig, aK as FarmContextFactoryInput } from '../client-plugins-CkYwvDJ0.mjs';
+export { fP as FarmLlmsTxtUserConfig, fQ as ResolvedFarmLlmsTxtConfig, fV as applyFarmCspNonceToResponse, fJ as collectFarmLlmsTxtPages, fH as createFarmAgentRobots, fW as createFarmCspNonce, fK as createFarmDefaultLlmsTxt, fI as createFarmDefaultSitemap, fN as createFarmLlmsFullRenderer, fL as createFarmLlmsMarkdownReader, fG as createFarmMetadataRouteResponse, a0 as getFarmRedirectError, a1 as isFarmNotFoundError, a2 as isFarmRedirectError, fR as manageFarmDocumentPreloads, fS as manageFarmHtmlPreloads, fT as manageFarmLinkHeaderPreloads, bh as registerFarmMCPServer, fM as renderFarmLlmsFullTxt, fU as reportFarmPreloadWarnings, fO as resolveFarmLlmsTxtConfig, fX as resolveFarmSecurityConfig, fY as stampFarmCspNonce } from '../client-plugins-CkYwvDJ0.mjs';
+export { m as mergeRouteRenderingDirectiveConfig } from '../route-rendering-BCM1QzEf.mjs';
+import { R as ResolvedFarmServerConfig } from '../workflows-IWP1ddBm.mjs';
+export { a as FarmServerConfig, z as bufferFarmRequestBody, A as cloneFarmRequestWithContext, c as createFarmNodeRequestAbortSignal, B as createFarmRequestBodyErrorResponse, C as matchesFarmIfNoneMatch, E as readFarmRequestBody, G as readNodeRequestBody, H as resolveFarmServerConfig } from '../workflows-IWP1ddBm.mjs';
+export { _registerFarmStorageModules, disposeStorage as disposeFarmStorage, initStorage as initFarmStorage } from '../storage.mjs';
+export { _ as _getRequestReadCount, a as _runWithCurrentRequest, b as _runWithFarmCspNonce, g as getCurrentRequest, r as resolveFarmWebRequestOrigin } from '../request-BxBWigtl.mjs';
+import { A as APIRequestRuntime } from '../server-client-bridge-DKWDl5NB.mjs';
 export { configureFarmCache, createFarmCacheKey, getFarmDataCache, normalizeRevalidatePath } from '../cache.mjs';
 import { k as FarmI18nUserConfig, R as ResolvedFarmI18nConfig } from '../types-CnH8DOqo.mjs';
 export { c as createFarmLocaleCookie, g as getFarmLocaleVaryHeaders } from '../resolver-khasx3fU.mjs';
 import { F as FarmLocalePathConfig } from '../index-BJJfLxJo.mjs';
 export { l as localizeFarmHref, a as localizeFarmPathname, s as stripFarmLocaleFromPathname } from '../index-BJJfLxJo.mjs';
-import { F as FarmDefaultMCPPage } from '../agent-mcp-BhneNPb4.mjs';
-export { a as addMetadataImageReference, b as addMetadataMarkdownAlternate, g as collectFarmDefaultMCPPages, m as mergeMetadata, d as mergeModuleViewport, r as renderMetadataHead, e as renderViewportHead, h as resolveFarmDefaultMCPServer, f as resolveFarmNotFoundMetadata } from '../agent-mcp-BhneNPb4.mjs';
-export { _ as _runWithMiddlewareContext, c as _runWithMiddlewareData, e as applyProductionMiddlewareHeaders, d as createProductionMiddlewareRunner } from '../production-runtime-DfRP0cV0.mjs';
+import { F as FarmDefaultMCPPage } from '../agent-mcp-BOqIxJLI.mjs';
+export { a as addMetadataImageReference, b as addMetadataMarkdownAlternate, h as collectFarmDefaultMCPPages, m as mergeMetadata, d as mergeModuleViewport, r as renderMetadataHead, e as renderViewportHead, i as resolveFarmDefaultMCPServer, f as resolveFarmNotFoundMetadata, g as resolveMetadataTitle } from '../agent-mcp-BOqIxJLI.mjs';
+export { _ as _runWithMiddlewareContext, c as _runWithMiddlewareData, f as _withFarmGuardedResponseCache, e as applyProductionMiddlewareHeaders, d as createProductionMiddlewareRunner } from '../production-runtime-BTkXQdYy.mjs';
 export { L as configureFarmObservability, P as emitFarmEvent, Q as runWithFarmRequestSpan } from '../observability-CoXunYhS.mjs';
 export { f as createFarmInstrumentationLifecycle, r as resolveFarmInstrumentationRuntime } from '../instrumentation-runtime-CE06JLHZ.mjs';
 export { _setDefaultFarmThemeConfig, getTheme } from '../theme/server.mjs';
 import { c as FarmThemeRuntime, d as FarmThemeConfig, R as ResolvedFarmThemeConfig, a as FarmThemePreference } from '../types-DQnyD3VD.mjs';
 export { d as applyFarmBasePath, r as resolveFarmTrailingSlashRedirect, s as searchParamsToObject, b as setFarmBasePath, a as setFarmTrailingSlashPreference, c as stripFarmBasePath } from '../base-path-BU16ETmo.mjs';
-export { m as matchFarmPageRoute, p as parseRoutePath } from '../utils-BtYehqeU.mjs';
+export { m as matchFarmPageRoute, p as parseRoutePath } from '../utils-8wtTYiH4.mjs';
 import 'node:http';
 import '../lifecycle-DK06VuKP.mjs';
-import '../integration-api-0y4FXJpC.mjs';
-import '../endpoint-CCHFqyTE.mjs';
+import '../integration-api-DWyMmvrR.mjs';
+import '../endpoint-DGZRZHux.mjs';
 import '../renderer.mjs';
 import '../deployment.mjs';
 import 'http';
@@ -41,11 +43,11 @@ import 'vite';
 import '../cron.mjs';
 import '../env.mjs';
 import '../server-action-security.mjs';
+import '../layers-CM5i6T7z.mjs';
 import 'rolldown/utils';
 import 'rolldown';
-import '../image-config-Duob7wER.mjs';
+import '../image-config-BpH1q5R8.mjs';
 import '../font.mjs';
-import '../island-CfGru1MO.mjs';
 import '@opentelemetry/api';
 
 interface FarmAppManifestWebMCPTool {
@@ -166,6 +168,19 @@ declare function createFarmAppManifestResponse(request: Request, input: FarmAppM
     env?: Env;
 }): Promise<Response>;
 
+/**
+ * Whether config middleware may run for a path. This reuses the runtime matcher: a
+ * separate copy drifted (`/members/(.*)` kept its trailing slash and never met
+ * `/members/secret`), and a prerendered page was frozen into a public file that
+ * middleware never sees again.
+ *
+ * @internal
+ */
+declare function configMiddlewareMayHandlePath(config: ResolvedFarmConfig["middleware"], pathname: string): boolean;
+/** @internal File middleware counterpart of `configMiddlewareMayHandlePath`. */
+declare function appMiddlewareMayHandlePath(middlewareRoutes: readonly {
+    path: string;
+}[], pathname: string): boolean;
 /**
  * Whether a guard written for this page's path covers it: middleware.ts in the page's
  * folder or a parent below the root, a config middleware matcher, or an integration's
@@ -230,6 +245,13 @@ declare function createFarmLayoutSelector<T extends {
  */
 declare function isInRouteGroupScope(directory: string | null | undefined, scope: string | null): boolean;
 
+/**
+ * Static path materialization for SSG routes: `generateStaticParams()` values to URL paths.
+ * Free of Node APIs, so production runtimes can import it as well as the build.
+ */
+
+declare function materializeSSGRoutePath(routePattern: string, params: StaticPathParams): string;
+
 type FarmProductionLifecycleState = "starting" | "ready" | "draining" | "failed" | "closed";
 interface FarmProductionLifecycleOptions {
     server: ResolvedFarmServerConfig;
@@ -430,6 +452,15 @@ declare function createFarmApiCatalogResponse(method: string, input: FarmApiCata
 /** The request being answered, so the read can be reported as agent traffic. */
 request?: Request): Response;
 
+/**
+ * Whether a server plugin's `runtime.before` runs for every request without declaring
+ * `runtime.cache: "public"`. Like middleware, it may be a guard that let this visitor through,
+ * so the responses it lets pass stay out of shared caches.
+ *
+ * @internal
+ */
+declare function _farmPluginsKeepResponsesPrivate(plugins: readonly FarmPlugin[]): boolean;
+
 declare const FARM_ROUTE_CONTEXT_SYMBOL: unique symbol;
 type FarmRouteContextCarrier<TContext = unknown> = {
     [FARM_ROUTE_CONTEXT_SYMBOL]?: TContext;
@@ -504,4 +535,4 @@ declare function appendFarmRedirectQuery(destination: string, search: string): s
 
 declare function appendFarmLinkHeader(headers: Headers, value: string): void;
 
-export { _isFarmOwnedResponse, _markFarmOwnedResponse, _resolveCurrentCspNonce, _runWithAPIRequestRuntime, _withFarmResponseHeaders, appendFarmLinkHeader, appendFarmRedirectQuery, applyFarmPreviewRobotsTag, applyFarmThemeDocument, compareRouteSpecificity, createDefaultErrorMarkup, createFarmAiCatalogResponse, createFarmApiCatalogResponse, createFarmAppManifestResponse, createFarmLayoutSelector, createFarmLegacyRequest, createFarmProductionLifecycle, createFarmThemeDocumentParts, createLateNotFoundRecovery, createLateRedirectRecovery, ensureFarmDocumentMeta, farmPathGuardCoversEndpoint, farmPathGuardCoversPage, farmSecretsMatch, generateNativeMCPPluginSource, getDefaultErrorStatusText, getRoutePatternSpecificity, handleFarmDefaultMCPRequest, isInRouteGroupScope as isInFarmRouteGroupScope, listFarmMCPLlmsTxtLinks, renderFarmLegacyErrorHtml, renderFarmLegacyHtml, renderFarmLocaleAlternateLinks, resolveDefaultErrorStatus, resolveFarmI18nConfig, resolveFarmPreviewDeployment, resolveFarmRouteContext, serializeFarmInlineValue, withFarmRouteContext };
+export { _farmPluginsKeepResponsesPrivate, _isFarmOwnedResponse, _markFarmOwnedResponse, _resolveCurrentCspNonce, _runWithAPIRequestRuntime, _withFarmResponseHeaders, appMiddlewareMayHandlePath, appendFarmLinkHeader, appendFarmRedirectQuery, applyFarmPreviewRobotsTag, applyFarmThemeDocument, compareRouteSpecificity, configMiddlewareMayHandlePath, createDefaultErrorMarkup, createFarmAiCatalogResponse, createFarmApiCatalogResponse, createFarmAppManifestResponse, createFarmLayoutSelector, createFarmLegacyRequest, createFarmProductionLifecycle, createFarmThemeDocumentParts, createLateNotFoundRecovery, createLateRedirectRecovery, ensureFarmDocumentMeta, farmPathGuardCoversEndpoint, farmPathGuardCoversPage, farmSecretsMatch, generateNativeMCPPluginSource, getDefaultErrorStatusText, getRoutePatternSpecificity, handleFarmDefaultMCPRequest, isInRouteGroupScope as isInFarmRouteGroupScope, listFarmMCPLlmsTxtLinks, materializeSSGRoutePath, renderFarmLegacyErrorHtml, renderFarmLegacyHtml, renderFarmLocaleAlternateLinks, resolveDefaultErrorStatus, resolveFarmI18nConfig, resolveFarmPreviewDeployment, resolveFarmRouteContext, serializeFarmInlineValue, withFarmRouteContext };

package/dist/internal/production-runtime.d.ts

@@ -1,28 +1,30 @@
 export { _runWithAfterRequest } from '../after.js';
-import { aJ as FarmMCPCatalogDetails, cx as ResolvedFarmConfig, dO as FarmIntegrationsUserConfig, fR as APIRequestRuntime, bT as ResolvedFarmMCPConfig, aE as FarmMCPServerRegistration, fS as FarmLlmsTxtLink, I as FarmConfig, _ as FarmContextFactoryInput } from '../client-plugins-D0ke-Hc8.js';
-export { g0 as FarmLlmsTxtUserConfig, g1 as ResolvedFarmLlmsTxtConfig, g6 as applyFarmCspNonceToResponse, fW as collectFarmLlmsTxtPages, fU as createFarmAgentRobots, g7 as createFarmCspNonce, fX as createFarmDefaultLlmsTxt, fV as createFarmDefaultSitemap, f_ as createFarmLlmsFullRenderer, fY as createFarmLlmsMarkdownReader, fT as createFarmMetadataRouteResponse, g as getFarmRedirectError, i as isFarmNotFoundError, b as isFarmRedirectError, g2 as manageFarmDocumentPreloads, g3 as manageFarmHtmlPreloads, g4 as manageFarmLinkHeaderPreloads, aI as registerFarmMCPServer, fZ as renderFarmLlmsFullTxt, g5 as reportFarmPreloadWarnings, f$ as resolveFarmLlmsTxtConfig, g8 as resolveFarmSecurityConfig, g9 as stampFarmCspNonce } from '../client-plugins-D0ke-Hc8.js';
-export { m as mergeRouteRenderingDirectiveConfig } from '../route-rendering-C4oHbv6C.js';
-import { R as ResolvedFarmServerConfig } from '../workflows-jZ4BcdoZ.js';
-export { a as FarmServerConfig, y as bufferFarmRequestBody, z as cloneFarmRequestWithContext, A as createFarmNodeRequestAbortSignal, B as createFarmRequestBodyErrorResponse, C as matchesFarmIfNoneMatch, E as readFarmRequestBody, G as readNodeRequestBody, H as resolveFarmServerConfig } from '../workflows-jZ4BcdoZ.js';
-export { _ as _getRequestReadCount, a as _runWithCurrentRequest, b as _runWithFarmCspNonce, g as getCurrentRequest, r as resolveFarmWebRequestOrigin } from '../request-CEbHIIl4.js';
+import { bi as FarmMCPCatalogDetails, cn as ResolvedFarmConfig, dE as FarmIntegrationsUserConfig, aW as StaticPathParams, cm as ResolvedFarmMCPConfig, bd as FarmMCPServerRegistration, fF as FarmLlmsTxtLink, a as FarmPlugin, ay as FarmConfig, aK as FarmContextFactoryInput } from '../client-plugins-DfeKd0sD.js';
+export { fP as FarmLlmsTxtUserConfig, fQ as ResolvedFarmLlmsTxtConfig, fV as applyFarmCspNonceToResponse, fJ as collectFarmLlmsTxtPages, fH as createFarmAgentRobots, fW as createFarmCspNonce, fK as createFarmDefaultLlmsTxt, fI as createFarmDefaultSitemap, fN as createFarmLlmsFullRenderer, fL as createFarmLlmsMarkdownReader, fG as createFarmMetadataRouteResponse, a0 as getFarmRedirectError, a1 as isFarmNotFoundError, a2 as isFarmRedirectError, fR as manageFarmDocumentPreloads, fS as manageFarmHtmlPreloads, fT as manageFarmLinkHeaderPreloads, bh as registerFarmMCPServer, fM as renderFarmLlmsFullTxt, fU as reportFarmPreloadWarnings, fO as resolveFarmLlmsTxtConfig, fX as resolveFarmSecurityConfig, fY as stampFarmCspNonce } from '../client-plugins-DfeKd0sD.js';
+export { m as mergeRouteRenderingDirectiveConfig } from '../route-rendering-BLZT0IP0.js';
+import { R as ResolvedFarmServerConfig } from '../workflows-IWP1ddBm.js';
+export { a as FarmServerConfig, z as bufferFarmRequestBody, A as cloneFarmRequestWithContext, c as createFarmNodeRequestAbortSignal, B as createFarmRequestBodyErrorResponse, C as matchesFarmIfNoneMatch, E as readFarmRequestBody, G as readNodeRequestBody, H as resolveFarmServerConfig } from '../workflows-IWP1ddBm.js';
+export { _registerFarmStorageModules, disposeStorage as disposeFarmStorage, initStorage as initFarmStorage } from '../storage.js';
+export { _ as _getRequestReadCount, a as _runWithCurrentRequest, b as _runWithFarmCspNonce, g as getCurrentRequest, r as resolveFarmWebRequestOrigin } from '../request-fciwmd3n.js';
+import { A as APIRequestRuntime } from '../server-client-bridge-DKWDl5NB.js';
 export { configureFarmCache, createFarmCacheKey, getFarmDataCache, normalizeRevalidatePath } from '../cache.js';
 import { k as FarmI18nUserConfig, R as ResolvedFarmI18nConfig } from '../types-CnH8DOqo.js';
 export { c as createFarmLocaleCookie, g as getFarmLocaleVaryHeaders } from '../resolver-DadfRL6F.js';
 import { F as FarmLocalePathConfig } from '../index-CwoOP-MW.js';
 export { l as localizeFarmHref, a as localizeFarmPathname, s as stripFarmLocaleFromPathname } from '../index-CwoOP-MW.js';
-import { F as FarmDefaultMCPPage } from '../agent-mcp-HcTYQmNX.js';
-export { a as addMetadataImageReference, b as addMetadataMarkdownAlternate, g as collectFarmDefaultMCPPages, m as mergeMetadata, d as mergeModuleViewport, r as renderMetadataHead, e as renderViewportHead, h as resolveFarmDefaultMCPServer, f as resolveFarmNotFoundMetadata } from '../agent-mcp-HcTYQmNX.js';
-export { _ as _runWithMiddlewareContext, c as _runWithMiddlewareData, e as applyProductionMiddlewareHeaders, d as createProductionMiddlewareRunner } from '../production-runtime-BaI3WHnV.js';
+import { F as FarmDefaultMCPPage } from '../agent-mcp-D0eZKfci.js';
+export { a as addMetadataImageReference, b as addMetadataMarkdownAlternate, h as collectFarmDefaultMCPPages, m as mergeMetadata, d as mergeModuleViewport, r as renderMetadataHead, e as renderViewportHead, i as resolveFarmDefaultMCPServer, f as resolveFarmNotFoundMetadata, g as resolveMetadataTitle } from '../agent-mcp-D0eZKfci.js';
+export { _ as _runWithMiddlewareContext, c as _runWithMiddlewareData, f as _withFarmGuardedResponseCache, e as applyProductionMiddlewareHeaders, d as createProductionMiddlewareRunner } from '../production-runtime-DFC7pgbp.js';
 export { L as configureFarmObservability, P as emitFarmEvent, Q as runWithFarmRequestSpan } from '../observability-CoXunYhS.js';
 export { f as createFarmInstrumentationLifecycle, r as resolveFarmInstrumentationRuntime } from '../instrumentation-runtime-CE06JLHZ.js';
 export { _setDefaultFarmThemeConfig, getTheme } from '../theme/server.js';
 import { c as FarmThemeRuntime, d as FarmThemeConfig, R as ResolvedFarmThemeConfig, a as FarmThemePreference } from '../types-DQnyD3VD.js';
 export { d as applyFarmBasePath, r as resolveFarmTrailingSlashRedirect, s as searchParamsToObject, b as setFarmBasePath, a as setFarmTrailingSlashPreference, c as stripFarmBasePath } from '../base-path-BU16ETmo.js';
-export { m as matchFarmPageRoute, p as parseRoutePath } from '../utils-Dhuqwmd2.js';
+export { m as matchFarmPageRoute, p as parseRoutePath } from '../utils-Dxbh6Hgj.js';
 import 'node:http';
 import '../lifecycle-DK06VuKP.js';
-import '../integration-api-BPJo5oXb.js';
-import '../endpoint-CA-TNX60.js';
+import '../integration-api-BuPHMeKz.js';
+import '../endpoint-BOE0IAaG.js';
 import '../renderer.js';
 import '../deployment.js';
 import 'http';
@@ -41,11 +43,11 @@ import 'vite';
 import '../cron.js';
 import '../env.js';
 import '../server-action-security.js';
+import '../layers-CM5i6T7z.js';
 import 'rolldown/utils';
 import 'rolldown';
-import '../image-config-Duob7wER.js';
+import '../image-config-BpH1q5R8.js';
 import '../font.js';
-import '../island-CfGru1MO.js';
 import '@opentelemetry/api';
 
 interface FarmAppManifestWebMCPTool {
@@ -166,6 +168,19 @@ declare function createFarmAppManifestResponse(request: Request, input: FarmAppM
     env?: Env;
 }): Promise<Response>;
 
+/**
+ * Whether config middleware may run for a path. This reuses the runtime matcher: a
+ * separate copy drifted (`/members/(.*)` kept its trailing slash and never met
+ * `/members/secret`), and a prerendered page was frozen into a public file that
+ * middleware never sees again.
+ *
+ * @internal
+ */
+declare function configMiddlewareMayHandlePath(config: ResolvedFarmConfig["middleware"], pathname: string): boolean;
+/** @internal File middleware counterpart of `configMiddlewareMayHandlePath`. */
+declare function appMiddlewareMayHandlePath(middlewareRoutes: readonly {
+    path: string;
+}[], pathname: string): boolean;
 /**
  * Whether a guard written for this page's path covers it: middleware.ts in the page's
  * folder or a parent below the root, a config middleware matcher, or an integration's
@@ -230,6 +245,13 @@ declare function createFarmLayoutSelector<T extends {
  */
 declare function isInRouteGroupScope(directory: string | null | undefined, scope: string | null): boolean;
 
+/**
+ * Static path materialization for SSG routes: `generateStaticParams()` values to URL paths.
+ * Free of Node APIs, so production runtimes can import it as well as the build.
+ */
+
+declare function materializeSSGRoutePath(routePattern: string, params: StaticPathParams): string;
+
 type FarmProductionLifecycleState = "starting" | "ready" | "draining" | "failed" | "closed";
 interface FarmProductionLifecycleOptions {
     server: ResolvedFarmServerConfig;
@@ -430,6 +452,15 @@ declare function createFarmApiCatalogResponse(method: string, input: FarmApiCata
 /** The request being answered, so the read can be reported as agent traffic. */
 request?: Request): Response;
 
+/**
+ * Whether a server plugin's `runtime.before` runs for every request without declaring
+ * `runtime.cache: "public"`. Like middleware, it may be a guard that let this visitor through,
+ * so the responses it lets pass stay out of shared caches.
+ *
+ * @internal
+ */
+declare function _farmPluginsKeepResponsesPrivate(plugins: readonly FarmPlugin[]): boolean;
+
 declare const FARM_ROUTE_CONTEXT_SYMBOL: unique symbol;
 type FarmRouteContextCarrier<TContext = unknown> = {
     [FARM_ROUTE_CONTEXT_SYMBOL]?: TContext;
@@ -504,4 +535,4 @@ declare function appendFarmRedirectQuery(destination: string, search: string): s
 
 declare function appendFarmLinkHeader(headers: Headers, value: string): void;
 
-export { _isFarmOwnedResponse, _markFarmOwnedResponse, _resolveCurrentCspNonce, _runWithAPIRequestRuntime, _withFarmResponseHeaders, appendFarmLinkHeader, appendFarmRedirectQuery, applyFarmPreviewRobotsTag, applyFarmThemeDocument, compareRouteSpecificity, createDefaultErrorMarkup, createFarmAiCatalogResponse, createFarmApiCatalogResponse, createFarmAppManifestResponse, createFarmLayoutSelector, createFarmLegacyRequest, createFarmProductionLifecycle, createFarmThemeDocumentParts, createLateNotFoundRecovery, createLateRedirectRecovery, ensureFarmDocumentMeta, farmPathGuardCoversEndpoint, farmPathGuardCoversPage, farmSecretsMatch, generateNativeMCPPluginSource, getDefaultErrorStatusText, getRoutePatternSpecificity, handleFarmDefaultMCPRequest, isInRouteGroupScope as isInFarmRouteGroupScope, listFarmMCPLlmsTxtLinks, renderFarmLegacyErrorHtml, renderFarmLegacyHtml, renderFarmLocaleAlternateLinks, resolveDefaultErrorStatus, resolveFarmI18nConfig, resolveFarmPreviewDeployment, resolveFarmRouteContext, serializeFarmInlineValue, withFarmRouteContext };
+export { _farmPluginsKeepResponsesPrivate, _isFarmOwnedResponse, _markFarmOwnedResponse, _resolveCurrentCspNonce, _runWithAPIRequestRuntime, _withFarmResponseHeaders, appMiddlewareMayHandlePath, appendFarmLinkHeader, appendFarmRedirectQuery, applyFarmPreviewRobotsTag, applyFarmThemeDocument, compareRouteSpecificity, configMiddlewareMayHandlePath, createDefaultErrorMarkup, createFarmAiCatalogResponse, createFarmApiCatalogResponse, createFarmAppManifestResponse, createFarmLayoutSelector, createFarmLegacyRequest, createFarmProductionLifecycle, createFarmThemeDocumentParts, createLateNotFoundRecovery, createLateRedirectRecovery, ensureFarmDocumentMeta, farmPathGuardCoversEndpoint, farmPathGuardCoversPage, farmSecretsMatch, generateNativeMCPPluginSource, getDefaultErrorStatusText, getRoutePatternSpecificity, handleFarmDefaultMCPRequest, isInRouteGroupScope as isInFarmRouteGroupScope, listFarmMCPLlmsTxtLinks, materializeSSGRoutePath, renderFarmLegacyErrorHtml, renderFarmLegacyHtml, renderFarmLocaleAlternateLinks, resolveDefaultErrorStatus, resolveFarmI18nConfig, resolveFarmPreviewDeployment, resolveFarmRouteContext, serializeFarmInlineValue, withFarmRouteContext };

package/dist/internal/production-runtime.mjs

@@ -1,21 +1,24 @@
 import {
   handleFarmDefaultMCPRequest
-} from "../chunk-EPYU2EBL.mjs";
+} from "../chunk-IF4NU2NG.mjs";
 import {
   createFarmLayoutSelector,
   generateNativeMCPPluginSource
-} from "../chunk-677THUVP.mjs";
+} from "../chunk-4C7KTKX7.mjs";
 import {
+  _withFarmGuardedResponseCache,
   applyProductionMiddlewareHeaders,
   createProductionMiddlewareRunner
-} from "../chunk-PVZE2JGJ.mjs";
+} from "../chunk-SGB4IW7K.mjs";
 import {
   createFarmInstrumentationLifecycle,
   resolveFarmInstrumentationRuntime
 } from "../chunk-H77NVNJ2.mjs";
 import "../chunk-OT6ZEW74.mjs";
 import {
+  appMiddlewareMayHandlePath,
   applyFarmThemeDocument,
+  configMiddlewareMayHandlePath,
   createDefaultErrorMarkup,
   createFarmAiCatalogResponse,
   createFarmApiCatalogResponse,
@@ -32,14 +35,18 @@ import {
   listFarmMCPLlmsTxtLinks,
   renderFarmLocaleAlternateLinks,
   resolveDefaultErrorStatus
-} from "../chunk-GKBWWRBG.mjs";
+} from "../chunk-SVPGWJZF.mjs";
 import {
   collectFarmDefaultMCPPages,
   resolveFarmDefaultMCPServer
-} from "../chunk-P664ZVTV.mjs";
+} from "../chunk-4ZZNPK25.mjs";
 import {
+  _farmPluginsKeepResponsesPrivate
+} from "../chunk-Y5RG6B7S.mjs";
+import {
+  materializeSSGRoutePath,
   mergeRouteRenderingDirectiveConfig
-} from "../chunk-DAO7JGTS.mjs";
+} from "../chunk-COABSY3U.mjs";
 import {
   resolveFarmPreviewDeployment
 } from "../chunk-BOYNDCZL.mjs";
@@ -47,7 +54,7 @@ import "../chunk-XAXTTBUT.mjs";
 import {
   _setDefaultFarmThemeConfig,
   getTheme
-} from "../chunk-CUM5NYL5.mjs";
+} from "../chunk-FIAPD365.mjs";
 import {
   applyFarmPreviewRobotsTag,
   createFarmAgentRobots,
@@ -56,7 +63,7 @@ import {
   manageFarmHtmlPreloads,
   manageFarmLinkHeaderPreloads,
   reportFarmPreloadWarnings
-} from "../chunk-WFRT7JPX.mjs";
+} from "../chunk-BYQVROIP.mjs";
 import {
   collectFarmLlmsTxtPages,
   createFarmDefaultLlmsTxt,
@@ -64,30 +71,37 @@ import {
   createFarmLlmsMarkdownReader,
   renderFarmLlmsFullTxt,
   resolveFarmLlmsTxtConfig
-} from "../chunk-HD5CF3OE.mjs";
+} from "../chunk-ETPEZLS3.mjs";
 import {
   applyFarmCspNonceToResponse,
   createFarmCspNonce,
   resolveFarmSecurityConfig,
   stampFarmCspNonce
-} from "../chunk-U6QLDL3G.mjs";
-import "../chunk-VNGH5MLF.mjs";
-import "../chunk-MVL2RAJW.mjs";
+} from "../chunk-7UEEHAW7.mjs";
+import "../chunk-I6UVKUYK.mjs";
+import "../chunk-KYN5ODF6.mjs";
 import {
   farmSecretsMatch
 } from "../chunk-2UC36WAC.mjs";
+import {
+  _registerFarmStorageModules,
+  disposeStorage,
+  initStorage
+} from "../chunk-JGHCKIRI.mjs";
 import "../chunk-AELACLOB.mjs";
 import {
   resolveFarmRouteContext,
   withFarmRouteContext
 } from "../chunk-SEJ5N6SL.mjs";
-import "../chunk-ATSDUUFK.mjs";
+import "../chunk-AX7S67YV.mjs";
+import "../chunk-H3EGVQE5.mjs";
 import "../chunk-44SYJEG3.mjs";
+import "../chunk-JOW4HDJO.mjs";
 import {
   _runWithMiddlewareContext,
   _runWithMiddlewareData
-} from "../chunk-SKVTP5PR.mjs";
-import "../chunk-P3PLW4FR.mjs";
+} from "../chunk-HANGSYMB.mjs";
+import "../chunk-HKFBMHCD.mjs";
 import {
   _runWithAPIRequestRuntime
 } from "../chunk-R3DS7A2T.mjs";
@@ -102,19 +116,9 @@ import {
   configureFarmCache,
   getFarmDataCache,
   normalizeRevalidatePath
-} from "../chunk-MSSFIQGM.mjs";
-import "../chunk-FZ6YYU2W.mjs";
+} from "../chunk-B2GSRB3P.mjs";
+import "../chunk-MGMF4VP7.mjs";
 import "../chunk-FP2INE7H.mjs";
-import {
-  bufferFarmRequestBody,
-  cloneFarmRequestWithContext,
-  createFarmNodeRequestAbortSignal,
-  createFarmRequestBodyErrorResponse,
-  matchesFarmIfNoneMatch,
-  readFarmRequestBody,
-  readNodeRequestBody,
-  resolveFarmServerConfig
-} from "../chunk-ZMMBIVQM.mjs";
 import {
   resolveFarmI18nConfig
 } from "../chunk-BCMSYSN2.mjs";
@@ -129,10 +133,21 @@ import {
   configureFarmObservability,
   emitFarmEvent,
   runWithFarmRequestSpan
-} from "../chunk-FUZEBRP3.mjs";
+} from "../chunk-4GP3XZ4Z.mjs";
 import "../chunk-Z2RZJZIZ.mjs";
 import "../chunk-BTHHUD7Q.mjs";
-import "../chunk-SOP2EAA6.mjs";
+import {
+  bufferFarmRequestBody,
+  cloneFarmRequestWithContext,
+  createFarmNodeRequestAbortSignal,
+  createFarmRequestBodyErrorResponse,
+  matchesFarmIfNoneMatch,
+  readFarmRequestBody,
+  readNodeRequestBody,
+  resolveFarmServerConfig
+} from "../chunk-ZZGQD7A4.mjs";
+import "../chunk-P7XDC7UJ.mjs";
+import "../chunk-VLPII2JJ.mjs";
 import {
   resolveFarmTrailingSlashRedirect,
   setFarmTrailingSlashPreference
@@ -154,7 +169,8 @@ import {
   mergeModuleViewport,
   renderMetadataHead,
   renderViewportHead,
-  resolveFarmNotFoundMetadata
+  resolveFarmNotFoundMetadata,
+  resolveMetadataTitle
 } from "../chunk-73WX6PRY.mjs";
 import "../chunk-SKNL7VA2.mjs";
 import "../chunk-C4NCTZLM.mjs";
@@ -182,11 +198,11 @@ import {
   _runWithFarmCspNonce,
   getCurrentRequest,
   resolveFarmWebRequestOrigin
-} from "../chunk-POSPE3IO.mjs";
+} from "../chunk-X3NGFVRF.mjs";
 import "../chunk-CQ6OSQ3K.mjs";
 import {
   _resolveCurrentCspNonce
-} from "../chunk-QRKIMN7T.mjs";
+} from "../chunk-6LVRDOAW.mjs";
 import {
   localizeFarmHref,
   localizeFarmPathname,
@@ -504,9 +520,11 @@ function appendFarmLinkHeader(headers, value) {
 }
 __name(appendFarmLinkHeader, "appendFarmLinkHeader");
 export {
+  _farmPluginsKeepResponsesPrivate,
   _getRequestReadCount,
   _isFarmOwnedResponse,
   _markFarmOwnedResponse,
+  _registerFarmStorageModules,
   _resolveCurrentCspNonce,
   _runWithAPIRequestRuntime,
   _runWithAfterRequest,
@@ -515,9 +533,11 @@ export {
   _runWithMiddlewareContext,
   _runWithMiddlewareData,
   _setDefaultFarmThemeConfig,
+  _withFarmGuardedResponseCache,
   _withFarmResponseHeaders,
   addMetadataImageReference,
   addMetadataMarkdownAlternate,
+  appMiddlewareMayHandlePath,
   appendFarmLinkHeader,
   appendFarmRedirectQuery,
   applyFarmBasePath,
@@ -530,6 +550,7 @@ export {
   collectFarmDefaultMCPPages,
   collectFarmLlmsTxtPages,
   compareRouteSpecificity,
+  configMiddlewareMayHandlePath,
   configureFarmCache,
   configureFarmObservability,
   createDefaultErrorMarkup,
@@ -555,6 +576,7 @@ export {
   createLateNotFoundRecovery,
   createLateRedirectRecovery,
   createProductionMiddlewareRunner,
+  disposeStorage as disposeFarmStorage,
   emitFarmEvent,
   ensureFarmDocumentMeta,
   farmPathGuardCoversEndpoint,
@@ -569,6 +591,7 @@ export {
   getRoutePatternSpecificity,
   getTheme,
   handleFarmDefaultMCPRequest,
+  initStorage as initFarmStorage,
   isFarmNotFoundError,
   isFarmRedirectError,
   isInRouteGroupScope as isInFarmRouteGroupScope,
@@ -580,6 +603,7 @@ export {
   manageFarmLinkHeaderPreloads,
   matchRoute as matchFarmPageRoute,
   matchesFarmIfNoneMatch,
+  materializeSSGRoutePath,
   mergeMetadata,
   mergeModuleViewport,
   mergeRouteRenderingDirectiveConfig,
@@ -607,6 +631,7 @@ export {
   resolveFarmServerConfig,
   resolveFarmTrailingSlashRedirect,
   resolveFarmWebRequestOrigin,
+  resolveMetadataTitle,
   runWithFarmRequestSpan,
   searchParamsToObject,
   serializeFarmInlineValue,

package/dist/layers-CM5i6T7z.d.mts

@@ -0,0 +1,55 @@
+import * as rolldown_utils from 'rolldown/utils';
+import { Plugin } from 'rolldown';
+
+type OxcTransform = (typeof rolldown_utils)["transform"];
+type FarmLayerEntry = string;
+interface ResolvedFarmLayer {
+    /** The value used in `extends`. */
+    source: string;
+    /** Stable name used by the `#layers/<name>` alias. */
+    name: string;
+    /** Absolute layer package or directory root. */
+    root: string;
+    /** Source directory relative to the layer root. */
+    srcDir: string;
+    /** Resolved layer config file when one exists. */
+    configFile?: string;
+}
+interface FarmSourceRoot {
+    name: string;
+    root: string;
+    srcDir: string;
+    layer: boolean;
+}
+interface ResolveFarmLayersOptions {
+    root: string;
+    mode: "development" | "production";
+}
+interface FarmLayerResolution<TConfig extends Record<string, any>> {
+    config: TConfig & {
+        extends?: readonly FarmLayerEntry[];
+        layers: ResolvedFarmLayer[];
+    };
+    layers: ResolvedFarmLayer[];
+}
+declare function resolveFarmLayers<TConfig extends Record<string, any>>(projectConfig: TConfig, options: ResolveFarmLayersOptions): Promise<FarmLayerResolution<TConfig>>;
+declare function getFarmSourceRoots(config: {
+    root?: string;
+    srcDir?: string;
+    layers?: readonly ResolvedFarmLayer[];
+}): FarmSourceRoot[];
+declare function getFarmAppDirectories(config: {
+    root?: string;
+    srcDir?: string;
+    layers?: readonly ResolvedFarmLayer[];
+}): string[];
+declare function getFarmLayerAliases(layers: readonly ResolvedFarmLayer[] | undefined): Record<string, string>;
+declare function createFarmConfigResolutionPlugin(options: {
+    transform: OxcTransform;
+}): Plugin;
+declare function loadFarmConfigFile<TConfig = Record<string, any>>(configPath: string, options: {
+    root: string;
+    cacheRoot?: string;
+}): Promise<TConfig>;
+
+export { type FarmLayerEntry as F, type ResolvedFarmLayer as R, type FarmSourceRoot as a, type ResolveFarmLayersOptions as b, type FarmLayerResolution as c, getFarmAppDirectories as d, getFarmLayerAliases as e, createFarmConfigResolutionPlugin as f, getFarmSourceRoots as g, loadFarmConfigFile as l, resolveFarmLayers as r };

package/dist/layers-CM5i6T7z.d.ts

@@ -0,0 +1,55 @@
+import * as rolldown_utils from 'rolldown/utils';
+import { Plugin } from 'rolldown';
+
+type OxcTransform = (typeof rolldown_utils)["transform"];
+type FarmLayerEntry = string;
+interface ResolvedFarmLayer {
+    /** The value used in `extends`. */
+    source: string;
+    /** Stable name used by the `#layers/<name>` alias. */
+    name: string;
+    /** Absolute layer package or directory root. */
+    root: string;
+    /** Source directory relative to the layer root. */
+    srcDir: string;
+    /** Resolved layer config file when one exists. */
+    configFile?: string;
+}
+interface FarmSourceRoot {
+    name: string;
+    root: string;
+    srcDir: string;
+    layer: boolean;
+}
+interface ResolveFarmLayersOptions {
+    root: string;
+    mode: "development" | "production";
+}
+interface FarmLayerResolution<TConfig extends Record<string, any>> {
+    config: TConfig & {
+        extends?: readonly FarmLayerEntry[];
+        layers: ResolvedFarmLayer[];
+    };
+    layers: ResolvedFarmLayer[];
+}
+declare function resolveFarmLayers<TConfig extends Record<string, any>>(projectConfig: TConfig, options: ResolveFarmLayersOptions): Promise<FarmLayerResolution<TConfig>>;
+declare function getFarmSourceRoots(config: {
+    root?: string;
+    srcDir?: string;
+    layers?: readonly ResolvedFarmLayer[];
+}): FarmSourceRoot[];
+declare function getFarmAppDirectories(config: {
+    root?: string;
+    srcDir?: string;
+    layers?: readonly ResolvedFarmLayer[];
+}): string[];
+declare function getFarmLayerAliases(layers: readonly ResolvedFarmLayer[] | undefined): Record<string, string>;
+declare function createFarmConfigResolutionPlugin(options: {
+    transform: OxcTransform;
+}): Plugin;
+declare function loadFarmConfigFile<TConfig = Record<string, any>>(configPath: string, options: {
+    root: string;
+    cacheRoot?: string;
+}): Promise<TConfig>;
+
+export { type FarmLayerEntry as F, type ResolvedFarmLayer as R, type FarmSourceRoot as a, type ResolveFarmLayersOptions as b, type FarmLayerResolution as c, getFarmAppDirectories as d, getFarmLayerAliases as e, createFarmConfigResolutionPlugin as f, getFarmSourceRoots as g, loadFarmConfigFile as l, resolveFarmLayers as r };

package/dist/markdown.cjs

@@ -17,10 +17,10 @@
 
 
 
-var _chunkSGBJ247Qcjs = require('./chunk-SGBJ247Q.cjs');
-require('./chunk-J63ZH5OQ.cjs');
+var _chunkD4ROBNTKcjs = require('./chunk-D4ROBNTK.cjs');
+require('./chunk-X3GMHKO3.cjs');
 require('./chunk-75RZHGLS.cjs');
-require('./chunk-E3UK5IIB.cjs');
+require('./chunk-GS3WR5HX.cjs');
 require('./chunk-KNBBQHO2.cjs');
 require('./chunk-G7HXGLEC.cjs');
 require('./chunk-S3A45T7F.cjs');
@@ -47,4 +47,4 @@ require('./chunk-S3JO3N4H.cjs');
 
 
 
-exports.FARM_MARKDOWN_CONTENT_TYPE = _chunkSGBJ247Qcjs.FARM_MARKDOWN_CONTENT_TYPE; exports.FARM_MARKDOWN_PAGE_CHECK_HEADER = _chunkSGBJ247Qcjs.FARM_MARKDOWN_PAGE_CHECK_HEADER; exports._getFarmMarkdownPageCheckToken = _chunkSGBJ247Qcjs._getFarmMarkdownPageCheckToken; exports._isFarmMarkdownPageCheck = _chunkSGBJ247Qcjs._isFarmMarkdownPageCheck; exports.applyMarkdownNegotiationHeaders = _chunkSGBJ247Qcjs.applyMarkdownNegotiationHeaders; exports.createFarmMarkdownErrorBody = _chunkSGBJ247Qcjs.createFarmMarkdownErrorBody; exports.createMarkdownMirrorResponse = _chunkSGBJ247Qcjs.createMarkdownMirrorResponse; exports.extractFarmPageActions = _chunkSGBJ247Qcjs.extractFarmPageActions; exports.farmAcceptQuality = _chunkSGBJ247Qcjs.farmAcceptQuality; exports.farmRequestWantsMarkdown = _chunkSGBJ247Qcjs.farmRequestWantsMarkdown; exports.getFarmMarkdownAlternatePath = _chunkSGBJ247Qcjs.getFarmMarkdownAlternatePath; exports.getFarmMarkdownMirrorPath = _chunkSGBJ247Qcjs.getFarmMarkdownMirrorPath; exports.htmlToMarkdown = _chunkSGBJ247Qcjs.htmlToMarkdown; exports.isFarmMarkdownMirrorExposed = _chunkSGBJ247Qcjs.isFarmMarkdownMirrorExposed; exports.matchesFarmMarkdownRoutePattern = _chunkSGBJ247Qcjs.matchesFarmMarkdownRoutePattern; exports.requestAcceptsMarkdown = _chunkSGBJ247Qcjs.requestAcceptsMarkdown; exports.resolveMarkdownConfig = _chunkSGBJ247Qcjs.resolveMarkdownConfig; exports.resolveMarkdownMirrorTarget = _chunkSGBJ247Qcjs.resolveMarkdownMirrorTarget;
+exports.FARM_MARKDOWN_CONTENT_TYPE = _chunkD4ROBNTKcjs.FARM_MARKDOWN_CONTENT_TYPE; exports.FARM_MARKDOWN_PAGE_CHECK_HEADER = _chunkD4ROBNTKcjs.FARM_MARKDOWN_PAGE_CHECK_HEADER; exports._getFarmMarkdownPageCheckToken = _chunkD4ROBNTKcjs._getFarmMarkdownPageCheckToken; exports._isFarmMarkdownPageCheck = _chunkD4ROBNTKcjs._isFarmMarkdownPageCheck; exports.applyMarkdownNegotiationHeaders = _chunkD4ROBNTKcjs.applyMarkdownNegotiationHeaders; exports.createFarmMarkdownErrorBody = _chunkD4ROBNTKcjs.createFarmMarkdownErrorBody; exports.createMarkdownMirrorResponse = _chunkD4ROBNTKcjs.createMarkdownMirrorResponse; exports.extractFarmPageActions = _chunkD4ROBNTKcjs.extractFarmPageActions; exports.farmAcceptQuality = _chunkD4ROBNTKcjs.farmAcceptQuality; exports.farmRequestWantsMarkdown = _chunkD4ROBNTKcjs.farmRequestWantsMarkdown; exports.getFarmMarkdownAlternatePath = _chunkD4ROBNTKcjs.getFarmMarkdownAlternatePath; exports.getFarmMarkdownMirrorPath = _chunkD4ROBNTKcjs.getFarmMarkdownMirrorPath; exports.htmlToMarkdown = _chunkD4ROBNTKcjs.htmlToMarkdown; exports.isFarmMarkdownMirrorExposed = _chunkD4ROBNTKcjs.isFarmMarkdownMirrorExposed; exports.matchesFarmMarkdownRoutePattern = _chunkD4ROBNTKcjs.matchesFarmMarkdownRoutePattern; exports.requestAcceptsMarkdown = _chunkD4ROBNTKcjs.requestAcceptsMarkdown; exports.resolveMarkdownConfig = _chunkD4ROBNTKcjs.resolveMarkdownConfig; exports.resolveMarkdownMirrorTarget = _chunkD4ROBNTKcjs.resolveMarkdownMirrorTarget;