@syncular/client 0.0.1-60

package/dist/query/QueryContext.d.ts

@@ -0,0 +1,33 @@
+/**
+ * @syncular/client - Query Context
+ *
+ * Provides a query context with tracked selectFrom for scope tracking
+ * and automatic fingerprint generation.
+ */
+import type { Kysely } from 'kysely';
+import type { SyncClientDb } from '../schema';
+import type { FingerprintCollector } from './FingerprintCollector';
+import type { MutationTimestampSource } from './fingerprint';
+import { createTrackedSelectFrom } from './tracked-select';
+export type TrackedSelectFrom<DB> = ReturnType<typeof createTrackedSelectFrom<DB>>;
+/**
+ * Query context provided to query functions.
+ *
+ * Only `selectFrom` is exposed to ensure proper scope tracking and fingerprinting.
+ * If you need raw database access, use the db directly outside the query function.
+ */
+export interface QueryContext<DB extends SyncClientDb = SyncClientDb> {
+    /**
+     * Wrapped selectFrom that:
+     * 1. Registers table as watched scope
+     * 2. Intercepts .execute() to auto-detect fingerprinting mode:
+     *    - Result has keyField (default: 'id')? -> row-level fingerprinting
+     *    - No keyField? -> value-based fingerprinting (for aggregates)
+     */
+    selectFrom: TrackedSelectFrom<DB>;
+}
+/**
+ * Create a query context with tracked selectFrom.
+ */
+export declare function createQueryContext<DB extends SyncClientDb>(db: Kysely<DB>, scopeCollector: Set<string>, fingerprintCollector: FingerprintCollector, engine: MutationTimestampSource, keyField?: string): QueryContext<DB>;
+//# sourceMappingURL=QueryContext.d.ts.map

package/dist/query/QueryContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"QueryContext.d.ts","sourceRoot":"","sources":["../../src/query/QueryContext.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AACrC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AACnE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AAC7D,OAAO,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AAE3D,MAAM,MAAM,iBAAiB,CAAC,EAAE,IAAI,UAAU,CAC5C,OAAO,uBAAuB,CAAC,EAAE,CAAC,CACnC,CAAC;AAEF;;;;;GAKG;AACH,MAAM,WAAW,YAAY,CAAC,EAAE,SAAS,YAAY,GAAG,YAAY;IAClE;;;;;;OAMG;IACH,UAAU,EAAE,iBAAiB,CAAC,EAAE,CAAC,CAAC;CACnC;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,EAAE,SAAS,YAAY,EACxD,EAAE,EAAE,MAAM,CAAC,EAAE,CAAC,EACd,cAAc,EAAE,GAAG,CAAC,MAAM,CAAC,EAC3B,oBAAoB,EAAE,oBAAoB,EAC1C,MAAM,EAAE,uBAAuB,EAC/B,QAAQ,SAAO,GACd,YAAY,CAAC,EAAE,CAAC,CAUlB"}

package/dist/query/QueryContext.js

@@ -0,0 +1,16 @@
+/**
+ * @syncular/client - Query Context
+ *
+ * Provides a query context with tracked selectFrom for scope tracking
+ * and automatic fingerprint generation.
+ */
+import { createTrackedSelectFrom } from './tracked-select';
+/**
+ * Create a query context with tracked selectFrom.
+ */
+export function createQueryContext(db, scopeCollector, fingerprintCollector, engine, keyField = 'id') {
+    return {
+        selectFrom: createTrackedSelectFrom(db, scopeCollector, fingerprintCollector, engine, keyField),
+    };
+}
+//# sourceMappingURL=QueryContext.js.map

package/dist/query/QueryContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"QueryContext.js","sourceRoot":"","sources":["../../src/query/QueryContext.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,OAAO,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AAuB3D;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAChC,EAAc,EACd,cAA2B,EAC3B,oBAA0C,EAC1C,MAA+B,EAC/B,QAAQ,GAAG,IAAI,EACG;IAClB,OAAO;QACL,UAAU,EAAE,uBAAuB,CACjC,EAAE,EACF,cAAc,EACd,oBAAoB,EACpB,MAAM,EACN,QAAQ,CACT;KACF,CAAC;AAAA,CACH"}

