@syncular/server-dialect-sqlite 0.0.1 → 0.0.2-127

package/README.md

@@ -0,0 +1,33 @@
+# @syncular/server-dialect-sqlite
+
+SQLite dialect for the Syncular server sync schema and query patterns (commit log, change log, scopes, snapshot chunks, console tables).
+
+Commonly used for dev/test setups and for edge deployments that use a SQLite-compatible backend.
+
+## Install
+
+```bash
+npm install @syncular/server-dialect-sqlite
+```
+
+## Usage
+
+```ts
+import { ensureSyncSchema } from '@syncular/server';
+import { createSqliteServerDialect } from '@syncular/server-dialect-sqlite';
+
+const dialect = createSqliteServerDialect();
+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

@@ -12,11 +12,12 @@
  * - No GIN index → regular index + manual filtering
  * - REPEATABLE READ → no-op (SQLite uses serializable by default)
  */
-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 SqliteServerSyncDialect 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 } from 'kysely';
+export declare class SqliteServerSyncDialect extends BaseServerSyncDialect {
     readonly name: "sqlite";
     readonly supportsForUpdate = false;
     readonly supportsSavepoints: boolean;
@@ -24,74 +25,24 @@ export declare class SqliteServerSyncDialect implements ServerSyncDialect {
     constructor(options?: {
         supportsTransactions?: boolean;
     });
+    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[];
-    }): 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: {
+    readChangesForCommits<DB extends SyncCoreDb>(db: DbExecutor<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;
-    }): 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;
-    }>>;
-    /**
-     * Streaming version of incremental pull for large result sets.
-     * Yields changes one at a time instead of loading all into memory.
-     */
-    streamIncrementalPullRows<DB extends SyncCoreDb>(db: Kysely<DB> | Transaction<DB>, args: {
-        table: string;
-        scopes: ScopeValues;
-        cursor: number;
-        limitCommits: 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: {
+    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>;
-    recordClientCursor<DB extends SyncCoreDb>(db: Kysely<DB> | Transaction<DB>, args: {
-        clientId: string;
-        actorId: string;
-        cursor: number;
-        effectiveScopes: ScopeValues;
-    }): Promise<void>;
     scopesToDb(scopes: StoredScopes): string;
-    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>;
 }
 export declare function createSqliteServerDialect(options?: {

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":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAU,MAAM,gBAAgB,CAAC;AACxE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EACL,qBAAqB,EAGrB,KAAK,kBAAkB,EACvB,KAAK,uBAAuB,EAE7B,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACzE,OAAO,KAAK,EAAE,MAAM,EAAE,UAAU,EAAe,MAAM,QAAQ,CAAC;AA4F9D,qBAAa,uBAAwB,SAAQ,qBAAqB;IAChE,QAAQ,CAAC,IAAI,WAAqB;IAClC,QAAQ,CAAC,iBAAiB,SAAS;IACnC,QAAQ,CAAC,kBAAkB,EAAE,OAAO,CAAC;IACrC,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAAU;IAEhD,YAAY,OAAO,CAAC,EAAE;QAAE,oBAAoB,CAAC,EAAE,OAAO,CAAA;KAAE,EAIvD;IAMD,SAAS,CAAC,qBAAqB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,UAAU,CAAC,OAAO,CAAC,CAMrE;IAED,SAAS,CAAC,qBAAqB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,UAAU,CAAC,OAAO,CAAC,CAMrE;IAMK,gBAAgB,CAAC,EAAE,SAAS,UAAU,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CA6J3E;IAMK,oBAAoB,CAAC,EAAE,SAAS,UAAU,EAAE,CAAC,EACjD,EAAE,EAAE,MAAM,CAAC,EAAE,CAAC,EACd,EAAE,EAAE,CAAC,QAAQ,EAAE,UAAU,CAAC,EAAE,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,GAC3C,OAAO,CAAC,CAAC,CAAC,CAqBZ;IAEK,iBAAiB,CAAC,EAAE,SAAS,UAAU,EAC3C,IAAI,EAAE,UAAU,CAAC,EAAE,CAAC,GACnB,OAAO,CAAC,IAAI,CAAC,CAEf;IAMK,qBAAqB,CAAC,EAAE,SAAS,UAAU,EAC/C,EAAE,EAAE,UAAU,CAAC,EAAE,CAAC,EAClB,IAAI,EAAE;QACJ,UAAU,EAAE,MAAM,EAAE,CAAC;QACrB,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,WAAW,CAAC;QACpB,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,GACA,OAAO,CAAC,aAAa,EAAE,CAAC,CA0C1B;IAED,UAAyB,4BAA4B,CAAC,EAAE,SAAS,UAAU,EACzE,EAAE,EAAE,UAAU,CAAC,EAAE,CAAC,EAClB,IAAI,EAAE,IAAI,CAAC,uBAAuB,EAAE,WAAW,CAAC,GAC/C,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAmF/B;IAEK,cAAc,CAAC,EAAE,SAAS,UAAU,EACxC,EAAE,EAAE,UAAU,CAAC,EAAE,CAAC,EAClB,IAAI,EAAE;QAAE,gBAAgB,EAAE,MAAM,CAAA;KAAE,GACjC,OAAO,CAAC,MAAM,CAAC,CA6FjB;IAMD,UAAU,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAEvC;IAED,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,EAAE,CAElC;IAED,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,CAElC;IAMK,mBAAmB,CAAC,EAAE,SAAS,UAAU,EAC7C,EAAE,EAAE,MAAM,CAAC,EAAE,CAAC,GACb,OAAO,CAAC,IAAI,CAAC,CAuDf;CACF;AAED,wBAAgB,yBAAyB,CAAC,OAAO,CAAC,EAAE;IAClD,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAChC,GAAG,uBAAuB,CAE1B"}

package/dist/index.js

@@ -12,26 +12,14 @@
  * - No GIN index → regular index + manual filtering
  * - REPEATABLE READ → no-op (SQLite uses serializable by default)
  */
+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 isActiveTransaction(db) {
+    return db.isTransaction === true;
 }
-function coerceIsoString(value) {
-    if (typeof value === 'string')
-        return value;
-    if (value instanceof Date)
-        return value.toISOString();
-    return String(value);
+function createSavepointName() {
+    const randomPart = Math.floor(Math.random() * 1_000_000_000).toString(36);
+    return `syncular_sp_${Date.now().toString(36)}_${randomPart}`;
 }
 function parseJsonValue(value) {
     if (value === null || value === undefined)
@@ -48,39 +36,6 @@ function parseJsonValue(value) {
     }
     return 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;
-    }
-    if (typeof value === 'string') {
-        try {
-            const parsed = JSON.parse(value);
-            if (typeof parsed === 'object' &&
-                parsed !== null &&
-                !Array.isArray(parsed)) {
-                const result = {};
-                for (const [k, v] of Object.entries(parsed)) {
-                    if (typeof v === 'string') {
-                        result[k] = v;
-                    }
-                }
-                return result;
-            }
-        }
-        catch {
-            // ignore
-        }
-    }
-    return {};
-}
 function toStringArray(value) {
     if (Array.isArray(value)) {
         return value.filter((k) => typeof k === 'string');
@@ -118,16 +73,48 @@ function scopesMatch(stored, requested) {
     }
     return true;
 }
-export class SqliteServerSyncDialect {
+async function ensurePartitionColumn(db, table) {
+    try {
+        await sql
+            .raw(`ALTER TABLE ${table} ADD COLUMN partition_id TEXT NOT NULL DEFAULT 'default'`)
+            .execute(db);
+    }
+    catch {
+        // Ignore when column already exists (or table is immutable in the current backend).
+    }
+}
+async function ensureTransportPathColumn(db) {
+    try {
+        await sql
+            .raw("ALTER TABLE sync_request_events ADD COLUMN transport_path TEXT NOT NULL DEFAULT 'direct'")
+            .execute(db);
+    }
+    catch {
+        // Ignore when column already exists (or table is immutable in the current backend).
+    }
+}
+export class SqliteServerSyncDialect extends BaseServerSyncDialect {
     name = 'sqlite';
     supportsForUpdate = false;
     supportsSavepoints;
     _supportsTransactions;
     constructor(options) {
+        super();
         this._supportsTransactions = options?.supportsTransactions ?? true;
         this.supportsSavepoints = this._supportsTransactions;
     }
     // ===========================================================================
+    // SQL Fragment Hooks
+    // ===========================================================================
+    buildNumberListFilter(values) {
+        const list = sql.join(values.map((v) => sql `${v}`), sql `, `);
+        return sql `IN (${list})`;
+    }
+    buildStringListFilter(values) {
+        const list = sql.join(values.map((v) => sql `${v}`), sql `, `);
+        return sql `IN (${list})`;
+    }
+    // ===========================================================================
     // Schema Setup
     // ===========================================================================
     async ensureSyncSchema(db) {
@@ -138,6 +125,7 @@ export class SqliteServerSyncDialect {
             .createTable('sync_commits')
             .ifNotExists()
             .addColumn('commit_seq', 'integer', (col) => col.primaryKey().autoIncrement())
+            .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())
@@ -147,23 +135,36 @@ export class SqliteServerSyncDialect {
             .addColumn('change_count', 'integer', (col) => col.notNull().defaultTo(0))
             .addColumn('affected_tables', 'text', (col) => col.notNull().defaultTo('[]'))
             .execute();
+        await ensurePartitionColumn(db, 'sync_commits');
+        await sql `DROP INDEX IF EXISTS idx_sync_commits_client_commit`.execute(db);
         await sql `CREATE UNIQUE INDEX IF NOT EXISTS idx_sync_commits_client_commit
