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

package/dist/api.d.mts

@@ -1,14 +1,14 @@
-export { A as AnyEndpointMiddleware, D as DELETE, d as EndpointErrorContracts, b as EndpointErrorDefinition, c as EndpointErrorDefinitions, e as EndpointErrorHandler, a as EndpointErrorSchema, f as EndpointFail, E as EndpointFailure, q as EndpointHandler, n as EndpointInvalidationContext, m as EndpointInvalidationTarget, o as EndpointInvalidations, l as EndpointMiddleware, j as EndpointMiddlewareContext, k as EndpointMiddlewareResult, p as EndpointOptions, g as EndpointParamValue, h as EndpointParams, F as FarmAPIStream, y as FarmStreamResponse, G as GET, H as HEAD, I as InferEndpointMiddlewareContext, M as MultipartField, x as MultipartSchema, v as MultipartValues, O as OPTIONS, u as PATCH, s as POST, t as PUT, $ as PluginAPIRouter, Z as PluginRoutes, P as PluginRoutesFactory, Q as QUERY, W as RouteDefinition, Y as RouteFactory, U as RouteInputSchemas, V as RouteJSON, S as RouteMethod, X as RouteOptions, R as RoutePathParams, T as TypedEndpoint, w as TypedFormData, r as createEndpoint, _ as createRouteFactory, i as isEndpointFailure, N as isFarmAPIStream, K as isJSONStreamResponse, B as isMultipartSchema, J as jsonStream, z as multipart, L as readJSONStream, a0 as resolvePluginRoutes, C as toFormData } from './route-Cq3aObmj.mjs';
+export { A as AnyEndpointMiddleware, D as DELETE, d as EndpointErrorContracts, b as EndpointErrorDefinition, c as EndpointErrorDefinitions, e as EndpointErrorHandler, a as EndpointErrorSchema, f as EndpointFail, E as EndpointFailure, q as EndpointHandler, n as EndpointInvalidationContext, m as EndpointInvalidationTarget, o as EndpointInvalidations, l as EndpointMiddleware, j as EndpointMiddlewareContext, k as EndpointMiddlewareResult, p as EndpointOptions, g as EndpointParamValue, h as EndpointParams, F as FarmAPIStream, y as FarmStreamResponse, G as GET, H as HEAD, I as InferEndpointMiddlewareContext, M as MultipartField, x as MultipartSchema, v as MultipartValues, O as OPTIONS, u as PATCH, s as POST, t as PUT, $ as PluginAPIRouter, Z as PluginRoutes, P as PluginRoutesFactory, Q as QUERY, W as RouteDefinition, Y as RouteFactory, U as RouteInputSchemas, V as RouteJSON, S as RouteMethod, X as RouteOptions, R as RoutePathParams, T as TypedEndpoint, w as TypedFormData, r as createEndpoint, _ as createRouteFactory, i as isEndpointFailure, N as isFarmAPIStream, K as isJSONStreamResponse, B as isMultipartSchema, J as jsonStream, z as multipart, L as readJSONStream, a0 as resolvePluginRoutes, C as toFormData } from './route-CvEr4Uc9.mjs';
 export { APIRoute, APIRouteConflictError, APIRouteHandlerOptions, APIRouteManager, APIRouteManagerOptions, API_ROUTE_METHODS } from './api/route-manager.mjs';
-export { s as APIClient, h as APIClientError, b as APIClientOptions, i as APIClientSystemError, c as APIClientWithoutIntegrationsOptions, g as APIResult, B as APIRouteManifest, A as APIRouteRefMetadata, u as ApiClients, C as CacheKey, m as CacheOptions, k as CachePolicy, l as CacheScope, q as ClientOptions, a as FARM_API_ROUTE_META_SYMBOL, F as FARM_API_ROUTE_REF_SYMBOL, o as InvalidateOptions, I as InvalidateTarget, p as OptimisticOptions, O as OptimisticUpdate, R as RequestEvent, j as ResponseEvent, n as RetryOptions, r as RouteAPIClient, t as ServerAPIClient, S as ServerAPIClientOptions, d as ServerAPIClientWithoutIntegrationsOptions, f as StatusEvent, e as StatusPhase, w as createAPIClient, v as createApiClients, z as createServerAPIClient, y as getAPIRouteRefMetadata, x as isAPIRouteRef } from './client-mcMC334J.mjs';
-import { ah as ResolvedFarmAPIConfig } from './client-plugins-BvClItiL.mjs';
-export { df as DEFAULT_FARM_API_BASE_PATH, di as FarmAPIConfig, dg as FarmAPIConfigResolverContext, dh as FarmAPIConfigValue, dm as getFarmAPIBaseURL, dl as normalizeFarmAPIBasePath, dk as normalizeFarmAPIConfig, dj as resolveFarmAPIConfig, dn as resolveFarmAPIRequestURL } from './client-plugins-BvClItiL.mjs';
+export { s as APIClient, h as APIClientError, b as APIClientOptions, i as APIClientSystemError, c as APIClientWithoutIntegrationsOptions, g as APIResult, G as APIRouteManifest, A as APIRouteRefMetadata, u as ApiClients, C as CacheKey, n as CacheOptions, l as CachePolicy, m as CacheScope, q as ClientOptions, a as FARM_API_ROUTE_META_SYMBOL, F as FARM_API_ROUTE_REF_SYMBOL, o as InvalidateOptions, I as InvalidateTarget, p as OptimisticOptions, O as OptimisticUpdate, j as RequestEvent, k as ResponseEvent, R as RetryOptions, r as RouteAPIClient, t as ServerAPIClient, S as ServerAPIClientOptions, d as ServerAPIClientWithoutIntegrationsOptions, f as StatusEvent, e as StatusPhase, B as applyServerFnOptimisticUpdates, w as createAPIClient, v as createApiClients, z as createServerAPIClient, y as getAPIRouteRefMetadata, x as isAPIRouteRef, E as resolveServerFnInvalidateTargets, D as settleServerFnOptimisticUpdates } from './client-DWoLZ3QU.mjs';
+import { ah as ResolvedFarmAPIConfig } from './client-plugins-B6-07YmP.mjs';
+export { d4 as DEFAULT_FARM_API_BASE_PATH, d7 as FarmAPIConfig, d5 as FarmAPIConfigResolverContext, d6 as FarmAPIConfigValue, db as getFarmAPIBaseURL, da as normalizeFarmAPIBasePath, d9 as normalizeFarmAPIConfig, d8 as resolveFarmAPIConfig, dc as resolveFarmAPIRequestURL } from './client-plugins-B6-07YmP.mjs';
 import { Plugin } from 'vite';
 export { getAllowedAPIRouteMethods, invokeAPIRouteEndpoint, isWebResponse, normalizeRouteResponse, resolveAPIRouteEndpoint } from './api/runtime.mjs';
 export { A as APIRouteMatch, b as APIRouteParamValue, a as APIRouteParams, m as matchAPIRoute } from './route-pattern-W-SsJGSp.mjs';
 import './cache.mjs';
 import './types-CnH8DOqo.mjs';
