@farm.js/core 0.1.0-beta.1 → 0.1.0-beta.4

package/dist/api.d.mts

@@ -1,157 +1,15 @@
+export { A as APIRouteMatch, c as APIRouteParamValue, b as APIRouteParams, q as AnyEndpointMiddleware, D as DELETE, e as EndpointErrorContracts, E as EndpointErrorDefinition, d as EndpointErrorDefinitions, f as EndpointFail, g as EndpointFailure, v as EndpointHandler, s as EndpointInvalidationContext, r as EndpointInvalidationTarget, t as EndpointInvalidations, p as EndpointMiddleware, l as EndpointMiddlewareContext, o as EndpointMiddlewareResult, u as EndpointOptions, j as EndpointParamValue, k as EndpointParams, G as GET, H as HEAD, I as InferEndpointMiddlewareContext, O as OPTIONS, y as PATCH, P as POST, x as PUT, T as TypedEndpoint, w as createEndpoint, i as invokeAPIRouteEndpoint, h as isEndpointFailure, a as isWebResponse, m as matchAPIRoute, n as normalizeRouteResponse } from './runtime-9nQjVM7X.mjs';
 export { APIRoute, APIRouteManager, APIRouteManagerOptions, API_ROUTE_METHODS } from './api/route-manager.mjs';
-export { n as APIClient, A as APIClientOptions, a as APIClientWithoutIntegrationsOptions, e as APIResult, C as CacheKey, h as CacheOptions, g as CachePolicy, l as ClientOptions, j as InvalidateOptions, I as InvalidateTarget, k as OptimisticOptions, O as OptimisticUpdate, R as RequestEvent, f as ResponseEvent, i as RetryOptions, m as RouteAPIClient, o as ServerAPIClient, S as ServerAPIClientOptions, b as ServerAPIClientWithoutIntegrationsOptions, d as StatusEvent, c as StatusPhase, p as createAPIClient, q as createServerAPIClient } from './client-D_yUjVhe.mjs';
+export { r as APIClient, h as APIClientError, b as APIClientOptions, i as APIClientSystemError, c as APIClientWithoutIntegrationsOptions, g as APIResult, A as APIRouteRefMetadata, C as CacheKey, l as CacheOptions, k as CachePolicy, p as ClientOptions, a as FARM_API_ROUTE_META_SYMBOL, F as FARM_API_ROUTE_REF_SYMBOL, n as InvalidateOptions, I as InvalidateTarget, o as OptimisticOptions, O as OptimisticUpdate, R as RequestEvent, j as ResponseEvent, m as RetryOptions, q as RouteAPIClient, s as ServerAPIClient, S as ServerAPIClientOptions, d as ServerAPIClientWithoutIntegrationsOptions, f as StatusEvent, e as StatusPhase, t as createAPIClient, w as createServerAPIClient, v as getAPIRouteRefMetadata, u as isAPIRouteRef } from './client-BT1mFQas.mjs';
+export { F as FarmAPIStream, c as FarmStreamResponse, a as MultipartField, M as MultipartSchema, b as MultipartValues, T as TypedFormData, e as isFarmAPIStream, d as isJSONStreamResponse, i as isMultipartSchema, j as jsonStream, m as multipart, r as readJSONStream, t as toFormData } from './transport-BmbGTXA5.mjs';
 import { Plugin } from 'vite';
-export { APIRouteMatch, APIRouteParamValue, APIRouteParams, invokeAPIRouteEndpoint, isWebResponse, matchAPIRoute, normalizeRouteResponse } from './api/runtime.mjs';
+import './cache.mjs';
 import './route-runtime-DoOHzCAD.mjs';
 import './types-BH1lhg5G.mjs';
 import './runtime-DeAAZ6gO.mjs';
 import './resolver-DlOPpjkB.mjs';
 import './integration-api-CHT2OKAf.mjs';
 import './client-cache-D-EZ7XVW.mjs';
