@farm.js/core 0.1.39 → 0.1.41

package/dist/ssg-1FGaFISl.d.ts

@@ -0,0 +1,184 @@
+import { R as RouteRenderingOptions, a as RouteRenderingConfig, D as DirectiveRenderingConfig } from './route-rendering-BLZT0IP0.js';
+import { ak as RouteModule, b4 as SSGCollectionResult, b3 as SSGPage } from './client-plugins-DfeKd0sD.js';
+
+/**
+ * The browser copy of a programmatic page or layout imports only the module that defines its
+ * component, never the routes file. Guards, data hooks, static paths, generated metadata, API
+ * handlers, and whatever the routes file imports for them stay out of the client graph because
+ * the client graph never reaches the routes file.
+ *
+ * Farm already evaluates the routes file on the server to build its route table. That
+ * evaluation also tells it where each component lives: the server module graph holds every
+ * module the routes file reached, with its exports, so the module that exports the very
+ * function (or object) a route uses as its `component` is that component's own module. This
+ * works for any way the route list is built (helpers, re-exported lists, assignments, aliases)
+ * because it reads the evaluated value instead of the routes file's syntax. A component that no
+ * other module exports (declared in the routes file, or computed there) has no module to
+ * import, so a client build that needs it fails with an actionable error.
+ *
+ * A module that holds route definitions is never a component's client import, however it holds
+ * them: Farm finds definitions in every evaluated module's exports (inside objects, arrays,
+ * maps, and sets), and route factories record the module that called them while routes are
+ * evaluated, which also finds definitions kept behind a function. A definition written as an
+ * object literal and kept out of every export can't be traced, so then a component module is
+ * accepted only when neither it nor anything it imports holds route-defining code.
+ */
+type ProgrammaticClientRouteKind = "page" | "layout";
+interface ProgrammaticClientModuleExport {
+    /** Absolute path of the module that exports the value. */
+    file: string;
+    /** The export name that holds it. */
+    exportName: string;
+}
+interface ProgrammaticClientRoute {
+    kind: ProgrammaticClientRouteKind;
+    path: string;
+    /** Absolute path of the routes file that defines the route. */
+    routesFile: string;
+    component?: ProgrammaticClientModuleExport;
+    pending?: ProgrammaticClientModuleExport;
+    /**
+     * The route options the server resolves into the page's props (params, search, guard, data).
+     * The browser copy renders only from props the server resolved.
+     */
+    serverProps?: string[];
+    /** Why the browser copy can't be generated, when it can't. */
+    problem?: string;
+}
+interface ProgrammaticClientRoutes {
+    /** Keyed by {@link programmaticClientRouteKey}. */
+    routes: ReadonlyMap<string, ProgrammaticClientRoute>;
+    /**
+     * Routes files and the modules that export route definitions. None of them may enter the
+     * client graph.
+     */
+    routeSourceFiles: ReadonlySet<string>;
+}
+
+/**
+ * Farm.js SSG (Static Site Generation) Module
+ *
+ * Handles collection and pre-rendering of SSG pages at build time.
+ *
+ * SSR is the default - pages render on each request
+ * SSG is opt-in via `export const ssg = true`, Next-compatible route
+ * config exports, or a top-of-file rendering directive.
+ *
+ * @example
+ * ```tsx
+ * // SSG Page
+ * export const ssg = true;
+ * export default function AboutPage() {
+ *   return <h1>About</h1>;
+ * }
+ *
+ * // SSG with ISR
+ * export const ssg = true;
+ * export const revalidate = 60;
+ * export default async function ProductsPage() {
+ *   const products = await fetchProducts();
+ *   return <ProductList products={products} />;
+ * }
+ *
+ * // Dynamic SSG
+ * export const ssg = true;
+ * export async function getStaticPaths() {
+ *   const posts = await fetchPosts();
+ *   return posts.map(post => ({ slug: post.slug }));
+ * }
+ * export default async function BlogPost({ params }) {
+ *   return <article>{params.slug}</article>;
+ * }
+ *
+ * // Next-compatible route config
+ * export const dynamic = "force-static";
+ * export const revalidate = 60;
+ *
+ * // PPR/static-shell route
+ * export const experimental_ppr = true;
+ * export const revalidate = 60;
+ *
+ * // Directive config
+ * "use ssg; 60";
+ * export default function DocsPage() {
+ *   return <h1>Docs</h1>;
+ * }
+ * ```
+ */
+
+interface RouteEntry {
+    path: string;
+    filePath: string;
+    isDynamic: boolean;
+    pattern: string;
+}
+
+interface StaticRouteCandidateAnalysis {
+    candidate: boolean;
+    blockers: string[];
+}
+/**
+ * Resolve the effective rendering mode. Direct request reads make an explicitly
+ * static route dynamic so request-specific HTML cannot enter a shared artifact.
+ */
+declare function resolveRouteRenderingConfig(mod: RouteModule | null | undefined, source?: string, options?: RouteRenderingOptions): RouteRenderingConfig;
+declare function resolveRouteRenderingConfigFromFile(mod: RouteModule | null | undefined, filePath: string, options?: RouteRenderingOptions): Promise<RouteRenderingConfig>;
+/**
+ * Conservatively identify a route that may be safe to pre-render.
+ *
+ * This intentionally produces a suggestion rather than changing rendering:
+ * request-bound work can live in a transitive import, which source inspection
+ * of the route module cannot prove safe. Explicit route config always wins.
+ */
+declare function analyzeStaticRouteCandidate(mod: RouteModule | null | undefined, source: string | undefined, options?: {
+    isDynamic?: boolean;
+}): StaticRouteCandidateAnalysis;
+declare function findRequestBoundSourceBlockers(source: string): string[];
+declare function parseRouteRenderingDirective(source: string | undefined): DirectiveRenderingConfig | undefined;
+/**
+ * A route's rendering directive as the production runtime needs it: the parsed directive plus
+ * whether its source reads request state. The runtime only sees module exports, so the build
+ * decides `requestBound` here and bakes it into the generated server entry, where
+ * `mergeRouteRenderingDirectiveConfig` combines it with the module's exports.
+ */
+declare function readRouteRenderingDirectiveFromFile(modulePath: string): DirectiveRenderingConfig | undefined;
+/**
+ * Collect SSG pages from route modules
+ *
+ * Scans all routes and categorizes them into:
+ * - SSG pages: Pre-rendered at build time
+ * - SSR routes: Rendered on each request
+ *
+ * @param routes - Array of route entries
+ * @param loadModule - Function to load a route module
+ * @returns SSG pages and SSR routes
+ */
+declare function collectSSGPages(routes: RouteEntry[], loadModule: (filePath: string) => Promise<RouteModule>, options?: {
+    suggestStaticRendering?: boolean;
+}): Promise<SSGCollectionResult>;
+/**
+ * Check if a route module is SSG
+ */
+declare function isSSGModule(mod: RouteModule | null | undefined): boolean;
+/**
+ * Check if a route module has ISR (Incremental Static Regeneration)
+ */
+declare function hasISR(mod: RouteModule | null | undefined): boolean;
+/**
+ * Get revalidation interval for a module
+ */
+declare function getRevalidateInterval(mod: RouteModule | null | undefined): number | undefined;
+/**
+ * Check if a route module has PPR/static-shell caching enabled.
+ */
+declare function hasPPR(mod: RouteModule | null | undefined, options?: RouteRenderingOptions): boolean;
+/**
+ * Generate SSG manifest for production builds
+ */
+declare function generateSSGManifest(pages: SSGPage[]): string;
+/**
+ * Check if a URL path matches an SSG page
+ */
+declare function matchSSGPage(urlPath: string, ssgPages: SSGPage[]): SSGPage | undefined;
+
+export { type ProgrammaticClientRoutes as P, type StaticRouteCandidateAnalysis as S, resolveRouteRenderingConfig as a, resolveRouteRenderingConfigFromFile as b, analyzeStaticRouteCandidate as c, collectSSGPages as d, hasPPR as e, findRequestBoundSourceBlockers as f, getRevalidateInterval as g, hasISR as h, isSSGModule as i, generateSSGManifest as j, matchSSGPage as m, parseRouteRenderingDirective as p, readRouteRenderingDirectiveFromFile as r };