-import './runtime-DDwvDtS4.mjs';
+import './runtime-CV2UCV-5.mjs';
 import './resolver-khasx3fU.mjs';
 import './lifecycle-De0vQG45.mjs';
 import './renderer.mjs';
@@ -17,6 +17,7 @@ import './types-Cc8l9IqS.mjs';
 import 'db0';
 import 'unstorage';
 import 'react';
+import './integration-api-BT024nuJ.mjs';
 import '@farming-labs/orm';
 import './types-CKwggz9n.mjs';
 import '@farming-labs/docs';
@@ -36,7 +37,7 @@ import './font.mjs';
 import './after.mjs';
 import 'node:http';
 import './island-CfGru1MO.mjs';
-import './client-cache-CopR_MaI.mjs';
+import './client-cache-CCK-fCe0.mjs';
 
 /** Return the same-origin path served by this Farm application. */
 declare function resolveFarmAPIServerBasePath(config: ResolvedFarmAPIConfig): string;

package/dist/api.d.ts

@@ -1,14 +1,14 @@
-export { A as AnyEndpointMiddleware, D as DELETE, d as EndpointErrorContracts, b as EndpointErrorDefinition, c as EndpointErrorDefinitions, e as EndpointErrorHandler, a as EndpointErrorSchema, f as EndpointFail, E as EndpointFailure, q as EndpointHandler, n as EndpointInvalidationContext, m as EndpointInvalidationTarget, o as EndpointInvalidations, l as EndpointMiddleware, j as EndpointMiddlewareContext, k as EndpointMiddlewareResult, p as EndpointOptions, g as EndpointParamValue, h as EndpointParams, F as FarmAPIStream, y as FarmStreamResponse, G as GET, H as HEAD, I as InferEndpointMiddlewareContext, M as MultipartField, x as MultipartSchema, v as MultipartValues, O as OPTIONS, u as PATCH, s as POST, t as PUT, $ as PluginAPIRouter, Z as PluginRoutes, P as PluginRoutesFactory, Q as QUERY, W as RouteDefinition, Y as RouteFactory, U as RouteInputSchemas, V as RouteJSON, S as RouteMethod, X as RouteOptions, R as RoutePathParams, T as TypedEndpoint, w as TypedFormData, r as createEndpoint, _ as createRouteFactory, i as isEndpointFailure, N as isFarmAPIStream, K as isJSONStreamResponse, B as isMultipartSchema, J as jsonStream, z as multipart, L as readJSONStream, a0 as resolvePluginRoutes, C as toFormData } from './route-Y8lfz1wF.js';
+export { A as AnyEndpointMiddleware, D as DELETE, d as EndpointErrorContracts, b as EndpointErrorDefinition, c as EndpointErrorDefinitions, e as EndpointErrorHandler, a as EndpointErrorSchema, f as EndpointFail, E as EndpointFailure, q as EndpointHandler, n as EndpointInvalidationContext, m as EndpointInvalidationTarget, o as EndpointInvalidations, l as EndpointMiddleware, j as EndpointMiddlewareContext, k as EndpointMiddlewareResult, p as EndpointOptions, g as EndpointParamValue, h as EndpointParams, F as FarmAPIStream, y as FarmStreamResponse, G as GET, H as HEAD, I as InferEndpointMiddlewareContext, M as MultipartField, x as MultipartSchema, v as MultipartValues, O as OPTIONS, u as PATCH, s as POST, t as PUT, $ as PluginAPIRouter, Z as PluginRoutes, P as PluginRoutesFactory, Q as QUERY, W as RouteDefinition, Y as RouteFactory, U as RouteInputSchemas, V as RouteJSON, S as RouteMethod, X as RouteOptions, R as RoutePathParams, T as TypedEndpoint, w as TypedFormData, r as createEndpoint, _ as createRouteFactory, i as isEndpointFailure, N as isFarmAPIStream, K as isJSONStreamResponse, B as isMultipartSchema, J as jsonStream, z as multipart, L as readJSONStream, a0 as resolvePluginRoutes, C as toFormData } from './route-4pd-EVtw.js';
 export { APIRoute, APIRouteConflictError, APIRouteHandlerOptions, APIRouteManager, APIRouteManagerOptions, API_ROUTE_METHODS } from './api/route-manager.js';
