import { RouteMetadata } from "./decorators";
/**
 * LogApiCall - Generic API call logging utility.
 *
 * Used by both server-side (LogApiFilter) and client-side (ClientFactory) for
 * consistent logging patterns across the framework.
 *
 * Logging format patterns:
 * - [API-{type}-req] ClassName.methodName request={...} headers={...}
 * - [API-{type}-resp-SUCCESS] ClassName.methodName response={...}
 * - [API-{type}-resp-OTHER] ClassName.methodName errorType={...}  (user errors)
 * - [API-{type}-resp-FAIL] ClassName.methodName error={...}  (server errors)
 */
export declare class LogApiCall {
    /**
     * Execute an API call with logging around it.
     *
     * @param type - 'SVR' or 'CLIENT'
     * @param meta - Route metadata with controllerClassName and methodName
     * @param requestDto - The request DTO
     * @param headers - Map of header name -> values
     * @param splitHeaders - SplitHeaders with secureHeaders and publicHeaders for masking
     * @param method - The method to execute
     */
    execute(type: string, meta: RouteMetadata, requestDto: any, headers: Map<string, any>, method: (dto: any) => Promise<any>): Promise<any>;
    /**
     * Check if an error is a user error (expected behavior from server perspective).
     * User errors are NOT failures - just users making mistakes or validation issues.
     *
     * User errors (logged as OTHER, no stack trace):
     * - HttpBadRequestError (400)
     * - HttpUnauthorizedError (401)
     * - HttpForbiddenError (403)
     * - HttpNotFoundError (404)
     * - HttpUserError (266)
     *
     * @param error - The error to check
     * @returns true if this is a user error, false for server errors
     */
    static isUserError(error: unknown): boolean;
}