@powersync/lib-service-postgres 0.0.0-dev-20250116115804

package/dist/db/connection/DatabaseClient.js.map

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

package/dist/db/connection/WrappedConnection.d.ts

@@ -0,0 +1,9 @@
+import * as pgwire from '@powersync/service-jpgwire';
+import { AbstractPostgresConnection } from './AbstractPostgresConnection.js';
+/**
+ * Provides helper functionality to transaction contexts given an existing PGWire connection
+ */
+export declare class WrappedConnection extends AbstractPostgresConnection {
+    protected baseConnection: pgwire.PgConnection;
+    constructor(baseConnection: pgwire.PgConnection);
+}

package/dist/db/connection/WrappedConnection.js

@@ -0,0 +1,11 @@
+import { AbstractPostgresConnection } from './AbstractPostgresConnection.js';
+/**
+ * Provides helper functionality to transaction contexts given an existing PGWire connection
+ */
+export class WrappedConnection extends AbstractPostgresConnection {
+    constructor(baseConnection) {
+        super();
+        this.baseConnection = baseConnection;
+    }
+}
+//# sourceMappingURL=WrappedConnection.js.map

package/dist/db/connection/WrappedConnection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"WrappedConnection.js","sourceRoot":"","sources":["../../../src/db/connection/WrappedConnection.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,0BAA0B,EAAE,MAAM,iCAAiC,CAAC;AAE7E;;GAEG;AACH,MAAM,OAAO,iBAAkB,SAAQ,0BAA0B;IAC/D,YAAsB,cAAmC;QACvD,KAAK,EAAE,CAAC;QADY,mBAAc,GAAd,cAAc,CAAqB;IAEzD,CAAC;CACF"}

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

@@ -0,0 +1,4 @@
+export * from './connection/AbstractPostgresConnection.js';
+export * from './connection/ConnectionSlot.js';
+export * from './connection/DatabaseClient.js';
+export * from './connection/WrappedConnection.js';

package/dist/db/db-index.js

@@ -0,0 +1,5 @@
+export * from './connection/AbstractPostgresConnection.js';
+export * from './connection/ConnectionSlot.js';
+export * from './connection/DatabaseClient.js';
+export * from './connection/WrappedConnection.js';
+//# sourceMappingURL=db-index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"db-index.js","sourceRoot":"","sources":["../../src/db/db-index.ts"],"names":[],"mappings":"AAAA,cAAc,4CAA4C,CAAC;AAC3D,cAAc,gCAAgC,CAAC;AAC/C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,mCAAmC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+export * from './db/db-index.js';
+export * as db from './db/db-index.js';
+export * from './locks/locks-index.js';
+export * as locks from './locks/locks-index.js';
+export * from './types/types.js';
+export * as types from './types/types.js';
+export * from './utils/utils-index.js';
+export * as utils from './utils/utils-index.js';

package/dist/index.js

@@ -0,0 +1,9 @@
+export * from './db/db-index.js';
+export * as db from './db/db-index.js';
+export * from './locks/locks-index.js';
+export * as locks from './locks/locks-index.js';
+export * from './types/types.js';
+export * as types from './types/types.js';
+export * from './utils/utils-index.js';
+export * as utils from './utils/utils-index.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,OAAO,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAEvC,cAAc,wBAAwB,CAAC;AACvC,OAAO,KAAK,KAAK,MAAM,wBAAwB,CAAC;AAEhD,cAAc,kBAAkB,CAAC;AACjC,OAAO,KAAK,KAAK,MAAM,kBAAkB,CAAC;AAE1C,cAAc,wBAAwB,CAAC;AACvC,OAAO,KAAK,KAAK,MAAM,wBAAwB,CAAC"}

package/dist/locks/PostgresLockManager.d.ts

@@ -0,0 +1,17 @@
+import * as framework from '@powersync/lib-services-framework';
+import { DatabaseClient } from '../db/db-index.js';
+export interface PostgresLockManagerParams extends framework.locks.LockManagerParams {
+    db: DatabaseClient;
+}
+export declare class PostgresLockManager extends framework.locks.AbstractLockManager {
+    protected params: PostgresLockManagerParams;
+    constructor(params: PostgresLockManagerParams);
+    protected get db(): DatabaseClient;
+    get timeout(): number;
+    get name(): string;
+    init(): Promise<void>;
+    protected acquireHandle(): Promise<framework.LockHandle | null>;
+    protected _acquireId(): Promise<string | null>;
+    protected refreshHandle(lockId: string): Promise<void>;
+    protected releaseHandle(lockId: string): Promise<void>;
+}

