@syncular/client 0.0.1-60

package/dist/proxy/connection.d.ts

@@ -0,0 +1,33 @@
+/**
+ * @syncular/client - Proxy Connection
+ *
+ * DatabaseConnection implementation that proxies queries over WebSocket.
+ */
+import type { CompiledQuery, DatabaseConnection, QueryResult } from 'kysely';
+/**
+ * WebSocket wrapper that handles reconnection and message correlation.
+ */
+export declare class ProxyConnection implements DatabaseConnection {
+    private actorId;
+    private clientId;
+    private ws;
+    private messageId;
+    private pendingRequests;
+    private handshakeComplete;
+    private handshakePromise;
+    private handshakeResolve;
+    private handshakeReject;
+    private closed;
+    constructor(ws: WebSocket, actorId: string, clientId: string);
+    private handleMessage;
+    private rejectAllPending;
+    private send;
+    private nextMessageId;
+    executeQuery<R>(query: CompiledQuery): Promise<QueryResult<R>>;
+    beginTransaction(): Promise<void>;
+    commitTransaction(): Promise<void>;
+    rollbackTransaction(): Promise<void>;
+    streamQuery<R>(): AsyncIterableIterator<QueryResult<R>>;
+    close(): void;
+}
+//# sourceMappingURL=connection.d.ts.map

package/dist/proxy/connection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection.d.ts","sourceRoot":"","sources":["../../src/proxy/connection.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAQH,OAAO,KAAK,EAAE,aAAa,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AAE7E;;GAEG;AACH,qBAAa,eAAgB,YAAW,kBAAkB;IAkBtD,OAAO,CAAC,OAAO;IACf,OAAO,CAAC,QAAQ;IAlBlB,OAAO,CAAC,EAAE,CAAY;IACtB,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,eAAe,CAMnB;IACJ,OAAO,CAAC,iBAAiB,CAAS;IAClC,OAAO,CAAC,gBAAgB,CAAgB;IACxC,OAAO,CAAC,gBAAgB,CAA6B;IACrD,OAAO,CAAC,eAAe,CAAyC;IAChE,OAAO,CAAC,MAAM,CAAS;IAEvB,YACE,EAAE,EAAE,SAAS,EACL,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAqCzB;IAED,OAAO,CAAC,aAAa;IA4BrB,OAAO,CAAC,gBAAgB;YAOV,IAAI;IAclB,OAAO,CAAC,aAAa;IAIf,YAAY,CAAC,CAAC,EAAE,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAiBnE;IAEK,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC,CAStC;IAEK,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC,CASvC;IAEK,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC,CASzC;IAED,WAAW,CAAC,CAAC,KAAK,qBAAqB,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAEtD;IAED,KAAK,IAAI,IAAI,CAKZ;CACF"}

package/dist/proxy/connection.js

