@powersync/service-module-postgres 0.0.0-dev-20240918092408

package/dist/replication/WalStreamReplicationJob.js

@@ -0,0 +1,131 @@
+import { MissingReplicationSlotError, WalStream } from './WalStream.js';
+import { container } from '@powersync/lib-services-framework';
+import { replication } from '@powersync/service-core';
+export class WalStreamReplicationJob extends replication.AbstractReplicationJob {
+    constructor(options) {
+        super(options);
+        this.connectionFactory = options.connectionFactory;
+        this.connectionManager = this.connectionFactory.create({
+            // Pool connections are only used intermittently.
+            idleTimeout: 30000,
+            maxSize: 2
+        });
+    }
+    /**
+     * Postgres on RDS writes performs a WAL checkpoint every 5 minutes by default, which creates a new 64MB file.
+     *
+     * The old WAL files are only deleted once no replication slot still references it.
+     *
+     * Unfortunately, when there are no changes to the db, the database creates new WAL files without the replication slot
+     * advancing**.
+     *
+     * As a workaround, we write a new message every couple of minutes, to make sure that the replication slot advances.
+     *
+     * **This may be a bug in pgwire or how we're using it.
+     */
+    async keepAlive() {
+        try {
+            await this.connectionManager.pool.query(`SELECT * FROM pg_logical_emit_message(false, 'powersync', 'ping')`);
+        }
+        catch (e) {
+            this.logger.warn(`KeepAlive failed, unable to post to WAL`, e);
+        }
+    }
+    get slotName() {
+        return this.options.storage.slot_name;
+    }
+    async replicate() {
+        try {
+            await this.replicateLoop();
+        }
+        catch (e) {
+            // Fatal exception
+            container.reporter.captureException(e, {
+                metadata: {
+                    replication_slot: this.slotName
+                }
+            });
+            this.logger.error(`Replication failed on ${this.slotName}`, e);
+            if (e instanceof MissingReplicationSlotError) {
+                // This stops replication on this slot, and creates a new slot
+                await this.options.storage.factory.slotRemoved(this.slotName);
+            }
+        }
+        finally {
+            this.abortController.abort();
+        }
+    }
+    async replicateLoop() {
+        while (!this.isStopped) {
+            await this.replicateOnce();
+            if (!this.isStopped) {
+                await new Promise((resolve) => setTimeout(resolve, 5000));
+            }
+        }
+    }
+    async replicateOnce() {
+        // New connections on every iteration (every error with retry),
+        // otherwise we risk repeating errors related to the connection,
+        // such as caused by cached PG schemas.
+        const connectionManager = this.connectionFactory.create({
+            // Pool connections are only used intermittently.
+            idleTimeout: 30000,
+            maxSize: 2
+        });
+        try {
+            await this.rateLimiter?.waitUntilAllowed({ signal: this.abortController.signal });
+            if (this.isStopped) {
+                return;
+            }
+            const stream = new WalStream({
+                abort_signal: this.abortController.signal,
+                storage: this.options.storage,
+                connections: connectionManager
+            });
+            await stream.replicate();
+        }
+        catch (e) {
+            this.logger.error(`Replication error`, e);
+            if (e.cause != null) {
+                // Example:
+                // PgError.conn_ended: Unable to do postgres query on ended connection
+                //     at PgConnection.stream (file:///.../powersync/node_modules/.pnpm/github.com+kagis+pgwire@f1cb95f9a0f42a612bb5a6b67bb2eb793fc5fc87/node_modules/pgwire/mod.js:315:13)
+                //     at stream.next (<anonymous>)
+                //     at PgResult.fromStream (file:///.../powersync/node_modules/.pnpm/github.com+kagis+pgwire@f1cb95f9a0f42a612bb5a6b67bb2eb793fc5fc87/node_modules/pgwire/mod.js:1174:22)
+                //     at PgConnection.query (file:///.../powersync/node_modules/.pnpm/github.com+kagis+pgwire@f1cb95f9a0f42a612bb5a6b67bb2eb793fc5fc87/node_modules/pgwire/mod.js:311:21)
+                //     at WalStream.startInitialReplication (file:///.../powersync/powersync-service/lib/replication/WalStream.js:266:22)
+                //     ...
+                //   cause: TypeError: match is not iterable
+                //       at timestamptzToSqlite (file:///.../powersync/packages/jpgwire/dist/util.js:140:50)
+                //       at PgType.decode (file:///.../powersync/packages/jpgwire/dist/pgwire_types.js:25:24)
+                //       at PgConnection._recvDataRow (file:///.../powersync/packages/jpgwire/dist/util.js:88:22)
+                //       at PgConnection._recvMessages (file:///.../powersync/node_modules/.pnpm/github.com+kagis+pgwire@f1cb95f9a0f42a612bb5a6b67bb2eb793fc5fc87/node_modules/pgwire/mod.js:656:30)
+                //       at PgConnection._ioloopAttempt (file:///.../powersync/node_modules/.pnpm/github.com+kagis+pgwire@f1cb95f9a0f42a612bb5a6b67bb2eb793fc5fc87/node_modules/pgwire/mod.js:563:20)
+                //       at process.processTicksAndRejections (node:internal/process/task_queues:95:5)
+                //       at async PgConnection._ioloop (file:///.../powersync/node_modules/.pnpm/github.com+kagis+pgwire@f1cb95f9a0f42a612bb5a6b67bb2eb793fc5fc87/node_modules/pgwire/mod.js:517:14),
+                //   [Symbol(pg.ErrorCode)]: 'conn_ended',
+                //   [Symbol(pg.ErrorResponse)]: undefined
+                // }
+                // Without this additional log, the cause would not be visible in the logs.
+                this.logger.error(`cause`, e.cause);
+            }
+            if (e instanceof MissingReplicationSlotError) {
+                throw e;
+            }
+            else {
+                // Report the error if relevant, before retrying
+                container.reporter.captureException(e, {
+                    metadata: {
+                        replication_slot: this.slotName
+                    }
+                });
+                // This sets the retry delay
+                this.rateLimiter?.reportError(e);
+            }
+        }
+        finally {
+            await connectionManager.end();
+        }
+    }
+}
+//# sourceMappingURL=WalStreamReplicationJob.js.map

