/** * WebSocket-specific error handling utilities. * * Maps WebSocket close codes to TransportErrorKind for consistent * error classification across browser and Node.js environments. */ import { type CloseInfo, TransportError, type TransportErrorKind } from "@sideband/transport"; /** * Maps WebSocket close codes to TransportErrorKind. * * Returns null for clean closes (code 1000). * * Note: Code 1006 always returns "abnormal_close". The spec allows * "connection_refused" when no frames were exchanged, but that heuristic * requires connection context not available here. Use normalizeError() * for context-aware error classification. */ export declare function errorKindFromWsCloseCode(code: number): TransportErrorKind | null; /** * Normalize a platform error to TransportError. * * Handles browser WebSocket errors (opaque), Node.js system errors, * and AbortSignal cancellations. * * @param error - The platform-specific error (Error, Event, etc.) * @param closeInfo - Optional WebSocket close info for context * @returns A normalized TransportError */ export declare function normalizeError(error: unknown, closeInfo?: Partial): TransportError; /** * I/O diagnostics for close kind derivation. */ export interface CloseDiagnostics { ioBytes: { sent: number; received: number; }; } /** * Derive error kind from close code and connection diagnostics. * Deterministically handles ambiguous codes like 1006 based on traffic history. * * - 1006 + no frames exchanged → "connection_refused" * - 1006 + had frames → "abnormal_close" * - Other codes → delegates to errorKindFromWsCloseCode() * * @param closeCode - WebSocket close code * @param diagnostics - Connection traffic diagnostics * @returns The inferred TransportErrorKind */ export declare function deriveCloseKind(closeCode: number, diagnostics: CloseDiagnostics): TransportErrorKind; //# sourceMappingURL=ws-errors.d.ts.map