@syncular/client 0.0.6-168 → 0.0.6-177

package/dist/query/QueryContext.js

@@ -1,16 +0,0 @@
-/**
- * @syncular/client - Query Context
- *
- * Provides a query context with tracked selectFrom for scope tracking
- * and automatic fingerprint generation.
- */
-import { createTrackedSelectFrom } from './tracked-select.js';
-/**
- * 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

@@ -1 +0,0 @@
-{"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/index.d.ts

@@ -1,7 +0,0 @@
-/**
- * @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

@@ -1 +0,0 @@
-{"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

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

package/dist/query/index.js.map

@@ -1 +0,0 @@
-{"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

@@ -1,18 +0,0 @@
-/**
- * @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

@@ -1 +0,0 @@
-{"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

@@ -1,90 +0,0 @@
-/**
- * @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.js';
-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

@@ -1 +0,0 @@
-{"version":3,"file":"tracked-select.js","sourceRoot":"","sources":["../../src/query/tracked-select.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAQH,OAAO,EACL,qBAAqB,EACrB,uBAAuB,EACvB,WAAW,GAEZ,MAAM,eAAe,CAAC;AAYvB,SAAS,iBAAiB,CAAC,KAAc,EAA4B;IACnE,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IAC9D,OAAO,CACL,OAAO,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,SAAS,CAAC,KAAK,UAAU;QACnD,OAAO,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,kBAAkB,CAAC,KAAK,UAAU;QAC5D,OAAO,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,yBAAyB,CAAC,KAAK,UAAU,CACpE,CAAC;AAAA,CACH;AAED,SAAS,kBAAkB,CACzB,OAAU,EACV,KAAa,EACb,SAA+B,EAC/B,MAA+B,EAC/B,QAAgB,EACb;IACH,OAAO,IAAI,KAAK,CAAC,OAAO,EAAE;QACxB,GAAG,CAAC,MAAM,EAAE,IAAqB,EAAE;YACjC,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;gBACvB,OAAO,KAAK,IAAI,EAAE,CAAC;oBACjB,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,OAAO,EAAE,CAAC;oBACpC,qDAAqD;oBACrD,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;wBACxB,IAAI,WAAW,CAAC,IAAI,EAAE,QAAQ,CAAC,EAAE,CAAC;4BAChC,iDAAiD;4BACjD,MAAM,EAAE,GAAG,qBAAqB,CAAC,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;4BAChE,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;wBACpB,CAAC;6BAAM,CAAC;4BACN,sDAAsD;4BACtD,MAAM,EAAE,GAAG,uBAAuB,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;4BAChD,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;wBACpB,CAAC;oBACH,CAAC;yBAAM,CAAC;wBACN,wDAAwD;wBACxD,MAAM,EAAE,GAAG,uBAAuB,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;wBAChD,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;oBACpB,CAAC;oBACD,OAAO,IAAI,CAAC;gBAAA,CACb,CAAC;YACJ,CAAC;YACD,IAAI,IAAI,KAAK,kBAAkB,EAAE,CAAC;gBAChC,OAAO,KAAK,IAAI,EAAE,CAAC;oBACjB,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,gBAAgB,EAAE,CAAC;oBAC5C,oDAAoD;oBACpD,MAAM,EAAE,GAAG,uBAAuB,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;oBAC/C,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;oBAClB,OAAO,GAAG,CAAC;gBAAA,CACZ,CAAC;YACJ,CAAC;YACD,IAAI,IAAI,KAAK,yBAAyB,EAAE,CAAC;gBACvC,OAAO,KAAK,IAAI,EAAE,CAAC;oBACjB,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,uBAAuB,EAAE,CAAC;oBACnD,oDAAoD;oBACpD,MAAM,EAAE,GAAG,uBAAuB,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;oBAC/C,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;oBAClB,OAAO,GAAG,CAAC;gBAAA,CACZ,CAAC;YACJ,CAAC;YACD,yDAAyD;YACzD,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;YAChD,IAAI,OAAO,KAAK,KAAK,UAAU,EAAE,CAAC;gBAChC,OAAO,CAAC,GAAG,IAAe,EAAE,EAAE,CAAC;oBAC7B,MAAM,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC;oBAClD,IAAI,iBAAiB,CAAC,MAAM,CAAC,EAAE,CAAC;wBAC9B,OAAO,kBAAkB,CACvB,MAAM,EACN,KAAK,EACL,SAAS,EACT,MAAM,EACN,QAAQ,CACT,CAAC;oBACJ,CAAC;oBACD,OAAO,MAAM,CAAC;gBAAA,CACf,CAAC;YACJ,CAAC;YACD,OAAO,KAAK,CAAC;QAAA,CACd;KACF,CAAC,CAAC;AAAA,CACJ;AAED;;GAEG;AACH,MAAM,UAAU,uBAAuB,CACrC,EAAc,EACd,cAA2B,EAC3B,oBAA0C,EAC1C,MAA+B,EAC/B,QAAQ,GAAG,IAAI,EACQ;IACvB,MAAM,UAAU,GAAG,CAA+B,KAAS,EAAE,EAAE,CAAC;QAC9D,4CAA4C;QAC5C,cAAc,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAE1B,gCAAgC;QAChC,MAAM,OAAO,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;QAErC,+CAA+C;QAC/C,OAAO,kBAAkB,CACvB,OAAO,EACP,KAAK,EACL,oBAAoB,EACpB,MAAM,EACN,QAAQ,CACT,CAAC;IAAA,CACH,CAAC;IACF,OAAO,UAAmC,CAAC;AAAA,CAC5C"}

package/src/query/QueryContext.ts

@@ -1,54 +0,0 @@
-/**
- * @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 function createQueryContext<DB extends SyncClientDb>(
-  db: Kysely<DB>,
-  scopeCollector: Set<string>,
-  fingerprintCollector: FingerprintCollector,
-  engine: MutationTimestampSource,
-  keyField = 'id'
-): QueryContext<DB> {
-  return {
-    selectFrom: createTrackedSelectFrom(
-      db,
-      scopeCollector,
-      fingerprintCollector,
-      engine,
-      keyField
-    ),
-  };
-}

package/src/query/index.ts

@@ -1,10 +0,0 @@
-/**
- * @syncular/client - Query utilities exports
- */
-
-export { FingerprintCollector } from './FingerprintCollector';
-export {
-  canFingerprint,
-  computeFingerprint,
-} from './fingerprint';
-export { createQueryContext, type QueryContext } from './QueryContext';

