@firtoz/drizzle-indexeddb 0.5.1 → 0.6.0

package/CHANGELOG.md

@@ -1,5 +1,15 @@
 # @firtoz/drizzle-indexeddb
 
+## 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 +71,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.0",
 	"description": "IndexedDB migrations powered by Drizzle ORM",
 	"main": "./src/index.ts",
 	"module": "./src/index.ts",
@@ -69,7 +69,7 @@
 	},
 	"peerDependencies": {
 		"@firtoz/drizzle-utils": ">=0.3.1",
-		"@tanstack/db": ">=0.5.15",
+		"@tanstack/db": ">=0.5.16",
 		"drizzle-orm": ">=0.45.1",
 		"drizzle-valibot": ">=0.4.0",
 		"react": ">=19.2.3",
@@ -77,7 +77,7 @@
 	},
 	"devDependencies": {
 		"@firtoz/drizzle-utils": "^0.3.1",
-		"@tanstack/db": "^0.5.15",
+		"@tanstack/db": "^0.5.16",
 		"@types/react": "^19.2.7",
 		"drizzle-orm": "^0.45.1",
 		"drizzle-valibot": "^0.4.2",

package/src/collections/indexeddb-collection.ts

@@ -467,32 +467,16 @@ export function indexedDBCollectionOptions<const TTable extends Table>(
 			}
 		},
 
-		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);
 
-				// 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;
-			}
-
-			return results;
+			return itemsToInsert;
 		},
 
 		handleUpdate: async (mutations) => {

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";