@dotdo/postgres 0.1.0

package/dist/cdc/change-stream.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Change Stream Implementation
+ * Task: postgres-lp00 - CDC/Change Data Capture streaming
+ *
+ * Stub file - full implementation pending
+ */
+import type { ChangeEvent, ChangeStreamOptions, ChangeStreamFilter, ResumeToken, CDCOperation } from './types';
+/**
+ * Change stream for CDC events
+ * Provides async iteration and event-based APIs
+ */
+export declare class ChangeStream<T = Record<string, unknown>> implements AsyncIterable<ChangeEvent<T>> {
+    readonly tables: string[];
+    readonly options: ChangeStreamOptions;
+    private closed;
+    constructor(tables: string | string[], options?: ChangeStreamOptions);
+    [Symbol.asyncIterator](): AsyncIterableIterator<ChangeEvent<T>>;
+    on(_event: string, _handler: (...args: unknown[]) => void): this;
+    off(_event: string, _handler: (...args: unknown[]) => void): this;
+    close(): Promise<void>;
+    isClosed(): boolean;
+    getResumeToken(): ResumeToken | null;
+}
+/**
+ * Create a change stream for one or more tables
+ */
+export declare function createChangeStream<T = Record<string, unknown>>(tables: string | string[], options?: ChangeStreamOptions): ChangeStream<T>;
+/**
+ * Create a change stream with filtering
+ */
+export declare function createFilteredChangeStream<T = Record<string, unknown>>(tables: string | string[], filter: ChangeStreamFilter, options?: ChangeStreamOptions): ChangeStream<T>;
+/**
+ * Watch all tables
+ */
+export declare function watchAll<T = Record<string, unknown>>(options?: ChangeStreamOptions): ChangeStream<T>;
+/**
+ * Create a mock change stream for testing
+ */
+export declare function createMockChangeStream<T = Record<string, unknown>>(events: ChangeEvent<T>[]): ChangeStream<T>;
+/**
+ * Create a test change event
+ */
+export declare function createTestChangeEvent<T = Record<string, unknown>>(operation: CDCOperation, table: string, data?: Partial<ChangeEvent<T>>): ChangeEvent<T>;
+//# sourceMappingURL=change-stream.d.ts.map

package/dist/cdc/change-stream.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"change-stream.d.ts","sourceRoot":"","sources":["../../src/cdc/change-stream.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,WAAW,EACX,mBAAmB,EACnB,kBAAkB,EAClB,WAAW,EACX,YAAY,EACb,MAAM,SAAS,CAAA;AAOhB;;;GAGG;AACH,qBAAa,YAAY,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CACnD,YAAW,aAAa,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;IAExC,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,CAAA;IACzB,QAAQ,CAAC,OAAO,EAAE,mBAAmB,CAAA;IACrC,OAAO,CAAC,MAAM,CAAQ;gBAEV,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,EAAE,OAAO,CAAC,EAAE,mBAAmB;IAK7D,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,qBAAqB,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;IAKtE,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,GAAG,IAAI;IAIhE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,GAAG,IAAI;IAI3D,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAI5B,QAAQ,IAAI,OAAO;IAInB,cAAc,IAAI,WAAW,GAAG,IAAI;CAGrC;AAMD;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5D,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,EACzB,OAAO,CAAC,EAAE,mBAAmB,GAC5B,YAAY,CAAC,CAAC,CAAC,CAEjB;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACpE,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,EACzB,MAAM,EAAE,kBAAkB,EAC1B,OAAO,CAAC,EAAE,mBAAmB,GAC5B,YAAY,CAAC,CAAC,CAAC,CAKjB;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAClD,OAAO,CAAC,EAAE,mBAAmB,GAC5B,YAAY,CAAC,CAAC,CAAC,CAEjB;AAMD;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChE,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,EAAE,GACvB,YAAY,CAAC,CAAC,CAAC,CAKjB;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/D,SAAS,EAAE,YAAY,EACvB,KAAK,EAAE,MAAM,EACb,IAAI,GAAE,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAM,GACjC,WAAW,CAAC,CAAC,CAAC,CAchB"}

package/dist/cdc/change-stream.js

