@firtoz/drizzle-indexeddb 0.5.1 → 0.6.1

package/CHANGELOG.md

@@ -1,5 +1,24 @@
 # @firtoz/drizzle-indexeddb
 
+## 0.6.1
+
+### Patch Changes
+
+- [`2725815`](https://github.com/firtoz/fullstack-toolkit/commit/27258158dd318b34b44ed77b88b2ac9b2b4b6a3d) Thanks [@firtoz](https://github.com/firtoz)! - Updated @tanstack/db peer dependency to >=0.5.23 for compatibility with latest versions
+
+- Updated dependencies [[`2725815`](https://github.com/firtoz/fullstack-toolkit/commit/27258158dd318b34b44ed77b88b2ac9b2b4b6a3d)]:
+  - @firtoz/drizzle-utils@0.3.2
+
+## 0.6.0
+
+### Minor Changes
+
+- [`a08a986`](https://github.com/firtoz/fullstack-toolkit/commit/a08a986cc5161b20c9c875328e49565c15417ffc) Thanks [@firtoz](https://github.com/firtoz)! - Slight refactor
+
+  - Renamed `createProxyDbCreator` to `createProxyIDbCreator` for consistency across the codebase.
+  - Updated server sync message type from `sync:clear` to `sync:truncate` to better reflect its functionality.
+  - Adjusted related documentation and test cases to align with these changes.
+
 ## 0.5.1
 
 ### Patch Changes
@@ -61,12 +80,12 @@
   - **`IDBProxyServer`** - Server that manages database lifecycle, migrations, and broadcasts mutations to connected clients
   - **`IDBProxyClient`** - Client implementing `IDBDatabaseLike`, routing operations through a transport layer
   - **`createMultiClientTransport()`** - In-memory transport for testing N clients connected to one server
-  - **`createProxyDbCreator()`** - Factory to create `dbCreator` for `DrizzleIndexedDBProvider`
+  - **`createProxyIDbCreator()`** - Factory to create `dbCreator` for `DrizzleIndexedDBProvider`
   - **`createCollectionSyncHandler()`** - Adapter connecting proxy sync messages to collection's external sync
 
   **Real-time Multi-Client Sync**:
 
-  - Server broadcasts `sync:add`, `sync:put`, `sync:delete`, `sync:clear` messages to all clients (excluding initiator)
+  - Server broadcasts `sync:add`, `sync:put`, `sync:delete`, `sync:truncate` messages to all clients (excluding initiator)
   - All mutations automatically sync across connected clients
 
   **Provider Enhancements**:

package/README.md

@@ -460,7 +460,7 @@ For scenarios where IndexedDB needs to be accessed over a messaging layer (e.g.,
 import {
   createMultiClientTransport,
   createProxyServer,
-  createProxyDbCreator,
+  createProxyIDbCreator,
   migrateIndexedDBWithFunctions,
   DrizzleIndexedDBProvider,
 } from "@firtoz/drizzle-indexeddb";
@@ -478,7 +478,7 @@ const server = createProxyServer({
 
 // Create client
 const clientTransport = createClientTransport();
-const dbCreator = createProxyDbCreator(clientTransport);
+const dbCreator = createProxyIDbCreator(clientTransport);
 
 // Use with React provider
 function App() {

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@firtoz/drizzle-indexeddb",
-	"version": "0.5.1",
+	"version": "0.6.1",
 	"description": "IndexedDB migrations powered by Drizzle ORM",
 	"main": "./src/index.ts",
 	"module": "./src/index.ts",
@@ -68,23 +68,23 @@
 		"access": "public"
 	},
 	"peerDependencies": {
-		"@firtoz/drizzle-utils": ">=0.3.1",
-		"@tanstack/db": ">=0.5.15",
+		"@firtoz/drizzle-utils": ">=0.3.2",
+		"@tanstack/db": ">=0.5.23",
 		"drizzle-orm": ">=0.45.1",
 		"drizzle-valibot": ">=0.4.0",
 		"react": ">=19.2.3",
 		"valibot": ">=1.0.0"
 	},
 	"devDependencies": {
-		"@firtoz/drizzle-utils": "^0.3.1",
-		"@tanstack/db": "^0.5.15",
-		"@types/react": "^19.2.7",
+		"@firtoz/drizzle-utils": "^0.3.2",
+		"@tanstack/db": "^0.5.23",
+		"@types/react": "^19.2.8",
 		"drizzle-orm": "^0.45.1",
 		"drizzle-valibot": "^0.4.2",
 		"react": "^19.2.3",
 		"valibot": "^1.2.0"
 	},
 	"dependencies": {
-		"citty": "^0.1.6"
+		"citty": "^0.2.0"
 	}
 }

package/src/collections/indexeddb-collection.ts

@@ -352,7 +352,7 @@ export function indexedDBCollectionOptions<const TTable extends Table>(
 
 	// Create backend-specific implementation
 	const backend: SyncBackend<TTable> = {
-		initialLoad: async (write) => {
+		initialLoad: async () => {
 			const db = config.indexedDBRef.current;
 			if (!db) {
 				throw new Error("Database not ready");
@@ -362,12 +362,9 @@ export function indexedDBCollectionOptions<const TTable extends Table>(
 
 			const items = await db.getAll<IndexedDBSyncItem>(config.storeName);
 
-			for (const item of items) {
-				write(item as unknown as InferSchemaOutput<SelectSchema<TTable>>);
-			}
+			return items as unknown as InferSchemaOutput<SelectSchema<TTable>>[];
 		},
-
-		loadSubset: async (options, write) => {
+		loadSubset: async (options) => {
 			const db = config.indexedDBRef.current;
 			if (!db) {
 				throw new Error("Database not ready");
@@ -462,37 +459,19 @@ export function indexedDBCollectionOptions<const TTable extends Table>(
 				items = items.slice(0, options.limit);
 			}
 
-			for (const item of items) {
-				write(item as unknown as InferSchemaOutput<SelectSchema<TTable>>);
-			}
+			return items as unknown as InferSchemaOutput<SelectSchema<TTable>>[];
 		},
 
-		handleInsert: async (mutations) => {
+		handleInsert: async (itemsToInsert) => {
 			const db = config.indexedDBRef.current;
 			if (!db) {
 				throw new Error("Database not ready");
 			}
 
-			const results: Array<InferSchemaOutput<SelectSchema<TTable>>> = [];
-
-			try {
-				const itemsToInsert: IndexedDBSyncItem[] = [];
-
-				for (const mutation of mutations) {
-					const itemToInsert = mutation.modified;
-					results.push(itemToInsert);
-					itemsToInsert.push(itemToInsert as IndexedDBSyncItem);
-				}
-
-				// Add all items in a single batch operation
-				await db.add(config.storeName, itemsToInsert);
-			} catch (error) {
-				// Clear results on error so nothing gets written to reactive store
-				results.length = 0;
-				throw error;
-			}
+			// Add all items in a single batch operation
+			await db.add(config.storeName, itemsToInsert);
 
-			return results;
+			return itemsToInsert;
 		},
 
 		handleUpdate: async (mutations) => {
@@ -565,13 +544,15 @@ export function indexedDBCollectionOptions<const TTable extends Table>(
 	// For non-eager sync modes, still discover indexes before marking ready
 	const wrappedBackend: SyncBackend<TTable> = {
 		...backend,
-		initialLoad: async (write) => {
+		initialLoad: async () => {
 			if (config.syncMode === "eager" || !config.syncMode) {
-				await backend.initialLoad(write);
-			} else {
-				// For non-eager sync modes, still discover indexes but don't load data
-				await discoverIndexesOnce();
+				return await backend.initialLoad();
 			}
+
+			// For non-eager sync modes, still discover indexes but don't load data
+			await discoverIndexesOnce();
+
+			return [];
 		},
 	};
 

package/src/context/DrizzleIndexedDBProvider.tsx

@@ -280,7 +280,7 @@ export function DrizzleIndexedDBProvider<
 										items: message.keys.map((key) => ({ id: key })),
 									});
 									break;
-								case "sync:clear":
+								case "sync:truncate":
 									pushExternalSync({
 										type: "truncate",
 									});

package/src/index.ts

@@ -76,7 +76,7 @@ export {
 	createMultiClientTransport,
 	// Client
 	IDBProxyClient,
-	createProxyDbCreator,
+	createProxyIDbCreator,
 	type SyncHandler,
 	// Server
 	IDBProxyServer,

package/src/proxy/idb-proxy-client.ts

@@ -1,7 +1,6 @@
 import type {
 	IDBDatabaseLike,
 	IDBCreator,
-	IDBOpenOptions,
 	IndexInfo,
 	CreateStoreOptions,
 	CreateIndexOptions,
@@ -294,13 +293,13 @@ export class IDBProxyClient implements IDBDatabaseLike {
  * @param onSync Optional handler called when any sync message is received
  *
  * @example
- * const dbCreator = createProxyDbCreator(transport, (msg) => {
+ * const dbCreator = createProxyIDbCreator(transport, (msg) => {
  *   console.log('Sync:', msg.type, msg.storeName);
  * });
  *
  * <DrizzleIndexedDBProvider dbCreator={dbCreator} ... />
  */
-export function createProxyDbCreator(
+export function createProxyIDbCreator(
 	transport: IDBProxyClientTransport,
 	onSync?: SyncHandler,
 ): IDBCreator {
@@ -308,10 +307,7 @@ export function createProxyDbCreator(
 	const clientCache = new Map<string, IDBProxyClient>();
 	const connectingCache = new Map<string, Promise<IDBProxyClient>>();
 
-	return async (
-		name: string,
-		_options?: IDBOpenOptions,
-	): Promise<IDBDatabaseLike> => {
+	return async (name: string): Promise<IDBDatabaseLike> => {
 		// Return cached client if already connected
 		const cached = clientCache.get(name);
 		if (cached) {

package/src/proxy/idb-proxy-server.ts

@@ -224,7 +224,7 @@ export class IDBProxyServer {
 				// Broadcast to other clients
 				this.options.transport.broadcast(
 					{
-						type: "sync:clear",
+						type: "sync:truncate",
 						dbName: request.dbName,
 						storeName: request.storeName,
 					},

package/src/proxy/idb-proxy-types.ts

@@ -59,7 +59,7 @@ export type IDBProxySyncMessage = {
 	| { type: "sync:add"; items: unknown[] }
 	| { type: "sync:put"; items: unknown[] }
 	| { type: "sync:delete"; keys: IDBValidKey[] }
-	| { type: "sync:clear" }
+	| { type: "sync:truncate" }
 );
 
 /**

package/src/proxy/idb-sync-adapter.ts

@@ -65,7 +65,7 @@ export function createCollectionSyncHandler<T = unknown>(
 				});
 				break;
 
-			case "sync:clear":
+			case "sync:truncate":
 				pushExternalSync({
 					type: "truncate",
 				});

package/src/proxy/index.ts

@@ -19,7 +19,7 @@ export {
 // Proxy client
 export {
 	IDBProxyClient,
-	createProxyDbCreator,
+	createProxyIDbCreator,
 	type SyncHandler,
 } from "./idb-proxy-client";