@farm.js/core 0.1.0-beta.16 → 0.1.0-beta.17

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

@@ -0,0 +1,41 @@
+export { ah as loadConfig, ag as resolveConfig, ai as resolveDeployConfig } from '../client-plugins-278AvYHE.mjs';
+import { build, createServer, loadEnv } from 'vite';
+export { l as logger } from '../utils-CKSHiip6.mjs';
+import '../plugin-BJDf43dc.mjs';
+import 'react';
+import 'http';
+import '../types-D1A6-XvH.mjs';
+import 'db0';
+import 'unstorage';
+import '../integration-api-CHT2OKAf.mjs';
+import '@farming-labs/orm';
+import '../types-DTzm4TCl.mjs';
+import '@farming-labs/docs';
+import '../markdown.mjs';
+import '../observability.mjs';
+import '../workflows.mjs';
+import '../cron.mjs';
+import '../env.mjs';
+import '../server-action-security.mjs';
+import '../server-fn-error-DDh14a0V.mjs';
+import '../image-config-Duob7wER.mjs';
+import '../types-BMxWr97v.mjs';
+import '../cache.mjs';
+import '../route-runtime-DoOHzCAD.mjs';
+import '../font.mjs';
+
+type FarmProductionViteBuilder = "rollup" | "rolldown";
+interface FarmProductionViteRuntime {
+    build: typeof build;
+    createServer: typeof createServer;
+    loadEnv: typeof loadEnv;
+    builder: FarmProductionViteBuilder;
+}
+/**
+ * Prefer Vite's Rolldown-powered production builder on supported Node releases.
+ * Vite 5 remains the compatibility path for Node 18, --no-optional installs,
+ * and projects that explicitly request Rollup.
+ */
+declare function loadFarmProductionVite(): Promise<FarmProductionViteRuntime>;
+
+export { type FarmProductionViteRuntime, loadFarmProductionVite };

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

@@ -0,0 +1,41 @@
+export { ah as loadConfig, ag as resolveConfig, ai as resolveDeployConfig } from '../client-plugins-CTQAkr7R.js';
+import { build, createServer, loadEnv } from 'vite';
+export { l as logger } from '../utils-B6GaYNJL.js';
+import '../plugin-BJDf43dc.js';
+import 'react';
+import 'http';
+import '../types-D1A6-XvH.js';
+import 'db0';
+import 'unstorage';
+import '../integration-api-CHT2OKAf.js';
+import '@farming-labs/orm';
+import '../types-DTzm4TCl.js';
+import '@farming-labs/docs';
+import '../markdown.js';
+import '../observability.js';
+import '../workflows.js';
+import '../cron.js';
+import '../env.js';
+import '../server-action-security.js';
+import '../server-fn-error-DDh14a0V.js';
+import '../image-config-Duob7wER.js';
+import '../types-BMxWr97v.js';
+import '../cache.js';
+import '../route-runtime-DoOHzCAD.js';
+import '../font.js';
+
+type FarmProductionViteBuilder = "rollup" | "rolldown";
+interface FarmProductionViteRuntime {
+    build: typeof build;
+    createServer: typeof createServer;
+    loadEnv: typeof loadEnv;
+    builder: FarmProductionViteBuilder;
+}
+/**
+ * Prefer Vite's Rolldown-powered production builder on supported Node releases.
+ * Vite 5 remains the compatibility path for Node 18, --no-optional installs,
+ * and projects that explicitly request Rollup.
+ */
+declare function loadFarmProductionVite(): Promise<FarmProductionViteRuntime>;
+
+export { type FarmProductionViteRuntime, loadFarmProductionVite };

package/dist/internal/config-runtime.mjs

@@ -5,10 +5,10 @@ import {
   loadConfig,
   resolveConfig,
   resolveDeployConfig
-} from "../chunk-T2KL7VEL.mjs";
+} from "../chunk-PZXBQKCH.mjs";
 import "../chunk-UVCIEUJC.mjs";
 import "../chunk-RQ633A5I.mjs";
-import "../chunk-I4CUBGVF.mjs";
+import "../chunk-E257KFBU.mjs";
 import "../chunk-7MABZJIM.mjs";
 import "../chunk-YW7OBE6Q.mjs";
 import "../chunk-74YTBPTY.mjs";

package/dist/internal/metadata-image-runtime.d.mts