-import './cache.mjs';
-
-type AnySchema = {
-    _output?: any;
-    _input?: any;
-    parse?: (data: unknown) => any;
-};
-type MaybePromise<T> = T | Promise<T>;
-type Simplify<T> = {
-    [TKey in keyof T]: T[TKey];
-} & {};
-type UnionToIntersection<T> = (T extends unknown ? (value: T) => void : never) extends (value: infer TIntersection) => void ? TIntersection : never;
-type InferOutput<T> = T extends {
-    _output: infer O;
-} ? O : T extends {
-    parse: (data: unknown) => infer R;
-} ? R : unknown;
-type InferHeadersOutput<T> = [T] extends [never] ? Record<string, string> : T extends AnySchema ? InferOutput<T> : Record<string, string>;
-type EndpointParamValue = string | string[];
-type EndpointParams = Record<string, EndpointParamValue>;
-type EndpointMiddlewareContext<TContext extends object = {}, TBody = unknown, TQuery = unknown, THeaders = Record<string, string>> = {
-    body: TBody;
-    query: TQuery;
-    headers: THeaders;
-    request: Request;
-    /** Context accumulated from middleware that ran earlier in the chain. */
-    context: Readonly<TContext>;
-    params: EndpointParams;
-};
-type EndpointMiddlewareResult<TProvidedContext extends object = object> = TProvidedContext | true | false | Response;
-/** A plain async function. No wrapper or `next()` callback is required. */
-type EndpointMiddleware<TProvidedContext extends object = object, TContext extends object = {}, TBody = unknown, TQuery = unknown, THeaders = Record<string, string>> = (ctx: EndpointMiddlewareContext<TContext, TBody, TQuery, THeaders>) => MaybePromise<EndpointMiddlewareResult<TProvidedContext>>;
-type AnyEndpointMiddleware = (ctx: EndpointMiddlewareContext<any, any, any, any>) => unknown;
-type ValidateEndpointMiddlewares<TMiddlewares extends readonly AnyEndpointMiddleware[]> = {
-    readonly [TIndex in keyof TMiddlewares]: TMiddlewares[TIndex] extends AnyEndpointMiddleware ? [Awaited<ReturnType<TMiddlewares[TIndex]>>] extends [EndpointMiddlewareResult<object>] ? TMiddlewares[TIndex] : never : never;
-};
-type ContextFromMiddlewareResult<TResult> = Exclude<TResult, Response | boolean> extends infer TContext ? [TContext] extends [never] ? {} : TContext extends object ? TContext : {} : {};
-type ContextFromMiddleware<TMiddleware> = TMiddleware extends (...args: any[]) => infer TResult ? ContextFromMiddlewareResult<Awaited<TResult>> : {};
-type InferEndpointMiddlewareContext<TMiddlewares extends readonly ((...args: any[]) => any)[], TContext extends object = {}> = TMiddlewares extends readonly [infer TMiddleware, ...infer TRest] ? TMiddleware extends (...args: any[]) => any ? TRest extends readonly ((...args: any[]) => any)[] ? InferEndpointMiddlewareContext<TRest, Simplify<TContext & ContextFromMiddleware<TMiddleware>>> : Simplify<TContext> : Simplify<TContext> : number extends TMiddlewares["length"] ? Simplify<TContext & UnionToIntersection<ContextFromMiddleware<TMiddlewares[number]>>> : Simplify<TContext>;
-type EndpointOptions<TBody extends AnySchema = never, TQuery extends AnySchema = never, THeaders extends AnySchema = never, TMiddlewares extends readonly AnyEndpointMiddleware[] = readonly []> = {
-    method?: "GET" | "HEAD" | "POST" | "PUT" | "DELETE" | "PATCH" | "OPTIONS";
-    body?: TBody;
-    query?: TQuery;
-    headers?: THeaders;
-    middleware?: TMiddlewares;
-    /** @deprecated Use plain functions in `middleware` for Farm endpoint middleware. */
-    use?: any[];
-};
-type EndpointHandler<TBody extends AnySchema = never, TQuery extends AnySchema = never, THeaders extends AnySchema = never, TResponse = any, TContext extends object = {}> = (ctx: {
-    body: InferOutput<TBody>;
-    query: InferOutput<TQuery>;
-    headers: InferHeadersOutput<THeaders>;
-    request: Request;
-    context: Readonly<TContext>;
-    params: EndpointParams;
-}) => Promise<TResponse> | TResponse;
-type TypedEndpoint<TBody = never, TQuery = never, TResponse = any, THeaders = Record<string, string>> = {
-    __types: {
-        body: TBody;
-        query: TQuery;
-        headers: THeaders;
-        response: TResponse;
-    };
-    __path?: string;
-    __method?: string;
-} & ((options?: {
-    body?: TBody;
-    query?: TQuery;
-}) => Promise<TResponse>);
-type CreatedEndpoint<TBody extends AnySchema, TQuery extends AnySchema, THeaders extends AnySchema, TResponse> = TypedEndpoint<InferOutput<TBody>, InferOutput<TQuery>, Awaited<TResponse>, InferHeadersOutput<THeaders>>;
-type AnyEndpointOptions = EndpointOptions<AnySchema, AnySchema, AnySchema, readonly AnyEndpointMiddleware[]>;
-type EndpointBodyFromOptions<TOptions> = TOptions extends {
-    body: infer TBody extends AnySchema;
-} ? TBody : never;
-type EndpointQueryFromOptions<TOptions> = TOptions extends {
-    query: infer TQuery extends AnySchema;
-} ? TQuery : never;
-type EndpointHeadersFromOptions<TOptions> = TOptions extends {
-    headers: infer THeaders extends AnySchema;
-} ? THeaders : never;
-type EndpointMiddlewaresFromOptions<TOptions> = TOptions extends {
-    middleware: infer TMiddlewares extends readonly AnyEndpointMiddleware[];
-} ? TMiddlewares : readonly [];
-type MethodlessEndpointOptions = Omit<AnyEndpointOptions, "method">;
-type EndpointHandlerFromOptions<TOptions, TResponse> = EndpointHandler<EndpointBodyFromOptions<TOptions>, EndpointQueryFromOptions<TOptions>, EndpointHeadersFromOptions<TOptions>, TResponse, InferEndpointMiddlewareContext<EndpointMiddlewaresFromOptions<TOptions>>>;
-type ValidatedEndpointHandlerFromOptions<TOptions, TResponse> = EndpointHandlerFromOptions<TOptions, TResponse> & (EndpointMiddlewaresFromOptions<TOptions> extends ValidateEndpointMiddlewares<EndpointMiddlewaresFromOptions<TOptions>> ? unknown : never);
-type CreatedEndpointFromOptions<TOptions, TResponse> = CreatedEndpoint<EndpointBodyFromOptions<TOptions>, EndpointQueryFromOptions<TOptions>, EndpointHeadersFromOptions<TOptions>, TResponse>;
-/**
- * Create a Farm.js API endpoint
- *
- * Supports two patterns:
- * 1. File-based routing (path auto-inferred from file location):
- *    `export const POST = createEndpoint({ method: 'POST', body: schema }, handler)`
- *    `createEndpoint({ method: 'GET', query: z.object({...}) }, handler)`
- *
- * 2. Explicit path (for routes.ts at project root):
- *    `createEndpoint('/api/hello', { method: 'GET', query: z.object({...}) }, handler)`
- */
-declare function createEndpoint<const TOptions extends AnyEndpointOptions, TResponse = any>(options: TOptions, handler: ValidatedEndpointHandlerFromOptions<TOptions, TResponse>): CreatedEndpointFromOptions<TOptions, TResponse>;
-declare function createEndpoint<const TOptions extends AnyEndpointOptions, TResponse = any>(path: string, options: TOptions, handler: ValidatedEndpointHandlerFromOptions<TOptions, TResponse>): CreatedEndpointFromOptions<TOptions, TResponse>;
-declare function createEndpoint<TBody extends AnySchema = never, TQuery extends AnySchema = never, THeaders extends AnySchema = never, TResponse = any>(options: EndpointOptions<TBody, TQuery, THeaders, readonly []>, handler: EndpointHandler<TBody, TQuery, THeaders, TResponse>): CreatedEndpoint<TBody, TQuery, THeaders, TResponse>;
-declare function createEndpoint<TBody extends AnySchema = never, TQuery extends AnySchema = never, THeaders extends AnySchema = never, TResponse = any>(path: string, options: EndpointOptions<TBody, TQuery, THeaders, readonly []>, handler: EndpointHandler<TBody, TQuery, THeaders, TResponse>): CreatedEndpoint<TBody, TQuery, THeaders, TResponse>;
-/**
- * Convenience method for GET requests
- */
-declare function GET<T = any>(handler: EndpointHandler<never, never, never, T>): CreatedEndpoint<never, never, never, T>;
-declare function GET<const TOptions extends MethodlessEndpointOptions, TResponse = any>(options: TOptions, handler: ValidatedEndpointHandlerFromOptions<TOptions, TResponse>): CreatedEndpointFromOptions<TOptions, TResponse>;
-declare function GET<TQuery extends AnySchema = never, THeaders extends AnySchema = never, TResponse = any>(options: Omit<EndpointOptions<never, TQuery, THeaders, readonly []>, "method">, handler: EndpointHandler<never, TQuery, THeaders, TResponse>): CreatedEndpoint<never, TQuery, THeaders, TResponse>;
-/**
- * Convenience method for HEAD requests
- */
-declare function HEAD<T = any>(handler: EndpointHandler<never, never, never, T>): CreatedEndpoint<never, never, never, T>;
-declare function HEAD<const TOptions extends MethodlessEndpointOptions, TResponse = any>(options: TOptions, handler: ValidatedEndpointHandlerFromOptions<TOptions, TResponse>): CreatedEndpointFromOptions<TOptions, TResponse>;
-declare function HEAD<TQuery extends AnySchema = never, THeaders extends AnySchema = never, TResponse = any>(options: Omit<EndpointOptions<never, TQuery, THeaders, readonly []>, "method">, handler: EndpointHandler<never, TQuery, THeaders, TResponse>): CreatedEndpoint<never, TQuery, THeaders, TResponse>;
-/**
- * Convenience method for POST requests
- */
-declare function POST<T = any>(handler: EndpointHandler<never, never, never, T>): CreatedEndpoint<never, never, never, T>;
-declare function POST<const TOptions extends MethodlessEndpointOptions, TResponse = any>(options: TOptions, handler: ValidatedEndpointHandlerFromOptions<TOptions, TResponse>): CreatedEndpointFromOptions<TOptions, TResponse>;
-declare function POST<TBody extends AnySchema = never, TQuery extends AnySchema = never, THeaders extends AnySchema = never, TResponse = any>(options: Omit<EndpointOptions<TBody, TQuery, THeaders, readonly []>, "method">, handler: EndpointHandler<TBody, TQuery, THeaders, TResponse>): CreatedEndpoint<TBody, TQuery, THeaders, TResponse>;
-/**
- * Convenience method for PUT requests
- */
-declare function PUT<T = any>(handler: EndpointHandler<never, never, never, T>): CreatedEndpoint<never, never, never, T>;
-declare function PUT<const TOptions extends MethodlessEndpointOptions, TResponse = any>(options: TOptions, handler: ValidatedEndpointHandlerFromOptions<TOptions, TResponse>): CreatedEndpointFromOptions<TOptions, TResponse>;
-declare function PUT<TBody extends AnySchema = never, TQuery extends AnySchema = never, THeaders extends AnySchema = never, TResponse = any>(options: Omit<EndpointOptions<TBody, TQuery, THeaders, readonly []>, "method">, handler: EndpointHandler<TBody, TQuery, THeaders, TResponse>): CreatedEndpoint<TBody, TQuery, THeaders, TResponse>;
-/**
- * Convenience method for DELETE requests
- */
-declare function DELETE<T = any>(handler: EndpointHandler<never, never, never, T>): CreatedEndpoint<never, never, never, T>;
-declare function DELETE<const TOptions extends MethodlessEndpointOptions, TResponse = any>(options: TOptions, handler: ValidatedEndpointHandlerFromOptions<TOptions, TResponse>): CreatedEndpointFromOptions<TOptions, TResponse>;
-declare function DELETE<TBody extends AnySchema = never, TQuery extends AnySchema = never, THeaders extends AnySchema = never, TResponse = any>(options: Omit<EndpointOptions<TBody, TQuery, THeaders, readonly []>, "method">, handler: EndpointHandler<TBody, TQuery, THeaders, TResponse>): CreatedEndpoint<TBody, TQuery, THeaders, TResponse>;
-/**
- * Convenience method for PATCH requests
- */
-declare function PATCH<T = any>(handler: EndpointHandler<never, never, never, T>): CreatedEndpoint<never, never, never, T>;
-declare function PATCH<const TOptions extends MethodlessEndpointOptions, TResponse = any>(options: TOptions, handler: ValidatedEndpointHandlerFromOptions<TOptions, TResponse>): CreatedEndpointFromOptions<TOptions, TResponse>;
-declare function PATCH<TBody extends AnySchema = never, TQuery extends AnySchema = never, THeaders extends AnySchema = never, TResponse = any>(options: Omit<EndpointOptions<TBody, TQuery, THeaders, readonly []>, "method">, handler: EndpointHandler<TBody, TQuery, THeaders, TResponse>): CreatedEndpoint<TBody, TQuery, THeaders, TResponse>;
-/**
- * Convenience method for OPTIONS requests
- */
-declare function OPTIONS<T = any>(handler: EndpointHandler<never, never, never, T>): CreatedEndpoint<never, never, never, T>;
-declare function OPTIONS<const TOptions extends MethodlessEndpointOptions, TResponse = any>(options: TOptions, handler: ValidatedEndpointHandlerFromOptions<TOptions, TResponse>): CreatedEndpointFromOptions<TOptions, TResponse>;
-declare function OPTIONS<TBody extends AnySchema = never, TQuery extends AnySchema = never, THeaders extends AnySchema = never, TResponse = any>(options: Omit<EndpointOptions<TBody, TQuery, THeaders, readonly []>, "method">, handler: EndpointHandler<TBody, TQuery, THeaders, TResponse>): CreatedEndpoint<TBody, TQuery, THeaders, TResponse>;
 
 /**
  * Farm.js API Routes Vite Plugin
@@ -187,4 +45,4 @@ interface ApiRoute {
  */
 declare function farmApiPlugin(options?: FarmApiPluginOptions): Plugin;
 
