export declare const BACKEND_ERROR_EVENT: "burdenoff:backend-error";
export declare const CONNECTION_STATUS_EVENT: "burdenoff:connection-status";
export interface ConnectionStatusDetail {
    /** true = connectivity restored, false = server unreachable / degraded */
    online: boolean;
    /** epoch ms when this status was observed */
    since: number;
}
export interface BackendErrorExtensions {
    code?: string;
    errorCode?: string;
    userMessage?: string;
    humanMessage?: string;
    displayMessage?: string;
    technicalMessage?: string;
    serviceName?: string;
    requestId?: string;
    correlationId?: string;
    traceId?: string;
    [key: string]: unknown;
}
export interface GraphQLBackendErrorLike {
    message?: string | null;
    path?: ReadonlyArray<string | number> | null;
    extensions?: BackendErrorExtensions | null;
}
export interface BackendErrorDisplay {
    message: string;
    subtitle?: string;
    technicalMessage?: string;
    code?: string;
    operationName?: string;
    serviceName?: string;
    path?: string;
    requestId?: string;
    extensions?: BackendErrorExtensions;
}
export interface ExtractBackendErrorOptions {
    operationName?: string;
    fallbackMessage?: string;
}
/** AbortError in either form — a user/navigation cancellation, never surfaced. */
export declare function isAbortError(input: unknown): boolean;
/**
 * True when an error is a pure transport/connectivity failure with no
 * actionable application code — it should be logged + surfaced via the
 * connection indicator, never as a toast. Returns false for AbortError (handled
 * separately/silently), for anything carrying an application GraphQL code, and
 * for auth/authorization HTTP statuses so those paths are preserved.
 */
export declare function isTransportError(input: unknown): boolean;
/**
 * Signal that connectivity is healthy again. Called from the GraphQL success
 * paths; clears the connection indicator exactly once on recovery. No-op when
 * the connection was never marked degraded.
 */
export declare function markConnectionHealthy(): void;
export declare function extractBackendError(input: unknown, options?: ExtractBackendErrorOptions): BackendErrorDisplay | null;
export declare function isBackendErrorDisplay(value: unknown): value is BackendErrorDisplay;
export declare function shouldToastBackendError(error: BackendErrorDisplay | null): error is BackendErrorDisplay;
export declare function dispatchBackendErrorEvent(input: unknown, options?: ExtractBackendErrorOptions): void;
//# sourceMappingURL=backendErrors.d.ts.map