@@ -0,0 +1,153 @@
+/**
+ * @syncular/client - Proxy Connection
+ *
+ * DatabaseConnection implementation that proxies queries over WebSocket.
+ */
+/**
+ * WebSocket wrapper that handles reconnection and message correlation.
+ */
+export class ProxyConnection {
+    actorId;
+    clientId;
+    ws;
+    messageId = 0;
+    pendingRequests = new Map();
+    handshakeComplete = false;
+    handshakePromise;
+    handshakeResolve = null;
+    handshakeReject = null;
+    closed = false;
+    constructor(ws, actorId, clientId) {
+        this.actorId = actorId;
+        this.clientId = clientId;
+        this.ws = ws;
+        this.handshakePromise = new Promise((resolve, reject) => {
+            this.handshakeResolve = resolve;
+            this.handshakeReject = reject;
+        });
+        this.ws.onmessage = (event) => {
+            this.handleMessage(event.data);
+        };
+        this.ws.onerror = (_event) => {
+            const error = new Error('WebSocket error');
+            this.rejectAllPending(error);
+            if (!this.handshakeComplete) {
+                this.handshakeReject?.(error);
+            }
+        };
+        this.ws.onclose = () => {
+            this.closed = true;
+            const error = new Error('WebSocket closed');
+            this.rejectAllPending(error);
+            if (!this.handshakeComplete) {
+                this.handshakeReject?.(error);
+            }
+        };
+        // Send handshake
+        const handshake = {
+            type: 'handshake',
+            actorId: this.actorId,
+            clientId: this.clientId,
+        };
+        this.ws.send(JSON.stringify(handshake));
+    }
+    handleMessage(data) {
+        try {
+            const message = JSON.parse(data);
+            // Handle handshake acknowledgement
+            if (message.type === 'handshake_ack') {
+                const ack = message;
+                if (ack.ok) {
+                    this.handshakeComplete = true;
+                    this.handshakeResolve?.();
+                }
+                else {
+                    this.handshakeReject?.(new Error(ack.error ?? 'Handshake failed'));
+                }
+                return;
+            }
+            // Handle query responses
+            const response = message;
+            const pending = this.pendingRequests.get(response.id);
+            if (pending) {
+                this.pendingRequests.delete(response.id);
+                pending.resolve(response);
+            }
+        }
+        catch {
+            // Ignore malformed messages
+        }
+    }
+    rejectAllPending(error) {
+        for (const pending of this.pendingRequests.values()) {
+            pending.reject(error);
+        }
+        this.pendingRequests.clear();
+    }
+    async send(message) {
+        // Wait for handshake to complete
+        await this.handshakePromise;
+        if (this.closed) {
+            throw new Error('Connection is closed');
+        }
+        return new Promise((resolve, reject) => {
+            this.pendingRequests.set(message.id, { resolve, reject });
+            this.ws.send(JSON.stringify(message));
+        });
+    }
+    nextMessageId() {
+        return `${++this.messageId}`;
+    }
+    async executeQuery(query) {
+        const response = await this.send({
+            id: this.nextMessageId(),
+            type: 'query',
+            sql: query.sql,
+            parameters: query.parameters,
+        });
+        if (response.type === 'error') {
+            throw new Error(response.error ?? 'Query failed');
+        }
+        return {
+            rows: (response.rows ?? []),
+            numAffectedRows: response.rowCount != null ? BigInt(response.rowCount) : undefined,
+        };
+    }
+    async beginTransaction() {
+        const response = await this.send({
+            id: this.nextMessageId(),
+            type: 'begin',
+        });
+        if (response.type === 'error') {
+            throw new Error(response.error ?? 'Failed to begin transaction');
+        }
+    }
+    async commitTransaction() {
+        const response = await this.send({
+            id: this.nextMessageId(),
+            type: 'commit',
+        });
+        if (response.type === 'error') {
+            throw new Error(response.error ?? 'Failed to commit transaction');
+        }
+    }
+    async rollbackTransaction() {
+        const response = await this.send({
+            id: this.nextMessageId(),
+            type: 'rollback',
+        });
+        if (response.type === 'error') {
+            throw new Error(response.error ?? 'Failed to rollback transaction');
+        }
+    }
+    streamQuery() {
+        throw new Error('Streaming queries are not supported over proxy');
+    }
+    close() {
+        if (!this.closed) {
+            this.closed = true;
+            this.ws.close();
+        }
+    }
+}
+//# sourceMappingURL=connection.js.map

package/dist/proxy/connection.js.map

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

package/dist/proxy/dialect.d.ts

@@ -0,0 +1,46 @@
+/**
+ * @syncular/client - Proxy Dialect
+ *
+ * Kysely Dialect that proxies queries over WebSocket to a sync server.
+ */
+import type { Dialect } from 'kysely';
+import { type ProxyDriverConfigWithFactory } from './driver';
+interface ProxyDialectConfig extends ProxyDriverConfigWithFactory {
+}
+/**
+ * Creates a Kysely dialect that proxies queries over WebSocket.
+ *
+ * This dialect uses PostgreSQL query compilation and adapters since
+ * the proxy server typically runs against a PostgreSQL database.
+ *
+ * @example
+ * ```typescript
+ * import { Kysely } from 'kysely';
+ * import { createProxyDialect } from '@syncular/client/proxy';
+ *
+ * const db = new Kysely<MySchema>({
+ *   dialect: createProxyDialect({
+ *     endpoint: 'wss://api.example.com/proxy',
+ *     actorId: 'admin:worker',
+ *     clientId: 'cf-worker-123',
+ *     headers: { authorization: 'Bearer ...' },
+ *   }),
+ * });
+ *
+ * // Full Kysely API works
+ * const tasks = await db.selectFrom('tasks').selectAll().execute();
+ *
+ * // Transactions work
+ * await db.transaction().execute(async (trx) => {
+ *   const user = await trx.selectFrom('users')
+ *     .where('id', '=', 'u1')
+ *     .executeTakeFirst();
+ *   await trx.insertInto('tasks')
+ *     .values({ id: 'x', user_id: user.id, title: 'New' })
+ *     .execute();
+ * });
+ * ```
+ */
+export declare function createProxyDialect(config: ProxyDialectConfig): Dialect;
+export {};
+//# sourceMappingURL=dialect.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dialect.d.ts","sourceRoot":"","sources":["../../src/proxy/dialect.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAEV,OAAO,EAKR,MAAM,QAAQ,CAAC;AAMhB,OAAO,EAAe,KAAK,4BAA4B,EAAE,MAAM,UAAU,CAAC;AAE1E,UAAU,kBAAmB,SAAQ,4BAA4B;CAAG;AAEpE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAkBtE"}

