@firtoz/collection-sync 5.0.0 → 6.0.0

package/README.md

@@ -0,0 +1,46 @@
+# @firtoz/collection-sync
+
+[![npm version](https://img.shields.io/npm/v/%40firtoz%2Fcollection-sync.svg)](https://www.npmjs.com/package/@firtoz/collection-sync)
+[![npm downloads](https://img.shields.io/npm/dm/%40firtoz%2Fcollection-sync.svg)](https://www.npmjs.com/package/@firtoz/collection-sync)
+[![license](https://img.shields.io/npm/l/%40firtoz%2Fcollection-sync.svg)](https://github.com/firtoz/fullstack-toolkit/blob/main/LICENSE)
+
+[![TypeScript](https://img.shields.io/badge/TypeScript-3178C6?logo=typescript&logoColor=white)](https://www.typescriptlang.org/)
+[![TanStack DB](https://img.shields.io/badge/TanStack_DB-000000?logo=react&logoColor=61DAFB)](https://tanstack.com/db)
+[![WebSocket](https://img.shields.io/badge/WebSocket-sync-6366f1)](https://developer.mozilla.org/en-US/docs/Web/API/WebSocket)
+
+**Real-time sync for [TanStack DB](https://tanstack.com/db) collections over WebSockets**—shared Zod message schemas, client/server bridges, optional partial sync and viewport-aware caching for large datasets.
+
+## Installation
+
+```bash
+npm install @firtoz/collection-sync @tanstack/db @standard-schema/spec @firtoz/websocket-do react @tanstack/react-db
+```
+
+Also: `pnpm add` · `bun add` · `yarn add`
+
+Peers include `@firtoz/websocket-do`, `@tanstack/db`, `@tanstack/react-db`, `react`, and `@standard-schema/spec`. Wire your Durable Object or server to the protocol types exported from the package root.
+
+## React entry
+
+Import hooks and adapters from the dedicated subpath:
+
+```ts
+import { /* … */ } from "@firtoz/collection-sync/react";
+```
+
+## Core exports
+
+The package root exposes protocol types (`SyncClientMessage`, `SyncServerMessage`, …), bridges (`SyncClientBridge`, `SyncServerBridge`, `PartialSyncClientBridge`, …), `withSync` for wrapping collections, and related utilities. See `src/index.ts` for the full public API.
+
+## Related
+
+- [`@firtoz/idb-collections`](https://www.npmjs.com/package/@firtoz/idb-collections) — IndexedDB-backed collections
+- [`@firtoz/db-helpers`](https://www.npmjs.com/package/@firtoz/db-helpers) — shared TanStack DB helpers
+
+## Links
+
+- [GitHub](https://github.com/firtoz/fullstack-toolkit/tree/main/packages/collection-sync) · [Issues](https://github.com/firtoz/fullstack-toolkit/issues)
+
+## License
+
+MIT © [Firtina Ozbalikchi](https://github.com/firtoz)

package/dist/cache-manager.d.ts

@@ -0,0 +1,52 @@
+import { PartialSyncRowRef } from './partial-sync-row-key.js';
+
+interface CacheStorageEstimate {
+    usageBytes: number;
+    quotaBytes: number;
+    utilizationRatio: number;
+}
+type CacheEntry = {
+    key: string | number;
+    lastAccessedAt: number;
+    fetchedAt: number;
+    sortPositions: Map<string, unknown>;
+    estimatedSizeBytes: number;
+};
+
+interface CacheManagerOptions<TItem extends PartialSyncRowRef> {
+    evictionThreshold?: number;
+    evictionTarget?: number;
+    estimateRowSize?: (row: TItem) => number;
+    getStorageEstimate: () => Promise<CacheStorageEstimate>;
+    deleteRows: (keys: Array<string | number>) => Promise<void>;
+}
+type CacheViewport = {
+    sortColumn: string;
+    sortDirection: "asc" | "desc";
+    fromValue: unknown;
+    toValue: unknown;
+};
+declare class CacheManager<TItem extends PartialSyncRowRef> {
+    #private;
+    private readonly options;
+    readonly evictionThreshold: number;
+    readonly evictionTarget: number;
+    constructor(options: CacheManagerOptions<TItem>);
+    get entryCount(): number;
+    /**
+     * Recompute `sortPositions` for rows already tracked (e.g. after a local edit changes sort keys).
+     * Does not add new entries; skips keys missing from `getRow`.
+     */
+    resyncSortPositionsForTrackedRows(getRow: (key: string | number) => TItem | undefined, getSortPositions: (row: TItem) => Record<string, unknown>): void;
+    recordFetchedRows(rows: TItem[], getSortPositions: (row: TItem) => Record<string, unknown>): void;
+    markAccessed(keys: Array<string | number>): void;
+    removeEntries(keys: Array<string | number>): void;
+    clear(): void;
+    estimateStoragePressure(): Promise<CacheStorageEstimate>;
+    evictIfNeeded(viewport: CacheViewport): Promise<{
+        evictedKeys: Array<string | number>;
+        estimate: CacheStorageEstimate;
+    }>;
+}
+
+export { type CacheEntry, CacheManager, type CacheManagerOptions, type CacheStorageEstimate, type CacheViewport };

package/dist/cache-manager.js

@@ -0,0 +1,5 @@
+export { CacheManager } from './chunk-5V6BSQAB.js';
+import './chunk-UJ24XW52.js';
+import './chunk-HMLY7DHA.js';
+//# sourceMappingURL=cache-manager.js.map
+//# sourceMappingURL=cache-manager.js.map

package/dist/cache-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"cache-manager.js"}

package/dist/chunk-3EHHMLSV.js

@@ -0,0 +1,57 @@
+import { exhaustiveGuard } from '@firtoz/maybe-error';
+
+// src/partial-sync-predicate-match.ts
+function compareUnknown(a, b) {
+  const na = a instanceof Date ? a.getTime() : a;
+  const nb = b instanceof Date ? b.getTime() : b;
+  if (typeof na === "number" && typeof nb === "number") {
+    if (na === nb) return 0;
+    return na < nb ? -1 : 1;
+  }
+  return String(na).localeCompare(String(nb));
+}
+function defaultPredicateColumnValue(row, column) {
+  if (row !== null && typeof row === "object" && column in row) {
+    return row[column];
+  }
+  return void 0;
+}
+function matchesPredicate(row, conditions, getColumnValue) {
+  for (const c of conditions) {
+    const v = getColumnValue(row, c.column);
+    switch (c.op) {
+      case "eq":
+        if (compareUnknown(v, c.value) !== 0) return false;
+        break;
+      case "neq":
+        if (compareUnknown(v, c.value) === 0) return false;
+        break;
+      case "gt":
+        if (compareUnknown(v, c.value) <= 0) return false;
+        break;
+      case "gte":
+        if (compareUnknown(v, c.value) < 0) return false;
+        break;
+      case "lt":
+        if (compareUnknown(v, c.value) >= 0) return false;
+        break;
+      case "lte":
+        if (compareUnknown(v, c.value) > 0) return false;
+        break;
+      case "between": {
+        if (c.valueTo === void 0) return false;
+        if (compareUnknown(v, c.value) < 0 || compareUnknown(v, c.valueTo) > 0) {
+          return false;
+        }
+        break;
+      }
+      default:
+        exhaustiveGuard(c.op);
+    }
+  }
+  return true;
+}
+
+export { defaultPredicateColumnValue, matchesPredicate };
+//# sourceMappingURL=chunk-3EHHMLSV.js.map
+//# sourceMappingURL=chunk-3EHHMLSV.js.map

package/dist/chunk-3EHHMLSV.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/partial-sync-predicate-match.ts"],"names":[],"mappings":";;;AAGA,SAAS,cAAA,CAAe,GAAY,CAAA,EAAoB;AACvD,EAAA,MAAM,EAAA,GAAK,CAAA,YAAa,IAAA,GAAO,CAAA,CAAE,SAAQ,GAAI,CAAA;AAC7C,EAAA,MAAM,EAAA,GAAK,CAAA,YAAa,IAAA,GAAO,CAAA,CAAE,SAAQ,GAAI,CAAA;AAC7C,EAAA,IAAI,OAAO,EAAA,KAAO,QAAA,IAAY,OAAO,OAAO,QAAA,EAAU;AACrD,IAAA,IAAI,EAAA,KAAO,IAAI,OAAO,CAAA;AACtB,IAAA,OAAO,EAAA,GAAK,KAAK,EAAA,GAAK,CAAA;AAAA,EACvB;AACA,EAAA,OAAO,OAAO,EAAE,CAAA,CAAE,aAAA,CAAc,MAAA,CAAO,EAAE,CAAC,CAAA;AAC3C;AAEO,SAAS,2BAAA,CACf,KACA,MAAA,EACU;AACV,EAAA,IAAI,QAAQ,IAAA,IAAQ,OAAO,GAAA,KAAQ,QAAA,IAAY,UAAU,GAAA,EAAK;AAC7D,IAAA,OAAQ,IAAgC,MAAM,CAAA;AAAA,EAC/C;AACA,EAAA,OAAO,MAAA;AACR;AAEO,SAAS,gBAAA,CACf,GAAA,EACA,UAAA,EACA,cAAA,EACU;AACV,EAAA,KAAA,MAAW,KAAK,UAAA,EAAY;AAC3B,IAAA,MAAM,CAAA,GAAI,cAAA,CAAe,GAAA,EAAK,CAAA,CAAE,MAAM,CAAA;AACtC,IAAA,QAAQ,EAAE,EAAA;AAAI,MACb,KAAK,IAAA;AACJ,QAAA,IAAI,eAAe,CAAA,EAAG,CAAA,CAAE,KAAK,CAAA,KAAM,GAAG,OAAO,KAAA;AAC7C,QAAA;AAAA,MACD,KAAK,KAAA;AACJ,QAAA,IAAI,eAAe,CAAA,EAAG,CAAA,CAAE,KAAK,CAAA,KAAM,GAAG,OAAO,KAAA;AAC7C,QAAA;AAAA,MACD,KAAK,IAAA;AACJ,QAAA,IAAI,eAAe,CAAA,EAAG,CAAA,CAAE,KAAK,CAAA,IAAK,GAAG,OAAO,KAAA;AAC5C,QAAA;AAAA,MACD,KAAK,KAAA;AACJ,QAAA,IAAI,eAAe,CAAA,EAAG,CAAA,CAAE,KAAK,CAAA,GAAI,GAAG,OAAO,KAAA;AAC3C,QAAA;AAAA,MACD,KAAK,IAAA;AACJ,QAAA,IAAI,eAAe,CAAA,EAAG,CAAA,CAAE,KAAK,CAAA,IAAK,GAAG,OAAO,KAAA;AAC5C,QAAA;AAAA,MACD,KAAK,KAAA;AACJ,QAAA,IAAI,eAAe,CAAA,EAAG,CAAA,CAAE,KAAK,CAAA,GAAI,GAAG,OAAO,KAAA;AAC3C,QAAA;AAAA,MACD,KAAK,SAAA,EAAW;AACf,QAAA,IAAI,CAAA,CAAE,OAAA,KAAY,MAAA,EAAW,OAAO,KAAA;AACpC,QAAA,IACC,cAAA,CAAe,CAAA,EAAG,CAAA,CAAE,KAAK,CAAA,GAAI,CAAA,IAC7B,cAAA,CAAe,CAAA,EAAG,CAAA,CAAE,OAAO,CAAA,GAAI,CAAA,EAC9B;AACD,UAAA,OAAO,KAAA;AAAA,QACR;AACA,QAAA;AAAA,MACD;AAAA,MACA;AACC,QAAA,eAAA,CAAgB,EAAE,EAAE,CAAA;AAAA;AACtB,EACD;AACA,EAAA,OAAO,IAAA;AACR","file":"chunk-3EHHMLSV.js","sourcesContent":["import { exhaustiveGuard } from \"@firtoz/maybe-error\";\nimport type { RangeCondition } from \"./sync-protocol\";\n\nfunction compareUnknown(a: unknown, b: unknown): number {\n\tconst na = a instanceof Date ? a.getTime() : a;\n\tconst nb = b instanceof Date ? b.getTime() : b;\n\tif (typeof na === \"number\" && typeof nb === \"number\") {\n\t\tif (na === nb) return 0;\n\t\treturn na < nb ? -1 : 1;\n\t}\n\treturn String(na).localeCompare(String(nb));\n}\n\nexport function defaultPredicateColumnValue<TItem>(\n\trow: TItem,\n\tcolumn: string,\n): unknown {\n\tif (row !== null && typeof row === \"object\" && column in row) {\n\t\treturn (row as Record<string, unknown>)[column];\n\t}\n\treturn undefined;\n}\n\nexport function matchesPredicate<TItem>(\n\trow: TItem,\n\tconditions: RangeCondition[],\n\tgetColumnValue: (row: TItem, column: string) => unknown,\n): boolean {\n\tfor (const c of conditions) {\n\t\tconst v = getColumnValue(row, c.column);\n\t\tswitch (c.op) {\n\t\t\tcase \"eq\":\n\t\t\t\tif (compareUnknown(v, c.value) !== 0) return false;\n\t\t\t\tbreak;\n\t\t\tcase \"neq\":\n\t\t\t\tif (compareUnknown(v, c.value) === 0) return false;\n\t\t\t\tbreak;\n\t\t\tcase \"gt\":\n\t\t\t\tif (compareUnknown(v, c.value) <= 0) return false;\n\t\t\t\tbreak;\n\t\t\tcase \"gte\":\n\t\t\t\tif (compareUnknown(v, c.value) < 0) return false;\n\t\t\t\tbreak;\n\t\t\tcase \"lt\":\n\t\t\t\tif (compareUnknown(v, c.value) >= 0) return false;\n\t\t\t\tbreak;\n\t\t\tcase \"lte\":\n\t\t\t\tif (compareUnknown(v, c.value) > 0) return false;\n\t\t\t\tbreak;\n\t\t\tcase \"between\": {\n\t\t\t\tif (c.valueTo === undefined) return false;\n\t\t\t\tif (\n\t\t\t\t\tcompareUnknown(v, c.value) < 0 ||\n\t\t\t\t\tcompareUnknown(v, c.valueTo) > 0\n\t\t\t\t) {\n\t\t\t\t\treturn false;\n\t\t\t\t}\n\t\t\t\tbreak;\n\t\t\t}\n\t\t\tdefault:\n\t\t\t\texhaustiveGuard(c.op);\n\t\t}\n\t}\n\treturn true;\n}\n"]}

package/dist/chunk-43KYAIKY.js

@@ -0,0 +1,46 @@
+import { and, gte, lte, lt, gt, not, eq } from '@tanstack/db';
+import { exhaustiveGuard } from '@firtoz/maybe-error';
+
+// src/react/range-conditions-expression.ts
+function buildRangeConditionsAndExpression(row, conditions) {
+  if (conditions.length === 0) {
+    throw new Error(
+      "buildRangeConditionsAndExpression: pass a non-empty conditions list"
+    );
+  }
+  const parts = conditions.map((c) => rangeConditionExpression(row, c));
+  if (parts.length === 1) {
+    return parts[0];
+  }
+  const [a, b, ...rest] = parts;
+  return rest.length === 0 ? and(a, b) : and(a, b, ...rest);
+}
+function rangeConditionExpression(row, c) {
+  const col = row[c.column];
+  switch (c.op) {
+    case "eq":
+      return eq(col, c.value);
+    case "neq":
+      return not(eq(col, c.value));
+    case "gt":
+      return gt(col, c.value);
+    case "gte":
+      return gte(col, c.value);
+    case "lt":
+      return lt(col, c.value);
+    case "lte":
+      return lte(col, c.value);
+    case "between": {
+      if (c.valueTo === void 0) {
+        throw new Error(`between requires valueTo for column ${c.column}`);
+      }
+      return and(gte(col, c.value), lte(col, c.valueTo));
+    }
+    default:
+      exhaustiveGuard(c.op);
+  }
+}
+
+export { buildRangeConditionsAndExpression };
+//# sourceMappingURL=chunk-43KYAIKY.js.map
+//# sourceMappingURL=chunk-43KYAIKY.js.map

package/dist/chunk-43KYAIKY.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/react/range-conditions-expression.ts"],"names":[],"mappings":";;;;AAyBO,SAAS,iCAAA,CACf,KACA,UAAA,EACC;AACD,EAAA,IAAI,UAAA,CAAW,WAAW,CAAA,EAAG;AAC5B,IAAA,MAAM,IAAI,KAAA;AAAA,MACT;AAAA,KACD;AAAA,EACD;AACA,EAAA,MAAM,KAAA,GAAQ,WAAW,GAAA,CAAI,CAAC,MAAM,wBAAA,CAAyB,GAAA,EAAK,CAAC,CAAC,CAAA;AACpE,EAAA,IAAI,KAAA,CAAM,WAAW,CAAA,EAAG;AACvB,IAAA,OAAO,MAAM,CAAC,CAAA;AAAA,EACf;AACA,EAAA,MAAM,CAAC,CAAA,EAAG,CAAA,EAAG,GAAG,IAAI,CAAA,GAAI,KAAA;AACxB,EAAA,OAAO,IAAA,CAAK,MAAA,KAAW,CAAA,GAAI,GAAA,CAAI,CAAA,EAAG,CAAC,CAAA,GAAI,GAAA,CAAI,CAAA,EAAG,CAAA,EAAG,GAAG,IAAI,CAAA;AACzD;AAEA,SAAS,wBAAA,CACR,KACA,CAAA,EACC;AACD,EAAA,MAAM,GAAA,GAAM,GAAA,CAAI,CAAA,CAAE,MAAM,CAAA;AACxB,EAAA,QAAQ,EAAE,EAAA;AAAI,IACb,KAAK,IAAA;AACJ,MAAA,OAAO,EAAA,CAAG,GAAA,EAAK,CAAA,CAAE,KAAK,CAAA;AAAA,IACvB,KAAK,KAAA;AACJ,MAAA,OAAO,GAAA,CAAI,EAAA,CAAG,GAAA,EAAK,CAAA,CAAE,KAAK,CAAC,CAAA;AAAA,IAC5B,KAAK,IAAA;AACJ,MAAA,OAAO,EAAA,CAAG,GAAA,EAAK,CAAA,CAAE,KAAK,CAAA;AAAA,IACvB,KAAK,KAAA;AACJ,MAAA,OAAO,GAAA,CAAI,GAAA,EAAK,CAAA,CAAE,KAAK,CAAA;AAAA,IACxB,KAAK,IAAA;AACJ,MAAA,OAAO,EAAA,CAAG,GAAA,EAAK,CAAA,CAAE,KAAK,CAAA;AAAA,IACvB,KAAK,KAAA;AACJ,MAAA,OAAO,GAAA,CAAI,GAAA,EAAK,CAAA,CAAE,KAAK,CAAA;AAAA,IACxB,KAAK,SAAA,EAAW;AACf,MAAA,IAAI,CAAA,CAAE,YAAY,MAAA,EAAW;AAC5B,QAAA,MAAM,IAAI,KAAA,CAAM,CAAA,oCAAA,EAAuC,CAAA,CAAE,MAAM,CAAA,CAAE,CAAA;AAAA,MAClE;AACA,MAAA,OAAO,GAAA,CAAI,GAAA,CAAI,GAAA,EAAK,CAAA,CAAE,KAAK,GAAG,GAAA,CAAI,GAAA,EAAK,CAAA,CAAE,OAAO,CAAC,CAAA;AAAA,IAClD;AAAA,IACA;AACC,MAAA,eAAA,CAAgB,EAAE,EAAE,CAAA;AAAA;AAEvB","file":"chunk-43KYAIKY.js","sourcesContent":["import { and, eq, gt, gte, lt, lte, not, type Ref } from \"@tanstack/db\";\nimport { exhaustiveGuard } from \"@firtoz/maybe-error\";\nimport type { PartialSyncRowShape } from \"../partial-sync-row-key\";\nimport type { RangeCondition } from \"../sync-protocol\";\n\n/**\n * Row ref from `q.from({ items: collection }).where(({ items }) => …)`.\n * Column access must match {@link RangeCondition.column} names on the stored row shape.\n *\n * Uses TanStack {@link Ref} so column reads are `ExpressionLike` (e.g. for `inArray`), not `unknown`.\n */\nexport type PredicateRowRef = Ref<\n\tPartialSyncRowShape & Record<string, unknown>\n>;\n\n/**\n * Row accepted by {@link buildRangeConditionsAndExpression}: live query refs or plain objects (e.g. tests).\n * Dynamic `column` access yields `unknown`, which TanStack comparison helpers still accept.\n */\nexport type PredicateRangeBuildRow = PredicateRowRef | Record<string, unknown>;\n\n/**\n * Builds a TanStack DB `where` expression AND-ing all conditions (same semantics as\n * {@link matchesPredicate} for plain property rows).\n */\nexport function buildRangeConditionsAndExpression(\n\trow: PredicateRangeBuildRow,\n\tconditions: RangeCondition[],\n) {\n\tif (conditions.length === 0) {\n\t\tthrow new Error(\n\t\t\t\"buildRangeConditionsAndExpression: pass a non-empty conditions list\",\n\t\t);\n\t}\n\tconst parts = conditions.map((c) => rangeConditionExpression(row, c));\n\tif (parts.length === 1) {\n\t\treturn parts[0];\n\t}\n\tconst [a, b, ...rest] = parts;\n\treturn rest.length === 0 ? and(a, b) : and(a, b, ...rest);\n}\n\nfunction rangeConditionExpression(\n\trow: PredicateRangeBuildRow,\n\tc: RangeCondition,\n) {\n\tconst col = row[c.column];\n\tswitch (c.op) {\n\t\tcase \"eq\":\n\t\t\treturn eq(col, c.value);\n\t\tcase \"neq\":\n\t\t\treturn not(eq(col, c.value));\n\t\tcase \"gt\":\n\t\t\treturn gt(col, c.value);\n\t\tcase \"gte\":\n\t\t\treturn gte(col, c.value);\n\t\tcase \"lt\":\n\t\t\treturn lt(col, c.value);\n\t\tcase \"lte\":\n\t\t\treturn lte(col, c.value);\n\t\tcase \"between\": {\n\t\t\tif (c.valueTo === undefined) {\n\t\t\t\tthrow new Error(`between requires valueTo for column ${c.column}`);\n\t\t\t}\n\t\t\treturn and(gte(col, c.value), lte(col, c.valueTo));\n\t\t}\n\t\tdefault:\n\t\t\texhaustiveGuard(c.op);\n\t}\n}\n"]}

package/dist/chunk-4BEXLBCH.js

@@ -0,0 +1,64 @@
+// src/react/partial-sync-utils.ts
+function primePartialSyncBridgeCachedIdsFromCollection(bridge, collection) {
+  bridge.seedHydratedLocalRows(Array.from(collection.entries(), ([, v]) => v));
+}
+function assertSyncUtils(utils) {
+  const receiveSync = utils.receiveSync;
+  const truncate = utils.truncate;
+  if (typeof receiveSync === "function" && typeof truncate === "function") {
+    return {
+      receiveSync,
+      truncate
+    };
+  }
+  throw new Error(
+    "Partial sync requires collection.utils.receiveSync and collection.utils.truncate"
+  );
+}
+function defaultPartialSyncVersionMs(row) {
+  const v = row.updatedAt;
+  if (v === null) return 0;
+  if (v instanceof Date) return v.getTime();
+  if (typeof v === "number") return v;
+  return 0;
+}
+function getPartialSyncRowByMapId(collection, id) {
+  const direct = collection.get(id);
+  if (direct !== void 0) return direct;
+  const sid = String(id);
+  for (const [k, row] of collection.entries()) {
+    if (String(k) === sid) return row;
+  }
+  return void 0;
+}
+function tryIdsForIndexWindow(map, offset, want, totalCount) {
+  if (totalCount === 0) return null;
+  const n = Math.min(want, Math.max(0, totalCount - offset));
+  if (n === 0) return [];
+  const out = [];
+  for (let i = 0; i < n; i += 1) {
+    const id = map.get(offset + i);
+    if (id === void 0) return null;
+    out.push(id);
+  }
+  return out;
+}
+function computeFingerprintForIndexWindow(collection, map, offset, want, getVersionMs = defaultPartialSyncVersionMs) {
+  if (want <= 0) return void 0;
+  let maxV = 0;
+  let count = 0;
+  for (let i = 0; i < want; i += 1) {
+    const id = map.get(offset + i);
+    if (id === void 0) return void 0;
+    const row = getPartialSyncRowByMapId(collection, id);
+    if (row === void 0) return void 0;
+    count += 1;
+    const ms = getVersionMs(row);
+    if (ms > maxV) maxV = ms;
+  }
+  return { version: maxV, count };
+}
+
+export { assertSyncUtils, computeFingerprintForIndexWindow, defaultPartialSyncVersionMs, getPartialSyncRowByMapId, primePartialSyncBridgeCachedIdsFromCollection, tryIdsForIndexWindow };
+//# sourceMappingURL=chunk-4BEXLBCH.js.map
+//# sourceMappingURL=chunk-4BEXLBCH.js.map

package/dist/chunk-4BEXLBCH.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/react/partial-sync-utils.ts"],"names":[],"mappings":"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","file":"chunk-4BEXLBCH.js","sourcesContent":["import type { CollectionUtils } from \"@firtoz/db-helpers\";\nimport type { UtilsRecord } from \"@tanstack/db\";\nimport type { RangeFingerprint } from \"../sync-protocol\";\nimport type { PartialSyncCollection, PartialSyncItem } from \"./types\";\n\n/** Merge every row currently in the collection into the bridge cache (id set only). Idempotent. */\nexport function primePartialSyncBridgeCachedIdsFromCollection<\n\tTItem extends PartialSyncItem,\n>(\n\tbridge: { seedHydratedLocalRows: (rows: readonly TItem[]) => void },\n\tcollection: Pick<PartialSyncCollection<TItem>, \"entries\">,\n): void {\n\tbridge.seedHydratedLocalRows(Array.from(collection.entries(), ([, v]) => v));\n}\n\n/**\n * TanStack `Collection` types `utils` as {@link UtilsRecord}. This narrows to sync helpers when\n * present (e.g. after `memoryCollectionOptions` / Drizzle sync config).\n */\nexport function assertSyncUtils<TItem>(\n\tutils: UtilsRecord,\n): CollectionUtils<TItem> {\n\tconst receiveSync = utils.receiveSync;\n\tconst truncate = utils.truncate;\n\tif (typeof receiveSync === \"function\" && typeof truncate === \"function\") {\n\t\treturn {\n\t\t\treceiveSync: receiveSync as CollectionUtils<TItem>[\"receiveSync\"],\n\t\t\ttruncate: truncate as CollectionUtils<TItem>[\"truncate\"],\n\t\t};\n\t}\n\tthrow new Error(\n\t\t\"Partial sync requires collection.utils.receiveSync and collection.utils.truncate\",\n\t);\n}\n\n/** Default fingerprint version: max `updatedAt` as epoch ms. */\nexport function defaultPartialSyncVersionMs<TItem extends PartialSyncItem>(\n\trow: TItem,\n): number {\n\tconst v = row.updatedAt;\n\tif (v === null) return 0;\n\tif (v instanceof Date) return v.getTime();\n\tif (typeof v === \"number\") return v;\n\treturn 0;\n}\n\n/**\n * Resolve a row for an id stored in the partial-sync index map. Uses {@link PartialSyncCollection.get}\n * first; if that misses (e.g. key type / boxed string mismatch vs TanStack’s internal map), scans\n * {@link PartialSyncCollection.entries} by `String(key)`.\n */\nexport function getPartialSyncRowByMapId<TItem extends PartialSyncItem>(\n\tcollection: PartialSyncCollection<TItem>,\n\tid: string | number,\n): TItem | undefined {\n\tconst direct = collection.get(id);\n\tif (direct !== undefined) return direct;\n\tconst sid = String(id);\n\tfor (const [k, row] of collection.entries()) {\n\t\tif (String(k) === sid) return row;\n\t}\n\treturn undefined;\n}\n\n/**\n * Returns consecutive row ids for `[offset, offset + want)` if all present in the map; else null.\n */\nexport function tryIdsForIndexWindow<TKey extends string | number>(\n\tmap: Map<number, TKey>,\n\toffset: number,\n\twant: number,\n\ttotalCount: number,\n): TKey[] | null {\n\tif (totalCount === 0) return null;\n\tconst n = Math.min(want, Math.max(0, totalCount - offset));\n\tif (n === 0) return [];\n\tconst out: TKey[] = [];\n\tfor (let i = 0; i < n; i += 1) {\n\t\tconst id = map.get(offset + i);\n\t\tif (id === undefined) return null;\n\t\tout.push(id);\n\t}\n\treturn out;\n}\n\n/**\n * Fingerprint for reconciliation when every index in `[offset, offset + want)` is mapped and rows\n * exist in the collection.\n */\nexport function computeFingerprintForIndexWindow<TItem extends PartialSyncItem>(\n\tcollection: PartialSyncCollection<TItem>,\n\tmap: Map<number, string | number>,\n\toffset: number,\n\twant: number,\n\tgetVersionMs: (row: TItem) => number = defaultPartialSyncVersionMs,\n): RangeFingerprint | undefined {\n\tif (want <= 0) return undefined;\n\tlet maxV = 0;\n\tlet count = 0;\n\tfor (let i = 0; i < want; i += 1) {\n\t\tconst id = map.get(offset + i);\n\t\tif (id === undefined) return undefined;\n\t\tconst row = getPartialSyncRowByMapId(collection, id);\n\t\tif (row === undefined) return undefined;\n\t\tcount += 1;\n\t\tconst ms = getVersionMs(row);\n\t\tif (ms > maxV) maxV = ms;\n\t}\n\treturn { version: maxV, count };\n}\n\nexport {\n\tdefaultPredicateColumnValue,\n\tmatchesPredicate,\n} from \"../partial-sync-predicate-match\";\n"]}

package/dist/chunk-5V6BSQAB.js

@@ -0,0 +1,148 @@
+import { partialSyncRowKey } from './chunk-UJ24XW52.js';
+import { __privateAdd, __privateGet, __privateMethod } from './chunk-HMLY7DHA.js';
+
+// src/cache-manager.ts
+var _entries, _CacheManager_instances, scoreEntry_fn, distanceFromViewport_fn, isEntryProtectedByViewport_fn, compareValues_fn;
+var CacheManager = class {
+  constructor(options) {
+    this.options = options;
+    __privateAdd(this, _CacheManager_instances);
+    __privateAdd(this, _entries, /* @__PURE__ */ new Map());
+    this.evictionThreshold = options.evictionThreshold ?? 0.85;
+    this.evictionTarget = options.evictionTarget ?? 0.7;
+  }
+  get entryCount() {
+    return __privateGet(this, _entries).size;
+  }
+  /**
+   * Recompute `sortPositions` for rows already tracked (e.g. after a local edit changes sort keys).
+   * Does not add new entries; skips keys missing from `getRow`.
+   */
+  resyncSortPositionsForTrackedRows(getRow, getSortPositions) {
+    for (const key of __privateGet(this, _entries).keys()) {
+      const row = getRow(key);
+      if (row === void 0) continue;
+      const entry = __privateGet(this, _entries).get(key);
+      if (entry === void 0) continue;
+      const sortPositionsObject = getSortPositions(row);
+      entry.sortPositions = new Map(
+        Object.entries(sortPositionsObject)
+      );
+    }
+  }
+  recordFetchedRows(rows, getSortPositions) {
+    const now = Date.now();
+    for (const row of rows) {
+      const rowKey = partialSyncRowKey(row.id);
+      const existing = __privateGet(this, _entries).get(rowKey);
+      const sortPositionsObject = getSortPositions(row);
+      const sortPositions = new Map(
+        Object.entries(sortPositionsObject)
+      );
+      const estimatedSizeBytes = this.options.estimateRowSize?.(row) ?? 256;
+      __privateGet(this, _entries).set(rowKey, {
+        key: rowKey,
+        lastAccessedAt: existing?.lastAccessedAt ?? now,
+        fetchedAt: now,
+        sortPositions,
+        estimatedSizeBytes
+      });
+    }
+  }
+  markAccessed(keys) {
+    const now = Date.now();
+    for (const key of keys) {
+      const entry = __privateGet(this, _entries).get(key);
+      if (!entry) continue;
+      entry.lastAccessedAt = now;
+    }
+  }
+  removeEntries(keys) {
+    for (const key of keys) __privateGet(this, _entries).delete(key);
+  }
+  clear() {
+    __privateGet(this, _entries).clear();
+  }
+  async estimateStoragePressure() {
+    const estimate = await this.options.getStorageEstimate();
+    return {
+      usageBytes: Math.max(0, estimate.usageBytes),
+      quotaBytes: Math.max(1, estimate.quotaBytes),
+      utilizationRatio: estimate.usageBytes / Math.max(1, estimate.quotaBytes)
+    };
+  }
+  async evictIfNeeded(viewport) {
+    const estimate = await this.estimateStoragePressure();
+    if (estimate.utilizationRatio < this.evictionThreshold) {
+      return { evictedKeys: [], estimate };
+    }
+    const candidates = Array.from(__privateGet(this, _entries).values()).filter((entry) => !__privateMethod(this, _CacheManager_instances, isEntryProtectedByViewport_fn).call(this, entry, viewport)).sort(
+      (a, b) => __privateMethod(this, _CacheManager_instances, scoreEntry_fn).call(this, b, viewport) - __privateMethod(this, _CacheManager_instances, scoreEntry_fn).call(this, a, viewport)
+    );
+    const evictedKeys = [];
+    let currentEstimate = estimate;
+    for (const candidate of candidates) {
+      if (currentEstimate.utilizationRatio <= this.evictionTarget) break;
+      evictedKeys.push(candidate.key);
+      __privateGet(this, _entries).delete(candidate.key);
+      currentEstimate = {
+        ...currentEstimate,
+        usageBytes: Math.max(
+          0,
+          currentEstimate.usageBytes - candidate.estimatedSizeBytes
+        ),
+        utilizationRatio: Math.max(
+          0,
+          currentEstimate.usageBytes - candidate.estimatedSizeBytes
+        ) / currentEstimate.quotaBytes
+      };
+    }
+    if (evictedKeys.length > 0) {
+      await this.options.deleteRows(evictedKeys);
+    }
+    return { evictedKeys, estimate: currentEstimate };
+  }
+};
+_entries = new WeakMap();
+_CacheManager_instances = new WeakSet();
+scoreEntry_fn = function(entry, viewport) {
+  const now = Date.now();
+  const timeSinceAccessMs = Math.max(0, now - entry.lastAccessedAt);
+  const distance = __privateMethod(this, _CacheManager_instances, distanceFromViewport_fn).call(this, entry, viewport);
+  return timeSinceAccessMs * 1e-3 + distance * 1e3;
+};
+distanceFromViewport_fn = function(entry, viewport) {
+  const value = entry.sortPositions.get(viewport.sortColumn);
+  if (value === void 0 || value === null) return 1;
+  let low = viewport.fromValue;
+  let high = viewport.toValue;
+  if (__privateMethod(this, _CacheManager_instances, compareValues_fn).call(this, low, high) > 0) {
+    const t = low;
+    low = high;
+    high = t;
+  }
+  const lowerCompare = __privateMethod(this, _CacheManager_instances, compareValues_fn).call(this, value, low);
+  const upperCompare = __privateMethod(this, _CacheManager_instances, compareValues_fn).call(this, value, high);
+  if (lowerCompare >= 0 && upperCompare <= 0) return 0;
+  const lowerDistance = Math.abs(lowerCompare);
+  const upperDistance = Math.abs(upperCompare);
+  return Math.min(lowerDistance, upperDistance);
+};
+isEntryProtectedByViewport_fn = function(entry, viewport) {
+  return __privateMethod(this, _CacheManager_instances, distanceFromViewport_fn).call(this, entry, viewport) === 0;
+};
+compareValues_fn = function(left, right) {
+  const normalizedLeft = left instanceof Date ? left.getTime() : left;
+  const normalizedRight = right instanceof Date ? right.getTime() : right;
+  if (typeof normalizedLeft === "number" && typeof normalizedRight === "number") {
+    if (normalizedLeft === normalizedRight) return 0;
+    return normalizedLeft < normalizedRight ? -1 : 1;
+  }
+  const leftStr = String(normalizedLeft);
+  const rightStr = String(normalizedRight);
+  return leftStr.localeCompare(rightStr);
+};
+
+export { CacheManager };
+//# sourceMappingURL=chunk-5V6BSQAB.js.map
+//# sourceMappingURL=chunk-5V6BSQAB.js.map

package/dist/chunk-5V6BSQAB.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/cache-manager.ts"],"names":[],"mappings":"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","file":"chunk-5V6BSQAB.js","sourcesContent":["export interface CacheStorageEstimate {\n\tusageBytes: number;\n\tquotaBytes: number;\n\tutilizationRatio: number;\n}\n\nexport type CacheEntry = {\n\tkey: string | number;\n\tlastAccessedAt: number;\n\tfetchedAt: number;\n\tsortPositions: Map<string, unknown>;\n\testimatedSizeBytes: number;\n};\n\nimport type { PartialSyncRowRef } from \"./partial-sync-row-key\";\nimport { partialSyncRowKey } from \"./partial-sync-row-key\";\n\nexport interface CacheManagerOptions<TItem extends PartialSyncRowRef> {\n\tevictionThreshold?: number;\n\tevictionTarget?: number;\n\testimateRowSize?: (row: TItem) => number;\n\tgetStorageEstimate: () => Promise<CacheStorageEstimate>;\n\tdeleteRows: (keys: Array<string | number>) => Promise<void>;\n}\n\nexport type CacheViewport = {\n\tsortColumn: string;\n\tsortDirection: \"asc\" | \"desc\";\n\tfromValue: unknown;\n\ttoValue: unknown;\n};\n\nexport class CacheManager<TItem extends PartialSyncRowRef> {\n\t#entries = new Map<string | number, CacheEntry>();\n\treadonly evictionThreshold: number;\n\treadonly evictionTarget: number;\n\n\tconstructor(private readonly options: CacheManagerOptions<TItem>) {\n\t\tthis.evictionThreshold = options.evictionThreshold ?? 0.85;\n\t\tthis.evictionTarget = options.evictionTarget ?? 0.7;\n\t}\n\n\tget entryCount(): number {\n\t\treturn this.#entries.size;\n\t}\n\n\t/**\n\t * Recompute `sortPositions` for rows already tracked (e.g. after a local edit changes sort keys).\n\t * Does not add new entries; skips keys missing from `getRow`.\n\t */\n\tresyncSortPositionsForTrackedRows(\n\t\tgetRow: (key: string | number) => TItem | undefined,\n\t\tgetSortPositions: (row: TItem) => Record<string, unknown>,\n\t): void {\n\t\tfor (const key of this.#entries.keys()) {\n\t\t\tconst row = getRow(key);\n\t\t\tif (row === undefined) continue;\n\t\t\tconst entry = this.#entries.get(key);\n\t\t\tif (entry === undefined) continue;\n\t\t\tconst sortPositionsObject = getSortPositions(row);\n\t\t\tentry.sortPositions = new Map<string, unknown>(\n\t\t\t\tObject.entries(sortPositionsObject),\n\t\t\t);\n\t\t}\n\t}\n\n\trecordFetchedRows(\n\t\trows: TItem[],\n\t\tgetSortPositions: (row: TItem) => Record<string, unknown>,\n\t): void {\n\t\tconst now = Date.now();\n\t\tfor (const row of rows) {\n\t\t\tconst rowKey = partialSyncRowKey(row.id);\n\t\t\tconst existing = this.#entries.get(rowKey);\n\t\t\tconst sortPositionsObject = getSortPositions(row);\n\t\t\tconst sortPositions = new Map<string, unknown>(\n\t\t\t\tObject.entries(sortPositionsObject),\n\t\t\t);\n\t\t\tconst estimatedSizeBytes = this.options.estimateRowSize?.(row) ?? 256;\n\t\t\tthis.#entries.set(rowKey, {\n\t\t\t\tkey: rowKey,\n\t\t\t\tlastAccessedAt: existing?.lastAccessedAt ?? now,\n\t\t\t\tfetchedAt: now,\n\t\t\t\tsortPositions,\n\t\t\t\testimatedSizeBytes,\n\t\t\t});\n\t\t}\n\t}\n\n\tmarkAccessed(keys: Array<string | number>): void {\n\t\tconst now = Date.now();\n\t\tfor (const key of keys) {\n\t\t\tconst entry = this.#entries.get(key);\n\t\t\tif (!entry) continue;\n\t\t\tentry.lastAccessedAt = now;\n\t\t}\n\t}\n\n\tremoveEntries(keys: Array<string | number>): void {\n\t\tfor (const key of keys) this.#entries.delete(key);\n\t}\n\n\tclear(): void {\n\t\tthis.#entries.clear();\n\t}\n\n\tasync estimateStoragePressure(): Promise<CacheStorageEstimate> {\n\t\tconst estimate = await this.options.getStorageEstimate();\n\t\treturn {\n\t\t\tusageBytes: Math.max(0, estimate.usageBytes),\n\t\t\tquotaBytes: Math.max(1, estimate.quotaBytes),\n\t\t\tutilizationRatio: estimate.usageBytes / Math.max(1, estimate.quotaBytes),\n\t\t};\n\t}\n\n\tasync evictIfNeeded(viewport: CacheViewport): Promise<{\n\t\tevictedKeys: Array<string | number>;\n\t\testimate: CacheStorageEstimate;\n\t}> {\n\t\tconst estimate = await this.estimateStoragePressure();\n\t\tif (estimate.utilizationRatio < this.evictionThreshold) {\n\t\t\treturn { evictedKeys: [], estimate };\n\t\t}\n\n\t\tconst candidates = Array.from(this.#entries.values())\n\t\t\t.filter((entry) => !this.#isEntryProtectedByViewport(entry, viewport))\n\t\t\t.sort(\n\t\t\t\t(a, b) => this.#scoreEntry(b, viewport) - this.#scoreEntry(a, viewport),\n\t\t\t);\n\n\t\tconst evictedKeys: Array<string | number> = [];\n\t\tlet currentEstimate = estimate;\n\t\tfor (const candidate of candidates) {\n\t\t\tif (currentEstimate.utilizationRatio <= this.evictionTarget) break;\n\t\t\tevictedKeys.push(candidate.key);\n\t\t\tthis.#entries.delete(candidate.key);\n\t\t\tcurrentEstimate = {\n\t\t\t\t...currentEstimate,\n\t\t\t\tusageBytes: Math.max(\n\t\t\t\t\t0,\n\t\t\t\t\tcurrentEstimate.usageBytes - candidate.estimatedSizeBytes,\n\t\t\t\t),\n\t\t\t\tutilizationRatio:\n\t\t\t\t\tMath.max(\n\t\t\t\t\t\t0,\n\t\t\t\t\t\tcurrentEstimate.usageBytes - candidate.estimatedSizeBytes,\n\t\t\t\t\t) / currentEstimate.quotaBytes,\n\t\t\t};\n\t\t}\n\n\t\tif (evictedKeys.length > 0) {\n\t\t\tawait this.options.deleteRows(evictedKeys);\n\t\t}\n\t\treturn { evictedKeys, estimate: currentEstimate };\n\t}\n\n\t#scoreEntry(entry: CacheEntry, viewport: CacheViewport): number {\n\t\tconst now = Date.now();\n\t\tconst timeSinceAccessMs = Math.max(0, now - entry.lastAccessedAt);\n\t\tconst distance = this.#distanceFromViewport(entry, viewport);\n\t\t// Weighted score: heavily prefer evicting far-away rows that have not been used recently.\n\t\treturn timeSinceAccessMs * 0.001 + distance * 1000;\n\t}\n\n\t#distanceFromViewport(entry: CacheEntry, viewport: CacheViewport): number {\n\t\tconst value = entry.sortPositions.get(viewport.sortColumn);\n\t\tif (value === undefined || value === null) return 1;\n\t\t// `fromValue` / `toValue` come from first/last *visible* rows. After a local sort-key edit,\n\t\t// the first row can temporarily sort *after* the last row, so from > to. Treat the band as\n\t\t// [min, max] so rows between them stay protected; otherwise every entry looks \"outside\" and\n\t\t// eviction can wipe the visible window (empty list, no throw).\n\t\tlet low = viewport.fromValue;\n\t\tlet high = viewport.toValue;\n\t\tif (this.#compareValues(low, high) > 0) {\n\t\t\tconst t = low;\n\t\t\tlow = high;\n\t\t\thigh = t;\n\t\t}\n\t\tconst lowerCompare = this.#compareValues(value, low);\n\t\tconst upperCompare = this.#compareValues(value, high);\n\t\tif (lowerCompare >= 0 && upperCompare <= 0) return 0;\n\t\tconst lowerDistance = Math.abs(lowerCompare);\n\t\tconst upperDistance = Math.abs(upperCompare);\n\t\treturn Math.min(lowerDistance, upperDistance);\n\t}\n\n\t#isEntryProtectedByViewport(\n\t\tentry: CacheEntry,\n\t\tviewport: CacheViewport,\n\t): boolean {\n\t\treturn this.#distanceFromViewport(entry, viewport) === 0;\n\t}\n\n\t#compareValues(left: unknown, right: unknown): number {\n\t\tconst normalizedLeft = left instanceof Date ? left.getTime() : left;\n\t\tconst normalizedRight = right instanceof Date ? right.getTime() : right;\n\t\tif (\n\t\t\ttypeof normalizedLeft === \"number\" &&\n\t\t\ttypeof normalizedRight === \"number\"\n\t\t) {\n\t\t\tif (normalizedLeft === normalizedRight) return 0;\n\t\t\treturn normalizedLeft < normalizedRight ? -1 : 1;\n\t\t}\n\t\tconst leftStr = String(normalizedLeft);\n\t\tconst rightStr = String(normalizedRight);\n\t\treturn leftStr.localeCompare(rightStr);\n\t}\n}\n"]}

package/dist/chunk-5VMFQT5Z.js

@@ -0,0 +1,112 @@
+import { DEFAULT_SYNC_COLLECTION_ID, toSyncMessage } from './chunk-BJJEAKXL.js';
+import { partialSyncRowKey } from './chunk-UJ24XW52.js';
+import { __privateAdd, __privateSet, __privateGet, __privateMethod } from './chunk-HMLY7DHA.js';
+import { exhaustiveGuard } from '@firtoz/maybe-error';
+
+function toMillis(value) {
+  if (typeof value === "number") return value;
+  if (value instanceof Date) return value.getTime();
+  return 0;
+}
+var _cid, _PartialSyncMutationHandler_instances, emit_fn, intentToMessageLww_fn, handleMutateBatch_fn;
+var PartialSyncMutationHandler = class {
+  constructor(options) {
+    this.options = options;
+    __privateAdd(this, _PartialSyncMutationHandler_instances);
+    __privateAdd(this, _cid);
+    __privateSet(this, _cid, options.collectionId ?? DEFAULT_SYNC_COLLECTION_ID);
+  }
+  get collectionId() {
+    return __privateGet(this, _cid);
+  }
+  async handleClientMessage(message) {
+    const mid = message.collectionId ?? DEFAULT_SYNC_COLLECTION_ID;
+    if (mid !== __privateGet(this, _cid)) return;
+    switch (message.type) {
+      case "ping":
+        __privateMethod(this, _PartialSyncMutationHandler_instances, emit_fn).call(this, message.clientId, {
+          type: "pong",
+          timestamp: message.timestamp
+        });
+        return;
+      case "mutateBatch":
+        await __privateMethod(this, _PartialSyncMutationHandler_instances, handleMutateBatch_fn).call(this, message);
+        return;
+      case "syncHello":
+      case "queryRange":
+      case "queryByOffset":
+      case "rangeQuery":
+      case "rangeReconcile":
+        return;
+      default:
+        exhaustiveGuard(message);
+    }
+  }
+};
+_cid = new WeakMap();
+_PartialSyncMutationHandler_instances = new WeakSet();
+emit_fn = function(clientId, body) {
+  this.options.sendToClient(clientId, {
+    ...body,
+    collectionId: __privateGet(this, _cid)
+  });
+};
+intentToMessageLww_fn = async function(intent) {
+  const base = toSyncMessage(intent);
+  if (base.type !== "update") {
+    return base;
+  }
+  const key = partialSyncRowKey(intent.key ?? base.value.id);
+  const existing = await this.options.store.getRow(key);
+  if (!existing) {
+    return base;
+  }
+  const incomingUpdatedAt = toMillis(base.value.updatedAt);
+  const existingUpdatedAt = toMillis(existing.updatedAt);
+  if (incomingUpdatedAt <= existingUpdatedAt) {
+    return {
+      type: "update",
+      value: existing,
+      previousValue: base.previousValue
+    };
+  }
+  return base;
+};
+handleMutateBatch_fn = async function(message) {
+  const resolvedChanges = [];
+  const acceptedMutationIds = [];
+  for (const mutation of message.mutations) {
+    try {
+      const change = await __privateMethod(this, _PartialSyncMutationHandler_instances, intentToMessageLww_fn).call(this, mutation);
+      if (!change) {
+        continue;
+      }
+      resolvedChanges.push(change);
+      acceptedMutationIds.push(mutation.clientMutationId);
+    } catch (error) {
+      __privateMethod(this, _PartialSyncMutationHandler_instances, emit_fn).call(this, message.clientId, {
+        type: "reject",
+        clientId: message.clientId,
+        clientMutationId: mutation.clientMutationId,
+        reason: error instanceof Error ? error.message : String(error),
+        correctiveChanges: []
+      });
+    }
+  }
+  if (resolvedChanges.length === 0) return;
+  await this.options.store.applySyncMessages(resolvedChanges);
+  __privateMethod(this, _PartialSyncMutationHandler_instances, emit_fn).call(this, message.clientId, {
+    type: "ack",
+    clientId: message.clientId,
+    clientMutationIds: acceptedMutationIds,
+    serverVersion: 0,
+    changes: resolvedChanges
+  });
+  await this.options.partialBridge.pushServerChanges(resolvedChanges, {
+    excludeClientId: message.clientId
+  });
+};
+
+export { PartialSyncMutationHandler };
+//# sourceMappingURL=chunk-5VMFQT5Z.js.map
+//# sourceMappingURL=chunk-5VMFQT5Z.js.map

package/dist/chunk-5VMFQT5Z.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/partial-sync-mutation-handler.ts"],"names":[],"mappings":"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","file":"chunk-5VMFQT5Z.js","sourcesContent":["import type { SyncMessage } from \"@firtoz/db-helpers\";\nimport { exhaustiveGuard } from \"@firtoz/maybe-error\";\nimport type { PartialSyncServerBridge } from \"./partial-sync-server-bridge\";\nimport {\n\tpartialSyncRowKey,\n\ttype PartialSyncRowShape,\n} from \"./partial-sync-row-key\";\nimport type {\n\tMutationIntent,\n\tSyncClientMessage,\n\tSyncServerMessage,\n\tSyncServerMessageBody,\n} from \"./sync-protocol\";\nimport { DEFAULT_SYNC_COLLECTION_ID, toSyncMessage } from \"./sync-protocol\";\n\nexport interface PartialSyncMutationHandlerStore<\n\tTItem extends PartialSyncRowShape,\n> {\n\tapplySyncMessages: (messages: SyncMessage<TItem>[]) => Promise<void>;\n\tgetRow: (key: string | number) => Promise<TItem | undefined>;\n}\n\nexport interface PartialSyncMutationHandlerOptions<\n\tTItem extends PartialSyncRowShape,\n> {\n\tstore: PartialSyncMutationHandlerStore<TItem>;\n\tpartialBridge: Pick<PartialSyncServerBridge<TItem>, \"pushServerChanges\">;\n\tsendToClient: (clientId: string, message: SyncServerMessage<TItem>) => void;\n\tcollectionId?: string;\n}\n\nfunction toMillis(value: number | Date | null | undefined): number {\n\tif (typeof value === \"number\") return value;\n\tif (value instanceof Date) return value.getTime();\n\treturn 0;\n}\n\n/**\n * Partial-sync durable object mutation path: `mutateBatch` → `ack` / `reject` + interest-scoped\n * `rangePatch` via {@link PartialSyncServerBridge.pushServerChanges}. No `serverVersion`, changelog,\n * or `syncBatch` broadcast.\n */\nexport class PartialSyncMutationHandler<TItem extends PartialSyncRowShape> {\n\treadonly #cid: string;\n\n\tconstructor(\n\t\tprivate readonly options: PartialSyncMutationHandlerOptions<TItem>,\n\t) {\n\t\tthis.#cid = options.collectionId ?? DEFAULT_SYNC_COLLECTION_ID;\n\t}\n\n\tget collectionId(): string {\n\t\treturn this.#cid;\n\t}\n\n\t#emit(clientId: string, body: SyncServerMessageBody<TItem>): void {\n\t\tthis.options.sendToClient(clientId, {\n\t\t\t...body,\n\t\t\tcollectionId: this.#cid,\n\t\t} as SyncServerMessage<TItem>);\n\t}\n\n\tasync handleClientMessage(message: SyncClientMessage): Promise<void> {\n\t\tconst mid = message.collectionId ?? DEFAULT_SYNC_COLLECTION_ID;\n\t\tif (mid !== this.#cid) return;\n\t\tswitch (message.type) {\n\t\t\tcase \"ping\":\n\t\t\t\tthis.#emit(message.clientId, {\n\t\t\t\t\ttype: \"pong\",\n\t\t\t\t\ttimestamp: message.timestamp,\n\t\t\t\t});\n\t\t\t\treturn;\n\t\t\tcase \"mutateBatch\":\n\t\t\t\tawait this.#handleMutateBatch(message);\n\t\t\t\treturn;\n\t\t\tcase \"syncHello\":\n\t\t\tcase \"queryRange\":\n\t\t\tcase \"queryByOffset\":\n\t\t\tcase \"rangeQuery\":\n\t\t\tcase \"rangeReconcile\":\n\t\t\t\treturn;\n\t\t\tdefault:\n\t\t\t\texhaustiveGuard(message);\n\t\t}\n\t}\n\n\tasync #intentToMessageLww(\n\t\tintent: MutationIntent,\n\t): Promise<SyncMessage<TItem> | null> {\n\t\tconst base = toSyncMessage(intent) as SyncMessage<TItem>;\n\t\tif (base.type !== \"update\") {\n\t\t\treturn base;\n\t\t}\n\t\tconst key = partialSyncRowKey(intent.key ?? base.value.id);\n\t\tconst existing = await this.options.store.getRow(key);\n\t\tif (!existing) {\n\t\t\treturn base;\n\t\t}\n\t\tconst incomingUpdatedAt = toMillis(base.value.updatedAt);\n\t\tconst existingUpdatedAt = toMillis(existing.updatedAt);\n\t\tif (incomingUpdatedAt <= existingUpdatedAt) {\n\t\t\treturn {\n\t\t\t\ttype: \"update\",\n\t\t\t\tvalue: existing,\n\t\t\t\tpreviousValue: base.previousValue,\n\t\t\t};\n\t\t}\n\t\treturn base;\n\t}\n\n\tasync #handleMutateBatch(\n\t\tmessage: Extract<SyncClientMessage, { type: \"mutateBatch\" }>,\n\t): Promise<void> {\n\t\tconst resolvedChanges: SyncMessage<TItem>[] = [];\n\t\tconst acceptedMutationIds: string[] = [];\n\n\t\tfor (const mutation of message.mutations) {\n\t\t\ttry {\n\t\t\t\tconst change = await this.#intentToMessageLww(mutation);\n\t\t\t\tif (!change) {\n\t\t\t\t\tcontinue;\n\t\t\t\t}\n\t\t\t\tresolvedChanges.push(change);\n\t\t\t\tacceptedMutationIds.push(mutation.clientMutationId);\n\t\t\t} catch (error) {\n\t\t\t\tthis.#emit(message.clientId, {\n\t\t\t\t\ttype: \"reject\",\n\t\t\t\t\tclientId: message.clientId,\n\t\t\t\t\tclientMutationId: mutation.clientMutationId,\n\t\t\t\t\treason: error instanceof Error ? error.message : String(error),\n\t\t\t\t\tcorrectiveChanges: [],\n\t\t\t\t});\n\t\t\t}\n\t\t}\n\n\t\tif (resolvedChanges.length === 0) return;\n\n\t\tawait this.options.store.applySyncMessages(resolvedChanges);\n\n\t\tthis.#emit(message.clientId, {\n\t\t\ttype: \"ack\",\n\t\t\tclientId: message.clientId,\n\t\t\tclientMutationIds: acceptedMutationIds,\n\t\t\tserverVersion: 0,\n\t\t\tchanges: resolvedChanges,\n\t\t});\n\n\t\tawait this.options.partialBridge.pushServerChanges(resolvedChanges, {\n\t\t\texcludeClientId: message.clientId,\n\t\t});\n\t}\n}\n"]}