@farm.js/core 0.1.0-beta.21 → 0.1.0-beta.22

package/dist/middleware.d.mts

@@ -0,0 +1,171 @@
+import { cU as MiddlewareChain, cZ as RateLimitStorage, c_ as RateLimitStatus, c$ as MemoryRateLimitStorageOptions, cP as MiddlewareContext, a2 as FarmMiddlewareConfig, cQ as MiddlewareFunction, dx as MiddlewareConfig, M as MiddlewareProps } from './client-plugins-QQntVkrv.mjs';
+export { cV as CookieJar, cW as CookieOptions, d1 as MiddlewareResult, cT as MiddlewareStore, d0 as NextFunction, cX as RateLimitConfig, cY as RateLimitIncrementResult, a1 as ReadonlyMiddlewareStore, cR as RequestMiddleware, cS as RequestMiddlewareContext } from './client-plugins-QQntVkrv.mjs';
+import { IncomingMessage, ServerResponse } from 'http';
+import { ViteDevServer, Plugin } from 'vite';
+import { R as ResolvedFarmI18nConfig } from './types-BMxWr97v.mjs';
+export { _ as _runWithMiddlewareContext, b as _runWithMiddlewareData, a as applyProductionMiddlewareHeaders, c as createProductionMiddlewareRunner, g as getMiddlewareContext, d as getMiddlewareData, e as getMiddlewareValue } from './production-runtime-Bxua86uR.mjs';
+import './plugin-BJDf43dc.mjs';
+import 'react';
+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-CusFV6mn.mjs';
+import './cron.mjs';
+import './env.mjs';
+import './server-action-security.mjs';
+import './server-fn-error-DDh14a0V.mjs';
+import './image-config-Duob7wER.mjs';
+import './cache.mjs';
+import './route-runtime-DoOHzCAD.mjs';
+import './font.mjs';
+
+/**
+ * Middleware Chain Builder
+ */
+
+declare class UnsupportedRateLimitStorageError extends TypeError {
+    constructor();
+}
+/** Create an atomic, process-local fixed-window rate-limit store. */
+declare function memoryRateLimitStorage(options?: MemoryRateLimitStorageOptions): RateLimitStorage;
+/**
+ * Get rate limit status for a key
+ * @example
+ * const status = await getRateLimitStatus('user:123', 100, storage);
+ */
+declare function getRateLimitStatus(key: string, limit: number, storage?: RateLimitStorage): Promise<RateLimitStatus>;
+declare function middleware(basePath?: string): MiddlewareChain;
+
+/**
+ * Middleware Context Implementation
+ */
+
+/**
+ * Create a middleware context from request/response
+ */
+declare function createContext(req: IncomingMessage, res: ServerResponse, viteServer?: ViteDevServer, parent?: MiddlewareContext["parent"]): MiddlewareContext;
+
+/**
+ * Middleware Manager
+ *
+ * Discovers and executes middleware files in the file system
+ */
+
+interface DiscoveredMiddleware {
+    path: string;
+    filePath: string;
+    handlers: MiddlewareFunction[];
+    config?: MiddlewareConfig;
+    source?: "config" | "file";
+}
+/**
+ * Middleware Manager - discovers and executes middleware
+ */
+declare class MiddlewareManager {
+    private middleware;
+    private configMiddleware;
+    private globalConfig?;
+    private viteServer?;
+    private appDirs;
+    private i18n?;
+    constructor(appDir: string | readonly string[], viteServer?: ViteDevServer, config?: FarmMiddlewareConfig, i18n?: ResolvedFarmI18nConfig);
+    configure(config?: FarmMiddlewareConfig): void;
+    /**
+     * Discover all middleware.ts files
+     */
+    discover(): Promise<void>;
+    /**
+     * Recursively discover middleware files
+     */
+    private discoverInDirectory;
+    /**
+     * Find middleware file in directory
+     */
+    private findMiddlewareFile;
+    /**
+     * Load a middleware file
+     */
+    private loadMiddleware;
+    /**
+     * Execute middleware for a request
+     */
+    execute(req: IncomingMessage, res: ServerResponse): Promise<boolean>;
+    /**
+     * Check if pathname matches middleware config
+     */
+    private matchesConfig;
+    /**
+     * Match a pattern against pathname
+     */
+    private matchPattern;
+    /**
+     * Reload middleware (for HMR)
+     */
+    reload(): Promise<void>;
+    getMiddlewares(): DiscoveredMiddleware[];
+    hasMiddleware(): boolean;
+    private matchRoutePath;
+    private toMatcherList;
+    private getConfigHandlers;
+    private toMiddlewareConfig;
+    private compilePathPattern;
+    private parseColonParam;
+    private escapeRegex;
+}
+
+/**
+ * Middleware helper utilities for pages
+ */
+
+/**
+ * Unwrap middleware data from PageProps
+ *
+ * @example
+ * ```tsx
+ * export default async function Page(props: PageProps) {
+ *   const { user, stats } = await unwrapMiddleware(props.middleware, {
+ *     user: null,
+ *     stats: { views: 0, clicks: 0 }
+ *   });
+ *
+ *   return <div>Welcome {user?.name}</div>;
+ * }
+ * ```
+ */
+declare function unwrapMiddleware<T extends Record<string, any>>(middleware: MiddlewareProps | undefined, defaults?: Partial<T>): Partial<T>;
+/**
+ * Get a single value from middleware with a default
+ *
+ * @example
+ * ```tsx
+ * export default async function Page(props: PageProps) {
+ *   const user = await getMiddlewareValue(props.middleware, 'user', null);
+ *   return <div>Welcome {user?.name || 'Guest'}</div>;
+ * }
+ * ```
+ */
+declare function getFromMiddleware<T = any>(middleware: MiddlewareProps | undefined, key: string, defaultValue?: T): T | undefined;
+/**
+ * Check if middleware data exists
+ */
+declare function hasMiddlewareData(middleware: MiddlewareProps | undefined): boolean;
+
+/**
+ * Standalone Vite middleware support used by Farm's RSC and API plugins.
+ */
+
+interface FarmMiddlewarePluginOptions {
+    /** Source directory (default: `src`). */
+    srcDir?: string;
+    /** Enable debug logging. */
+    debug?: boolean;
+}
+declare function farmMiddlewarePlugin(options?: FarmMiddlewarePluginOptions): Plugin;
+
+export { FarmMiddlewareConfig, type FarmMiddlewarePluginOptions, MemoryRateLimitStorageOptions, MiddlewareChain, MiddlewareConfig, MiddlewareContext, MiddlewareFunction, MiddlewareManager, RateLimitStatus, RateLimitStorage, UnsupportedRateLimitStorageError, createContext, farmMiddlewarePlugin, getFromMiddleware, getRateLimitStatus, hasMiddlewareData, memoryRateLimitStorage, middleware, unwrapMiddleware };