package/dist/replication/WalStreamReplicationJob.js.map

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

package/dist/replication/WalStreamReplicator.d.ts

@@ -0,0 +1,13 @@
+import { storage, replication } from '@powersync/service-core';
+import { WalStreamReplicationJob } from './WalStreamReplicationJob.js';
+import { ConnectionManagerFactory } from './ConnectionManagerFactory.js';
+export interface WalStreamReplicatorOptions extends replication.AbstractReplicatorOptions {
+    connectionFactory: ConnectionManagerFactory;
+}
+export declare class WalStreamReplicator extends replication.AbstractReplicator<WalStreamReplicationJob> {
+    private readonly connectionFactory;
+    constructor(options: WalStreamReplicatorOptions);
+    createJob(options: replication.CreateJobOptions): WalStreamReplicationJob;
+    cleanUp(syncRulesStorage: storage.SyncRulesBucketStorage): Promise<void>;
+    stop(): Promise<void>;
+}

package/dist/replication/WalStreamReplicator.js

@@ -0,0 +1,36 @@
+import { replication } from '@powersync/service-core';
+import { WalStreamReplicationJob } from './WalStreamReplicationJob.js';
+import { cleanUpReplicationSlot } from './replication-utils.js';
+export class WalStreamReplicator extends replication.AbstractReplicator {
+    constructor(options) {
+        super(options);
+        this.connectionFactory = options.connectionFactory;
+    }
+    createJob(options) {
+        return new WalStreamReplicationJob({
+            id: this.createJobId(options.storage.group_id),
+            storage: options.storage,
+            connectionFactory: this.connectionFactory,
+            lock: options.lock,
+            rateLimiter: this.rateLimiter
+        });
+    }
+    async cleanUp(syncRulesStorage) {
+        const connectionManager = this.connectionFactory.create({
+            idleTimeout: 30000,
+            maxSize: 1
+        });
+        try {
+            // TODO: Slot_name will likely have to come from a different source in the future
+            await cleanUpReplicationSlot(syncRulesStorage.slot_name, connectionManager.pool);
+        }
+        finally {
+            await connectionManager.end();
+        }
+    }
+    async stop() {
+        await super.stop();
+        await this.connectionFactory.shutdown();
+    }
+}
+//# sourceMappingURL=WalStreamReplicator.js.map