-      ON sync_commits(client_id, client_commit_id)`.execute(db);
+      ON sync_commits(partition_id, client_id, client_commit_id)`.execute(db);
         // sync_table_commits table (index of which commits affect which tables)
         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', 'integer', (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 ensurePartitionColumn(db, 'sync_table_commits');
+        // Ensure unique index matches ON CONFLICT clause in push.ts
+        // (needed when migrating from old schema where PK was only (table, commit_seq))
+        await sql `CREATE UNIQUE INDEX IF NOT EXISTS idx_sync_table_commits_partition_pk
+      ON sync_table_commits(partition_id, "table", commit_seq)`.execute(db);
         await sql `CREATE INDEX IF NOT EXISTS idx_sync_table_commits_commit_seq
-      ON sync_table_commits(commit_seq)`.execute(db);
+      ON sync_table_commits(partition_id, commit_seq)`.execute(db);
         // sync_changes table - uses JSON for scopes
         await db.schema
             .createTable('sync_changes')
             .ifNotExists()
             .addColumn('change_id', 'integer', (col) => col.primaryKey().autoIncrement())
+            .addColumn('partition_id', 'text', (col) => col.notNull().defaultTo('default'))
             .addColumn('commit_seq', 'integer', (col) => col.notNull().references('sync_commits.commit_seq').onDelete('cascade'))
             .addColumn('table', 'text', (col) => col.notNull())
             .addColumn('row_id', 'text', (col) => col.notNull())
@@ -172,20 +173,31 @@ export class SqliteServerSyncDialect {
             .addColumn('row_version', 'integer')
             .addColumn('scopes', 'json', (col) => col.notNull())
             .execute();
+        await ensurePartitionColumn(db, 'sync_changes');
         await sql `CREATE INDEX IF NOT EXISTS idx_sync_changes_commit_seq
