import { type InternalAction, type MiddlewareFn } from '../types.js';
export type CompiledChain<TContext> = Map<string, (ctx: TContext, args: Record<string, unknown>) => Promise<unknown>>;
/** Generic handler function signature used in middleware chains. */
type ChainFn<TContext> = (ctx: TContext, args: Record<string, unknown>) => Promise<unknown>;
/**
 * Wrap a handler with a middleware stack (right-to-left composition).
 *
 * This is the single canonical implementation of the middleware
 * wrapping pattern. No other file should duplicate this loop.
 *
 * @param handler - The innermost function to wrap
 * @param middlewares - Middleware stack (outermost first, applied right-to-left)
 * @returns The compiled chain function
 */
export declare function wrapChain<TContext>(handler: ChainFn<TContext>, middlewares: readonly MiddlewareFn<TContext>[]): ChainFn<TContext>;
/**
 * Pre-compile middleware chains for all actions in a builder.
 *
 * For each action:
 * 1. Wraps generator handlers in a GeneratorResultEnvelope
 * 2. Applies per-action middlewares (innermost)
 * 3. Applies global middlewares (outermost)
 *
 * @param actions - Registered actions with their handlers and local middleware
 * @param middlewares - Global middleware stack
 * @returns Map from action key to compiled chain
 */
export declare function compileMiddlewareChains<TContext>(actions: readonly InternalAction<TContext>[], middlewares: readonly MiddlewareFn<TContext>[]): CompiledChain<TContext>;
export {};
//# sourceMappingURL=MiddlewareCompiler.d.ts.map