@@ -0,0 +1,25 @@
+import { ImageResponseOptions } from '@vercel/og';
+
+type MetadataImageSize = {
+    width?: number;
+    height?: number;
+};
+type MetadataImageFont = Omit<NonNullable<ImageResponseOptions["fonts"]>[number], "data"> & {
+    data: ArrayBuffer | ArrayBufferView | Promise<ArrayBuffer | ArrayBufferView>;
+};
+type FarmMetadataImageModule = {
+    size?: MetadataImageSize;
+    contentType?: string;
+    revalidate?: number | false;
+    fonts?: MetadataImageFont[];
+    emoji?: ImageResponseOptions["emoji"];
+    debug?: boolean;
+};
+type FarmMetadataImageResponseOptions = {
+    method?: string;
+    ifNoneMatch?: string | null;
+};
+/** @internal */
+declare function createFarmMetadataImageResponse(value: unknown, imageModule: FarmMetadataImageModule, options?: FarmMetadataImageResponseOptions): Promise<Response>;
+
+export { type FarmMetadataImageModule, type FarmMetadataImageResponseOptions, createFarmMetadataImageResponse };

package/dist/internal/metadata-image-runtime.d.ts

@@ -0,0 +1,25 @@
+import { ImageResponseOptions } from '@vercel/og';
+
+type MetadataImageSize = {
+    width?: number;
+    height?: number;
+};
+type MetadataImageFont = Omit<NonNullable<ImageResponseOptions["fonts"]>[number], "data"> & {
+    data: ArrayBuffer | ArrayBufferView | Promise<ArrayBuffer | ArrayBufferView>;
+};
+type FarmMetadataImageModule = {
+    size?: MetadataImageSize;
+    contentType?: string;
+    revalidate?: number | false;
+    fonts?: MetadataImageFont[];
+    emoji?: ImageResponseOptions["emoji"];
+    debug?: boolean;
+};
+type FarmMetadataImageResponseOptions = {
+    method?: string;
+    ifNoneMatch?: string | null;
+};
+/** @internal */
+declare function createFarmMetadataImageResponse(value: unknown, imageModule: FarmMetadataImageModule, options?: FarmMetadataImageResponseOptions): Promise<Response>;
+
+export { type FarmMetadataImageModule, type FarmMetadataImageResponseOptions, createFarmMetadataImageResponse };

package/dist/internal/production-node-env.d.mts

@@ -0,0 +1,12 @@
+/**
+ * Keep overlapping production operations on the production condition.
+ *
+ * The state lives on `globalThis` so independently loaded CJS/ESM copies of
+ * Farm share one refcount. The first entrant captures the caller's value and
+ * only the last operation to settle restores it.
+ *
+ * @internal
+ */
+declare function withProductionNodeEnv<T>(operation: () => T | PromiseLike<T>): Promise<T>;
+
+export { withProductionNodeEnv };

package/dist/internal/production-node-env.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Keep overlapping production operations on the production condition.
+ *
+ * The state lives on `globalThis` so independently loaded CJS/ESM copies of
+ * Farm share one refcount. The first entrant captures the caller's value and
+ * only the last operation to settle restores it.
+ *
+ * @internal
+ */
+declare function withProductionNodeEnv<T>(operation: () => T | PromiseLike<T>): Promise<T>;
+
+export { withProductionNodeEnv };

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

@@ -0,0 +1,44 @@
+export { _runWithAfterRequest } from '../after.mjs';
+export { _ as _runWithCurrentRequest, g as getCurrentRequest } from '../request-Cq5d6qmE.mjs';
+export { configureFarmCache, createFarmCacheKey, getFarmDataCache, normalizeRevalidatePath } from '../cache.mjs';
+export { c as createFarmLocaleCookie, g as getFarmLocaleVaryHeaders } from '../resolver-DJqjLMg_.mjs';
+export { localizeFarmHref, localizeFarmPathname, stripFarmLocaleFromPathname } from '../i18n/index.mjs';
+export { a as addMetadataImageReference, m as mergeMetadata, r as renderMetadataHead } from '../metadata-DmCudMw_.mjs';
+export { _ as _runWithMiddlewareContext, b as _runWithMiddlewareData, a as applyProductionMiddlewareHeaders, c as createProductionMiddlewareRunner } from '../production-runtime-DFN2_RXq.mjs';
+export { g as getFarmRedirectError, i as isFarmNotFoundError, a as isFarmRedirectError } from '../navigation-errors-Dvwpzaer.mjs';
+export { configureFarmObservability, emitFarmEvent } from '../observability.mjs';
+import { F as FarmConfig, e as FarmContextFactoryInput } from '../client-plugins-278AvYHE.mjs';
+export { a4 as manageFarmDocumentPreloads, a5 as manageFarmHtmlPreloads, a6 as manageFarmLinkHeaderPreloads, a7 as reportFarmPreloadWarnings } from '../client-plugins-278AvYHE.mjs';
+import 'node:http';
+import '../types-BMxWr97v.mjs';
+import '../plugin-BJDf43dc.mjs';
+import 'react';
+import 'http';
+import '../types-D1A6-XvH.mjs';
+import 'db0';
+import 'unstorage';
+import '../integration-api-CHT2OKAf.mjs';
+import '@farming-labs/orm';
+import '../types-DTzm4TCl.mjs';
+import '@farming-labs/docs';
+import '../markdown.mjs';
+import 'vite';
+import '../workflows.mjs';
+import '../cron.mjs';
+import '../env.mjs';
+import '../server-action-security.mjs';
+import '../server-fn-error-DDh14a0V.mjs';
+import '../image-config-Duob7wER.mjs';
+import '../route-runtime-DoOHzCAD.mjs';
+import '../font.mjs';
+
+declare const FARM_ROUTE_CONTEXT_SYMBOL: unique symbol;
+type FarmRouteContextCarrier<TContext = unknown> = {
+    [FARM_ROUTE_CONTEXT_SYMBOL]?: TContext;
+};
+declare function resolveFarmRouteContext(config: Pick<FarmConfig, "context">, input: FarmContextFactoryInput): Promise<unknown>;
+declare function withFarmRouteContext<TProps extends object, TContext>(props: TProps, context: TContext | undefined): TProps & FarmRouteContextCarrier<TContext>;
+
+declare function appendFarmLinkHeader(headers: Headers, value: string): void;
+
+export { appendFarmLinkHeader, resolveFarmRouteContext, withFarmRouteContext };

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