-      ON sync_changes(commit_seq)`.execute(db);
+      ON sync_changes(partition_id, commit_seq)`.execute(db);
         await sql `CREATE INDEX IF NOT EXISTS idx_sync_changes_table
-      ON sync_changes("table")`.execute(db);
+      ON sync_changes(partition_id, "table")`.execute(db);
         // sync_client_cursors table
         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', 'integer', (col) => col.notNull().defaultTo(0))
             .addColumn('effective_scopes', 'json', (col) => col.notNull().defaultTo('{}'))
             .addColumn('updated_at', 'text', (col) => col.notNull().defaultTo(nowIso))
+            .addPrimaryKeyConstraint('sync_client_cursors_pk', [
+            'partition_id',
+            'client_id',
+        ])
             .execute();
+        await ensurePartitionColumn(db, 'sync_client_cursors');
+        // Ensure unique index matches ON CONFLICT clause in recordClientCursor
+        // (needed when migrating from old schema where PK was only (client_id))
+        await sql `CREATE UNIQUE INDEX IF NOT EXISTS idx_sync_client_cursors_partition_pk
+      ON sync_client_cursors(partition_id, client_id)`.execute(db);
         await sql `CREATE INDEX IF NOT EXISTS idx_sync_client_cursors_updated_at
       ON sync_client_cursors(updated_at)`.execute(db);
         // sync_snapshot_chunks table
@@ -193,6 +205,7 @@ export class SqliteServerSyncDialect {
             .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', 'integer', (col) => col.notNull())
@@ -207,10 +220,11 @@ export class SqliteServerSyncDialect {
             .addColumn('created_at', 'text', (col) => col.notNull().defaultTo(nowIso))
             .addColumn('expires_at', 'text', (col) => col.notNull())
             .execute();
+        await ensurePartitionColumn(db, 'sync_snapshot_chunks');
         await sql `CREATE INDEX IF NOT EXISTS idx_sync_snapshot_chunks_expires_at
       ON sync_snapshot_chunks(expires_at)`.execute(db);
         await sql `CREATE UNIQUE INDEX IF NOT EXISTS idx_sync_snapshot_chunks_page_key