package/dist/query/fingerprint.d.ts

@@ -0,0 +1,61 @@
+/**
+ * @syncular/client - Fingerprint-based rerender optimization utilities
+ *
+ * Provides efficient fingerprint computation for query results to avoid
+ * expensive deep equality checks. Uses mutation timestamps from the SyncEngine.
+ */
+export interface MutationTimestampSource {
+    getMutationTimestamp(table: string, rowId: string): number;
+}
+/**
+ * Compute a fingerprint for query results based on length + ids + mutation timestamps.
+ * Much faster than deep equality for large datasets.
+ *
+ * Fingerprint format: `length:id1@ts1,id2@ts2,...`
+ *
+ * @param rows - Query result rows (must have an id-like field)
+ * @param engine - SyncEngine to look up mutation timestamps
+ * @param table - Table name for timestamp lookup
+ * @param keyField - Field name to use as row identifier (default: 'id')
+ * @returns Fingerprint string for comparison
+ *
+ * @example
+ * ```ts
+ * const fingerprint = computeFingerprint(tasks, engine, 'tasks', 'id');
+ * // Returns: "3:abc@1706123456789,def@1706123456790,ghi@0"
+ * ```
+ */
+export declare function computeFingerprint<T extends Record<string, unknown>>(rows: T[], engine: MutationTimestampSource, table: string, keyField?: string): string;
+/**
+ * Check if rows have the required key field for fingerprinting.
+ * Returns true for empty arrays (no data to fingerprint).
+ *
+ * @param rows - Query result rows to check
+ * @param keyField - Field name to check for (default: 'id')
+ * @returns true if rows can be fingerprinted, false otherwise
+ *
+ * @example
+ * ```ts
+ * // Can fingerprint - rows have 'id' field
+ * canFingerprint([{ id: '1', name: 'foo' }]); // true
+ *
+ * // Cannot fingerprint - rows lack 'id' field (aggregates, etc.)
+ * canFingerprint([{ count: 42 }]); // false
+ * ```
+ */
+export declare function canFingerprint<T>(rows: T[], keyField?: string): boolean;
+/**
+ * Compute row-level fingerprint from query results.
+ * Format: `table:count:id1@ts1,id2@ts2,...`
+ */
+export declare function computeRowFingerprint(rows: unknown[], table: string, engine: MutationTimestampSource, keyField: string): string;
+/**
+ * Compute value-based fingerprint for aggregate/scalar queries.
+ * Format: `table:hash(value)`
+ */
+export declare function computeValueFingerprint(table: string, value: unknown): string;
+/**
+ * Check if result rows have the key field for row-level fingerprinting.
+ */
+export declare function hasKeyField(rows: unknown[], keyField: string): boolean;
+//# sourceMappingURL=fingerprint.d.ts.map

package/dist/query/fingerprint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fingerprint.d.ts","sourceRoot":"","sources":["../../src/query/fingerprint.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,uBAAuB;IACtC,oBAAoB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;CAC5D;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAClE,IAAI,EAAE,CAAC,EAAE,EACT,MAAM,EAAE,uBAAuB,EAC/B,KAAK,EAAE,MAAM,EACb,QAAQ,SAAO,GACd,MAAM,CAWR;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,EAAE,QAAQ,SAAO,GAAG,OAAO,CAGrE;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,OAAO,EAAE,EACf,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,uBAAuB,EAC/B,QAAQ,EAAE,MAAM,GACf,MAAM,CAYR;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,MAAM,CAI7E;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAGtE"}

package/dist/query/fingerprint.js

