@syncular/server-dialect-postgres 0.0.1 → 0.0.2-126

package/README.md

@@ -0,0 +1,33 @@
+# @syncular/server-dialect-postgres
+
+PostgreSQL dialect for the Syncular server sync schema and query patterns (commit log, change log, scopes, snapshot chunks, console tables).
+
+Use this when your server is backed by Postgres.
+
+## Install
+
+```bash
+npm install @syncular/server-dialect-postgres
+```
+
+## Usage
+
+```ts
+import { ensureSyncSchema } from '@syncular/server';
+import { createPostgresServerDialect } from '@syncular/server-dialect-postgres';
+
+const dialect = createPostgresServerDialect();
+await ensureSyncSchema(db, dialect);
+```
+
+## Documentation
+
+- Dialects: https://syncular.dev/docs/server/dialects
+- Server setup: https://syncular.dev/docs/build/server-setup
+
+## Links
+
+- GitHub: https://github.com/syncular/syncular
+- Issues: https://github.com/syncular/syncular/issues
+
+> Status: Alpha. APIs and storage layouts may change between releases.

package/dist/index.d.ts

@@ -10,79 +10,46 @@
  * - 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 {
+import type { ScopeValues, StoredScopes } from '@syncular/core';
+import type { DbExecutor } from '@syncular/server';
+import { BaseServerSyncDialect, type IncrementalPullRow, type IncrementalPullRowsArgs } from '@syncular/server';
+import type { SyncChangeRow, SyncCoreDb } from '@syncular/server/schema';
+import type { Kysely, RawBuilder, Transaction } from 'kysely';
+export declare class PostgresServerSyncDialect extends BaseServerSyncDialect {
     readonly name: "postgres";
     readonly supportsForUpdate = true;
     readonly supportsSavepoints = true;
+    protected buildNumberListFilter(values: number[]): RawBuilder<unknown>;
+    protected buildStringListFilter(values: string[]): RawBuilder<unknown>;
     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>): Promise<number>;
-    readMinCommitSeq<DB extends SyncCoreDb>(db: Kysely<DB> | Transaction<DB>): 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[]): Promise<SyncCommitRow[]>;
-    readChangesForCommits<DB extends SyncCoreDb>(db: Kysely<DB> | Transaction<DB>, args: {
-        commitSeqs: number[];
-        table: string;
-        scopes: ScopeValues;
-    }): Promise<SyncChangeRow[]>;
-    readIncrementalPullRows<DB extends SyncCoreDb>(db: Kysely<DB> | Transaction<DB>, args: {
-        table: string;
-        scopes: ScopeValues;
-        cursor: number;
-        limitCommits: number;
-    }): 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;
-    }): 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>;
+    readChangesForCommits<DB extends SyncCoreDb>(db: DbExecutor<DB>, args: {
+        commitSeqs: number[];
+        table: string;
+        scopes: ScopeValues;
+        partitionId?: string;
+    }): Promise<SyncChangeRow[]>;
+    protected readIncrementalPullRowsBatch<DB extends SyncCoreDb>(db: DbExecutor<DB>, args: Omit<IncrementalPullRowsArgs, 'batchSize'>): Promise<IncrementalPullRow[]>;
+    compactChanges<DB extends SyncCoreDb>(db: DbExecutor<DB>, args: {
+        fullHistoryHours: number;
+    }): Promise<number>;
     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): Promise<string[]>;
     ensureConsoleSchema<DB extends SyncCoreDb>(db: Kysely<DB>): Promise<void>;
     private ensureIndex;
 }

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -10,46 +10,29 @@
  * - sync_changes: change log (JSONB scopes for filtering)
  * - sync_client_cursors: per-client cursor tracking (pruning/observability)
  */
+import { BaseServerSyncDialect, coerceIsoString, coerceNumber, parseScopes, } from '@syncular/server';
 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 isActiveTransaction(db) {
+    return db.isTransaction === true;
 }
-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 {};
+function createSavepointName() {
+    const randomPart = Math.floor(Math.random() * 1_000_000_000).toString(36);
+    return `syncular_sp_${Date.now().toString(36)}_${randomPart}`;
 }