-      ON sync_snapshot_chunks(scope_key, scope, as_of_commit_seq, row_cursor, row_limit, encoding, compression)`.execute(db);
+      ON sync_snapshot_chunks(partition_id, scope_key, scope, as_of_commit_seq, row_cursor, row_limit, encoding, compression)`.execute(db);
         // Cleanup orphaned rows
         await sql `
       DELETE FROM sync_table_commits
@@ -225,6 +239,23 @@ export class SqliteServerSyncDialect {
     // Transaction Control
     // ===========================================================================
     async executeInTransaction(db, fn) {
+        if (isActiveTransaction(db)) {
+            if (!this._supportsTransactions) {
+                return fn(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;
+            }
+        }
         if (this._supportsTransactions) {
             return db.transaction().execute(fn);
         }
@@ -234,56 +265,10 @@ export class SqliteServerSyncDialect {
         // SQLite uses serializable isolation by default in WAL mode.
     }
     // ===========================================================================
-    // Commit/Change Log Queries
+    // Commit/Change Log Queries (dialect-specific)
     // ===========================================================================
-    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) {
-        if (args.tables.length === 0)
-            return [];
-        const tablesIn = sql.join(args.tables.map((t) => sql `${t}`), sql `, `);
-        const res = await sql `
-      SELECT DISTINCT commit_seq
-      FROM sync_table_commits
-      WHERE "table" IN (${tablesIn})
-        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) {
-        if (commitSeqs.length === 0)
-            return [];
-        const commitSeqsIn = sql.join(commitSeqs.map((seq) => sql `${seq}`), sql `, `);
-        const res = await sql `
-      SELECT commit_seq, actor_id, created_at, result_json
-      FROM sync_commits
-      WHERE commit_seq IN (${commitSeqsIn})
-      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 [];
         const commitSeqsIn = sql.join(args.commitSeqs.map((seq) => sql `${seq}`), sql `, `);
@@ -292,6 +277,7 @@ export class SqliteServerSyncDialect {
       SELECT commit_seq, "table", row_id, op, row_json, row_version, scopes
       FROM sync_changes
       WHERE commit_seq IN (${commitSeqsIn})
+        AND partition_id = ${partitionId}
         AND "table" = ${args.table}
       ORDER BY commit_seq ASC, change_id ASC
     `.execute(db);
@@ -311,18 +297,21 @@ export class SqliteServerSyncDialect {
             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));
         // Get commit_seqs for this table
         const commitSeqsRes = await sql `
       SELECT commit_seq
       FROM sync_table_commits
-      WHERE "table" = ${args.table}
+      WHERE partition_id = ${partitionId}
+        AND "table" = ${args.table}
         AND commit_seq > ${args.cursor}
         AND EXISTS (
           SELECT 1
           FROM sync_commits cm
           WHERE cm.commit_seq = sync_table_commits.commit_seq
+            AND cm.partition_id = ${partitionId}
         )
       ORDER BY commit_seq ASC
       LIMIT ${limitCommits}
@@ -349,6 +338,8 @@ export class SqliteServerSyncDialect {
       FROM sync_commits cm
       JOIN sync_changes c ON c.commit_seq = cm.commit_seq
       WHERE cm.commit_seq IN (${commitSeqsIn})
+        AND cm.partition_id = ${partitionId}
+        AND c.partition_id = ${partitionId}
         AND c."table" = ${args.table}
       ORDER BY cm.commit_seq ASC, c.change_id ASC
     `.execute(db);
