import type { MiddlewareContext, MiddlewareHandler } from "./types.js";
/**
 * Middleware pipeline for request processing
 * Composes multiple middleware handlers into a single execution flow
 */
export declare class MiddlewarePipeline {
    private handlers;
    /**
     * Add a middleware handler to the pipeline
     */
    use(handler: MiddlewareHandler): this;
    /**
     * Execute the middleware pipeline
     * @param ctx - Request context
     * @returns Promise that resolves when pipeline completes
     */
    execute(ctx: MiddlewareContext): Promise<void>;
    /**
     * Compose multiple middleware handlers into a single handler
     * This is useful for creating reusable middleware groups
     */
    static compose(handlers: MiddlewareHandler[]): MiddlewareHandler;
    /**
     * Get the number of middleware handlers in the pipeline
     */
    get length(): number;
    /**
     * Clear all middleware handlers from the pipeline
     */
    clear(): void;
}