package/dist/ssg-Bg4bMMhM.d.mts

@@ -0,0 +1,184 @@
+import { R as RouteRenderingOptions, a as RouteRenderingConfig, D as DirectiveRenderingConfig } from './route-rendering-BCM1QzEf.mjs';
+import { ak as RouteModule, b4 as SSGCollectionResult, b3 as SSGPage } from './client-plugins-CkYwvDJ0.mjs';
+
+/**
+ * The browser copy of a programmatic page or layout imports only the module that defines its
+ * component, never the routes file. Guards, data hooks, static paths, generated metadata, API
+ * handlers, and whatever the routes file imports for them stay out of the client graph because
+ * the client graph never reaches the routes file.
+ *
+ * Farm already evaluates the routes file on the server to build its route table. That
+ * evaluation also tells it where each component lives: the server module graph holds every
+ * module the routes file reached, with its exports, so the module that exports the very
+ * function (or object) a route uses as its `component` is that component's own module. This
+ * works for any way the route list is built (helpers, re-exported lists, assignments, aliases)
+ * because it reads the evaluated value instead of the routes file's syntax. A component that no
+ * other module exports (declared in the routes file, or computed there) has no module to
+ * import, so a client build that needs it fails with an actionable error.
+ *
+ * A module that holds route definitions is never a component's client import, however it holds
+ * them: Farm finds definitions in every evaluated module's exports (inside objects, arrays,
+ * maps, and sets), and route factories record the module that called them while routes are
+ * evaluated, which also finds definitions kept behind a function. A definition written as an
+ * object literal and kept out of every export can't be traced, so then a component module is
+ * accepted only when neither it nor anything it imports holds route-defining code.
+ */
+type ProgrammaticClientRouteKind = "page" | "layout";
+interface ProgrammaticClientModuleExport {
+    /** Absolute path of the module that exports the value. */
+    file: string;
+    /** The export name that holds it. */
+    exportName: string;
+}
+interface ProgrammaticClientRoute {
+    kind: ProgrammaticClientRouteKind;
+    path: string;
+    /** Absolute path of the routes file that defines the route. */
+    routesFile: string;
+    component?: ProgrammaticClientModuleExport;
+    pending?: ProgrammaticClientModuleExport;
+    /**
+     * The route options the server resolves into the page's props (params, search, guard, data).
+     * The browser copy renders only from props the server resolved.
+     */
+    serverProps?: string[];
+    /** Why the browser copy can't be generated, when it can't. */
+    problem?: string;
+}
+interface ProgrammaticClientRoutes {
+    /** Keyed by {@link programmaticClientRouteKey}. */
+    routes: ReadonlyMap<string, ProgrammaticClientRoute>;
+    /**
+     * Routes files and the modules that export route definitions. None of them may enter the
+     * client graph.
+     */
+    routeSourceFiles: ReadonlySet<string>;
+}
+
+/**
+ * Farm.js SSG (Static Site Generation) Module
+ *
+ * Handles collection and pre-rendering of SSG pages at build time.
+ *
+ * SSR is the default - pages render on each request
+ * SSG is opt-in via `export const ssg = true`, Next-compatible route
+ * config exports, or a top-of-file rendering directive.
+ *
+ * @example
+ * ```tsx
+ * // SSG Page
+ * export const ssg = true;
+ * export default function AboutPage() {
+ *   return <h1>About</h1>;
+ * }
+ *
+ * // SSG with ISR
+ * export const ssg = true;
+ * export const revalidate = 60;
+ * export default async function ProductsPage() {
+ *   const products = await fetchProducts();
+ *   return <ProductList products={products} />;
+ * }
+ *
+ * // Dynamic SSG
+ * export const ssg = true;
+ * export async function getStaticPaths() {
+ *   const posts = await fetchPosts();
+ *   return posts.map(post => ({ slug: post.slug }));
+ * }
+ * export default async function BlogPost({ params }) {
+ *   return <article>{params.slug}</article>;
+ * }
+ *
+ * // Next-compatible route config
+ * export const dynamic = "force-static";
+ * export const revalidate = 60;
+ *
+ * // PPR/static-shell route
+ * export const experimental_ppr = true;
+ * export const revalidate = 60;
+ *
+ * // Directive config
+ * "use ssg; 60";
+ * export default function DocsPage() {
+ *   return <h1>Docs</h1>;
+ * }
+ * ```
+ */
+
+interface RouteEntry {
+    path: string;
+    filePath: string;
+    isDynamic: boolean;
+    pattern: string;
+}
+
+interface StaticRouteCandidateAnalysis {
+    candidate: boolean;
+    blockers: string[];
+}
+/**
+ * Resolve the effective rendering mode. Direct request reads make an explicitly
+ * static route dynamic so request-specific HTML cannot enter a shared artifact.
+ */
+declare function resolveRouteRenderingConfig(mod: RouteModule | null | undefined, source?: string, options?: RouteRenderingOptions): RouteRenderingConfig;
+declare function resolveRouteRenderingConfigFromFile(mod: RouteModule | null | undefined, filePath: string, options?: RouteRenderingOptions): Promise<RouteRenderingConfig>;
+/**
+ * Conservatively identify a route that may be safe to pre-render.
+ *
+ * This intentionally produces a suggestion rather than changing rendering:
+ * request-bound work can live in a transitive import, which source inspection
+ * of the route module cannot prove safe. Explicit route config always wins.
+ */
+declare function analyzeStaticRouteCandidate(mod: RouteModule | null | undefined, source: string | undefined, options?: {
+    isDynamic?: boolean;
+}): StaticRouteCandidateAnalysis;
+declare function findRequestBoundSourceBlockers(source: string): string[];
+declare function parseRouteRenderingDirective(source: string | undefined): DirectiveRenderingConfig | undefined;
+/**
+ * A route's rendering directive as the production runtime needs it: the parsed directive plus
+ * whether its source reads request state. The runtime only sees module exports, so the build
+ * decides `requestBound` here and bakes it into the generated server entry, where
+ * `mergeRouteRenderingDirectiveConfig` combines it with the module's exports.
+ */
+declare function readRouteRenderingDirectiveFromFile(modulePath: string): DirectiveRenderingConfig | undefined;
+/**
+ * Collect SSG pages from route modules
+ *
+ * Scans all routes and categorizes them into:
+ * - SSG pages: Pre-rendered at build time
+ * - SSR routes: Rendered on each request
+ *
+ * @param routes - Array of route entries
+ * @param loadModule - Function to load a route module
+ * @returns SSG pages and SSR routes
+ */
+declare function collectSSGPages(routes: RouteEntry[], loadModule: (filePath: string) => Promise<RouteModule>, options?: {
+    suggestStaticRendering?: boolean;
+}): Promise<SSGCollectionResult>;
+/**
+ * Check if a route module is SSG
+ */
+declare function isSSGModule(mod: RouteModule | null | undefined): boolean;
+/**
+ * Check if a route module has ISR (Incremental Static Regeneration)
+ */
+declare function hasISR(mod: RouteModule | null | undefined): boolean;
+/**
+ * Get revalidation interval for a module
+ */
+declare function getRevalidateInterval(mod: RouteModule | null | undefined): number | undefined;
+/**
+ * Check if a route module has PPR/static-shell caching enabled.
+ */
+declare function hasPPR(mod: RouteModule | null | undefined, options?: RouteRenderingOptions): boolean;
+/**
+ * Generate SSG manifest for production builds
+ */
+declare function generateSSGManifest(pages: SSGPage[]): string;
+/**
+ * Check if a URL path matches an SSG page
+ */
+declare function matchSSGPage(urlPath: string, ssgPages: SSGPage[]): SSGPage | undefined;
+
+export { type ProgrammaticClientRoutes as P, type StaticRouteCandidateAnalysis as S, resolveRouteRenderingConfig as a, resolveRouteRenderingConfigFromFile as b, analyzeStaticRouteCandidate as c, collectSSGPages as d, hasPPR as e, findRequestBoundSourceBlockers as f, getRevalidateInterval as g, hasISR as h, isSSGModule as i, generateSSGManifest as j, matchSSGPage as m, parseRouteRenderingDirective as p, readRouteRenderingDirectiveFromFile as r };