package/dist/proxy/dialect.js

@@ -0,0 +1,58 @@
+/**
+ * @syncular/client - Proxy Dialect
+ *
+ * Kysely Dialect that proxies queries over WebSocket to a sync server.
+ */
+import { PostgresAdapter, PostgresIntrospector, PostgresQueryCompiler, } from 'kysely';
+import { ProxyDriver } from './driver';
+/**
+ * Creates a Kysely dialect that proxies queries over WebSocket.
+ *
+ * This dialect uses PostgreSQL query compilation and adapters since
+ * the proxy server typically runs against a PostgreSQL database.
+ *
+ * @example
+ * ```typescript
+ * import { Kysely } from 'kysely';
+ * import { createProxyDialect } from '@syncular/client/proxy';
+ *
+ * const db = new Kysely<MySchema>({
+ *   dialect: createProxyDialect({
+ *     endpoint: 'wss://api.example.com/proxy',
+ *     actorId: 'admin:worker',
+ *     clientId: 'cf-worker-123',
+ *     headers: { authorization: 'Bearer ...' },
+ *   }),
+ * });
+ *
+ * // Full Kysely API works
+ * const tasks = await db.selectFrom('tasks').selectAll().execute();
+ *
+ * // Transactions work
+ * await db.transaction().execute(async (trx) => {
+ *   const user = await trx.selectFrom('users')
+ *     .where('id', '=', 'u1')
+ *     .executeTakeFirst();
+ *   await trx.insertInto('tasks')
+ *     .values({ id: 'x', user_id: user.id, title: 'New' })
+ *     .execute();
+ * });
+ * ```
+ */
+export function createProxyDialect(config) {
+    return {
+        createDriver() {
+            return new ProxyDriver(config);
+        },
+        createQueryCompiler() {
+            return new PostgresQueryCompiler();
+        },
+        createAdapter() {
+            return new PostgresAdapter();
+        },
+        createIntrospector(db) {
+            return new PostgresIntrospector(db);
+        },
+    };
+}
+//# sourceMappingURL=dialect.js.map

package/dist/proxy/dialect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dialect.js","sourceRoot":"","sources":["../../src/proxy/dialect.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAUH,OAAO,EACL,eAAe,EACf,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,QAAQ,CAAC;AAChB,OAAO,EAAE,WAAW,EAAqC,MAAM,UAAU,CAAC;AAI1E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,MAAM,UAAU,kBAAkB,CAAC,MAA0B,EAAW;IACtE,OAAO;QACL,YAAY,GAAW;YACrB,OAAO,IAAI,WAAW,CAAC,MAAM,CAAC,CAAC;QAAA,CAChC;QAED,mBAAmB,GAAkB;YACnC,OAAO,IAAI,qBAAqB,EAAE,CAAC;QAAA,CACpC;QAED,aAAa,GAAmB;YAC9B,OAAO,IAAI,eAAe,EAAE,CAAC;QAAA,CAC9B;QAED,kBAAkB,CAAC,EAAe,EAAwB;YACxD,OAAO,IAAI,oBAAoB,CAAC,EAAE,CAAC,CAAC;QAAA,CACrC;KACF,CAAC;AAAA,CACH"}

package/dist/proxy/driver.d.ts

