export type SpectreErrorCode = "API_KEY_MISSING" | "NETWORK_ERROR" | "UNAUTHORIZED" | "FORBIDDEN" | "NOT_FOUND" | "VALIDATION_ERROR" | "RATE_LIMITED" | "LIVENESS_CHECK_FAILED" | "FACE_MATCH_FAILED" | "FACE_ALREADY_REGISTERED" | "FACE_PROFILE_NOT_FOUND" | "SERVER_ERROR" | "UNKNOWN";
export interface SpectreErrorEnvelope {
    code: SpectreErrorCode | string;
    message: string;
    details?: unknown;
    request_id?: string | null;
    timestamp?: string | null;
}
export declare class SpectreError extends Error {
    readonly code: SpectreErrorCode | string;
    readonly status: number;
    readonly details?: unknown;
    readonly requestId?: string | null;
    readonly timestamp?: string | null;
    constructor(status: number, envelope: SpectreErrorEnvelope);
}
export declare function codeFromStatus(status: number): SpectreErrorCode;
export declare function normalizeErrorEnvelope(status: number, body: unknown, fallbackMessage: string): SpectreErrorEnvelope;
//# sourceMappingURL=sdk-errors.d.ts.map