@@ -0,0 +1,44 @@
+export { _runWithAfterRequest } from '../after.js';
+export { _ as _runWithCurrentRequest, g as getCurrentRequest } from '../request-LoxDW3lp.js';
+export { configureFarmCache, createFarmCacheKey, getFarmDataCache, normalizeRevalidatePath } from '../cache.js';
+export { c as createFarmLocaleCookie, g as getFarmLocaleVaryHeaders } from '../resolver-IH4RmPEl.js';
+export { localizeFarmHref, localizeFarmPathname, stripFarmLocaleFromPathname } from '../i18n/index.js';
+export { a as addMetadataImageReference, m as mergeMetadata, r as renderMetadataHead } from '../metadata-xghtOlbR.js';
+export { _ as _runWithMiddlewareContext, b as _runWithMiddlewareData, a as applyProductionMiddlewareHeaders, c as createProductionMiddlewareRunner } from '../production-runtime-BLxSv9cU.js';
+export { g as getFarmRedirectError, i as isFarmNotFoundError, a as isFarmRedirectError } from '../navigation-errors-Dvwpzaer.js';
+export { configureFarmObservability, emitFarmEvent } from '../observability.js';
+import { F as FarmConfig, e as FarmContextFactoryInput } from '../client-plugins-CTQAkr7R.js';
+export { a4 as manageFarmDocumentPreloads, a5 as manageFarmHtmlPreloads, a6 as manageFarmLinkHeaderPreloads, a7 as reportFarmPreloadWarnings } from '../client-plugins-CTQAkr7R.js';
+import 'node:http';
+import '../types-BMxWr97v.js';
+import '../plugin-BJDf43dc.js';
+import 'react';
+import 'http';
+import '../types-D1A6-XvH.js';
+import 'db0';
+import 'unstorage';
+import '../integration-api-CHT2OKAf.js';
+import '@farming-labs/orm';
+import '../types-DTzm4TCl.js';
+import '@farming-labs/docs';
+import '../markdown.js';
+import 'vite';
+import '../workflows.js';
+import '../cron.js';
+import '../env.js';
+import '../server-action-security.js';
+import '../server-fn-error-DDh14a0V.js';
+import '../image-config-Duob7wER.js';
+import '../route-runtime-DoOHzCAD.js';
+import '../font.js';
+
+declare const FARM_ROUTE_CONTEXT_SYMBOL: unique symbol;
+type FarmRouteContextCarrier<TContext = unknown> = {
+    [FARM_ROUTE_CONTEXT_SYMBOL]?: TContext;
+};
+declare function resolveFarmRouteContext(config: Pick<FarmConfig, "context">, input: FarmContextFactoryInput): Promise<unknown>;
+declare function withFarmRouteContext<TProps extends object, TContext>(props: TProps, context: TContext | undefined): TProps & FarmRouteContextCarrier<TContext>;
+
+declare function appendFarmLinkHeader(headers: Headers, value: string): void;
+
+export { appendFarmLinkHeader, resolveFarmRouteContext, withFarmRouteContext };

package/dist/island-CfGru1MO.d.mts