@@ -0,0 +1,91 @@
+/**
+ * @syncular/client - Fingerprint-based rerender optimization utilities
+ *
+ * Provides efficient fingerprint computation for query results to avoid
+ * expensive deep equality checks. Uses mutation timestamps from the SyncEngine.
+ */
+/**
+ * Compute a fingerprint for query results based on length + ids + mutation timestamps.
+ * Much faster than deep equality for large datasets.
+ *
+ * Fingerprint format: `length:id1@ts1,id2@ts2,...`
+ *
+ * @param rows - Query result rows (must have an id-like field)
+ * @param engine - SyncEngine to look up mutation timestamps
+ * @param table - Table name for timestamp lookup
+ * @param keyField - Field name to use as row identifier (default: 'id')
+ * @returns Fingerprint string for comparison
+ *
+ * @example
+ * ```ts
+ * const fingerprint = computeFingerprint(tasks, engine, 'tasks', 'id');
+ * // Returns: "3:abc@1706123456789,def@1706123456790,ghi@0"
+ * ```
+ */
+export function computeFingerprint(rows, engine, table, keyField = 'id') {
+    if (rows.length === 0)
+        return '0:';
+    const parts = [];
+    for (const row of rows) {
+        const id = String(row[keyField] ?? '');
+        const ts = engine.getMutationTimestamp(table, id);
+        parts.push(`${id}@${ts}`);
+    }
+    return `${rows.length}:${parts.join(',')}`;
+}
+/**
+ * Check if rows have the required key field for fingerprinting.
+ * Returns true for empty arrays (no data to fingerprint).
+ *
+ * @param rows - Query result rows to check
+ * @param keyField - Field name to check for (default: 'id')
+ * @returns true if rows can be fingerprinted, false otherwise
+ *
+ * @example
+ * ```ts
+ * // Can fingerprint - rows have 'id' field
+ * canFingerprint([{ id: '1', name: 'foo' }]); // true
+ *
+ * // Cannot fingerprint - rows lack 'id' field (aggregates, etc.)
+ * canFingerprint([{ count: 42 }]); // false
+ * ```
+ */
+export function canFingerprint(rows, keyField = 'id') {
+    if (rows.length === 0)
+        return true;
+    return keyField in rows[0];
+}
+/**
+ * Compute row-level fingerprint from query results.
+ * Format: `table:count:id1@ts1,id2@ts2,...`
+ */
+export function computeRowFingerprint(rows, table, engine, keyField) {
+    if (rows.length === 0)
+        return `${table}:0:`;
+    const parts = [];
+    for (const row of rows) {
+        const r = row;
+        const id = String(r[keyField] ?? '');
+        const ts = engine.getMutationTimestamp(table, id);
+        parts.push(`${id}@${ts}`);
+    }
+    return `${table}:${rows.length}:${parts.join(',')}`;
+}
+/**
+ * Compute value-based fingerprint for aggregate/scalar queries.
+ * Format: `table:hash(value)`
+ */
+export function computeValueFingerprint(table, value) {
+    // Simple hash of the JSON representation
+    const json = JSON.stringify(value);
+    return `${table}:${json}`;
+}
+/**
+ * Check if result rows have the key field for row-level fingerprinting.
+ */
+export function hasKeyField(rows, keyField) {
+    if (rows.length === 0)
+        return false;
+    return keyField in rows[0];
+}
+//# sourceMappingURL=fingerprint.js.map

package/dist/query/fingerprint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fingerprint.js","sourceRoot":"","sources":["../../src/query/fingerprint.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,kBAAkB,CAChC,IAAS,EACT,MAA+B,EAC/B,KAAa,EACb,QAAQ,GAAG,IAAI,EACP;IACR,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAEnC,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,MAAM,EAAE,GAAG,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;QACvC,MAAM,EAAE,GAAG,MAAM,CAAC,oBAAoB,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QAClD,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC;IAC5B,CAAC;IAED,OAAO,GAAG,IAAI,CAAC,MAAM,IAAI,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;AAAA,CAC5C;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,cAAc,CAAI,IAAS,EAAE,QAAQ,GAAG,IAAI,EAAW;IACrE,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACnC,OAAO,QAAQ,IAAK,IAAI,CAAC,CAAC,CAA6B,CAAC;AAAA,CACzD;AAED;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CACnC,IAAe,EACf,KAAa,EACb,MAA+B,EAC/B,QAAgB,EACR;IACR,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,GAAG,KAAK,KAAK,CAAC;IAE5C,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,MAAM,CAAC,GAAG,GAA8B,CAAC;QACzC,MAAM,EAAE,GAAG,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;QACrC,MAAM,EAAE,GAAG,MAAM,CAAC,oBAAoB,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QAClD,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC;IAC5B,CAAC;IAED,OAAO,GAAG,KAAK,IAAI,IAAI,CAAC,MAAM,IAAI,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;AAAA,CACrD;AAED;;;GAGG;AACH,MAAM,UAAU,uBAAuB,CAAC,KAAa,EAAE,KAAc,EAAU;IAC7E,yCAAyC;IACzC,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IACnC,OAAO,GAAG,KAAK,IAAI,IAAI,EAAE,CAAC;AAAA,CAC3B;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,IAAe,EAAE,QAAgB,EAAW;IACtE,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACpC,OAAO,QAAQ,IAAK,IAAI,CAAC,CAAC,CAA6B,CAAC;AAAA,CACzD"}