package/dist/replication/WalStreamReplicator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"WalStreamReplicator.js","sourceRoot":"","sources":["../../src/replication/WalStreamReplicator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAW,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AAEvE,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAMhE,MAAM,OAAO,mBAAoB,SAAQ,WAAW,CAAC,kBAA2C;IAG9F,YAAY,OAAmC;QAC7C,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IACrD,CAAC;IAED,SAAS,CAAC,OAAqC;QAC7C,OAAO,IAAI,uBAAuB,CAAC;YACjC,EAAE,EAAE,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC;YAC9C,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,iBAAiB,EAAE,IAAI,CAAC,iBAAiB;YACzC,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,WAAW,EAAE,IAAI,CAAC,WAAW;SAC9B,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,gBAAgD;QAC5D,MAAM,iBAAiB,GAAG,IAAI,CAAC,iBAAiB,CAAC,MAAM,CAAC;YACtD,WAAW,EAAE,KAAM;YACnB,OAAO,EAAE,CAAC;SACX,CAAC,CAAC;QACH,IAAI;YACF,iFAAiF;YACjF,MAAM,sBAAsB,CAAC,gBAAgB,CAAC,SAAS,EAAE,iBAAiB,CAAC,IAAI,CAAC,CAAC;SAClF;gBAAS;YACR,MAAM,iBAAiB,CAAC,GAAG,EAAE,CAAC;SAC/B;IACH,CAAC;IAED,KAAK,CAAC,IAAI;QACR,MAAM,KAAK,CAAC,IAAI,EAAE,CAAC;QACnB,MAAM,IAAI,CAAC,iBAAiB,CAAC,QAAQ,EAAE,CAAC;IAC1C,CAAC;CACF"}

package/dist/replication/replication-index.d.ts

@@ -0,0 +1,5 @@
+export * from './PgRelation.js';
+export * from './replication-utils.js';
+export * from './WalStream.js';
+export * from './WalStreamReplicator.js';
+export * from './WalStreamReplicationJob.js';

package/dist/replication/replication-index.js

@@ -0,0 +1,6 @@
+export * from './PgRelation.js';
+export * from './replication-utils.js';
+export * from './WalStream.js';
+export * from './WalStreamReplicator.js';
+export * from './WalStreamReplicationJob.js';
+//# sourceMappingURL=replication-index.js.map

package/dist/replication/replication-index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"replication-index.js","sourceRoot":"","sources":["../../src/replication/replication-index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,wBAAwB,CAAC;AACvC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,0BAA0B,CAAC;AACzC,cAAc,8BAA8B,CAAC"}

package/dist/replication/replication-utils.d.ts

@@ -0,0 +1,32 @@
+import * as pgwire from '@powersync/service-jpgwire';
+import { PatternResult, storage } from '@powersync/service-core';
+import { ReplicationIdentity } from './PgRelation.js';
+import * as sync_rules from '@powersync/service-sync-rules';
+import * as service_types from '@powersync/service-types';
+export interface ReplicaIdentityResult {
+    replicationColumns: storage.ColumnDescriptor[];
+    replicationIdentity: ReplicationIdentity;
+}
+export declare function getPrimaryKeyColumns(db: pgwire.PgClient, relationId: number, mode: 'primary' | 'replident'): Promise<storage.ColumnDescriptor[]>;
+export declare function getAllColumns(db: pgwire.PgClient, relationId: number): Promise<storage.ColumnDescriptor[]>;
+export declare function getReplicationIdentityColumns(db: pgwire.PgClient, relationId: number): Promise<ReplicaIdentityResult>;
+export declare function checkSourceConfiguration(db: pgwire.PgClient, publicationName: string): Promise<void>;
+export interface GetDebugTablesInfoOptions {
+    db: pgwire.PgClient;
+    publicationName: string;
+    connectionTag: string;
+    tablePatterns: sync_rules.TablePattern[];
+    syncRules: sync_rules.SqlSyncRules;
+}
+export declare function getDebugTablesInfo(options: GetDebugTablesInfoOptions): Promise<PatternResult[]>;
+export interface GetDebugTableInfoOptions {
+    db: pgwire.PgClient;
+    name: string;
+    publicationName: string;
+    connectionTag: string;
+    tablePattern: sync_rules.TablePattern;
+    relationId: number | null;
+    syncRules: sync_rules.SqlSyncRules;
+}
+export declare function getDebugTableInfo(options: GetDebugTableInfoOptions): Promise<service_types.TableInfo>;
+export declare function cleanUpReplicationSlot(slotName: string, db: pgwire.PgClient): Promise<void>;

