@farm.js/core 0.1.51-beta.3 → 0.1.61

package/dist/types.d-DQnyD3VD.d.ts

@@ -1,30 +0,0 @@
-type FarmThemePreference = "light" | "dark" | "system";
-type FarmResolvedTheme = Exclude<FarmThemePreference, "system">;
-interface FarmThemeConfig {
-    /** Initial preference when the visitor has not selected one. @default "system" */
-    default?: FarmThemePreference;
-    /** Cookie and cross-tab storage key. @default "farm-theme" */
-    storageKey?: string;
-}
-interface ResolvedFarmThemeConfig {
-    enabled: boolean;
-    default: FarmThemePreference;
-    storageKey: string;
-    cookiePath: string;
-}
-interface FarmThemeSnapshot {
-    /** Saved visitor preference. */
-    theme: FarmThemePreference;
-    /** Active browser color mode. Undefined during SSR when the preference is `system`. */
-    resolvedTheme: FarmResolvedTheme | undefined;
-    /** Whether the browser runtime has resolved the theme. */
-    mounted: boolean;
-}
-interface FarmThemeRuntime {
-    config: ResolvedFarmThemeConfig;
-    serverSnapshot: FarmThemeSnapshot;
-    snapshot: FarmThemeSnapshot;
-    setTheme(theme: FarmThemePreference): void;
-}
-
-export type { FarmThemeSnapshot as F, ResolvedFarmThemeConfig as R, FarmThemePreference as a, FarmResolvedTheme as b, FarmThemeRuntime as c, FarmThemeConfig as d };

package/dist/utils.d-Bv2MPeLR.d.ts

@@ -1,48 +0,0 @@
-import { q as RouteSegment, P as ParsedRoute } from './client-plugins.d-n3iWY1EJ.js';
-
-declare function parseRoutePath(filePath: string): ParsedRoute;
-declare function segmentsToPattern(segments: RouteSegment[]): string;
-declare function matchRoute(url: string, segments: RouteSegment[]): {
-    params: Record<string, string>;
-    matches: boolean;
-};
-/** Decode a pathname once when it will be tested against multiple route chains. */
-declare function splitRoutePath(url: string): string[];
-/** Match an already decoded pathname so route-table scans do not repeatedly split it. */
-declare function matchRouteParts(urlParts: readonly string[], segments: RouteSegment[]): {
-    params: Record<string, string>;
-    matches: boolean;
-};
-/** Match a route segment chain as an owner of the pathname or one of its descendants. */
-declare function matchRoutePrefix(url: string, segments: RouteSegment[]): boolean;
-/** Match an owner chain against an already decoded pathname. */
-declare function matchRoutePrefixParts(urlParts: readonly string[], segments: RouteSegment[]): boolean;
-declare function resolveAppPath(root: string, ...paths: string[]): string;
-/**
- * Convert an absolute module path inside the project root to a root-relative
- * URL path with forward slashes (e.g. `/src/app/page.tsx`), for values the
- * client passes to dynamic `import()`. On Windows the naive root-prefix slice
- * yields `\src\app\page.tsx`, which is not a valid module specifier. Returns
- * undefined for paths outside the root so callers keep their own fallbacks.
- */
-declare function toRootRelativeUrlPath(absolutePath: string, projectRoot: string): string | undefined;
-/**
- * Normalize a filesystem path to forward slashes. Node's fs accepts these on
- * every platform, and module ids handed to bundlers (e.g. Nitro handler and
- * task entries) must not contain backslashes.
- */
-declare function toPosixPath(filePath: string): string;
-declare function toViteModuleId(filePath: string, root: string): string;
-declare function fileExists(filePath: string): Promise<boolean>;
-declare function globFiles(pattern: string, cwd: string): Promise<string[]>;
-declare function parseSearchParams(searchParams: URLSearchParams): Record<string, string | string[]>;
-declare const logger: {
-    info: (message: string) => void;
-    success: (message: string) => void;
-    warn: (message: string) => void;
-    error: (message: string) => void;
-    ready: (message: string) => void;
-    event: (message: string) => void;
-};
-
-export { matchRouteParts as a, matchRoutePrefix as b, matchRoutePrefixParts as c, parseSearchParams as d, splitRoutePath as e, fileExists as f, globFiles as g, toRootRelativeUrlPath as h, toViteModuleId as i, logger as l, matchRoute as m, parseRoutePath as p, resolveAppPath as r, segmentsToPattern as s, toPosixPath as t };