package/dist/query/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @syncular/client - Query utilities exports
+ */
+export { FingerprintCollector } from './FingerprintCollector';
+export { canFingerprint, computeFingerprint, } from './fingerprint';
+export { createQueryContext, type QueryContext } from './QueryContext';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/query/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EACL,cAAc,EACd,kBAAkB,GACnB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,kBAAkB,EAAE,KAAK,YAAY,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/query/index.js

@@ -0,0 +1,7 @@
+/**
+ * @syncular/client - Query utilities exports
+ */
+export { FingerprintCollector } from './FingerprintCollector';
+export { canFingerprint, computeFingerprint, } from './fingerprint';
+export { createQueryContext } from './QueryContext';
+//# sourceMappingURL=index.js.map

package/dist/query/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/query/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EACL,cAAc,EACd,kBAAkB,GACnB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,kBAAkB,EAAqB,MAAM,gBAAgB,CAAC"}

package/dist/query/tracked-select.d.ts

@@ -0,0 +1,18 @@
+/**
+ * @syncular/client - Tracked SelectFrom
+ *
+ * Provides a wrapped selectFrom that:
+ * 1. Tracks tables as watched scopes when called
+ * 2. Intercepts .execute() to auto-generate fingerprints
+ */
+import type { Kysely } from 'kysely';
+import type { FingerprintCollector } from './FingerprintCollector';
+/** Portable type alias for Kysely's selectFrom method signature */
+type TrackedSelectFrom<DB> = Kysely<DB>['selectFrom'];
+import { type MutationTimestampSource } from './fingerprint';
+/**
+ * Create a tracked selectFrom that registers scopes and generates fingerprints.
+ */
+export declare function createTrackedSelectFrom<DB>(db: Kysely<DB>, scopeCollector: Set<string>, fingerprintCollector: FingerprintCollector, engine: MutationTimestampSource, keyField?: string): TrackedSelectFrom<DB>;
+export {};
+//# sourceMappingURL=tracked-select.d.ts.map

package/dist/query/tracked-select.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracked-select.d.ts","sourceRoot":"","sources":["../../src/query/tracked-select.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AACrC,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAEnE,mEAAmE;AACnE,KAAK,iBAAiB,CAAC,EAAE,IAAI,MAAM,CAAC,EAAE,CAAC,CAAC,YAAY,CAAC,CAAC;AAEtD,OAAO,EAIL,KAAK,uBAAuB,EAC7B,MAAM,eAAe,CAAC;AA4FvB;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,EAAE,EACxC,EAAE,EAAE,MAAM,CAAC,EAAE,CAAC,EACd,cAAc,EAAE,GAAG,CAAC,MAAM,CAAC,EAC3B,oBAAoB,EAAE,oBAAoB,EAC1C,MAAM,EAAE,uBAAuB,EAC/B,QAAQ,SAAO,GACd,iBAAiB,CAAC,EAAE,CAAC,CAkBvB"}

package/dist/query/tracked-select.js