package/dist/locks/PostgresLockManager.js

@@ -0,0 +1,112 @@
+import * as framework from '@powersync/lib-services-framework';
+import { v4 as uuidv4 } from 'uuid';
+import { sql } from '../db/db-index.js';
+const DEFAULT_LOCK_TIMEOUT = 60000; // 1 minute
+export class PostgresLockManager extends framework.locks.AbstractLockManager {
+    constructor(params) {
+        super(params);
+        this.params = params;
+    }
+    get db() {
+        return this.params.db;
+    }
+    get timeout() {
+        return this.params.timeout ?? DEFAULT_LOCK_TIMEOUT;
+    }
+    get name() {
+        return this.params.name;
+    }
+    async init() {
+        /**
+         * Locks are required for migrations, which means this table can't be
+         * created inside a migration. This ensures the locks table is present.
+         */
+        await this.db.query(sql `
+      CREATE TABLE IF NOT EXISTS locks (
+        name TEXT PRIMARY KEY,
+        lock_id UUID NOT NULL,
+        ts TIMESTAMPTZ NOT NULL
+      );
+    `);
+    }
+    async acquireHandle() {
+        const id = await this._acquireId();
+        if (!id) {
+            return null;
+        }
+        return {
+            refresh: () => this.refreshHandle(id),
+            release: () => this.releaseHandle(id)
+        };
+    }
+    async _acquireId() {
+        const now = new Date();
+        const nowISO = now.toISOString();
+        const expiredTs = new Date(now.getTime() - this.timeout).toISOString();
+        const lockId = uuidv4();
+        try {
+            // Attempt to acquire or refresh the lock
+            const res = await this.db.queryRows(sql `
+        INSERT INTO
+          locks (name, lock_id, ts)
+        VALUES
+          (
+            ${{ type: 'varchar', value: this.name }},
+            ${{ type: 'uuid', value: lockId }},
+            ${{ type: 1184, value: nowISO }}
+          )
+        ON CONFLICT (name) DO UPDATE
+        SET
+          lock_id = CASE
+            WHEN locks.ts <= ${{ type: 1184, value: expiredTs }} THEN ${{ type: 'uuid', value: lockId }}
+            ELSE locks.lock_id
+          END,
+          ts = CASE
+            WHEN locks.ts <= ${{ type: 1184, value: expiredTs }} THEN ${{
+                type: 1184,
+                value: nowISO
+            }}
+            ELSE locks.ts
+          END
+        RETURNING
+          lock_id;
+      `);
+            if (res.length == 0 || res[0].lock_id !== lockId) {
+                // Lock is active and could not be acquired
+                return null;
+            }
+            return lockId;
+        }
+        catch (err) {
+            console.error('Error acquiring lock:', err);
+            throw err;
+        }
+    }
+    async refreshHandle(lockId) {
+        const res = await this.db.query(sql `
+      UPDATE locks
+      SET
+        ts = ${{ type: 1184, value: new Date().toISOString() }}
+      WHERE
+        lock_id = ${{ type: 'uuid', value: lockId }}
+      RETURNING
+        lock_id;
+    `);
+        if (res.rows.length === 0) {
+            throw new Error('Lock not found, could not refresh');
+        }
+    }
+    async releaseHandle(lockId) {
+        const res = await this.db.query(sql `
+      DELETE FROM locks
+      WHERE
+        lock_id = ${{ type: 'uuid', value: lockId }}
+      RETURNING
+        lock_id;
+    `);
+        if (res.rows.length == 0) {
+            throw new Error('Lock not found, could not release');
+        }
+    }
+}
+//# sourceMappingURL=PostgresLockManager.js.map

package/dist/locks/PostgresLockManager.js.map

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

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

@@ -0,0 +1 @@
+export * from './PostgresLockManager.js';

package/dist/locks/locks-index.js