package/dist/utils.d-fqXe8lNc.d.mts

@@ -1,48 +0,0 @@
-import { q as RouteSegment, P as ParsedRoute } from './client-plugins.d-DllmH8eM.mjs';
-
-declare function parseRoutePath(filePath: string): ParsedRoute;
-declare function segmentsToPattern(segments: RouteSegment[]): string;
-declare function matchRoute(url: string, segments: RouteSegment[]): {
-    params: Record<string, string>;
-    matches: boolean;
-};
-/** Decode a pathname once when it will be tested against multiple route chains. */
-declare function splitRoutePath(url: string): string[];
-/** Match an already decoded pathname so route-table scans do not repeatedly split it. */
-declare function matchRouteParts(urlParts: readonly string[], segments: RouteSegment[]): {
-    params: Record<string, string>;
-    matches: boolean;
-};
-/** Match a route segment chain as an owner of the pathname or one of its descendants. */
-declare function matchRoutePrefix(url: string, segments: RouteSegment[]): boolean;
-/** Match an owner chain against an already decoded pathname. */
-declare function matchRoutePrefixParts(urlParts: readonly string[], segments: RouteSegment[]): boolean;
-declare function resolveAppPath(root: string, ...paths: string[]): string;
-/**
- * Convert an absolute module path inside the project root to a root-relative
- * URL path with forward slashes (e.g. `/src/app/page.tsx`), for values the
- * client passes to dynamic `import()`. On Windows the naive root-prefix slice
- * yields `\src\app\page.tsx`, which is not a valid module specifier. Returns
- * undefined for paths outside the root so callers keep their own fallbacks.
- */
-declare function toRootRelativeUrlPath(absolutePath: string, projectRoot: string): string | undefined;
-/**
- * Normalize a filesystem path to forward slashes. Node's fs accepts these on
- * every platform, and module ids handed to bundlers (e.g. Nitro handler and
- * task entries) must not contain backslashes.
- */
-declare function toPosixPath(filePath: string): string;
-declare function toViteModuleId(filePath: string, root: string): string;
-declare function fileExists(filePath: string): Promise<boolean>;
-declare function globFiles(pattern: string, cwd: string): Promise<string[]>;
-declare function parseSearchParams(searchParams: URLSearchParams): Record<string, string | string[]>;
-declare const logger: {
-    info: (message: string) => void;
-    success: (message: string) => void;
-    warn: (message: string) => void;
-    error: (message: string) => void;
-    ready: (message: string) => void;
-    event: (message: string) => void;
-};
-
-export { matchRouteParts as a, matchRoutePrefix as b, matchRoutePrefixParts as c, parseSearchParams as d, splitRoutePath as e, fileExists as f, globFiles as g, toRootRelativeUrlPath as h, toViteModuleId as i, logger as l, matchRoute as m, parseRoutePath as p, resolveAppPath as r, segmentsToPattern as s, toPosixPath as t };

package/dist/version.d.mts

@@ -1,3 +0,0 @@
-declare const FARM_VERSION: string;
-
-export { FARM_VERSION };

package/dist/version.d.ts

@@ -1,3 +0,0 @@
-declare const FARM_VERSION: string;
-
-export { FARM_VERSION };

package/dist/vite.d.mts