package/dist/replication/replication-utils.js

@@ -0,0 +1,272 @@
+import * as pgwire from '@powersync/service-jpgwire';
+import { storage } from '@powersync/service-core';
+import * as pgwire_utils from '../utils/pgwire_utils.js';
+import * as pg_utils from '../utils/pgwire_utils.js';
+import * as util from '../utils/pgwire_utils.js';
+import { logger } from '@powersync/lib-services-framework';
+export async function getPrimaryKeyColumns(db, relationId, mode) {
+    const indexFlag = mode == 'primary' ? `i.indisprimary` : `i.indisreplident`;
+    const attrRows = await pgwire_utils.retriedQuery(db, {
+        statement: `SELECT a.attname as name, a.atttypid as typeid, t.typname as type, a.attnum as attnum
+                                    FROM pg_index i
+                                    JOIN pg_attribute a ON a.attrelid = i.indrelid AND a.attnum = ANY (i.indkey)
+                                    JOIN pg_type t ON a.atttypid = t.oid
+                                    WHERE i.indrelid = $1::oid
+                                      AND ${indexFlag}
+                                      AND a.attnum > 0
+                                      ORDER BY a.attnum`,
+        params: [{ value: relationId, type: 'int4' }]
+    });
+    return attrRows.rows.map((row) => {
+        return {
+            name: row[0],
+            typeId: row[1]
+        };
+    });
+}
+export async function getAllColumns(db, relationId) {
+    const attrRows = await pgwire_utils.retriedQuery(db, {
+        statement: `SELECT a.attname as name, a.atttypid as typeid, t.typname as type, a.attnum as attnum
+                                    FROM pg_attribute a
+                                    JOIN pg_type t ON a.atttypid = t.oid
+                                    WHERE a.attrelid = $1::oid
+                                      AND attnum > 0
+                                    ORDER BY a.attnum`,
+        params: [{ type: 'varchar', value: relationId }]
+    });
+    return attrRows.rows.map((row) => {
+        return {
+            name: row[0],
+            typeId: row[1]
+        };
+    });
+}
+export async function getReplicationIdentityColumns(db, relationId) {
+    const rows = await pgwire_utils.retriedQuery(db, {
+        statement: `SELECT CASE relreplident
+        WHEN 'd' THEN 'default'
+        WHEN 'n' THEN 'nothing'
+        WHEN 'f' THEN 'full'
+        WHEN 'i' THEN 'index'
+     END AS replica_identity
+FROM pg_class
+WHERE oid = $1::oid LIMIT 1`,
+        params: [{ type: 'int8', value: relationId }]
+    });
+    const idType = rows.rows[0]?.[0];
+    if (idType == 'nothing' || idType == null) {
+        return { replicationIdentity: 'nothing', replicationColumns: [] };
+    }
+    else if (idType == 'full') {
+        return { replicationIdentity: 'full', replicationColumns: await getAllColumns(db, relationId) };
+    }
+    else if (idType == 'default') {
+        return {
+            replicationIdentity: 'default',
+            replicationColumns: await getPrimaryKeyColumns(db, relationId, 'primary')
+        };
+    }
+    else if (idType == 'index') {
+        return {
+            replicationIdentity: 'index',
+            replicationColumns: await getPrimaryKeyColumns(db, relationId, 'replident')
+        };
+    }
+    else {
+        return { replicationIdentity: 'nothing', replicationColumns: [] };
+    }
+}
+export async function checkSourceConfiguration(db, publicationName) {
+    // Check basic config
+    await pgwire_utils.retriedQuery(db, `DO $$
+BEGIN
+if current_setting('wal_level') is distinct from 'logical' then
+raise exception 'wal_level must be set to ''logical'', your database has it set to ''%''. Please edit your config file and restart PostgreSQL.', current_setting('wal_level');
+end if;
+if (current_setting('max_replication_slots')::int >= 1) is not true then
+raise exception 'Your max_replication_slots setting is too low, it must be greater than 1. Please edit your config file and restart PostgreSQL.';
+end if;
+if (current_setting('max_wal_senders')::int >= 1) is not true then
+raise exception 'Your max_wal_senders setting is too low, it must be greater than 1. Please edit your config file and restart PostgreSQL.';
+end if;
+end;
+$$ LANGUAGE plpgsql;`);
+    // Check that publication exists
+    const rs = await pgwire_utils.retriedQuery(db, {
+        statement: `SELECT * FROM pg_publication WHERE pubname = $1`,
+        params: [{ type: 'varchar', value: publicationName }]
+    });
+    const row = pgwire.pgwireRows(rs)[0];
+    if (row == null) {
+        throw new Error(`Publication '${publicationName}' does not exist. Run: \`CREATE PUBLICATION ${publicationName} FOR ALL TABLES\`, or read the documentation for details.`);
+    }
+    if (row.pubinsert == false || row.pubupdate == false || row.pubdelete == false || row.pubtruncate == false) {
+        throw new Error(`Publication '${publicationName}' does not publish all changes. Create a publication using \`WITH (publish = "insert, update, delete, truncate")\` (the default).`);
+    }
+    if (row.pubviaroot) {
+        throw new Error(`'${publicationName}' uses publish_via_partition_root, which is not supported.`);
+    }
+}
+export async function getDebugTablesInfo(options) {
+    const { db, publicationName, connectionTag, tablePatterns, syncRules } = options;
+    let result = [];
+    for (let tablePattern of tablePatterns) {
+        const schema = tablePattern.schema;
+        let patternResult = {
+            schema: schema,
+            pattern: tablePattern.tablePattern,
+            wildcard: tablePattern.isWildcard
+        };
+        result.push(patternResult);
+        if (tablePattern.isWildcard) {
+            patternResult.tables = [];
+            const prefix = tablePattern.tablePrefix;
+            const results = await util.retriedQuery(db, {
+                statement: `SELECT c.oid AS relid, c.relname AS table_name
+        FROM pg_class c
+        JOIN pg_namespace n ON n.oid = c.relnamespace
+        WHERE n.nspname = $1
+        AND c.relkind = 'r'
+        AND c.relname LIKE $2`,
+                params: [
+                    { type: 'varchar', value: schema },
+                    { type: 'varchar', value: tablePattern.tablePattern }
+                ]
+            });
+            for (let row of pgwire.pgwireRows(results)) {
+                const name = row.table_name;
+                const relationId = row.relid;
+                if (!name.startsWith(prefix)) {
+                    continue;
+                }
+                const details = await getDebugTableInfo({
+                    db,
+                    name,
+                    publicationName,
+                    connectionTag,
+                    tablePattern,
+                    relationId,
+                    syncRules: syncRules
+                });
+                patternResult.tables.push(details);
+            }
+        }
+        else {
+            const results = await util.retriedQuery(db, {
+                statement: `SELECT c.oid AS relid, c.relname AS table_name
+        FROM pg_class c
+        JOIN pg_namespace n ON n.oid = c.relnamespace
+        WHERE n.nspname = $1
+        AND c.relkind = 'r'
+        AND c.relname = $2`,
+                params: [
+                    { type: 'varchar', value: schema },
+                    { type: 'varchar', value: tablePattern.tablePattern }
+                ]
+            });
+            if (results.rows.length == 0) {
+                // Table not found
+                patternResult.table = await getDebugTableInfo({
+                    db,
+                    name: tablePattern.name,
+                    publicationName,
+                    connectionTag,
+                    tablePattern,
+                    relationId: null,
+                    syncRules: syncRules
+                });
+            }
+            else {
+                const row = pgwire.pgwireRows(results)[0];
+                const name = row.table_name;
+                const relationId = row.relid;
+                patternResult.table = await getDebugTableInfo({
+                    db,
+                    name,
+                    publicationName,
+                    connectionTag,
+                    tablePattern,
+                    relationId,
+                    syncRules: syncRules
+                });
+            }
+        }
+    }
+    return result;
+}
+export async function getDebugTableInfo(options) {
+    const { db, name, publicationName, connectionTag, tablePattern, relationId, syncRules } = options;
+    const schema = tablePattern.schema;
+    let id_columns_result = undefined;
+    let id_columns_error = null;
+    if (relationId != null) {
+        try {
+            id_columns_result = await getReplicationIdentityColumns(db, relationId);
+        }
+        catch (e) {
+            id_columns_error = { level: 'fatal', message: e.message };
+        }
+    }
+    const id_columns = id_columns_result?.replicationColumns ?? [];
+    const sourceTable = new storage.SourceTable(0, connectionTag, relationId ?? 0, schema, name, id_columns, true);
+    const syncData = syncRules.tableSyncsData(sourceTable);
+    const syncParameters = syncRules.tableSyncsParameters(sourceTable);
+    if (relationId == null) {
+        return {
+            schema: schema,
+            name: name,
+            pattern: tablePattern.isWildcard ? tablePattern.tablePattern : undefined,
+            replication_id: [],
+            data_queries: syncData,
+            parameter_queries: syncParameters,
+            // Also
+            errors: [{ level: 'warning', message: `Table ${sourceTable.qualifiedName} not found.` }]
+        };
+    }
+    if (id_columns.length == 0 && id_columns_error == null) {
+        let message = `No replication id found for ${sourceTable.qualifiedName}. Replica identity: ${id_columns_result?.replicationIdentity}.`;
+        if (id_columns_result?.replicationIdentity == 'default') {
+            message += ' Configure a primary key on the table.';
+        }
+        id_columns_error = { level: 'fatal', message };
+    }
+    let selectError = null;
+    try {
+        await pg_utils.retriedQuery(db, `SELECT * FROM ${sourceTable.escapedIdentifier} LIMIT 1`);
+    }
+    catch (e) {
+        selectError = { level: 'fatal', message: e.message };
+    }
+    let replicateError = null;
+    const publications = await pg_utils.retriedQuery(db, {
+        statement: `SELECT tablename FROM pg_publication_tables WHERE pubname = $1 AND schemaname = $2 AND tablename = $3`,
+        params: [
+            { type: 'varchar', value: publicationName },
+            { type: 'varchar', value: tablePattern.schema },
+            { type: 'varchar', value: name }
+        ]
+    });
+    if (publications.rows.length == 0) {
+        replicateError = {
+            level: 'fatal',
+            message: `Table ${sourceTable.qualifiedName} is not part of publication '${publicationName}'. Run: \`ALTER PUBLICATION ${publicationName} ADD TABLE ${sourceTable.qualifiedName}\`.`
+        };
+    }
+    return {
+        schema: schema,
+        name: name,
+        pattern: tablePattern.isWildcard ? tablePattern.tablePattern : undefined,
+        replication_id: id_columns.map((c) => c.name),
+        data_queries: syncData,
+        parameter_queries: syncParameters,
+        errors: [id_columns_error, selectError, replicateError].filter((error) => error != null)
+    };
+}
+export async function cleanUpReplicationSlot(slotName, db) {
+    logger.info(`Cleaning up Postgres replication slot: ${slotName}...`);
+    await db.query({
+        statement: 'SELECT pg_drop_replication_slot(slot_name) FROM pg_replication_slots WHERE slot_name = $1',
+        params: [{ type: 'varchar', value: slotName }]
+    });
+}
+//# sourceMappingURL=replication-utils.js.map