@@ -0,0 +1,2 @@
+export * from './PostgresLockManager.js';
+//# sourceMappingURL=locks-index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"locks-index.js","sourceRoot":"","sources":["../../src/locks/locks-index.ts"],"names":[],"mappings":"AAAA,cAAc,0BAA0B,CAAC"}

package/dist/types/types.d.ts

@@ -0,0 +1,70 @@
+import type * as jpgwire from '@powersync/service-jpgwire';
+import * as t from 'ts-codec';
+export interface NormalizedBasePostgresConnectionConfig extends jpgwire.NormalizedConnectionConfig {
+}
+export declare const POSTGRES_CONNECTION_TYPE: "postgresql";
+export declare const BasePostgresConnectionConfig: t.ObjectCodec<{
+    /** Unique identifier for the connection - optional when a single connection is present. */
+    id: t.OptionalCodec<t.Codec<string, string, string, t.CodecProps>>;
+    /** Additional meta tag for connection */
+    tag: t.OptionalCodec<t.Codec<string, string, string, t.CodecProps>>;
+    type: t.LiteralCodec<"postgresql">;
+    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>>;
+    /** Specify to use a servername for TLS that is different from hostname. */
+    tls_servername: t.OptionalCodec<t.Codec<string, string, string, t.CodecProps>>;
+    /**
+     * Block connections in any of these IP ranges.
+     *
+     * Use 'local' to block anything not in public unicast ranges.
+     */
+    reject_ip_ranges: t.OptionalCodec<t.Codec<string[], string[], string, t.CodecProps>>;
+    /**
+     * Prefix for the slot name. Defaults to "powersync_"
+     */
+    slot_name_prefix: t.OptionalCodec<t.Codec<string, string, string, t.CodecProps>>;
+}>;
+export type BasePostgresConnectionConfig = t.Encoded<typeof BasePostgresConnectionConfig>;
+export type BasePostgresConnectionConfigDecoded = t.Decoded<typeof BasePostgresConnectionConfig>;
+/**
+ * Validate and normalize connection options.
+ *
+ * Returns destructured options.
+ */
+export declare function normalizeConnectionConfig(options: BasePostgresConnectionConfigDecoded): {
+    id: string;
+    tag: string;
+    hostname: string;
+    port: number;
+    database: string;
+    username: string;
+    password: string;
+    sslmode: "verify-full" | "verify-ca" | "disable";
+    cacert: string | undefined;
+    tls_servername: string | undefined;
+    lookup: import("net").LookupFunction | undefined;
+    client_certificate: string | undefined;
+    client_private_key: string | undefined;
+};
+/**
+ * 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: NormalizedBasePostgresConnectionConfig): string;

package/dist/types/types.js

@@ -0,0 +1,119 @@
+import { makeHostnameLookupFunction } from '@powersync/lib-services-framework';
+import * as service_types from '@powersync/service-types';
+import * as t from 'ts-codec';
+import * as urijs from 'uri-js';
+export const POSTGRES_CONNECTION_TYPE = 'postgresql';
+export const BasePostgresConnectionConfig = t.object({
+    /** Unique identifier for the connection - optional when a single connection is present. */
+    id: t.string.optional(),
+    /** Additional meta tag for connection */
+    tag: t.string.optional(),
+    type: t.literal(POSTGRES_CONNECTION_TYPE),
+    uri: t.string.optional(),
+    hostname: t.string.optional(),
+    port: service_types.configFile.portCodec.optional(),
+    username: t.string.optional(),
+    password: t.string.optional(),
+    database: t.string.optional(),
+    /** Defaults to verify-full */
+    sslmode: t.literal('verify-full').or(t.literal('verify-ca')).or(t.literal('disable')).optional(),
+    /** Required for verify-ca, optional for verify-full */
+    cacert: t.string.optional(),
+    client_certificate: t.string.optional(),
+    client_private_key: t.string.optional(),
+    /** Specify to use a servername for TLS that is different from hostname. */
+    tls_servername: t.string.optional(),
+    /**
+     * Block connections in any of these IP ranges.
+     *
+     * Use 'local' to block anything not in public unicast ranges.
+     */
+    reject_ip_ranges: t.array(t.string).optional(),
+    /**
+     * Prefix for the slot name. Defaults to "powersync_"
+     */
+    slot_name_prefix: t.string.optional()
+});
+/**
+ * Validate and normalize connection options.
+ *
+ * Returns destructured options.
+ */
+export function normalizeConnectionConfig(options) {
+    let uri;
+    if (options.uri) {
+        uri = urijs.parse(options.uri);
+        if (uri.scheme != 'postgresql' && uri.scheme != 'postgres') {
+            `Invalid URI - protocol must be postgresql, got ${uri.scheme}`;
+        }
+        else if (uri.scheme != 'postgresql') {
+            uri.scheme = 'postgresql';
+        }
+    }
+    else {
+        uri = urijs.parse('postgresql:///');
+    }
+    const hostname = options.hostname ?? uri.host ?? '';
+    const port = validatePort(options.port ?? uri.port ?? 5432);
+    const database = options.database ?? uri.path?.substring(1) ?? '';
+    const [uri_username, uri_password] = (uri.userinfo ?? '').split(':');
+    const username = options.username ?? uri_username ?? '';
+    const password = options.password ?? uri_password ?? '';
+    const sslmode = options.sslmode ?? 'verify-full'; // Configuration not supported via URI
+    const cacert = options.cacert;
+    if (sslmode == 'verify-ca' && cacert == null) {
+        throw new Error('Explicit cacert is required for sslmode=verify-ca');
+    }
+    if (hostname == '') {
+        throw new Error(`hostname required`);
+    }
+    if (username == '') {
+        throw new Error(`username required`);
+    }
+    if (password == '') {
+        throw new Error(`password required`);
+    }
+    if (database == '') {
+        throw new Error(`database required`);
+    }
+    const lookupOptions = { reject_ip_ranges: options.reject_ip_ranges ?? [] };
+    const lookup = makeHostnameLookupFunction(hostname, lookupOptions);
+    return {
+        id: options.id ?? 'default',
+        tag: options.tag ?? 'default',
+        hostname,
+        port,
+        database,
+        username,
+        password,
+        sslmode,
+        cacert,
+        tls_servername: options.tls_servername ?? undefined,
+        lookup,
+        client_certificate: options.client_certificate ?? undefined,
+        client_private_key: options.client_private_key ?? undefined
+    };
+}
+/**
+ * Check whether the port is in a "safe" range.
+ *
+ * We do not support connecting to "privileged" ports.
+ */
+export function validatePort(port) {
+    if (typeof port == 'string') {
+        port = parseInt(port);
+    }
+    if (port < 1024) {
+        throw new Error(`Port ${port} not supported`);
+    }
+    return port;
+}
+/**
+ * Construct a postgres URI, without username, password or ssl options.
+ *
+ * Only contains hostname, port, database.
+ */
+export function baseUri(options) {
+    return `postgresql://${options.hostname}:${options.port}/${options.database}`;
+}
+//# sourceMappingURL=types.js.map

