import type { BaseSchema, Infer } from "anyvali";
import type { RawRouteHandler, RouteHandlerContext, RouteHandler } from "../contracts/route.js";
/**
 * Schema configuration for a route handler.
 * `response` is required; `params`, `query`, `headers`, and `request` are optional.
 */
export interface HandlerSchemas<TResponse extends BaseSchema<unknown, unknown>, TQuery extends BaseSchema<unknown, unknown> | undefined = undefined, THeaders extends BaseSchema<unknown, unknown> | undefined = undefined, TRequest extends BaseSchema<unknown, unknown> | undefined = undefined, TParamsSchema extends BaseSchema<unknown, unknown> | undefined = undefined> {
    readonly response: TResponse;
    readonly params?: TParamsSchema;
    readonly query?: TQuery;
    readonly headers?: THeaders;
    readonly request?: TRequest;
}
/** Resolve a schema to its inferred output type, or fall back to a default. */
type SchemaOutput<T extends BaseSchema<unknown, unknown> | undefined, TDefault> = T extends BaseSchema<unknown, unknown> ? Infer<T> : TDefault;
/** Fully-typed handler context derived from schema configuration. */
type TypedHandlerContext<TSchemas extends HandlerSchemas<BaseSchema<unknown, unknown>, any, any, any, any>, TParams = Record<string, string>, TPlugin = unknown, TServiceConfig = Record<string, unknown>> = RouteHandlerContext<SchemaOutput<TSchemas["params"], TParams>, SchemaOutput<TSchemas["query"], Record<string, unknown>>, SchemaOutput<TSchemas["headers"], Record<string, string>>, SchemaOutput<TSchemas["request"], Record<string, unknown>>, TPlugin, TServiceConfig>;
/**
 * Create a type-safe route handler with framework-enforced validation.
 *
 * - TypeScript enforces the return type matches `Infer<ResponseSchema>` at compile time.
 * - At runtime, the response is validated through `schemas.response.parse()` as a safety net.
 * - The handler's `ctx` is fully typed from the provided schemas - no manual `.parse()` needed.
 *
 * @example
 * ```ts
 * export const handleGet = createHandler(
 *   { response: ResponseSchema, query: QuerySchema },
 *   (ctx) => ({
 *     greeting: `Hello, ${ctx.query.name}`,
 *     themeHint: "bootstrap1",
 *     supports: ["application/json", "text/html"]
 *   })
 * );
 * ```
 */