-export { type AnyEndpointMiddleware, type ApiRoute, DELETE, type EndpointHandler, type EndpointMiddleware, type EndpointMiddlewareContext, type EndpointMiddlewareResult, type EndpointOptions, type EndpointParamValue, type EndpointParams, type FarmApiPluginOptions, GET, HEAD, type InferEndpointMiddlewareContext, OPTIONS, PATCH, POST, PUT, type TypedEndpoint, createEndpoint, farmApiPlugin };
+export { type ApiRoute, type FarmApiPluginOptions, farmApiPlugin };

package/dist/api.d.ts

@@ -1,157 +1,15 @@
+export { A as APIRouteMatch, c as APIRouteParamValue, b as APIRouteParams, q as AnyEndpointMiddleware, D as DELETE, e as EndpointErrorContracts, E as EndpointErrorDefinition, d as EndpointErrorDefinitions, f as EndpointFail, g as EndpointFailure, v as EndpointHandler, s as EndpointInvalidationContext, r as EndpointInvalidationTarget, t as EndpointInvalidations, p as EndpointMiddleware, l as EndpointMiddlewareContext, o as EndpointMiddlewareResult, u as EndpointOptions, j as EndpointParamValue, k as EndpointParams, G as GET, H as HEAD, I as InferEndpointMiddlewareContext, O as OPTIONS, y as PATCH, P as POST, x as PUT, T as TypedEndpoint, w as createEndpoint, i as invokeAPIRouteEndpoint, h as isEndpointFailure, a as isWebResponse, m as matchAPIRoute, n as normalizeRouteResponse } from './runtime-DgeS2skB.js';
 export { APIRoute, APIRouteManager, APIRouteManagerOptions, API_ROUTE_METHODS } from './api/route-manager.js';