package/dist/types/types.js.map

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

package/dist/utils/pgwire_utils.d.ts

@@ -0,0 +1,5 @@
+import * as pgwire from '@powersync/service-jpgwire';
+export declare function escapeIdentifier(identifier: string): string;
+export declare function autoParameter(arg: any): pgwire.StatementParam;
+export declare function retriedQuery(db: pgwire.PgClient, ...statements: pgwire.Statement[]): Promise<pgwire.PgResult>;
+export declare function retriedQuery(db: pgwire.PgClient, query: string): Promise<pgwire.PgResult>;

package/dist/utils/pgwire_utils.js

@@ -0,0 +1,47 @@
+// Adapted from https://github.com/kagis/pgwire/blob/0dc927f9f8990a903f238737326e53ba1c8d094f/mod.js#L2218
+import { logger } from '@powersync/lib-services-framework';
+export function escapeIdentifier(identifier) {
+    return `"${identifier.replace(/"/g, '""').replace(/\./g, '"."')}"`;
+}
+export function autoParameter(arg) {
+    if (arg == null) {
+        return { type: 'varchar', value: null };
+    }
+    else if (typeof arg == 'string') {
+        return { type: 'varchar', value: arg };
+    }
+    else if (typeof arg == 'number') {
+        if (Number.isInteger(arg)) {
+            return { type: 'int8', value: arg };
+        }
+        else {
+            return { type: 'float8', value: arg };
+        }
+    }
+    else if (typeof arg == 'boolean') {
+        return { type: 'bool', value: arg };
+    }
+    else if (typeof arg == 'bigint') {
+        return { type: 'int8', value: arg };
+    }
+    else {
+        throw new Error(`Unsupported query parameter: ${typeof arg}`);
+    }
+}
+/**
+ * Retry a simple query - up to 2 attempts total.
+ */
+export async function retriedQuery(db, ...args) {
+    for (let tries = 2;; tries--) {
+        try {
+            return await db.query(...args);
+        }
+        catch (e) {
+            if (tries == 1) {
+                throw e;
+            }
+            logger.warn('Query error, retrying', e);
+        }
+    }
+}
+//# sourceMappingURL=pgwire_utils.js.map