@@ -0,0 +1,90 @@
+/**
+ * @syncular/client - Tracked SelectFrom
+ *
+ * Provides a wrapped selectFrom that:
+ * 1. Tracks tables as watched scopes when called
+ * 2. Intercepts .execute() to auto-generate fingerprints
+ */
+import { computeRowFingerprint, computeValueFingerprint, hasKeyField, } from './fingerprint';
+function isExecutableQuery(value) {
+    if (typeof value !== 'object' || value === null)
+        return false;
+    return (typeof Reflect.get(value, 'execute') === 'function' &&
+        typeof Reflect.get(value, 'executeTakeFirst') === 'function' &&
+        typeof Reflect.get(value, 'executeTakeFirstOrThrow') === 'function');
+}
+function createExecuteProxy(builder, table, collector, engine, keyField) {
+    return new Proxy(builder, {
+        get(target, prop) {
+            if (prop === 'execute') {
+                return async () => {
+                    const rows = await target.execute();
+                    // Auto-detect fingerprint mode based on result shape
+                    if (Array.isArray(rows)) {
+                        if (hasKeyField(rows, keyField)) {
+                            // Row-level fingerprinting - result has keyField
+                            const fp = computeRowFingerprint(rows, table, engine, keyField);
+                            collector.add(fp);
+                        }
+                        else {
+                            // Value-based fingerprinting - for aggregates/scalars
+                            const fp = computeValueFingerprint(table, rows);
+                            collector.add(fp);
+                        }
+                    }
+                    else {
+                        // Unexpected, but keep rerender behavior deterministic.
+                        const fp = computeValueFingerprint(table, rows);
+                        collector.add(fp);
+                    }
+                    return rows;
+                };
+            }
+            if (prop === 'executeTakeFirst') {
+                return async () => {
+                    const row = await target.executeTakeFirst();
+                    // Value-based fingerprinting for single-row queries
+                    const fp = computeValueFingerprint(table, row);
+                    collector.add(fp);
+                    return row;
+                };
+            }
+            if (prop === 'executeTakeFirstOrThrow') {
+                return async () => {
+                    const row = await target.executeTakeFirstOrThrow();
+                    // Value-based fingerprinting for single-row queries
+                    const fp = computeValueFingerprint(table, row);
+                    collector.add(fp);
+                    return row;
+                };
+            }
+            // For other methods, return wrapped builder for chaining
+            const value = Reflect.get(target, prop, target);
+            if (typeof value === 'function') {
+                return (...args) => {
+                    const result = Reflect.apply(value, target, args);
+                    if (isExecutableQuery(result)) {
+                        return createExecuteProxy(result, table, collector, engine, keyField);
+                    }
+                    return result;
+                };
+            }
+            return value;
+        },
+    });
+}
+/**
+ * Create a tracked selectFrom that registers scopes and generates fingerprints.
+ */
+export function createTrackedSelectFrom(db, scopeCollector, fingerprintCollector, engine, keyField = 'id') {
+    const selectFrom = (table) => {
+        // 1. Register this table as a watched scope
+        scopeCollector.add(table);
+        // 2. Get the real query builder
+        const builder = db.selectFrom(table);
+        // 3. Return a proxy that intercepts .execute()
+        return createExecuteProxy(builder, table, fingerprintCollector, engine, keyField);
+    };
+    return selectFrom;
+}
+//# sourceMappingURL=tracked-select.js.map

package/dist/query/tracked-select.js.map

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

package/dist/schema.d.ts