-export { n as APIClient, A as APIClientOptions, a as APIClientWithoutIntegrationsOptions, e as APIResult, C as CacheKey, h as CacheOptions, g as CachePolicy, l as ClientOptions, j as InvalidateOptions, I as InvalidateTarget, k as OptimisticOptions, O as OptimisticUpdate, R as RequestEvent, f as ResponseEvent, i as RetryOptions, m as RouteAPIClient, o as ServerAPIClient, S as ServerAPIClientOptions, b as ServerAPIClientWithoutIntegrationsOptions, d as StatusEvent, c as StatusPhase, p as createAPIClient, q as createServerAPIClient } from './client-Dkc03WP8.js';
+export { r as APIClient, h as APIClientError, b as APIClientOptions, i as APIClientSystemError, c as APIClientWithoutIntegrationsOptions, g as APIResult, A as APIRouteRefMetadata, C as CacheKey, l as CacheOptions, k as CachePolicy, p as ClientOptions, a as FARM_API_ROUTE_META_SYMBOL, F as FARM_API_ROUTE_REF_SYMBOL, n as InvalidateOptions, I as InvalidateTarget, o as OptimisticOptions, O as OptimisticUpdate, R as RequestEvent, j as ResponseEvent, m as RetryOptions, q as RouteAPIClient, s as ServerAPIClient, S as ServerAPIClientOptions, d as ServerAPIClientWithoutIntegrationsOptions, f as StatusEvent, e as StatusPhase, t as createAPIClient, w as createServerAPIClient, v as getAPIRouteRefMetadata, u as isAPIRouteRef } from './client-Nn0q4eO4.js';
+export { F as FarmAPIStream, c as FarmStreamResponse, a as MultipartField, M as MultipartSchema, b as MultipartValues, T as TypedFormData, e as isFarmAPIStream, d as isJSONStreamResponse, i as isMultipartSchema, j as jsonStream, m as multipart, r as readJSONStream, t as toFormData } from './transport-BmbGTXA5.js';
 import { Plugin } from 'vite';
-export { APIRouteMatch, APIRouteParamValue, APIRouteParams, invokeAPIRouteEndpoint, isWebResponse, matchAPIRoute, normalizeRouteResponse } from './api/runtime.js';
+import './cache.js';
 import './route-runtime-DoOHzCAD.js';
 import './types-BH1lhg5G.js';
 import './runtime-B6GvwDS1.js';
 import './resolver-C6iecsDV.js';
 import './integration-api-CHT2OKAf.js';
 import './client-cache-CIlyBlmx.js';