package/src/query/tracked-select.ts

@@ -1,139 +0,0 @@
-/**
- * @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 {
-  computeRowFingerprint,
-  computeValueFingerprint,
-  hasKeyField,
-  type MutationTimestampSource,
-} from './fingerprint';
-
-/**
- * Create a proxy that intercepts execute() to compute fingerprints.
- */
-
-type ExecutableQuery = {
-  execute: () => Promise<unknown>;
-  executeTakeFirst: () => Promise<unknown>;
-  executeTakeFirstOrThrow: () => Promise<unknown>;
-};
-
-function isExecutableQuery(value: unknown): value is ExecutableQuery {
-  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<B extends ExecutableQuery>(
-  builder: B,
-  table: string,
-  collector: FingerprintCollector,
-  engine: MutationTimestampSource,
-  keyField: string
-): B {
-  return new Proxy(builder, {
-    get(target, prop: string | symbol) {
-      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: unknown[]) => {
-          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>(
-  db: Kysely<DB>,
-  scopeCollector: Set<string>,
-  fingerprintCollector: FingerprintCollector,
-  engine: MutationTimestampSource,
-  keyField = 'id'
-): TrackedSelectFrom<DB> {
-  const selectFrom = <TB extends keyof DB & string>(table: TB) => {
-    // 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 as TrackedSelectFrom<DB>;
-}