package/dist/utils/pgwire_utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pgwire_utils.js","sourceRoot":"","sources":["../../src/utils/pgwire_utils.ts"],"names":[],"mappings":"AAAA,0GAA0G;AAI1G,OAAO,EAAE,MAAM,EAAE,MAAM,mCAAmC,CAAC;AAE3D,MAAM,UAAU,gBAAgB,CAAC,UAAkB;IACjD,OAAO,IAAI,UAAU,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC;AACrE,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,GAAQ;IACpC,IAAI,GAAG,IAAI,IAAI,EAAE,CAAC;QAChB,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;IAC1C,CAAC;SAAM,IAAI,OAAO,GAAG,IAAI,QAAQ,EAAE,CAAC;QAClC,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC;IACzC,CAAC;SAAM,IAAI,OAAO,GAAG,IAAI,QAAQ,EAAE,CAAC;QAClC,IAAI,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC;YAC1B,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC;QACtC,CAAC;aAAM,CAAC;YACN,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC;QACxC,CAAC;IACH,CAAC;SAAM,IAAI,OAAO,GAAG,IAAI,SAAS,EAAE,CAAC;QACnC,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC;IACtC,CAAC;SAAM,IAAI,OAAO,GAAG,IAAI,QAAQ,EAAE,CAAC;QAClC,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC;IACtC,CAAC;SAAM,CAAC;QACN,MAAM,IAAI,KAAK,CAAC,gCAAgC,OAAO,GAAG,EAAE,CAAC,CAAC;IAChE,CAAC;AACH,CAAC;AAKD;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,EAAmB,EAAE,GAAG,IAAW;IACpE,KAAK,IAAI,KAAK,GAAG,CAAC,GAAI,KAAK,EAAE,EAAE,CAAC;QAC9B,IAAI,CAAC;YACH,OAAO,MAAM,EAAE,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,CAAC;QACjC,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;gBACf,MAAM,CAAC,CAAC;YACV,CAAC;YACD,MAAM,CAAC,IAAI,CAAC,uBAAuB,EAAE,CAAC,CAAC,CAAC;QAC1C,CAAC;IACH,CAAC;AACH,CAAC"}

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

@@ -0,0 +1 @@
+export * from './pgwire_utils.js';

package/dist/utils/utils-index.js

@@ -0,0 +1,2 @@
+export * from './pgwire_utils.js';
+//# sourceMappingURL=utils-index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"utils-index.js","sourceRoot":"","sources":["../../src/utils/utils-index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC"}

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@powersync/lib-service-postgres",
+  "repository": "https://github.com/powersync-ja/powersync-service",
+  "types": "dist/index.d.ts",
+  "version": "0.0.0-dev-20250116115804",
+  "main": "dist/index.js",
+  "license": "FSL-1.1-Apache-2.0",
+  "type": "module",
+  "publishConfig": {
+    "access": "public"
+  },
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "require": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./types": {
+      "import": "./dist/types/types.js",
+      "require": "./dist/types/types.js",
+      "default": "./dist/types/types.js"
+    }
+  },
+  "dependencies": {
+    "p-defer": "^4.0.1",
+    "ts-codec": "^1.3.0",
+    "uri-js": "^4.4.1",
+    "uuid": "^9.0.1",
+    "@powersync/lib-services-framework": "0.0.0-dev-20250116115804",
+    "@powersync/service-jpgwire": "0.0.0-dev-20250116115804",
+    "@powersync/service-types": "0.0.0-dev-20250116115804"
+  },
+  "devDependencies": {
+    "@types/uuid": "^9.0.4"
+  },
+  "scripts": {
+    "build": "tsc -b",
+    "build:tests": "tsc -b test/tsconfig.json",
+    "clean": "rm -rf ./dist && tsc -b --clean",
+    "test": "vitest"
+  }
+}