package/dist/storage.cjs

@@ -25,7 +25,9 @@
 
 
 
-var _chunk4ZFL5GFNcjs = require('./chunk-4ZFL5GFN.cjs');
+
+
+var _chunkOILHPMFXcjs = require('./chunk-OILHPMFX.cjs');
 require('./chunk-S3JO3N4H.cjs');
 
 
@@ -54,4 +56,6 @@ require('./chunk-S3JO3N4H.cjs');
 
 
 
-exports.createFarmStorage = _chunk4ZFL5GFNcjs.createFarmStorage; exports.createStorageClient = _chunk4ZFL5GFNcjs.createStorageClient; exports.databaseStorage = _chunk4ZFL5GFNcjs.databaseStorage; exports.defineStorageClient = _chunk4ZFL5GFNcjs.defineStorageClient; exports.disposeStorage = _chunk4ZFL5GFNcjs.disposeStorage; exports.driverStorage = _chunk4ZFL5GFNcjs.driverStorage; exports.getStorage = _chunk4ZFL5GFNcjs.getStorage; exports.initStorage = _chunk4ZFL5GFNcjs.initStorage; exports.libsqlStorage = _chunk4ZFL5GFNcjs.libsqlStorage; exports.localStorage = _chunk4ZFL5GFNcjs.localStorage; exports.memoryStorage = _chunk4ZFL5GFNcjs.memoryStorage; exports.mongodbStorage = _chunk4ZFL5GFNcjs.mongodbStorage; exports.mysql2Storage = _chunk4ZFL5GFNcjs.mysql2Storage; exports.mysqlStorage = _chunk4ZFL5GFNcjs.mysqlStorage; exports.netlifyBlobsStorage = _chunk4ZFL5GFNcjs.netlifyBlobsStorage; exports.pgStorage = _chunk4ZFL5GFNcjs.pgStorage; exports.pgliteStorage = _chunk4ZFL5GFNcjs.pgliteStorage; exports.planetscaleStorage = _chunk4ZFL5GFNcjs.planetscaleStorage; exports.postgresStorage = _chunk4ZFL5GFNcjs.postgresStorage; exports.redisStorage = _chunk4ZFL5GFNcjs.redisStorage; exports.resolveStorageRuntimeClient = _chunk4ZFL5GFNcjs.resolveStorageRuntimeClient; exports.s3Storage = _chunk4ZFL5GFNcjs.s3Storage; exports.sqliteStorage = _chunk4ZFL5GFNcjs.sqliteStorage; exports.upstashStorage = _chunk4ZFL5GFNcjs.upstashStorage; exports.vercelBlobStorage = _chunk4ZFL5GFNcjs.vercelBlobStorage; exports.vercelKVStorage = _chunk4ZFL5GFNcjs.vercelKVStorage;
+
+
+exports._collectFarmStorageModules = _chunkOILHPMFXcjs._collectFarmStorageModules; exports._registerFarmStorageModules = _chunkOILHPMFXcjs._registerFarmStorageModules; exports.createFarmStorage = _chunkOILHPMFXcjs.createFarmStorage; exports.createStorageClient = _chunkOILHPMFXcjs.createStorageClient; exports.databaseStorage = _chunkOILHPMFXcjs.databaseStorage; exports.defineStorageClient = _chunkOILHPMFXcjs.defineStorageClient; exports.disposeStorage = _chunkOILHPMFXcjs.disposeStorage; exports.driverStorage = _chunkOILHPMFXcjs.driverStorage; exports.getStorage = _chunkOILHPMFXcjs.getStorage; exports.initStorage = _chunkOILHPMFXcjs.initStorage; exports.libsqlStorage = _chunkOILHPMFXcjs.libsqlStorage; exports.localStorage = _chunkOILHPMFXcjs.localStorage; exports.memoryStorage = _chunkOILHPMFXcjs.memoryStorage; exports.mongodbStorage = _chunkOILHPMFXcjs.mongodbStorage; exports.mysql2Storage = _chunkOILHPMFXcjs.mysql2Storage; exports.mysqlStorage = _chunkOILHPMFXcjs.mysqlStorage; exports.netlifyBlobsStorage = _chunkOILHPMFXcjs.netlifyBlobsStorage; exports.pgStorage = _chunkOILHPMFXcjs.pgStorage; exports.pgliteStorage = _chunkOILHPMFXcjs.pgliteStorage; exports.planetscaleStorage = _chunkOILHPMFXcjs.planetscaleStorage; exports.postgresStorage = _chunkOILHPMFXcjs.postgresStorage; exports.redisStorage = _chunkOILHPMFXcjs.redisStorage; exports.resolveStorageRuntimeClient = _chunkOILHPMFXcjs.resolveStorageRuntimeClient; exports.s3Storage = _chunkOILHPMFXcjs.s3Storage; exports.sqliteStorage = _chunkOILHPMFXcjs.sqliteStorage; exports.upstashStorage = _chunkOILHPMFXcjs.upstashStorage; exports.vercelBlobStorage = _chunkOILHPMFXcjs.vercelBlobStorage; exports.vercelKVStorage = _chunkOILHPMFXcjs.vercelKVStorage;

