@syncular/server 0.0.1-60

package/dist/blobs/migrate.js

@@ -0,0 +1,119 @@
+/**
+ * @syncular/server - Blob storage migrations
+ *
+ * These migrations are separate from core sync migrations because
+ * blob storage is optional and may use external storage (S3/R2).
+ */
+import { sql } from 'kysely';
+/**
+ * Ensures the blob uploads tracking schema exists.
+ * This table is required for the blob manager regardless of storage backend.
+ *
+ * For PostgreSQL.
+ */
+async function ensureBlobUploadsSchemaPostgres(db) {
+    await db.schema
+        .createTable('sync_blob_uploads')
+        .ifNotExists()
+        .addColumn('hash', 'text', (col) => col.primaryKey())
+        .addColumn('size', 'bigint', (col) => col.notNull())
+        .addColumn('mime_type', 'text', (col) => col.notNull())
+        .addColumn('status', 'text', (col) => col.notNull())
+        .addColumn('actor_id', 'text', (col) => col.notNull())
+        .addColumn('created_at', 'timestamptz', (col) => col.notNull().defaultTo(sql `now()`))
+        .addColumn('expires_at', 'timestamptz', (col) => col.notNull())
+        .addColumn('completed_at', 'timestamptz')
+        .execute();
+    await db.schema
+        .createIndex('idx_sync_blob_uploads_status')
+        .ifNotExists()
+        .on('sync_blob_uploads')
+        .columns(['status'])
+        .execute();
+    await db.schema
+        .createIndex('idx_sync_blob_uploads_expires_at')
+        .ifNotExists()
+        .on('sync_blob_uploads')
+        .columns(['expires_at'])
+        .execute();
+}
+/**
+ * Ensures the blob uploads tracking schema exists.
+ * This table is required for the blob manager regardless of storage backend.
+ *
+ * For SQLite.
+ */
+async function ensureBlobUploadsSchemasSqlite(db) {
+    await db.schema
+        .createTable('sync_blob_uploads')
+        .ifNotExists()
+        .addColumn('hash', 'text', (col) => col.primaryKey())
+        .addColumn('size', 'integer', (col) => col.notNull())
+        .addColumn('mime_type', 'text', (col) => col.notNull())
+        .addColumn('status', 'text', (col) => col.notNull())
+        .addColumn('actor_id', 'text', (col) => col.notNull())
+        .addColumn('created_at', 'text', (col) => col.notNull().defaultTo(sql `(datetime('now'))`))
+        .addColumn('expires_at', 'text', (col) => col.notNull())
+        .addColumn('completed_at', 'text')
+        .execute();
+    await db.schema
+        .createIndex('idx_sync_blob_uploads_status')
+        .ifNotExists()
+        .on('sync_blob_uploads')
+        .columns(['status'])
+        .execute();
+    await db.schema
+        .createIndex('idx_sync_blob_uploads_expires_at')
+        .ifNotExists()
+        .on('sync_blob_uploads')
+        .columns(['expires_at'])
+        .execute();
+}
+/**
+ * Ensures the blob storage schema exists (for database adapter).
+ * Only needed if using the database blob storage adapter.
+ *
+ * For PostgreSQL.
+ */
+export async function ensureBlobStorageSchemaPostgres(db) {
+    // First ensure uploads table
+    await ensureBlobUploadsSchemaPostgres(db);
+    // Then create blobs table
+    await db.schema
+        .createTable('sync_blobs')
+        .ifNotExists()
+        .addColumn('hash', 'text', (col) => col.primaryKey())
+        .addColumn('size', 'bigint', (col) => col.notNull())
+        .addColumn('mime_type', 'text', (col) => col.notNull())
+        .addColumn('body', 'bytea', (col) => col.notNull())
+        .addColumn('created_at', 'timestamptz', (col) => col.notNull().defaultTo(sql `now()`))
+        .execute();
+}
+/**
+ * Ensures the blob storage schema exists (for database adapter).
+ * Only needed if using the database blob storage adapter.
+ *
+ * For SQLite.
+ */
+export async function ensureBlobStorageSchemaSqlite(db) {
+    // First ensure uploads table
+    await ensureBlobUploadsSchemasSqlite(db);
+    // Then create blobs table
+    await db.schema
+        .createTable('sync_blobs')
+        .ifNotExists()
+        .addColumn('hash', 'text', (col) => col.primaryKey())
+        .addColumn('size', 'integer', (col) => col.notNull())
+        .addColumn('mime_type', 'text', (col) => col.notNull())
+        .addColumn('body', 'blob', (col) => col.notNull())
+        .addColumn('created_at', 'text', (col) => col.notNull().defaultTo(sql `(datetime('now'))`))
+        .execute();
+}
+/**
+ * Drops the blob schema from the database.
+ */
+export async function dropBlobSchema(db) {
+    await db.schema.dropTable('sync_blobs').ifExists().execute();
+    await db.schema.dropTable('sync_blob_uploads').ifExists().execute();
+}
+//# sourceMappingURL=migrate.js.map