@@ -1,163 +0,0 @@
-import { Plugin, UserConfig, Connect } from 'vite';
-import { aF as FarmConfig, p as FarmUserConfig, au as PluginManager } from './client-plugins.d-DllmH8eM.mjs';
-import { FarmCacheUserConfig } from './cache.mjs';
-import { P as ProgrammaticClientRoutes } from './programmatic-routes-client.d-aAWiDd64.mjs';
-export { r as readRouteRenderingDirectiveFromFile } from './programmatic-routes-client.d-aAWiDd64.mjs';
-import { FarmPlatform } from './platform.mjs';
-import { _withAfterNodeMiddleware } from './after.mjs';
-import { A as APIRequestRuntime } from './server-client-bridge.d-DKWDl5NB.mjs';
-import { FarmRenderer } from './renderer.mjs';
-import { F as FarmIslandStrategy } from './island.d-CfGru1MO.mjs';
-export { c as createFarmNodeRequestAbortSignal } from './workflows.d-CRMzQZ3k.mjs';
-import { a as FarmImageConfig } from './image-config.d-CeDgNyX4.mjs';
-export { g as getPublicFarmImageConfig, r as resolveFarmImageConfig } from './image-config.d-CeDgNyX4.mjs';
-import './lifecycle.d-C2aLBOwu.mjs';
-import './route.d-BaVH3V0w.mjs';
-import './endpoint.d-BkMSCRf6.mjs';
-import 'http';
-import './server-fn.mjs';
-import './server-fn-error.d-DrcH9cc1.mjs';
-import './server-query.mjs';
-import './types.d-BnIqOn9w.mjs';
-import 'db0';
-import 'unstorage';
-import './schema.mjs';
-import 'react';
-import '@farming-labs/orm';
-import '@farming-labs/docs';
-import './observability.d-B2363jB6.mjs';
-import '@opentelemetry/api';
-import './cron.mjs';
-import './env.mjs';
-import './server-action-security.mjs';
-import './layers.d-CcS42OGR.mjs';
-import 'rolldown/utils';
-import 'rolldown';
-import './types.d-C41ePjvP.mjs';
-import './config.d-DqKaCr1r.mjs';
-import './types.d-DQnyD3VD.mjs';
-import './font.mjs';
-import './route-rendering.d-BQ53lJ_D.mjs';
-import 'node:http';
-import './deployment.mjs';
-
-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;
-
-declare function farmFontImportsPlugin(options?: {
-    root?: string;
-    basePath?: string;
-    publicDir?: string | false;
-    /** See TransformFarmFontCallsOptions.importCss. */
-    importCss?: boolean;
-}): Plugin;
-
-declare function farmImageImportsPlugin(): Plugin;
-
-/**
- * Sharp is an optional peer of @farm.js/core. Decide whether this run needs it
- * (development always optimizes with Sharp; production needs it on every
- * non-Cloudflare preset) and, when it is not installed:
- *
- * - `provider: "node"` fails with the install command;
- * - `provider: "auto"` (and `"cloudflare"` in development) falls back to the
- *   documented `provider: "none"` mode: original image URLs and no optimizer
- *   endpoint, so pages keep working without optimization.
- *
- * The returned images config is what the client, the dev handler, and the
- * production runtime must all use, so callers apply it before building plugins.
- */
-declare function resolveFarmImageProviderForRuntime<T extends FarmImageConfig>(images: T | undefined, options: {
-    root: string;
-    preset?: string;
-    dev?: boolean;
-}): T | undefined;
-/**
- * Which image optimizer a production server mounts for `images.provider`:
- * none, Sharp on Node, or the platform's transformer on Cloudflare presets.
- */
-declare function resolveFarmImageServerRuntime(images: Pick<FarmImageConfig, "provider">, preset: string): "none" | "node" | "cloudflare";
-
-interface FarmVitePluginOptions extends FarmConfig {
-    /** The resolved config's flag: the app has a `mobile` block. */
-    mobileClient?: boolean;
-    openapi?: FarmUserConfig["openapi"];
-    images?: FarmUserConfig["images"];
-    publicDir?: FarmUserConfig["publicDir"];
-    /** @internal Modules selected by the compiled isolated-hydration ownership plan. */
-    isolatedClientBoundaryModules?: ReadonlySet<string>;
-    /** @internal Component modules of programmatic routes, read from the evaluated routes files. */
-    programmaticClientRoutes?: ProgrammaticClientRoutes;
-}
-declare function farmI18nClientBridgePlugin(): Plugin;
-/**
- * Fail a browser graph that imports a server-only core entry, instead of
- * bundling its server runtime (for `@farm.js/core/og`, the `@vercel/og` wasm
- * renderer) into client code. A server graph that imports `@farm.js/core/og`
- * without the optional `@vercel/og` peer fails with the install command.
- * A Node builtin in a browser graph resolves to Farm's browser module for it.
- */
-declare function farmServerOnlyEntriesPlugin(options?: {
-    /** The browser graph's platform; a web build's mobile client passes `"mobile"`. */
-    platform?: FarmPlatform;
-}): Plugin;
-
-/** Exported for tests: the request boundary all Farm dev middlewares share. */
-declare function withFarmRequestTracing(handler: Parameters<typeof _withAfterNodeMiddleware>[0], apiRuntime?: APIRequestRuntime, resolveTraceUrl?: (request: Connect.IncomingMessage) => URL): Connect.NextHandleFunction;
-interface FarmModuleAstNode {
-    type: string;
-    start: number;
-    end: number;
-    [key: string]: unknown;
-}
-declare function rewriteEarlySsrRelativeImports(options: {
-    code: string;
-    id: string;
-    root: string;
-    parse: (code: string) => FarmModuleAstNode;
-}): string | null;
-declare function transformIsolatedClientBoundaryModule(options: {
-    code: string;
-    moduleReference: string;
-    islandStrategy: FarmIslandStrategy;
-    parse: (code: string) => FarmModuleAstNode;
-    /** Islands mode: server output in props travels as DOM slots (RFC 0003). */
-    slots?: boolean;
-}): string | null;
-/**
- * Whether Farm should append its own client-root HMR handler to a
- * `"use client"` module.
- *
- * Re-rendering the whole root on every edit only makes sense for a renderer
- * that diffs the result against the live DOM. Rebuilding renderers such as
- * Solid would otherwise wipe the page's state for a one-character edit. They
- * ship their own HMR integration, which can only preserve component state if
- * Farm leaves the module unaccepted.
- */
-declare function shouldEmitFarmClientRootHmr(renderer?: FarmRenderer): boolean;
-declare function farmPlugin(options?: FarmVitePluginOptions, initialPluginManager?: PluginManager): Plugin;
-declare function defineConfig(config?: FarmVitePluginOptions): Promise<UserConfig>;
-
-export { type ClientCachePersistenceEntryCode, defineConfig, farmFontImportsPlugin, farmI18nClientBridgePlugin, farmImageImportsPlugin, farmPlugin, farmServerOnlyEntriesPlugin, generateClientCachePersistenceCode, resolveFarmClientCacheAdapterEntry, resolveFarmImageProviderForRuntime, resolveFarmImageServerRuntime, rewriteEarlySsrRelativeImports, shouldEmitFarmClientRootHmr, transformIsolatedClientBoundaryModule, withFarmRequestTracing };