package/dist/replication/replication-utils.js.map

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

package/dist/types/types.d.ts

@@ -0,0 +1,76 @@
+import * as t from 'ts-codec';
+export declare const POSTGRES_CONNECTION_TYPE: "postgresql";
+export interface NormalizedPostgresConnectionConfig {
+    id: string;
+    tag: string;
+    hostname: string;
+    port: number;
+    database: string;
+    username: string;
+    password: string;
+    sslmode: 'verify-full' | 'verify-ca' | 'disable';
+    cacert: string | undefined;
+    client_certificate: string | undefined;
+    client_private_key: string | undefined;
+}
+export declare const PostgresConnectionConfig: t.Intersection<t.Codec<{
+    type: string;
+    id?: string | undefined;
+    tag?: string | undefined;
+    debug_api?: boolean | undefined;
+}, {
+    type: string;
+    id?: string | undefined;
+    tag?: string | undefined;
+    debug_api?: boolean | undefined;
+}, string, t.CodecProps>, t.ObjectCodec<{
+    type: t.LiteralCodec<"postgresql">;
+    /** Unique identifier for the connection - optional when a single connection is present. */
+    id: t.OptionalCodec<t.Codec<string, string, string, t.CodecProps>>;
+    /** Tag used as reference in sync rules. Defaults to "default". Does not have to be unique. */
+    tag: t.OptionalCodec<t.Codec<string, string, string, t.CodecProps>>;
+    uri: t.OptionalCodec<t.Codec<string, string, string, t.CodecProps>>;
+    hostname: t.OptionalCodec<t.Codec<string, string, string, t.CodecProps>>;
+    port: t.OptionalCodec<t.Codec<number, string | number, string, t.CodecProps>>;
+    username: t.OptionalCodec<t.Codec<string, string, string, t.CodecProps>>;
+    password: t.OptionalCodec<t.Codec<string, string, string, t.CodecProps>>;
+    database: t.OptionalCodec<t.Codec<string, string, string, t.CodecProps>>;
+    /** Defaults to verify-full */
+    sslmode: t.OptionalCodec<t.Codec<"verify-full" | "verify-ca" | "disable", "verify-full" | "verify-ca" | "disable", string, t.CodecProps>>;
+    /** Required for verify-ca, optional for verify-full */
+    cacert: t.OptionalCodec<t.Codec<string, string, string, t.CodecProps>>;
+    client_certificate: t.OptionalCodec<t.Codec<string, string, string, t.CodecProps>>;
+    client_private_key: t.OptionalCodec<t.Codec<string, string, string, t.CodecProps>>;
+    /** Expose database credentials */
+    demo_database: t.OptionalCodec<t.Codec<boolean, boolean, string, t.CodecProps>>;
+    /**
+     * Prefix for the slot name. Defaults to "powersync_"
+     */
+    slot_name_prefix: t.OptionalCodec<t.Codec<string, string, string, t.CodecProps>>;
+}>>;
+/**
+ * Config input specified when starting services
+ */
+export type PostgresConnectionConfig = t.Decoded<typeof PostgresConnectionConfig>;
+/**
+ * Resolved version of {@link PostgresConnectionConfig}
+ */
+export type ResolvedConnectionConfig = PostgresConnectionConfig & NormalizedPostgresConnectionConfig;
+/**
+ * Validate and normalize connection options.
+ *
+ * Returns destructured options.
+ */
+export declare function normalizeConnectionConfig(options: PostgresConnectionConfig): NormalizedPostgresConnectionConfig;
+/**
+ * Check whether the port is in a "safe" range.
+ *
+ * We do not support connecting to "privileged" ports.
+ */
+export declare function validatePort(port: string | number): number;
+/**
+ * Construct a postgres URI, without username, password or ssl options.
+ *
+ * Only contains hostname, port, database.
+ */
+export declare function baseUri(options: NormalizedPostgresConnectionConfig): string;