package/dist/blobs/migrate.js.map

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

package/dist/blobs/types.d.ts

@@ -0,0 +1,54 @@
+/**
+ * @syncular/server - Blob storage types
+ */
+import type { Generated } from 'kysely';
+/**
+ * Blob uploads tracking table.
+ * Tracks initiated uploads and their completion status.
+ */
+export interface SyncBlobUploadsTable {
+    /** SHA-256 hash with prefix: "sha256:<hex>" */
+    hash: string;
+    /** Expected size in bytes */
+    size: number;
+    /** MIME type */
+    mime_type: string;
+    /** Upload status */
+    status: 'pending' | 'complete';
+    /** Actor who initiated the upload */
+    actor_id: string;
+    /** When the upload was initiated */
+    created_at: Generated<string>;
+    /** When the upload expires (for cleanup of incomplete uploads) */
+    expires_at: string;
+    /** When the upload was completed */
+    completed_at: string | null;
+}
+export interface SyncBlobUploadsDb {
+    sync_blob_uploads: SyncBlobUploadsTable;
+}
+/**
+ * Blob storage table (for database adapter).
+ * Stores blob content directly in the database.
+ */
+export interface SyncBlobsTable {
+    /** SHA-256 hash with prefix: "sha256:<hex>" */
+    hash: string;
+    /** Size in bytes */
+    size: number;
+    /** MIME type */
+    mime_type: string;
+    /** Blob content */
+    body: Uint8Array;
+    /** When the blob was created */
+    created_at: Generated<string>;
+}
+export interface SyncBlobsDb {
+    sync_blobs: SyncBlobsTable;
+}
+/**
+ * Full database interface for blob storage.
+ */
+export interface SyncBlobDb extends SyncBlobUploadsDb, SyncBlobsDb {
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/blobs/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/blobs/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AAMxC;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACnC,+CAA+C;IAC/C,IAAI,EAAE,MAAM,CAAC;IACb,6BAA6B;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,gBAAgB;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,oBAAoB;IACpB,MAAM,EAAE,SAAS,GAAG,UAAU,CAAC;IAC/B,qCAAqC;IACrC,QAAQ,EAAE,MAAM,CAAC;IACjB,oCAAoC;IACpC,UAAU,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC;IAC9B,kEAAkE;IAClE,UAAU,EAAE,MAAM,CAAC;IACnB,oCAAoC;IACpC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED,MAAM,WAAW,iBAAiB;IAChC,iBAAiB,EAAE,oBAAoB,CAAC;CACzC;AAMD;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,+CAA+C;IAC/C,IAAI,EAAE,MAAM,CAAC;IACb,oBAAoB;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,gBAAgB;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,mBAAmB;IACnB,IAAI,EAAE,UAAU,CAAC;IACjB,gCAAgC;IAChC,UAAU,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC;CAC/B;AAED,MAAM,WAAW,WAAW;IAC1B,UAAU,EAAE,cAAc,CAAC;CAC5B;AAMD;;GAEG;AACH,MAAM,WAAW,UAAW,SAAQ,iBAAiB,EAAE,WAAW;CAAG"}

package/dist/blobs/types.js

@@ -0,0 +1,5 @@
+/**
+ * @syncular/server - Blob storage types
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/blobs/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/blobs/types.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/clients.d.ts

@@ -0,0 +1,14 @@
+/**
+ * @syncular/server - Client cursor tracking
+ */
+import type { ScopeValues } from '@syncular/core';
+import type { DbExecutor, ServerSyncDialect } from './dialect/types';
+import type { SyncCoreDb } from './schema';
+export declare function recordClientCursor<DB extends SyncCoreDb>(db: DbExecutor<DB>, dialect: ServerSyncDialect, args: {
+    partitionId?: string;
+    clientId: string;
+    actorId: string;
+    cursor: number;
+    effectiveScopes: ScopeValues;
+}): Promise<void>;
+//# sourceMappingURL=clients.d.ts.map

package/dist/clients.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clients.d.ts","sourceRoot":"","sources":["../src/clients.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,KAAK,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACrE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAE3C,wBAAsB,kBAAkB,CAAC,EAAE,SAAS,UAAU,EAC5D,EAAE,EAAE,UAAU,CAAC,EAAE,CAAC,EAClB,OAAO,EAAE,iBAAiB,EAC1B,IAAI,EAAE;IACJ,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,eAAe,EAAE,WAAW,CAAC;CAC9B,GACA,OAAO,CAAC,IAAI,CAAC,CAEf"}

package/dist/clients.js

@@ -0,0 +1,7 @@
+/**
+ * @syncular/server - Client cursor tracking
+ */
+export async function recordClientCursor(db, dialect, args) {
+    await dialect.recordClientCursor(db, args);
+}
+//# sourceMappingURL=clients.js.map

package/dist/clients.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clients.js","sourceRoot":"","sources":["../src/clients.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,EAAkB,EAClB,OAA0B,EAC1B,IAMC,EACc;IACf,MAAM,OAAO,CAAC,kBAAkB,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;AAAA,CAC5C"}

package/dist/compaction.d.ts

@@ -0,0 +1,27 @@
+/**
+ * @syncular/server - Change-log compaction utilities
+ *
+ * Compaction reduces storage by deleting intermediate history while preserving
+ * the newest change per (shape, table_name, row_id, scope_key) for older data.
+ *
+ * Dialect-specific implementation lives in `ServerSyncDialect.compactChanges`.
+ */
+import type { DbExecutor, ServerSyncDialect } from './dialect/types';
+import type { SyncCoreDb } from './schema';
+export interface CompactOptions {
+    /**
+     * Keep full (non-compacted) history for the most recent N hours.
+     * Older history may be compacted depending on dialect strategy.
+     */
+    fullHistoryHours: number;
+}
+export declare function compactChanges<DB extends SyncCoreDb>(db: DbExecutor<DB>, args: {
+    dialect: ServerSyncDialect;
+    options: CompactOptions;
+}): Promise<number>;
+export declare function maybeCompactChanges<DB extends SyncCoreDb>(db: DbExecutor<DB>, args: {
+    dialect: ServerSyncDialect;
+    minIntervalMs: number;
+    options: CompactOptions;
+}): Promise<number>;
+//# sourceMappingURL=compaction.d.ts.map

package/dist/compaction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compaction.d.ts","sourceRoot":"","sources":["../src/compaction.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACrE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAE3C,MAAM,WAAW,cAAc;IAC7B;;;OAGG;IACH,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED,wBAAsB,cAAc,CAAC,EAAE,SAAS,UAAU,EACxD,EAAE,EAAE,UAAU,CAAC,EAAE,CAAC,EAClB,IAAI,EAAE;IAAE,OAAO,EAAE,iBAAiB,CAAC;IAAC,OAAO,EAAE,cAAc,CAAA;CAAE,GAC5D,OAAO,CAAC,MAAM,CAAC,CAIjB;AAqBD,wBAAsB,mBAAmB,CAAC,EAAE,SAAS,UAAU,EAC7D,EAAE,EAAE,UAAU,CAAC,EAAE,CAAC,EAClB,IAAI,EAAE;IACJ,OAAO,EAAE,iBAAiB,CAAC;IAC3B,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,cAAc,CAAC;CACzB,GACA,OAAO,CAAC,MAAM,CAAC,CAqBjB"}

package/dist/compaction.js

@@ -0,0 +1,49 @@
+/**
+ * @syncular/server - Change-log compaction utilities
+ *
+ * Compaction reduces storage by deleting intermediate history while preserving
+ * the newest change per (shape, table_name, row_id, scope_key) for older data.
+ *
+ * Dialect-specific implementation lives in `ServerSyncDialect.compactChanges`.
+ */
+export async function compactChanges(db, args) {
+    const fullHistoryHours = Math.max(0, args.options.fullHistoryHours);
+    if (fullHistoryHours <= 0)
+        return 0;
+    return args.dialect.compactChanges(db, { fullHistoryHours });
+}
+const compactStateByDb = new WeakMap();
+function getCompactState(db) {
+    const existing = compactStateByDb.get(db);
+    if (existing)
+        return existing;
+    const created = {
+        lastCompactAtMs: 0,
+        compactInFlight: null,
+    };
+    compactStateByDb.set(db, created);
+    return created;
+}
+export async function maybeCompactChanges(db, args) {
+    const state = getCompactState(db);
+    const now = Date.now();
+    if (now - state.lastCompactAtMs < args.minIntervalMs)
+        return 0;
+    if (state.compactInFlight)
+        return state.compactInFlight;
+    state.compactInFlight = (async () => {
+        try {
+            const deleted = await compactChanges(db, {
+                dialect: args.dialect,
+                options: args.options,
+            });
+            state.lastCompactAtMs = Date.now();
+            return deleted;
+        }
+        finally {
+            state.compactInFlight = null;
+        }
+    })();
+    return state.compactInFlight;
+}
+//# sourceMappingURL=compaction.js.map

package/dist/compaction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compaction.js","sourceRoot":"","sources":["../src/compaction.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAaH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,EAAkB,EAClB,IAA6D,EAC5C;IACjB,MAAM,gBAAgB,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC;IACpE,IAAI,gBAAgB,IAAI,CAAC;QAAE,OAAO,CAAC,CAAC;IACpC,OAAO,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC,EAAE,EAAE,EAAE,gBAAgB,EAAE,CAAC,CAAC;AAAA,CAC9D;AAOD,MAAM,gBAAgB,GAAG,IAAI,OAAO,EAAwB,CAAC;AAE7D,SAAS,eAAe,CAAC,EAAU,EAAgB;IACjD,MAAM,QAAQ,GAAG,gBAAgB,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC1C,IAAI,QAAQ;QAAE,OAAO,QAAQ,CAAC;IAE9B,MAAM,OAAO,GAAiB;QAC5B,eAAe,EAAE,CAAC;QAClB,eAAe,EAAE,IAAI;KACtB,CAAC;IACF,gBAAgB,CAAC,GAAG,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;IAClC,OAAO,OAAO,CAAC;AAAA,CAChB;AAED,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,EAAkB,EAClB,IAIC,EACgB;IACjB,MAAM,KAAK,GAAG,eAAe,CAAC,EAAE,CAAC,CAAC;IAClC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACvB,IAAI,GAAG,GAAG,KAAK,CAAC,eAAe,GAAG,IAAI,CAAC,aAAa;QAAE,OAAO,CAAC,CAAC;IAE/D,IAAI,KAAK,CAAC,eAAe;QAAE,OAAO,KAAK,CAAC,eAAe,CAAC;IAExD,KAAK,CAAC,eAAe,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC;QACnC,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,cAAc,CAAC,EAAE,EAAE;gBACvC,OAAO,EAAE,IAAI,CAAC,OAAO;gBACrB,OAAO,EAAE,IAAI,CAAC,OAAO;aACtB,CAAC,CAAC;YACH,KAAK,CAAC,eAAe,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YACnC,OAAO,OAAO,CAAC;QACjB,CAAC;gBAAS,CAAC;YACT,KAAK,CAAC,eAAe,GAAG,IAAI,CAAC;QAC/B,CAAC;IAAA,CACF,CAAC,EAAE,CAAC;IAEL,OAAO,KAAK,CAAC,eAAe,CAAC;AAAA,CAC9B"}

package/dist/dialect/index.d.ts

@@ -0,0 +1,5 @@
+/**
+ * @syncular/server - Dialect exports
+ */
+export * from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/dialect/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/dialect/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,SAAS,CAAC"}

package/dist/dialect/index.js

@@ -0,0 +1,5 @@
+/**
+ * @syncular/server - Dialect exports
+ */
+export * from './types';
+//# sourceMappingURL=index.js.map

package/dist/dialect/index.js.map

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

package/dist/dialect/types.d.ts

@@ -0,0 +1,170 @@
+/**
+ * @syncular/server - Server Sync Dialect Interface
+ *
+ * Abstracts database-specific operations for commit-log sync.
+ * Supports the new JSONB scopes model.
+ */
+import type { ScopeValues, StoredScopes, SyncOp } from '@syncular/core';
+import type { Kysely, Transaction } from 'kysely';
+import type { SyncChangeRow, SyncCommitRow, SyncCoreDb } from '../schema';
+/**
+ * Common database executor type that works with both Kysely and Transaction.
+ * Generic version allows for extended database types that include sync tables.
+ */
+export type DbExecutor<DB extends SyncCoreDb = SyncCoreDb> = Kysely<DB> | Transaction<DB>;
+/**
+ * Supported dialect names.
+ */
+export type ServerSyncDialectName = string;
+export interface ServerSyncDialect {
+    readonly name: ServerSyncDialectName;
+    /** Create sync tables + indexes (idempotent) */
+    ensureSyncSchema<DB extends SyncCoreDb>(db: Kysely<DB>): Promise<void>;
+    /** Create console-specific tables (e.g., sync_request_events) - optional */
+    ensureConsoleSchema?<DB extends SyncCoreDb>(db: Kysely<DB>): Promise<void>;
+    /** Execute callback in a transaction (or directly if transactions not supported). */
+    executeInTransaction<DB extends SyncCoreDb, T>(db: Kysely<DB>, fn: (executor: DbExecutor<DB>) => Promise<T>): Promise<T>;
+    /** Set REPEATABLE READ (or closest equivalent) */
+    setRepeatableRead<DB extends SyncCoreDb>(trx: DbExecutor<DB>): Promise<void>;
+    /** Read the maximum committed commit_seq (0 if none) */
+    readMaxCommitSeq<DB extends SyncCoreDb>(db: DbExecutor<DB>, options?: {
+        partitionId?: string;
+    }): Promise<number>;
+    /** Read the minimum committed commit_seq (0 if none) */
+    readMinCommitSeq<DB extends SyncCoreDb>(db: DbExecutor<DB>, options?: {
+        partitionId?: string;
+    }): Promise<number>;
+    /**
+     * Read the next commit sequence numbers that have changes for the given tables.
+     * Must return commit_seq values in ascending order.
+     */
+    readCommitSeqsForPull<DB extends SyncCoreDb>(db: DbExecutor<DB>, args: {
+        cursor: number;
+        limitCommits: number;
+        tables: string[];
+        partitionId?: string;
+    }): Promise<number[]>;
+    /** Read commit metadata for commit_seq values */
+    readCommits<DB extends SyncCoreDb>(db: DbExecutor<DB>, commitSeqs: number[], options?: {
+        partitionId?: string;
+    }): Promise<SyncCommitRow[]>;
+    /**
+     * Read changes for commit_seq values, filtered by table and scopes.
+     * Uses JSONB filtering for scope matching.
+     */
+    readChangesForCommits<DB extends SyncCoreDb>(db: DbExecutor<DB>, args: {
+        commitSeqs: number[];
+        table: string;
+        scopes: ScopeValues;
+        partitionId?: string;
+    }): Promise<SyncChangeRow[]>;
+    /**
+     * Optimized incremental pull for a subscription.
+     *
+     * Returns change rows joined with commit metadata and filtered by
+     * the subscription's table and scope values.
+     */
+    readIncrementalPullRows<DB extends SyncCoreDb>(db: DbExecutor<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;
+    }>>;
+    /**
+     * Streaming incremental pull for large result sets.
+     *
+     * Yields changes one at a time instead of loading all into memory.
+     * Use this when expecting large numbers of changes.
+     */
+    streamIncrementalPullRows?<DB extends SyncCoreDb>(db: DbExecutor<DB>, args: {
+        table: string;
+        scopes: ScopeValues;
+        cursor: number;
+        limitCommits: 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;
+    }>;
+    /**
+     * Optional compaction of the change log to reduce storage.
+     *
+     * Keeps full history for the most recent N hours.
+     * For older history, keeps only the newest change per (table, row_id, scopes).
+     */
+    compactChanges<DB extends SyncCoreDb>(db: DbExecutor<DB>, args: {
+        fullHistoryHours: number;
+    }): Promise<number>;
+    /**
+     * Record/update a client cursor for tracking and pruning.
+     */
+    recordClientCursor<DB extends SyncCoreDb>(db: DbExecutor<DB>, args: {
+        partitionId?: string;
+        clientId: string;
+        actorId: string;
+        cursor: number;
+        effectiveScopes: ScopeValues;
+    }): Promise<void>;
+    /**
+     * Convert a StoredScopes object to database representation.
+     * For Postgres: returns as-is (native JSONB)
+     * For SQLite: returns JSON.stringify()
+     */
+    scopesToDb(scopes: StoredScopes): unknown;
+    /**
+     * Convert database scopes representation to StoredScopes.
+     */
+    dbToScopes(value: unknown): StoredScopes;
+    /**
+     * Whether the dialect supports SELECT ... FOR UPDATE row locking.
+     * Postgres: true
+     * SQLite: false (uses database-level locking)
+     */
+    readonly supportsForUpdate: boolean;
+    /**
+     * Whether the dialect supports SAVEPOINT / ROLLBACK TO SAVEPOINT.
+     * Postgres/SQLite: true
+     * D1 (Durable Object): false (blocks raw SAVEPOINT statements)
+     */
+    readonly supportsSavepoints: boolean;
+    /**
+     * Read distinct tables from sync_changes for a given commit.
+     * Used for realtime notifications.
+     */
+    readAffectedTablesFromChanges<DB extends SyncCoreDb>(db: DbExecutor<DB>, commitSeq: number, options?: {
+        partitionId?: string;
+    }): Promise<string[]>;
+    /**
+     * Convert database array representation to string[].
+     * For Postgres: returns as-is (native array)
+     * For SQLite: returns JSON.parse() or empty array if null
+     */
+    dbToArray(value: unknown): string[];
+    /**
+     * Convert string[] to database array representation.
+     * For Postgres: returns as-is (native array)
+     * For SQLite: returns JSON.stringify()
+     */
+    arrayToDb(values: string[]): unknown;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/dialect/types.d.ts.map

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

package/dist/dialect/types.js

@@ -0,0 +1,8 @@
+/**
+ * @syncular/server - Server Sync Dialect Interface
+ *
+ * Abstracts database-specific operations for commit-log sync.
+ * Supports the new JSONB scopes model.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/dialect/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/dialect/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/helpers/conflict.d.ts

@@ -0,0 +1,52 @@
+/**
+ * @syncular/server - Conflict result builder
+ *
+ * Helper for building conflict results in server table handlers.
+ */
+import type { ApplyOperationResult } from '../shapes/types';
+export interface BuildConflictResultArgs {
+    /** Index of the operation in the batch */
+    opIndex: number;
+    /** Current server row data */
+    serverRow: unknown;
+    /** Current server version */
+    serverVersion: number;
+    /** Client's base version (what they thought they were updating) */
+    baseVersion: number | null;
+}
+/**
+ * Build a conflict result for applyOperation.
+ *
+ * Use this when the client's base version doesn't match the server's current version,
+ * indicating a concurrent modification conflict.
+ *
+ * @example
+ * ```typescript
+ * const handler: ServerTableHandler = {
+ *   table: 'tasks',
+ *   async applyOperation(ctx, op, opIndex) {
+ *     const existing = await ctx.db
+ *       .selectFrom('tasks')
+ *       .selectAll()
+ *       .where('id', '=', op.row_id)
+ *       .executeTakeFirst();
+ *
+ *     // Check for version conflict
+ *     if (existing && op.base_version !== null && existing.version !== op.base_version) {
+ *       return {
+ *         result: buildConflictResult({
+ *           opIndex,
+ *           serverRow: existing,
+ *           serverVersion: existing.version,
+ *           baseVersion: op.base_version,
+ *         }),
+ *       };
+ *     }
+ *
+ *     // ... apply the operation
+ *   },
+ * };
+ * ```
+ */
+export declare function buildConflictResult(args: BuildConflictResultArgs): ApplyOperationResult['result'];
+//# sourceMappingURL=conflict.d.ts.map

package/dist/helpers/conflict.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conflict.d.ts","sourceRoot":"","sources":["../../src/helpers/conflict.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAE5D,MAAM,WAAW,uBAAuB;IACtC,0CAA0C;IAC1C,OAAO,EAAE,MAAM,CAAC;IAChB,8BAA8B;IAC9B,SAAS,EAAE,OAAO,CAAC;IACnB,6BAA6B;IAC7B,aAAa,EAAE,MAAM,CAAC;IACtB,mEAAmE;IACnE,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,uBAAuB,GAC5B,oBAAoB,CAAC,QAAQ,CAAC,CAQhC"}

package/dist/helpers/conflict.js

@@ -0,0 +1,49 @@
+/**
+ * @syncular/server - Conflict result builder
+ *
+ * Helper for building conflict results in server table handlers.
+ */
+/**
+ * Build a conflict result for applyOperation.
+ *
+ * Use this when the client's base version doesn't match the server's current version,
+ * indicating a concurrent modification conflict.
+ *
+ * @example
+ * ```typescript
+ * const handler: ServerTableHandler = {
+ *   table: 'tasks',
+ *   async applyOperation(ctx, op, opIndex) {
+ *     const existing = await ctx.db
+ *       .selectFrom('tasks')
+ *       .selectAll()
+ *       .where('id', '=', op.row_id)
+ *       .executeTakeFirst();
+ *
+ *     // Check for version conflict
+ *     if (existing && op.base_version !== null && existing.version !== op.base_version) {
+ *       return {
+ *         result: buildConflictResult({
+ *           opIndex,
+ *           serverRow: existing,
+ *           serverVersion: existing.version,
+ *           baseVersion: op.base_version,
+ *         }),
+ *       };
+ *     }
+ *
+ *     // ... apply the operation
+ *   },
+ * };
+ * ```
+ */
+export function buildConflictResult(args) {
+    return {
+        opIndex: args.opIndex,
+        status: 'conflict',
+        message: `Version conflict: server=${args.serverVersion}, base=${args.baseVersion}`,
+        server_version: args.serverVersion,
+        server_row: args.serverRow,
+    };
+}
+//# sourceMappingURL=conflict.js.map

package/dist/helpers/conflict.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conflict.js","sourceRoot":"","sources":["../../src/helpers/conflict.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAeH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,MAAM,UAAU,mBAAmB,CACjC,IAA6B,EACG;IAChC,OAAO;QACL,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,MAAM,EAAE,UAAU;QAClB,OAAO,EAAE,4BAA4B,IAAI,CAAC,aAAa,UAAU,IAAI,CAAC,WAAW,EAAE;QACnF,cAAc,EAAE,IAAI,CAAC,aAAa;QAClC,UAAU,EAAE,IAAI,CAAC,SAAS;KAC3B,CAAC;AAAA,CACH"}