import type { Context } from "hono";
import { type ZodType } from "zod";
export declare class ApiHttpError extends Error {
    readonly status: number;
    readonly code?: string;
    readonly details?: Record<string, unknown>;
    constructor(message: string, options: {
        status: number;
        code?: string;
        details?: Record<string, unknown>;
    });
}
/**
 * Identifies an {@link ApiHttpError} across module copies. Prefer this over
 * `error instanceof ApiHttpError` anywhere the error may have been thrown by a
 * different bundle of `@voyant-travel/hono` — notably any framework-wide error
 * boundary. Subclasses inherit the brand through `super()`.
 */
export declare function isApiHttpError(error: unknown): error is ApiHttpError;
export declare class RequestValidationError extends ApiHttpError {
    constructor(message: string, details?: Record<string, unknown>);
}
export declare class UnauthorizedApiError extends ApiHttpError {
    constructor(message?: string);
}
export declare class ForbiddenApiError extends ApiHttpError {
    constructor(message?: string);
}
export declare function parseJsonBody<T>(c: Context, schema: ZodType<T>, options?: {
    invalidJsonMessage?: string;
    invalidBodyMessage?: string;
    maxBytes?: number;
}): Promise<T>;
export declare function parseOptionalJsonBody<T>(c: Context, schema: ZodType<T>, options?: {
    defaultValue?: unknown;
    invalidBodyMessage?: string;
    maxBytes?: number;
}): Promise<T>;
export declare function parseQuery<T>(c: Context, schema: ZodType<T>, options?: {
    invalidQueryMessage?: string;
}): T;
export declare function normalizeValidationError(error: unknown): ApiHttpError | undefined;