@dotdo/postgres 0.1.0

package/dist/cdc/transport/websocket.d.ts

@@ -0,0 +1,130 @@
+/**
+ * WebSocket CDC Transport
+ * Task: postgres-lp00 - CDC/Change Data Capture streaming
+ *
+ * Full implementation of WebSocket transport with:
+ * - Connection management and automatic reconnection
+ * - Message acknowledgments
+ * - Resume from token support
+ * - Ping/pong heartbeat mechanism
+ * - Message queuing during reconnection
+ */
+import type { CDCTransport, CDCTransportOptions, WebSocketTransportOptions, ChangeEvent, SubscriptionConfig, ResumeToken } from '../types';
+type ConnectionState = 'disconnected' | 'connecting' | 'connected' | 'reconnecting' | 'closing';
+export declare class WebSocketCDCTransport implements CDCTransport {
+    readonly options: WebSocketTransportOptions;
+    private ws;
+    private state;
+    private connectionId;
+    private changeHandlers;
+    private errorHandlers;
+    private closeHandlers;
+    private reconnectHandlers;
+    private lastResumeToken;
+    private connectPromise;
+    private connectResolve;
+    private connectReject;
+    private connectTimeout;
+    private pingInterval;
+    private pongTimeout;
+    private waitingForPong;
+    private reconnectAttempt;
+    private reconnectTimeout;
+    private intentionalClose;
+    private messageQueue;
+    private stats;
+    constructor(options: WebSocketTransportOptions);
+    /**
+     * Connect to the WebSocket CDC endpoint
+     * @param options - Optional connection options including resume token
+     * @throws Error if connection times out or fails
+     */
+    connect(options?: CDCTransportOptions): Promise<void>;
+    /**
+     * Disconnect from the WebSocket CDC endpoint
+     * Clears all timers and rejects any pending operations
+     */
+    disconnect(): Promise<void>;
+    /**
+     * Subscribe to CDC events for specified tables
+     * @param config - Subscription configuration including tables, filters, and resume token
+     */
+    subscribe(config: SubscriptionConfig): Promise<void>;
+    /**
+     * Unsubscribe from a CDC subscription
+     * @param subscriptionId - The ID of the subscription to remove
+     */
+    unsubscribe(subscriptionId: string): Promise<void>;
+    /**
+     * Acknowledge receipt of events up to the specified LSN
+     * This commits the stream position for exactly-once delivery
+     * @param lsn - The Log Sequence Number to acknowledge
+     */
+    ack(lsn: string): Promise<void>;
+    /**
+     * Check if the transport is currently connected
+     * @returns true if connected, false otherwise
+     */
+    isConnected(): boolean;
+    /**
+     * Register an event handler
+     * @param event - Event type: 'change', 'error', 'close', or 'reconnect'
+     * @param handler - Handler function to call when event occurs
+     */
+    on(event: 'change', handler: (event: ChangeEvent) => void): void;
+    on(event: 'error', handler: (error: Error) => void): void;
+    on(event: 'close', handler: () => void): void;
+    on(event: 'reconnect', handler: () => void): void;
+    /**
+     * Remove an event handler
+     * @param event - Event type to unsubscribe from
+     * @param handler - The handler function to remove
+     */
+    off(event: string, handler: (...args: unknown[]) => void): void;
+    /**
+     * Get last resume token
+     */
+    getResumeToken(): ResumeToken | null;
+    /**
+     * Get connection statistics
+     */
+    getStats(): {
+        state: ConnectionState;
+        eventsReceived: number;
+        messagesReceived: number;
+        messagesSent: number;
+        reconnectAttempts: number;
+        lastPingTime: number;
+        lastPongTime: number;
+    };
+    private handleOpen;
+    private handleConnectError;
+    private handleClose;
+    private handleError;
+    private handleMessage;
+    private handleChangeMessage;
+    private handleBatchMessage;
+    private handlePing;
+    private handlePong;
+    private handleErrorMessage;
+    private handleServerClose;
+    private startPingInterval;
+    private sendPing;
+    private scheduleReconnect;
+    private attemptReconnect;
+    private sendMessage;
+    private sendImmediate;
+    private processMessageQueue;
+    private rejectQueuedOperations;
+    private emitChange;
+    private emitError;
+    private emitClose;
+    private emitReconnect;
+    private clearTimers;
+}
+/**
+ * Create a WebSocket CDC transport
+ */
+export declare function createWebSocketTransport(options: WebSocketTransportOptions): WebSocketCDCTransport;
+export {};
+//# sourceMappingURL=websocket.d.ts.map

package/dist/cdc/transport/websocket.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"websocket.d.ts","sourceRoot":"","sources":["../../../src/cdc/transport/websocket.ts"],"names":[],"mappings":"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"}