@@ -0,0 +1,42 @@
+/**
+ * @syncular/client - Proxy Driver
+ *
+ * Kysely Driver that creates WebSocket connections for query execution.
+ */
+import type { DatabaseConnection, Driver } from 'kysely';
+interface ProxyDriverConfig {
+    /** WebSocket endpoint URL (wss://...) */
+    endpoint: string;
+    /** Actor ID for oplog tracking */
+    actorId: string;
+    /** Client ID for oplog tracking */
+    clientId: string;
+    /** Optional headers for authentication */
+    headers?: Record<string, string>;
+}
+/**
+ * Custom WebSocket factory type for environments that need it.
+ */
+export type WebSocketFactory = (url: string, protocols?: string | string[]) => WebSocket;
+/**
+ * Extended config with optional WebSocket factory.
+ */
+export interface ProxyDriverConfigWithFactory extends ProxyDriverConfig {
+    /** Optional WebSocket factory for custom environments */
+    createWebSocket?: WebSocketFactory;
+}
+export declare class ProxyDriver implements Driver {
+    private config;
+    private connection;
+    constructor(config: ProxyDriverConfigWithFactory);
+    init(): Promise<void>;
+    acquireConnection(): Promise<DatabaseConnection>;
+    private createWebSocket;
+    beginTransaction(connection: DatabaseConnection): Promise<void>;
+    commitTransaction(connection: DatabaseConnection): Promise<void>;
+    rollbackTransaction(connection: DatabaseConnection): Promise<void>;
+    releaseConnection(): Promise<void>;
+    destroy(): Promise<void>;
+}
+export {};
+//# sourceMappingURL=driver.d.ts.map

package/dist/proxy/driver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"driver.d.ts","sourceRoot":"","sources":["../../src/proxy/driver.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAGzD,UAAU,iBAAiB;IACzB,yCAAyC;IACzC,QAAQ,EAAE,MAAM,CAAC;IACjB,kCAAkC;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,mCAAmC;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,0CAA0C;IAC1C,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAC7B,GAAG,EAAE,MAAM,EACX,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,KAC1B,SAAS,CAAC;AAEf;;GAEG;AACH,MAAM,WAAW,4BAA6B,SAAQ,iBAAiB;IACrE,yDAAyD;IACzD,eAAe,CAAC,EAAE,gBAAgB,CAAC;CACpC;AAED,qBAAa,WAAY,YAAW,MAAM;IAG5B,OAAO,CAAC,MAAM;IAF1B,OAAO,CAAC,UAAU,CAAgC;IAElD,YAAoB,MAAM,EAAE,4BAA4B,EAAI;IAEtD,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAE1B;IAEK,iBAAiB,IAAI,OAAO,CAAC,kBAAkB,CAAC,CAarD;YAEa,eAAe;IA2CvB,gBAAgB,CAAC,UAAU,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAEpE;IAEK,iBAAiB,CAAC,UAAU,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAErE;IAEK,mBAAmB,CAAC,UAAU,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAEvE;IAEK,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC,CAEvC;IAEK,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAK7B;CACF"}

package/dist/proxy/driver.js

@@ -0,0 +1,78 @@
+/**
+ * @syncular/client - Proxy Driver
+ *
+ * Kysely Driver that creates WebSocket connections for query execution.
+ */
+import { ProxyConnection } from './connection';
+export class ProxyDriver {
+    config;
+    connection = null;
+    constructor(config) {
+        this.config = config;
+    }
+    async init() {
+        // No initialization needed
+    }
+    async acquireConnection() {
+        // Reuse existing connection if available
+        if (this.connection) {
+            return this.connection;
+        }
+        const ws = await this.createWebSocket();
+        this.connection = new ProxyConnection(ws, this.config.actorId, this.config.clientId);
+        return this.connection;
+    }
+    async createWebSocket() {
+        return new Promise((resolve, reject) => {
+            // Build URL with auth info if needed
+            const url = new URL(this.config.endpoint);
+            // Note: WebSocket doesn't support custom headers directly,
+            // so auth is typically done via query params or after connection
+            // The server should handle auth during the handshake
+            if (this.config.headers?.authorization) {
+                url.searchParams.set('authorization', this.config.headers.authorization);
+            }
+            let ws;
+            if (this.config.createWebSocket) {
+                ws = this.config.createWebSocket(url.toString());
+            }
+            else {
+                ws = new WebSocket(url.toString());
+            }
+            ws.onopen = () => {
+                resolve(ws);
+            };
+            ws.onerror = (_event) => {
+                reject(new Error('Failed to connect to proxy endpoint'));
+            };
+            // Set a connection timeout
+            const timeout = setTimeout(() => {
+                ws.close();
+                reject(new Error('Connection timeout'));
+            }, 30000);
+            ws.onopen = () => {
+                clearTimeout(timeout);
+                resolve(ws);
+            };
+        });
+    }
+    async beginTransaction(connection) {
+        await connection.beginTransaction();
+    }
+    async commitTransaction(connection) {
+        await connection.commitTransaction();
+    }
+    async rollbackTransaction(connection) {
+        await connection.rollbackTransaction();
+    }
+    async releaseConnection() {
+        // Keep the connection alive for reuse
+    }
+    async destroy() {
+        if (this.connection) {
+            this.connection.close();
+            this.connection = null;
+        }
+    }
+}
+//# sourceMappingURL=driver.js.map