-import './cache.js';
-
-type AnySchema = {
-    _output?: any;
-    _input?: any;
-    parse?: (data: unknown) => any;
-};
-type MaybePromise<T> = T | Promise<T>;
-type Simplify<T> = {
-    [TKey in keyof T]: T[TKey];
-} & {};
-type UnionToIntersection<T> = (T extends unknown ? (value: T) => void : never) extends (value: infer TIntersection) => void ? TIntersection : never;
-type InferOutput<T> = T extends {
-    _output: infer O;
-} ? O : T extends {
-    parse: (data: unknown) => infer R;
-} ? R : unknown;
-type InferHeadersOutput<T> = [T] extends [never] ? Record<string, string> : T extends AnySchema ? InferOutput<T> : Record<string, string>;
-type EndpointParamValue = string | string[];
-type EndpointParams = Record<string, EndpointParamValue>;
-type EndpointMiddlewareContext<TContext extends object = {}, TBody = unknown, TQuery = unknown, THeaders = Record<string, string>> = {
-    body: TBody;
-    query: TQuery;
-    headers: THeaders;
-    request: Request;
-    /** Context accumulated from middleware that ran earlier in the chain. */
-    context: Readonly<TContext>;
-    params: EndpointParams;
-};
-type EndpointMiddlewareResult<TProvidedContext extends object = object> = TProvidedContext | true | false | Response;
-/** A plain async function. No wrapper or `next()` callback is required. */
-type EndpointMiddleware<TProvidedContext extends object = object, TContext extends object = {}, TBody = unknown, TQuery = unknown, THeaders = Record<string, string>> = (ctx: EndpointMiddlewareContext<TContext, TBody, TQuery, THeaders>) => MaybePromise<EndpointMiddlewareResult<TProvidedContext>>;
-type AnyEndpointMiddleware = (ctx: EndpointMiddlewareContext<any, any, any, any>) => unknown;
-type ValidateEndpointMiddlewares<TMiddlewares extends readonly AnyEndpointMiddleware[]> = {
-    readonly [TIndex in keyof TMiddlewares]: TMiddlewares[TIndex] extends AnyEndpointMiddleware ? [Awaited<ReturnType<TMiddlewares[TIndex]>>] extends [EndpointMiddlewareResult<object>] ? TMiddlewares[TIndex] : never : never;
-};
-type ContextFromMiddlewareResult<TResult> = Exclude<TResult, Response | boolean> extends infer TContext ? [TContext] extends [never] ? {} : TContext extends object ? TContext : {} : {};
-type ContextFromMiddleware<TMiddleware> = TMiddleware extends (...args: any[]) => infer TResult ? ContextFromMiddlewareResult<Awaited<TResult>> : {};
-type InferEndpointMiddlewareContext<TMiddlewares extends readonly ((...args: any[]) => any)[], TContext extends object = {}> = TMiddlewares extends readonly [infer TMiddleware, ...infer TRest] ? TMiddleware extends (...args: any[]) => any ? TRest extends readonly ((...args: any[]) => any)[] ? InferEndpointMiddlewareContext<TRest, Simplify<TContext & ContextFromMiddleware<TMiddleware>>> : Simplify<TContext> : Simplify<TContext> : number extends TMiddlewares["length"] ? Simplify<TContext & UnionToIntersection<ContextFromMiddleware<TMiddlewares[number]>>> : Simplify<TContext>;
-type EndpointOptions<TBody extends AnySchema = never, TQuery extends AnySchema = never, THeaders extends AnySchema = never, TMiddlewares extends readonly AnyEndpointMiddleware[] = readonly []> = {
-    method?: "GET" | "HEAD" | "POST" | "PUT" | "DELETE" | "PATCH" | "OPTIONS";
-    body?: TBody;
-    query?: TQuery;
-    headers?: THeaders;
-    middleware?: TMiddlewares;
-    /** @deprecated Use plain functions in `middleware` for Farm endpoint middleware. */
-    use?: any[];
-};
-type EndpointHandler<TBody extends AnySchema = never, TQuery extends AnySchema = never, THeaders extends AnySchema = never, TResponse = any, TContext extends object = {}> = (ctx: {
-    body: InferOutput<TBody>;
-    query: InferOutput<TQuery>;
-    headers: InferHeadersOutput<THeaders>;
-    request: Request;
-    context: Readonly<TContext>;
-    params: EndpointParams;
-}) => Promise<TResponse> | TResponse;
-type TypedEndpoint<TBody = never, TQuery = never, TResponse = any, THeaders = Record<string, string>> = {
-    __types: {
-        body: TBody;
-        query: TQuery;
-        headers: THeaders;
-        response: TResponse;
-    };
-    __path?: string;
-    __method?: string;
-} & ((options?: {
-    body?: TBody;
-    query?: TQuery;
-}) => Promise<TResponse>);
-type CreatedEndpoint<TBody extends AnySchema, TQuery extends AnySchema, THeaders extends AnySchema, TResponse> = TypedEndpoint<InferOutput<TBody>, InferOutput<TQuery>, Awaited<TResponse>, InferHeadersOutput<THeaders>>;
-type AnyEndpointOptions = EndpointOptions<AnySchema, AnySchema, AnySchema, readonly AnyEndpointMiddleware[]>;
-type EndpointBodyFromOptions<TOptions> = TOptions extends {
-    body: infer TBody extends AnySchema;
-} ? TBody : never;
-type EndpointQueryFromOptions<TOptions> = TOptions extends {
-    query: infer TQuery extends AnySchema;
-} ? TQuery : never;
-type EndpointHeadersFromOptions<TOptions> = TOptions extends {
-    headers: infer THeaders extends AnySchema;
-} ? THeaders : never;
-type EndpointMiddlewaresFromOptions<TOptions> = TOptions extends {
-    middleware: infer TMiddlewares extends readonly AnyEndpointMiddleware[];
-} ? TMiddlewares : readonly [];
-type MethodlessEndpointOptions = Omit<AnyEndpointOptions, "method">;
-type EndpointHandlerFromOptions<TOptions, TResponse> = EndpointHandler<EndpointBodyFromOptions<TOptions>, EndpointQueryFromOptions<TOptions>, EndpointHeadersFromOptions<TOptions>, TResponse, InferEndpointMiddlewareContext<EndpointMiddlewaresFromOptions<TOptions>>>;
-type ValidatedEndpointHandlerFromOptions<TOptions, TResponse> = EndpointHandlerFromOptions<TOptions, TResponse> & (EndpointMiddlewaresFromOptions<TOptions> extends ValidateEndpointMiddlewares<EndpointMiddlewaresFromOptions<TOptions>> ? unknown : never);
-type CreatedEndpointFromOptions<TOptions, TResponse> = CreatedEndpoint<EndpointBodyFromOptions<TOptions>, EndpointQueryFromOptions<TOptions>, EndpointHeadersFromOptions<TOptions>, TResponse>;
-/**
- * Create a Farm.js API endpoint
- *
- * Supports two patterns:
- * 1. File-based routing (path auto-inferred from file location):
- *    `export const POST = createEndpoint({ method: 'POST', body: schema }, handler)`
- *    `createEndpoint({ method: 'GET', query: z.object({...}) }, handler)`
- *
- * 2. Explicit path (for routes.ts at project root):
- *    `createEndpoint('/api/hello', { method: 'GET', query: z.object({...}) }, handler)`
- */
-declare function createEndpoint<const TOptions extends AnyEndpointOptions, TResponse = any>(options: TOptions, handler: ValidatedEndpointHandlerFromOptions<TOptions, TResponse>): CreatedEndpointFromOptions<TOptions, TResponse>;
-declare function createEndpoint<const TOptions extends AnyEndpointOptions, TResponse = any>(path: string, options: TOptions, handler: ValidatedEndpointHandlerFromOptions<TOptions, TResponse>): CreatedEndpointFromOptions<TOptions, TResponse>;
-declare function createEndpoint<TBody extends AnySchema = never, TQuery extends AnySchema = never, THeaders extends AnySchema = never, TResponse = any>(options: EndpointOptions<TBody, TQuery, THeaders, readonly []>, handler: EndpointHandler<TBody, TQuery, THeaders, TResponse>): CreatedEndpoint<TBody, TQuery, THeaders, TResponse>;
-declare function createEndpoint<TBody extends AnySchema = never, TQuery extends AnySchema = never, THeaders extends AnySchema = never, TResponse = any>(path: string, options: EndpointOptions<TBody, TQuery, THeaders, readonly []>, handler: EndpointHandler<TBody, TQuery, THeaders, TResponse>): CreatedEndpoint<TBody, TQuery, THeaders, TResponse>;
-/**
- * Convenience method for GET requests
- */
-declare function GET<T = any>(handler: EndpointHandler<never, never, never, T>): CreatedEndpoint<never, never, never, T>;
-declare function GET<const TOptions extends MethodlessEndpointOptions, TResponse = any>(options: TOptions, handler: ValidatedEndpointHandlerFromOptions<TOptions, TResponse>): CreatedEndpointFromOptions<TOptions, TResponse>;
-declare function GET<TQuery extends AnySchema = never, THeaders extends AnySchema = never, TResponse = any>(options: Omit<EndpointOptions<never, TQuery, THeaders, readonly []>, "method">, handler: EndpointHandler<never, TQuery, THeaders, TResponse>): CreatedEndpoint<never, TQuery, THeaders, TResponse>;
-/**
- * Convenience method for HEAD requests
- */
-declare function HEAD<T = any>(handler: EndpointHandler<never, never, never, T>): CreatedEndpoint<never, never, never, T>;
-declare function HEAD<const TOptions extends MethodlessEndpointOptions, TResponse = any>(options: TOptions, handler: ValidatedEndpointHandlerFromOptions<TOptions, TResponse>): CreatedEndpointFromOptions<TOptions, TResponse>;
-declare function HEAD<TQuery extends AnySchema = never, THeaders extends AnySchema = never, TResponse = any>(options: Omit<EndpointOptions<never, TQuery, THeaders, readonly []>, "method">, handler: EndpointHandler<never, TQuery, THeaders, TResponse>): CreatedEndpoint<never, TQuery, THeaders, TResponse>;
-/**
- * Convenience method for POST requests
- */
-declare function POST<T = any>(handler: EndpointHandler<never, never, never, T>): CreatedEndpoint<never, never, never, T>;
-declare function POST<const TOptions extends MethodlessEndpointOptions, TResponse = any>(options: TOptions, handler: ValidatedEndpointHandlerFromOptions<TOptions, TResponse>): CreatedEndpointFromOptions<TOptions, TResponse>;
-declare function POST<TBody extends AnySchema = never, TQuery extends AnySchema = never, THeaders extends AnySchema = never, TResponse = any>(options: Omit<EndpointOptions<TBody, TQuery, THeaders, readonly []>, "method">, handler: EndpointHandler<TBody, TQuery, THeaders, TResponse>): CreatedEndpoint<TBody, TQuery, THeaders, TResponse>;
-/**
- * Convenience method for PUT requests
- */
-declare function PUT<T = any>(handler: EndpointHandler<never, never, never, T>): CreatedEndpoint<never, never, never, T>;
-declare function PUT<const TOptions extends MethodlessEndpointOptions, TResponse = any>(options: TOptions, handler: ValidatedEndpointHandlerFromOptions<TOptions, TResponse>): CreatedEndpointFromOptions<TOptions, TResponse>;
-declare function PUT<TBody extends AnySchema = never, TQuery extends AnySchema = never, THeaders extends AnySchema = never, TResponse = any>(options: Omit<EndpointOptions<TBody, TQuery, THeaders, readonly []>, "method">, handler: EndpointHandler<TBody, TQuery, THeaders, TResponse>): CreatedEndpoint<TBody, TQuery, THeaders, TResponse>;
-/**
- * Convenience method for DELETE requests
- */
-declare function DELETE<T = any>(handler: EndpointHandler<never, never, never, T>): CreatedEndpoint<never, never, never, T>;
-declare function DELETE<const TOptions extends MethodlessEndpointOptions, TResponse = any>(options: TOptions, handler: ValidatedEndpointHandlerFromOptions<TOptions, TResponse>): CreatedEndpointFromOptions<TOptions, TResponse>;
-declare function DELETE<TBody extends AnySchema = never, TQuery extends AnySchema = never, THeaders extends AnySchema = never, TResponse = any>(options: Omit<EndpointOptions<TBody, TQuery, THeaders, readonly []>, "method">, handler: EndpointHandler<TBody, TQuery, THeaders, TResponse>): CreatedEndpoint<TBody, TQuery, THeaders, TResponse>;
-/**
- * Convenience method for PATCH requests
- */
-declare function PATCH<T = any>(handler: EndpointHandler<never, never, never, T>): CreatedEndpoint<never, never, never, T>;
-declare function PATCH<const TOptions extends MethodlessEndpointOptions, TResponse = any>(options: TOptions, handler: ValidatedEndpointHandlerFromOptions<TOptions, TResponse>): CreatedEndpointFromOptions<TOptions, TResponse>;
-declare function PATCH<TBody extends AnySchema = never, TQuery extends AnySchema = never, THeaders extends AnySchema = never, TResponse = any>(options: Omit<EndpointOptions<TBody, TQuery, THeaders, readonly []>, "method">, handler: EndpointHandler<TBody, TQuery, THeaders, TResponse>): CreatedEndpoint<TBody, TQuery, THeaders, TResponse>;
-/**
- * Convenience method for OPTIONS requests
- */
-declare function OPTIONS<T = any>(handler: EndpointHandler<never, never, never, T>): CreatedEndpoint<never, never, never, T>;
-declare function OPTIONS<const TOptions extends MethodlessEndpointOptions, TResponse = any>(options: TOptions, handler: ValidatedEndpointHandlerFromOptions<TOptions, TResponse>): CreatedEndpointFromOptions<TOptions, TResponse>;
-declare function OPTIONS<TBody extends AnySchema = never, TQuery extends AnySchema = never, THeaders extends AnySchema = never, TResponse = any>(options: Omit<EndpointOptions<TBody, TQuery, THeaders, readonly []>, "method">, handler: EndpointHandler<TBody, TQuery, THeaders, TResponse>): CreatedEndpoint<TBody, TQuery, THeaders, TResponse>;
 
 /**
  * Farm.js API Routes Vite Plugin
@@ -187,4 +45,4 @@ interface ApiRoute {
  */
 declare function farmApiPlugin(options?: FarmApiPluginOptions): Plugin;
 