package/dist/middleware.d.ts

@@ -0,0 +1,171 @@
+import { cU as MiddlewareChain, cZ as RateLimitStorage, c_ as RateLimitStatus, c$ as MemoryRateLimitStorageOptions, cP as MiddlewareContext, a2 as FarmMiddlewareConfig, cQ as MiddlewareFunction, dx as MiddlewareConfig, M as MiddlewareProps } from './client-plugins-CbRum1fj.js';
+export { cV as CookieJar, cW as CookieOptions, d1 as MiddlewareResult, cT as MiddlewareStore, d0 as NextFunction, cX as RateLimitConfig, cY as RateLimitIncrementResult, a1 as ReadonlyMiddlewareStore, cR as RequestMiddleware, cS as RequestMiddlewareContext } from './client-plugins-CbRum1fj.js';
+import { IncomingMessage, ServerResponse } from 'http';
+import { ViteDevServer, Plugin } from 'vite';
+import { R as ResolvedFarmI18nConfig } from './types-BMxWr97v.js';
+export { _ as _runWithMiddlewareContext, b as _runWithMiddlewareData, a as applyProductionMiddlewareHeaders, c as createProductionMiddlewareRunner, g as getMiddlewareContext, d as getMiddlewareData, e as getMiddlewareValue } from './production-runtime-CZqXjRVi.js';
+import './plugin-BJDf43dc.js';
+import 'react';
+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-CusFV6mn.js';
+import './cron.js';
+import './env.js';
+import './server-action-security.js';
+import './server-fn-error-DDh14a0V.js';
+import './image-config-Duob7wER.js';
+import './cache.js';
+import './route-runtime-DoOHzCAD.js';
+import './font.js';
+
+/**
+ * Middleware Chain Builder
+ */
+
+declare class UnsupportedRateLimitStorageError extends TypeError {
+    constructor();
+}
+/** Create an atomic, process-local fixed-window rate-limit store. */
+declare function memoryRateLimitStorage(options?: MemoryRateLimitStorageOptions): RateLimitStorage;
+/**
+ * Get rate limit status for a key
+ * @example
+ * const status = await getRateLimitStatus('user:123', 100, storage);
+ */
+declare function getRateLimitStatus(key: string, limit: number, storage?: RateLimitStorage): Promise<RateLimitStatus>;
+declare function middleware(basePath?: string): MiddlewareChain;
+
+/**
+ * Middleware Context Implementation
+ */
+
+/**
+ * Create a middleware context from request/response
+ */
+declare function createContext(req: IncomingMessage, res: ServerResponse, viteServer?: ViteDevServer, parent?: MiddlewareContext["parent"]): MiddlewareContext;
+
+/**
+ * Middleware Manager
+ *
+ * Discovers and executes middleware files in the file system
+ */
+
+interface DiscoveredMiddleware {
+    path: string;
+    filePath: string;
+    handlers: MiddlewareFunction[];
+    config?: MiddlewareConfig;
+    source?: "config" | "file";
+}
+/**
+ * Middleware Manager - discovers and executes middleware
+ */
+declare class MiddlewareManager {
+    private middleware;
+    private configMiddleware;
+    private globalConfig?;
+    private viteServer?;
+    private appDirs;
+    private i18n?;
+    constructor(appDir: string | readonly string[], viteServer?: ViteDevServer, config?: FarmMiddlewareConfig, i18n?: ResolvedFarmI18nConfig);
+    configure(config?: FarmMiddlewareConfig): void;
+    /**
+     * Discover all middleware.ts files
+     */
+    discover(): Promise<void>;
+    /**
+     * Recursively discover middleware files
+     */
+    private discoverInDirectory;
+    /**
+     * Find middleware file in directory
+     */
+    private findMiddlewareFile;
+    /**
+     * Load a middleware file
+     */
+    private loadMiddleware;
+    /**
+     * Execute middleware for a request
+     */
+    execute(req: IncomingMessage, res: ServerResponse): Promise<boolean>;
+    /**
+     * Check if pathname matches middleware config
+     */
+    private matchesConfig;
+    /**
+     * Match a pattern against pathname
+     */
+    private matchPattern;
+    /**
+     * Reload middleware (for HMR)
+     */
+    reload(): Promise<void>;
+    getMiddlewares(): DiscoveredMiddleware[];
+    hasMiddleware(): boolean;
+    private matchRoutePath;
+    private toMatcherList;
+    private getConfigHandlers;
+    private toMiddlewareConfig;
+    private compilePathPattern;
+    private parseColonParam;
+    private escapeRegex;
+}
+
+/**
+ * Middleware helper utilities for pages
+ */
+
+/**
+ * Unwrap middleware data from PageProps
+ *
+ * @example
+ * ```tsx
+ * export default async function Page(props: PageProps) {
+ *   const { user, stats } = await unwrapMiddleware(props.middleware, {
+ *     user: null,
+ *     stats: { views: 0, clicks: 0 }
+ *   });
+ *
+ *   return <div>Welcome {user?.name}</div>;
+ * }
+ * ```
+ */
+declare function unwrapMiddleware<T extends Record<string, any>>(middleware: MiddlewareProps | undefined, defaults?: Partial<T>): Partial<T>;
+/**
+ * Get a single value from middleware with a default
+ *
+ * @example
+ * ```tsx
+ * export default async function Page(props: PageProps) {
+ *   const user = await getMiddlewareValue(props.middleware, 'user', null);
+ *   return <div>Welcome {user?.name || 'Guest'}</div>;
+ * }
+ * ```
+ */
+declare function getFromMiddleware<T = any>(middleware: MiddlewareProps | undefined, key: string, defaultValue?: T): T | undefined;
+/**
+ * Check if middleware data exists
+ */
+declare function hasMiddlewareData(middleware: MiddlewareProps | undefined): boolean;
+
+/**
+ * Standalone Vite middleware support used by Farm's RSC and API plugins.
+ */
+
+interface FarmMiddlewarePluginOptions {
+    /** Source directory (default: `src`). */
+    srcDir?: string;
+    /** Enable debug logging. */
+    debug?: boolean;
+}
+declare function farmMiddlewarePlugin(options?: FarmMiddlewarePluginOptions): Plugin;
+
+export { FarmMiddlewareConfig, type FarmMiddlewarePluginOptions, MemoryRateLimitStorageOptions, MiddlewareChain, MiddlewareConfig, MiddlewareContext, MiddlewareFunction, MiddlewareManager, RateLimitStatus, RateLimitStorage, UnsupportedRateLimitStorageError, createContext, farmMiddlewarePlugin, getFromMiddleware, getRateLimitStatus, hasMiddlewareData, memoryRateLimitStorage, middleware, unwrapMiddleware };

