@dotdo/postgres 0.1.0

package/dist/cdc/resume-token.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Resume Token Implementation
+ * Task: postgres-lp00 - CDC/Change Data Capture streaming
+ *
+ * Provides resume tokens for exactly-once delivery in CDC streams.
+ * Tokens encode LSN, timestamp, and optional metadata with checksum.
+ */
+import type { ResumeToken, ChangeEvent } from './types';
+/**
+ * Create a resume token from LSN and timestamp
+ */
+export declare function createResumeToken(lsn: string, timestamp: number, options?: {
+    shardId?: string | undefined;
+    sequence?: number | undefined;
+}): ResumeToken;
+/**
+ * Create a resume token from a change event
+ */
+export declare function createResumeTokenFromEvent(event: ChangeEvent): ResumeToken;
+/**
+ * Parse a resume token
+ * Returns null if token is invalid
+ */
+export declare function parseResumeToken(token: ResumeToken | string): {
+    lsn: string;
+    timestamp: number;
+    shardId?: string | undefined;
+    sequence?: number | undefined;
+} | null;
+/**
+ * Compare two resume tokens
+ * Returns negative if a < b, positive if a > b, 0 if equal
+ * Throws if either token is invalid
+ */
+export declare function compareResumeTokens(a: ResumeToken | string, b: ResumeToken | string): number;
+/**
+ * Check if a token is valid
+ */
+export declare function isValidResumeToken(token: ResumeToken | string | unknown): boolean;
+/**
+ * Create a resume token from just an LSN
+ */
+export declare function resumeTokenFromLsn(lsn: string, timestamp?: number): ResumeToken;
+/**
+ * Extract LSN from a resume token
+ */
+export declare function getLsnFromResumeToken(token: ResumeToken | string): string | null;
+/**
+ * Extract timestamp from a resume token
+ */
+export declare function getTimestampFromResumeToken(token: ResumeToken | string): number | null;
+/**
+ * Serialize a resume token to a string for storage
+ */
+export declare function serializeResumeToken(token: ResumeToken): string;
+/**
+ * Deserialize a string back to a resume token
+ */
+export declare function deserializeResumeToken(data: string): ResumeToken;
+//# sourceMappingURL=resume-token.d.ts.map

package/dist/cdc/resume-token.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resume-token.d.ts","sourceRoot":"","sources":["../../src/cdc/resume-token.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AAyDvD;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE;IAAE,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,GACxE,WAAW,CAuBb;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,WAAW,GAAG,WAAW,CAI1E;AAMD;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,GAAG;IAC7D,GAAG,EAAE,MAAM,CAAA;IACX,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC5B,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAC9B,GAAG,IAAI,CAgDP;AAMD;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,CAAC,EAAE,WAAW,GAAG,MAAM,EACvB,CAAC,EAAE,WAAW,GAAG,MAAM,GACtB,MAAM,CA6BR;AAMD;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,CAWjF;AAMD;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,WAAW,CAE/E;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,GAAG,MAAM,GAAG,IAAI,CAGhF;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,GAAG,MAAM,GAAG,IAAI,CAGtF;AAMD;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,CAE/D;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,CAMhE"}

package/dist/cdc/resume-token.js