package/dist/vite.d.ts

@@ -1,163 +0,0 @@
-import { Plugin, UserConfig, Connect } from 'vite';
-import { aF as FarmConfig, p as FarmUserConfig, au as PluginManager } from './client-plugins.d-n3iWY1EJ.js';
-import { FarmCacheUserConfig } from './cache.js';
-import { P as ProgrammaticClientRoutes } from './programmatic-routes-client.d-XfmIrCK1.js';
-export { r as readRouteRenderingDirectiveFromFile } from './programmatic-routes-client.d-XfmIrCK1.js';
-import { FarmPlatform } from './platform.js';
-import { _withAfterNodeMiddleware } from './after.js';
-import { A as APIRequestRuntime } from './server-client-bridge.d-DKWDl5NB.js';
-import { FarmRenderer } from './renderer.js';
-import { F as FarmIslandStrategy } from './island.d-CfGru1MO.js';
-export { c as createFarmNodeRequestAbortSignal } from './workflows.d-CRMzQZ3k.js';
-import { a as FarmImageConfig } from './image-config.d-CeDgNyX4.js';
-export { g as getPublicFarmImageConfig, r as resolveFarmImageConfig } from './image-config.d-CeDgNyX4.js';
-import './lifecycle.d-C2aLBOwu.js';
-import './route.d-DBTEqifW.js';
-import './endpoint.d-BgHn0lhl.js';
-import 'http';
-import './server-fn.js';
-import './server-fn-error.d-DrcH9cc1.js';
-import './server-query.js';
-import './types.d-BnIqOn9w.js';
-import 'db0';
-import 'unstorage';
-import './schema.js';
-import 'react';
-import '@farming-labs/orm';
-import '@farming-labs/docs';
-import './observability.d-B2363jB6.js';
-import '@opentelemetry/api';
-import './cron.js';
-import './env.js';
-import './server-action-security.js';
-import './layers.d-CcS42OGR.js';
-import 'rolldown/utils';
-import 'rolldown';
-import './types.d-C41ePjvP.js';
-import './config.d-DqKaCr1r.js';
-import './types.d-DQnyD3VD.js';
-import './font.js';
-import './route-rendering.d-Bhx4QoJt.js';
-import 'node:http';
-import './deployment.js';
-
-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;
-
-declare function farmFontImportsPlugin(options?: {
-    root?: string;
-    basePath?: string;
-    publicDir?: string | false;
-    /** See TransformFarmFontCallsOptions.importCss. */
-    importCss?: boolean;
-}): Plugin;
-
-declare function farmImageImportsPlugin(): Plugin;
-
-/**
- * Sharp is an optional peer of @farm.js/core. Decide whether this run needs it
- * (development always optimizes with Sharp; production needs it on every
- * non-Cloudflare preset) and, when it is not installed:
- *
- * - `provider: "node"` fails with the install command;
- * - `provider: "auto"` (and `"cloudflare"` in development) falls back to the
- *   documented `provider: "none"` mode: original image URLs and no optimizer
- *   endpoint, so pages keep working without optimization.
- *
- * The returned images config is what the client, the dev handler, and the
- * production runtime must all use, so callers apply it before building plugins.
- */
-declare function resolveFarmImageProviderForRuntime<T extends FarmImageConfig>(images: T | undefined, options: {
-    root: string;
-    preset?: string;
-    dev?: boolean;
-}): T | undefined;
-/**
- * Which image optimizer a production server mounts for `images.provider`:
- * none, Sharp on Node, or the platform's transformer on Cloudflare presets.
- */
-declare function resolveFarmImageServerRuntime(images: Pick<FarmImageConfig, "provider">, preset: string): "none" | "node" | "cloudflare";
-
-interface FarmVitePluginOptions extends FarmConfig {
-    /** The resolved config's flag: the app has a `mobile` block. */
-    mobileClient?: boolean;
-    openapi?: FarmUserConfig["openapi"];
-    images?: FarmUserConfig["images"];
-    publicDir?: FarmUserConfig["publicDir"];
-    /** @internal Modules selected by the compiled isolated-hydration ownership plan. */
-    isolatedClientBoundaryModules?: ReadonlySet<string>;
-    /** @internal Component modules of programmatic routes, read from the evaluated routes files. */
-    programmaticClientRoutes?: ProgrammaticClientRoutes;
-}
-declare function farmI18nClientBridgePlugin(): Plugin;
-/**
- * Fail a browser graph that imports a server-only core entry, instead of
- * bundling its server runtime (for `@farm.js/core/og`, the `@vercel/og` wasm
- * renderer) into client code. A server graph that imports `@farm.js/core/og`
- * without the optional `@vercel/og` peer fails with the install command.
- * A Node builtin in a browser graph resolves to Farm's browser module for it.
- */
-declare function farmServerOnlyEntriesPlugin(options?: {
-    /** The browser graph's platform; a web build's mobile client passes `"mobile"`. */
-    platform?: FarmPlatform;
-}): Plugin;
-
-/** Exported for tests: the request boundary all Farm dev middlewares share. */
-declare function withFarmRequestTracing(handler: Parameters<typeof _withAfterNodeMiddleware>[0], apiRuntime?: APIRequestRuntime, resolveTraceUrl?: (request: Connect.IncomingMessage) => URL): Connect.NextHandleFunction;
-interface FarmModuleAstNode {
-    type: string;
-    start: number;
-    end: number;
-    [key: string]: unknown;
-}
-declare function rewriteEarlySsrRelativeImports(options: {
-    code: string;
-    id: string;
-    root: string;
-    parse: (code: string) => FarmModuleAstNode;
-}): string | null;
-declare function transformIsolatedClientBoundaryModule(options: {
-    code: string;
-    moduleReference: string;
-    islandStrategy: FarmIslandStrategy;
-    parse: (code: string) => FarmModuleAstNode;
-    /** Islands mode: server output in props travels as DOM slots (RFC 0003). */
-    slots?: boolean;
-}): string | null;
-/**
- * Whether Farm should append its own client-root HMR handler to a
- * `"use client"` module.
- *
- * Re-rendering the whole root on every edit only makes sense for a renderer
- * that diffs the result against the live DOM. Rebuilding renderers such as
- * Solid would otherwise wipe the page's state for a one-character edit. They
- * ship their own HMR integration, which can only preserve component state if
- * Farm leaves the module unaccepted.
- */
-declare function shouldEmitFarmClientRootHmr(renderer?: FarmRenderer): boolean;
-declare function farmPlugin(options?: FarmVitePluginOptions, initialPluginManager?: PluginManager): Plugin;
-declare function defineConfig(config?: FarmVitePluginOptions): Promise<UserConfig>;
-
-export { type ClientCachePersistenceEntryCode, defineConfig, farmFontImportsPlugin, farmI18nClientBridgePlugin, farmImageImportsPlugin, farmPlugin, farmServerOnlyEntriesPlugin, generateClientCachePersistenceCode, resolveFarmClientCacheAdapterEntry, resolveFarmImageProviderForRuntime, resolveFarmImageServerRuntime, rewriteEarlySsrRelativeImports, shouldEmitFarmClientRootHmr, transformIsolatedClientBoundaryModule, withFarmRequestTracing };