-export class PostgresServerSyncDialect {
+export class PostgresServerSyncDialect extends BaseServerSyncDialect {
     name = 'postgres';
     supportsForUpdate = true;
     supportsSavepoints = true;
     // ===========================================================================
+    // SQL Fragment Hooks
+    // ===========================================================================
+    buildNumberListFilter(values) {
+        return sql `= ANY(${values}::bigint[])`;
+    }
+    buildStringListFilter(values) {
+        return sql `= ANY(${values}::text[])`;
+    }
+    // ===========================================================================
     // Schema Setup
     // ===========================================================================
     async ensureSyncSchema(db) {
@@ -57,6 +40,7 @@ export class PostgresServerSyncDialect {
             .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())
@@ -71,32 +55,43 @@ export class PostgresServerSyncDialect {
       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(['client_id', 'client_commit_id'])
+            .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', ['table', 'commit_seq'])
+            .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(['commit_seq'])
+            .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())
@@ -105,28 +100,37 @@ export class PostgresServerSyncDialect {
             .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(['commit_seq'])
+            .columns(['partition_id', 'commit_seq'])
             .execute();
         await db.schema
             .createIndex('idx_sync_changes_table')
             .ifNotExists()
             .on('sync_changes')
-            .columns(['table'])
+            .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('client_id', 'text', (col) => col.primaryKey())
+            .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()
@@ -137,6 +141,7 @@ export class PostgresServerSyncDialect {
             .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())
@@ -151,6 +156,8 @@ export class PostgresServerSyncDialect {
             .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()
@@ -162,6 +169,7 @@ export class PostgresServerSyncDialect {
             .ifNotExists()
             .on('sync_snapshot_chunks')
             .columns([
+            'partition_id',
             'scope_key',
             'scope',
             'as_of_commit_seq',
@@ -177,36 +185,39 @@ export class PostgresServerSyncDialect {
     // Transaction Control
     // ===========================================================================
     async executeInTransaction(db, fn) {
+        if (isActiveTransaction(db)) {
+            const savepoint = createSavepointName();
+            await sql.raw(`SAVEPOINT ${savepoint}`).execute(db);
+            try {
+                const result = await fn(db);
+                await sql.raw(`RELEASE SAVEPOINT ${savepoint}`).execute(db);
+                return result;
+            }
+            catch (error) {
+                await sql.raw(`ROLLBACK TO SAVEPOINT ${savepoint}`).execute(db);
+                await sql.raw(`RELEASE SAVEPOINT ${savepoint}`).execute(db);
+                throw error;
+            }
+        }
         return db.transaction().execute(fn);
     }
     async setRepeatableRead(trx) {
         await sql `SET TRANSACTION ISOLATION LEVEL REPEATABLE READ`.execute(trx);
     }
     // ===========================================================================
-    // Commit/Change Log Queries
+    // Overrides (dialect-specific optimizations / casts)
     // ===========================================================================
-    async readMaxCommitSeq(db) {
-        const res = await sql `
-      SELECT max(commit_seq) as max_seq
-      FROM sync_commits
-    `.execute(db);
-        return coerceNumber(res.rows[0]?.max_seq) ?? 0;
-    }
-    async readMinCommitSeq(db) {
-        const res = await sql `
-      SELECT min(commit_seq) as min_seq
-      FROM sync_commits
-    `.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 [];
+        // Single-table fast path: skip DISTINCT since (partition_id, table, commit_seq) is PK
         if (args.tables.length === 1) {
             const res = await sql `
         SELECT commit_seq
         FROM sync_table_commits
-        WHERE "table" = ${args.tables[0]}
+        WHERE partition_id = ${partitionId}
+          AND "table" = ${args.tables[0]}
           AND commit_seq > ${args.cursor}
         ORDER BY commit_seq ASC
         LIMIT ${args.limitCommits}
@@ -215,43 +226,34 @@ export class PostgresServerSyncDialect {
                 .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 "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);
+        // Multi-table: use ANY() with DISTINCT
+        return super.readCommitSeqsForPull(db, args);
     }
-    async readCommits(db, commitSeqs) {
-        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[])
-      ORDER BY commit_seq ASC
+    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);
-        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,
-        }));
     }
+    // ===========================================================================
+    // Commit/Change Log Queries (dialect-specific)
+    // ===========================================================================
     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 {
@@ -262,6 +264,7 @@ export class PostgresServerSyncDialect {
       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) {
@@ -270,6 +273,7 @@ export class PostgresServerSyncDialect {
         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
@@ -286,7 +290,8 @@ export class PostgresServerSyncDialect {
             scopes: parseScopes(row.scopes),
         }));
     }
-    async readIncrementalPullRows(db, args) {
+    async readIncrementalPullRowsBatch(db, args) {
+        const partitionId = args.partitionId ?? 'default';
         const limitCommits = Math.max(1, Math.min(500, args.limitCommits));
         // Build scope filter conditions
         const scopeConditions = [];
@@ -306,12 +311,15 @@ export class PostgresServerSyncDialect {
         SELECT DISTINCT tc.commit_seq
         FROM sync_table_commits tc
         JOIN sync_commits cm ON cm.commit_seq = tc.commit_seq
-        WHERE tc."table" = ${args.table}
+        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})
           )
@@ -332,7 +340,9 @@ export class PostgresServerSyncDialect {
       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 c."table" = ${args.table}
+      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);
@@ -349,26 +359,6 @@ export class PostgresServerSyncDialect {
             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 `
@@ -376,7 +366,7 @@ export class PostgresServerSyncDialect {
         SELECT
           c.change_id,
           row_number() OVER (
-            PARTITION BY c."table", c.row_id, c.scopes
+            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
@@ -391,42 +381,25 @@ export class PostgresServerSyncDialect {
         await sql `
       DELETE FROM sync_table_commits tc
       USING sync_commits cm
-      WHERE cm.commit_seq = tc.commit_seq
-        AND cm.created_at < ${cutoffIso}
+        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 now = new Date().toISOString();
-        const scopesJson = JSON.stringify(args.effectiveScopes);
-        await sql `
-      INSERT INTO sync_client_cursors (client_id, actor_id, cursor, effective_scopes, updated_at)
-      VALUES (${args.clientId}, ${args.actorId}, ${args.cursor}, ${scopesJson}::jsonb, ${now})
-      ON CONFLICT(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');
@@ -436,16 +409,6 @@ export class PostgresServerSyncDialect {
     arrayToDb(values) {
         return values.filter((v) => v.length > 0);
     }
-    async readAffectedTablesFromChanges(db, commitSeq) {
-        const res = await sql `
-      SELECT DISTINCT "table"
-      FROM sync_changes
-      WHERE commit_seq = ${commitSeq}
-    `.execute(db);
-        return res.rows
-            .map((r) => r.table)
-            .filter((t) => typeof t === 'string' && t.length > 0);
-    }
     // ===========================================================================
     // Console Schema (Request Events)
     // ===========================================================================