@firtoz/db-helpers 2.1.1 → 2.2.0

package/README.md

@@ -1,8 +1,13 @@
 # @firtoz/db-helpers
 
-TanStack DB helpers and utilities. TypeScript-only, no build step—consume source directly.
+[![npm version](https://img.shields.io/npm/v/%40firtoz%2Fdb-helpers.svg)](https://www.npmjs.com/package/@firtoz/db-helpers)
+[![npm downloads](https://img.shields.io/npm/dm/%40firtoz%2Fdb-helpers.svg)](https://www.npmjs.com/package/@firtoz/db-helpers)
+[![license](https://img.shields.io/npm/l/%40firtoz%2Fdb-helpers.svg)](https://github.com/firtoz/fullstack-toolkit/blob/main/LICENSE)
 
-This package is a small collection of helpers for [@tanstack/db](https://tanstack.com/db). More utilities will be added over time.
+[![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)
+
+**Small helpers for [TanStack DB](https://tanstack.com/db)** — published as compiled `dist/` with types on npm. Memory collections, sync adapters, and more as the toolkit grows.
 
 ## Current helpers
 

package/dist/chunk-72YXZ3BK.js

@@ -0,0 +1,445 @@
+import { DeferredWriteQueue } from './chunk-E6ZONR5D.js';
+import { exhaustiveGuard } from '@firtoz/maybe-error';
+import { BasicIndex, DeduplicatedLoadSubset } from '@tanstack/db';
+
+var USE_DEDUPE = true;
+function createGenericSyncFunction(config, backend) {
+  let insertListener;
+  let updateListener;
+  let deleteListener;
+  let syncBegin = null;
+  let syncWrite = null;
+  let syncCommit = null;
+  let syncTruncate = null;
+  let initialSyncDone = null;
+  let syncLayerSerial = Promise.resolve();
+  const enqueueSyncLayer = (run) => {
+    const next = syncLayerSerial.catch(() => {
+    }).then(run);
+    syncLayerSerial = next;
+    return next;
+  };
+  function resolveDeferLocalPersistence(opts) {
+    if (opts === true) return { enabled: true, flushIntervalMs: 100 };
+    if (typeof opts === "object" && opts !== null) {
+      return { enabled: true, flushIntervalMs: opts.flushIntervalMs ?? 100 };
+    }
+    return { enabled: false, flushIntervalMs: 100 };
+  }
+  const deferOpts = resolveDeferLocalPersistence(config.deferLocalPersistence);
+  const resolveDeferredPersistKey = (item) => {
+    if (config.getSyncPersistKey !== void 0) {
+      return config.getSyncPersistKey(item);
+    }
+    if (item !== null && typeof item === "object" && "id" in item) {
+      const id = item.id;
+      if (typeof id === "string" || typeof id === "number") {
+        return String(id);
+      }
+    }
+    throw new Error(
+      "[deferLocalPersistence] Persist key missing: set GenericBaseSyncConfig.getSyncPersistKey or use items with string/number `id`"
+    );
+  };
+  let deferQueue = null;
+  if (deferOpts.enabled) {
+    deferQueue = new DeferredWriteQueue({
+      backend,
+      getPersistKey: resolveDeferredPersistKey,
+      flushIntervalMs: deferOpts.flushIntervalMs
+    });
+  }
+  const syncFn = (params) => {
+    const { begin, write, commit, markReady, truncate } = params;
+    syncBegin = begin;
+    syncWrite = write;
+    syncCommit = commit;
+    syncTruncate = truncate;
+    const initialSync = async () => {
+      await enqueueSyncLayer(async () => {
+        await config.readyPromise;
+        try {
+          const items = await backend.initialLoad();
+          begin();
+          for (const item of items) {
+            write({
+              type: "insert",
+              value: item
+            });
+          }
+          commit();
+        } finally {
+          markReady();
+        }
+      });
+    };
+    if (config.syncMode === "eager" || !config.syncMode) {
+      initialSyncDone = initialSync();
+    } else {
+      markReady();
+      initialSyncDone = Promise.resolve();
+    }
+    insertListener = async (params2) => {
+      await enqueueSyncLayer(async () => {
+        const items = params2.transaction.mutations.map((m) => m.modified);
+        if (deferQueue !== null) {
+          begin();
+          for (const item of items) {
+            write({
+              type: "insert",
+              value: item
+            });
+          }
+          commit();
+          deferQueue.enqueueInsert(items);
+          return;
+        }
+        const results = await backend.handleInsert(items);
+        begin();
+        for (const result of results) {
+          write({
+            type: "insert",
+            value: result
+          });
+        }
+        commit();
+      });
+    };
+    updateListener = async (params2) => {
+      await enqueueSyncLayer(async () => {
+        if (deferQueue !== null) {
+          const mutations = params2.transaction.mutations.map((m) => ({
+            key: String(m.key),
+            changes: m.changes,
+            original: m.original
+          }));
+          const results2 = mutations.map(
+            (m) => ({ ...m.original, ...m.changes })
+          );
+          begin();
+          for (const result of results2) {
+            write({
+              type: "update",
+              value: result
+            });
+          }
+          commit();
+          deferQueue.enqueueUpdate(mutations);
+          return;
+        }
+        const results = await backend.handleUpdate(
+          params2.transaction.mutations
+        );
+        begin();
+        for (const result of results) {
+          write({
+            type: "update",
+            value: result
+          });
+        }
+        commit();
+      });
+    };
+    deleteListener = async (params2) => {
+      await enqueueSyncLayer(async () => {
+        if (deferQueue !== null) {
+          const mutations = params2.transaction.mutations.map((m) => ({
+            key: String(m.key),
+            modified: m.modified,
+            original: m.original
+          }));
+          begin();
+          for (const item of mutations) {
+            write({
+              type: "delete",
+              value: item.modified
+            });
+          }
+          commit();
+          deferQueue.enqueueDelete(mutations);
+          return;
+        }
+        await backend.handleDelete(params2.transaction.mutations);
+        begin();
+        for (const item of params2.transaction.mutations) {
+          write({
+            type: "delete",
+            value: item.modified
+          });
+        }
+        commit();
+      });
+    };
+    const loadSubset = async (options) => {
+      await enqueueSyncLayer(async () => {
+        await config.readyPromise;
+        if (deferQueue !== null) {
+          await deferQueue.flush();
+        }
+        const items = await backend.loadSubset(options);
+        begin();
+        for (const item of items) {
+          write({
+            type: "insert",
+            value: item
+          });
+        }
+        commit();
+      });
+    };
+    let loadSubsetDedupe = null;
+    {
+      loadSubsetDedupe = new DeduplicatedLoadSubset({
+        loadSubset
+      });
+    }
+    return {
+      cleanup: () => {
+        deferQueue?.dispose();
+        deferQueue = null;
+        insertListener = void 0;
+        updateListener = void 0;
+        deleteListener = void 0;
+        loadSubsetDedupe?.reset();
+      },
+      loadSubset: loadSubsetDedupe?.loadSubset ?? loadSubset
+    };
+  };
+  const resolveReceiveSyncPersistKey = (item) => {
+    if (config.getSyncPersistKey !== void 0) {
+      return config.getSyncPersistKey(item);
+    }
+    if (item !== null && typeof item === "object" && "id" in item) {
+      const id = item.id;
+      if (typeof id === "string" || typeof id === "number") {
+        return String(id);
+      }
+    }
+    throw new Error(
+      "[receiveSync] Persist key missing: set GenericBaseSyncConfig.getSyncPersistKey or use items with string/number `id`"
+    );
+  };
+  const shallowRecordDiff = (previous, next) => {
+    const out = {};
+    if (previous !== null && typeof previous === "object" && next !== null && typeof next === "object") {
+      const prevRec = previous;
+      const nextRec = next;
+      for (const k of Object.keys(nextRec)) {
+        if (prevRec[k] !== nextRec[k]) {
+          out[k] = nextRec[k];
+        }
+      }
+    }
+    return out;
+  };
+  const toReceiveSyncDurableOps = (messages) => {
+    const out = [];
+    for (const msg of messages) {
+      switch (msg.type) {
+        case "insert":
+          out.push({ type: "insert", value: msg.value });
+          break;
+        case "update":
+          out.push({
+            type: "update",
+            key: resolveReceiveSyncPersistKey(msg.value),
+            changes: shallowRecordDiff(
+              msg.previousValue,
+              msg.value
+            ),
+            original: msg.previousValue
+          });
+          break;
+        case "delete":
+          out.push({ type: "delete", key: String(msg.key) });
+          break;
+        case "truncate":
+          out.push({ type: "truncate" });
+          break;
+        default:
+          exhaustiveGuard(msg);
+      }
+    }
+    return out;
+  };
+  const receiveSync = async (messages) => {
+    if (messages.length === 0) return;
+    await enqueueSyncLayer(async () => {
+      if (initialSyncDone) {
+        await initialSyncDone;
+      }
+      if (!syncBegin || !syncWrite || !syncCommit || !syncTruncate) {
+        if (config.debug) {
+          console.warn(
+            "[receiveSync] Sync functions not initialized yet - messages will be dropped",
+            messages.length
+          );
+        }
+        return;
+      }
+      if (deferQueue !== null) {
+        await deferQueue.flush();
+      }
+      syncBegin();
+      try {
+        const applyBatch = backend.applyReceiveSyncDurableWrites;
+        if (applyBatch !== void 0) {
+          await applyBatch(toReceiveSyncDurableOps(messages));
+          for (const msg of messages) {
+            switch (msg.type) {
+              case "insert":
+                syncWrite({ type: "insert", value: msg.value });
+                break;
+              case "update":
+                syncWrite({ type: "update", value: msg.value });
+                break;
+              case "delete":
+                syncWrite({
+                  type: "delete",
+                  value: { id: msg.key }
+                });
+                break;
+              case "truncate":
+                syncTruncate();
+                break;
+              default:
+                exhaustiveGuard(msg);
+            }
+          }
+        } else {
+          for (const msg of messages) {
+            switch (msg.type) {
+              case "insert":
+                await backend.handleInsert([msg.value]);
+                syncWrite({ type: "insert", value: msg.value });
+                break;
+              case "update": {
+                const key = resolveReceiveSyncPersistKey(msg.value);
+                await backend.handleUpdate([
+                  {
+                    key,
+                    changes: shallowRecordDiff(
+                      msg.previousValue,
+                      msg.value
+                    ),
+                    original: msg.previousValue
+                  }
+                ]);
+                syncWrite({ type: "update", value: msg.value });
+                break;
+              }
+              case "delete":
+                await backend.handleDelete([
+                  {
+                    key: String(msg.key),
+                    modified: { id: msg.key },
+                    original: { id: msg.key }
+                  }
+                ]);
+                syncWrite({
+                  type: "delete",
+                  value: { id: msg.key }
+                });
+                break;
+              case "truncate":
+                if (backend.handleTruncate) {
+                  await backend.handleTruncate();
+                }
+                syncTruncate();
+                break;
+              default:
+                exhaustiveGuard(msg);
+            }
+          }
+        }
+      } catch (err) {
+        console.error(
+          "[receiveSync] error during sync writes, committing partial batch to avoid leaving transaction open",
+          err
+        );
+      }
+      syncCommit();
+    });
+  };
+  const utils = {
+    truncate: async () => {
+      const handleTruncate = backend.handleTruncate;
+      if (!handleTruncate) {
+        throw new Error("Truncate not supported by this backend");
+      }
+      if (!syncBegin || !syncTruncate || !syncCommit) {
+        throw new Error(
+          "Sync functions not initialized - sync function may not have been called yet"
+        );
+      }
+      await enqueueSyncLayer(async () => {
+        if (deferQueue !== null) {
+          await deferQueue.flush();
+        }
+        await handleTruncate();
+        const begin = syncBegin;
+        const trunc = syncTruncate;
+        const commit = syncCommit;
+        if (!begin || !trunc || !commit) {
+          throw new Error(
+            "Sync functions not initialized - sync function may not have been called yet"
+          );
+        }
+        begin();
+        trunc();
+        commit();
+      });
+    },
+    receiveSync
+  };
+  return {
+    sync: syncFn,
+    onInsert: async (params) => {
+      if (!insertListener) {
+        throw new Error(
+          "insertListener not initialized - sync function may not have been called yet"
+        );
+      }
+      return insertListener(params);
+    },
+    onUpdate: async (params) => {
+      if (!updateListener) {
+        throw new Error(
+          "updateListener not initialized - sync function may not have been called yet"
+        );
+      }
+      return updateListener(params);
+    },
+    onDelete: async (params) => {
+      if (!deleteListener) {
+        throw new Error(
+          "deleteListener not initialized - sync function may not have been called yet"
+        );
+      }
+      return deleteListener(params);
+    },
+    utils
+  };
+}
+function createGenericCollectionConfig(config) {
+  return {
+    schema: config.schema,
+    getKey: config.getKey,
+    sync: {
+      sync: config.syncResult.sync
+    },
+    onInsert: config.onInsert ?? config.syncResult.onInsert,
+    onUpdate: config.onUpdate ?? config.syncResult.onUpdate,
+    onDelete: config.onDelete ?? config.syncResult.onDelete,
+    syncMode: config.syncMode,
+    // TanStack DB 0.6+: indexing is opt-in; eager BasicIndex restores pre-0.6 behavior for
+    // orderBy/limit live queries (playground pagination, usePredicateFilteredRows, etc.).
+    defaultIndexType: BasicIndex,
+    autoIndex: "eager",
+    utils: config.syncResult.utils
+  };
+}
+
+export { USE_DEDUPE, createGenericCollectionConfig, createGenericSyncFunction };
+//# sourceMappingURL=chunk-72YXZ3BK.js.map
+//# sourceMappingURL=chunk-72YXZ3BK.js.map

package/dist/chunk-72YXZ3BK.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/generic-sync.ts"],"names":["params","results"],"mappings":"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","file":"chunk-72YXZ3BK.js","sourcesContent":["import type {\n\tCollectionUtils,\n\tReceiveSyncDurableOp,\n\tSyncMessage,\n} from \"./sync-types\";\nimport { DeferredWriteQueue } from \"./deferred-write-queue\";\nimport { exhaustiveGuard } from \"@firtoz/maybe-error\";\nimport type { StandardSchemaV1 } from \"@standard-schema/spec\";\nimport type {\n\tCollectionConfig,\n\tInferSchemaOutput,\n\tSyncConfig,\n\tSyncConfigRes,\n\tSyncMode,\n\tLoadSubsetOptions,\n} from \"@tanstack/db\";\nimport { BasicIndex, DeduplicatedLoadSubset } from \"@tanstack/db\";\n\n// DeduplicatedLoadSubset dedupes overlapping loadSubset calls. Previously disabled for TanStack/db#828\n// (invalid OR expressions when toggling isNull/isNotNull). Re-enabled with @tanstack/db 0.6.4; if\n// regressions appear, set back to false and add a regression test.\nexport const USE_DEDUPE = true as boolean;\n\n/**\n * Base configuration for sync lifecycle management (generic, no Drizzle dependency).\n */\nexport interface GenericBaseSyncConfig<TItem extends object = object> {\n\treadyPromise: Promise<void>;\n\tsyncMode?: SyncMode;\n\tdebug?: boolean;\n\t/**\n\t * Row key for durable storage when applying {@link CollectionUtils.receiveSync} updates.\n\t * If omitted, `id` on the item (string or number) is used.\n\t */\n\tgetSyncPersistKey?: (item: TItem) => string;\n\t/**\n\t * When set, local `onInsert` / `onUpdate` / `onDelete` confirm TanStack sync state immediately\n\t * and enqueue durable backend writes (coalesced, flushed on an interval). `receiveSync`,\n\t * `loadSubset`, and `truncate` flush the queue first so reads stay consistent.\n\t */\n\tdeferLocalPersistence?: boolean | { flushIntervalMs?: number };\n}\n\n/**\n * Backend-specific implementations required for sync (generic, no Drizzle dependency).\n */\nexport interface GenericSyncBackend<TItem extends object> {\n\tinitialLoad: () => Promise<Array<TItem>>;\n\tloadSubset: (options: LoadSubsetOptions) => Promise<Array<TItem>>;\n\thandleInsert: (items: Array<TItem>) => Promise<Array<TItem>>;\n\thandleUpdate: (\n\t\tmutations: Array<{\n\t\t\tkey: string;\n\t\t\tchanges: Partial<TItem>;\n\t\t\toriginal: TItem;\n\t\t}>,\n\t) => Promise<Array<TItem>>;\n\thandleDelete: (\n\t\tmutations: Array<{\n\t\t\tkey: string;\n\t\t\tmodified: TItem;\n\t\t\toriginal: TItem;\n\t\t}>,\n\t) => Promise<void>;\n\thandleTruncate?: () => Promise<void>;\n\t/**\n\t * When set, {@link CollectionUtils.receiveSync} persists an entire message batch with one call\n\t * (e.g. one SQLite transaction) instead of awaiting {@link handleInsert}/handleUpdate per\n\t * message. TanStack `syncWrite`/`syncTruncate` still run once per message in order.\n\t */\n\tapplyReceiveSyncDurableWrites?: (\n\t\tops: ReceiveSyncDurableOp<TItem>[],\n\t) => Promise<void>;\n\t/**\n\t * Optional batch upsert for deferred local persistence flushes (e.g. IndexedDB `put` in one tx).\n\t */\n\thandleBatchPut?: (items: Array<TItem>) => Promise<void>;\n}\n\n/**\n * Return type for createGenericSyncFunction.\n */\nexport type GenericSyncFunctionResult<TItem extends object> = {\n\tsync: SyncConfig<TItem, string>[\"sync\"];\n\tonInsert: CollectionConfig<\n\t\tTItem,\n\t\tstring,\n\t\t// biome-ignore lint/suspicious/noExplicitAny: Schema type parameter needs to be flexible\n\t\tany\n\t>[\"onInsert\"];\n\tonUpdate: CollectionConfig<\n\t\tTItem,\n\t\tstring,\n\t\t// biome-ignore lint/suspicious/noExplicitAny: Schema type parameter needs to be flexible\n\t\tany\n\t>[\"onUpdate\"];\n\tonDelete: CollectionConfig<\n\t\tTItem,\n\t\tstring,\n\t\t// biome-ignore lint/suspicious/noExplicitAny: Schema type parameter needs to be flexible\n\t\tany\n\t>[\"onDelete\"];\n\tutils: CollectionUtils<TItem>;\n};\n\n/**\n * Creates the sync function with common lifecycle management.\n * Generic version -- no Drizzle dependency.\n */\nexport function createGenericSyncFunction<TItem extends object>(\n\tconfig: GenericBaseSyncConfig<TItem>,\n\tbackend: GenericSyncBackend<TItem>,\n): GenericSyncFunctionResult<TItem> {\n\ttype CollectionType = CollectionConfig<\n\t\tTItem,\n\t\tstring,\n\t\t// biome-ignore lint/suspicious/noExplicitAny: Schema type parameter needs to be flexible\n\t\tany\n\t>;\n\n\tlet insertListener: CollectionType[\"onInsert\"];\n\tlet updateListener: CollectionType[\"onUpdate\"];\n\tlet deleteListener: CollectionType[\"onDelete\"];\n\n\tlet syncBegin: (() => void) | null = null;\n\tlet syncWrite:\n\t\t| ((op: { type: \"insert\" | \"update\" | \"delete\"; value: TItem }) => void)\n\t\t| null = null;\n\tlet syncCommit: (() => void) | null = null;\n\tlet syncTruncate: (() => void) | null = null;\n\t/** Resolves when eager `initialSync` has finished (or immediately in on-demand mode). Used so `receiveSync` cannot interleave with initial inserts. */\n\tlet initialSyncDone: Promise<void> | null = null;\n\t/**\n\t * TanStack DB allows only one pending sync transaction per collection. Every path that calls\n\t * `begin`/`commit` — `initialSync`, `loadSubset`, `onInsert`/`onUpdate`/`onDelete`, `receiveSync`,\n\t * and `truncate` — must run through this queue so async backends (e.g. SQLite WASM) cannot\n\t * leave a transaction open across an `await` while another path starts a second transaction.\n\t */\n\tlet syncLayerSerial: Promise<void> = Promise.resolve();\n\n\tconst enqueueSyncLayer = (run: () => void | Promise<void>): Promise<void> => {\n\t\tconst next = syncLayerSerial.catch(() => {}).then(run);\n\t\tsyncLayerSerial = next;\n\t\treturn next;\n\t};\n\n\tfunction resolveDeferLocalPersistence(\n\t\topts: GenericBaseSyncConfig<TItem>[\"deferLocalPersistence\"],\n\t): { enabled: boolean; flushIntervalMs: number } {\n\t\tif (opts === true) return { enabled: true, flushIntervalMs: 100 };\n\t\tif (typeof opts === \"object\" && opts !== null) {\n\t\t\treturn { enabled: true, flushIntervalMs: opts.flushIntervalMs ?? 100 };\n\t\t}\n\t\treturn { enabled: false, flushIntervalMs: 100 };\n\t}\n\n\tconst deferOpts = resolveDeferLocalPersistence(config.deferLocalPersistence);\n\n\tconst resolveDeferredPersistKey = (item: TItem): string => {\n\t\tif (config.getSyncPersistKey !== undefined) {\n\t\t\treturn config.getSyncPersistKey(item);\n\t\t}\n\t\tif (item !== null && typeof item === \"object\" && \"id\" in item) {\n\t\t\tconst id = (item as { id: unknown }).id;\n\t\t\tif (typeof id === \"string\" || typeof id === \"number\") {\n\t\t\t\treturn String(id);\n\t\t\t}\n\t\t}\n\t\tthrow new Error(\n\t\t\t\"[deferLocalPersistence] Persist key missing: set GenericBaseSyncConfig.getSyncPersistKey or use items with string/number `id`\",\n\t\t);\n\t};\n\n\tlet deferQueue: DeferredWriteQueue<TItem> | null = null;\n\tif (deferOpts.enabled) {\n\t\tdeferQueue = new DeferredWriteQueue({\n\t\t\tbackend,\n\t\t\tgetPersistKey: resolveDeferredPersistKey,\n\t\t\tflushIntervalMs: deferOpts.flushIntervalMs,\n\t\t});\n\t}\n\n\tconst syncFn: SyncConfig<TItem, string>[\"sync\"] = (params) => {\n\t\tconst { begin, write, commit, markReady, truncate } = params;\n\n\t\tsyncBegin = begin;\n\t\tsyncWrite = write;\n\t\tsyncCommit = commit;\n\t\tsyncTruncate = truncate;\n\n\t\tconst initialSync = async () => {\n\t\t\tawait enqueueSyncLayer(async () => {\n\t\t\t\tawait config.readyPromise;\n\n\t\t\t\ttry {\n\t\t\t\t\tconst items = await backend.initialLoad();\n\n\t\t\t\t\tbegin();\n\n\t\t\t\t\tfor (const item of items) {\n\t\t\t\t\t\twrite({\n\t\t\t\t\t\t\ttype: \"insert\",\n\t\t\t\t\t\t\tvalue: item,\n\t\t\t\t\t\t});\n\t\t\t\t\t}\n\n\t\t\t\t\tcommit();\n\t\t\t\t} finally {\n\t\t\t\t\tmarkReady();\n\t\t\t\t}\n\t\t\t});\n\t\t};\n\n\t\tif (config.syncMode === \"eager\" || !config.syncMode) {\n\t\t\tinitialSyncDone = initialSync();\n\t\t} else {\n\t\t\tmarkReady();\n\t\t\tinitialSyncDone = Promise.resolve();\n\t\t}\n\n\t\tinsertListener = async (params) => {\n\t\t\tawait enqueueSyncLayer(async () => {\n\t\t\t\tconst items = params.transaction.mutations.map((m) => m.modified);\n\t\t\t\tif (deferQueue !== null) {\n\t\t\t\t\tbegin();\n\t\t\t\t\tfor (const item of items) {\n\t\t\t\t\t\twrite({\n\t\t\t\t\t\t\ttype: \"insert\",\n\t\t\t\t\t\t\tvalue: item,\n\t\t\t\t\t\t});\n\t\t\t\t\t}\n\t\t\t\t\tcommit();\n\t\t\t\t\tdeferQueue.enqueueInsert(items);\n\t\t\t\t\treturn;\n\t\t\t\t}\n\n\t\t\t\tconst results = await backend.handleInsert(items);\n\n\t\t\t\tbegin();\n\t\t\t\tfor (const result of results) {\n\t\t\t\t\twrite({\n\t\t\t\t\t\ttype: \"insert\",\n\t\t\t\t\t\tvalue: result,\n\t\t\t\t\t});\n\t\t\t\t}\n\t\t\t\tcommit();\n\t\t\t});\n\t\t};\n\n\t\tupdateListener = async (params) => {\n\t\t\tawait enqueueSyncLayer(async () => {\n\t\t\t\tif (deferQueue !== null) {\n\t\t\t\t\tconst mutations = params.transaction.mutations.map((m) => ({\n\t\t\t\t\t\tkey: String(m.key),\n\t\t\t\t\t\tchanges: m.changes as Partial<TItem>,\n\t\t\t\t\t\toriginal: m.original as TItem,\n\t\t\t\t\t}));\n\t\t\t\t\tconst results = mutations.map(\n\t\t\t\t\t\t(m) => ({ ...m.original, ...m.changes }) as TItem,\n\t\t\t\t\t);\n\t\t\t\t\tbegin();\n\t\t\t\t\tfor (const result of results) {\n\t\t\t\t\t\twrite({\n\t\t\t\t\t\t\ttype: \"update\",\n\t\t\t\t\t\t\tvalue: result,\n\t\t\t\t\t\t});\n\t\t\t\t\t}\n\t\t\t\t\tcommit();\n\t\t\t\t\tdeferQueue.enqueueUpdate(mutations);\n\t\t\t\t\treturn;\n\t\t\t\t}\n\n\t\t\t\tconst results = await backend.handleUpdate(\n\t\t\t\t\tparams.transaction.mutations,\n\t\t\t\t);\n\n\t\t\t\tbegin();\n\t\t\t\tfor (const result of results) {\n\t\t\t\t\twrite({\n\t\t\t\t\t\ttype: \"update\",\n\t\t\t\t\t\tvalue: result,\n\t\t\t\t\t});\n\t\t\t\t}\n\t\t\t\tcommit();\n\t\t\t});\n\t\t};\n\n\t\tdeleteListener = async (params) => {\n\t\t\tawait enqueueSyncLayer(async () => {\n\t\t\t\tif (deferQueue !== null) {\n\t\t\t\t\tconst mutations = params.transaction.mutations.map((m) => ({\n\t\t\t\t\t\tkey: String(m.key),\n\t\t\t\t\t\tmodified: m.modified as TItem,\n\t\t\t\t\t\toriginal: m.original as TItem,\n\t\t\t\t\t}));\n\t\t\t\t\tbegin();\n\t\t\t\t\tfor (const item of mutations) {\n\t\t\t\t\t\twrite({\n\t\t\t\t\t\t\ttype: \"delete\",\n\t\t\t\t\t\t\tvalue: item.modified,\n\t\t\t\t\t\t});\n\t\t\t\t\t}\n\t\t\t\t\tcommit();\n\t\t\t\t\tdeferQueue.enqueueDelete(mutations);\n\t\t\t\t\treturn;\n\t\t\t\t}\n\n\t\t\t\tawait backend.handleDelete(params.transaction.mutations);\n\n\t\t\t\tbegin();\n\t\t\t\tfor (const item of params.transaction.mutations) {\n\t\t\t\t\twrite({\n\t\t\t\t\t\ttype: \"delete\",\n\t\t\t\t\t\tvalue: item.modified,\n\t\t\t\t\t});\n\t\t\t\t}\n\t\t\t\tcommit();\n\t\t\t});\n\t\t};\n\n\t\tconst loadSubset = async (options: LoadSubsetOptions) => {\n\t\t\tawait enqueueSyncLayer(async () => {\n\t\t\t\tawait config.readyPromise;\n\n\t\t\t\tif (deferQueue !== null) {\n\t\t\t\t\tawait deferQueue.flush();\n\t\t\t\t}\n\n\t\t\t\tconst items = await backend.loadSubset(options);\n\n\t\t\t\tbegin();\n\n\t\t\t\tfor (const item of items) {\n\t\t\t\t\twrite({\n\t\t\t\t\t\ttype: \"insert\",\n\t\t\t\t\t\tvalue: item,\n\t\t\t\t\t});\n\t\t\t\t}\n\n\t\t\t\tcommit();\n\t\t\t});\n\t\t};\n\n\t\tlet loadSubsetDedupe: DeduplicatedLoadSubset | null = null;\n\t\tif (USE_DEDUPE) {\n\t\t\tloadSubsetDedupe = new DeduplicatedLoadSubset({\n\t\t\t\tloadSubset,\n\t\t\t});\n\t\t}\n\n\t\treturn {\n\t\t\tcleanup: () => {\n\t\t\t\tdeferQueue?.dispose();\n\t\t\t\tdeferQueue = null;\n\t\t\t\tinsertListener = undefined;\n\t\t\t\tupdateListener = undefined;\n\t\t\t\tdeleteListener = undefined;\n\t\t\t\tloadSubsetDedupe?.reset();\n\t\t\t},\n\t\t\tloadSubset: loadSubsetDedupe?.loadSubset ?? loadSubset,\n\t\t} satisfies SyncConfigRes;\n\t};\n\n\tconst resolveReceiveSyncPersistKey = (item: TItem): string => {\n\t\tif (config.getSyncPersistKey !== undefined) {\n\t\t\treturn config.getSyncPersistKey(item);\n\t\t}\n\t\tif (item !== null && typeof item === \"object\" && \"id\" in item) {\n\t\t\tconst id = (item as { id: unknown }).id;\n\t\t\tif (typeof id === \"string\" || typeof id === \"number\") {\n\t\t\t\treturn String(id);\n\t\t\t}\n\t\t}\n\t\tthrow new Error(\n\t\t\t\"[receiveSync] Persist key missing: set GenericBaseSyncConfig.getSyncPersistKey or use items with string/number `id`\",\n\t\t);\n\t};\n\n\tconst shallowRecordDiff = (previous: TItem, next: TItem): Partial<TItem> => {\n\t\tconst out: Partial<TItem> = {};\n\t\tif (\n\t\t\tprevious !== null &&\n\t\t\ttypeof previous === \"object\" &&\n\t\t\tnext !== null &&\n\t\t\ttypeof next === \"object\"\n\t\t) {\n\t\t\tconst prevRec = previous as Record<string, unknown>;\n\t\t\tconst nextRec = next as Record<string, unknown>;\n\t\t\tfor (const k of Object.keys(nextRec)) {\n\t\t\t\tif (prevRec[k] !== nextRec[k]) {\n\t\t\t\t\t(out as Record<string, unknown>)[k] = nextRec[k];\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\t\treturn out;\n\t};\n\n\tconst toReceiveSyncDurableOps = (\n\t\tmessages: SyncMessage<TItem>[],\n\t): ReceiveSyncDurableOp<TItem>[] => {\n\t\tconst out: ReceiveSyncDurableOp<TItem>[] = [];\n\t\tfor (const msg of messages) {\n\t\t\tswitch (msg.type) {\n\t\t\t\tcase \"insert\":\n\t\t\t\t\tout.push({ type: \"insert\", value: msg.value });\n\t\t\t\t\tbreak;\n\t\t\t\tcase \"update\":\n\t\t\t\t\tout.push({\n\t\t\t\t\t\ttype: \"update\",\n\t\t\t\t\t\tkey: resolveReceiveSyncPersistKey(msg.value),\n\t\t\t\t\t\tchanges: shallowRecordDiff(\n\t\t\t\t\t\t\tmsg.previousValue,\n\t\t\t\t\t\t\tmsg.value,\n\t\t\t\t\t\t) as Partial<TItem>,\n\t\t\t\t\t\toriginal: msg.previousValue,\n\t\t\t\t\t});\n\t\t\t\t\tbreak;\n\t\t\t\tcase \"delete\":\n\t\t\t\t\tout.push({ type: \"delete\", key: String(msg.key) });\n\t\t\t\t\tbreak;\n\t\t\t\tcase \"truncate\":\n\t\t\t\t\tout.push({ type: \"truncate\" });\n\t\t\t\t\tbreak;\n\t\t\t\tdefault:\n\t\t\t\t\texhaustiveGuard(msg);\n\t\t\t}\n\t\t}\n\t\treturn out;\n\t};\n\n\tconst receiveSync = async (messages: SyncMessage<TItem>[]) => {\n\t\tif (messages.length === 0) return;\n\n\t\tawait enqueueSyncLayer(async () => {\n\t\t\tif (initialSyncDone) {\n\t\t\t\tawait initialSyncDone;\n\t\t\t}\n\t\t\tif (!syncBegin || !syncWrite || !syncCommit || !syncTruncate) {\n\t\t\t\tif (config.debug) {\n\t\t\t\t\tconsole.warn(\n\t\t\t\t\t\t\"[receiveSync] Sync functions not initialized yet - messages will be dropped\",\n\t\t\t\t\t\tmessages.length,\n\t\t\t\t\t);\n\t\t\t\t}\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tif (deferQueue !== null) {\n\t\t\t\tawait deferQueue.flush();\n\t\t\t}\n\t\t\tsyncBegin();\n\n\t\t\ttry {\n\t\t\t\tconst applyBatch = backend.applyReceiveSyncDurableWrites;\n\t\t\t\tif (applyBatch !== undefined) {\n\t\t\t\t\tawait applyBatch(toReceiveSyncDurableOps(messages));\n\t\t\t\t\tfor (const msg of messages) {\n\t\t\t\t\t\tswitch (msg.type) {\n\t\t\t\t\t\t\tcase \"insert\":\n\t\t\t\t\t\t\t\tsyncWrite({ type: \"insert\", value: msg.value });\n\t\t\t\t\t\t\t\tbreak;\n\t\t\t\t\t\t\tcase \"update\":\n\t\t\t\t\t\t\t\tsyncWrite({ type: \"update\", value: msg.value });\n\t\t\t\t\t\t\t\tbreak;\n\t\t\t\t\t\t\tcase \"delete\":\n\t\t\t\t\t\t\t\tsyncWrite({\n\t\t\t\t\t\t\t\t\ttype: \"delete\",\n\t\t\t\t\t\t\t\t\tvalue: { id: msg.key } as TItem,\n\t\t\t\t\t\t\t\t});\n\t\t\t\t\t\t\t\tbreak;\n\t\t\t\t\t\t\tcase \"truncate\":\n\t\t\t\t\t\t\t\tsyncTruncate();\n\t\t\t\t\t\t\t\tbreak;\n\t\t\t\t\t\t\tdefault:\n\t\t\t\t\t\t\t\texhaustiveGuard(msg);\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\t\t\t\t} else {\n\t\t\t\t\tfor (const msg of messages) {\n\t\t\t\t\t\tswitch (msg.type) {\n\t\t\t\t\t\t\tcase \"insert\":\n\t\t\t\t\t\t\t\tawait backend.handleInsert([msg.value]);\n\t\t\t\t\t\t\t\tsyncWrite({ type: \"insert\", value: msg.value });\n\t\t\t\t\t\t\t\tbreak;\n\t\t\t\t\t\t\tcase \"update\": {\n\t\t\t\t\t\t\t\tconst key = resolveReceiveSyncPersistKey(msg.value);\n\t\t\t\t\t\t\t\tawait backend.handleUpdate([\n\t\t\t\t\t\t\t\t\t{\n\t\t\t\t\t\t\t\t\t\tkey,\n\t\t\t\t\t\t\t\t\t\tchanges: shallowRecordDiff(\n\t\t\t\t\t\t\t\t\t\t\tmsg.previousValue,\n\t\t\t\t\t\t\t\t\t\t\tmsg.value,\n\t\t\t\t\t\t\t\t\t\t) as Partial<TItem>,\n\t\t\t\t\t\t\t\t\t\toriginal: msg.previousValue,\n\t\t\t\t\t\t\t\t\t},\n\t\t\t\t\t\t\t\t]);\n\t\t\t\t\t\t\t\tsyncWrite({ type: \"update\", value: msg.value });\n\t\t\t\t\t\t\t\tbreak;\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\tcase \"delete\":\n\t\t\t\t\t\t\t\tawait backend.handleDelete([\n\t\t\t\t\t\t\t\t\t{\n\t\t\t\t\t\t\t\t\t\tkey: String(msg.key),\n\t\t\t\t\t\t\t\t\t\tmodified: { id: msg.key } as TItem,\n\t\t\t\t\t\t\t\t\t\toriginal: { id: msg.key } as TItem,\n\t\t\t\t\t\t\t\t\t},\n\t\t\t\t\t\t\t\t]);\n\t\t\t\t\t\t\t\tsyncWrite({\n\t\t\t\t\t\t\t\t\ttype: \"delete\",\n\t\t\t\t\t\t\t\t\tvalue: { id: msg.key } as TItem,\n\t\t\t\t\t\t\t\t});\n\t\t\t\t\t\t\t\tbreak;\n\t\t\t\t\t\t\tcase \"truncate\":\n\t\t\t\t\t\t\t\tif (backend.handleTruncate) {\n\t\t\t\t\t\t\t\t\tawait backend.handleTruncate();\n\t\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\t\tsyncTruncate();\n\t\t\t\t\t\t\t\tbreak;\n\t\t\t\t\t\t\tdefault:\n\t\t\t\t\t\t\t\texhaustiveGuard(msg);\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t} catch (err) {\n\t\t\t\tconsole.error(\n\t\t\t\t\t\"[receiveSync] error during sync writes, committing partial batch to avoid leaving transaction open\",\n\t\t\t\t\terr,\n\t\t\t\t);\n\t\t\t}\n\t\t\tsyncCommit();\n\t\t});\n\t};\n\n\tconst utils: CollectionUtils<TItem> = {\n\t\ttruncate: async () => {\n\t\t\tconst handleTruncate = backend.handleTruncate;\n\t\t\tif (!handleTruncate) {\n\t\t\t\tthrow new Error(\"Truncate not supported by this backend\");\n\t\t\t}\n\t\t\tif (!syncBegin || !syncTruncate || !syncCommit) {\n\t\t\t\tthrow new Error(\n\t\t\t\t\t\"Sync functions not initialized - sync function may not have been called yet\",\n\t\t\t\t);\n\t\t\t}\n\t\t\tawait enqueueSyncLayer(async () => {\n\t\t\t\tif (deferQueue !== null) {\n\t\t\t\t\tawait deferQueue.flush();\n\t\t\t\t}\n\t\t\t\tawait handleTruncate();\n\t\t\t\tconst begin = syncBegin;\n\t\t\t\tconst trunc = syncTruncate;\n\t\t\t\tconst commit = syncCommit;\n\t\t\t\tif (!begin || !trunc || !commit) {\n\t\t\t\t\tthrow new Error(\n\t\t\t\t\t\t\"Sync functions not initialized - sync function may not have been called yet\",\n\t\t\t\t\t);\n\t\t\t\t}\n\t\t\t\tbegin();\n\t\t\t\ttrunc();\n\t\t\t\tcommit();\n\t\t\t});\n\t\t},\n\t\treceiveSync,\n\t};\n\n\treturn {\n\t\tsync: syncFn,\n\t\tonInsert: async (params) => {\n\t\t\tif (!insertListener) {\n\t\t\t\tthrow new Error(\n\t\t\t\t\t\"insertListener not initialized - sync function may not have been called yet\",\n\t\t\t\t);\n\t\t\t}\n\t\t\treturn insertListener(params);\n\t\t},\n\t\tonUpdate: async (params) => {\n\t\t\tif (!updateListener) {\n\t\t\t\tthrow new Error(\n\t\t\t\t\t\"updateListener not initialized - sync function may not have been called yet\",\n\t\t\t\t);\n\t\t\t}\n\t\t\treturn updateListener(params);\n\t\t},\n\t\tonDelete: async (params) => {\n\t\t\tif (!deleteListener) {\n\t\t\t\tthrow new Error(\n\t\t\t\t\t\"deleteListener not initialized - sync function may not have been called yet\",\n\t\t\t\t);\n\t\t\t}\n\t\t\treturn deleteListener(params);\n\t\t},\n\t\tutils,\n\t};\n}\n\n/**\n * Generic collection config factory.\n * Combines schema, sync, and event handlers into a collection config.\n * No Drizzle dependency -- uses StandardSchemaV1 directly.\n */\nexport function createGenericCollectionConfig<\n\tTItem extends object,\n\tTSchema extends StandardSchemaV1,\n>(config: {\n\tschema: TSchema;\n\tgetKey: (item: TItem) => string;\n\tsyncResult: GenericSyncFunctionResult<TItem>;\n\tonInsert?: CollectionConfig<\n\t\tTItem,\n\t\tstring,\n\t\t// biome-ignore lint/suspicious/noExplicitAny: Schema type parameter needs to be flexible\n\t\tany\n\t>[\"onInsert\"];\n\tonUpdate?: CollectionConfig<\n\t\tTItem,\n\t\tstring,\n\t\t// biome-ignore lint/suspicious/noExplicitAny: Schema type parameter needs to be flexible\n\t\tany\n\t>[\"onUpdate\"];\n\tonDelete?: CollectionConfig<\n\t\tTItem,\n\t\tstring,\n\t\t// biome-ignore lint/suspicious/noExplicitAny: Schema type parameter needs to be flexible\n\t\tany\n\t>[\"onDelete\"];\n\tsyncMode?: SyncMode;\n}): Omit<\n\tCollectionConfig<\n\t\tTItem,\n\t\tstring,\n\t\tTSchema,\n\t\tCollectionUtils<InferSchemaOutput<TSchema>>\n\t>,\n\t\"utils\"\n> & {\n\tschema: TSchema;\n\tutils: CollectionUtils<InferSchemaOutput<TSchema>>;\n} {\n\treturn {\n\t\tschema: config.schema,\n\t\tgetKey: config.getKey,\n\t\tsync: {\n\t\t\tsync: config.syncResult.sync,\n\t\t},\n\t\tonInsert: config.onInsert ?? config.syncResult.onInsert,\n\t\tonUpdate: config.onUpdate ?? config.syncResult.onUpdate,\n\t\tonDelete: config.onDelete ?? config.syncResult.onDelete,\n\t\tsyncMode: config.syncMode,\n\t\t// TanStack DB 0.6+: indexing is opt-in; eager BasicIndex restores pre-0.6 behavior for\n\t\t// orderBy/limit live queries (playground pagination, usePredicateFilteredRows, etc.).\n\t\tdefaultIndexType: BasicIndex,\n\t\tautoIndex: \"eager\",\n\t\tutils: config.syncResult.utils as CollectionUtils<\n\t\t\tInferSchemaOutput<TSchema>\n\t\t>,\n\t};\n}\n"]}