@@ -371,88 +362,20 @@ export class SqliteServerSyncDialect {
             scopes: parseScopes(row.scopes),
         }));
     }
-    /**
-     * Streaming version of incremental pull for large result sets.
-     * Yields changes one at a time instead of loading all into memory.
-     */
-    async *streamIncrementalPullRows(db, args) {
-        const limitCommits = Math.max(1, Math.min(500, args.limitCommits));
-        // Get commit_seqs for this table
-        const commitSeqsRes = await sql `
-      SELECT commit_seq
-      FROM sync_table_commits
-      WHERE "table" = ${args.table}
-        AND commit_seq > ${args.cursor}
-        AND EXISTS (
-          SELECT 1
-          FROM sync_commits cm
-          WHERE cm.commit_seq = sync_table_commits.commit_seq
-        )
-      ORDER BY commit_seq ASC
-      LIMIT ${limitCommits}
-    `.execute(db);
-        const commitSeqs = commitSeqsRes.rows
-            .map((r) => coerceNumber(r.commit_seq))
-            .filter((n) => n !== null);
-        if (commitSeqs.length === 0)
-            return;
-        // Process in smaller batches to avoid memory issues
-        const batchSize = 100;
-        for (let i = 0; i < commitSeqs.length; i += batchSize) {
-            const batch = commitSeqs.slice(i, i + batchSize);
-            const commitSeqsIn = sql.join(batch.map((seq) => sql `${seq}`), sql `, `);
-            const changesRes = await sql `
-        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 sync_commits cm
-        JOIN sync_changes c ON c.commit_seq = cm.commit_seq
-        WHERE cm.commit_seq IN (${commitSeqsIn})
-          AND c."table" = ${args.table}
-        ORDER BY cm.commit_seq ASC, c.change_id ASC
-      `.execute(db);
-            // Filter and yield each row
-            for (const row of changesRes.rows) {
-                const storedScopes = parseScopes(row.scopes);
-                if (scopesMatch(storedScopes, args.scopes)) {
-                    yield {
-                        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: parseJsonValue(row.row_json),
-                        row_version: coerceNumber(row.row_version),
-                        scopes: storedScopes,
-                    };
-                }
-            }
-        }
-    }
     async compactChanges(db, args) {
         const cutoffIso = new Date(Date.now() - args.fullHistoryHours * 60 * 60 * 1000).toISOString();
         // Find all old changes
         const oldChanges = await sql `
-      SELECT c.change_id, c.commit_seq, c."table", c.row_id, c.scopes
+      SELECT c.change_id, c.partition_id, c.commit_seq, c."table", c.row_id, c.scopes
       FROM sync_changes c
       JOIN sync_commits cm ON cm.commit_seq = c.commit_seq
       WHERE cm.created_at < ${cutoffIso}
     `.execute(db);
-        // Group by (table, row_id, scopes)
+        // Group by (partition_id, table, row_id, scopes)
         const groups = new Map();
         for (const row of oldChanges.rows) {
             const scopesStr = JSON.stringify(parseScopes(row.scopes));
-            const key = `${row.table}|${row.row_id}|${scopesStr}`;
+            const key = `${row.partition_id}|${row.table}|${row.row_id}|${scopesStr}`;
             if (!groups.has(key)) {
                 groups.set(key, []);
             }
@@ -478,10 +401,10 @@ export class SqliteServerSyncDialect {
         if (toDelete.length === 0)
             return 0;
         // Delete in batches
-        const batchSize = 500;
+        const deleteBatchSize = 500;
         let deleted = 0;
-        for (let i = 0; i < toDelete.length; i += batchSize) {
-            const batch = toDelete.slice(i, i + batchSize);
+        for (let i = 0; i < toDelete.length; i += deleteBatchSize) {
+            const batch = toDelete.slice(i, i + deleteBatchSize);
             const batchIn = sql.join(batch.map((id) => sql `${id}`), sql `, `);
             const res = await sql `
         DELETE FROM sync_changes
@@ -496,57 +419,30 @@ export class SqliteServerSyncDialect {
         SELECT commit_seq
         FROM sync_commits
         WHERE created_at < ${cutoffIso}
+          AND partition_id = sync_table_commits.partition_id
       )
         AND NOT EXISTS (
           SELECT 1
           FROM sync_changes c
           WHERE c.commit_seq = sync_table_commits.commit_seq
+            AND c.partition_id = sync_table_commits.partition_id
             AND c."table" = sync_table_commits."table"
         )
     `.execute(db);
         return deleted;
     }
     // ===========================================================================
-    // 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}, ${now})
-      ON CONFLICT(client_id) DO UPDATE SET
-        actor_id = ${args.actorId},
-        cursor = ${args.cursor},
-        effective_scopes = ${scopesJson},
-        updated_at = ${now}
-    `.execute(db);
-    }
-    // ===========================================================================
     // Scope Conversion Helpers
     // ===========================================================================
     scopesToDb(scopes) {
         return JSON.stringify(scopes);
     }
-    dbToScopes(value) {
-        return parseScopes(value);
-    }
     dbToArray(value) {
         return toStringArray(value);
     }
     arrayToDb(values) {
         return JSON.stringify(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)
     // ===========================================================================
@@ -567,8 +463,10 @@ export class SqliteServerSyncDialect {
             .addColumn('row_count', 'integer')
             .addColumn('tables', 'text', (col) => col.notNull().defaultTo('[]'))
             .addColumn('error_message', 'text')
+            .addColumn('transport_path', 'text', (col) => col.notNull().defaultTo('direct'))
             .addColumn('created_at', 'text', (col) => col.notNull().defaultTo(nowIso))
             .execute();
+        await ensureTransportPathColumn(db);
         await sql `CREATE INDEX IF NOT EXISTS idx_sync_request_events_created_at
       ON sync_request_events(created_at DESC)`.execute(db);
         await sql `CREATE INDEX IF NOT EXISTS idx_sync_request_events_event_type