@@ -0,0 +1,83 @@
+/**
+ * @syncular/client - Sync client schema types (SQLite reference)
+ *
+ * These tables are sync-internal and should not collide with app tables.
+ */
+import type { Generated, Kysely } from 'kysely';
+import type { SyncBlobClientDb } from './blobs/types';
+/**
+ * Database executor type that both Kysely and Transaction satisfy.
+ * Use this when a function needs to work with either a raw Kysely instance
+ * or within a transaction context.
+ */
+export type SyncClientExecutor<DB extends SyncClientDb = SyncClientDb> = Pick<Kysely<DB>, 'selectFrom' | 'insertInto' | 'updateTable' | 'deleteFrom'>;
+export type OutboxCommitStatus = 'pending' | 'sending' | 'acked' | 'failed';
+export type SubscriptionStatus = 'active' | 'revoked';
+export interface SyncSubscriptionStateTable {
+    /** Logical profile id (default: 'default') */
+    state_id: string;
+    /** Subscription identifier (client-chosen) */
+    subscription_id: string;
+    /** Shape name (table) for this subscription */
+    shape: string;
+    /** JSON string of ScopeValues for this subscription */
+    scopes_json: string;
+    /** JSON string of params */
+    params_json: string;
+    /** Per-subscription cursor (last applied commit_seq) */
+    cursor: number;
+    /**
+     * JSON string of SyncBootstrapState (or null).
+     * When set, indicates a paginated bootstrap is in progress for this subscription.
+     */
+    bootstrap_state_json: string | null;
+    /** active | revoked */
+    status: SubscriptionStatus;
+    created_at: number;
+    updated_at: number;
+}
+export interface SyncOutboxCommitsTable {
+    /** Local row id (uuid) */
+    id: string;
+    /** Client-provided idempotency key (uuid) */
+    client_commit_id: string;
+    /** pending | sending | acked | failed */
+    status: OutboxCommitStatus;
+    /** JSON string of SyncOperation[] */
+    operations_json: string;
+    /** JSON string of the last SyncPushResponse (optional) */
+    last_response_json: string | null;
+    /** Last error (if any) */
+    error: string | null;
+    /** Created timestamp (ms since epoch) */
+    created_at: number;
+    /** Updated timestamp (ms since epoch) */
+    updated_at: number;
+    /** How many send attempts have been made */
+    attempt_count: Generated<number>;
+    /** Server commit_seq if acked (optional) */
+    acked_commit_seq: number | null;
+    /** Client schema version when commit was created (default: 1 for legacy) */
+    schema_version: Generated<number>;
+}
+export interface SyncClientDb extends SyncBlobClientDb {
+    sync_subscription_state: SyncSubscriptionStateTable;
+    sync_outbox_commits: SyncOutboxCommitsTable;
+    sync_conflicts: SyncConflictsTable;
+}
+export type ConflictResultStatus = 'conflict' | 'error';
+export interface SyncConflictsTable {
+    id: string;
+    outbox_commit_id: string;
+    client_commit_id: string;
+    op_index: number;
+    result_status: ConflictResultStatus;
+    message: string;
+    code: string | null;
+    server_version: number | null;
+    server_row_json: string | null;
+    created_at: number;
+    resolved_at: number | null;
+    resolution: string | null;
+}
+//# sourceMappingURL=schema.d.ts.map

package/dist/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEtD;;;;GAIG;AACH,MAAM,MAAM,kBAAkB,CAAC,EAAE,SAAS,YAAY,GAAG,YAAY,IAAI,IAAI,CAC3E,MAAM,CAAC,EAAE,CAAC,EACV,YAAY,GAAG,YAAY,GAAG,aAAa,GAAG,YAAY,CAC3D,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,GAAG,QAAQ,CAAC;AAE5E,MAAM,MAAM,kBAAkB,GAAG,QAAQ,GAAG,SAAS,CAAC;AAEtD,MAAM,WAAW,0BAA0B;IACzC,8CAA8C;IAC9C,QAAQ,EAAE,MAAM,CAAC;IACjB,8CAA8C;IAC9C,eAAe,EAAE,MAAM,CAAC;IACxB,+CAA+C;IAC/C,KAAK,EAAE,MAAM,CAAC;IACd,uDAAuD;IACvD,WAAW,EAAE,MAAM,CAAC;IACpB,4BAA4B;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,wDAAwD;IACxD,MAAM,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,oBAAoB,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,uBAAuB;IACvB,MAAM,EAAE,kBAAkB,CAAC;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,sBAAsB;IACrC,0BAA0B;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,6CAA6C;IAC7C,gBAAgB,EAAE,MAAM,CAAC;IACzB,yCAAyC;IACzC,MAAM,EAAE,kBAAkB,CAAC;IAC3B,qCAAqC;IACrC,eAAe,EAAE,MAAM,CAAC;IACxB,0DAA0D;IAC1D,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,0BAA0B;IAC1B,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,yCAAyC;IACzC,UAAU,EAAE,MAAM,CAAC;IACnB,yCAAyC;IACzC,UAAU,EAAE,MAAM,CAAC;IACnB,4CAA4C;IAC5C,aAAa,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC;IACjC,4CAA4C;IAC5C,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,4EAA4E;IAC5E,cAAc,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC;CACnC;AAED,MAAM,WAAW,YAAa,SAAQ,gBAAgB;IACpD,uBAAuB,EAAE,0BAA0B,CAAC;IACpD,mBAAmB,EAAE,sBAAsB,CAAC;IAC5C,cAAc,EAAE,kBAAkB,CAAC;CACpC;AAED,MAAM,MAAM,oBAAoB,GAAG,UAAU,GAAG,OAAO,CAAC;AAExD,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,gBAAgB,EAAE,MAAM,CAAC;IACzB,gBAAgB,EAAE,MAAM,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,oBAAoB,CAAC;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B"}