package/dist/storage.d.mts

@@ -6,6 +6,9 @@ import { F as FarmStorageClient, a as FarmStorageClientConfig, b as FarmStorageL
 export { e as FarmStorageBuiltinDriverConfig, f as FarmStorageConfigObject, g as FarmStorageCustomDriverConfig, h as FarmStorageDatabaseDriverName, j as FarmStorageMountConfig, k as FarmStorageMounts, i as FarmStorageRuntimeClient } from './types-Cc8l9IqS.mjs';
 
 type DriverResolver = () => Driver | Promise<Driver>;
+type StorageModuleLoaders = Record<string, () => Promise<unknown>>;
+/** @internal Register literal imports for the storage driver modules a build needs. */
+declare function _registerFarmStorageModules(loaders: StorageModuleLoaders): void;
 declare function defineStorageClient(resolveDriver: DriverResolver): FarmStorageClient;
 declare function createStorageClient(config: FarmStorageClientConfig): FarmStorageClient;
 declare function driverStorage(driver: Driver | (() => Driver | Promise<Driver>)): FarmStorageClient;
@@ -43,10 +46,15 @@ declare function vercelKVStorage(options: Omit<Extract<FarmStorageClientConfig,
 declare function vercelBlobStorage(options: Omit<Extract<FarmStorageClientConfig, {
     driver: "vercel-blob";
 }>, "driver">): FarmStorageClient;
+/**
+ * @internal The driver modules `config` loads by name. A production build
+ * imports each one literally so the server bundle contains it.
+ */
+declare function _collectFarmStorageModules(config: FarmStorageUserConfig | undefined): string[];
 declare function createFarmStorage(config?: FarmStorageUserConfig): Promise<Storage>;
 declare function resolveStorageRuntimeClient(config: FarmStorageUserConfig | undefined): Promise<unknown | undefined>;
 declare function initStorage(config?: FarmStorageUserConfig): Promise<Storage>;
 declare function getStorage(namespace?: string): Storage;
 declare function disposeStorage(): Promise<void>;
 
-export { FarmStorageClient, FarmStorageClientConfig, FarmStorageDatabaseConfig, FarmStorageLocalDriverConfig, FarmStorageUserConfig, createFarmStorage, createStorageClient, databaseStorage, defineStorageClient, disposeStorage, driverStorage, getStorage, initStorage, libsqlStorage, localStorage, memoryStorage, mongodbStorage, mysql2Storage, mysqlStorage, netlifyBlobsStorage, pgStorage, pgliteStorage, planetscaleStorage, postgresStorage, redisStorage, resolveStorageRuntimeClient, s3Storage, sqliteStorage, upstashStorage, vercelBlobStorage, vercelKVStorage };
+export { FarmStorageClient, FarmStorageClientConfig, FarmStorageDatabaseConfig, FarmStorageLocalDriverConfig, FarmStorageUserConfig, _collectFarmStorageModules, _registerFarmStorageModules, createFarmStorage, createStorageClient, databaseStorage, defineStorageClient, disposeStorage, driverStorage, getStorage, initStorage, libsqlStorage, localStorage, memoryStorage, mongodbStorage, mysql2Storage, mysqlStorage, netlifyBlobsStorage, pgStorage, pgliteStorage, planetscaleStorage, postgresStorage, redisStorage, resolveStorageRuntimeClient, s3Storage, sqliteStorage, upstashStorage, vercelBlobStorage, vercelKVStorage };

package/dist/storage.d.ts

@@ -6,6 +6,9 @@ import { F as FarmStorageClient, a as FarmStorageClientConfig, b as FarmStorageL
 export { e as FarmStorageBuiltinDriverConfig, f as FarmStorageConfigObject, g as FarmStorageCustomDriverConfig, h as FarmStorageDatabaseDriverName, j as FarmStorageMountConfig, k as FarmStorageMounts, i as FarmStorageRuntimeClient } from './types-Cc8l9IqS.js';
 
 type DriverResolver = () => Driver | Promise<Driver>;
+type StorageModuleLoaders = Record<string, () => Promise<unknown>>;
+/** @internal Register literal imports for the storage driver modules a build needs. */
+declare function _registerFarmStorageModules(loaders: StorageModuleLoaders): void;
 declare function defineStorageClient(resolveDriver: DriverResolver): FarmStorageClient;
 declare function createStorageClient(config: FarmStorageClientConfig): FarmStorageClient;
 declare function driverStorage(driver: Driver | (() => Driver | Promise<Driver>)): FarmStorageClient;
@@ -43,10 +46,15 @@ declare function vercelKVStorage(options: Omit<Extract<FarmStorageClientConfig,
 declare function vercelBlobStorage(options: Omit<Extract<FarmStorageClientConfig, {
     driver: "vercel-blob";
 }>, "driver">): FarmStorageClient;
+/**
+ * @internal The driver modules `config` loads by name. A production build
+ * imports each one literally so the server bundle contains it.
+ */
+declare function _collectFarmStorageModules(config: FarmStorageUserConfig | undefined): string[];
 declare function createFarmStorage(config?: FarmStorageUserConfig): Promise<Storage>;
 declare function resolveStorageRuntimeClient(config: FarmStorageUserConfig | undefined): Promise<unknown | undefined>;
 declare function initStorage(config?: FarmStorageUserConfig): Promise<Storage>;
 declare function getStorage(namespace?: string): Storage;
 declare function disposeStorage(): Promise<void>;
 
-export { FarmStorageClient, FarmStorageClientConfig, FarmStorageDatabaseConfig, FarmStorageLocalDriverConfig, FarmStorageUserConfig, createFarmStorage, createStorageClient, databaseStorage, defineStorageClient, disposeStorage, driverStorage, getStorage, initStorage, libsqlStorage, localStorage, memoryStorage, mongodbStorage, mysql2Storage, mysqlStorage, netlifyBlobsStorage, pgStorage, pgliteStorage, planetscaleStorage, postgresStorage, redisStorage, resolveStorageRuntimeClient, s3Storage, sqliteStorage, upstashStorage, vercelBlobStorage, vercelKVStorage };
+export { FarmStorageClient, FarmStorageClientConfig, FarmStorageDatabaseConfig, FarmStorageLocalDriverConfig, FarmStorageUserConfig, _collectFarmStorageModules, _registerFarmStorageModules, createFarmStorage, createStorageClient, databaseStorage, defineStorageClient, disposeStorage, driverStorage, getStorage, initStorage, libsqlStorage, localStorage, memoryStorage, mongodbStorage, mysql2Storage, mysqlStorage, netlifyBlobsStorage, pgStorage, pgliteStorage, planetscaleStorage, postgresStorage, redisStorage, resolveStorageRuntimeClient, s3Storage, sqliteStorage, upstashStorage, vercelBlobStorage, vercelKVStorage };

package/dist/storage.mjs

@@ -1,4 +1,6 @@
 import {
+  _collectFarmStorageModules,
+  _registerFarmStorageModules,
   createFarmStorage,
   createStorageClient,
   databaseStorage,
@@ -25,9 +27,11 @@ import {
   upstashStorage,
   vercelBlobStorage,
   vercelKVStorage
-} from "./chunk-UWPLULNK.mjs";
+} from "./chunk-JGHCKIRI.mjs";
 import "./chunk-LPEX4YW6.mjs";
 export {
+  _collectFarmStorageModules,
+  _registerFarmStorageModules,
   createFarmStorage,
   createStorageClient,
   databaseStorage,

package/dist/testing.cjs

@@ -1,6 +1,6 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } }
 
-var _chunkTO4GJ56Kcjs = require('./chunk-TO4GJ56K.cjs');
+var _chunkFEYQCYT7cjs = require('./chunk-FEYQCYT7.cjs');
 
 
 
@@ -8,40 +8,42 @@ var _chunkSU7MH53Pcjs = require('./chunk-SU7MH53P.cjs');
 require('./chunk-PCOTGFSM.cjs');
 
 
-var _chunkT5OJPTVNcjs = require('./chunk-T5OJPTVN.cjs');
+var _chunkP4TYB4SFcjs = require('./chunk-P4TYB4SF.cjs');
 
 
 
 var _chunk6QQDAAAZcjs = require('./chunk-6QQDAAAZ.cjs');
-require('./chunk-RWFLWR5J.cjs');
-require('./chunk-FUCSUGDM.cjs');
+require('./chunk-S7MTDRYA.cjs');
+require('./chunk-KF6VDJH7.cjs');
 require('./chunk-2CQ74SP6.cjs');
 require('./chunk-XJXBIP67.cjs');
 require('./chunk-UFDAAQFX.cjs');
 require('./chunk-LYLEZIG3.cjs');
 
 
-var _chunkXKG2BLFNcjs = require('./chunk-XKG2BLFN.cjs');
-require('./chunk-IWZKTWHZ.cjs');
+var _chunkQIBP5EFAcjs = require('./chunk-QIBP5EFA.cjs');
+require('./chunk-WU7ZS3EM.cjs');
 require('./chunk-WMAPPDMM.cjs');
 require('./chunk-TKJZFIML.cjs');
 require('./chunk-75RZHGLS.cjs');
-require('./chunk-6V4TDWEC.cjs');
+require('./chunk-CGVPXIRN.cjs');
 require('./chunk-SOR334EB.cjs');
 
 
-var _chunkYWN746UScjs = require('./chunk-YWN746US.cjs');
-require('./chunk-LSKZMJMP.cjs');
+var _chunk6MVFHNYZcjs = require('./chunk-6MVFHNYZ.cjs');
+require('./chunk-64SBBZDU.cjs');
 require('./chunk-SVRTJOUF.cjs');
-require('./chunk-KIIMAWOJ.cjs');
-require('./chunk-SHLXACIO.cjs');
+require('./chunk-VQDBNVOO.cjs');
+require('./chunk-PJ42JESY.cjs');
 require('./chunk-HLJ6MBUZ.cjs');
 require('./chunk-5QIKR7RR.cjs');
 
 
 var _chunkQNPEUFHQcjs = require('./chunk-QNPEUFHQ.cjs');
-require('./chunk-E3UK5IIB.cjs');
+require('./chunk-GS3WR5HX.cjs');
 require('./chunk-KNBBQHO2.cjs');
+require('./chunk-5NAVKJCZ.cjs');
+require('./chunk-4TLUFAIP.cjs');
 require('./chunk-ARJWXNQL.cjs');
 
 
@@ -52,9 +54,9 @@ require('./chunk-AI7QMY7O.cjs');
 require('./chunk-LIUGYUX3.cjs');
 require('./chunk-NYJMY3JA.cjs');
 require('./chunk-ZEG3OPIB.cjs');
-require('./chunk-6XWDE2P2.cjs');
+require('./chunk-ZTP3BJG6.cjs');
 require('./chunk-US2QVW3E.cjs');
-require('./chunk-ULASELLA.cjs');
+require('./chunk-6IZWX6ES.cjs');
 require('./chunk-BIDYX3SL.cjs');
 require('./chunk-I57LW5VZ.cjs');
 require('./chunk-NO3WWW3N.cjs');
@@ -128,7 +130,7 @@ function createFarmTestHarness(options = {}) {
         },
         routeContext
       );
-      const routeModule = _chunkTO4GJ56Kcjs.createRouteModuleFromProgrammaticPage.call(void 0, route);
+      const routeModule = _chunkFEYQCYT7cjs.createRouteModuleFromProgrammaticPage.call(void 0, route);
       const resolveProps = routeModule.__farmResolveRouteProps;
       const resolvedProps = resolveProps ? await resolveProps(rawProps) : { ...rawProps, search, searchParams: Promise.resolve(search) };
       const canonicalPath = readCanonicalPath(resolvedProps);
@@ -179,10 +181,10 @@ function createFarmTestHarness(options = {}) {
         signal: serverFnOptions.signal,
         method: "POST"
       })));