@@ -0,0 +1,228 @@
+/**
+ * Resume Token Implementation
+ * Task: postgres-lp00 - CDC/Change Data Capture streaming
+ *
+ * Provides resume tokens for exactly-once delivery in CDC streams.
+ * Tokens encode LSN, timestamp, and optional metadata with checksum.
+ */
+// ============================================================================
+// Constants
+// ============================================================================
+const TOKEN_VERSION = 1;
+const TOKEN_SEPARATOR = '|';
+const CHECKSUM_LENGTH = 8;
+// ============================================================================
+// Internal Helpers
+// ============================================================================
+/**
+ * Simple checksum for token validation
+ */
+function computeChecksum(data) {
+    let hash = 0;
+    for (let i = 0; i < data.length; i++) {
+        const char = data.charCodeAt(i);
+        hash = ((hash << 5) - hash + char) | 0;
+    }
+    // Convert to positive hex string
+    return Math.abs(hash).toString(16).padStart(CHECKSUM_LENGTH, '0').slice(0, CHECKSUM_LENGTH);
+}
+/**
+ * Encode data to base64 (browser-safe)
+ */
+function encodeBase64(data) {
+    if (typeof btoa === 'function') {
+        return btoa(unescape(encodeURIComponent(data)));
+    }
+    // Node.js fallback
+    return Buffer.from(data, 'utf-8').toString('base64');
+}
+/**
+ * Decode base64 to string (browser-safe)
+ */
+function decodeBase64(encoded) {
+    try {
+        if (typeof atob === 'function') {
+            return decodeURIComponent(escape(atob(encoded)));
+        }
+        // Node.js fallback
+        return Buffer.from(encoded, 'base64').toString('utf-8');
+    }
+    catch {
+        return '';
+    }
+}
+// ============================================================================
+// Token Creation
+// ============================================================================
+/**
+ * Create a resume token from LSN and timestamp
+ */
+export function createResumeToken(lsn, timestamp, options) {
+    const payload = {
+        v: TOKEN_VERSION,
+        l: lsn,
+        t: timestamp,
+        s: options?.shardId,
+        n: options?.sequence,
+    };
+    const payloadStr = JSON.stringify(payload);
+    const checksum = computeChecksum(payloadStr);
+    const data = encodeBase64(payloadStr + TOKEN_SEPARATOR + checksum);
+    return {
+        _data: data,
+        _decoded: {
+            lsn,
+            timestamp,
+            shardId: options?.shardId,
+            sequence: options?.sequence,
+            checksum,
+        },
+    };
+}
+/**
+ * Create a resume token from a change event
+ */
+export function createResumeTokenFromEvent(event) {
+    return createResumeToken(event.lsn, event.timestamp, {
+        shardId: event.transactionId,
+    });
+}
+// ============================================================================
+// Token Parsing
+// ============================================================================
+/**
+ * Parse a resume token
+ * Returns null if token is invalid
+ */
+export function parseResumeToken(token) {
+    try {
+        // Handle object or string
+        const data = typeof token === 'string' ? token : token._data;
+        // Check if we have cached decoded info
+        if (typeof token === 'object' && token._decoded) {
+            return token._decoded;
+        }
+        // Decode and validate
+        const decoded = decodeBase64(data);
+        if (!decoded) {
+            return null;
+        }
+        const separatorIndex = decoded.lastIndexOf(TOKEN_SEPARATOR);
+        if (separatorIndex === -1) {
+            return null;
+        }
+        const payloadStr = decoded.slice(0, separatorIndex);
+        const checksum = decoded.slice(separatorIndex + 1);
+        // Verify checksum
+        const expectedChecksum = computeChecksum(payloadStr);
+        if (checksum !== expectedChecksum) {
+            return null;
+        }
+        // Parse payload
+        const payload = JSON.parse(payloadStr);
+        return {
+            lsn: payload.l,
+            timestamp: payload.t,
+            shardId: payload.s,
+            sequence: payload.n,
+        };
+    }
+    catch {
+        return null;
+    }
+}
+// ============================================================================
+// Token Comparison
+// ============================================================================
+/**
+ * Compare two resume tokens
+ * Returns negative if a < b, positive if a > b, 0 if equal
+ * Throws if either token is invalid
+ */
+export function compareResumeTokens(a, b) {
+    const parsedA = parseResumeToken(a);
+    const parsedB = parseResumeToken(b);
+    if (!parsedA || !parsedB) {
+        throw new Error('Invalid resume token');
+    }
+    // Compare by LSN first (as numbers if possible)
+    const lsnA = parseInt(parsedA.lsn, 10);
+    const lsnB = parseInt(parsedB.lsn, 10);
+    if (!isNaN(lsnA) && !isNaN(lsnB)) {
+        if (lsnA !== lsnB) {
+            return lsnA - lsnB;
+        }
+    }
+    else {
+        // String comparison for non-numeric LSNs
+        const cmp = parsedA.lsn.localeCompare(parsedB.lsn);
+        if (cmp !== 0) {
+            return cmp;
+        }
+    }
+    // If LSN is same, compare by sequence
+    const seqA = parsedA.sequence ?? 0;
+    const seqB = parsedB.sequence ?? 0;
+    return seqA - seqB;
+}
+// ============================================================================
+// Token Validation
+// ============================================================================
+/**
+ * Check if a token is valid
+ */
+export function isValidResumeToken(token) {
+    if (!token) {
+        return false;
+    }
+    try {
+        const parsed = parseResumeToken(token);
+        return parsed !== null;
+    }
+    catch {
+        return false;
+    }
+}
+// ============================================================================
+// Convenience Functions
+// ============================================================================
+/**
+ * Create a resume token from just an LSN
+ */
+export function resumeTokenFromLsn(lsn, timestamp) {
+    return createResumeToken(lsn, timestamp ?? Date.now());
+}
+/**
+ * Extract LSN from a resume token
+ */
+export function getLsnFromResumeToken(token) {
+    const parsed = parseResumeToken(token);
+    return parsed?.lsn ?? null;
+}
+/**
+ * Extract timestamp from a resume token
+ */
+export function getTimestampFromResumeToken(token) {
+    const parsed = parseResumeToken(token);
+    return parsed?.timestamp ?? null;
+}
+// ============================================================================
+// Serialization
+// ============================================================================
+/**
+ * Serialize a resume token to a string for storage
+ */
+export function serializeResumeToken(token) {
+    return token._data;
+}
+/**
+ * Deserialize a string back to a resume token
+ */
+export function deserializeResumeToken(data) {
+    const parsed = parseResumeToken(data);
+    return {
+        _data: data,
+        _decoded: parsed ?? undefined,
+    };
+}
+//# sourceMappingURL=resume-token.js.map

