@farm.js/core 0.1.0-beta.95 → 0.1.0-beta.97

package/dist/{client-mcMC334J.d.mts → client-DWoLZ3QU.d.mts}

@@ -1,7 +1,7 @@
-import { an as FarmIntegrationAPI, ao as FarmIntegrationAPIOperation } from './client-plugins-BvClItiL.mjs';
-import { a as FarmClientCacheKey } from './client-cache-CopR_MaI.mjs';
+import { F as FarmIntegrationAPI, a as FarmIntegrationAPIOperation } from './integration-api-BT024nuJ.mjs';
+import { a as FarmClientCacheKey, b as FarmClientCacheEntry } from './client-cache-CCK-fCe0.mjs';
 import { DefinedCacheKey, RouteDataCacheKey, InferCacheKeyData } from './cache.mjs';
-import { F as FarmAPIStream, R as RoutePathParams } from './route-Cq3aObmj.mjs';
+import { F as FarmAPIStream, R as RoutePathParams } from './route-CvEr4Uc9.mjs';
 
 /** Instance defaults, resolved once per call before cache lookup or dispatch. */
 type ClientHeaders = Record<string, string> | (() => Record<string, string> | Promise<Record<string, string>>);
@@ -297,6 +297,8 @@ type CacheOptions = {
     staleTime?: number;
     gcTime?: number;
     dedupeMs?: number;
+    /** Allow the configured client cache persistence adapter to store this read. */
+    persist?: boolean;
 };
 type RetryOptions = {
     count?: number;
@@ -404,7 +406,11 @@ type InferEndpointInput<T> = T extends {
     __types: {
         query: infer TQuery;
     };
-} ? Simplify<BodyInputProp<InferEndpointBody<T>> & QueryInputProp<TQuery> & (T extends {
+} ? Simplify<BodyInputProp<InferEndpointBody<T>> & QueryInputProp<T extends {
+    __types: {
+        inputQuery: infer I;
+    };
+} ? I : TQuery> & (T extends {
     __routeParams: infer P;
 } ? keyof P extends never ? {
     params?: never;
@@ -548,5 +554,46 @@ declare function getAPIRouteRefMetadata(value: unknown): APIRouteRefMetadata | n
 declare function createServerAPIClient<TEndpoints extends Record<string, any>>(endpoints: TEndpoints): TEndpoints;
 declare function createServerAPIClient<TEndpoints extends Record<string, any>>(endpoints: TEndpoints, options: ServerAPIClientWithoutIntegrationsOptions): TEndpoints;
 declare function createServerAPIClient<TEndpoints extends Record<string, any>, TIntegrations extends Record<string, any> = {}>(endpoints: TEndpoints, options?: ServerAPIClientOptions): ServerAPIClient<TEndpoints, TIntegrations>;
+declare const API_CACHE_REFETCH: unique symbol;
+type CacheEntry = FarmClientCacheEntry<any> & {
+    [API_CACHE_REFETCH]?: () => void;
+};
+type OptimisticSnapshot = {
+    key: string;
+    stack: OptimisticStack;
+    layer: OptimisticLayer;
+};
+type OptimisticStack = {
+    entry?: CacheEntry;
+    layers: OptimisticLayer[];
+    renderedEntry?: CacheEntry;
+    invalidatedAt?: number;
+};
+type OptimisticLayer = {
+    updaters: Array<(prev: any) => any>;
+    updatedAt: number;
+    staleAt: number;
+    gcAt?: number;
+    committed?: boolean;
+};
+/**
+ * @internal Apply key-targeted optimistic updates to the shared client cache
+ * for a server-function mutation. Route-reference update tuples need an API
+ * caller's route metadata and are skipped here; use structured cache keys.
+ */
+declare function applyServerFnOptimisticUpdates(updates: readonly OptimisticUpdate[], now?: number): OptimisticSnapshot[];
+/**
+ * @internal Settle a server-function mutation's optimistic snapshots with the
+ * API client's semantics: commit on success, rollback on failure with
+ * `rollbackOnError`, and mark-stale on failure without it.
+ */
+declare function settleServerFnOptimisticUpdates(snapshots: OptimisticSnapshot[], outcome: "commit" | "rollback" | "invalidate"): void;
+/**
+ * @internal Resolve a server-function mutation's invalidate targets to cache
+ * keys. Route-reference and path targets need an API caller's identity and are
+ * skipped; use structured cache keys. Keys are applied through the shared
+ * invalidation bus, matching server-declared `invalidates`.
+ */
+declare function resolveServerFnInvalidateTargets(invalidate: InvalidateOptions): string[];
 
-export { type IntegrationAPI as $, type APIRouteRefMetadata as A, type APIRouteManifest as B, type CacheKey as C, type ClientHeaders as D, type ClientLifecycleHooks as E, FARM_API_ROUTE_REF_SYMBOL as F, type ClientRequestEvent as G, type ClientResponseEvent as H, type InvalidateTarget as I, createIntegrationClient as J, IntegrationClientError as K, createIntegrationApi as L, createIntegrationClients as M, createIntegrations as N, type OptimisticUpdate as O, createIntegrationServerClient as P, getIntegrationAPIManifest as Q, type RequestEvent as R, type ServerAPIClientOptions as S, integrationClients as T, integrationsClient as U, integrationsServer as V, type IntegrationClient as W, type IntegrationClientAliases as X, type IntegrationClientRoot as Y, type IntegrationClientOptions as Z, type IntegrationClientRequestOptions as _, FARM_API_ROUTE_META_SYMBOL as a, type IntegrationClients as a0, type IntegrationClientData as a1, type IntegrationOperationResult as a2, type InferIntegrationOperationBody as a3, type InferIntegrationOperationQuery as a4, type InferIntegrationOperationResponse as a5, type IntegrationServerClient as a6, type IntegrationServerClientAliases as a7, type IntegrationServerClientOptions as a8, type IntegrationServerClientRequestOptions as a9, type IntegrationServerClientRoot as aa, type IntegrationServerRequestLike as ab, type APIClientOptions as b, type APIClientWithoutIntegrationsOptions as c, type ServerAPIClientWithoutIntegrationsOptions as d, type StatusPhase as e, type StatusEvent as f, type APIResult as g, APIClientError as h, type APIClientSystemError as i, type ResponseEvent as j, type CachePolicy as k, type CacheScope as l, type CacheOptions as m, type RetryOptions as n, type InvalidateOptions as o, type OptimisticOptions as p, type ClientOptions as q, type RouteAPIClient as r, type APIClient as s, type ServerAPIClient as t, type ApiClients as u, createApiClients as v, createAPIClient as w, isAPIRouteRef as x, getAPIRouteRefMetadata as y, createServerAPIClient as z };
+export { type IntegrationClientRoot as $, type APIRouteRefMetadata as A, applyServerFnOptimisticUpdates as B, type CacheKey as C, settleServerFnOptimisticUpdates as D, resolveServerFnInvalidateTargets as E, FARM_API_ROUTE_REF_SYMBOL as F, type APIRouteManifest as G, type ClientHeaders as H, type InvalidateTarget as I, type ClientLifecycleHooks as J, type ClientRequestEvent as K, type ClientResponseEvent as L, createIntegrationClient as M, IntegrationClientError as N, type OptimisticUpdate as O, createIntegrationApi as P, createIntegrationClients as Q, type RetryOptions as R, type ServerAPIClientOptions as S, createIntegrations as T, createIntegrationServerClient as U, getIntegrationAPIManifest as V, integrationClients as W, integrationsClient as X, integrationsServer as Y, type IntegrationClient as Z, type IntegrationClientAliases as _, FARM_API_ROUTE_META_SYMBOL as a, type IntegrationClientOptions as a0, type IntegrationClientRequestOptions as a1, type IntegrationAPI as a2, type IntegrationClients as a3, type IntegrationClientData as a4, type IntegrationOperationResult as a5, type InferIntegrationOperationBody as a6, type InferIntegrationOperationQuery as a7, type InferIntegrationOperationResponse as a8, type IntegrationServerClient as a9, type IntegrationServerClientAliases as aa, type IntegrationServerClientOptions as ab, type IntegrationServerClientRequestOptions as ac, type IntegrationServerClientRoot as ad, type IntegrationServerRequestLike as ae, type APIClientOptions as b, type APIClientWithoutIntegrationsOptions as c, type ServerAPIClientWithoutIntegrationsOptions as d, type StatusPhase as e, type StatusEvent as f, type APIResult as g, APIClientError as h, type APIClientSystemError as i, type RequestEvent as j, type ResponseEvent as k, type CachePolicy as l, type CacheScope as m, type CacheOptions as n, type InvalidateOptions as o, type OptimisticOptions as p, type ClientOptions as q, type RouteAPIClient as r, type APIClient as s, type ServerAPIClient as t, type ApiClients as u, createApiClients as v, createAPIClient as w, isAPIRouteRef as x, getAPIRouteRefMetadata as y, createServerAPIClient as z };

package/dist/{client-d5ONQ-Pd.d.ts → client-DuQuQC1h.d.ts}

@@ -1,7 +1,7 @@
-import { an as FarmIntegrationAPI, ao as FarmIntegrationAPIOperation } from './client-plugins-B9Sq-iMg.js';
-import { a as FarmClientCacheKey } from './client-cache-Djy_TlE8.js';
+import { F as FarmIntegrationAPI, a as FarmIntegrationAPIOperation } from './integration-api-BT024nuJ.js';
+import { a as FarmClientCacheKey, b as FarmClientCacheEntry } from './client-cache-BMxuFqwH.js';
 import { DefinedCacheKey, RouteDataCacheKey, InferCacheKeyData } from './cache.js';
-import { F as FarmAPIStream, R as RoutePathParams } from './route-Y8lfz1wF.js';
+import { F as FarmAPIStream, R as RoutePathParams } from './route-4pd-EVtw.js';
 
 /** Instance defaults, resolved once per call before cache lookup or dispatch. */
 type ClientHeaders = Record<string, string> | (() => Record<string, string> | Promise<Record<string, string>>);
@@ -297,6 +297,8 @@ type CacheOptions = {
     staleTime?: number;
     gcTime?: number;
     dedupeMs?: number;
+    /** Allow the configured client cache persistence adapter to store this read. */
+    persist?: boolean;
 };
 type RetryOptions = {
     count?: number;
@@ -404,7 +406,11 @@ type InferEndpointInput<T> = T extends {
     __types: {
         query: infer TQuery;
     };
-} ? Simplify<BodyInputProp<InferEndpointBody<T>> & QueryInputProp<TQuery> & (T extends {
+} ? Simplify<BodyInputProp<InferEndpointBody<T>> & QueryInputProp<T extends {
+    __types: {
+        inputQuery: infer I;
+    };
+} ? I : TQuery> & (T extends {
     __routeParams: infer P;
 } ? keyof P extends never ? {
     params?: never;
@@ -548,5 +554,46 @@ declare function getAPIRouteRefMetadata(value: unknown): APIRouteRefMetadata | n
 declare function createServerAPIClient<TEndpoints extends Record<string, any>>(endpoints: TEndpoints): TEndpoints;
 declare function createServerAPIClient<TEndpoints extends Record<string, any>>(endpoints: TEndpoints, options: ServerAPIClientWithoutIntegrationsOptions): TEndpoints;
 declare function createServerAPIClient<TEndpoints extends Record<string, any>, TIntegrations extends Record<string, any> = {}>(endpoints: TEndpoints, options?: ServerAPIClientOptions): ServerAPIClient<TEndpoints, TIntegrations>;
+declare const API_CACHE_REFETCH: unique symbol;
+type CacheEntry = FarmClientCacheEntry<any> & {
+    [API_CACHE_REFETCH]?: () => void;
+};
+type OptimisticSnapshot = {
+    key: string;
+    stack: OptimisticStack;
+    layer: OptimisticLayer;
+};
+type OptimisticStack = {
+    entry?: CacheEntry;
+    layers: OptimisticLayer[];
+    renderedEntry?: CacheEntry;
+    invalidatedAt?: number;
+};
+type OptimisticLayer = {
+    updaters: Array<(prev: any) => any>;
+    updatedAt: number;
+    staleAt: number;
+    gcAt?: number;
+    committed?: boolean;
+};
+/**
+ * @internal Apply key-targeted optimistic updates to the shared client cache
+ * for a server-function mutation. Route-reference update tuples need an API
+ * caller's route metadata and are skipped here; use structured cache keys.
+ */
+declare function applyServerFnOptimisticUpdates(updates: readonly OptimisticUpdate[], now?: number): OptimisticSnapshot[];
+/**
+ * @internal Settle a server-function mutation's optimistic snapshots with the
+ * API client's semantics: commit on success, rollback on failure with
+ * `rollbackOnError`, and mark-stale on failure without it.
+ */
+declare function settleServerFnOptimisticUpdates(snapshots: OptimisticSnapshot[], outcome: "commit" | "rollback" | "invalidate"): void;
+/**
+ * @internal Resolve a server-function mutation's invalidate targets to cache
+ * keys. Route-reference and path targets need an API caller's identity and are
+ * skipped; use structured cache keys. Keys are applied through the shared
+ * invalidation bus, matching server-declared `invalidates`.
+ */
+declare function resolveServerFnInvalidateTargets(invalidate: InvalidateOptions): string[];
 
-export { type IntegrationAPI as $, type APIRouteRefMetadata as A, type APIRouteManifest as B, type CacheKey as C, type ClientHeaders as D, type ClientLifecycleHooks as E, FARM_API_ROUTE_REF_SYMBOL as F, type ClientRequestEvent as G, type ClientResponseEvent as H, type InvalidateTarget as I, createIntegrationClient as J, IntegrationClientError as K, createIntegrationApi as L, createIntegrationClients as M, createIntegrations as N, type OptimisticUpdate as O, createIntegrationServerClient as P, getIntegrationAPIManifest as Q, type RequestEvent as R, type ServerAPIClientOptions as S, integrationClients as T, integrationsClient as U, integrationsServer as V, type IntegrationClient as W, type IntegrationClientAliases as X, type IntegrationClientRoot as Y, type IntegrationClientOptions as Z, type IntegrationClientRequestOptions as _, FARM_API_ROUTE_META_SYMBOL as a, type IntegrationClients as a0, type IntegrationClientData as a1, type IntegrationOperationResult as a2, type InferIntegrationOperationBody as a3, type InferIntegrationOperationQuery as a4, type InferIntegrationOperationResponse as a5, type IntegrationServerClient as a6, type IntegrationServerClientAliases as a7, type IntegrationServerClientOptions as a8, type IntegrationServerClientRequestOptions as a9, type IntegrationServerClientRoot as aa, type IntegrationServerRequestLike as ab, type APIClientOptions as b, type APIClientWithoutIntegrationsOptions as c, type ServerAPIClientWithoutIntegrationsOptions as d, type StatusPhase as e, type StatusEvent as f, type APIResult as g, APIClientError as h, type APIClientSystemError as i, type ResponseEvent as j, type CachePolicy as k, type CacheScope as l, type CacheOptions as m, type RetryOptions as n, type InvalidateOptions as o, type OptimisticOptions as p, type ClientOptions as q, type RouteAPIClient as r, type APIClient as s, type ServerAPIClient as t, type ApiClients as u, createApiClients as v, createAPIClient as w, isAPIRouteRef as x, getAPIRouteRefMetadata as y, createServerAPIClient as z };
+export { type IntegrationClientRoot as $, type APIRouteRefMetadata as A, applyServerFnOptimisticUpdates as B, type CacheKey as C, settleServerFnOptimisticUpdates as D, resolveServerFnInvalidateTargets as E, FARM_API_ROUTE_REF_SYMBOL as F, type APIRouteManifest as G, type ClientHeaders as H, type InvalidateTarget as I, type ClientLifecycleHooks as J, type ClientRequestEvent as K, type ClientResponseEvent as L, createIntegrationClient as M, IntegrationClientError as N, type OptimisticUpdate as O, createIntegrationApi as P, createIntegrationClients as Q, type RetryOptions as R, type ServerAPIClientOptions as S, createIntegrations as T, createIntegrationServerClient as U, getIntegrationAPIManifest as V, integrationClients as W, integrationsClient as X, integrationsServer as Y, type IntegrationClient as Z, type IntegrationClientAliases as _, FARM_API_ROUTE_META_SYMBOL as a, type IntegrationClientOptions as a0, type IntegrationClientRequestOptions as a1, type IntegrationAPI as a2, type IntegrationClients as a3, type IntegrationClientData as a4, type IntegrationOperationResult as a5, type InferIntegrationOperationBody as a6, type InferIntegrationOperationQuery as a7, type InferIntegrationOperationResponse as a8, type IntegrationServerClient as a9, type IntegrationServerClientAliases as aa, type IntegrationServerClientOptions as ab, type IntegrationServerClientRequestOptions as ac, type IntegrationServerClientRoot as ad, type IntegrationServerRequestLike as ae, type APIClientOptions as b, type APIClientWithoutIntegrationsOptions as c, type ServerAPIClientWithoutIntegrationsOptions as d, type StatusPhase as e, type StatusEvent as f, type APIResult as g, APIClientError as h, type APIClientSystemError as i, type RequestEvent as j, type ResponseEvent as k, type CachePolicy as l, type CacheScope as m, type CacheOptions as n, type InvalidateOptions as o, type OptimisticOptions as p, type ClientOptions as q, type RouteAPIClient as r, type APIClient as s, type ServerAPIClient as t, type ApiClients as u, createApiClients as v, createAPIClient as w, isAPIRouteRef as x, getAPIRouteRefMetadata as y, createServerAPIClient as z };

package/dist/client-cache-BMxuFqwH.d.ts

@@ -0,0 +1,18 @@
+import { RouteDataCacheKey } from './cache.js';
+
+type FarmClientCacheKey = RouteDataCacheKey;
+type FarmClientCacheStatus = "idle" | "pending" | "success" | "error";
+type FarmClientCacheEntry<TData = unknown> = {
+    data: TData;
+    updatedAt: number;
+    staleAt: number;
+    gcAt?: number;
+    invalidatedAt?: number;
+    status?: FarmClientCacheStatus;
+    error?: Error | null;
+    fetching?: boolean;
+    /** Marks an entry the persistence layer may write to its adapter. */
+    persist?: boolean;
+};
+
+export type { FarmClientCacheStatus as F, FarmClientCacheKey as a, FarmClientCacheEntry as b };

package/dist/client-cache-CCK-fCe0.d.mts

@@ -0,0 +1,18 @@
+import { RouteDataCacheKey } from './cache.mjs';
+
+type FarmClientCacheKey = RouteDataCacheKey;
+type FarmClientCacheStatus = "idle" | "pending" | "success" | "error";
+type FarmClientCacheEntry<TData = unknown> = {
+    data: TData;
+    updatedAt: number;
+    staleAt: number;
+    gcAt?: number;
+    invalidatedAt?: number;
+    status?: FarmClientCacheStatus;
+    error?: Error | null;
+    fetching?: boolean;
+    /** Marks an entry the persistence layer may write to its adapter. */
+    persist?: boolean;
+};
+
+export type { FarmClientCacheStatus as F, FarmClientCacheKey as a, FarmClientCacheEntry as b };

package/dist/{client-plugins-BvClItiL.d.mts → client-plugins-B6-07YmP.d.mts}

@@ -1,9 +1,10 @@
 import { n as FarmClientPlugin } from './lifecycle-De0vQG45.mjs';
-import { Z as PluginRoutes, P as PluginRoutesFactory } from './route-Cq3aObmj.mjs';
+import { Z as PluginRoutes, P as PluginRoutesFactory } from './route-CvEr4Uc9.mjs';
 import { FarmRenderer } from './renderer.mjs';
 import { IncomingMessage, ServerResponse } from 'http';
 import { d as FarmStorageUserConfig } from './types-Cc8l9IqS.mjs';
 import React__default, { ComponentType, ReactNode } from 'react';
+import { F as FarmIntegrationAPI, f as FarmIntegrationAPIMethod, e as FarmIntegrationAPIBodyFormat, a as FarmIntegrationAPIOperation, g as FarmIntegrationAPIResponseFormat, h as FarmIntegrationRouteOperationCarrier, I as InferIntegrationAPIFromRoutes } from './integration-api-BT024nuJ.mjs';
 import { OrmClient, SchemaDefinition, ModelDefinition, FieldBuilder, JsonValue, AnyModelDefinition, SchemaModels } from '@farming-labs/orm';
 import { a as FarmDocsUserConfig, F as FarmDocsResolvedConfig } from './types-CKwggz9n.mjs';
 import { FarmMarkdownUserConfig, FarmMarkdownResolvedConfig } from './markdown.mjs';
@@ -24,102 +25,6 @@ import { FarmLayoutFonts } from './font.mjs';
 import { _withAfterNodeMiddleware } from './after.mjs';
 import { F as FarmIslandStrategy } from './island-CfGru1MO.mjs';
 
-type FarmIntegrationAPIMethod = "GET" | "QUERY" | "POST" | "PUT" | "PATCH" | "DELETE" | "OPTIONS" | "HEAD";
-type FarmIntegrationAPIBodyFormat = "json" | "form" | "none";
-type FarmIntegrationAPIResponseFormat = "json" | "text" | "response";
-interface FarmIntegrationAPIOperation<TBody = never, TQuery = never, TResponse = unknown, TServer extends boolean = false, TMethod extends FarmIntegrationAPIMethod = FarmIntegrationAPIMethod> {
-    readonly kind: "farm-integration-api-operation";
-    path: string;
-    method: TMethod;
-    bodyFormat?: FarmIntegrationAPIBodyFormat;
-    responseFormat?: FarmIntegrationAPIResponseFormat;
-    headers?: Record<string, string>;
-    credentials?: RequestCredentials;
-    isServer?: TServer;
-    __pathless?: boolean;
-    __types?: {
-        body: TBody;
-        query: TQuery;
-        response: TResponse;
-    };
-}
-type FarmIntegrationAPI = {
-    [key: string]: FarmIntegrationAPI | FarmIntegrationAPIOperation<any, any, any, any, any>;
-};
-type FarmIntegrationRouteOperationCarrier<TPath extends string = string, TOperation extends FarmIntegrationAPIOperation<any, any, any, any, any> = FarmIntegrationAPIOperation<any, any, any, any, any>> = {
-    path: TPath;
-    __operation: TOperation;
-};
-type IntegrationAPIBuilderOptions<TServer extends boolean = false> = Omit<FarmIntegrationAPIOperation<any, any, any, TServer>, "kind" | "method" | "path" | "__pathless" | "__types">;
-declare function defineIntegrationAPIOperation<TBody = never, TQuery = never, TResponse = unknown, TServer extends boolean = false, TMethod extends FarmIntegrationAPIMethod = FarmIntegrationAPIMethod>(operation: Omit<FarmIntegrationAPIOperation<TBody, TQuery, TResponse, TServer, TMethod>, "kind" | "__types">): FarmIntegrationAPIOperation<TBody, TQuery, TResponse, TServer, TMethod>;
-declare function defineIntegrationAPI<TAPI extends FarmIntegrationAPI>(api: TAPI): TAPI;
-declare function get<TResponse = unknown, TServer extends boolean = false>(path: string, options?: IntegrationAPIBuilderOptions<TServer>): FarmIntegrationAPIOperation<never, never, TResponse, TServer, "GET">;
-declare function get<TQuery = never, TResponse = unknown, TServer extends boolean = false>(path: string, options?: IntegrationAPIBuilderOptions<TServer>): FarmIntegrationAPIOperation<never, TQuery, TResponse, TServer, "GET">;
-declare function get<TResponse = unknown, TServer extends boolean = false>(options?: IntegrationAPIBuilderOptions<TServer>): FarmIntegrationAPIOperation<never, never, TResponse, TServer, "GET">;
-declare function get<TQuery = never, TResponse = unknown, TServer extends boolean = false>(options?: IntegrationAPIBuilderOptions<TServer>): FarmIntegrationAPIOperation<never, TQuery, TResponse, TServer, "GET">;
-type RouteOperationsToAPI<TOperations extends readonly FarmIntegrationAPIOperation<any, any, any, any, any>[]> = {
-    [TMethod in Lowercase<TOperations[number]["method"] & string>]: Extract<TOperations[number], {
-        method: Uppercase<TMethod>;
-    }>;
-};
-type StripRouteClientPrefix<TPath extends string> = TPath extends `/api/${string}/${infer TRest}` ? TRest : TPath extends `/${string}/${infer TRest}` ? TRest : TPath extends `/${infer TRest}` ? TRest : TPath;
-type NormalizeRouteSegment<TSegment extends string> = TSegment extends `[...${infer TName}]` ? TName : TSegment extends `[${infer TName}]` ? TName : TSegment extends `${infer TName}(${string}` ? TName : CamelCaseRouteSegment<TSegment>;
-type CamelCaseRouteSegment<TSegment extends string> = TSegment extends `${infer THead}-${infer TTail}` ? `${THead}${Capitalize<CamelCaseRouteSegment<TTail>>}` : TSegment;
-type RouteNamespaceFromPath<TPath extends string, TOperation extends FarmIntegrationAPIOperation<any, any, any, any, any>> = TPath extends `${infer THead}/${infer TTail}` ? {
-    [TKey in NormalizeRouteSegment<THead>]: RouteNamespaceFromPath<TTail, TOperation>;
-} : {
-    [TKey in NormalizeRouteSegment<TPath>]: {
-        [TMethod in Lowercase<TOperation["method"] & string>]: TOperation;
-    };
-};
-type UnionToIntersection<TUnion> = (TUnion extends unknown ? (value: TUnion) => void : never) extends (value: infer TIntersection) => void ? TIntersection : never;
-type ExpandRecursively<TValue> = TValue extends (...args: any[]) => any ? TValue : TValue extends object ? {
-    [TKey in keyof TValue]: ExpandRecursively<TValue[TKey]>;
-} : TValue;
-type RoutesToAPI<TRoutes extends readonly FarmIntegrationRouteOperationCarrier<string, any>[]> = ExpandRecursively<UnionToIntersection<TRoutes[number] extends FarmIntegrationRouteOperationCarrier<infer TPath, infer TOperation> ? RouteNamespaceFromPath<StripRouteClientPrefix<TPath>, TOperation> : never>>;
-type InferIntegrationAPIFromRoutes<TRoutes extends readonly FarmIntegrationRouteOperationCarrier<string, any>[]> = RoutesToAPI<TRoutes>;
-declare function route<TAPI extends FarmIntegrationAPI>(path: string, definition: TAPI): TAPI;
-declare function route<TOperations extends readonly FarmIntegrationAPIOperation<any, any, any, any, any>[]>(path: string, ...operations: TOperations): RouteOperationsToAPI<TOperations>;
-declare function fromRoutes<TRoutes extends readonly FarmIntegrationRouteOperationCarrier<string, any>[]>(routes: TRoutes): RoutesToAPI<TRoutes>;
-declare const api: {
-    get: typeof get;
-    route: typeof route;
-    fromRoutes: typeof fromRoutes;
-    query<TBody = never, TResponse = unknown, TQuery = never, TServer extends boolean = false>(pathOrOptions?: string | IntegrationAPIBuilderOptions<TServer>, maybeOptions?: IntegrationAPIBuilderOptions<TServer>): FarmIntegrationAPIOperation<TBody, TQuery, TResponse, TServer, "QUERY">;
-    post<TBody = never, TResponse = unknown, TQuery = never, TServer extends boolean = false>(pathOrOptions?: string | IntegrationAPIBuilderOptions<TServer>, maybeOptions?: IntegrationAPIBuilderOptions<TServer>): FarmIntegrationAPIOperation<TBody, TQuery, TResponse, TServer, "POST">;
-    put<TBody = never, TResponse = unknown, TQuery = never, TServer extends boolean = false>(pathOrOptions?: string | IntegrationAPIBuilderOptions<TServer>, maybeOptions?: IntegrationAPIBuilderOptions<TServer>): FarmIntegrationAPIOperation<TBody, TQuery, TResponse, TServer, "PUT">;
-    patch<TBody = never, TResponse = unknown, TQuery = never, TServer extends boolean = false>(pathOrOptions?: string | IntegrationAPIBuilderOptions<TServer>, maybeOptions?: IntegrationAPIBuilderOptions<TServer>): FarmIntegrationAPIOperation<TBody, TQuery, TResponse, TServer, "PATCH">;
-    delete<TBody = never, TResponse = unknown, TQuery = never, TServer extends boolean = false>(pathOrOptions?: string | IntegrationAPIBuilderOptions<TServer>, maybeOptions?: IntegrationAPIBuilderOptions<TServer>): FarmIntegrationAPIOperation<TBody, TQuery, TResponse, TServer, "DELETE">;
-    options<TResponse = unknown, TQuery = never, TServer extends boolean = false>(pathOrOptions?: string | IntegrationAPIBuilderOptions<TServer>, maybeOptions?: IntegrationAPIBuilderOptions<TServer>): FarmIntegrationAPIOperation<never, TQuery, TResponse, TServer, "OPTIONS">;
-    head<TResponse = unknown, TQuery = never, TServer extends boolean = false>(pathOrOptions?: string | IntegrationAPIBuilderOptions<TServer>, maybeOptions?: IntegrationAPIBuilderOptions<TServer>): FarmIntegrationAPIOperation<never, TQuery, TResponse, TServer, "HEAD">;
-    form: {
-        query<TBody = never, TResponse = unknown, TQuery = never, TServer extends boolean = false>(pathOrOptions?: string | IntegrationAPIBuilderOptions<TServer>, maybeOptions?: IntegrationAPIBuilderOptions<TServer>): FarmIntegrationAPIOperation<TBody, TQuery, TResponse, TServer, "QUERY">;
-        post<TBody = never, TResponse = unknown, TQuery = never, TServer extends boolean = false>(pathOrOptions?: string | IntegrationAPIBuilderOptions<TServer>, maybeOptions?: IntegrationAPIBuilderOptions<TServer>): FarmIntegrationAPIOperation<TBody, TQuery, TResponse, TServer, "POST">;
-        put<TBody = never, TResponse = unknown, TQuery = never, TServer extends boolean = false>(pathOrOptions?: string | IntegrationAPIBuilderOptions<TServer>, maybeOptions?: IntegrationAPIBuilderOptions<TServer>): FarmIntegrationAPIOperation<TBody, TQuery, TResponse, TServer, "PUT">;
-        patch<TBody = never, TResponse = unknown, TQuery = never, TServer extends boolean = false>(pathOrOptions?: string | IntegrationAPIBuilderOptions<TServer>, maybeOptions?: IntegrationAPIBuilderOptions<TServer>): FarmIntegrationAPIOperation<TBody, TQuery, TResponse, TServer, "PATCH">;
-        delete<TBody = never, TResponse = unknown, TQuery = never, TServer extends boolean = false>(pathOrOptions?: string | IntegrationAPIBuilderOptions<TServer>, maybeOptions?: IntegrationAPIBuilderOptions<TServer>): FarmIntegrationAPIOperation<TBody, TQuery, TResponse, TServer, "DELETE">;
-    };
-};
-declare const endpoint: {
-    get: typeof get;
-    route: typeof route;
-    fromRoutes: typeof fromRoutes;
-    query<TBody = never, TResponse = unknown, TQuery = never, TServer extends boolean = false>(pathOrOptions?: string | IntegrationAPIBuilderOptions<TServer>, maybeOptions?: IntegrationAPIBuilderOptions<TServer>): FarmIntegrationAPIOperation<TBody, TQuery, TResponse, TServer, "QUERY">;
-    post<TBody = never, TResponse = unknown, TQuery = never, TServer extends boolean = false>(pathOrOptions?: string | IntegrationAPIBuilderOptions<TServer>, maybeOptions?: IntegrationAPIBuilderOptions<TServer>): FarmIntegrationAPIOperation<TBody, TQuery, TResponse, TServer, "POST">;
-    put<TBody = never, TResponse = unknown, TQuery = never, TServer extends boolean = false>(pathOrOptions?: string | IntegrationAPIBuilderOptions<TServer>, maybeOptions?: IntegrationAPIBuilderOptions<TServer>): FarmIntegrationAPIOperation<TBody, TQuery, TResponse, TServer, "PUT">;
-    patch<TBody = never, TResponse = unknown, TQuery = never, TServer extends boolean = false>(pathOrOptions?: string | IntegrationAPIBuilderOptions<TServer>, maybeOptions?: IntegrationAPIBuilderOptions<TServer>): FarmIntegrationAPIOperation<TBody, TQuery, TResponse, TServer, "PATCH">;
-    delete<TBody = never, TResponse = unknown, TQuery = never, TServer extends boolean = false>(pathOrOptions?: string | IntegrationAPIBuilderOptions<TServer>, maybeOptions?: IntegrationAPIBuilderOptions<TServer>): FarmIntegrationAPIOperation<TBody, TQuery, TResponse, TServer, "DELETE">;
-    options<TResponse = unknown, TQuery = never, TServer extends boolean = false>(pathOrOptions?: string | IntegrationAPIBuilderOptions<TServer>, maybeOptions?: IntegrationAPIBuilderOptions<TServer>): FarmIntegrationAPIOperation<never, TQuery, TResponse, TServer, "OPTIONS">;
-    head<TResponse = unknown, TQuery = never, TServer extends boolean = false>(pathOrOptions?: string | IntegrationAPIBuilderOptions<TServer>, maybeOptions?: IntegrationAPIBuilderOptions<TServer>): FarmIntegrationAPIOperation<never, TQuery, TResponse, TServer, "HEAD">;
-    form: {
-        query<TBody = never, TResponse = unknown, TQuery = never, TServer extends boolean = false>(pathOrOptions?: string | IntegrationAPIBuilderOptions<TServer>, maybeOptions?: IntegrationAPIBuilderOptions<TServer>): FarmIntegrationAPIOperation<TBody, TQuery, TResponse, TServer, "QUERY">;
-        post<TBody = never, TResponse = unknown, TQuery = never, TServer extends boolean = false>(pathOrOptions?: string | IntegrationAPIBuilderOptions<TServer>, maybeOptions?: IntegrationAPIBuilderOptions<TServer>): FarmIntegrationAPIOperation<TBody, TQuery, TResponse, TServer, "POST">;
-        put<TBody = never, TResponse = unknown, TQuery = never, TServer extends boolean = false>(pathOrOptions?: string | IntegrationAPIBuilderOptions<TServer>, maybeOptions?: IntegrationAPIBuilderOptions<TServer>): FarmIntegrationAPIOperation<TBody, TQuery, TResponse, TServer, "PUT">;
-        patch<TBody = never, TResponse = unknown, TQuery = never, TServer extends boolean = false>(pathOrOptions?: string | IntegrationAPIBuilderOptions<TServer>, maybeOptions?: IntegrationAPIBuilderOptions<TServer>): FarmIntegrationAPIOperation<TBody, TQuery, TResponse, TServer, "PATCH">;
-        delete<TBody = never, TResponse = unknown, TQuery = never, TServer extends boolean = false>(pathOrOptions?: string | IntegrationAPIBuilderOptions<TServer>, maybeOptions?: IntegrationAPIBuilderOptions<TServer>): FarmIntegrationAPIOperation<TBody, TQuery, TResponse, TServer, "DELETE">;
-    };
-};
-
 type RuntimeClientFactory<TClient> = () => TClient | Promise<TClient>;
 type FarmIntegrationOrmSchema = SchemaDefinition<Record<string, AnyModelDefinition>>;
 type FarmIntegrationOrmClient<TSchema extends FarmIntegrationOrmSchema> = OrmClient<TSchema>;
@@ -152,6 +57,31 @@ declare function resolveIntegrationOrmRuntimeClient<TClient = unknown>(options:
 declare function farmIntegrationSchemaToOrmSchema(schema: FarmIntegrationSchema): Promise<FarmIntegrationOrmSchema>;
 type IntegrationOrmModelNames<TSchema extends FarmIntegrationOrmSchema> = keyof SchemaModels<TSchema> & string;
 
+interface ResolvedClientCacheAdapterEntry {
+    /** Absolute adapter module path with forward slashes, ready for codegen. */
+    importPath: string;
+    options: {
+        version?: string;
+        flushDelayMs?: number;
+    };
+}
+interface ClientCachePersistenceEntryCode {
+    imports: string;
+    init: string;
+}
+/**
+ * Resolve `cache.client.adapter` from configuration to an absolute module
+ * path for the generated client entries. Fails the build with an actionable
+ * error when the option is set but the module cannot be found.
+ */
+declare function resolveFarmClientCacheAdapterEntry(root: string, cache: FarmCacheUserConfig | undefined): ResolvedClientCacheAdapterEntry | undefined;
+/**
+ * Code fragments for the generated client entries: an import of the user's
+ * adapter module and an init call that runs before hydration starts. Empty
+ * strings when persistence is not configured, so entries stay unchanged.
+ */
+declare function generateClientCachePersistenceCode(entry: ResolvedClientCacheAdapterEntry | undefined): ClientCachePersistenceEntryCode;
+
 /**
  * Farm.js Middleware System
  *
@@ -502,6 +432,11 @@ declare function loadFarmConfigFile<TConfig = Record<string, any>>(configPath: s
 declare const DEFAULT_FARM_DEVTOOLS_SHORTCUT = "mod+shift+.";
 declare const FARM_DEVTOOLS_PATH = "/__farm/devtools";
 declare const FARM_DEVTOOLS_LAUNCH_PARAM = "__farm_devtools";
+/**
+ * Configuration for the built-in DevTools dashboard. The dashboard is deprecated in favor
+ * of the `@farm.js/devtools` plugin, which reuses this configuration for enablement and
+ * the keyboard shortcut. Both options keep working while the built-in UI remains available.
+ */
 interface FarmDevtoolsConfig {
     /** Enable the development-only DevTools UI and runtime endpoints. */
     enabled?: boolean;
@@ -1889,7 +1824,13 @@ interface FarmConfig {
     observability?: FarmObservabilityUserConfig;
     /** Farm product telemetry for deployed server runtimes. Set to false to disable. */
     telemetry?: boolean;
-    /** Development-only runtime inspector. Enabled by default during `farm dev`. */
+    /**
+     * Development-only runtime inspector. Enabled by default during `farm dev`.
+     *
+     * @deprecated The built-in dashboard is deprecated. Install `@farm.js/devtools` and add
+     * `devtools()` to `plugins` instead; it reuses this runtime and owns the maintained UI.
+     * `devtools: false` and `shortcut` remain supported for the transition.
+     */
     devtools?: FarmDevtoolsUserConfig;
     /** Development-only browser feedback for build and HMR activity. */
     devIndicators?: FarmDevIndicatorsConfig;
@@ -1901,6 +1842,17 @@ interface FarmConfig {
     experimental?: {
         serverComponents?: boolean;
         serverActions?: boolean;
+        /**
+         * Enables Partial Prerendering (static-shell caching). Routes still opt in
+         * individually with `export const ppr = true`, the Next-compatible
+         * `export const experimental_ppr = true`, or a `"use ppr"` directive;
+         * without this flag those declarations are inert and the route renders
+         * fully dynamically.
+         *
+         * @experimental
+         * @default false
+         */
+        ppr?: boolean;
         /**
          * Controls non-RSC hydration ownership for server modules that import
          * leaf `"use client"` components.
@@ -2136,6 +2088,7 @@ interface RouteModule<TRoute extends FarmRoutePropsTarget = FarmRoutePropsDefaul
     /**
      * Opt into Partial Prerendering/static-shell caching for this route.
      * Compatible with Farm's `ppr` export and Next.js `experimental_ppr`.
+     * Requires `experimental.ppr` in `farm.config.ts`; inert without it.
      */
     ppr?: boolean;
     experimental_ppr?: boolean;
@@ -2316,4 +2269,4 @@ interface SSGCollectionResult {
     ssr: string[];
 }
 
-export { type BuildOptions as $, type AppRoutePattern as A, type BundleResultPayload as B, type FarmContextFactoryInput as C, type FarmIsolatedClientHydrationMode as D, type LoadingProps as E, type FarmRouteRuntimeConfig as F, type ErrorProps as G, type PagePropsWithMiddleware as H, type MetadataProps as I, type LayoutMetadataProps as J, type Page as K, type LayoutProps as L, type Metadata as M, type NitroPreset as N, type Layout as O, type ParsedRoute as P, type Loading as Q, type RouteSegment as R, type ErrorBoundary as S, type StaticPathPrimitive as T, type StaticPathParams as U, type StaticRouteParams as V, type GenerateStaticParams as W, type LayoutModule as X, type FarmRequest as Y, type FarmResponse as Z, type ServerAction as _, type FarmPlugin as a, type FarmRequestStore as a$, type SSGPage as a0, type SSGCollectionResult as a1, type FarmLayerEntry as a2, type ResolvedFarmLayer as a3, type FarmSourceRoot as a4, type ResolveFarmLayersOptions as a5, type FarmLayerResolution as a6, resolveFarmLayers as a7, getFarmSourceRoots as a8, getFarmAppDirectories as a9, resolveDeployConfig as aA, resolveMigrationsConfig as aB, resolveDeployOutputPath as aC, normalizeDeployTarget as aD, getDeployTargetForPreset as aE, getPresetForDeployTarget as aF, type FarmLayerConfig as aG, type FarmPerformanceConfig as aH, type FarmPreloadMode as aI, type FarmPreloadUserConfig as aJ, type ResolvedFarmPreloadConfig as aK, type FarmCspConfig as aL, type FarmCspDirectives as aM, type FarmCspDirectiveValue as aN, type FarmCspOptions as aO, type FarmSecurityConfig as aP, type ResolvedFarmCspConfig as aQ, type FarmAuthConfig as aR, type FarmAuthDatabaseConfig as aS, type FarmAuthEmailAndPasswordConfig as aT, type FarmAuthSessionConfig as aU, type FarmAuthUserConfig as aV, type PluginRequestContext as aW, type FarmPluginContext as aX, type FarmPluginIntegrationContext as aY, type FarmPluginLifecycle as aZ, type FarmRequestPluginContext as a_, getFarmLayerAliases as aa, createFarmConfigResolutionPlugin as ab, loadFarmConfigFile as ac, type ReadonlyMiddlewareStore as ad, type FarmMiddlewareConfig as ae, type MiddlewareModule as af, type ResolvedFarmRouteRuntimeConfig as ag, type ResolvedFarmAPIConfig as ah, type ResolvedFarmDevtoolsConfig as ai, type ResolvedFarmDevIndicatorsConfig as aj, type ResolvedFarmAuthConfig as ak, type ResolvedFarmPerformanceConfig as al, type ResolvedFarmSecurityConfig as am, type FarmIntegrationAPI as an, type FarmIntegrationAPIOperation as ao, type APIRequestRuntime as ap, manageFarmDocumentPreloads as aq, manageFarmHtmlPreloads as ar, manageFarmLinkHeaderPreloads as as, reportFarmPreloadWarnings as at, type OpenAPIConfig as au, definePlugin as av, FarmRuntimeShutdownError as aw, PluginManager as ax, resolveConfig as ay, loadConfig as az, type FarmRouteRuntime as b, type FarmIntegrationConfigContext as b$, type FarmPluginRuntimeKind as b0, type FarmPluginRouteRuntimePayload as b1, type FarmPluginSetupContext as b2, type FarmPluginStateContext as b3, type FarmPluginRuntimeBaseEvent as b4, type FarmPluginRuntimeContextEvent as b5, type FarmPluginRuntimeBeforeEvent as b6, type FarmPluginRuntimeAfterEvent as b7, type FarmPluginRuntimeErrorEvent as b8, type FarmPluginRuntimeStartEvent as b9, type HeaderConfig as bA, type RewriteConfig as bB, type ImageConfig as bC, type I18nConfig as bD, type MiddlewareConfig as bE, type FarmDeployConfig as bF, type ResolvedFarmDeployConfig as bG, type FarmDeployTarget as bH, type FarmIntegrationCategory as bI, type FarmIntegrationSlot as bJ, type FarmIntegrationRouteParamValue as bK, type FarmIntegrationRouteParams as bL, type FarmIntegrationRouteMethod as bM, type FarmIntegrationRouteInputSource as bN, type FarmIntegrationValidationPathSegment as bO, type FarmIntegrationRouteInput as bP, type FarmIntegrationValidationIssue as bQ, type FarmIntegrationValidationErrorLike as bR, type FarmIntegrationValidationResult as bS, type FarmIntegrationStandardValidationResult as bT, type FarmIntegrationInputSchema as bU, type FarmIntegrationRouteInputSchemas as bV, type FarmIntegrationRequestContextStore as bW, FARM_INTEGRATION_INTERNAL_DISPATCH_CONTEXT_KEY as bX, type FarmIntegrationRouteDb as bY, type FarmIntegrationRouteStorageArgs as bZ, type FarmIntegrationRouteArgs as b_, type FarmPluginRuntimeCloseEvent as ba, type FarmPluginRuntimeHooks as bb, type FarmPluginRuntimeRequestOptions as bc, type FarmPluginRuntimeRequestHandler as bd, type FarmPluginRuntimeSession as be, type FarmPluginDiscoveredRoute as bf, type FarmPluginRouterHooks as bg, type FarmPluginRenderHooks as bh, type FarmPluginBuildHooks as bi, type FarmPluginDevHooks as bj, type FarmPluginClientConfig as bk, type RouteDiscoveredPayload as bl, type RoutesGeneratedPayload as bm, type MiddlewareDiscoveredPayload as bn, type APIRouteDiscoveredPayload as bo, type RouteMatchPayload as bp, type RouteMatchResultPayload as bq, type RenderLifecyclePayload as br, type APIHandlerLifecyclePayload as bs, type ErrorLifecyclePayload as bt, type HMRUpdatePayload as bu, type BundleLifecyclePayload as bv, type NitroBuildLifecyclePayload as bw, type ShutdownPayload as bx, type ResolvedFarmConfig as by, type RedirectConfig as bz, type FarmRouteRegions as c, type FarmIntegrationAPIMethod as c$, type FarmIntegrationConfigDefinition as c0, type FarmIntegrationConfigInput as c1, type FarmIntegrationLifecycleLogLevel as c2, type FarmIntegrationLifecycleLogger as c3, type FarmIntegrationLifecycleContext as c4, type FarmIntegrationLifecycleHook as c5, type FarmIntegrationData as c6, type FarmIntegrationHandlerContext as c7, type FarmIntegrationRouteHookContext as c8, type FarmIntegrationRouteHook as c9, type FarmIntegrationRoutesFactoryContext as cA, type FarmIntegrationRoutesFactory as cB, type FarmIntegrationEndpointValue as cC, type FarmIntegrationEndpoints as cD, type FarmIntegrationEndpointsFactoryContext as cE, type FarmIntegrationEndpointsFactory as cF, createIntegrationRoute as cG, integrationRoute as cH, type DefinedIntegration as cI, defineIntegration as cJ, isFarmIntegration as cK, resolveIntegrationPlugins as cL, getIntegrationProviders as cM, isFarmIntegrationProviderComponentReference as cN, getIntegrationDocumentNavigationMatchers as cO, getIntegrationSchemas as cP, getRegisteredIntegrationRuntime as cQ, getRegisteredIntegrations as cR, getRegisteredIntegrationSchemas as cS, matchIntegrationRoute as cT, matchRegisteredIntegrationRoute as cU, getRegisteredIntegrationAPIManifest as cV, dispatchIntegrationRequest as cW, api as cX, defineIntegrationAPI as cY, defineIntegrationAPIOperation as cZ, type FarmIntegrationAPIBodyFormat as c_, type FarmIntegrationRoute as ca, type FarmTypedIntegrationRoute as cb, type FarmIntegrationRouteMiddleware as cc, type FarmIntegrationMiddleware as cd, type FarmIntegrationProviderProps as ce, type FarmIntegrationProviderComponentReference as cf, type FarmIntegrationProvider as cg, type FarmIntegrationDocumentNavigation as ch, type FarmIntegrationSchemaFieldType as ci, type FarmIntegrationSchemaReference as cj, type FarmIntegrationSchemaField as ck, type FarmIntegrationSchemaConstraint as cl, type FarmIntegrationSchemaModel as cm, type FarmIntegrationSchemaModelExtension as cn, type FarmIntegrationSchemaModelOverride as co, type FarmIntegrationSchema as cp, defineIntegrationSchema as cq, type FarmIntegrationLogPhase as cr, type FarmIntegrationLogEvent as cs, type FarmIntegrationLogger as ct, type FarmIntegrationPluginOwner as cu, type FarmIntegrationContributedPlugin as cv, type FarmIntegrationsUserConfig as cw, getFarmIntegrationPluginServerRuntime as cx, getFarmIntegrationPluginOwner as cy, type FarmIntegrationRouteFactory as cz, type FarmRouteMaxDuration as d, FARM_DEVTOOLS_LAUNCH_PARAM as d$, type FarmIntegrationAPIResponseFormat as d0, type FarmIntegrationOrmSchema as d1, type FarmIntegrationOrmClient as d2, type InferFarmIntegrationOrmField as d3, type InferFarmIntegrationOrmFields as d4, type InferFarmIntegrationOrmSchema as d5, type InferFarmIntegrationOrmClient as d6, type CreateIntegrationOrmOptions as d7, createIntegrationOrm as d8, resolveIntegrationOrmRuntimeClient as d9, type RateLimitStatus as dA, type MemoryRateLimitStorageOptions as dB, type NextFunction as dC, type MiddlewareResult as dD, type FarmRouteRuleRenderMode as dE, type FarmRouteRuleRedirect as dF, type FarmRouteRuleCors as dG, type FarmRouteRule as dH, type FarmRouteRules as dI, normalizeRouteRules as dJ, routeRulesToRedirects as dK, routeRulesToHeaders as dL, routeRulesToNitroRouteRules as dM, type FarmRouteRuntimeEntryKind as dN, type FarmRouteRenderingMode as dO, type FarmRouteRuntimeManifestEntry as dP, type FarmRouteRuntimeManifest as dQ, normalizeFarmRouteRuntimeConfig as dR, mergeFarmRouteRuntimeConfigs as dS, resolveFarmRouteRuntimeConfig as dT, hasFarmRouteRuntimeControls as dU, getFarmRouteRuntimeConfig as dV, createFarmRouteRuntimeKey as dW, resolveFarmRouteRuleRuntimeConfig as dX, farmRouteRuleMatches as dY, DEFAULT_FARM_DEVTOOLS_SHORTCUT as dZ, FARM_DEVTOOLS_PATH as d_, farmIntegrationSchemaToOrmSchema as da, type IntegrationOrmModelNames as db, type FarmIntegrationRouteOperationCarrier as dc, type InferIntegrationAPIFromRoutes as dd, endpoint as de, DEFAULT_FARM_API_BASE_PATH as df, type FarmAPIConfigResolverContext as dg, type FarmAPIConfigValue as dh, type FarmAPIConfig as di, resolveFarmAPIConfig as dj, normalizeFarmAPIConfig as dk, normalizeFarmAPIBasePath as dl, getFarmAPIBaseURL as dm, resolveFarmAPIRequestURL as dn, type MiddlewareContext as dp, type MiddlewareFunction as dq, type RequestMiddleware as dr, type RequestMiddlewareContext as ds, type MiddlewareStore as dt, type MiddlewareChain as du, type CookieJar as dv, type CookieOptions as dw, type RateLimitConfig as dx, type RateLimitIncrementResult as dy, type RateLimitStorage as dz, type FarmAppContext as e, type FarmDevtoolsConfig as e0, type FarmDevtoolsUserConfig as e1, resolveFarmDevtoolsConfig as e2, type FarmBuildActivityPosition as e3, type FarmDevIndicatorsConfig as e4, resolveFarmDevIndicatorsConfig as e5, generateFarmDevIndicatorsClientRuntime as e6, type MiddlewareConfig$1 as e7, farmI18nClientBridgePlugin as e8, withFarmRequestTracing as e9, rewriteEarlySsrRelativeImports as ea, transformIsolatedClientBoundaryModule as eb, FARM_NODE_RESPONSE_END_PENDING as ec, type PageProps as f, type PluginContextProps as g, type RouteModule as h, type FarmMdxComponents as i, type FarmMdxResolvedConfig as j, type FarmMdxComponent as k, type FarmMdxUserConfig as l, type FarmUserConfig as m, type FarmContextFactory as n, type MiddlewareProps as o, type FarmIntegration as p, type FarmConfig as q, resolveMdxConfig as r, farmPlugin as s, defineConfig as t, type FarmComponentType as u, type PageRouteParams as v, type FarmMigrationCommand as w, type FarmMigrationsConfig as x, type FarmMigrationsUserConfig as y, type ResolvedFarmMigrationsConfig as z };
+export { type BuildOptions as $, type AppRoutePattern as A, type BundleResultPayload as B, type FarmContextFactoryInput as C, type FarmIsolatedClientHydrationMode as D, type LoadingProps as E, type FarmRouteRuntimeConfig as F, type ErrorProps as G, type PagePropsWithMiddleware as H, type MetadataProps as I, type LayoutMetadataProps as J, type Page as K, type LayoutProps as L, type Metadata as M, type NitroPreset as N, type Layout as O, type ParsedRoute as P, type Loading as Q, type RouteSegment as R, type ErrorBoundary as S, type StaticPathPrimitive as T, type StaticPathParams as U, type StaticRouteParams as V, type GenerateStaticParams as W, type LayoutModule as X, type FarmRequest as Y, type FarmResponse as Z, type ServerAction as _, type FarmPlugin as a, type FarmPluginRouteRuntimePayload as a$, type SSGPage as a0, type SSGCollectionResult as a1, type FarmLayerEntry as a2, type ResolvedFarmLayer as a3, type FarmSourceRoot as a4, type ResolveFarmLayersOptions as a5, type FarmLayerResolution as a6, resolveFarmLayers as a7, getFarmSourceRoots as a8, getFarmAppDirectories as a9, resolveDeployOutputPath as aA, normalizeDeployTarget as aB, getDeployTargetForPreset as aC, getPresetForDeployTarget as aD, type FarmLayerConfig as aE, type FarmPerformanceConfig as aF, type FarmPreloadMode as aG, type FarmPreloadUserConfig as aH, type ResolvedFarmPreloadConfig as aI, type FarmCspConfig as aJ, type FarmCspDirectives as aK, type FarmCspDirectiveValue as aL, type FarmCspOptions as aM, type FarmSecurityConfig as aN, type ResolvedFarmCspConfig as aO, type FarmAuthConfig as aP, type FarmAuthDatabaseConfig as aQ, type FarmAuthEmailAndPasswordConfig as aR, type FarmAuthSessionConfig as aS, type FarmAuthUserConfig as aT, type PluginRequestContext as aU, type FarmPluginContext as aV, type FarmPluginIntegrationContext as aW, type FarmPluginLifecycle as aX, type FarmRequestPluginContext as aY, type FarmRequestStore as aZ, type FarmPluginRuntimeKind as a_, getFarmLayerAliases as aa, createFarmConfigResolutionPlugin as ab, loadFarmConfigFile as ac, type ReadonlyMiddlewareStore as ad, type FarmMiddlewareConfig as ae, type MiddlewareModule as af, type ResolvedFarmRouteRuntimeConfig as ag, type ResolvedFarmAPIConfig as ah, type ResolvedFarmDevtoolsConfig as ai, type ResolvedFarmDevIndicatorsConfig as aj, type ResolvedFarmAuthConfig as ak, type ResolvedFarmPerformanceConfig as al, type ResolvedFarmSecurityConfig as am, type APIRequestRuntime as an, manageFarmDocumentPreloads as ao, manageFarmHtmlPreloads as ap, manageFarmLinkHeaderPreloads as aq, reportFarmPreloadWarnings as ar, type OpenAPIConfig as as, definePlugin as at, FarmRuntimeShutdownError as au, PluginManager as av, resolveConfig as aw, loadConfig as ax, resolveDeployConfig as ay, resolveMigrationsConfig as az, type FarmRouteRuntime as b, type FarmIntegrationConfigInput as b$, type FarmPluginSetupContext as b0, type FarmPluginStateContext as b1, type FarmPluginRuntimeBaseEvent as b2, type FarmPluginRuntimeContextEvent as b3, type FarmPluginRuntimeBeforeEvent as b4, type FarmPluginRuntimeAfterEvent as b5, type FarmPluginRuntimeErrorEvent as b6, type FarmPluginRuntimeStartEvent as b7, type FarmPluginRuntimeCloseEvent as b8, type FarmPluginRuntimeHooks as b9, type ImageConfig as bA, type I18nConfig as bB, type MiddlewareConfig as bC, type FarmDeployConfig as bD, type ResolvedFarmDeployConfig as bE, type FarmDeployTarget as bF, type FarmIntegrationCategory as bG, type FarmIntegrationSlot as bH, type FarmIntegrationRouteParamValue as bI, type FarmIntegrationRouteParams as bJ, type FarmIntegrationRouteMethod as bK, type FarmIntegrationRouteInputSource as bL, type FarmIntegrationValidationPathSegment as bM, type FarmIntegrationRouteInput as bN, type FarmIntegrationValidationIssue as bO, type FarmIntegrationValidationErrorLike as bP, type FarmIntegrationValidationResult as bQ, type FarmIntegrationStandardValidationResult as bR, type FarmIntegrationInputSchema as bS, type FarmIntegrationRouteInputSchemas as bT, type FarmIntegrationRequestContextStore as bU, FARM_INTEGRATION_INTERNAL_DISPATCH_CONTEXT_KEY as bV, type FarmIntegrationRouteDb as bW, type FarmIntegrationRouteStorageArgs as bX, type FarmIntegrationRouteArgs as bY, type FarmIntegrationConfigContext as bZ, type FarmIntegrationConfigDefinition as b_, type FarmPluginRuntimeRequestOptions as ba, type FarmPluginRuntimeRequestHandler as bb, type FarmPluginRuntimeSession as bc, type FarmPluginDiscoveredRoute as bd, type FarmPluginRouterHooks as be, type FarmPluginRenderHooks as bf, type FarmPluginBuildHooks as bg, type FarmPluginDevHooks as bh, type FarmPluginClientConfig as bi, type RouteDiscoveredPayload as bj, type RoutesGeneratedPayload as bk, type MiddlewareDiscoveredPayload as bl, type APIRouteDiscoveredPayload as bm, type RouteMatchPayload as bn, type RouteMatchResultPayload as bo, type RenderLifecyclePayload as bp, type APIHandlerLifecyclePayload as bq, type ErrorLifecyclePayload as br, type HMRUpdatePayload as bs, type BundleLifecyclePayload as bt, type NitroBuildLifecyclePayload as bu, type ShutdownPayload as bv, type ResolvedFarmConfig as bw, type RedirectConfig as bx, type HeaderConfig as by, type RewriteConfig as bz, type FarmRouteRegions as c, type CreateIntegrationOrmOptions as c$, type FarmIntegrationLifecycleLogLevel as c0, type FarmIntegrationLifecycleLogger as c1, type FarmIntegrationLifecycleContext as c2, type FarmIntegrationLifecycleHook as c3, type FarmIntegrationData as c4, type FarmIntegrationHandlerContext as c5, type FarmIntegrationRouteHookContext as c6, type FarmIntegrationRouteHook as c7, type FarmIntegrationRoute as c8, type FarmTypedIntegrationRoute as c9, type FarmIntegrationEndpointValue as cA, type FarmIntegrationEndpoints as cB, type FarmIntegrationEndpointsFactoryContext as cC, type FarmIntegrationEndpointsFactory as cD, createIntegrationRoute as cE, integrationRoute as cF, type DefinedIntegration as cG, defineIntegration as cH, isFarmIntegration as cI, resolveIntegrationPlugins as cJ, getIntegrationProviders as cK, isFarmIntegrationProviderComponentReference as cL, getIntegrationDocumentNavigationMatchers as cM, getIntegrationSchemas as cN, getRegisteredIntegrationRuntime as cO, getRegisteredIntegrations as cP, getRegisteredIntegrationSchemas as cQ, matchIntegrationRoute as cR, matchRegisteredIntegrationRoute as cS, getRegisteredIntegrationAPIManifest as cT, dispatchIntegrationRequest as cU, type FarmIntegrationOrmSchema as cV, type FarmIntegrationOrmClient as cW, type InferFarmIntegrationOrmField as cX, type InferFarmIntegrationOrmFields as cY, type InferFarmIntegrationOrmSchema as cZ, type InferFarmIntegrationOrmClient as c_, type FarmIntegrationRouteMiddleware as ca, type FarmIntegrationMiddleware as cb, type FarmIntegrationProviderProps as cc, type FarmIntegrationProviderComponentReference as cd, type FarmIntegrationProvider as ce, type FarmIntegrationDocumentNavigation as cf, type FarmIntegrationSchemaFieldType as cg, type FarmIntegrationSchemaReference as ch, type FarmIntegrationSchemaField as ci, type FarmIntegrationSchemaConstraint as cj, type FarmIntegrationSchemaModel as ck, type FarmIntegrationSchemaModelExtension as cl, type FarmIntegrationSchemaModelOverride as cm, type FarmIntegrationSchema as cn, defineIntegrationSchema as co, type FarmIntegrationLogPhase as cp, type FarmIntegrationLogEvent as cq, type FarmIntegrationLogger as cr, type FarmIntegrationPluginOwner as cs, type FarmIntegrationContributedPlugin as ct, type FarmIntegrationsUserConfig as cu, getFarmIntegrationPluginServerRuntime as cv, getFarmIntegrationPluginOwner as cw, type FarmIntegrationRouteFactory as cx, type FarmIntegrationRoutesFactoryContext as cy, type FarmIntegrationRoutesFactory as cz, type FarmRouteMaxDuration as d, rewriteEarlySsrRelativeImports as d$, createIntegrationOrm as d0, resolveIntegrationOrmRuntimeClient as d1, farmIntegrationSchemaToOrmSchema as d2, type IntegrationOrmModelNames as d3, DEFAULT_FARM_API_BASE_PATH as d4, type FarmAPIConfigResolverContext as d5, type FarmAPIConfigValue as d6, type FarmAPIConfig as d7, resolveFarmAPIConfig as d8, normalizeFarmAPIConfig as d9, routeRulesToHeaders as dA, routeRulesToNitroRouteRules as dB, type FarmRouteRuntimeEntryKind as dC, type FarmRouteRenderingMode as dD, type FarmRouteRuntimeManifestEntry as dE, type FarmRouteRuntimeManifest as dF, normalizeFarmRouteRuntimeConfig as dG, mergeFarmRouteRuntimeConfigs as dH, resolveFarmRouteRuntimeConfig as dI, hasFarmRouteRuntimeControls as dJ, getFarmRouteRuntimeConfig as dK, createFarmRouteRuntimeKey as dL, resolveFarmRouteRuleRuntimeConfig as dM, farmRouteRuleMatches as dN, DEFAULT_FARM_DEVTOOLS_SHORTCUT as dO, FARM_DEVTOOLS_PATH as dP, FARM_DEVTOOLS_LAUNCH_PARAM as dQ, type FarmDevtoolsConfig as dR, type FarmDevtoolsUserConfig as dS, resolveFarmDevtoolsConfig as dT, type FarmBuildActivityPosition as dU, type FarmDevIndicatorsConfig as dV, resolveFarmDevIndicatorsConfig as dW, generateFarmDevIndicatorsClientRuntime as dX, type MiddlewareConfig$1 as dY, farmI18nClientBridgePlugin as dZ, withFarmRequestTracing as d_, normalizeFarmAPIBasePath as da, getFarmAPIBaseURL as db, resolveFarmAPIRequestURL as dc, type MiddlewareContext as dd, type MiddlewareFunction as de, type RequestMiddleware as df, type RequestMiddlewareContext as dg, type MiddlewareStore as dh, type MiddlewareChain as di, type CookieJar as dj, type CookieOptions as dk, type RateLimitConfig as dl, type RateLimitIncrementResult as dm, type RateLimitStorage as dn, type RateLimitStatus as dp, type MemoryRateLimitStorageOptions as dq, type NextFunction as dr, type MiddlewareResult as ds, type FarmRouteRuleRenderMode as dt, type FarmRouteRuleRedirect as du, type FarmRouteRuleCors as dv, type FarmRouteRule as dw, type FarmRouteRules as dx, normalizeRouteRules as dy, routeRulesToRedirects as dz, type FarmAppContext as e, transformIsolatedClientBoundaryModule as e0, generateClientCachePersistenceCode as e1, resolveFarmClientCacheAdapterEntry as e2, type ClientCachePersistenceEntryCode as e3, FARM_NODE_RESPONSE_END_PENDING as e4, type PageProps as f, type PluginContextProps as g, type RouteModule as h, type FarmMdxComponents as i, type FarmMdxResolvedConfig as j, type FarmMdxComponent as k, type FarmMdxUserConfig as l, type FarmUserConfig as m, type FarmContextFactory as n, type MiddlewareProps as o, type FarmIntegration as p, type FarmConfig as q, resolveMdxConfig as r, farmPlugin as s, defineConfig as t, type FarmComponentType as u, type PageRouteParams as v, type FarmMigrationCommand as w, type FarmMigrationsConfig as x, type FarmMigrationsUserConfig as y, type ResolvedFarmMigrationsConfig as z };