@firtoz/drizzle-indexeddb 2.0.1 → 3.0.1

package/CHANGELOG.md

@@ -1,5 +1,20 @@
 # @firtoz/drizzle-indexeddb
 
+## 3.0.1
+
+### Patch Changes
+
+- [`8b839f2`](https://github.com/firtoz/fullstack-toolkit/commit/8b839f2227f50409af649aab87178e039aad55dc) Thanks [@firtoz](https://github.com/firtoz)! - Export collection helper types for Drizzle-backed TanStack DB collections so users can declare collection variables with preserved select and insert inference from table schemas.
+
+## 3.0.0
+
+### Patch Changes
+
+- [`b714ebb`](https://github.com/firtoz/fullstack-toolkit/commit/b714ebbb62ec0e3c3aa56c4105e7499fac11d1e5) Thanks [@firtoz](https://github.com/firtoz)! - Extract shared SQLite TanStack sync backend (`createSqliteTableSyncBackend`, IR→Drizzle helpers, `SQLOperation` types) into `@firtoz/drizzle-utils`. Add `@firtoz/drizzle-durable-sqlite` for Durable Object SQLite collections (`durableSqliteCollectionOptions`). Refactor `@firtoz/drizzle-sqlite-wasm` to use the shared backend with `driverMode: "async"`. `durableSqliteCollectionOptions` accepts optional `readyPromise` (defaults to immediate readiness). README documents the class-field Hono pattern, `app.fetch(request, env)` for bindings, optional `on-demand` + `preload` vs eager + `onFirstReady`, and `honoDoFetcherWithName` without a separate exported app type. Restore JSDoc on `DrizzleSqliteCollectionConfig` (`debug`, `checkpoint`, `interceptor`) for editor tooltips. Align `createStandaloneCollection` generics with `InsertToSelectSchema` from `@firtoz/drizzle-utils`.
+
+- Updated dependencies [[`b714ebb`](https://github.com/firtoz/fullstack-toolkit/commit/b714ebbb62ec0e3c3aa56c4105e7499fac11d1e5)]:
+  - @firtoz/drizzle-utils@1.1.0
+
 ## 2.0.1
 
 ### Patch Changes

package/README.md

@@ -100,16 +100,23 @@ Create reactive collections backed by IndexedDB:
 
 ```typescript
 import { createCollection } from "@tanstack/db";
-import { indexedDBCollectionOptions } from "@firtoz/drizzle-indexeddb";
+import {
+	drizzleIndexedDBCollectionOptions,
+	type DrizzleIndexedDBCollection,
+} from "@firtoz/drizzle-indexeddb";
+import * as schema from "./schema";
 
 const todosCollection = createCollection(
-  indexedDBCollectionOptions({
-    db,
-    tableName: "todos",
+  drizzleIndexedDBCollectionOptions({
+    indexedDBRef: { current: db },
+    table: schema.todoTable,
+    storeName: "todos",
     syncMode: "on-demand", // or "realtime"
   })
 );
 
+type TodosCollection = DrizzleIndexedDBCollection<typeof schema.todoTable>;
+
 // Subscribe to changes
 const unsubscribe = todosCollection.subscribe((todos) => {
   console.log("Todos updated:", todos);

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@firtoz/drizzle-indexeddb",
-	"version": "2.0.1",
+	"version": "3.0.1",
 	"description": "IndexedDB migrations powered by Drizzle ORM",
 	"main": "./src/index.ts",
 	"module": "./src/index.ts",
@@ -68,7 +68,7 @@
 		"access": "public"
 	},
 	"peerDependencies": {
-		"@firtoz/drizzle-utils": ">=1.0.2",
+		"@firtoz/drizzle-utils": ">=1.1.0",
 		"@tanstack/db": ">=0.5.33",
 		"drizzle-orm": ">=0.45.1",
 		"drizzle-valibot": ">=0.4.0",
@@ -76,7 +76,7 @@
 		"valibot": ">=1.3.1"
 	},
 	"devDependencies": {
-		"@firtoz/drizzle-utils": "^1.0.2",
+		"@firtoz/drizzle-utils": "^1.1.0",
 		"@tanstack/db": "^0.5.33",
 		"@types/react": "^19.2.14",
 		"drizzle-orm": "^0.45.1",

package/src/collections/drizzle-indexeddb-collection.ts

@@ -1,4 +1,10 @@
-import type { InferSchemaOutput, SyncMode } from "@tanstack/db";
+import type {
+	Collection,
+	CollectionConfig,
+	InferSchemaInput,
+	InferSchemaOutput,
+	SyncMode,
+} from "@tanstack/db";
 import type { IR } from "@tanstack/db";
 import { parseOrderByExpression } from "@tanstack/db";
 import type { Table } from "drizzle-orm";
@@ -6,6 +12,8 @@ import type { Table } from "drizzle-orm";
 import {
 	type IdOf,
 	type SelectSchema,
+	type InsertToSelectSchema,
+	type TableWithRequiredFields,
 	type BaseSyncConfig,
 	type SyncBackend,
 	createSyncFunction,
@@ -13,7 +21,7 @@ import {
 	createGetKeyFunction,
 	createCollectionConfig,
 } from "@firtoz/drizzle-utils";
-import { evaluateExpression } from "@firtoz/db-helpers";
+import { evaluateExpression, type CollectionUtils } from "@firtoz/db-helpers";
 import { tryExtractIndexedQuery } from "@firtoz/idb-collections";
 
 import type { IDBDatabaseLike } from "../idb-types";
@@ -59,6 +67,28 @@ export interface DrizzleIndexedDBCollectionConfig<TTable extends Table> {
 	debug?: boolean;
 }
 
+export type DrizzleIndexedDBCollectionConfigResult<TTable extends Table> = Omit<
+	CollectionConfig<
+		InferSchemaOutput<SelectSchema<TTable>>,
+		IdOf<TTable>,
+		InsertToSelectSchema<TTable>,
+		CollectionUtils<InferSchemaOutput<SelectSchema<TTable>>>
+	>,
+	"utils"
+> & {
+	schema: InsertToSelectSchema<TTable>;
+	utils: CollectionUtils<InferSchemaOutput<SelectSchema<TTable>>>;
+};
+
+export type DrizzleIndexedDBCollection<TTable extends TableWithRequiredFields> =
+	Collection<
+		InferSchemaOutput<SelectSchema<TTable>>,
+		IdOf<TTable>,
+		CollectionUtils<InferSchemaOutput<SelectSchema<TTable>>>,
+		InsertToSelectSchema<TTable>,
+		InferSchemaInput<InsertToSelectSchema<TTable>>
+	>;
+
 /**
  * Auto-discovers indexes from the IndexedDB store.
  * Returns a map of field names to index names for single-column indexes.
@@ -84,7 +114,7 @@ function discoverIndexes(
  */
 export function drizzleIndexedDBCollectionOptions<const TTable extends Table>(
 	config: DrizzleIndexedDBCollectionConfig<TTable>,
-) {
+): DrizzleIndexedDBCollectionConfigResult<TTable> {
 	let discoveredIndexes: Record<string, string> = {};
 	let indexesDiscovered = false;
 

package/src/index.ts

@@ -35,6 +35,8 @@ export { createInstrumentedDbCreator } from "./instrumented-idb-database";
 export {
 	drizzleIndexedDBCollectionOptions,
 	type DrizzleIndexedDBCollectionConfig,
+	type DrizzleIndexedDBCollectionConfigResult,
+	type DrizzleIndexedDBCollection,
 	type DrizzleIndexedDBSyncItem,
 } from "./collections/drizzle-indexeddb-collection";
 

package/src/standalone-collection.ts

@@ -9,7 +9,12 @@ import {
 } from "@tanstack/db";
 import type { Table } from "drizzle-orm";
 import type { CollectionUtils } from "@firtoz/db-helpers";
-import type { IdOf, InsertSchema, SelectSchema } from "@firtoz/drizzle-utils";
+import type {
+	IdOf,
+	InsertSchema,
+	InsertToSelectSchema,
+	SelectSchema,
+} from "@firtoz/drizzle-utils";
 import {
 	drizzleIndexedDBCollectionOptions,
 	type DrizzleIndexedDBCollectionConfig,
@@ -62,7 +67,7 @@ type InternalCollection<TTable extends Table> = Collection<
 	InferSchemaOutput<SelectSchema<TTable>>,
 	IdOf<TTable>,
 	CollectionUtils<InferSchemaOutput<SelectSchema<TTable>>>,
-	SelectSchema<TTable>,
+	InsertToSelectSchema<TTable>,
 	InferSchemaInput<InsertSchema<TTable>>
 >;
 
@@ -271,9 +276,9 @@ export function createStandaloneCollection<TTable extends Table>(
 		syncMode,
 	} as DrizzleIndexedDBCollectionConfig<TTable>);
 
-	// Create the collection
+	// biome-ignore lint/suspicious/noExplicitAny: createCollection overloads can't resolve InsertToSelectSchema for generic TTable; collection is re-typed below
 	const collection = createCollection(
-		collectionConfig,
+		collectionConfig as any,
 	) as unknown as InternalCollection<TTable>;
 
 	// Wait for collection to be ready