-export { s as APIClient, h as APIClientError, b as APIClientOptions, i as APIClientSystemError, c as APIClientWithoutIntegrationsOptions, g as APIResult, B as APIRouteManifest, A as APIRouteRefMetadata, u as ApiClients, C as CacheKey, m as CacheOptions, k as CachePolicy, l as CacheScope, q as ClientOptions, a as FARM_API_ROUTE_META_SYMBOL, F as FARM_API_ROUTE_REF_SYMBOL, o as InvalidateOptions, I as InvalidateTarget, p as OptimisticOptions, O as OptimisticUpdate, R as RequestEvent, j as ResponseEvent, n as RetryOptions, r as RouteAPIClient, t as ServerAPIClient, S as ServerAPIClientOptions, d as ServerAPIClientWithoutIntegrationsOptions, f as StatusEvent, e as StatusPhase, w as createAPIClient, v as createApiClients, z as createServerAPIClient, y as getAPIRouteRefMetadata, x as isAPIRouteRef } from './client-d5ONQ-Pd.js';
-import { ah as ResolvedFarmAPIConfig } from './client-plugins-B9Sq-iMg.js';
-export { df as DEFAULT_FARM_API_BASE_PATH, di as FarmAPIConfig, dg as FarmAPIConfigResolverContext, dh as FarmAPIConfigValue, dm as getFarmAPIBaseURL, dl as normalizeFarmAPIBasePath, dk as normalizeFarmAPIConfig, dj as resolveFarmAPIConfig, dn as resolveFarmAPIRequestURL } from './client-plugins-B9Sq-iMg.js';
+export { s as APIClient, h as APIClientError, b as APIClientOptions, i as APIClientSystemError, c as APIClientWithoutIntegrationsOptions, g as APIResult, G as APIRouteManifest, A as APIRouteRefMetadata, u as ApiClients, C as CacheKey, n as CacheOptions, l as CachePolicy, m as CacheScope, q as ClientOptions, a as FARM_API_ROUTE_META_SYMBOL, F as FARM_API_ROUTE_REF_SYMBOL, o as InvalidateOptions, I as InvalidateTarget, p as OptimisticOptions, O as OptimisticUpdate, j as RequestEvent, k as ResponseEvent, R as RetryOptions, r as RouteAPIClient, t as ServerAPIClient, S as ServerAPIClientOptions, d as ServerAPIClientWithoutIntegrationsOptions, f as StatusEvent, e as StatusPhase, B as applyServerFnOptimisticUpdates, w as createAPIClient, v as createApiClients, z as createServerAPIClient, y as getAPIRouteRefMetadata, x as isAPIRouteRef, E as resolveServerFnInvalidateTargets, D as settleServerFnOptimisticUpdates } from './client-DuQuQC1h.js';
+import { ah as ResolvedFarmAPIConfig } from './client-plugins-By6MVUX-.js';
+export { d4 as DEFAULT_FARM_API_BASE_PATH, d7 as FarmAPIConfig, d5 as FarmAPIConfigResolverContext, d6 as FarmAPIConfigValue, db as getFarmAPIBaseURL, da as normalizeFarmAPIBasePath, d9 as normalizeFarmAPIConfig, d8 as resolveFarmAPIConfig, dc as resolveFarmAPIRequestURL } from './client-plugins-By6MVUX-.js';
 import { Plugin } from 'vite';
 export { getAllowedAPIRouteMethods, invokeAPIRouteEndpoint, isWebResponse, normalizeRouteResponse, resolveAPIRouteEndpoint } from './api/runtime.js';
 export { A as APIRouteMatch, b as APIRouteParamValue, a as APIRouteParams, m as matchAPIRoute } from './route-pattern-W-SsJGSp.js';
 import './cache.js';
 import './types-CnH8DOqo.js';
-import './runtime-j1S3sDTh.js';
+import './runtime-BgDQzBiu.js';
 import './resolver-DadfRL6F.js';
 import './lifecycle-De0vQG45.js';
 import './renderer.js';
@@ -17,6 +17,7 @@ import './types-Cc8l9IqS.js';
 import 'db0';
 import 'unstorage';
 import 'react';
+import './integration-api-BT024nuJ.js';
 import '@farming-labs/orm';
 import './types-CKwggz9n.js';
 import '@farming-labs/docs';
@@ -36,7 +37,7 @@ import './font.js';
 import './after.js';
 import 'node:http';
 import './island-CfGru1MO.js';
-import './client-cache-Djy_TlE8.js';
+import './client-cache-BMxuFqwH.js';
 
 /** Return the same-origin path served by this Farm application. */
 declare function resolveFarmAPIServerBasePath(config: ResolvedFarmAPIConfig): string;

package/dist/api.mjs

@@ -1,26 +1,30 @@
 import {
   farmApiPlugin
-} from "./chunk-2LS3KKE7.mjs";
+} from "./chunk-JV7JUD7Q.mjs";
 import {
   APIClientError,
   FARM_API_ROUTE_META_SYMBOL,
   FARM_API_ROUTE_REF_SYMBOL,
+  applyServerFnOptimisticUpdates,
   createAPIClient,
   createApiClients,
   createServerAPIClient,
   getAPIRouteRefMetadata,
-  isAPIRouteRef
-} from "./chunk-75CGAL6E.mjs";
-import "./chunk-DLBUAJTK.mjs";
+  isAPIRouteRef,
+  resolveServerFnInvalidateTargets,
+  settleServerFnOptimisticUpdates
+} from "./chunk-IZBX2TEU.mjs";
+import "./chunk-DU3PKDVQ.mjs";
+import "./chunk-WMJGA32P.mjs";
 import "./chunk-YUE4CJNB.mjs";
-import "./chunk-ZFNK77WN.mjs";
+import "./chunk-6JNGOC37.mjs";
 import {
   APIRouteConflictError,
   APIRouteManager,
   API_ROUTE_METHODS
-} from "./chunk-MH27UH72.mjs";
+} from "./chunk-TT3E2JOF.mjs";
 import "./chunk-NXV52RNX.mjs";