-export { type AnyEndpointMiddleware, type ApiRoute, DELETE, type EndpointHandler, type EndpointMiddleware, type EndpointMiddlewareContext, type EndpointMiddlewareResult, type EndpointOptions, type EndpointParamValue, type EndpointParams, type FarmApiPluginOptions, GET, HEAD, type InferEndpointMiddlewareContext, OPTIONS, PATCH, POST, PUT, type TypedEndpoint, createEndpoint, farmApiPlugin };
+export { type ApiRoute, type FarmApiPluginOptions, farmApiPlugin };

package/dist/api.mjs

@@ -1,50 +1,70 @@
 import {
-  DELETE,
-  GET,
-  HEAD,
-  OPTIONS,
-  PATCH,
-  POST,
-  PUT,
-  createEndpoint,
   farmApiPlugin
-} from "./chunk-PRNYWD7K.mjs";
+} from "./chunk-JDEOUK5V.mjs";
 import {
+  APIClientError,
+  FARM_API_ROUTE_META_SYMBOL,
+  FARM_API_ROUTE_REF_SYMBOL,
   createAPIClient,
-  createServerAPIClient
-} from "./chunk-QFQRHRZS.mjs";
-import "./chunk-6XDUHOEM.mjs";
+  createServerAPIClient,
+  getAPIRouteRefMetadata,
+  isAPIRouteRef
+} from "./chunk-W2CRQFF6.mjs";
+import "./chunk-TQAEEJB4.mjs";
 import "./chunk-E6EPN5BT.mjs";
 import "./chunk-QGOHVJ6J.mjs";
 import {
   APIRouteManager,
   API_ROUTE_METHODS
-} from "./chunk-YHU7SS6L.mjs";
-import "./chunk-QF4PHCMA.mjs";
+} from "./chunk-Z5CQMP54.mjs";
+import "./chunk-2ED5Q2GH.mjs";
 import "./chunk-GN72QAIH.mjs";
 import "./chunk-FQYDHKKU.mjs";