-      return await _chunkT5OJPTVNcjs.runWithServerActionRequest.call(void 0, actionRequest, () => serverFn(input));
+      return await _chunkP4TYB4SFcjs.runWithServerActionRequest.call(void 0, actionRequest, () => serverFn(input));
     },
     clearCache() {
-      _chunkYWN746UScjs.getFarmDataCache.call(void 0, ).clear();
+      _chunk6MVFHNYZcjs.getFarmDataCache.call(void 0, ).clear();
     }
   };
 }
@@ -329,7 +331,7 @@ function omitEndpointControlOptions(options) {
 _chunkS3JO3N4Hcjs.__name.call(void 0, omitEndpointControlOptions, "omitEndpointControlOptions");
 async function invokeTestEndpoint(endpoint, request, params = {}, throwOnError = false) {
   try {
-    return await _chunkXKG2BLFNcjs.invokeAPIRouteEndpoint.call(void 0, endpoint, request, params);
+    return await _chunkQIBP5EFAcjs.invokeAPIRouteEndpoint.call(void 0, endpoint, request, params);
   } catch (error) {
     if (throwOnError) throw error;
     return jsonErrorResponse(error instanceof Error ? error.message : "Internal Server Error", 500);

package/dist/testing.d.mts

@@ -1,13 +1,13 @@
 import { ReactElement } from 'react';
-import { D as FarmContextFactory, E as MiddlewareProps, q as PluginContextProps, s as RouteModule } from './client-plugins-CsCuCLBz.mjs';
-import { ServerFn } from './server-fn.mjs';
+import { av as FarmContextFactory, aw as MiddlewareProps, aj as PluginContextProps, ak as RouteModule } from './client-plugins-CkYwvDJ0.mjs';
 import './types-CnH8DOqo.mjs';
 import { a as APIRouteParams } from './route-pattern-W-SsJGSp.mjs';
+import { ServerFn } from './server-fn.mjs';
 import { ProgrammaticPageRoute, InferProgrammaticRouteData, ProgrammaticRouteComponentProps, ProgrammaticApiRoute } from './routes.mjs';
 import { FarmRouterQueryValue, FarmRouterPathParams } from './router.mjs';
 import './lifecycle-DK06VuKP.mjs';
-import './integration-api-0y4FXJpC.mjs';
-import './endpoint-CCHFqyTE.mjs';
+import './integration-api-DWyMmvrR.mjs';
+import './endpoint-DGZRZHux.mjs';
 import './cache.mjs';
 import './cache-invalidation-BD0z_lfu.mjs';
 import './renderer.mjs';
@@ -24,18 +24,16 @@ import '@farming-labs/docs';
 import './observability-CoXunYhS.mjs';
 import '@opentelemetry/api';
 import 'vite';
-import './workflows-jZ4BcdoZ.mjs';
+import './workflows-IWP1ddBm.mjs';
 import './cron.mjs';
 import './env.mjs';
 import './server-action-security.mjs';
+import './layers-CM5i6T7z.mjs';
 import 'rolldown/utils';
 import 'rolldown';
-import './image-config-Duob7wER.mjs';
+import './image-config-BpH1q5R8.mjs';
 import './types-DQnyD3VD.mjs';
 import './font.mjs';
-import './after.mjs';
-import 'node:http';
-import './island-CfGru1MO.mjs';
 
 type FarmTestQuery = URLSearchParams | Record<string, FarmRouterQueryValue>;
 type FarmTestPathParams = FarmRouterPathParams;

package/dist/testing.d.ts

@@ -1,13 +1,13 @@
 import { ReactElement } from 'react';
-import { D as FarmContextFactory, E as MiddlewareProps, q as PluginContextProps, s as RouteModule } from './client-plugins-D0ke-Hc8.js';
-import { ServerFn } from './server-fn.js';
+import { av as FarmContextFactory, aw as MiddlewareProps, aj as PluginContextProps, ak as RouteModule } from './client-plugins-DfeKd0sD.js';
 import './types-CnH8DOqo.js';
 import { a as APIRouteParams } from './route-pattern-W-SsJGSp.js';
+import { ServerFn } from './server-fn.js';
 import { ProgrammaticPageRoute, InferProgrammaticRouteData, ProgrammaticRouteComponentProps, ProgrammaticApiRoute } from './routes.js';
 import { FarmRouterQueryValue, FarmRouterPathParams } from './router.js';
 import './lifecycle-DK06VuKP.js';
-import './integration-api-BPJo5oXb.js';
-import './endpoint-CA-TNX60.js';
+import './integration-api-BuPHMeKz.js';
+import './endpoint-BOE0IAaG.js';
 import './cache.js';
 import './cache-invalidation-BD0z_lfu.js';
 import './renderer.js';
@@ -24,18 +24,16 @@ import '@farming-labs/docs';
 import './observability-CoXunYhS.js';
 import '@opentelemetry/api';
 import 'vite';
-import './workflows-jZ4BcdoZ.js';
+import './workflows-IWP1ddBm.js';
 import './cron.js';
 import './env.js';
 import './server-action-security.js';
+import './layers-CM5i6T7z.js';
 import 'rolldown/utils';
 import 'rolldown';
-import './image-config-Duob7wER.js';
+import './image-config-BpH1q5R8.js';
 import './types-DQnyD3VD.js';
 import './font.js';
-import './after.js';
-import 'node:http';
-import './island-CfGru1MO.js';
 
 type FarmTestQuery = URLSearchParams | Record<string, FarmRouterQueryValue>;
 type FarmTestPathParams = FarmRouterPathParams;