-import "./chunk-WB75GIX2.mjs";
+import "./chunk-TQTB33JS.mjs";
 import "./chunk-STV7A2LH.mjs";
 import "./chunk-XNWHZQ6A.mjs";
 import "./chunk-SXWF4QRU.mjs";
@@ -48,7 +52,7 @@ import {
   normalizeRouteResponse,
   resolveAPIRouteEndpoint,
   resolvePluginRoutes
-} from "./chunk-D7QH7MDU.mjs";
+} from "./chunk-3TWQERDE.mjs";
 import "./chunk-4OAR7CTF.mjs";
 import {
   resolveFarmAPIServerBasePath
@@ -65,7 +69,7 @@ import {
   multipart,
   readJSONStream,
   toFormData
-} from "./chunk-XTLLHCWU.mjs";
+} from "./chunk-V4VRLVLW.mjs";
 import {
   DEFAULT_FARM_API_BASE_PATH,
   getFarmAPIBaseURL,
@@ -75,10 +79,10 @@ import {
   resolveFarmAPIRequestURL
 } from "./chunk-6YPPIPKR.mjs";
 import "./chunk-776TTMU3.mjs";
-import "./chunk-AXVJCMVF.mjs";
-import "./chunk-RBRLLZL5.mjs";
+import "./chunk-2HDOV47R.mjs";
+import "./chunk-34IAPZBG.mjs";
 import "./chunk-WZ5QFROO.mjs";
-import "./chunk-ZRBCBOEX.mjs";
+import "./chunk-N2FY2QZ7.mjs";
 import "./chunk-EDWCT2JF.mjs";
 import "./chunk-LM2YNO4U.mjs";
 import "./chunk-W4ZNS76E.mjs";
@@ -102,6 +106,7 @@ export {
   POST,
   PUT,
   QUERY,
+  applyServerFnOptimisticUpdates,
   createAPIClient,
   createApiClients,
   createEndpoint,
@@ -130,6 +135,8 @@ export {
   resolveFarmAPIRequestURL,
   resolveFarmAPIServerBasePath,
   resolvePluginRoutes,
+  resolveServerFnInvalidateTargets,
+  settleServerFnOptimisticUpdates,
   toFormData
 };
 //# sourceMappingURL=api.mjs.map

package/dist/{app-CIIEvA4r.d.ts → app-CIOx3LvY.d.ts}

@@ -1,4 +1,4 @@
-import { q as FarmConfig, P as ParsedRoute, ag as ResolvedFarmRouteRuntimeConfig, h as RouteModule, X as LayoutModule, a1 as SSGCollectionResult, Y as FarmRequest, Z as FarmResponse, ah as ResolvedFarmAPIConfig, j as FarmMdxResolvedConfig, ai as ResolvedFarmDevtoolsConfig, aj as ResolvedFarmDevIndicatorsConfig, ak as ResolvedFarmAuthConfig, al as ResolvedFarmPerformanceConfig, am as ResolvedFarmSecurityConfig } from './client-plugins-B9Sq-iMg.js';
+import { q as FarmConfig, P as ParsedRoute, ag as ResolvedFarmRouteRuntimeConfig, h as RouteModule, X as LayoutModule, a1 as SSGCollectionResult, Y as FarmRequest, Z as FarmResponse, ah as ResolvedFarmAPIConfig, j as FarmMdxResolvedConfig, ai as ResolvedFarmDevtoolsConfig, aj as ResolvedFarmDevIndicatorsConfig, ak as ResolvedFarmAuthConfig, al as ResolvedFarmPerformanceConfig, am as ResolvedFarmSecurityConfig } from './client-plugins-By6MVUX-.js';
 import { F as FarmDocsResolvedConfig } from './types-CKwggz9n.js';
 import { FarmMarkdownResolvedConfig } from './markdown.js';
 import { F as FarmWorkflowsResolvedConfig } from './workflows-ChyK_oTu.js';
@@ -7,11 +7,11 @@ import { R as ResolvedFarmImageConfig } from './image-config-Duob7wER.js';
 import { ProgrammaticRedirectRoute, ProgrammaticRouteSearchClientOptions } from './routes.js';
 import { ViteDevServer } from 'vite';
 import { F as FarmIslandStrategy } from './island-CfGru1MO.js';
-import { M as MetadataImageKind, A as ApplicationMetadataRouteKind } from './metadata-route-yV4U6X8h.js';
+import { M as MetadataImageKind, A as ApplicationMetadataRouteKind } from './metadata-route-8_V3UonT.js';
 import { FarmServerRendererRuntime, FarmRenderer } from './renderer.js';
-import { F as FarmRouteRenderPlan } from './render-plan-Dc8CjNI7.js';
+import { F as FarmRouteRenderPlan } from './render-plan-0GeHiGVZ.js';
 import { R as ResolvedFarmI18nConfig } from './types-CnH8DOqo.js';
-import { F as FarmI18nRuntime } from './runtime-j1S3sDTh.js';
+import { F as FarmI18nRuntime } from './runtime-BgDQzBiu.js';
 import { R as ResolvedFarmThemeConfig } from './types-DQnyD3VD.js';
 
 interface IsolatedClientBoundaryReference {

package/dist/{app-O4AEC1OH.d.mts → app-DBd6437H.d.mts}

@@ -1,4 +1,4 @@
-import { q as FarmConfig, P as ParsedRoute, ag as ResolvedFarmRouteRuntimeConfig, h as RouteModule, X as LayoutModule, a1 as SSGCollectionResult, Y as FarmRequest, Z as FarmResponse, ah as ResolvedFarmAPIConfig, j as FarmMdxResolvedConfig, ai as ResolvedFarmDevtoolsConfig, aj as ResolvedFarmDevIndicatorsConfig, ak as ResolvedFarmAuthConfig, al as ResolvedFarmPerformanceConfig, am as ResolvedFarmSecurityConfig } from './client-plugins-BvClItiL.mjs';
+import { q as FarmConfig, P as ParsedRoute, ag as ResolvedFarmRouteRuntimeConfig, h as RouteModule, X as LayoutModule, a1 as SSGCollectionResult, Y as FarmRequest, Z as FarmResponse, ah as ResolvedFarmAPIConfig, j as FarmMdxResolvedConfig, ai as ResolvedFarmDevtoolsConfig, aj as ResolvedFarmDevIndicatorsConfig, ak as ResolvedFarmAuthConfig, al as ResolvedFarmPerformanceConfig, am as ResolvedFarmSecurityConfig } from './client-plugins-B6-07YmP.mjs';
 import { F as FarmDocsResolvedConfig } from './types-CKwggz9n.mjs';
 import { FarmMarkdownResolvedConfig } from './markdown.mjs';
 import { F as FarmWorkflowsResolvedConfig } from './workflows-ChyK_oTu.mjs';
@@ -7,11 +7,11 @@ import { R as ResolvedFarmImageConfig } from './image-config-Duob7wER.mjs';
 import { ProgrammaticRedirectRoute, ProgrammaticRouteSearchClientOptions } from './routes.mjs';
 import { ViteDevServer } from 'vite';
 import { F as FarmIslandStrategy } from './island-CfGru1MO.mjs';
-import { M as MetadataImageKind, A as ApplicationMetadataRouteKind } from './metadata-route-p4K1l92V.mjs';
+import { M as MetadataImageKind, A as ApplicationMetadataRouteKind } from './metadata-route-CWP_HjGU.mjs';
 import { FarmServerRendererRuntime, FarmRenderer } from './renderer.mjs';
-import { F as FarmRouteRenderPlan } from './render-plan-CU31j-Jk.mjs';
+import { F as FarmRouteRenderPlan } from './render-plan-DLxJYAA5.mjs';
 import { R as ResolvedFarmI18nConfig } from './types-CnH8DOqo.mjs';
-import { F as FarmI18nRuntime } from './runtime-DDwvDtS4.mjs';
+import { F as FarmI18nRuntime } from './runtime-CV2UCV-5.mjs';
 import { R as ResolvedFarmThemeConfig } from './types-DQnyD3VD.mjs';
 
 interface IsolatedClientBoundaryReference {

package/dist/app-markdown.d.mts

@@ -1,7 +1,7 @@
-import { i as FarmMdxComponents, j as FarmMdxResolvedConfig, M as Metadata, h as RouteModule } from './client-plugins-BvClItiL.mjs';
-export { k as FarmMdxComponent, l as FarmMdxUserConfig, r as resolveMdxConfig } from './client-plugins-BvClItiL.mjs';
+import { i as FarmMdxComponents, j as FarmMdxResolvedConfig, M as Metadata, h as RouteModule } from './client-plugins-B6-07YmP.mjs';
+export { k as FarmMdxComponent, l as FarmMdxUserConfig, r as resolveMdxConfig } from './client-plugins-B6-07YmP.mjs';
 import './lifecycle-De0vQG45.mjs';
-import './route-Cq3aObmj.mjs';
+import './route-CvEr4Uc9.mjs';
 import './cache.mjs';
 import './renderer.mjs';
 import 'http';
@@ -9,6 +9,7 @@ import './types-Cc8l9IqS.mjs';
 import 'db0';
 import 'unstorage';
 import 'react';
+import './integration-api-BT024nuJ.mjs';
 import '@farming-labs/orm';
 import './types-CKwggz9n.mjs';
 import '@farming-labs/docs';

package/dist/app-markdown.d.ts

@@ -1,7 +1,7 @@
-import { i as FarmMdxComponents, j as FarmMdxResolvedConfig, M as Metadata, h as RouteModule } from './client-plugins-B9Sq-iMg.js';
-export { k as FarmMdxComponent, l as FarmMdxUserConfig, r as resolveMdxConfig } from './client-plugins-B9Sq-iMg.js';
+import { i as FarmMdxComponents, j as FarmMdxResolvedConfig, M as Metadata, h as RouteModule } from './client-plugins-By6MVUX-.js';
+export { k as FarmMdxComponent, l as FarmMdxUserConfig, r as resolveMdxConfig } from './client-plugins-By6MVUX-.js';
 import './lifecycle-De0vQG45.js';
-import './route-Y8lfz1wF.js';
+import './route-4pd-EVtw.js';
 import './cache.js';
 import './renderer.js';
 import 'http';
@@ -9,6 +9,7 @@ import './types-Cc8l9IqS.js';
 import 'db0';
 import 'unstorage';
 import 'react';
+import './integration-api-BT024nuJ.js';
 import '@farming-labs/orm';
 import './types-CKwggz9n.js';
 import '@farming-labs/docs';

package/dist/cache.cjs

@@ -111,7 +111,13 @@ function recordFarmEventTrace(event) {
       activeSpan.addEvent(event.type, toEventAttributes(event), event.timestamp);
     }
     const error = event.type === "request.error" ? void 0 : getEventError(event);
-    if (error !== void 0) recordSpanError(activeSpan, error);
+    if (error !== void 0) {
+      if (event.type === "render.error") {
+        recordSpanException(activeSpan, error);
+      } else {
+        recordSpanError(activeSpan, error);
+      }
+    }
   }
   const completedTraceContext = recordCompletedEventSpan(event, activeContext);
   return traceContext ?? completedTraceContext;
@@ -208,12 +214,26 @@ function getCompletedSpanDescriptor(event) {
   }
 }
 __name(getCompletedSpanDescriptor, "getCompletedSpanDescriptor");
+function hashFarmCacheKey(value) {
+  let hash = 2166136261;
+  for (let index = 0; index < value.length; index++) {
+    hash ^= value.charCodeAt(index);
+    hash = Math.imul(hash, 16777619);
+  }
+  return (hash >>> 0).toString(16).padStart(8, "0");
+}
+__name(hashFarmCacheKey, "hashFarmCacheKey");
 function toEventAttributes(event) {
   const attributes = {};
+  const redactKey = typeof event.type === "string" && event.type.startsWith("cache.");
   for (const [key, value] of Object.entries(event)) {
     if (key === "timestamp" || key === "level" || key === "error" || key === "traceId" || key === "spanId" || key === "traceSampled" || value === void 0) {
       continue;
     }
+    if (redactKey && key === "key" && typeof value === "string") {
+      attributes["farm.key_hash"] = hashFarmCacheKey(value);
+      continue;
+    }
     if (typeof value === "string" || typeof value === "number" || typeof value === "boolean") {
       attributes[`farm.${key}`] = value;
     } else if (Array.isArray(value)) {
@@ -233,9 +253,14 @@ function getEventError(event) {
   return "error" in event ? event.error : void 0;
 }
 __name(getEventError, "getEventError");
-function recordSpanError(span, error) {
+function recordSpanException(span, error) {
   const normalized = error instanceof Error ? error : new Error(String(error));
   span.recordException(normalized);
+  return normalized;
+}
+__name(recordSpanException, "recordSpanException");
+function recordSpanError(span, error) {
+  const normalized = recordSpanException(span, error);
   span.setStatus({ code: import_api.SpanStatusCode.ERROR, message: normalized.message });
 }
 __name(recordSpanError, "recordSpanError");
@@ -394,16 +419,29 @@ function getFarmCacheInvalidationState() {
   });
 }
 __name(getFarmCacheInvalidationState, "getFarmCacheInvalidationState");
+function warnFarmCacheListenerError(scope, error) {
+  const detail = error instanceof Error ? error.stack ?? error.message : String(error);
+  console.warn(`[farm:cache] ${scope} listener failed: ${detail}`);
+}
+__name(warnFarmCacheListenerError, "warnFarmCacheListenerError");
 function notifyFarmCacheInvalidation(key) {
   if (typeof key !== "string" || key.length === 0) return;
   for (const listener of getFarmCacheInvalidationState().listeners) {
-    listener(key);
+    try {
+      listener(key);
+    } catch (error) {
+      warnFarmCacheListenerError("invalidation", error);
+    }
   }
 }
 __name(notifyFarmCacheInvalidation, "notifyFarmCacheInvalidation");
 function notifyFarmCacheTask(task) {
   for (const listener of getFarmCacheInvalidationState().taskListeners) {
-    listener(task);
+    try {
+      listener(task);
+    } catch (error) {
+      warnFarmCacheListenerError("task", error);
+    }
   }
 }
 __name(notifyFarmCacheTask, "notifyFarmCacheTask");

package/dist/cache.d.mts

@@ -80,11 +80,25 @@ interface FarmCacheAdapter {
     /** Release the lease only when the supplied ownership token still matches. */
     releaseLease?(key: string, token: string): Promise<void>;
 }
+interface FarmClientCacheUserConfig {
+    /**
+     * Module path, relative to the project root, whose default export is a
+     * client cache adapter (`defineClientCacheAdapter`). The module is bundled
+     * into the browser entry; the server never imports it.
+     */
+    adapter?: string;
+    /** Extra version salt, typically a build or deploy id; entries persisted under another salt are dropped. */
+    version?: string;
+    /** Debounce for persisted write-behind flushes, in milliseconds. */
+    flushDelayMs?: number;
+}
 interface FarmCacheUserConfig {
     /** Shared cache implementation, for example a Redis-backed adapter. */
     adapter?: FarmCacheAdapter;
     /** Prefix isolating applications and deployments sharing one adapter. */
     namespace?: string;
+    /** Browser cache persistence; see the client cache adapter documentation. */
+    client?: FarmClientCacheUserConfig;
     /**
      * Coordinate cache fills across processes when the adapter implements
      * acquireLease/releaseLease. Set false to disable.
@@ -174,9 +188,62 @@ declare class FarmDataCache {
 }
 declare function getFarmDataCache(): FarmDataCache;
 declare function configureFarmCache(config: FarmCacheUserConfig | undefined): void;
+/**
+ * Wrap an async function so its results are cached and shared across requests,
+ * processes, and restarts.
+ *
+ * The cache key is built from the wrapped function's identity (its name and a
+ * hash of its source), the active locale, `keyParts`, and the call arguments.
+ * Deriving identity from the source — rather than the closure instance — is
+ * deliberate: it keeps the key stable across processes and restarts so a
+ * distributed cache adapter can share entries between server instances.
+ *
+ * The consequence is that two closures with **identical source text but
+ * different captured variables** produce the same identity. Pass those captured
+ * values in `keyParts` so they take part in the key; otherwise the closures
+ * share a cache entry and return each other's data:
+ *
+ * ```ts
+ * // Collides: both closures have identical source, and `table` is captured,
+ * // not an argument, so it never reaches the key.
+ * const makeLoader = (table: string) =>
+ *   unstable_cache(async (id: number) => db.get(table, id));
+ *
+ * // Correct: the captured value disambiguates the two closures.
+ * const makeLoader = (table: string) =>
+ *   unstable_cache(async (id: number) => db.get(table, id), [table]);
+ * ```
+ *
+ * Values passed as call arguments already participate in the key and do not
+ * need to be repeated in `keyParts`.
+ *
+ * @param fn The async function to memoize.
+ * @param keyParts Extra values that identify this call site. Include every
+ *   variable the function closes over that is not one of its arguments.
+ * @param options Tags, paths, and revalidation settings for the cached entry.
+ */
 declare function unstable_cache<Args extends unknown[], Result>(fn: (...args: Args) => Result | Promise<Result>, keyParts?: readonly unknown[], options?: FarmCacheOptions): (...args: Args) => Promise<Result>;
+/**
+ * Invalidate every cache entry carrying `tag`.
+ *
+ * Observability note: the `count` on the emitted `cache.revalidateTag` event is
+ * derived from Farm's process-local entry tracking. With a shared `cache.adapter`
+ * configured, entries live in the adapter rather than in local memory, so the
+ * count can read as `0` even though the invalidation is still propagated to the
+ * adapter and applied. Treat it as a best-effort signal, not a distributed count.
+ */
 declare function revalidateTag(_tag: string, _profile?: RevalidateTagProfile): void | Promise<void>;
 declare function updateTag(tag: string): void | Promise<void>;
+/**
+ * Invalidate cached data for a route path (and its PPR shell, if any).
+ *
+ * Observability note: the `count` on the emitted `cache.revalidatePath` event and
+ * the `ppr.shell.invalidated` event are derived from process-local entry tracking.
+ * With a shared `cache.adapter`, PPR shells live in the adapter rather than in
+ * local memory, so the count can read as `0` and `ppr.shell.invalidated` may not
+ * be emitted even though the invalidation is still propagated to the adapter and
+ * applied.
+ */
 declare function revalidatePath(routePath: string): void | Promise<void>;
 declare function invalidate(key: RouteDataCacheKey): void | Promise<void>;
 declare function invalidateRouteData(key: RouteDataCacheKey): void | Promise<void>;
@@ -191,4 +258,4 @@ declare function createRouteDataCacheKey(key: RouteDataCacheKey): string;
 declare function normalizeRevalidatePath(routePath: string): string;
 declare function createFarmCacheKey(parts: readonly unknown[]): string;
 
-export { type CacheKeyFactory, type DefinedCacheKey, type FarmCacheAdapter, type FarmCacheEntry, type FarmCacheInvalidationTarget, type FarmCacheOptions, type FarmCacheSetOptions, type FarmCacheStorage, type FarmCacheUserConfig, FarmDataCache, type GetFarmCacheEntryOptions, type InferCacheKeyData, type RevalidateTagProfile, type RouteDataCacheKey, type StorageFarmCacheAdapterOptions, applyFarmCacheInvalidationTargets, applyFarmCacheInvalidations, configureFarmCache, createFarmCacheKey, createPathCacheTag, createRouteDataCacheKey, createRouteDataCacheTag, defineCacheKey, getFarmDataCache, invalidate, invalidateRouteData, normalizeRevalidatePath, revalidatePath, revalidateTag, storageCacheAdapter, unstable_cache, updateTag };
+export { type CacheKeyFactory, type DefinedCacheKey, type FarmCacheAdapter, type FarmCacheEntry, type FarmCacheInvalidationTarget, type FarmCacheOptions, type FarmCacheSetOptions, type FarmCacheStorage, type FarmCacheUserConfig, type FarmClientCacheUserConfig, FarmDataCache, type GetFarmCacheEntryOptions, type InferCacheKeyData, type RevalidateTagProfile, type RouteDataCacheKey, type StorageFarmCacheAdapterOptions, applyFarmCacheInvalidationTargets, applyFarmCacheInvalidations, configureFarmCache, createFarmCacheKey, createPathCacheTag, createRouteDataCacheKey, createRouteDataCacheTag, defineCacheKey, getFarmDataCache, invalidate, invalidateRouteData, normalizeRevalidatePath, revalidatePath, revalidateTag, storageCacheAdapter, unstable_cache, updateTag };

package/dist/cache.d.ts

@@ -80,11 +80,25 @@ interface FarmCacheAdapter {
     /** Release the lease only when the supplied ownership token still matches. */
     releaseLease?(key: string, token: string): Promise<void>;
 }
+interface FarmClientCacheUserConfig {
+    /**
+     * Module path, relative to the project root, whose default export is a
+     * client cache adapter (`defineClientCacheAdapter`). The module is bundled
+     * into the browser entry; the server never imports it.
+     */
+    adapter?: string;
+    /** Extra version salt, typically a build or deploy id; entries persisted under another salt are dropped. */
+    version?: string;
+    /** Debounce for persisted write-behind flushes, in milliseconds. */
+    flushDelayMs?: number;
+}
 interface FarmCacheUserConfig {
     /** Shared cache implementation, for example a Redis-backed adapter. */
     adapter?: FarmCacheAdapter;
     /** Prefix isolating applications and deployments sharing one adapter. */
     namespace?: string;
+    /** Browser cache persistence; see the client cache adapter documentation. */
+    client?: FarmClientCacheUserConfig;
     /**
      * Coordinate cache fills across processes when the adapter implements
      * acquireLease/releaseLease. Set false to disable.
@@ -174,9 +188,62 @@ declare class FarmDataCache {
 }
 declare function getFarmDataCache(): FarmDataCache;
 declare function configureFarmCache(config: FarmCacheUserConfig | undefined): void;
+/**
+ * Wrap an async function so its results are cached and shared across requests,
+ * processes, and restarts.
+ *
+ * The cache key is built from the wrapped function's identity (its name and a
+ * hash of its source), the active locale, `keyParts`, and the call arguments.
+ * Deriving identity from the source — rather than the closure instance — is
+ * deliberate: it keeps the key stable across processes and restarts so a
+ * distributed cache adapter can share entries between server instances.
+ *
+ * The consequence is that two closures with **identical source text but
+ * different captured variables** produce the same identity. Pass those captured
+ * values in `keyParts` so they take part in the key; otherwise the closures
+ * share a cache entry and return each other's data:
+ *
+ * ```ts
+ * // Collides: both closures have identical source, and `table` is captured,
+ * // not an argument, so it never reaches the key.
+ * const makeLoader = (table: string) =>
+ *   unstable_cache(async (id: number) => db.get(table, id));
+ *
+ * // Correct: the captured value disambiguates the two closures.
+ * const makeLoader = (table: string) =>
+ *   unstable_cache(async (id: number) => db.get(table, id), [table]);
+ * ```
+ *
+ * Values passed as call arguments already participate in the key and do not
+ * need to be repeated in `keyParts`.
+ *
+ * @param fn The async function to memoize.
+ * @param keyParts Extra values that identify this call site. Include every
+ *   variable the function closes over that is not one of its arguments.
+ * @param options Tags, paths, and revalidation settings for the cached entry.
+ */
 declare function unstable_cache<Args extends unknown[], Result>(fn: (...args: Args) => Result | Promise<Result>, keyParts?: readonly unknown[], options?: FarmCacheOptions): (...args: Args) => Promise<Result>;
+/**
+ * Invalidate every cache entry carrying `tag`.
+ *
+ * Observability note: the `count` on the emitted `cache.revalidateTag` event is
+ * derived from Farm's process-local entry tracking. With a shared `cache.adapter`
+ * configured, entries live in the adapter rather than in local memory, so the
+ * count can read as `0` even though the invalidation is still propagated to the
+ * adapter and applied. Treat it as a best-effort signal, not a distributed count.
+ */
 declare function revalidateTag(_tag: string, _profile?: RevalidateTagProfile): void | Promise<void>;
 declare function updateTag(tag: string): void | Promise<void>;
+/**
+ * Invalidate cached data for a route path (and its PPR shell, if any).
+ *
+ * Observability note: the `count` on the emitted `cache.revalidatePath` event and
+ * the `ppr.shell.invalidated` event are derived from process-local entry tracking.
+ * With a shared `cache.adapter`, PPR shells live in the adapter rather than in
+ * local memory, so the count can read as `0` and `ppr.shell.invalidated` may not
+ * be emitted even though the invalidation is still propagated to the adapter and
+ * applied.
+ */
 declare function revalidatePath(routePath: string): void | Promise<void>;
 declare function invalidate(key: RouteDataCacheKey): void | Promise<void>;
 declare function invalidateRouteData(key: RouteDataCacheKey): void | Promise<void>;
@@ -191,4 +258,4 @@ declare function createRouteDataCacheKey(key: RouteDataCacheKey): string;
 declare function normalizeRevalidatePath(routePath: string): string;
 declare function createFarmCacheKey(parts: readonly unknown[]): string;
 
-export { type CacheKeyFactory, type DefinedCacheKey, type FarmCacheAdapter, type FarmCacheEntry, type FarmCacheInvalidationTarget, type FarmCacheOptions, type FarmCacheSetOptions, type FarmCacheStorage, type FarmCacheUserConfig, FarmDataCache, type GetFarmCacheEntryOptions, type InferCacheKeyData, type RevalidateTagProfile, type RouteDataCacheKey, type StorageFarmCacheAdapterOptions, applyFarmCacheInvalidationTargets, applyFarmCacheInvalidations, configureFarmCache, createFarmCacheKey, createPathCacheTag, createRouteDataCacheKey, createRouteDataCacheTag, defineCacheKey, getFarmDataCache, invalidate, invalidateRouteData, normalizeRevalidatePath, revalidatePath, revalidateTag, storageCacheAdapter, unstable_cache, updateTag };
+export { type CacheKeyFactory, type DefinedCacheKey, type FarmCacheAdapter, type FarmCacheEntry, type FarmCacheInvalidationTarget, type FarmCacheOptions, type FarmCacheSetOptions, type FarmCacheStorage, type FarmCacheUserConfig, type FarmClientCacheUserConfig, FarmDataCache, type GetFarmCacheEntryOptions, type InferCacheKeyData, type RevalidateTagProfile, type RouteDataCacheKey, type StorageFarmCacheAdapterOptions, applyFarmCacheInvalidationTargets, applyFarmCacheInvalidations, configureFarmCache, createFarmCacheKey, createPathCacheTag, createRouteDataCacheKey, createRouteDataCacheTag, defineCacheKey, getFarmDataCache, invalidate, invalidateRouteData, normalizeRevalidatePath, revalidatePath, revalidateTag, storageCacheAdapter, unstable_cache, updateTag };

package/dist/cache.mjs

@@ -16,12 +16,12 @@ import {
   storageCacheAdapter,
   unstable_cache,
   updateTag
-} from "./chunk-AXVJCMVF.mjs";
+} from "./chunk-2HDOV47R.mjs";
 import {
   applyFarmCacheInvalidations
-} from "./chunk-RBRLLZL5.mjs";
+} from "./chunk-34IAPZBG.mjs";
 import "./chunk-WZ5QFROO.mjs";
-import "./chunk-ZRBCBOEX.mjs";
+import "./chunk-N2FY2QZ7.mjs";
 import "./chunk-CGILA3WO.mjs";
 export {
   FarmDataCache,

package/dist/{chunk-AXVJCMVF.mjs → chunk-2HDOV47R.mjs}

@@ -1,13 +1,13 @@
 import {
   notifyFarmCacheInvalidation,
   notifyFarmCacheTask
-} from "./chunk-RBRLLZL5.mjs";
+} from "./chunk-34IAPZBG.mjs";
 import {
   getActiveFarmI18nSnapshot
 } from "./chunk-WZ5QFROO.mjs";
 import {
   emitFarmEvent
-} from "./chunk-ZRBCBOEX.mjs";
+} from "./chunk-N2FY2QZ7.mjs";
 import {
   __name
 } from "./chunk-CGILA3WO.mjs";
@@ -844,4 +844,4 @@ export {
   normalizeRevalidatePath,
   createFarmCacheKey
 };
-//# sourceMappingURL=chunk-AXVJCMVF.mjs.map
+//# sourceMappingURL=chunk-2HDOV47R.mjs.map