package/src/db/connection/AbstractPostgresConnection.ts

@@ -0,0 +1,109 @@
+import * as framework from '@powersync/lib-services-framework';
+import * as pgwire from '@powersync/service-jpgwire';
+import * as t from 'ts-codec';
+
+export type DecodedSQLQueryExecutor<T extends t.Codec<any, any>> = {
+  first: () => Promise<t.Decoded<T> | null>;
+  rows: () => Promise<t.Decoded<T>[]>;
+};
+
+export abstract class AbstractPostgresConnection<
+  Listener extends framework.DisposableListener = framework.DisposableListener
+> extends framework.DisposableObserver<Listener> {
+  protected abstract baseConnection: pgwire.PgClient;
+
+  stream(...args: pgwire.Statement[]): AsyncIterableIterator<pgwire.PgChunk> {
+    return this.baseConnection.stream(...args);
+  }
+
+  query(script: string, options?: pgwire.PgSimpleQueryOptions): Promise<pgwire.PgResult>;
+  query(...args: pgwire.Statement[]): Promise<pgwire.PgResult>;
+  query(...args: any[]): Promise<pgwire.PgResult> {
+    return this.baseConnection.query(...args);
+  }
+
+  /**
+   * Template string helper which can be used to execute template SQL strings.
+   */
+  sql(strings: TemplateStringsArray, ...params: pgwire.StatementParam[]) {
+    const { statement, params: queryParams } = sql(strings, ...params);
+
+    const rows = <T>(): Promise<T[]> =>
+      this.queryRows({
+        statement,
+        params: queryParams
+      });
+
+    const first = async <T>(): Promise<T | null> => {
+      const [f] = await rows<T>();
+      return f;
+    };
+
+    return {
+      execute: () =>
+        this.query({
+          statement,
+          params
+        }),
+      rows,
+      first,
+      decoded: <T extends t.Codec<any, any>>(codec: T): DecodedSQLQueryExecutor<T> => {
+        return {
+          first: async () => {
+            const result = await first();
+            return result && codec.decode(result);
+          },
+          rows: async () => {
+            const results = await rows();
+            return results.map((r) => {
+              return codec.decode(r);
+            });
+          }
+        };
+      }
+    };
+  }
+
+  queryRows<T>(script: string, options?: pgwire.PgSimpleQueryOptions): Promise<T[]>;
+  queryRows<T>(...args: pgwire.Statement[] | [...pgwire.Statement[], pgwire.PgExtendedQueryOptions]): Promise<T[]>;
+  async queryRows(...args: any[]) {
+    return pgwire.pgwireRows(await this.query(...args));
+  }
+
+  async *streamRows<T>(...args: pgwire.Statement[]): AsyncIterableIterator<T[]> {
+    let columns: Array<keyof T> = [];
+
+    for await (const chunk of this.stream(...args)) {
+      if (chunk.tag == 'RowDescription') {
+        columns = chunk.payload.map((c, index) => {
+          return c.name as keyof T;
+        });
+        continue;
+      }
+
+      if (!chunk.rows.length) {
+        continue;
+      }
+
+      yield chunk.rows.map((row) => {
+        let q: Partial<T> = {};
+        for (const [index, c] of columns.entries()) {
+          q[c] = row[index];
+        }
+        return q as T;
+      });
+    }
+  }
+}
+
+/**
+ * Template string helper function which generates PGWire statements.
+ */
+export const sql = (strings: TemplateStringsArray, ...params: pgwire.StatementParam[]): pgwire.Statement => {
+  const paramPlaceholders = new Array(params.length).fill('').map((value, index) => `$${index + 1}`);
+  const joinedQueryStatement = strings.map((query, index) => `${query} ${paramPlaceholders[index] ?? ''}`).join(' ');
+  return {
+    statement: joinedQueryStatement,
+    params
+  };
+};