package/dist/middleware.mjs

@@ -7,7 +7,7 @@ import {
   memoryRateLimitStorage,
   middleware,
   unwrapMiddleware
-} from "./chunk-RIXKJPGI.mjs";
+} from "./chunk-42325TLU.mjs";
 import {
   applyProductionMiddlewareHeaders,
   createProductionMiddlewareRunner
@@ -15,7 +15,7 @@ import {
 import {
   MiddlewareManager,
   createContext
-} from "./chunk-MIUW47JX.mjs";
+} from "./chunk-2PEJGY5V.mjs";
 import {
   _runWithMiddlewareContext,
   _runWithMiddlewareData,
@@ -23,6 +23,7 @@ import {
   getMiddlewareData,
   getMiddlewareValue
 } from "./chunk-P7QDS5AT.mjs";
+import "./chunk-GIELMNBG.mjs";
 import "./chunk-QGOHVJ6J.mjs";
 import "./chunk-J4FNJ5IU.mjs";
 import "./chunk-RHIFZZUI.mjs";

package/dist/navigation-errors-Dvwpzaer.d.mts

@@ -0,0 +1,13 @@
+type FarmRedirectStatus = 301 | 302 | 303 | 307 | 308;
+interface FarmRedirectSignal {
+    url: string;
+    status: FarmRedirectStatus;
+}
+declare function redirect(url: string, status?: FarmRedirectStatus): never;
+declare function permanentRedirect(url: string): never;
+declare function notFound(): never;
+declare function isFarmRedirectError(error: unknown): boolean;
+declare function getFarmRedirectError(error: unknown): FarmRedirectSignal | null;
+declare function isFarmNotFoundError(error: unknown): boolean;
+
+export { type FarmRedirectSignal as F, isFarmRedirectError as a, type FarmRedirectStatus as b, getFarmRedirectError as g, isFarmNotFoundError as i, notFound as n, permanentRedirect as p, redirect as r };

package/dist/navigation-errors-Dvwpzaer.d.ts

@@ -0,0 +1,13 @@
+type FarmRedirectStatus = 301 | 302 | 303 | 307 | 308;
+interface FarmRedirectSignal {
+    url: string;
+    status: FarmRedirectStatus;
+}
+declare function redirect(url: string, status?: FarmRedirectStatus): never;
+declare function permanentRedirect(url: string): never;
+declare function notFound(): never;
+declare function isFarmRedirectError(error: unknown): boolean;
+declare function getFarmRedirectError(error: unknown): FarmRedirectSignal | null;
+declare function isFarmNotFoundError(error: unknown): boolean;
+
+export { type FarmRedirectSignal as F, isFarmRedirectError as a, type FarmRedirectStatus as b, getFarmRedirectError as g, isFarmNotFoundError as i, notFound as n, permanentRedirect as p, redirect as r };

package/dist/navigation.d.mts

@@ -0,0 +1,14 @@
+export { F as FarmRedirectSignal, b as FarmRedirectStatus, g as getFarmRedirectError, i as isFarmNotFoundError, a as isFarmRedirectError, n as notFound, p as permanentRedirect, r as redirect } from './navigation-errors-Dvwpzaer.mjs';
+
+declare function useRouter(): {
+    push: (href: string) => void;
+    replace: (href: string) => void;
+    back: () => void;
+    forward: () => void;
+    refresh(): void;
+    prefetch(_href: string): Promise<void>;
+};
+declare function usePathname(): string;
+declare function useSearchParams(): URLSearchParams;
+
+export { usePathname, useRouter, useSearchParams };

package/dist/navigation.d.ts

@@ -0,0 +1,14 @@
+export { F as FarmRedirectSignal, b as FarmRedirectStatus, g as getFarmRedirectError, i as isFarmNotFoundError, a as isFarmRedirectError, n as notFound, p as permanentRedirect, r as redirect } from './navigation-errors-Dvwpzaer.js';
+
+declare function useRouter(): {
+    push: (href: string) => void;
+    replace: (href: string) => void;
+    back: () => void;
+    forward: () => void;
+    refresh(): void;
+    prefetch(_href: string): Promise<void>;
+};
+declare function usePathname(): string;
+declare function useSearchParams(): URLSearchParams;
+
+export { usePathname, useRouter, useSearchParams };