export declare function createHandler<TResponse extends BaseSchema<unknown, unknown>, TQuery extends BaseSchema<unknown, unknown> | undefined = undefined, THeaders extends BaseSchema<unknown, unknown> | undefined = undefined, TRequest extends BaseSchema<unknown, unknown> | undefined = undefined, TParams = Record<string, string>, TPlugin = unknown, TServiceConfig = Record<string, unknown>, TParamsSchema extends BaseSchema<unknown, unknown> | undefined = undefined>(schemas: HandlerSchemas<TResponse, TQuery, THeaders, TRequest, TParamsSchema>, handler: (ctx: TypedHandlerContext<HandlerSchemas<TResponse, TQuery, THeaders, TRequest, TParamsSchema>, TParams, TPlugin, TServiceConfig>) => Infer<TResponse> | Promise<Infer<TResponse>>): RouteHandler<SchemaOutput<TParamsSchema, TParams>, SchemaOutput<TQuery, Record<string, unknown>>, SchemaOutput<THeaders, Record<string, string>>, SchemaOutput<TRequest, Record<string, unknown>>, Infer<TResponse>, TPlugin, TServiceConfig>;
export declare namespace createHandler {
    function forContext<TPlugin = unknown, TServiceConfig = Record<string, unknown>>(): <TResponse extends BaseSchema<unknown, unknown>, TQuery extends BaseSchema<unknown, unknown> | undefined = undefined, THeaders extends BaseSchema<unknown, unknown> | undefined = undefined, TRequest extends BaseSchema<unknown, unknown> | undefined = undefined, TParams = Record<string, string>, TParamsSchema extends BaseSchema<unknown, unknown> | undefined = undefined>(schemas: HandlerSchemas<TResponse, TQuery, THeaders, TRequest, TParamsSchema>, handler: (ctx: TypedHandlerContext<HandlerSchemas<TResponse, TQuery, THeaders, TRequest, TParamsSchema>, TParams, TPlugin, TServiceConfig>) => Infer<TResponse> | Promise<Infer<TResponse>>) => RouteHandler<SchemaOutput<TParamsSchema, TParams>, SchemaOutput<TQuery, Record<string, unknown>>, SchemaOutput<THeaders, Record<string, string>>, SchemaOutput<TRequest, Record<string, unknown>>, Infer<TResponse>, TPlugin, TServiceConfig>;
}
export type RawHandlerSchemas<TQuery extends BaseSchema<unknown, unknown> | undefined = undefined, THeaders extends BaseSchema<unknown, unknown> | undefined = undefined, TRequest extends BaseSchema<unknown, unknown> | undefined = undefined, TMultipart extends BaseSchema<unknown, unknown> | undefined = undefined, TParamsSchema extends BaseSchema<unknown, unknown> | undefined = undefined> = {
    readonly params?: TParamsSchema;
    readonly query?: TQuery;
    readonly headers?: THeaders;
    readonly request?: TRequest;
    readonly multipart?: TMultipart;
};
export declare function createRawHandler<TQuery extends BaseSchema<unknown, unknown> | undefined = undefined, THeaders extends BaseSchema<unknown, unknown> | undefined = undefined, TRequest extends BaseSchema<unknown, unknown> | undefined = undefined, TMultipart extends BaseSchema<unknown, unknown> | undefined = undefined, TParams = Record<string, string>, TPlugin = unknown, TServiceConfig = Record<string, unknown>, TParamsSchema extends BaseSchema<unknown, unknown> | undefined = undefined>(_schemas: RawHandlerSchemas<TQuery, THeaders, TRequest, TMultipart, TParamsSchema>, handler: (ctx: RouteHandlerContext<SchemaOutput<TParamsSchema, TParams>, SchemaOutput<TQuery, Record<string, unknown>>, SchemaOutput<THeaders, Record<string, string>>, SchemaOutput<TRequest, Record<string, unknown>>, TPlugin, TServiceConfig> & {
    readonly multipart: SchemaOutput<TMultipart, never>;
}) => Response | Promise<Response>): RawRouteHandler<SchemaOutput<TParamsSchema, TParams>, SchemaOutput<TQuery, Record<string, unknown>>, SchemaOutput<THeaders, Record<string, string>>, SchemaOutput<TRequest, Record<string, unknown>>, TPlugin, TServiceConfig>;
export declare namespace createRawHandler {
    function forContext<TPlugin = unknown, TServiceConfig = Record<string, unknown>>(): <TQuery extends BaseSchema<unknown, unknown> | undefined = undefined, THeaders extends BaseSchema<unknown, unknown> | undefined = undefined, TRequest extends BaseSchema<unknown, unknown> | undefined = undefined, TMultipart extends BaseSchema<unknown, unknown> | undefined = undefined, TParams = Record<string, string>, TParamsSchema extends BaseSchema<unknown, unknown> | undefined = undefined>(schemas: RawHandlerSchemas<TQuery, THeaders, TRequest, TMultipart, TParamsSchema>, handler: (ctx: RouteHandlerContext<SchemaOutput<TParamsSchema, TParams>, SchemaOutput<TQuery, Record<string, unknown>>, SchemaOutput<THeaders, Record<string, string>>, SchemaOutput<TRequest, Record<string, unknown>>, TPlugin, TServiceConfig> & {
        readonly multipart: SchemaOutput<TMultipart, never>;
    }) => Response | Promise<Response>) => RawRouteHandler<SchemaOutput<TParamsSchema, TParams>, SchemaOutput<TQuery, Record<string, unknown>>, SchemaOutput<THeaders, Record<string, string>>, SchemaOutput<TRequest, Record<string, unknown>>, TPlugin, TServiceConfig>;
}
export {};
//# sourceMappingURL=handler.d.ts.map