+import "./chunk-C2ROET2V.mjs";
+import "./chunk-QKVUNGAH.mjs";
+import "./chunk-GQVGIUSN.mjs";
 import "./chunk-J4FNJ5IU.mjs";
 import {
+  DELETE,
+  EndpointFailure,
+  GET,
+  HEAD,
+  OPTIONS,
+  PATCH,
+  POST,
+  PUT,
+  createEndpoint,
   invokeAPIRouteEndpoint,
+  isEndpointFailure,
   isWebResponse,
   matchAPIRoute,
   normalizeRouteResponse
-} from "./chunk-EVGBEZDF.mjs";
+} from "./chunk-PFE6GMNE.mjs";
 import "./chunk-RHIFZZUI.mjs";
 import "./chunk-LM2YNO4U.mjs";
-import "./chunk-B6N4ZB2H.mjs";
-import "./chunk-QKVUNGAH.mjs";
-import "./chunk-QM6VV26B.mjs";
 import "./chunk-44ZCFSKE.mjs";
-import "./chunk-4PTK6KT4.mjs";
-import "./chunk-TXCFGOHW.mjs";
+import {
+  isFarmAPIStream,
+  isJSONStreamResponse,
+  isMultipartSchema,
+  jsonStream,
+  multipart,
+  readJSONStream,
+  toFormData
+} from "./chunk-ALCLXXTY.mjs";
+import "./chunk-V3XURYJO.mjs";
 import "./chunk-WZ5QFROO.mjs";