package/dist/proxy/driver.js.map

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

package/dist/proxy/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @syncular/client - Proxy Dialect Exports
+ *
+ * Kysely dialect for proxying queries over WebSocket to a sync server.
+ */
+export * from './connection';
+export * from './dialect';
+export * from './driver';
+export * from './mutations';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/proxy/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC"}

package/dist/proxy/index.js

@@ -0,0 +1,10 @@
+/**
+ * @syncular/client - Proxy Dialect Exports
+ *
+ * Kysely dialect for proxying queries over WebSocket to a sync server.
+ */
+export * from './connection';
+export * from './dialect';
+export * from './driver';
+export * from './mutations';
+//# sourceMappingURL=index.js.map

package/dist/proxy/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/proxy/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC"}

package/dist/proxy/mutations.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @syncular/client - Proxy mutations
+ *
+ * Exposes the same Proxy-based mutation interface as the offline client,
+ * but pushes commits to the server immediately (no local outbox/db writes).
+ */
+import { type MutationsApi, type PushCommitConfig } from '../mutations';
+export declare function createProxyMutations<DB extends Record<string, any>>(config: PushCommitConfig): MutationsApi<DB, undefined>;
+//# sourceMappingURL=mutations.d.ts.map

package/dist/proxy/mutations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mutations.d.ts","sourceRoot":"","sources":["../../src/proxy/mutations.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAEL,KAAK,YAAY,EACjB,KAAK,gBAAgB,EACtB,MAAM,cAAc,CAAC;AAEtB,wBAAgB,oBAAoB,CAAC,EAAE,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACjE,MAAM,EAAE,gBAAgB,GACvB,YAAY,CAAC,EAAE,EAAE,SAAS,CAAC,CAE7B"}

package/dist/proxy/mutations.js

@@ -0,0 +1,11 @@
+/**
+ * @syncular/client - Proxy mutations
+ *
+ * Exposes the same Proxy-based mutation interface as the offline client,
+ * but pushes commits to the server immediately (no local outbox/db writes).
+ */
+import { createPushMutations, } from '../mutations';
+export function createProxyMutations(config) {
+    return createPushMutations(config);
+}
+//# sourceMappingURL=mutations.js.map

package/dist/proxy/mutations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mutations.js","sourceRoot":"","sources":["../../src/proxy/mutations.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,mBAAmB,GAGpB,MAAM,cAAc,CAAC;AAEtB,MAAM,UAAU,oBAAoB,CAClC,MAAwB,EACK;IAC7B,OAAO,mBAAmB,CAAC,MAAM,CAAC,CAAC;AAAA,CACpC"}

package/dist/pull-engine.d.ts

