@syncular/server-dialect-postgres 0.0.1-60

package/dist/index.d.ts

@@ -0,0 +1,103 @@
+/**
+ * @syncular/server-dialect-postgres - PostgreSQL Server Sync Dialect
+ *
+ * Driver-agnostic PostgreSQL dialect for sync. Works with any Postgres-compatible
+ * Kysely dialect (pg, pglite, neon, etc.).
+ *
+ * Tables:
+ * - sync_commits: commit log (idempotency + ordering)
+ * - sync_table_commits: commit routing index (fast pull by table)
+ * - sync_changes: change log (JSONB scopes for filtering)
+ * - sync_client_cursors: per-client cursor tracking (pruning/observability)
+ */
+import type { ScopeValues, StoredScopes, SyncOp } from '@syncular/core';
+import type { DbExecutor, ServerSyncDialect } from '@syncular/server';
+import type { SyncChangeRow, SyncCommitRow, SyncCoreDb } from '@syncular/server/schema';
+import type { Kysely, Transaction } from 'kysely';
+export declare class PostgresServerSyncDialect implements ServerSyncDialect {
+    readonly name: "postgres";
+    readonly supportsForUpdate = true;
+    readonly supportsSavepoints = true;
+    ensureSyncSchema<DB extends SyncCoreDb>(db: Kysely<DB>): Promise<void>;
+    executeInTransaction<DB extends SyncCoreDb, T>(db: Kysely<DB>, fn: (executor: DbExecutor<DB>) => Promise<T>): Promise<T>;
+    setRepeatableRead<DB extends SyncCoreDb>(trx: DbExecutor<DB>): Promise<void>;
+    readMaxCommitSeq<DB extends SyncCoreDb>(db: Kysely<DB> | Transaction<DB>, options?: {
+        partitionId?: string;
+    }): Promise<number>;
+    readMinCommitSeq<DB extends SyncCoreDb>(db: Kysely<DB> | Transaction<DB>, options?: {
+        partitionId?: string;
+    }): Promise<number>;
+    readCommitSeqsForPull<DB extends SyncCoreDb>(db: Kysely<DB> | Transaction<DB>, args: {
+        cursor: number;
+        limitCommits: number;
+        tables: string[];
+        partitionId?: string;
+    }): Promise<number[]>;
+    readCommits<DB extends SyncCoreDb>(db: Kysely<DB> | Transaction<DB>, commitSeqs: number[], options?: {
+        partitionId?: string;
+    }): Promise<SyncCommitRow[]>;
+    readChangesForCommits<DB extends SyncCoreDb>(db: Kysely<DB> | Transaction<DB>, args: {
+        commitSeqs: number[];
+        table: string;
+        scopes: ScopeValues;
+        partitionId?: string;
+    }): Promise<SyncChangeRow[]>;
+    readIncrementalPullRows<DB extends SyncCoreDb>(db: Kysely<DB> | Transaction<DB>, args: {
+        table: string;
+        scopes: ScopeValues;
+        cursor: number;
+        limitCommits: number;
+        partitionId?: string;
+    }): Promise<Array<{
+        commit_seq: number;
+        actor_id: string;
+        created_at: string;
+        change_id: number;
+        table: string;
+        row_id: string;
+        op: SyncOp;
+        row_json: unknown | null;
+        row_version: number | null;
+        scopes: StoredScopes;
+    }>>;
+    streamIncrementalPullRows<DB extends SyncCoreDb>(db: Kysely<DB> | Transaction<DB>, args: {
+        table: string;
+        scopes: ScopeValues;
+        cursor: number;
+        limitCommits: number;
+        batchSize?: number;
+        partitionId?: string;
+    }): AsyncGenerator<{
+        commit_seq: number;
+        actor_id: string;
+        created_at: string;
+        change_id: number;
+        table: string;
+        row_id: string;
+        op: SyncOp;
+        row_json: unknown | null;
+        row_version: number | null;
+        scopes: StoredScopes;
+    }>;
+    compactChanges<DB extends SyncCoreDb>(db: Kysely<DB> | Transaction<DB>, args: {
+        fullHistoryHours: number;
+    }): Promise<number>;
+    recordClientCursor<DB extends SyncCoreDb>(db: Kysely<DB> | Transaction<DB>, args: {
+        partitionId?: string;
+        clientId: string;
+        actorId: string;
+        cursor: number;
+        effectiveScopes: ScopeValues;
+    }): Promise<void>;
+    scopesToDb(scopes: StoredScopes): StoredScopes;
+    dbToScopes(value: unknown): StoredScopes;
+    dbToArray(value: unknown): string[];
+    arrayToDb(values: string[]): string[];
+    readAffectedTablesFromChanges<DB extends SyncCoreDb>(db: Kysely<DB> | Transaction<DB>, commitSeq: number, options?: {
+        partitionId?: string;
+    }): Promise<string[]>;
+    ensureConsoleSchema<DB extends SyncCoreDb>(db: Kysely<DB>): Promise<void>;
+    private ensureIndex;
+}
+export declare function createPostgresServerDialect(): PostgresServerSyncDialect;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,564 @@
+/**
+ * @syncular/server-dialect-postgres - PostgreSQL Server Sync Dialect
+ *
+ * Driver-agnostic PostgreSQL dialect for sync. Works with any Postgres-compatible
+ * Kysely dialect (pg, pglite, neon, etc.).
+ *
+ * Tables:
+ * - sync_commits: commit log (idempotency + ordering)
+ * - sync_table_commits: commit routing index (fast pull by table)
+ * - sync_changes: change log (JSONB scopes for filtering)
+ * - sync_client_cursors: per-client cursor tracking (pruning/observability)
+ */
+import { sql } from 'kysely';
+function coerceNumber(value) {
+    if (value === null || value === undefined)
+        return null;
+    if (typeof value === 'number')
+        return Number.isFinite(value) ? value : null;
+    if (typeof value === 'bigint')
+        return Number.isFinite(Number(value)) ? Number(value) : null;
+    if (typeof value === 'string') {
+        const n = Number(value);
+        return Number.isFinite(n) ? n : null;
+    }
+    return null;
+}
+function coerceIsoString(value) {
+    if (typeof value === 'string')
+        return value;
+    if (value instanceof Date)
+        return value.toISOString();
+    return String(value);
+}
+function parseScopes(value) {
+    if (value === null || value === undefined)
+        return {};
+    if (typeof value === 'object' && !Array.isArray(value)) {
+        const result = {};
+        for (const [k, v] of Object.entries(value)) {
+            if (typeof v === 'string') {
+                result[k] = v;
+            }
+        }
+        return result;
+    }
+    return {};
+}
+export class PostgresServerSyncDialect {
+    name = 'postgres';
+    supportsForUpdate = true;
+    supportsSavepoints = true;
+    // ===========================================================================
+    // Schema Setup
+    // ===========================================================================
+    async ensureSyncSchema(db) {
+        await db.schema
+            .createTable('sync_commits')
+            .ifNotExists()
+            .addColumn('commit_seq', 'bigserial', (col) => col.primaryKey())
+            .addColumn('partition_id', 'text', (col) => col.notNull().defaultTo('default'))
+            .addColumn('actor_id', 'text', (col) => col.notNull())
+            .addColumn('client_id', 'text', (col) => col.notNull())
+            .addColumn('client_commit_id', 'text', (col) => col.notNull())
+            .addColumn('created_at', 'timestamptz', (col) => col.notNull().defaultTo(sql `now()`))
+            .addColumn('meta', 'jsonb')
+            .addColumn('result_json', 'jsonb')
+            .addColumn('change_count', 'integer', (col) => col.notNull().defaultTo(0))
+            .addColumn('affected_tables', sql `text[]`, (col) => col.notNull().defaultTo(sql `ARRAY[]::text[]`))
+            .execute();
+        // Ensure new columns exist for dev environments that already created the table.
+        await sql `ALTER TABLE sync_commits
+      ADD COLUMN IF NOT EXISTS change_count integer NOT NULL DEFAULT 0`.execute(db);
+        await sql `ALTER TABLE sync_commits
+      ADD COLUMN IF NOT EXISTS affected_tables text[] NOT NULL DEFAULT ARRAY[]::text[]`.execute(db);
+        await sql `ALTER TABLE sync_commits
+      ADD COLUMN IF NOT EXISTS partition_id text NOT NULL DEFAULT 'default'`.execute(db);
+        await sql `DROP INDEX IF EXISTS idx_sync_commits_client_commit`.execute(db);
+        await db.schema
+            .createIndex('idx_sync_commits_client_commit')
+            .ifNotExists()
+            .on('sync_commits')
+            .columns(['partition_id', 'client_id', 'client_commit_id'])
+            .unique()
+            .execute();
+        // Table-based commit routing index
+        await db.schema
+            .createTable('sync_table_commits')
+            .ifNotExists()
+            .addColumn('partition_id', 'text', (col) => col.notNull().defaultTo('default'))
+            .addColumn('table', 'text', (col) => col.notNull())
+            .addColumn('commit_seq', 'bigint', (col) => col.notNull().references('sync_commits.commit_seq').onDelete('cascade'))
+            .addPrimaryKeyConstraint('sync_table_commits_pk', [
+            'partition_id',
+            'table',
+            'commit_seq',
+        ])
+            .execute();
+        await sql `ALTER TABLE sync_table_commits
+      ADD COLUMN IF NOT EXISTS partition_id text NOT NULL DEFAULT 'default'`.execute(db);
+        await db.schema
+            .createIndex('idx_sync_table_commits_commit_seq')
+            .ifNotExists()
+            .on('sync_table_commits')
+            .columns(['partition_id', 'commit_seq'])
+            .execute();
+        // Changes table with JSONB scopes
+        await db.schema
+            .createTable('sync_changes')
+            .ifNotExists()
+            .addColumn('change_id', 'bigserial', (col) => col.primaryKey())
+            .addColumn('partition_id', 'text', (col) => col.notNull().defaultTo('default'))
+            .addColumn('commit_seq', 'bigint', (col) => col.notNull().references('sync_commits.commit_seq').onDelete('cascade'))
+            .addColumn('table', 'text', (col) => col.notNull())
+            .addColumn('row_id', 'text', (col) => col.notNull())
+            .addColumn('op', 'text', (col) => col.notNull())
+            .addColumn('row_json', 'jsonb')
+            .addColumn('row_version', 'bigint')
+            .addColumn('scopes', 'jsonb', (col) => col.notNull())
+            .execute();
+        await sql `ALTER TABLE sync_changes
+      ADD COLUMN IF NOT EXISTS partition_id text NOT NULL DEFAULT 'default'`.execute(db);
+        await db.schema
+            .createIndex('idx_sync_changes_commit_seq')
+            .ifNotExists()
+            .on('sync_changes')
+            .columns(['partition_id', 'commit_seq'])
+            .execute();
+        await db.schema
+            .createIndex('idx_sync_changes_table')
+            .ifNotExists()
+            .on('sync_changes')
+            .columns(['partition_id', 'table'])
+            .execute();
+        await this.ensureIndex(db, 'idx_sync_changes_scopes', 'CREATE INDEX idx_sync_changes_scopes ON sync_changes USING GIN (scopes)');
+        await db.schema
+            .createTable('sync_client_cursors')
+            .ifNotExists()
+            .addColumn('partition_id', 'text', (col) => col.notNull().defaultTo('default'))
+            .addColumn('client_id', 'text', (col) => col.notNull())
+            .addColumn('actor_id', 'text', (col) => col.notNull())
+            .addColumn('cursor', 'bigint', (col) => col.notNull().defaultTo(0))
+            .addColumn('effective_scopes', 'jsonb', (col) => col.notNull().defaultTo(sql `'{}'::jsonb`))
+            .addColumn('updated_at', 'timestamptz', (col) => col.notNull().defaultTo(sql `now()`))
+            .addPrimaryKeyConstraint('sync_client_cursors_pk', [
+            'partition_id',
+            'client_id',
+        ])
+            .execute();
+        await sql `ALTER TABLE sync_client_cursors
+      ADD COLUMN IF NOT EXISTS partition_id text NOT NULL DEFAULT 'default'`.execute(db);
+        await db.schema
+            .createIndex('idx_sync_client_cursors_updated_at')
+            .ifNotExists()
+            .on('sync_client_cursors')
+            .columns(['updated_at'])
+            .execute();
+        await db.schema
+            .createTable('sync_snapshot_chunks')
+            .ifNotExists()
+            .addColumn('chunk_id', 'text', (col) => col.primaryKey())
+            .addColumn('partition_id', 'text', (col) => col.notNull().defaultTo('default'))
+            .addColumn('scope_key', 'text', (col) => col.notNull())
+            .addColumn('scope', 'text', (col) => col.notNull())
+            .addColumn('as_of_commit_seq', 'bigint', (col) => col.notNull())
+            .addColumn('row_cursor', 'text', (col) => col.notNull().defaultTo(''))
+            .addColumn('row_limit', 'integer', (col) => col.notNull())
+            .addColumn('encoding', 'text', (col) => col.notNull())
+            .addColumn('compression', 'text', (col) => col.notNull())
+            .addColumn('sha256', 'text', (col) => col.notNull())
+            .addColumn('byte_length', 'integer', (col) => col.notNull())
+            .addColumn('blob_hash', 'text', (col) => col.notNull().defaultTo(''))
+            .addColumn('body', 'bytea') // Deprecated: use blob storage
+            .addColumn('created_at', 'timestamptz', (col) => col.notNull().defaultTo(sql `now()`))
+            .addColumn('expires_at', 'timestamptz', (col) => col.notNull())
+            .execute();
+        await sql `ALTER TABLE sync_snapshot_chunks
+      ADD COLUMN IF NOT EXISTS partition_id text NOT NULL DEFAULT 'default'`.execute(db);
+        await db.schema
+            .createIndex('idx_sync_snapshot_chunks_expires_at')
+            .ifNotExists()
+            .on('sync_snapshot_chunks')
+            .columns(['expires_at'])
+            .execute();
+        await db.schema
+            .createIndex('idx_sync_snapshot_chunks_page_key')
+            .ifNotExists()
+            .on('sync_snapshot_chunks')
+            .columns([
+            'partition_id',
+            'scope_key',
+            'scope',
+            'as_of_commit_seq',
+            'row_cursor',
+            'row_limit',
+            'encoding',
+            'compression',
+        ])
+            .unique()
+            .execute();
+    }
+    // ===========================================================================
+    // Transaction Control
+    // ===========================================================================
+    async executeInTransaction(db, fn) {
+        return db.transaction().execute(fn);
+    }
+    async setRepeatableRead(trx) {
+        await sql `SET TRANSACTION ISOLATION LEVEL REPEATABLE READ`.execute(trx);
+    }
+    // ===========================================================================
+    // Commit/Change Log Queries
+    // ===========================================================================
+    async readMaxCommitSeq(db, options) {
+        const partitionId = options?.partitionId ?? 'default';
+        const res = await sql `
+      SELECT max(commit_seq) as max_seq
+      FROM sync_commits
+      WHERE partition_id = ${partitionId}
+    `.execute(db);
+        return coerceNumber(res.rows[0]?.max_seq) ?? 0;
+    }
+    async readMinCommitSeq(db, options) {
+        const partitionId = options?.partitionId ?? 'default';
+        const res = await sql `
+      SELECT min(commit_seq) as min_seq
+      FROM sync_commits
+      WHERE partition_id = ${partitionId}
+    `.execute(db);
+        return coerceNumber(res.rows[0]?.min_seq) ?? 0;
+    }
+    async readCommitSeqsForPull(db, args) {
+        const partitionId = args.partitionId ?? 'default';
+        if (args.tables.length === 0)
+            return [];
+        if (args.tables.length === 1) {
+            const res = await sql `
+        SELECT commit_seq
+        FROM sync_table_commits
+        WHERE partition_id = ${partitionId}
+          AND "table" = ${args.tables[0]}
+          AND commit_seq > ${args.cursor}
+        ORDER BY commit_seq ASC
+        LIMIT ${args.limitCommits}
+      `.execute(db);
+            return res.rows
+                .map((r) => coerceNumber(r.commit_seq))
+                .filter((n) => typeof n === 'number' && Number.isFinite(n) && n > args.cursor);
+        }
+        const res = await sql `
+      SELECT DISTINCT commit_seq
+      FROM sync_table_commits
+      WHERE partition_id = ${partitionId}
+        AND "table" = ANY(${args.tables}::text[])
+        AND commit_seq > ${args.cursor}
+      ORDER BY commit_seq ASC
+      LIMIT ${args.limitCommits}
+    `.execute(db);
+        return res.rows
+            .map((r) => coerceNumber(r.commit_seq))
+            .filter((n) => typeof n === 'number' && Number.isFinite(n) && n > args.cursor);
+    }
+    async readCommits(db, commitSeqs, options) {
+        const partitionId = options?.partitionId ?? 'default';
+        if (commitSeqs.length === 0)
+            return [];
+        const res = await sql `
+      SELECT commit_seq, actor_id, created_at, result_json
+      FROM sync_commits
+      WHERE commit_seq = ANY(${commitSeqs}::bigint[])
+        AND partition_id = ${partitionId}
+      ORDER BY commit_seq ASC
+    `.execute(db);
+        return res.rows.map((row) => ({
+            commit_seq: coerceNumber(row.commit_seq) ?? 0,
+            actor_id: row.actor_id,
+            created_at: coerceIsoString(row.created_at),
+            result_json: row.result_json ?? null,
+        }));
+    }
+    async readChangesForCommits(db, args) {
+        const partitionId = args.partitionId ?? 'default';
+        if (args.commitSeqs.length === 0)
+            return [];
+        // Build JSONB containment conditions for scope filtering
+        // For each scope key/value, we need: scopes->>'key' = 'value' OR scopes->>'key' IN (values)
+        const scopeConditions = [];
+        for (const [key, value] of Object.entries(args.scopes)) {
+            if (Array.isArray(value)) {
+                // OR condition for array values
+                scopeConditions.push(sql `scopes->>${key} = ANY(${value}::text[])`);
+            }
+            else {
+                scopeConditions.push(sql `scopes->>${key} = ${value}`);
+            }
+        }
+        let query = sql `
+      SELECT commit_seq, "table", row_id, op, row_json, row_version, scopes
+      FROM sync_changes
+      WHERE commit_seq = ANY(${args.commitSeqs}::bigint[])
+        AND partition_id = ${partitionId}
+        AND "table" = ${args.table}
+    `;
+        if (scopeConditions.length > 0) {
+            const scopeFilter = sql.join(scopeConditions, sql ` AND `);
+            query = sql `
+        SELECT commit_seq, "table", row_id, op, row_json, row_version, scopes
+        FROM sync_changes
+        WHERE commit_seq = ANY(${args.commitSeqs}::bigint[])
+          AND partition_id = ${partitionId}
+          AND "table" = ${args.table}
+          AND (${scopeFilter})
+        ORDER BY commit_seq ASC, change_id ASC
+      `;
+        }
+        const res = await query.execute(db);
+        return res.rows.map((row) => ({
+            commit_seq: coerceNumber(row.commit_seq) ?? 0,
+            table: row.table,
+            row_id: row.row_id,
+            op: row.op,
+            row_json: row.row_json ?? null,
+            row_version: coerceNumber(row.row_version),
+            scopes: parseScopes(row.scopes),
+        }));
+    }
+    async readIncrementalPullRows(db, args) {
+        const partitionId = args.partitionId ?? 'default';
+        const limitCommits = Math.max(1, Math.min(500, args.limitCommits));
+        // Build scope filter conditions
+        const scopeConditions = [];
+        for (const [key, value] of Object.entries(args.scopes)) {
+            if (Array.isArray(value)) {
+                scopeConditions.push(sql `c.scopes->>${key} = ANY(${value}::text[])`);
+            }
+            else {
+                scopeConditions.push(sql `c.scopes->>${key} = ${value}`);
+            }
+        }
+        const scopeFilter = scopeConditions.length > 0
+            ? sql.join(scopeConditions, sql ` AND `)
+            : sql `TRUE`;
+        const res = await sql `
+      WITH commit_seqs AS (
+        SELECT DISTINCT tc.commit_seq
+        FROM sync_table_commits tc
+        JOIN sync_commits cm ON cm.commit_seq = tc.commit_seq
+        WHERE tc.partition_id = ${partitionId}
+          AND tc."table" = ${args.table}
+          AND cm.partition_id = ${partitionId}
+          AND tc.commit_seq > ${args.cursor}
+          AND EXISTS (
+            SELECT 1
+            FROM sync_changes c
+            WHERE c.commit_seq = tc.commit_seq
+              AND c.partition_id = ${partitionId}
+              AND c."table" = ${args.table}
+              AND (${scopeFilter})
+          )
+        ORDER BY tc.commit_seq ASC
+        LIMIT ${limitCommits}
+      )
+      SELECT
+        cm.commit_seq,
+        cm.actor_id,
+        cm.created_at,
+        c.change_id,
+        c."table",
+        c.row_id,
+        c.op,
+        c.row_json,
+        c.row_version,
+        c.scopes
+      FROM commit_seqs cs
+      JOIN sync_commits cm ON cm.commit_seq = cs.commit_seq
+      JOIN sync_changes c ON c.commit_seq = cs.commit_seq
+      WHERE cm.partition_id = ${partitionId}
+        AND c.partition_id = ${partitionId}
+        AND c."table" = ${args.table}
+        AND (${scopeFilter})
+      ORDER BY cm.commit_seq ASC, c.change_id ASC
+    `.execute(db);
+        return res.rows.map((row) => ({
+            commit_seq: coerceNumber(row.commit_seq) ?? 0,
+            actor_id: row.actor_id,
+            created_at: coerceIsoString(row.created_at),
+            change_id: coerceNumber(row.change_id) ?? 0,
+            table: row.table,
+            row_id: row.row_id,
+            op: row.op,
+            row_json: row.row_json ?? null,
+            row_version: coerceNumber(row.row_version),
+            scopes: parseScopes(row.scopes),
+        }));
+    }
+    async *streamIncrementalPullRows(db, args) {
+        // PostgreSQL: use batching approach (could use pg-query-stream for true streaming)
+        const batchSize = Math.min(100, args.batchSize ?? 100);
+        let processed = 0;
+        while (processed < args.limitCommits) {
+            const batch = await this.readIncrementalPullRows(db, {
+                ...args,
+                limitCommits: Math.min(batchSize, args.limitCommits - processed),
+                cursor: args.cursor + processed,
+            });
+            if (batch.length === 0)
+                break;
+            for (const row of batch) {
+                yield row;
+            }
+            processed += batch.length;
+            if (batch.length < batchSize)
+                break;
+        }
+    }
+    async compactChanges(db, args) {
+        const cutoffIso = new Date(Date.now() - args.fullHistoryHours * 60 * 60 * 1000).toISOString();
+        const res = await sql `
+      WITH ranked AS (
+        SELECT
+          c.change_id,
+          row_number() OVER (
+            PARTITION BY c.partition_id, c."table", c.row_id, c.scopes
+            ORDER BY c.commit_seq DESC, c.change_id DESC
+          ) AS rn
+        FROM sync_changes c
+        JOIN sync_commits cm ON cm.commit_seq = c.commit_seq
+        WHERE cm.created_at < ${cutoffIso}
+      )
+      DELETE FROM sync_changes
+      WHERE change_id IN (SELECT change_id FROM ranked WHERE rn > 1)
+    `.execute(db);
+        const deletedChanges = Number(res.numAffectedRows ?? 0);
+        // Remove routing index entries that no longer have any remaining changes
+        await sql `
+      DELETE FROM sync_table_commits tc
+      USING sync_commits cm
+        WHERE cm.commit_seq = tc.commit_seq
+          AND cm.partition_id = tc.partition_id
+          AND cm.created_at < ${cutoffIso}
+        AND NOT EXISTS (
+          SELECT 1
+          FROM sync_changes c
+          WHERE c.commit_seq = tc.commit_seq
+            AND c.partition_id = tc.partition_id
+            AND c."table" = tc."table"
+        )
+    `.execute(db);
+        return deletedChanges;
+    }
+    // ===========================================================================
+    // Client Cursor Recording
+    // ===========================================================================
+    async recordClientCursor(db, args) {
+        const partitionId = args.partitionId ?? 'default';
+        const now = new Date().toISOString();
+        const scopesJson = JSON.stringify(args.effectiveScopes);
+        await sql `
+      INSERT INTO sync_client_cursors (partition_id, client_id, actor_id, cursor, effective_scopes, updated_at)
+      VALUES (${partitionId}, ${args.clientId}, ${args.actorId}, ${args.cursor}, ${scopesJson}::jsonb, ${now})
+      ON CONFLICT(partition_id, client_id) DO UPDATE SET
+        actor_id = ${args.actorId},
+        cursor = ${args.cursor},
+        effective_scopes = ${scopesJson}::jsonb,
+        updated_at = ${now}
+    `.execute(db);
+    }
+    // ===========================================================================
+    // Scope Conversion Helpers
+    // ===========================================================================
+    scopesToDb(scopes) {
+        return scopes;
+    }
+    dbToScopes(value) {
+        return parseScopes(value);
+    }
+    dbToArray(value) {
+        if (Array.isArray(value)) {
+            return value.filter((k) => typeof k === 'string');
+        }
+        return [];
+    }
+    arrayToDb(values) {
+        return values.filter((v) => v.length > 0);
+    }
+    async readAffectedTablesFromChanges(db, commitSeq, options) {
+        const partitionId = options?.partitionId ?? 'default';
+        const res = await sql `
+      SELECT DISTINCT "table"
+      FROM sync_changes
+      WHERE commit_seq = ${commitSeq}
+        AND partition_id = ${partitionId}
+    `.execute(db);
+        return res.rows
+            .map((r) => r.table)
+            .filter((t) => typeof t === 'string' && t.length > 0);
+    }
+    // ===========================================================================
+    // Console Schema (Request Events)
+    // ===========================================================================
+    async ensureConsoleSchema(db) {
+        await sql `
+      CREATE TABLE IF NOT EXISTS sync_request_events (
+        event_id BIGSERIAL PRIMARY KEY,
+        event_type TEXT NOT NULL,
+        actor_id TEXT NOT NULL,
+        client_id TEXT NOT NULL,
+        transport_path TEXT NOT NULL DEFAULT 'direct',
+        status_code INTEGER NOT NULL,
+        outcome TEXT NOT NULL,
+        duration_ms INTEGER NOT NULL,
+        commit_seq BIGINT,
+        operation_count INTEGER,
+        row_count INTEGER,
+        tables TEXT[] NOT NULL DEFAULT ARRAY[]::TEXT[],
+        error_message TEXT,
+        created_at TIMESTAMPTZ NOT NULL DEFAULT NOW()
+      )
+    `.execute(db);
+        await sql `
+      ALTER TABLE sync_request_events
+      ADD COLUMN IF NOT EXISTS transport_path TEXT NOT NULL DEFAULT 'direct'
+    `.execute(db);
+        await this.ensureIndex(db, 'idx_sync_request_events_created_at', 'CREATE INDEX idx_sync_request_events_created_at ON sync_request_events(created_at DESC)');
+        await this.ensureIndex(db, 'idx_sync_request_events_event_type', 'CREATE INDEX idx_sync_request_events_event_type ON sync_request_events(event_type)');
+        await this.ensureIndex(db, 'idx_sync_request_events_client_id', 'CREATE INDEX idx_sync_request_events_client_id ON sync_request_events(client_id)');
+        // API Keys table
+        await sql `
+      CREATE TABLE IF NOT EXISTS sync_api_keys (
+        key_id TEXT PRIMARY KEY,
+        key_hash TEXT NOT NULL,
+        key_prefix TEXT NOT NULL,
+        name TEXT NOT NULL,
+        key_type TEXT NOT NULL,
+        scope_keys TEXT[] DEFAULT ARRAY[]::TEXT[],
+        actor_id TEXT,
+        created_at TIMESTAMPTZ NOT NULL DEFAULT NOW(),
+        expires_at TIMESTAMPTZ,
+        last_used_at TIMESTAMPTZ,
+        revoked_at TIMESTAMPTZ
+      )
+    `.execute(db);
+        await this.ensureIndex(db, 'idx_sync_api_keys_key_hash', 'CREATE INDEX idx_sync_api_keys_key_hash ON sync_api_keys(key_hash)');
+        await this.ensureIndex(db, 'idx_sync_api_keys_key_type', 'CREATE INDEX idx_sync_api_keys_key_type ON sync_api_keys(key_type)');
+    }
+    // ===========================================================================
+    // Private Helpers
+    // ===========================================================================
+    async ensureIndex(db, indexName, createSql) {
+        const exists = await sql `
+      SELECT 1 as ok
+      FROM pg_indexes
+      WHERE schemaname = 'public'
+        AND indexname = ${indexName}
+      LIMIT 1
+    `.execute(db);
+        if (exists.rows.length > 0)
+            return;
+        await sql.raw(createSql).execute(db);
+    }
+}
+export function createPostgresServerDialect() {
+    return new PostgresServerSyncDialect();
+}
+//# sourceMappingURL=index.js.map