import type { Handler, HandlerContext, HandlerMetadata, HandlerResult, RoutePattern } from "../../types/index.js";
import type { VerifiedControlPlaneRequestClaims } from "../../internal-agents/control-plane-auth.js";
import type { WebSocketUpgradeResponse } from "../../platform/adapters/base.js";
import { ResponseBuilder } from "./response/index.js";
export interface HandlerHelpers {
    createResponseBuilder: (ctx: HandlerContext, nonce?: string) => ResponseBuilder;
    respond: (response: Response | WebSocketUpgradeResponse, metadata?: Record<string, unknown>) => HandlerResult;
    logDebug: (message: string, extra?: Record<string, unknown>, ctx?: HandlerContext) => void;
    getErrorMessage: (error: unknown) => string;
    continue: () => HandlerResult;
}
/** Match a request pathname against one runtime route pattern. */
export declare function matchesRoutePathname(pathname: string, routePattern: RoutePattern): boolean;
export declare abstract class BaseHandler implements Handler {
    abstract metadata: HandlerMetadata;
    protected readonly helpers: HandlerHelpers;
    abstract handle(req: Request, ctx: HandlerContext): Promise<HandlerResult>;
    protected shouldHandle(req: Request, ctx: HandlerContext): boolean;
    private matchesPattern;
    protected createResponseBuilder(ctx: HandlerContext, nonce?: string): ResponseBuilder;
    protected logDebug(message: string, extra?: Record<string, unknown>, ctx?: HandlerContext): void;
    protected logWarn(message: string, extra?: Record<string, unknown>): void;
    protected logInfo(message: string, extra?: Record<string, unknown>): void;
    protected getErrorMessage(error: unknown): string;
    protected continue(): HandlerResult;
    protected respond(response: Response | WebSocketUpgradeResponse, metadata?: Record<string, unknown>): HandlerResult;
    protected withProxyContext<T>(ctx: HandlerContext, fn: () => Promise<T>, options?: {
        requireToken?: boolean;
        verifiedControlPlaneClaims?: VerifiedControlPlaneRequestClaims;
    }): Promise<T>;
}
//# sourceMappingURL=base-handler.d.ts.map