package/dist/workflows.d-CRMzQZ3k.d.mts

@@ -1,188 +0,0 @@
-interface FarmNodeAbortRequest {
-    aborted?: boolean;
-    once(event: "aborted", listener: () => void): unknown;
-    off(event: "aborted", listener: () => void): unknown;
-}
-interface FarmNodeAbortResponse {
-    writableEnded: boolean;
-    once(event: "close" | "finish", listener: () => void): unknown;
-    off(event: "close" | "finish", listener: () => void): unknown;
-}
-/** Share disconnect semantics between development and production Node requests. */
-declare function createFarmNodeRequestAbortSignal(req: FarmNodeAbortRequest, res: FarmNodeAbortResponse): AbortSignal;
-type FarmServerDuration = number | `${number}${"ms" | "s" | "m" | "h"}`;
-interface FarmServerHealthConfig {
-    /** Liveness endpoint. It remains healthy while a production process drains. */
-    livenessPath?: string;
-    /** Readiness endpoint. It returns 503 until startup completes and while draining. */
-    readinessPath?: string;
-}
-interface ResolvedFarmServerHealthConfig {
-    enabled: boolean;
-    livenessPath: string;
-    readinessPath: string;
-}
-interface FarmServerConfig {
-    /** Maximum request body size for API routes, integrations, workflows, and uploads. */
-    bodySizeLimit?: number | string;
-    /**
-     * Trust proxy-provided client address and request authority headers. Enable only behind a trusted proxy.
-     * The client address is the last `X-Forwarded-For` hop, the one the closest proxy appended.
-     */
-    trustProxy?: boolean;
-    /** Maximum time for a Node client to send complete request headers. */
-    headersTimeout?: FarmServerDuration;
-    /** Maximum time for a Node client to send the complete request. */
-    requestTimeout?: FarmServerDuration;
-    /** How long an idle Node keep-alive connection remains open after a response. */
-    keepAliveTimeout?: FarmServerDuration;
-    /** Maximum time the Node adapter drains traffic before forcing shutdown. */
-    gracefulShutdownTimeout?: FarmServerDuration;
-    /** Production liveness and readiness endpoints. Set to false to disable them. */
-    health?: false | FarmServerHealthConfig;
-}
-interface ResolvedFarmServerConfig {
-    bodySizeLimit: number;
-    trustProxy: boolean;
-    headersTimeout: number;
-    requestTimeout: number;
-    keepAliveTimeout: number;
-    gracefulShutdownTimeout: number;
-    health: ResolvedFarmServerHealthConfig;
-}
-/** Apply the weak entity-tag comparison required by If-None-Match. */
-declare function matchesFarmIfNoneMatch(value: string | readonly string[] | null | undefined, etag: string): boolean;
-declare function resolveFarmServerConfig(config: FarmServerConfig | ResolvedFarmServerConfig | undefined): ResolvedFarmServerConfig;
-declare function cloneFarmRequestWithContext(request: Request): Request;
-declare function bufferFarmRequestBody(request: Request, limit: number): Promise<Request>;
-declare function readFarmRequestBody(request: Request, limit: number): Promise<Uint8Array>;
-declare function readNodeRequestBody(request: Parameters<typeof readNodeRequestBodyOnce>[0], limit: number): Promise<Buffer>;
-declare function readNodeRequestBodyOnce(request: {
-    headers: Record<string, string | string[] | undefined>;
-    on(event: "data", listener: (chunk: unknown) => void): unknown;
-    on(event: "end", listener: () => void): unknown;
-    on(event: "error", listener: (error: Error) => void): unknown;
-    removeListener?(event: string, listener: (...args: any[]) => void): unknown;
-    resume?(): unknown;
-}, limit: number): Promise<Buffer>;
-declare function createFarmRequestBodyErrorResponse(error: unknown): Response | null;
-
-type FarmWorkflowSchedule = string | string[];
-interface FarmWorkflowsUserConfig {
-    /** Enable or disable Farm workflow discovery. Enabled by default. */
-    enabled?: boolean;
-    /** Directory or directories to scan for workflow modules. */
-    dir?: string | string[];
-    /** Alias for dir. */
-    dirs?: string[];
-    /** HTTP route used for manual and URL-based cron invocation. */
-    route?: string;
-    /** Environment variable that stores the optional runner secret. */
-    secretEnv?: string;
-    /** Inline runner secret. Prefer secretEnv for deployed apps. */
-    secret?: string;
-    /**
-     * Serve the workflow route without a secret in a deployed runtime.
-     * Defaults to false: without a secret the route is public, so production
-     * requests are rejected unless this is explicitly enabled.
-     */
-    allowUnsecured?: boolean;
-}
-interface FarmWorkflowsResolvedConfig {
-    enabled: boolean;
-    dirs: string[];
-    route: string;
-    secretEnv: string;
-    secret?: string;
-    allowUnsecured?: boolean;
-}
-interface FarmWorkflowLogger {
-    info: (...args: unknown[]) => void;
-    warn: (...args: unknown[]) => void;
-    error: (...args: unknown[]) => void;
-}
-interface FarmWorkflowRunContext<TPayload = unknown> {
-    id: string;
-    name: string;
-    payload: TPayload;
-    scheduledTime?: number | string;
-    request?: Request;
-    event?: unknown;
-    env: Record<string, string | undefined>;
-    data: Map<string, unknown>;
-    log: FarmWorkflowLogger;
-}
-interface FarmWorkflowDefinition<TPayload = unknown, TResult = unknown> {
-    kind?: "farm-workflow";
-    id?: string;
-    description?: string;
-    schedule?: FarmWorkflowSchedule;
-    timezone?: string;
-    run: (ctx: FarmWorkflowRunContext<TPayload>) => TResult | Promise<TResult>;
-}
-interface FarmCronDefinition<TPayload = unknown, TResult = unknown> extends FarmWorkflowDefinition<TPayload, TResult> {
-    schedule: FarmWorkflowSchedule;
-}
-interface FarmDiscoveredWorkflow {
-    id: string;
-    filePath: string;
-    description?: string;
-    schedule: string[];
-    timezone?: string;
-    routePath: string;
-}
-interface PreparedFarmWorkflows {
-    workflows: FarmDiscoveredWorkflow[];
-    tasks: Record<string, {
-        handler: string;
-        description: string;
-    }>;
-    scheduledTasks: Record<string, string | string[]>;
-    handlerPath?: string;
-    manifestPath?: string;
-}
-interface FarmWorkflowHTTPHandlerOptions {
-    workflows: FarmDiscoveredWorkflow[];
-    config: FarmWorkflowsResolvedConfig;
-    loadModule: (workflow: FarmDiscoveredWorkflow) => Promise<Record<string, any>>;
-    server?: FarmServerConfig | ResolvedFarmServerConfig;
-}
-declare const DEFAULT_FARM_WORKFLOW_DIRS: string[];
-declare const DEFAULT_FARM_WORKFLOW_ROUTE = "/api/_farm/workflows";
-declare const DEFAULT_FARM_WORKFLOW_SECRET_ENV = "CRON_SECRET";
-declare function defineWorkflow<const TPayload = unknown, TResult = unknown>(definition: FarmWorkflowDefinition<TPayload, TResult>): FarmWorkflowDefinition<TPayload, TResult>;
-declare function defineTask<const TPayload = unknown, TResult = unknown>(definition: FarmWorkflowDefinition<TPayload, TResult>): FarmWorkflowDefinition<TPayload, TResult>;
-/**
- * @deprecated Configure `cron` in `farm.config.ts` and point it at an API route.
- */
-declare function defineCron<const TPayload = unknown, TResult = unknown>(definition: FarmCronDefinition<TPayload, TResult>): FarmCronDefinition<TPayload, TResult>;
-declare function resolveWorkflowsConfig(workflows: FarmWorkflowsUserConfig | boolean | undefined): FarmWorkflowsResolvedConfig;
-declare function discoverFarmWorkflows(config: {
-    root?: string;
-    workflows?: FarmWorkflowsResolvedConfig | FarmWorkflowsUserConfig | boolean;
-}, options?: {
-    loadModule?: (filePath: string) => Promise<Record<string, any>>;
-}): Promise<FarmDiscoveredWorkflow[]>;
-declare function createFarmWorkflowRequestHandler(options: FarmWorkflowHTTPHandlerOptions): (request: Request) => Promise<Response | null>;
-declare function runFarmWorkflowModule(module: Record<string, any>, context: {
-    id: string;
-    name?: string;
-    payload?: unknown;
-    scheduledTime?: number | string;
-    request?: Request;
-    event?: unknown;
-    env?: Record<string, string | undefined>;
-}): Promise<unknown>;
-declare function prepareFarmWorkflowsForNitro(config: {
-    root?: string;
-    distDir?: string;
-    workflows?: FarmWorkflowsResolvedConfig | FarmWorkflowsUserConfig | boolean;
-    server?: FarmServerConfig | ResolvedFarmServerConfig;
-}): Promise<PreparedFarmWorkflows>;
-declare function createFarmWorkflowVercelCrons(workflows: FarmDiscoveredWorkflow[]): Array<{
-    path: string;
-    schedule: string;
-}>;
-declare function applyFarmWorkflowVercelCrons(vercelConfig: Record<string, any>, workflows: FarmDiscoveredWorkflow[]): Record<string, any>;
-
-export { cloneFarmRequestWithContext as A, createFarmRequestBodyErrorResponse as B, matchesFarmIfNoneMatch as C, DEFAULT_FARM_WORKFLOW_DIRS as D, readFarmRequestBody as E, type FarmWorkflowsResolvedConfig as F, readNodeRequestBody as G, resolveFarmServerConfig as H, type PreparedFarmWorkflows as P, type ResolvedFarmServerConfig as R, DEFAULT_FARM_WORKFLOW_ROUTE as a, DEFAULT_FARM_WORKFLOW_SECRET_ENV as b, createFarmNodeRequestAbortSignal as c, type FarmCronDefinition as d, type FarmDiscoveredWorkflow as e, type FarmServerConfig as f, type FarmServerDuration as g, type FarmServerHealthConfig as h, type FarmWorkflowDefinition as i, type FarmWorkflowHTTPHandlerOptions as j, type FarmWorkflowLogger as k, type FarmWorkflowRunContext as l, type FarmWorkflowSchedule as m, type FarmWorkflowsUserConfig as n, type ResolvedFarmServerHealthConfig as o, applyFarmWorkflowVercelCrons as p, createFarmWorkflowRequestHandler as q, createFarmWorkflowVercelCrons as r, defineCron as s, defineTask as t, defineWorkflow as u, discoverFarmWorkflows as v, prepareFarmWorkflowsForNitro as w, resolveWorkflowsConfig as x, runFarmWorkflowModule as y, bufferFarmRequestBody as z };