@@ -0,0 +1,95 @@
+/**
+ * Change Stream Implementation
+ * Task: postgres-lp00 - CDC/Change Data Capture streaming
+ *
+ * Stub file - full implementation pending
+ */
+import { createResumeToken } from './resume-token';
+// ============================================================================
+// ChangeStream Class
+// ============================================================================
+/**
+ * Change stream for CDC events
+ * Provides async iteration and event-based APIs
+ */
+export class ChangeStream {
+    tables;
+    options;
+    closed = false;
+    constructor(tables, options) {
+        this.tables = Array.isArray(tables) ? tables : [tables];
+        this.options = options ?? {};
+    }
+    async *[Symbol.asyncIterator]() {
+        // Stub - would connect to transport and yield events
+        yield* [];
+    }
+    on(_event, _handler) {
+        return this;
+    }
+    off(_event, _handler) {
+        return this;
+    }
+    async close() {
+        this.closed = true;
+    }
+    isClosed() {
+        return this.closed;
+    }
+    getResumeToken() {
+        return null;
+    }
+}
+// ============================================================================
+// Factory Functions
+// ============================================================================
+/**
+ * Create a change stream for one or more tables
+ */
+export function createChangeStream(tables, options) {
+    return new ChangeStream(tables, options);
+}
+/**
+ * Create a change stream with filtering
+ */
+export function createFilteredChangeStream(tables, filter, options) {
+    return new ChangeStream(tables, {
+        ...options,
+        filter,
+    });
+}
+/**
+ * Watch all tables
+ */
+export function watchAll(options) {
+    return new ChangeStream('*', options);
+}
+// ============================================================================
+// Test Utilities
+// ============================================================================
+/**
+ * Create a mock change stream for testing
+ */
+export function createMockChangeStream(events) {
+    const stream = new ChangeStream([]);
+    stream.events = events;
+    return stream;
+}
+/**
+ * Create a test change event
+ */
+export function createTestChangeEvent(operation, table, data = {}) {
+    const timestamp = Date.now();
+    const lsn = String(timestamp);
+    return {
+        id: `test-${timestamp}-${Math.random().toString(36).slice(2)}`,
+        lsn,
+        operation,
+        schema: 'public',
+        table,
+        timestamp,
+        resumeToken: createResumeToken(lsn, timestamp),
+        ...data,
+    };
+}
+//# sourceMappingURL=change-stream.js.map

package/dist/cdc/change-stream.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"change-stream.js","sourceRoot":"","sources":["../../src/cdc/change-stream.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AASH,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAA;AAElD,+EAA+E;AAC/E,qBAAqB;AACrB,+EAA+E;AAE/E;;;GAGG;AACH,MAAM,OAAO,YAAY;IAGd,MAAM,CAAU;IAChB,OAAO,CAAqB;IAC7B,MAAM,GAAG,KAAK,CAAA;IAEtB,YAAY,MAAyB,EAAE,OAA6B;QAClE,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAA;QACvD,IAAI,CAAC,OAAO,GAAG,OAAO,IAAI,EAAE,CAAA;IAC9B,CAAC;IAED,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC;QAC3B,qDAAqD;QACrD,KAAK,CAAC,CAAC,EAAE,CAAA;IACX,CAAC;IAED,EAAE,CAAC,MAAc,EAAE,QAAsC;QACvD,OAAO,IAAI,CAAA;IACb,CAAC;IAED,GAAG,CAAC,MAAc,EAAE,QAAsC;QACxD,OAAO,IAAI,CAAA;IACb,CAAC;IAED,KAAK,CAAC,KAAK;QACT,IAAI,CAAC,MAAM,GAAG,IAAI,CAAA;IACpB,CAAC;IAED,QAAQ;QACN,OAAO,IAAI,CAAC,MAAM,CAAA;IACpB,CAAC;IAED,cAAc;QACZ,OAAO,IAAI,CAAA;IACb,CAAC;CACF;AAED,+EAA+E;AAC/E,oBAAoB;AACpB,+EAA+E;AAE/E;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAChC,MAAyB,EACzB,OAA6B;IAE7B,OAAO,IAAI,YAAY,CAAI,MAAM,EAAE,OAAO,CAAC,CAAA;AAC7C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,0BAA0B,CACxC,MAAyB,EACzB,MAA0B,EAC1B,OAA6B;IAE7B,OAAO,IAAI,YAAY,CAAI,MAAM,EAAE;QACjC,GAAG,OAAO;QACV,MAAM;KACP,CAAC,CAAA;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,QAAQ,CACtB,OAA6B;IAE7B,OAAO,IAAI,YAAY,CAAI,GAAG,EAAE,OAAO,CAAC,CAAA;AAC1C,CAAC;AAED,+EAA+E;AAC/E,iBAAiB;AACjB,+EAA+E;AAE/E;;GAEG;AACH,MAAM,UAAU,sBAAsB,CACpC,MAAwB;IAExB,MAAM,MAAM,GAAG,IAAI,YAAY,CAAI,EAAE,CAAC,CAErC;IAAC,MAAkD,CAAC,MAAM,GAAG,MAAM,CAAA;IACpE,OAAO,MAAM,CAAA;AACf,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,qBAAqB,CACnC,SAAuB,EACvB,KAAa,EACb,OAAgC,EAAE;IAElC,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;IAC5B,MAAM,GAAG,GAAG,MAAM,CAAC,SAAS,CAAC,CAAA;IAE7B,OAAO;QACL,EAAE,EAAE,QAAQ,SAAS,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE;QAC9D,GAAG;QACH,SAAS;QACT,MAAM,EAAE,QAAQ;QAChB,KAAK;QACL,SAAS;QACT,WAAW,EAAE,iBAAiB,CAAC,GAAG,EAAE,SAAS,CAAC;QAC9C,GAAG,IAAI;KACU,CAAA;AACrB,CAAC"}

package/dist/cdc/filter.d.ts