package/dist/schema.js

@@ -0,0 +1,7 @@
+/**
+ * @syncular/client - Sync client schema types (SQLite reference)
+ *
+ * These tables are sync-internal and should not collide with app tables.
+ */
+export {};
+//# sourceMappingURL=schema.js.map

package/dist/schema.js.map

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

package/dist/sync-loop.d.ts

@@ -0,0 +1,32 @@
+/**
+ * @syncular/client - High-level sync loops
+ *
+ * Helpers that run push/pull repeatedly until the client is caught up.
+ */
+import type { SyncPullResponse, SyncSubscriptionRequest, SyncTransport } from '@syncular/core';
+import type { Kysely } from 'kysely';
+import type { ClientTableRegistry } from './handlers/registry';
+import { type SyncPushOnceOptions } from './push-engine';
+import type { SyncClientDb } from './schema';
+export interface SyncOnceOptions {
+    clientId: string;
+    actorId?: string;
+    plugins?: SyncPushOnceOptions['plugins'];
+    subscriptions: Array<Omit<SyncSubscriptionRequest, 'cursor'>>;
+    limitCommits?: number;
+    limitSnapshotRows?: number;
+    maxSnapshotPages?: number;
+    dedupeRows?: boolean;
+    stateId?: string;
+    maxPushCommits?: number;
+    maxPullRounds?: number;
+    /** When 'ws', peek outbox first and skip push if empty. */
+    trigger?: 'ws' | 'local' | 'poll';
+}
+export interface SyncOnceResult {
+    pushedCommits: number;
+    pullRounds: number;
+    pullResponse: SyncPullResponse;
+}
+export declare function syncOnce<DB extends SyncClientDb>(db: Kysely<DB>, transport: SyncTransport, shapes: ClientTableRegistry<DB>, options: SyncOnceOptions): Promise<SyncOnceResult>;
+//# sourceMappingURL=sync-loop.d.ts.map

package/dist/sync-loop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-loop.d.ts","sourceRoot":"","sources":["../src/sync-loop.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACV,gBAAgB,EAIhB,uBAAuB,EACvB,aAAa,EACd,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAErC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAc/D,OAAO,EAAE,KAAK,mBAAmB,EAAgB,MAAM,eAAe,CAAC;AACvE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAqH7C,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,mBAAmB,CAAC,SAAS,CAAC,CAAC;IACzC,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;IACjB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,2DAA2D;IAC3D,OAAO,CAAC,EAAE,IAAI,GAAG,OAAO,GAAG,MAAM,CAAC;CACnC;AAED,MAAM,WAAW,cAAc;IAC7B,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,gBAAgB,CAAC;CAChC;AAgMD,wBAAsB,QAAQ,CAAC,EAAE,SAAS,YAAY,EACpD,EAAE,EAAE,MAAM,CAAC,EAAE,CAAC,EACd,SAAS,EAAE,aAAa,EACxB,MAAM,EAAE,mBAAmB,CAAC,EAAE,CAAC,EAC/B,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,cAAc,CAAC,CAEzB"}