@firtoz/idb-collections 0.2.2 → 0.3.0

package/README.md

@@ -0,0 +1,46 @@
+# @firtoz/idb-collections
+
+[![npm version](https://img.shields.io/npm/v/%40firtoz%2Fidb-collections.svg)](https://www.npmjs.com/package/@firtoz/idb-collections)
+[![npm downloads](https://img.shields.io/npm/dm/%40firtoz%2Fidb-collections.svg)](https://www.npmjs.com/package/@firtoz/idb-collections)
+[![license](https://img.shields.io/npm/l/%40firtoz%2Fidb-collections.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)
+[![IndexedDB](https://img.shields.io/badge/IndexedDB-browser-2563eb)](https://developer.mozilla.org/en-US/docs/Web/API/IndexedDB_API)
+
+**Key-value collections on IndexedDB for [TanStack DB](https://tanstack.com/db)**—with a typed adapter, helpers to build key ranges from queries, and a path to fast local reads in the browser.
+
+## Installation
+
+```bash
+npm install @firtoz/idb-collections @tanstack/db @standard-schema/spec
+```
+
+Also: `pnpm add` · `bun add` · `yarn add`
+
+Peer dependencies: `@tanstack/db` and `@standard-schema/spec`. The package builds on [`@firtoz/db-helpers`](https://www.npmjs.com/package/@firtoz/db-helpers) for shared collection utilities.
+
+## What you get
+
+- **`createKeyValCollection` / `keyvalCollectionOptions`** — configure a TanStack DB collection backed by IndexedDB key-value storage.
+- **`tryExtractIndexedQuery`**, **`KeyRangeSpec`** — translate query intent into IDB key ranges where possible.
+
+## Usage
+
+```ts
+import {
+	createKeyValCollection,
+	keyvalCollectionOptions,
+	tryExtractIndexedQuery,
+} from "@firtoz/idb-collections";
+```
+
+See tests and consumers in the monorepo for full patterns.
+
+## Links
+
+- [GitHub](https://github.com/firtoz/fullstack-toolkit/tree/main/packages/idb-collections) · [Issues](https://github.com/firtoz/fullstack-toolkit/issues)
+
+## License
+
+MIT © [Firtina Ozbalikchi](https://github.com/firtoz)

package/dist/chunk-NGMCD6BY.js

@@ -0,0 +1,86 @@
+import { extractSimpleComparisons } from '@tanstack/db';
+
+// src/idb-query-utils.ts
+function tryExtractIndexedQuery(expression, indexes, debug) {
+  if (!indexes) {
+    return null;
+  }
+  try {
+    let comparisons;
+    try {
+      comparisons = extractSimpleComparisons(expression);
+    } catch {
+      if (debug) {
+        console.warn(
+          "Indexed query extraction skipped: expression not supported by extractSimpleComparisons"
+        );
+      }
+      return null;
+    }
+    if (comparisons.length !== 1) {
+      return null;
+    }
+    const comparison = comparisons[0];
+    const fieldName = comparison.field.join(".");
+    const lastIdx = comparison.field.length - 1;
+    const lastSegment = lastIdx >= 0 ? comparison.field[lastIdx] ?? "" : "";
+    const indexName = indexes[fieldName] ?? indexes[lastSegment];
+    if (!indexName) {
+      return null;
+    }
+    let keyRange = null;
+    switch (comparison.operator) {
+      case "eq":
+        keyRange = { type: "only", value: comparison.value };
+        break;
+      case "gt":
+        keyRange = {
+          type: "lowerBound",
+          lower: comparison.value,
+          lowerOpen: true
+        };
+        break;
+      case "gte":
+        keyRange = {
+          type: "lowerBound",
+          lower: comparison.value,
+          lowerOpen: false
+        };
+        break;
+      case "lt":
+        keyRange = {
+          type: "upperBound",
+          upper: comparison.value,
+          upperOpen: true
+        };
+        break;
+      case "lte":
+        keyRange = {
+          type: "upperBound",
+          upper: comparison.value,
+          upperOpen: false
+        };
+        break;
+      default:
+        if (debug) {
+          console.warn(
+            `Skipping indexed query extraction for unsupported operator: ${comparison.operator}`
+          );
+        }
+        return null;
+    }
+    if (!keyRange) {
+      return null;
+    }
+    return { fieldName, indexName, keyRange };
+  } catch (error) {
+    if (debug) {
+      console.warn("Error extracting indexed query", error, expression);
+    }
+    return null;
+  }
+}
+
+export { tryExtractIndexedQuery };
+//# sourceMappingURL=chunk-NGMCD6BY.js.map
+//# sourceMappingURL=chunk-NGMCD6BY.js.map

package/dist/chunk-NGMCD6BY.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/idb-query-utils.ts"],"names":[],"mappings":";;;AAyBO,SAAS,sBAAA,CACf,UAAA,EACA,OAAA,EACA,KAAA,EAC0E;AAC1E,EAAA,IAAI,CAAC,OAAA,EAAS;AACb,IAAA,OAAO,IAAA;AAAA,EACR;AAEA,EAAA,IAAI;AACH,IAAA,IAAI,WAAA;AACJ,IAAA,IAAI;AACH,MAAA,WAAA,GAAc,yBAAyB,UAAU,CAAA;AAAA,IAClD,CAAA,CAAA,MAAQ;AAEP,MAAA,IAAI,KAAA,EAAO;AACV,QAAA,OAAA,CAAQ,IAAA;AAAA,UACP;AAAA,SACD;AAAA,MACD;AACA,MAAA,OAAO,IAAA;AAAA,IACR;AAEA,IAAA,IAAI,WAAA,CAAY,WAAW,CAAA,EAAG;AAC7B,MAAA,OAAO,IAAA;AAAA,IACR;AAEA,IAAA,MAAM,UAAA,GAAa,YAAY,CAAC,CAAA;AAChC,IAAA,MAAM,SAAA,GAAY,UAAA,CAAW,KAAA,CAAM,IAAA,CAAK,GAAG,CAAA;AAC3C,IAAA,MAAM,OAAA,GAAU,UAAA,CAAW,KAAA,CAAM,MAAA,GAAS,CAAA;AAC1C,IAAA,MAAM,cAAc,OAAA,IAAW,CAAA,GAAK,WAAW,KAAA,CAAM,OAAO,KAAK,EAAA,GAAM,EAAA;AAEvE,IAAA,MAAM,SAAA,GAAY,OAAA,CAAQ,SAAS,CAAA,IAAK,QAAQ,WAAW,CAAA;AAE3D,IAAA,IAAI,CAAC,SAAA,EAAW;AACf,MAAA,OAAO,IAAA;AAAA,IACR;AAEA,IAAA,IAAI,QAAA,GAAgC,IAAA;AAEpC,IAAA,QAAQ,WAAW,QAAA;AAAU,MAC5B,KAAK,IAAA;AACJ,QAAA,QAAA,GAAW,EAAE,IAAA,EAAM,MAAA,EAAQ,KAAA,EAAO,WAAW,KAAA,EAAM;AACnD,QAAA;AAAA,MACD,KAAK,IAAA;AACJ,QAAA,QAAA,GAAW;AAAA,UACV,IAAA,EAAM,YAAA;AAAA,UACN,OAAO,UAAA,CAAW,KAAA;AAAA,UAClB,SAAA,EAAW;AAAA,SACZ;AACA,QAAA;AAAA,MACD,KAAK,KAAA;AACJ,QAAA,QAAA,GAAW;AAAA,UACV,IAAA,EAAM,YAAA;AAAA,UACN,OAAO,UAAA,CAAW,KAAA;AAAA,UAClB,SAAA,EAAW;AAAA,SACZ;AACA,QAAA;AAAA,MACD,KAAK,IAAA;AACJ,QAAA,QAAA,GAAW;AAAA,UACV,IAAA,EAAM,YAAA;AAAA,UACN,OAAO,UAAA,CAAW,KAAA;AAAA,UAClB,SAAA,EAAW;AAAA,SACZ;AACA,QAAA;AAAA,MACD,KAAK,KAAA;AACJ,QAAA,QAAA,GAAW;AAAA,UACV,IAAA,EAAM,YAAA;AAAA,UACN,OAAO,UAAA,CAAW,KAAA;AAAA,UAClB,SAAA,EAAW;AAAA,SACZ;AACA,QAAA;AAAA,MACD;AACC,QAAA,IAAI,KAAA,EAAO;AACV,UAAA,OAAA,CAAQ,IAAA;AAAA,YACP,CAAA,4DAAA,EAA+D,WAAW,QAAQ,CAAA;AAAA,WACnF;AAAA,QACD;AACA,QAAA,OAAO,IAAA;AAAA;AAGT,IAAA,IAAI,CAAC,QAAA,EAAU;AACd,MAAA,OAAO,IAAA;AAAA,IACR;AAEA,IAAA,OAAO,EAAE,SAAA,EAAW,SAAA,EAAW,QAAA,EAAS;AAAA,EACzC,SAAS,KAAA,EAAO;AACf,IAAA,IAAI,KAAA,EAAO;AACV,MAAA,OAAA,CAAQ,IAAA,CAAK,gCAAA,EAAkC,KAAA,EAAO,UAAU,CAAA;AAAA,IACjE;AACA,IAAA,OAAO,IAAA;AAAA,EACR;AACD","file":"chunk-NGMCD6BY.js","sourcesContent":["import type { IR } from \"@tanstack/db\";\nimport { extractSimpleComparisons } from \"@tanstack/db\";\n\n/**\n * Key range specification for index queries.\n * Used by IndexedDB implementations to build IDBKeyRange objects.\n */\nexport interface KeyRangeSpec {\n\ttype: \"only\" | \"lowerBound\" | \"upperBound\" | \"bound\";\n\tvalue?: unknown;\n\tlower?: unknown;\n\tupper?: unknown;\n\tlowerOpen?: boolean;\n\tupperOpen?: boolean;\n}\n\n/**\n * Attempts to extract a simple indexed query from an IR expression.\n * Returns the field name and key range if the query can be optimized.\n *\n * IndexedDB indexes are much more limited than SQL WHERE clauses:\n * - Only supports simple comparisons on a SINGLE indexed field\n * - Supported operators: eq, gt, gte, lt, lte\n * - Complex queries (AND, OR, NOT, multiple fields) fall back to in-memory filtering\n */\nexport function tryExtractIndexedQuery(\n\texpression: IR.BasicExpression,\n\tindexes?: Record<string, string>,\n\tdebug?: boolean,\n): { fieldName: string; indexName: string; keyRange: KeyRangeSpec } | null {\n\tif (!indexes) {\n\t\treturn null;\n\t}\n\n\ttry {\n\t\tlet comparisons: ReturnType<typeof extractSimpleComparisons>;\n\t\ttry {\n\t\t\tcomparisons = extractSimpleComparisons(expression);\n\t\t} catch {\n\t\t\t// e.g. `like` and other ops TanStack does not decompose here — fall back to full scan + filter\n\t\t\tif (debug) {\n\t\t\t\tconsole.warn(\n\t\t\t\t\t\"Indexed query extraction skipped: expression not supported by extractSimpleComparisons\",\n\t\t\t\t);\n\t\t\t}\n\t\t\treturn null;\n\t\t}\n\n\t\tif (comparisons.length !== 1) {\n\t\t\treturn null;\n\t\t}\n\n\t\tconst comparison = comparisons[0];\n\t\tconst fieldName = comparison.field.join(\".\");\n\t\tconst lastIdx = comparison.field.length - 1;\n\t\tconst lastSegment = lastIdx >= 0 ? (comparison.field[lastIdx] ?? \"\") : \"\";\n\t\t// TanStack may use nested refs (`todo.priority`); IDB indexes are keyed by column (e.g. `priority`)\n\t\tconst indexName = indexes[fieldName] ?? indexes[lastSegment];\n\n\t\tif (!indexName) {\n\t\t\treturn null;\n\t\t}\n\n\t\tlet keyRange: KeyRangeSpec | null = null;\n\n\t\tswitch (comparison.operator) {\n\t\t\tcase \"eq\":\n\t\t\t\tkeyRange = { type: \"only\", value: comparison.value };\n\t\t\t\tbreak;\n\t\t\tcase \"gt\":\n\t\t\t\tkeyRange = {\n\t\t\t\t\ttype: \"lowerBound\",\n\t\t\t\t\tlower: comparison.value,\n\t\t\t\t\tlowerOpen: true,\n\t\t\t\t};\n\t\t\t\tbreak;\n\t\t\tcase \"gte\":\n\t\t\t\tkeyRange = {\n\t\t\t\t\ttype: \"lowerBound\",\n\t\t\t\t\tlower: comparison.value,\n\t\t\t\t\tlowerOpen: false,\n\t\t\t\t};\n\t\t\t\tbreak;\n\t\t\tcase \"lt\":\n\t\t\t\tkeyRange = {\n\t\t\t\t\ttype: \"upperBound\",\n\t\t\t\t\tupper: comparison.value,\n\t\t\t\t\tupperOpen: true,\n\t\t\t\t};\n\t\t\t\tbreak;\n\t\t\tcase \"lte\":\n\t\t\t\tkeyRange = {\n\t\t\t\t\ttype: \"upperBound\",\n\t\t\t\t\tupper: comparison.value,\n\t\t\t\t\tupperOpen: false,\n\t\t\t\t};\n\t\t\t\tbreak;\n\t\t\tdefault:\n\t\t\t\tif (debug) {\n\t\t\t\t\tconsole.warn(\n\t\t\t\t\t\t`Skipping indexed query extraction for unsupported operator: ${comparison.operator}`,\n\t\t\t\t\t);\n\t\t\t\t}\n\t\t\t\treturn null;\n\t\t}\n\n\t\tif (!keyRange) {\n\t\t\treturn null;\n\t\t}\n\n\t\treturn { fieldName, indexName, keyRange };\n\t} catch (error) {\n\t\tif (debug) {\n\t\t\tconsole.warn(\"Error extracting indexed query\", error, expression);\n\t\t}\n\t\treturn null;\n\t}\n}\n"]}

package/dist/chunk-RKCR4KWV.js

@@ -0,0 +1,177 @@
+import { createCollection, parseOrderByExpression } from '@tanstack/db';
+import { createGenericSyncFunction, createGenericCollectionConfig, evaluateExpression } from '@firtoz/db-helpers';
+
+// src/keyvalCollection.ts
+function defaultGetKey(item) {
+  return item.id;
+}
+function keyvalCollectionOptions(config) {
+  const adapter = config.adapter;
+  const getKey = config.getKey ?? defaultGetKey;
+  const readyPromise = config.readyPromise ?? Promise.resolve();
+  const adapterSetMany = async (entries) => {
+    if (adapter.setMany) {
+      await adapter.setMany(entries);
+    } else {
+      for (const [key, value] of entries) {
+        await adapter.set(key, value);
+      }
+    }
+  };
+  const adapterDelMany = async (keys) => {
+    if (adapter.delMany) {
+      await adapter.delMany(keys);
+    } else {
+      for (const key of keys) {
+        await adapter.del(key);
+      }
+    }
+  };
+  const backend = {
+    initialLoad: async () => {
+      const allEntries = await adapter.entries();
+      return allEntries.map(([, value]) => value);
+    },
+    loadSubset: async (options) => {
+      const allEntries = await adapter.entries();
+      let items = allEntries.map(([, value]) => value);
+      let combinedWhere = options.where;
+      if (options.cursor?.whereFrom) {
+        if (combinedWhere) {
+          combinedWhere = {
+            type: "func",
+            name: "and",
+            args: [combinedWhere, options.cursor.whereFrom]
+          };
+        } else {
+          combinedWhere = options.cursor.whereFrom;
+        }
+      }
+      if (combinedWhere) {
+        const whereExpression = combinedWhere;
+        items = items.filter(
+          (item) => evaluateExpression(whereExpression, item)
+        );
+      }
+      if (options.orderBy) {
+        const sorts = parseOrderByExpression(options.orderBy);
+        items.sort((a, b) => {
+          for (const sort of sorts) {
+            let aValue = a;
+            let bValue = b;
+            for (const fieldName of sort.field) {
+              aValue = aValue?.[fieldName];
+              bValue = bValue?.[fieldName];
+            }
+            if (aValue < bValue) {
+              return sort.direction === "asc" ? -1 : 1;
+            }
+            if (aValue > bValue) {
+              return sort.direction === "asc" ? 1 : -1;
+            }
+          }
+          return 0;
+        });
+      }
+      if (options.offset !== void 0 && options.offset > 0) {
+        items = items.slice(options.offset);
+      }
+      if (options.limit !== void 0) {
+        items = items.slice(0, options.limit);
+      }
+      return items;
+    },
+    handleInsert: async (itemsToInsert) => {
+      const entries = itemsToInsert.map((item) => [
+        getKey(item),
+        item
+      ]);
+      await adapterSetMany(entries);
+      return itemsToInsert;
+    },
+    handleUpdate: async (mutations) => {
+      const results = [];
+      const entriesToSet = [];
+      for (const mutation of mutations) {
+        const existing = await adapter.get(mutation.key);
+        if (existing) {
+          const updatedItem = {
+            ...existing,
+            ...mutation.changes
+          };
+          entriesToSet.push([mutation.key, updatedItem]);
+          results.push(updatedItem);
+        } else {
+          results.push(mutation.original);
+        }
+      }
+      if (entriesToSet.length > 0) {
+        await adapterSetMany(entriesToSet);
+      }
+      return results;
+    },
+    handleDelete: async (mutations) => {
+      const keysToDelete = mutations.map((m) => m.key);
+      await adapterDelMany(keysToDelete);
+    },
+    handleTruncate: async () => {
+      await adapter.clear();
+    }
+  };
+  const wrappedBackend = {
+    ...backend,
+    initialLoad: async () => {
+      if (config.syncMode === "eager" || !config.syncMode) {
+        return await backend.initialLoad();
+      }
+      return [];
+    }
+  };
+  const baseSyncConfig = {
+    readyPromise,
+    syncMode: config.syncMode,
+    debug: config.debug,
+    getSyncPersistKey: getKey
+  };
+  const syncResult = createGenericSyncFunction(baseSyncConfig, wrappedBackend);
+  return createGenericCollectionConfig({
+    schema: config.schema,
+    getKey,
+    syncResult,
+    syncMode: config.syncMode,
+    onInsert: async (params) => {
+      await syncResult.onInsert?.(params);
+      const writes = params.transaction.mutations.map((mutation) => ({
+        type: "insert",
+        value: mutation.modified
+      }));
+      config.onBroadcast?.(writes);
+    },
+    onUpdate: async (params) => {
+      await syncResult.onUpdate?.(params);
+      const writes = params.transaction.mutations.map((mutation) => ({
+        type: "update",
+        value: mutation.modified,
+        previousValue: mutation.original
+      }));
+      config.onBroadcast?.(writes);
+    },
+    onDelete: async (params) => {
+      await syncResult.onDelete?.(params);
+      const writes = params.transaction.mutations.map((mutation) => ({
+        type: "delete",
+        key: mutation.key
+      }));
+      config.onBroadcast?.(writes);
+    }
+  });
+}
+function createKeyValCollection(config) {
+  return createCollection(
+    keyvalCollectionOptions(config)
+  );
+}
+
+export { createKeyValCollection, keyvalCollectionOptions };
+//# sourceMappingURL=chunk-RKCR4KWV.js.map
+//# sourceMappingURL=chunk-RKCR4KWV.js.map

package/dist/chunk-RKCR4KWV.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/keyvalCollection.ts"],"names":[],"mappings":"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","file":"chunk-RKCR4KWV.js","sourcesContent":["import type { StandardSchemaV1 } from \"@standard-schema/spec\";\nimport {\n\ttype Collection,\n\ttype CollectionConfig,\n\tcreateCollection,\n\ttype InferSchemaInput,\n\ttype InferSchemaOutput,\n\ttype IR,\n\ttype SyncMode,\n\tparseOrderByExpression,\n} from \"@tanstack/db\";\nimport type { SyncMessage, CollectionUtils } from \"@firtoz/db-helpers\";\nimport { evaluateExpression } from \"@firtoz/db-helpers\";\nimport {\n\ttype GenericBaseSyncConfig,\n\ttype GenericSyncBackend,\n\ttype GenericSyncFunctionResult,\n\tcreateGenericSyncFunction,\n\tcreateGenericCollectionConfig,\n} from \"@firtoz/db-helpers\";\n\n/**\n * Minimal key-value storage adapter.\n * Compatible with idb-keyval (almost directly) and localforage (via thin wrapper).\n */\nexport interface KeyValAdapter<T = unknown> {\n\tget(key: string): Promise<T | null | undefined>;\n\tset(key: string, value: T): Promise<void>;\n\tdel(key: string): Promise<void>;\n\tentries(): Promise<[string, T][]>;\n\tclear(): Promise<void>;\n\t/** Optional batch set for performance. Falls back to sequential set() calls. */\n\tsetMany?(entries: [string, T][]): Promise<void>;\n\t/** Optional batch delete for performance. Falls back to sequential del() calls. */\n\tdelMany?(keys: string[]): Promise<void>;\n}\n\nexport interface KeyValCollectionConfig<TSchema extends StandardSchemaV1> {\n\tschema: TSchema;\n\tadapter: KeyValAdapter<InferSchemaOutput<TSchema>>;\n\t/** Extracts the key from an item. Defaults to `(item) => item.id`. */\n\tgetKey?: (item: InferSchemaOutput<TSchema>) => string;\n\t/** Promise that resolves when the adapter is ready. Defaults to resolved. */\n\treadyPromise?: Promise<void>;\n\tsyncMode?: SyncMode;\n\tdebug?: boolean;\n\t/** Called when a local mutation is persisted; use to broadcast to other peers/tabs. */\n\tonBroadcast?: (\n\t\tchanges: SyncMessage<InferSchemaOutput<TSchema>, string | number>[],\n\t) => void;\n}\n\ntype KeyValUtils<TItem> = CollectionUtils<TItem>;\n\nfunction defaultGetKey<TSchema extends StandardSchemaV1>(\n\titem: InferSchemaOutput<TSchema>,\n): string {\n\treturn (item as { id: string }).id;\n}\n\nexport function keyvalCollectionOptions<TSchema extends StandardSchemaV1>(\n\tconfig: KeyValCollectionConfig<TSchema>,\n): CollectionConfig<\n\tInferSchemaOutput<TSchema>,\n\tstring,\n\tTSchema,\n\tKeyValUtils<InferSchemaOutput<TSchema>>\n> & {\n\tutils: KeyValUtils<InferSchemaOutput<TSchema>>;\n\tschema: TSchema;\n} {\n\ttype TItem = InferSchemaOutput<TSchema>;\n\n\tconst adapter = config.adapter;\n\tconst getKey = config.getKey ?? defaultGetKey<TSchema>;\n\tconst readyPromise = config.readyPromise ?? Promise.resolve();\n\n\tconst adapterSetMany = async (entries: [string, TItem][]) => {\n\t\tif (adapter.setMany) {\n\t\t\tawait adapter.setMany(entries);\n\t\t} else {\n\t\t\tfor (const [key, value] of entries) {\n\t\t\t\tawait adapter.set(key, value);\n\t\t\t}\n\t\t}\n\t};\n\n\tconst adapterDelMany = async (keys: string[]) => {\n\t\tif (adapter.delMany) {\n\t\t\tawait adapter.delMany(keys);\n\t\t} else {\n\t\t\tfor (const key of keys) {\n\t\t\t\tawait adapter.del(key);\n\t\t\t}\n\t\t}\n\t};\n\n\tconst backend: GenericSyncBackend<TItem> = {\n\t\tinitialLoad: async () => {\n\t\t\tconst allEntries = await adapter.entries();\n\t\t\treturn allEntries.map(([, value]) => value);\n\t\t},\n\n\t\tloadSubset: async (options) => {\n\t\t\tconst allEntries = await adapter.entries();\n\t\t\tlet items = allEntries.map(([, value]) => value);\n\n\t\t\tlet combinedWhere = options.where;\n\t\t\tif (options.cursor?.whereFrom) {\n\t\t\t\tif (combinedWhere) {\n\t\t\t\t\tcombinedWhere = {\n\t\t\t\t\t\ttype: \"func\",\n\t\t\t\t\t\tname: \"and\",\n\t\t\t\t\t\targs: [combinedWhere, options.cursor.whereFrom],\n\t\t\t\t\t} as IR.Func;\n\t\t\t\t} else {\n\t\t\t\t\tcombinedWhere = options.cursor.whereFrom;\n\t\t\t\t}\n\t\t\t}\n\n\t\t\tif (combinedWhere) {\n\t\t\t\tconst whereExpression = combinedWhere;\n\t\t\t\titems = items.filter((item) =>\n\t\t\t\t\tevaluateExpression(whereExpression, item as Record<string, unknown>),\n\t\t\t\t);\n\t\t\t}\n\n\t\t\tif (options.orderBy) {\n\t\t\t\tconst sorts = parseOrderByExpression(options.orderBy);\n\t\t\t\titems.sort((a, b) => {\n\t\t\t\t\tfor (const sort of sorts) {\n\t\t\t\t\t\t// biome-ignore lint/suspicious/noExplicitAny: Need any for dynamic field access\n\t\t\t\t\t\tlet aValue: any = a;\n\t\t\t\t\t\t// biome-ignore lint/suspicious/noExplicitAny: Need any for dynamic field access\n\t\t\t\t\t\tlet bValue: any = b;\n\t\t\t\t\t\tfor (const fieldName of sort.field) {\n\t\t\t\t\t\t\taValue = aValue?.[fieldName];\n\t\t\t\t\t\t\tbValue = bValue?.[fieldName];\n\t\t\t\t\t\t}\n\n\t\t\t\t\t\tif (aValue < bValue) {\n\t\t\t\t\t\t\treturn sort.direction === \"asc\" ? -1 : 1;\n\t\t\t\t\t\t}\n\t\t\t\t\t\tif (aValue > bValue) {\n\t\t\t\t\t\t\treturn sort.direction === \"asc\" ? 1 : -1;\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\t\t\t\t\treturn 0;\n\t\t\t\t});\n\t\t\t}\n\n\t\t\tif (options.offset !== undefined && options.offset > 0) {\n\t\t\t\titems = items.slice(options.offset);\n\t\t\t}\n\n\t\t\tif (options.limit !== undefined) {\n\t\t\t\titems = items.slice(0, options.limit);\n\t\t\t}\n\n\t\t\treturn items;\n\t\t},\n\n\t\thandleInsert: async (itemsToInsert) => {\n\t\t\tconst entries: [string, TItem][] = itemsToInsert.map((item) => [\n\t\t\t\tgetKey(item),\n\t\t\t\titem,\n\t\t\t]);\n\t\t\tawait adapterSetMany(entries);\n\t\t\treturn itemsToInsert;\n\t\t},\n\n\t\thandleUpdate: async (mutations) => {\n\t\t\tconst results: TItem[] = [];\n\t\t\tconst entriesToSet: [string, TItem][] = [];\n\n\t\t\tfor (const mutation of mutations) {\n\t\t\t\tconst existing = await adapter.get(mutation.key);\n\t\t\t\tif (existing) {\n\t\t\t\t\tconst updatedItem = {\n\t\t\t\t\t\t...existing,\n\t\t\t\t\t\t...mutation.changes,\n\t\t\t\t\t} as TItem;\n\t\t\t\t\tentriesToSet.push([mutation.key, updatedItem]);\n\t\t\t\t\tresults.push(updatedItem);\n\t\t\t\t} else {\n\t\t\t\t\tresults.push(mutation.original);\n\t\t\t\t}\n\t\t\t}\n\n\t\t\tif (entriesToSet.length > 0) {\n\t\t\t\tawait adapterSetMany(entriesToSet);\n\t\t\t}\n\n\t\t\treturn results;\n\t\t},\n\n\t\thandleDelete: async (mutations) => {\n\t\t\tconst keysToDelete = mutations.map((m) => m.key);\n\t\t\tawait adapterDelMany(keysToDelete);\n\t\t},\n\n\t\thandleTruncate: async () => {\n\t\t\tawait adapter.clear();\n\t\t},\n\t};\n\n\tconst wrappedBackend: GenericSyncBackend<TItem> = {\n\t\t...backend,\n\t\tinitialLoad: async () => {\n\t\t\tif (config.syncMode === \"eager\" || !config.syncMode) {\n\t\t\t\treturn await backend.initialLoad();\n\t\t\t}\n\t\t\treturn [];\n\t\t},\n\t};\n\n\tconst baseSyncConfig: GenericBaseSyncConfig<TItem> = {\n\t\treadyPromise,\n\t\tsyncMode: config.syncMode,\n\t\tdebug: config.debug,\n\t\tgetSyncPersistKey: getKey,\n\t};\n\n\tconst syncResult: GenericSyncFunctionResult<TItem> =\n\t\tcreateGenericSyncFunction(baseSyncConfig, wrappedBackend);\n\n\treturn createGenericCollectionConfig<TItem, TSchema>({\n\t\tschema: config.schema,\n\t\tgetKey,\n\t\tsyncResult,\n\t\tsyncMode: config.syncMode,\n\t\tonInsert: async (params) => {\n\t\t\tawait syncResult.onInsert?.(params);\n\t\t\tconst writes: SyncMessage<TItem, string>[] =\n\t\t\t\tparams.transaction.mutations.map((mutation) => ({\n\t\t\t\t\ttype: \"insert\",\n\t\t\t\t\tvalue: mutation.modified,\n\t\t\t\t}));\n\t\t\tconfig.onBroadcast?.(writes);\n\t\t},\n\t\tonUpdate: async (params) => {\n\t\t\tawait syncResult.onUpdate?.(params);\n\t\t\tconst writes: SyncMessage<TItem, string>[] =\n\t\t\t\tparams.transaction.mutations.map((mutation) => ({\n\t\t\t\t\ttype: \"update\",\n\t\t\t\t\tvalue: mutation.modified,\n\t\t\t\t\tpreviousValue: mutation.original,\n\t\t\t\t}));\n\t\t\tconfig.onBroadcast?.(writes);\n\t\t},\n\t\tonDelete: async (params) => {\n\t\t\tawait syncResult.onDelete?.(params);\n\t\t\tconst writes: SyncMessage<TItem, string>[] =\n\t\t\t\tparams.transaction.mutations.map((mutation) => ({\n\t\t\t\t\ttype: \"delete\",\n\t\t\t\t\tkey: mutation.key,\n\t\t\t\t}));\n\t\t\tconfig.onBroadcast?.(writes);\n\t\t},\n\t});\n}\n\nexport type KeyValCollection<TSchema extends StandardSchemaV1> = Collection<\n\tInferSchemaOutput<TSchema>,\n\tstring,\n\tKeyValUtils<InferSchemaOutput<TSchema>>,\n\tTSchema,\n\tInferSchemaInput<TSchema>\n>;\n\nexport function createKeyValCollection<TSchema extends StandardSchemaV1>(\n\tconfig: KeyValCollectionConfig<TSchema>,\n): KeyValCollection<TSchema> {\n\treturn createCollection(\n\t\tkeyvalCollectionOptions(config),\n\t) as KeyValCollection<TSchema>;\n}\n"]}

package/dist/idb-query-utils.d.ts

@@ -0,0 +1,30 @@
+import { IR } from '@tanstack/db';
+
+/**
+ * Key range specification for index queries.
+ * Used by IndexedDB implementations to build IDBKeyRange objects.
+ */
+interface KeyRangeSpec {
+    type: "only" | "lowerBound" | "upperBound" | "bound";
+    value?: unknown;
+    lower?: unknown;
+    upper?: unknown;
+    lowerOpen?: boolean;
+    upperOpen?: boolean;
+}
+/**
+ * Attempts to extract a simple indexed query from an IR expression.
+ * Returns the field name and key range if the query can be optimized.
+ *
+ * IndexedDB indexes are much more limited than SQL WHERE clauses:
+ * - Only supports simple comparisons on a SINGLE indexed field
+ * - Supported operators: eq, gt, gte, lt, lte
+ * - Complex queries (AND, OR, NOT, multiple fields) fall back to in-memory filtering
+ */
+declare function tryExtractIndexedQuery(expression: IR.BasicExpression, indexes?: Record<string, string>, debug?: boolean): {
+    fieldName: string;
+    indexName: string;
+    keyRange: KeyRangeSpec;
+} | null;
+
+export { type KeyRangeSpec, tryExtractIndexedQuery };

package/dist/idb-query-utils.js

@@ -0,0 +1,3 @@
+export { tryExtractIndexedQuery } from './chunk-NGMCD6BY.js';
+//# sourceMappingURL=idb-query-utils.js.map
+//# sourceMappingURL=idb-query-utils.js.map

package/dist/idb-query-utils.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export { KeyValAdapter, KeyValCollection, KeyValCollectionConfig, createKeyValCollection, keyvalCollectionOptions } from './keyvalCollection.js';
+export { KeyRangeSpec, tryExtractIndexedQuery } from './idb-query-utils.js';
+import '@standard-schema/spec';
+import '@tanstack/db';
+import '@firtoz/db-helpers';

package/dist/index.js

@@ -0,0 +1,4 @@
+export { tryExtractIndexedQuery } from './chunk-NGMCD6BY.js';
+export { createKeyValCollection, keyvalCollectionOptions } from './chunk-RKCR4KWV.js';
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/keyvalCollection.d.ts

@@ -0,0 +1,40 @@
+import { StandardSchemaV1 } from '@standard-schema/spec';
+import { InferSchemaOutput, SyncMode, CollectionConfig, Collection, InferSchemaInput } from '@tanstack/db';
+import { SyncMessage, CollectionUtils } from '@firtoz/db-helpers';
+
+/**
+ * Minimal key-value storage adapter.
+ * Compatible with idb-keyval (almost directly) and localforage (via thin wrapper).
+ */
+interface KeyValAdapter<T = unknown> {
+    get(key: string): Promise<T | null | undefined>;
+    set(key: string, value: T): Promise<void>;
+    del(key: string): Promise<void>;
+    entries(): Promise<[string, T][]>;
+    clear(): Promise<void>;
+    /** Optional batch set for performance. Falls back to sequential set() calls. */
+    setMany?(entries: [string, T][]): Promise<void>;
+    /** Optional batch delete for performance. Falls back to sequential del() calls. */
+    delMany?(keys: string[]): Promise<void>;
+}
+interface KeyValCollectionConfig<TSchema extends StandardSchemaV1> {
+    schema: TSchema;
+    adapter: KeyValAdapter<InferSchemaOutput<TSchema>>;
+    /** Extracts the key from an item. Defaults to `(item) => item.id`. */
+    getKey?: (item: InferSchemaOutput<TSchema>) => string;
+    /** Promise that resolves when the adapter is ready. Defaults to resolved. */
+    readyPromise?: Promise<void>;
+    syncMode?: SyncMode;
+    debug?: boolean;
+    /** Called when a local mutation is persisted; use to broadcast to other peers/tabs. */
+    onBroadcast?: (changes: SyncMessage<InferSchemaOutput<TSchema>, string | number>[]) => void;
+}
+type KeyValUtils<TItem> = CollectionUtils<TItem>;
+declare function keyvalCollectionOptions<TSchema extends StandardSchemaV1>(config: KeyValCollectionConfig<TSchema>): CollectionConfig<InferSchemaOutput<TSchema>, string, TSchema, KeyValUtils<InferSchemaOutput<TSchema>>> & {
+    utils: KeyValUtils<InferSchemaOutput<TSchema>>;
+    schema: TSchema;
+};
+type KeyValCollection<TSchema extends StandardSchemaV1> = Collection<InferSchemaOutput<TSchema>, string, KeyValUtils<InferSchemaOutput<TSchema>>, TSchema, InferSchemaInput<TSchema>>;
+declare function createKeyValCollection<TSchema extends StandardSchemaV1>(config: KeyValCollectionConfig<TSchema>): KeyValCollection<TSchema>;
+
+export { type KeyValAdapter, type KeyValCollection, type KeyValCollectionConfig, createKeyValCollection, keyvalCollectionOptions };

package/dist/keyvalCollection.js

@@ -0,0 +1,3 @@
+export { createKeyValCollection, keyvalCollectionOptions } from './chunk-RKCR4KWV.js';
+//# sourceMappingURL=keyvalCollection.js.map
+//# sourceMappingURL=keyvalCollection.js.map

package/dist/keyvalCollection.js.map

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

package/package.json

@@ -1,23 +1,28 @@
 {
 	"name": "@firtoz/idb-collections",
-	"version": "0.2.2",
+	"version": "0.3.0",
 	"description": "IndexedDB collection utilities for TanStack DB — key-value adapter, query optimization",
-	"main": "./src/index.ts",
-	"module": "./src/index.ts",
-	"types": "./src/index.ts",
+	"type": "module",
+	"main": "./dist/index.js",
+	"module": "./dist/index.js",
+	"types": "./dist/index.d.ts",
 	"exports": {
 		".": {
-			"types": "./src/index.ts",
-			"import": "./src/index.ts",
-			"require": "./src/index.ts"
+			"types": "./dist/index.d.ts",
+			"import": "./dist/index.js"
 		}
 	},
 	"files": [
+		"dist/**/*.js",
+		"dist/**/*.js.map",
+		"dist/**/*.d.ts",
 		"src/**/*.ts",
 		"!src/**/*.test.ts",
 		"README.md"
 	],
 	"scripts": {
+		"build": "tsup",
+		"prepack": "bun run build",
 		"typecheck": "tsgo --noEmit -p ./tsconfig.json",
 		"test": "bun test",
 		"lint": "biome check --write src",
@@ -51,15 +56,15 @@
 	},
 	"peerDependencies": {
 		"@standard-schema/spec": ">=1.1.0",
-		"@tanstack/db": ">=0.6.1"
+		"@tanstack/db": ">=0.6.3"
 	},
 	"devDependencies": {
 		"@standard-schema/spec": "^1.1.0",
-		"@tanstack/db": "^0.6.1",
+		"@tanstack/db": "^0.6.4",
 		"bun-types": "^1.3.11",
 		"zod": "^4.3.6"
 	},
 	"dependencies": {
-		"@firtoz/db-helpers": "^2.1.0"
+		"@firtoz/db-helpers": "^2.2.0"
 	}
 }