@@ -0,0 +1,9 @@
+/**
+ * Controls when Farm loads and hydrates a server-rendered client boundary.
+ *
+ * `load` is the compatibility-first default. The deferred strategies keep the
+ * server-rendered HTML visible while postponing the boundary's JavaScript.
+ */
+type FarmIslandStrategy = "load" | "interaction" | "visible" | "idle";
+
+export type { FarmIslandStrategy as F };

package/dist/island-CfGru1MO.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Controls when Farm loads and hydrates a server-rendered client boundary.
+ *
+ * `load` is the compatibility-first default. The deferred strategies keep the
+ * server-rendered HTML visible while postponing the boundary's JavaScript.
+ */
+type FarmIslandStrategy = "load" | "interaction" | "visible" | "idle";
+
+export type { FarmIslandStrategy as F };

package/dist/markdown.d.mts

@@ -0,0 +1,60 @@
+type FarmMarkdownRouteInput = string | {
+    route: string;
+    title?: string;
+    cache?: number | false;
+};
+interface FarmMarkdownUserConfig {
+    /**
+     * Enable generated markdown representations for React pages.
+     * @default true
+     */
+    enabled?: boolean;
+    /**
+     * Routes that may expose generated markdown. Every page is exposed by default.
+     */
+    expose?: boolean | FarmMarkdownRouteInput[];
+    /** @deprecated Use `expose`. */
+    routes?: FarmMarkdownRouteInput[];
+    cache?: number | false;
+    includeMetadata?: boolean;
+}
+interface FarmMarkdownResolvedRoute {
+    route: string;
+    title?: string;
+    cache?: number | false;
+}
+interface FarmMarkdownResolvedConfig {
+    enabled: boolean;
+    expose: true | FarmMarkdownResolvedRoute[];
+    cache: number | false;
+    includeMetadata: boolean;
+}
+interface FarmMarkdownMirrorTarget {
+    pathname: string;
+    route: FarmMarkdownResolvedRoute | null;
+}
+interface ResolveMarkdownMirrorTargetOptions {
+    accept?: string | null;
+}
+interface CreateMarkdownMirrorResponseOptions {
+    request: Request;
+    config?: FarmMarkdownResolvedConfig;
+    routeExists?: (pathname: string) => boolean;
+    renderPage: (request: Request) => Response | Promise<Response>;
+}
+interface ApplyMarkdownNegotiationHeadersOptions {
+    config?: FarmMarkdownResolvedConfig;
+    pathname: string;
+}
+declare function resolveMarkdownConfig(config: FarmMarkdownUserConfig | boolean | undefined): FarmMarkdownResolvedConfig;
+declare function resolveMarkdownMirrorTarget(config: FarmMarkdownResolvedConfig | undefined, pathname: string, options?: ResolveMarkdownMirrorTargetOptions): FarmMarkdownMirrorTarget | null;
+declare function createMarkdownMirrorResponse(options: CreateMarkdownMirrorResponseOptions): Promise<Response | null>;
+declare function applyMarkdownNegotiationHeaders(response: Response, options: ApplyMarkdownNegotiationHeadersOptions): Response;
+declare function htmlToMarkdown(html: string, options?: {
+    title?: string;
+    sourcePath?: string;
+    includeMetadata?: boolean;
+}): string;
+declare function requestAcceptsMarkdown(accept: string | null | undefined): boolean;
+
+export { type ApplyMarkdownNegotiationHeadersOptions, type CreateMarkdownMirrorResponseOptions, type FarmMarkdownMirrorTarget, type FarmMarkdownResolvedConfig, type FarmMarkdownResolvedRoute, type FarmMarkdownRouteInput, type FarmMarkdownUserConfig, type ResolveMarkdownMirrorTargetOptions, applyMarkdownNegotiationHeaders, createMarkdownMirrorResponse, htmlToMarkdown, requestAcceptsMarkdown, resolveMarkdownConfig, resolveMarkdownMirrorTarget };

package/dist/markdown.d.ts

