@firtoz/drizzle-indexeddb 3.0.1 → 4.0.0

package/CHANGELOG.md

@@ -1,5 +1,20 @@
 # @firtoz/drizzle-indexeddb
 
+## 4.0.0
+
+### Major Changes
+
+- [#64](https://github.com/firtoz/fullstack-toolkit/pull/64) [`556555a`](https://github.com/firtoz/fullstack-toolkit/commit/556555a2e09030a8658be8c07b5881e72be64b2f) Thanks [@firtoz](https://github.com/firtoz)! - **`@firtoz/drizzle-utils`:** Export `DrizzleSqliteTableCollection`; extend `BaseSyncConfig` / `createCollectionConfig` for typed `getSyncPersistKey` and `getKey` as `IdOf<TTable>`; avoid executing `syncableTable` default functions during table definition for Worker/DO globals; export collection helper types for Drizzle-backed TanStack collections.
+
+  **`@firtoz/drizzle-indexeddb` (major):** `deferLocalPersistence`, `handleBatchPut`, and related collection options; `receiveSync` persistence aligned with generic sync and partial-sync traffic; remove debug ingest usage. **Breaking** alongside the `@firtoz/drizzle-utils` sync/collection typing changes above (including `DrizzleSqliteTableCollection` and `BaseSyncConfig` expectations).
+
+### Patch Changes
+
+- Updated dependencies [[`556555a`](https://github.com/firtoz/fullstack-toolkit/commit/556555a2e09030a8658be8c07b5881e72be64b2f), [`556555a`](https://github.com/firtoz/fullstack-toolkit/commit/556555a2e09030a8658be8c07b5881e72be64b2f), [`556555a`](https://github.com/firtoz/fullstack-toolkit/commit/556555a2e09030a8658be8c07b5881e72be64b2f), [`f90479f`](https://github.com/firtoz/fullstack-toolkit/commit/f90479f263e932b39269aecce4f54dbbb7cdce3e)]:
+  - @firtoz/db-helpers@2.1.0
+  - @firtoz/drizzle-utils@1.2.0
+  - @firtoz/idb-collections@0.2.2
+
 ## 3.0.1
 
 ### Patch Changes

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@firtoz/drizzle-indexeddb",
-	"version": "3.0.1",
+	"version": "4.0.0",
 	"description": "IndexedDB migrations powered by Drizzle ORM",
 	"main": "./src/index.ts",
 	"module": "./src/index.ts",
@@ -39,7 +39,7 @@
 		"CHANGELOG.md"
 	],
 	"scripts": {
-		"typecheck": "tsc --noEmit -p ./tsconfig.json",
+		"typecheck": "tsgo --noEmit -p ./tsconfig.json",
 		"lint": "biome check --write src",
 		"lint:ci": "biome ci src",
 		"format": "biome format src --write"
@@ -68,25 +68,25 @@
 		"access": "public"
 	},
 	"peerDependencies": {
-		"@firtoz/drizzle-utils": ">=1.1.0",
-		"@tanstack/db": ">=0.5.33",
-		"drizzle-orm": ">=0.45.1",
+		"@firtoz/drizzle-utils": ">=1.2.0",
+		"@tanstack/db": ">=0.6.1",
+		"drizzle-orm": ">=0.45.2",
 		"drizzle-valibot": ">=0.4.0",
 		"react": ">=19.2.4",
 		"valibot": ">=1.3.1"
 	},
 	"devDependencies": {
-		"@firtoz/drizzle-utils": "^1.1.0",
-		"@tanstack/db": "^0.5.33",
+		"@firtoz/drizzle-utils": "^1.2.0",
+		"@tanstack/db": "^0.6.1",
 		"@types/react": "^19.2.14",
-		"drizzle-orm": "^0.45.1",
+		"drizzle-orm": "^0.45.2",
 		"drizzle-valibot": "^0.4.2",
 		"react": "^19.2.4",
 		"valibot": "^1.3.1"
 	},
 	"dependencies": {
-		"@firtoz/db-helpers": "^2.0.0",
-		"@firtoz/idb-collections": "^0.2.1",
+		"@firtoz/db-helpers": "^2.1.0",
+		"@firtoz/idb-collections": "^0.2.2",
 		"@firtoz/maybe-error": "^1.5.2",
 		"citty": "^0.2.1"
 	}

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

@@ -65,6 +65,11 @@ export interface DrizzleIndexedDBCollectionConfig<TTable extends Table> {
 	 * Enable debug logging for index discovery and query optimization
 	 */
 	debug?: boolean;
+	/**
+	 * When set, local mutations confirm TanStack sync immediately and persist to IndexedDB on a
+	 * coalesced timer (`createGenericSyncFunction` in `@firtoz/db-helpers`).
+	 */
+	deferLocalPersistence?: boolean | { flushIntervalMs?: number };
 }
 
 export type DrizzleIndexedDBCollectionConfigResult<TTable extends Table> = Omit<
@@ -284,6 +289,21 @@ export function drizzleIndexedDBCollectionOptions<const TTable extends Table>(
 			return results;
 		},
 
+		handleBatchPut: async (itemsToPut) => {
+			const db = config.indexedDBRef.current;
+			if (!db) {
+				throw new Error("Database not ready");
+			}
+			const now = new Date();
+			const rows = (itemsToPut as unknown as DrizzleIndexedDBSyncItem[]).map(
+				(row) => ({
+					...row,
+					updatedAt: now,
+				}),
+			);
+			await db.put(config.storeName, rows);
+		},
+
 		handleDelete: async (mutations) => {
 			const db = config.indexedDBRef.current;
 
@@ -320,11 +340,18 @@ export function drizzleIndexedDBCollectionOptions<const TTable extends Table>(
 		},
 	};
 
+	type TItem = InferSchemaOutput<SelectSchema<TTable>>;
+	const getKey = createGetKeyFunction<TTable>();
+
 	const baseSyncConfig: BaseSyncConfig<TTable> = {
 		table,
 		readyPromise: config.readyPromise,
 		syncMode: config.syncMode,
 		debug: config.debug,
+		getSyncPersistKey: (item: TItem) => String(getKey(item)),
+		...(config.deferLocalPersistence !== undefined
+			? { deferLocalPersistence: config.deferLocalPersistence }
+			: {}),
 	};
 
 	const syncResult = createSyncFunction(baseSyncConfig, wrappedBackend);
@@ -333,7 +360,7 @@ export function drizzleIndexedDBCollectionOptions<const TTable extends Table>(
 
 	return createCollectionConfig({
 		schema,
-		getKey: createGetKeyFunction<TTable>(),
+		getKey,
 		syncResult,
 		syncMode: config.syncMode,
 	});