+import "./chunk-RBRLLZL5.mjs";
 import "./chunk-7ZY5AIJO.mjs";
 import "./chunk-CGILA3WO.mjs";
 export {
+  APIClientError,
   APIRouteManager,
   API_ROUTE_METHODS,
   DELETE,
+  EndpointFailure,
+  FARM_API_ROUTE_META_SYMBOL,
+  FARM_API_ROUTE_REF_SYMBOL,
   GET,
   HEAD,
   OPTIONS,
@@ -55,9 +75,19 @@ export {
   createEndpoint,
   createServerAPIClient,
   farmApiPlugin,
+  getAPIRouteRefMetadata,
   invokeAPIRouteEndpoint,
+  isAPIRouteRef,
+  isEndpointFailure,
+  isFarmAPIStream,
+  isJSONStreamResponse,
+  isMultipartSchema,
   isWebResponse,
+  jsonStream,
   matchAPIRoute,
-  normalizeRouteResponse
+  multipart,
+  normalizeRouteResponse,
+  readJSONStream,
+  toFormData
 };
 //# sourceMappingURL=api.mjs.map

package/dist/{app-CFRNJXP1.d.ts → app-BjN-da13.d.ts}

@@ -1,4 +1,4 @@
-import { F as FarmConfig, x as ParsedRoute, p as RouteModule, r as LayoutModule, z as SSGCollectionResult, t as FarmRequest, u as FarmResponse, _ as FarmMdxResolvedConfig, $ as ResolvedFarmDevtoolsConfig } from './client-plugins-BZnpeTGA.js';
+import { F as FarmConfig, x as ParsedRoute, p as RouteModule, r as LayoutModule, z as SSGCollectionResult, t as FarmRequest, u as FarmResponse, _ as FarmMdxResolvedConfig, $ as ResolvedFarmDevtoolsConfig } from './client-plugins-Cw4qUGsw.js';
 import { F as FarmDocsResolvedConfig } from './types-C9N-nk5R.js';
 import { FarmMarkdownResolvedConfig } from './markdown.js';
 import { FarmWorkflowsResolvedConfig } from './workflows.js';
@@ -6,7 +6,7 @@ import { FarmCronResolvedConfig } from './cron.js';
 import { R as ResolvedFarmImageConfig } from './image-config-Duob7wER.js';
 import { ProgrammaticRedirectRoute, ProgrammaticRouteSearchClientOptions } from './routes.js';
 import { ViteDevServer } from 'vite';
-import { M as MetadataImageKind } from './metadata-DAXRaOHx.js';
+import { M as MetadataImageKind } from './metadata-BAPg_Nmo.js';
 import { R as ResolvedFarmRouteRuntimeConfig } from './route-runtime-DoOHzCAD.js';
 import { R as ResolvedFarmI18nConfig } from './types-BH1lhg5G.js';
 import { F as FarmI18nRuntime } from './runtime-B6GvwDS1.js';
@@ -30,6 +30,22 @@ interface RouteEntry {
     source?: "file" | "programmatic";
     sourceRoot: string;
 }
+interface RouteSlotEntry extends RouteEntry {
+    name: string;
+    ownerPattern: string;
+    interception: boolean;
+    fallback: boolean;
+    containerId: string;
+}
+interface MatchedRouteSlot {
+    name: string;
+    ownerPattern: string;
+    containerId: string;
+    interception: boolean;
+    fallback: boolean;
+    route: RouteSlotEntry;
+    params: Record<string, string>;
+}
 interface MetadataImageEntry extends RouteEntry {
     kind: MetadataImageKind;
     fileName: "opengraph-image" | "twitter-image";
@@ -43,6 +59,7 @@ declare class RouteManager {
     private config;
     private routes;
     private layouts;
+    private routeSlots;
     private loadings;
     private errors;
     private metadataImages;
@@ -58,10 +75,13 @@ declare class RouteManager {
     /**
      * Find matching route for a given URL path
      */
-    matchRoute(pathname: string): {
+    matchRoute(pathname: string, options?: {
+        interceptFrom?: string;
+    }): {
         route: RouteEntry | null;
         params: Record<string, string>;
         layouts: RouteEntry[];
+        slots: MatchedRouteSlot[];
     };
     /**
      * Get all registered routes
@@ -71,6 +91,7 @@ declare class RouteManager {
      * Get all registered layouts
      */
     getLayouts(): Map<string, RouteEntry>;
+    getRouteSlots(): Map<string, RouteSlotEntry>;
     /** Resolve route rules, inherited layouts, and the page export in precedence order. */
     resolveRouteRuntimeConfig(pattern: string): Promise<ResolvedFarmRouteRuntimeConfig>;
     /**
@@ -129,6 +150,18 @@ declare class RouteManager {
             pattern: string;
             modulePath: string;
         }>;
+        slots: Array<{
+            name: string;
+            ownerPattern: string;
+            pattern: string;
+            modulePath: string;
+            containerId: string;
+            interception: boolean;
+            fallback: boolean;
+            shouldHydrate: boolean;
+            isClientComponent: boolean;
+            segments: RouteEntry["route"]["segments"];
+        }>;
     };
     /**
      * Load a route module dynamically
@@ -149,6 +182,8 @@ declare class RouteManager {
      * Find all layouts that should wrap a given path
      */
     private findMatchingLayouts;
+    private findMatchingRouteSlots;
+    private matchesRoutePrefix;
     private findNearestBoundary;
     /**
      * Log discovered routes for debugging

package/dist/{app-BiX4qb-d.d.mts → app-CakAr8Be.d.mts}

@@ -1,4 +1,4 @@
-import { F as FarmConfig, x as ParsedRoute, p as RouteModule, r as LayoutModule, z as SSGCollectionResult, t as FarmRequest, u as FarmResponse, _ as FarmMdxResolvedConfig, $ as ResolvedFarmDevtoolsConfig } from './client-plugins-g4bzuCmo.mjs';
+import { F as FarmConfig, x as ParsedRoute, p as RouteModule, r as LayoutModule, z as SSGCollectionResult, t as FarmRequest, u as FarmResponse, _ as FarmMdxResolvedConfig, $ as ResolvedFarmDevtoolsConfig } from './client-plugins-DQQ1adXM.mjs';
 import { F as FarmDocsResolvedConfig } from './types-C9N-nk5R.mjs';
 import { FarmMarkdownResolvedConfig } from './markdown.mjs';
 import { FarmWorkflowsResolvedConfig } from './workflows.mjs';
@@ -6,7 +6,7 @@ import { FarmCronResolvedConfig } from './cron.mjs';
 import { R as ResolvedFarmImageConfig } from './image-config-Duob7wER.mjs';
 import { ProgrammaticRedirectRoute, ProgrammaticRouteSearchClientOptions } from './routes.mjs';
 import { ViteDevServer } from 'vite';
-import { M as MetadataImageKind } from './metadata-C9NZxMDW.mjs';
+import { M as MetadataImageKind } from './metadata-_6i9oFG3.mjs';
 import { R as ResolvedFarmRouteRuntimeConfig } from './route-runtime-DoOHzCAD.mjs';
 import { R as ResolvedFarmI18nConfig } from './types-BH1lhg5G.mjs';
 import { F as FarmI18nRuntime } from './runtime-DeAAZ6gO.mjs';
@@ -30,6 +30,22 @@ interface RouteEntry {
     source?: "file" | "programmatic";
     sourceRoot: string;
 }
+interface RouteSlotEntry extends RouteEntry {
+    name: string;
+    ownerPattern: string;
+    interception: boolean;
+    fallback: boolean;
+    containerId: string;
+}
+interface MatchedRouteSlot {
+    name: string;
+    ownerPattern: string;
+    containerId: string;
+    interception: boolean;
+    fallback: boolean;
+    route: RouteSlotEntry;
+    params: Record<string, string>;
+}
 interface MetadataImageEntry extends RouteEntry {
     kind: MetadataImageKind;
     fileName: "opengraph-image" | "twitter-image";
@@ -43,6 +59,7 @@ declare class RouteManager {
     private config;
     private routes;
     private layouts;
+    private routeSlots;
     private loadings;
     private errors;
     private metadataImages;
@@ -58,10 +75,13 @@ declare class RouteManager {
     /**
      * Find matching route for a given URL path
      */
-    matchRoute(pathname: string): {
+    matchRoute(pathname: string, options?: {
+        interceptFrom?: string;
+    }): {
         route: RouteEntry | null;
         params: Record<string, string>;
         layouts: RouteEntry[];
+        slots: MatchedRouteSlot[];
     };
     /**
      * Get all registered routes
@@ -71,6 +91,7 @@ declare class RouteManager {
      * Get all registered layouts
      */
     getLayouts(): Map<string, RouteEntry>;
+    getRouteSlots(): Map<string, RouteSlotEntry>;
     /** Resolve route rules, inherited layouts, and the page export in precedence order. */
     resolveRouteRuntimeConfig(pattern: string): Promise<ResolvedFarmRouteRuntimeConfig>;
     /**
@@ -129,6 +150,18 @@ declare class RouteManager {
             pattern: string;
             modulePath: string;
         }>;
+        slots: Array<{
+            name: string;
+            ownerPattern: string;
+            pattern: string;
+            modulePath: string;
+            containerId: string;
+            interception: boolean;
+            fallback: boolean;
+            shouldHydrate: boolean;
+            isClientComponent: boolean;
+            segments: RouteEntry["route"]["segments"];
+        }>;
     };
     /**
      * Load a route module dynamically
@@ -149,6 +182,8 @@ declare class RouteManager {
      * Find all layouts that should wrap a given path
      */
     private findMatchingLayouts;
+    private findMatchingRouteSlots;
+    private matchesRoutePrefix;
     private findNearestBoundary;
     /**
      * Log discovered routes for debugging