@@ -0,0 +1,60 @@
+type FarmMarkdownRouteInput = string | {
+    route: string;
+    title?: string;
+    cache?: number | false;
+};
+interface FarmMarkdownUserConfig {
+    /**
+     * Enable generated markdown representations for React pages.
+     * @default true
+     */
+    enabled?: boolean;
+    /**
+     * Routes that may expose generated markdown. Every page is exposed by default.
+     */
+    expose?: boolean | FarmMarkdownRouteInput[];
+    /** @deprecated Use `expose`. */
+    routes?: FarmMarkdownRouteInput[];
+    cache?: number | false;
+    includeMetadata?: boolean;
+}
+interface FarmMarkdownResolvedRoute {
+    route: string;
+    title?: string;
+    cache?: number | false;
+}
+interface FarmMarkdownResolvedConfig {
+    enabled: boolean;
+    expose: true | FarmMarkdownResolvedRoute[];
+    cache: number | false;
+    includeMetadata: boolean;
+}
+interface FarmMarkdownMirrorTarget {
+    pathname: string;
+    route: FarmMarkdownResolvedRoute | null;
+}
+interface ResolveMarkdownMirrorTargetOptions {
+    accept?: string | null;
+}
+interface CreateMarkdownMirrorResponseOptions {
+    request: Request;
+    config?: FarmMarkdownResolvedConfig;
+    routeExists?: (pathname: string) => boolean;
+    renderPage: (request: Request) => Response | Promise<Response>;
+}
+interface ApplyMarkdownNegotiationHeadersOptions {
+    config?: FarmMarkdownResolvedConfig;
+    pathname: string;
+}
+declare function resolveMarkdownConfig(config: FarmMarkdownUserConfig | boolean | undefined): FarmMarkdownResolvedConfig;
+declare function resolveMarkdownMirrorTarget(config: FarmMarkdownResolvedConfig | undefined, pathname: string, options?: ResolveMarkdownMirrorTargetOptions): FarmMarkdownMirrorTarget | null;
+declare function createMarkdownMirrorResponse(options: CreateMarkdownMirrorResponseOptions): Promise<Response | null>;
+declare function applyMarkdownNegotiationHeaders(response: Response, options: ApplyMarkdownNegotiationHeadersOptions): Response;
+declare function htmlToMarkdown(html: string, options?: {
+    title?: string;
+    sourcePath?: string;
+    includeMetadata?: boolean;
+}): string;
+declare function requestAcceptsMarkdown(accept: string | null | undefined): boolean;
+
+export { type ApplyMarkdownNegotiationHeadersOptions, type CreateMarkdownMirrorResponseOptions, type FarmMarkdownMirrorTarget, type FarmMarkdownResolvedConfig, type FarmMarkdownResolvedRoute, type FarmMarkdownRouteInput, type FarmMarkdownUserConfig, type ResolveMarkdownMirrorTargetOptions, applyMarkdownNegotiationHeaders, createMarkdownMirrorResponse, htmlToMarkdown, requestAcceptsMarkdown, resolveMarkdownConfig, resolveMarkdownMirrorTarget };

package/dist/metadata-DmCudMw_.d.mts

@@ -0,0 +1,22 @@
+import { w as Metadata } from './client-plugins-278AvYHE.mjs';
+
+type MetadataImageKind = "opengraph" | "twitter";
+interface FarmMetadataImageReference {
+    kind: MetadataImageKind;
+    href: string;
+    alt?: string;
+    width?: number;
+    height?: number;
+    contentType?: string;
+}
+interface RenderedMetadataHead {
+    title: string;
+    tags: string;
+    hasFavicon: boolean;
+}
+type MetadataRecord = Metadata & Record<string, any>;
+declare function mergeMetadata(base: MetadataRecord | undefined, next: MetadataRecord | undefined): MetadataRecord;
+declare function addMetadataImageReference(metadata: MetadataRecord, reference: FarmMetadataImageReference): MetadataRecord;
+declare function renderMetadataHead(metadata: MetadataRecord | undefined): RenderedMetadataHead;
+
+export { type MetadataImageKind as M, addMetadataImageReference as a, mergeMetadata as m, renderMetadataHead as r };

package/dist/metadata-xghtOlbR.d.ts

@@ -0,0 +1,22 @@
+import { w as Metadata } from './client-plugins-CTQAkr7R.js';
+
+type MetadataImageKind = "opengraph" | "twitter";
+interface FarmMetadataImageReference {
+    kind: MetadataImageKind;
+    href: string;
+    alt?: string;
+    width?: number;
+    height?: number;
+    contentType?: string;
+}
+interface RenderedMetadataHead {
+    title: string;
+    tags: string;
+    hasFavicon: boolean;
+}
+type MetadataRecord = Metadata & Record<string, any>;
+declare function mergeMetadata(base: MetadataRecord | undefined, next: MetadataRecord | undefined): MetadataRecord;
+declare function addMetadataImageReference(metadata: MetadataRecord, reference: FarmMetadataImageReference): MetadataRecord;
+declare function renderMetadataHead(metadata: MetadataRecord | undefined): RenderedMetadataHead;
+
+export { type MetadataImageKind as M, addMetadataImageReference as a, mergeMetadata as m, renderMetadataHead as r };