@@ -0,0 +1,45 @@
+/**
+ * @syncular/client - Sync pull engine
+ */
+import type { SyncPullRequest, SyncPullResponse, SyncSubscriptionRequest, SyncTransport } from '@syncular/core';
+import { type Kysely } from 'kysely';
+import type { ClientTableRegistry } from './handlers/registry';
+import type { SyncClientPlugin } from './plugins/types';
+import type { SyncClientDb, SyncSubscriptionStateTable } from './schema';
+export interface SyncPullOnceOptions {
+    clientId: string;
+    actorId?: string;
+    plugins?: SyncClientPlugin[];
+    /**
+     * Desired subscriptions (client-chosen ids).
+     * Cursors are persisted in `sync_subscription_state`.
+     */
+    subscriptions: Array<Omit<SyncSubscriptionRequest, 'cursor'>>;
+    limitCommits?: number;
+    limitSnapshotRows?: number;
+    maxSnapshotPages?: number;
+    dedupeRows?: boolean;
+    stateId?: string;
+}
+/**
+ * Build a pull request from subscription state. Exported for use
+ * by the combined sync path in sync-loop.ts.
+ */
+export declare function buildPullRequest<DB extends SyncClientDb>(db: Kysely<DB>, options: SyncPullOnceOptions): Promise<{
+    request: SyncPullRequest;
+    existing: SyncSubscriptionStateTable[];
+    existingById: Map<string, SyncSubscriptionStateTable>;
+    stateId: string;
+}>;
+/**
+ * Apply a pull response (run plugins + write to local DB).
+ * Exported for use by the combined sync path in sync-loop.ts.
+ */
+export declare function applyPullResponse<DB extends SyncClientDb>(db: Kysely<DB>, transport: SyncTransport, shapes: ClientTableRegistry<DB>, options: SyncPullOnceOptions, pullState: {
+    request: SyncPullRequest;
+    existing: SyncSubscriptionStateTable[];
+    existingById: Map<string, SyncSubscriptionStateTable>;
+    stateId: string;
+}, rawResponse: SyncPullResponse): Promise<SyncPullResponse>;
+export declare function syncPullOnce<DB extends SyncClientDb>(db: Kysely<DB>, transport: SyncTransport, shapes: ClientTableRegistry<DB>, options: SyncPullOnceOptions): Promise<SyncPullResponse>;
+//# sourceMappingURL=pull-engine.d.ts.map

package/dist/pull-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pull-engine.d.ts","sourceRoot":"","sources":["../src/pull-engine.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAEV,eAAe,EACf,gBAAgB,EAChB,uBAAuB,EACvB,aAAa,EACd,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,KAAK,MAAM,EAAO,MAAM,QAAQ,CAAC;AAC1C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC/D,OAAO,KAAK,EACV,gBAAgB,EAEjB,MAAM,iBAAiB,CAAC;AACzB,OAAO,KAAK,EAAE,YAAY,EAAE,0BAA0B,EAAE,MAAM,UAAU,CAAC;AAkOzE,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAC7B;;;OAGG;IACH,aAAa,EAAE,KAAK,CAAC,IAAI,CAAC,uBAAuB,EAAE,QAAQ,CAAC,CAAC,CAAC;IAC9D,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CAAC,EAAE,SAAS,YAAY,EAC5D,EAAE,EAAE,MAAM,CAAC,EAAE,CAAC,EACd,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC;IACT,OAAO,EAAE,eAAe,CAAC;IACzB,QAAQ,EAAE,0BAA0B,EAAE,CAAC;IACvC,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,0BAA0B,CAAC,CAAC;IACtD,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC,CAuCD;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,CAAC,EAAE,SAAS,YAAY,EAC7D,EAAE,EAAE,MAAM,CAAC,EAAE,CAAC,EACd,SAAS,EAAE,aAAa,EACxB,MAAM,EAAE,mBAAmB,CAAC,EAAE,CAAC,EAC/B,OAAO,EAAE,mBAAmB,EAC5B,SAAS,EAAE;IACT,OAAO,EAAE,eAAe,CAAC;IACzB,QAAQ,EAAE,0BAA0B,EAAE,CAAC;IACvC,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,0BAA0B,CAAC,CAAC;IACtD,OAAO,EAAE,MAAM,CAAC;CACjB,EACD,WAAW,EAAE,gBAAgB,GAC5B,OAAO,CAAC,gBAAgB,CAAC,CAuK3B;AAED,wBAAsB,YAAY,CAAC,EAAE,SAAS,YAAY,EACxD,EAAE,EAAE,MAAM,CAAC,EAAE,CAAC,EACd,SAAS,EAAE,aAAa,EACxB,MAAM,EAAE,mBAAmB,CAAC,EAAE,CAAC,EAC/B,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,gBAAgB,CAAC,CAe3B"}