@@ -0,0 +1,58 @@
+/**
+ * CDC Filter Implementation
+ * Task: postgres-lp00 - CDC/Change Data Capture streaming
+ *
+ * Provides filtering and transformation for CDC change events.
+ * Supports operation filtering, table matching, SQL-like WHERE clauses,
+ * and MongoDB-style pipeline transformations.
+ */
+import type { ChangeEvent, ChangeStreamFilter, ChangeStreamPipelineStage } from './types';
+/**
+ * Check if a change event matches a filter
+ */
+export declare function matchesFilter(event: ChangeEvent, filter: ChangeStreamFilter): boolean;
+/**
+ * Apply a filter to an event
+ * Returns the (possibly transformed) event if it matches, null otherwise
+ */
+export declare function applyFilter<T = Record<string, unknown>>(event: ChangeEvent<T>, filter: ChangeStreamFilter): ChangeEvent<T> | null;
+/**
+ * Apply a pipeline of transformations to an event
+ */
+export declare function applyPipeline<T = Record<string, unknown>>(event: ChangeEvent<T>, pipeline: ChangeStreamPipelineStage[]): ChangeEvent<T> | null;
+/**
+ * Create a reusable filter function
+ */
+export declare function createFilterFunction<T = Record<string, unknown>>(filter: ChangeStreamFilter): (event: ChangeEvent<T>) => ChangeEvent<T> | null;
+/**
+ * Create a reusable pipeline function
+ */
+export declare function createPipelineFunction<T = Record<string, unknown>>(pipeline: ChangeStreamPipelineStage[]): (event: ChangeEvent<T>) => ChangeEvent<T> | null;
+/**
+ * Combine multiple filters with AND logic
+ */
+export declare function combineFilters(...filters: ChangeStreamFilter[]): ChangeStreamFilter;
+/**
+ * Pre-built filter helpers
+ */
+export declare const QuickFilters: {
+    /** Only INSERT operations */
+    insertsOnly(): ChangeStreamFilter;
+    /** Only UPDATE operations */
+    updatesOnly(): ChangeStreamFilter;
+    /** Only DELETE operations */
+    deletesOnly(): ChangeStreamFilter;
+    /** All data-changing operations (no TRUNCATE) */
+    dataChangesOnly(): ChangeStreamFilter;
+    /** Filter by table name */
+    table(tableName: string): ChangeStreamFilter;
+    /** Filter by table pattern */
+    tablePattern(pattern: string): ChangeStreamFilter;
+    /** Filter by schema */
+    schema(schemaName: string): ChangeStreamFilter;
+    /** Filter by multiple tables */
+    tables(...tableNames: string[]): ChangeStreamFilter;
+    /** Custom WHERE clause */
+    where(clause: string): ChangeStreamFilter;
+};
+//# sourceMappingURL=filter.d.ts.map

package/dist/cdc/filter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filter.d.ts","sourceRoot":"","sources":["../../src/cdc/filter.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EACV,WAAW,EACX,kBAAkB,EAClB,yBAAyB,EAE1B,MAAM,SAAS,CAAA;AAiNhB;;GAEG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,WAAW,EAClB,MAAM,EAAE,kBAAkB,GACzB,OAAO,CA+CT;AAMD;;;GAGG;AACH,wBAAgB,WAAW,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACrD,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC,EACrB,MAAM,EAAE,kBAAkB,GACzB,WAAW,CAAC,CAAC,CAAC,GAAG,IAAI,CA2BvB;AAqCD;;GAEG;AACH,wBAAgB,aAAa,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACvD,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC,EACrB,QAAQ,EAAE,yBAAyB,EAAE,GACpC,WAAW,CAAC,CAAC,CAAC,GAAG,IAAI,CA0BvB;AAwHD;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9D,MAAM,EAAE,kBAAkB,GACzB,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC,KAAK,WAAW,CAAC,CAAC,CAAC,GAAG,IAAI,CAElD;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChE,QAAQ,EAAE,yBAAyB,EAAE,GACpC,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC,KAAK,WAAW,CAAC,CAAC,CAAC,GAAG,IAAI,CAElD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,GAAG,OAAO,EAAE,kBAAkB,EAAE,GAC/B,kBAAkB,CA+DpB;AAMD;;GAEG;AACH,eAAO,MAAM,YAAY;IACvB,6BAA6B;mBACd,kBAAkB;IAIjC,6BAA6B;mBACd,kBAAkB;IAIjC,6BAA6B;mBACd,kBAAkB;IAIjC,iDAAiD;uBAC9B,kBAAkB;IAIrC,2BAA2B;qBACV,MAAM,GAAG,kBAAkB;IAI5C,8BAA8B;0BACR,MAAM,GAAG,kBAAkB;IAIjD,uBAAuB;uBACJ,MAAM,GAAG,kBAAkB;IAI9C,gCAAgC;0BACV,MAAM,EAAE,GAAG,kBAAkB;IAInD,0BAA0B;kBACZ,MAAM,GAAG,kBAAkB;CAG1C,CAAA"}