package/dist/cdc/resume-token.js.map

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

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

@@ -0,0 +1,7 @@
+/**
+ * CDC Transport Exports
+ * Task: postgres-lp00 - CDC/Change Data Capture streaming
+ */
+export { WebSocketCDCTransport, createWebSocketTransport } from './websocket';
+export { SSECDCTransport, createSSETransport } from './sse';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/cdc/transport/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,qBAAqB,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAA;AAC7E,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,OAAO,CAAA"}

package/dist/cdc/transport/index.js

@@ -0,0 +1,7 @@
+/**
+ * CDC Transport Exports
+ * Task: postgres-lp00 - CDC/Change Data Capture streaming
+ */
+export { WebSocketCDCTransport, createWebSocketTransport } from './websocket';
+export { SSECDCTransport, createSSETransport } from './sse';
+//# sourceMappingURL=index.js.map

package/dist/cdc/transport/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/cdc/transport/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,qBAAqB,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAA;AAC7E,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,OAAO,CAAA"}

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

@@ -0,0 +1,120 @@
+/**
+ * SSE (Server-Sent Events) CDC Transport
+ * Task: postgres-lp00 - CDC/Change Data Capture streaming
+ *
+ * Implements CDC streaming over Server-Sent Events with:
+ * - Standard EventSource API support
+ * - Fetch-based fallback for restricted environments
+ * - Automatic reconnection with Last-Event-ID
+ * - Resume from token on reconnection
+ */
+import type { CDCTransport, CDCTransportOptions, SSETransportOptions, ChangeEvent, SubscriptionConfig, ResumeToken } from '../types';
+/**
+ * Connection state for the SSE transport
+ */
+type ConnectionState = 'disconnected' | 'connecting' | 'connected' | 'reconnecting' | 'closed';
+/**
+ * SSE CDC Transport
+ *
+ * Provides CDC streaming over Server-Sent Events with:
+ * - EventSource API for standard browsers
+ * - Fetch-based streaming for Cloudflare Workers and other environments
+ * - Automatic reconnection with resume support
+ */
+export declare class SSECDCTransport implements CDCTransport {
+    private options;
+    private eventSource;
+    private fetchController;
+    private state;
+    private reconnectAttempt;
+    private reconnectTimer;
+    private subscriptions;
+    private changeHandlers;
+    private errorHandlers;
+    private closeHandlers;
+    private reconnectHandlers;
+    private lastResumeToken;
+    private lastEventId;
+    private lastLsn;
+    constructor(options: SSETransportOptions);
+    connect(options?: CDCTransportOptions): Promise<void>;
+    disconnect(): Promise<void>;
+    subscribe(config: SubscriptionConfig): Promise<void>;
+    unsubscribe(subscriptionId: string): Promise<void>;
+    ack(lsn: string): Promise<void>;
+    isConnected(): boolean;
+    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;
+    off(event: string, handler: (...args: unknown[]) => void): void;
+    /**
+     * Connect using the native EventSource API
+     * Used in browser environments with standard EventSource support
+     */
+    private connectWithEventSource;
+    /**
+     * Connect using the Fetch API with streaming
+     * Used in Cloudflare Workers and other environments without EventSource
+     */
+    private connectWithFetch;
+    /**
+     * Process incoming SSE stream data
+     * Parses SSE format: event/data/id/retry fields, dispatches on empty line
+     */
+    private processStream;
+    /**
+     * Handle an incoming SSE message by type
+     * Routes to appropriate handler based on event type
+     */
+    private handleSSEMessage;
+    /**
+     * Process a change event and emit to handlers
+     * Updates resume token state for reconnection support
+     */
+    private handleChangeEvent;
+    /**
+     * Build the SSE endpoint URL with query parameters
+     * Includes authentication, database, resume position, and subscriptions
+     */
+    private buildUrl;
+    private emitError;
+    private emitClose;
+    private emitReconnect;
+    /**
+     * Schedule a reconnection attempt with exponential backoff
+     * Respects maxAttempts and maxDelay configuration
+     */
+    private scheduleReconnect;
+    /**
+     * Cancel any pending reconnection timer
+     */
+    private stopReconnectTimer;
+    /**
+     * Get current connection state
+     */
+    getState(): ConnectionState;
+    /**
+     * Get last resume token
+     */
+    getResumeToken(): ResumeToken | null;
+    /**
+     * Get last event ID (for SSE resume)
+     */
+    getLastEventId(): string | null;
+    /**
+     * Get connection statistics
+     */
+    getStats(): {
+        state: ConnectionState;
+        reconnectAttempts: number;
+        subscriptionCount: number;
+        lastEventId: string | null;
+    };
+}
+/**
+ * Create an SSE CDC transport
+ */
+export declare function createSSETransport(options: SSETransportOptions): SSECDCTransport;
+export {};
+//# sourceMappingURL=sse.d.ts.map

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

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