@firtoz/drizzle-indexeddb 0.6.1 → 1.0.0

package/CHANGELOG.md

@@ -1,5 +1,32 @@
 # @firtoz/drizzle-indexeddb
 
+## 1.0.0
+
+### Major Changes
+
+- [`3c7ce1d`](https://github.com/firtoz/fullstack-toolkit/commit/3c7ce1dbca5c5396386db9927ae7f5e19a562cf6) Thanks [@firtoz](https://github.com/firtoz)! - **IndexedDB proxy removed**
+
+  The IDB proxy layer (proxy client/server, transport, sync adapter) has been removed. Provider no longer exposes proxy sync; use native IndexedDB only.
+
+  **Upgrade:** If you were using the IDB proxy (e.g. `idb-proxy-client`, `idb-proxy-server`, `handleProxySync`, `onSyncReady`): remove that code. There is no replacement API; you implement the transport and call `receiveSync` with `SyncMessage[]` from `@firtoz/drizzle-utils` on each side.
+
+  **Remote / multi-context setup:** Use a **memory collection** (`@firtoz/db-helpers`) in the context that cannot access IndexedDB and keep the **IDB collection** where IndexedDB is available (source of truth). Implement your own channel (e.g. BroadcastChannel, `postMessage`, or WebSocket): when a context receives sync messages, call `utils.receiveSync(messages)` on its collection. Use `SyncMessage` from `@firtoz/db-helpers` (or `@firtoz/drizzle-utils`). The side that holds IDB can push initial state and updates as `SyncMessage[]` so the other side’s memory collection stays in sync.
+
+### Patch Changes
+
+- Updated dependencies [[`3c7ce1d`](https://github.com/firtoz/fullstack-toolkit/commit/3c7ce1dbca5c5396386db9927ae7f5e19a562cf6), [`3c7ce1d`](https://github.com/firtoz/fullstack-toolkit/commit/3c7ce1dbca5c5396386db9927ae7f5e19a562cf6)]:
+  - @firtoz/db-helpers@1.0.0
+  - @firtoz/drizzle-utils@1.0.0
+
+## 0.6.2
+
+### Patch Changes
+
+- [`ec365af`](https://github.com/firtoz/fullstack-toolkit/commit/ec365af8c17bcd7efc2b0cf9b3bed5225b853e72) Thanks [@firtoz](https://github.com/firtoz)! - Update dependencies
+
+- Updated dependencies [[`ec365af`](https://github.com/firtoz/fullstack-toolkit/commit/ec365af8c17bcd7efc2b0cf9b3bed5225b853e72)]:
+  - @firtoz/drizzle-utils@0.3.3
+
 ## 0.6.1
 
 ### Patch Changes

package/package.json

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

package/src/collections/indexeddb-collection.ts

@@ -65,100 +65,103 @@ export function evaluateExpression(
 	expression: IR.BasicExpression,
 	item: Record<string, unknown>,
 ): boolean {
-	if (expression.type === "ref") {
-		const propRef = expression as IR.PropRef;
-		const columnName = propRef.path[propRef.path.length - 1];
-		return item[columnName as string] !== undefined;
-	}
-
-	if (expression.type === "val") {
-		const value = expression as IR.Value;
-		return !!value.value;
-	}
-
-	if (expression.type === "func") {
-		const func = expression as IR.Func;
-
-		switch (func.name) {
-			case "eq": {
-				const left = getExpressionValue(func.args[0], item);
-				const right = getExpressionValue(func.args[1], item);
-				return left === right;
-			}
-			case "ne": {
-				const left = getExpressionValue(func.args[0], item);
-				const right = getExpressionValue(func.args[1], item);
-				return left !== right;
-			}
-			case "gt": {
-				const left = getExpressionValue(func.args[0], item);
-				const right = getExpressionValue(func.args[1], item);
-				return left > right;
-			}
-			case "gte": {
-				const left = getExpressionValue(func.args[0], item);
-				const right = getExpressionValue(func.args[1], item);
-				return left >= right;
-			}
-			case "lt": {
-				const left = getExpressionValue(func.args[0], item);
-				const right = getExpressionValue(func.args[1], item);
-				return left < right;
-			}
-			case "lte": {
-				const left = getExpressionValue(func.args[0], item);
-				const right = getExpressionValue(func.args[1], item);
-				return left <= right;
-			}
-			case "and": {
-				return func.args.every((arg) => evaluateExpression(arg, item));
-			}
-			case "or": {
-				return func.args.some((arg) => evaluateExpression(arg, item));
-			}
-			case "not": {
-				return !evaluateExpression(func.args[0], item);
-			}
-			case "isNull": {
-				const value = getExpressionValue(func.args[0], item);
-				return value === null || value === undefined;
-			}
-			case "isNotNull": {
-				const value = getExpressionValue(func.args[0], item);
-				return value !== null && value !== undefined;
-			}
-			case "like": {
-				const left = String(getExpressionValue(func.args[0], item));
-				const right = String(getExpressionValue(func.args[1], item));
-				// Convert SQL LIKE pattern to regex (case-sensitive)
-				const pattern = right.replace(/%/g, ".*").replace(/_/g, ".");
-				return new RegExp(`^${pattern}$`).test(left);
-			}
-			case "ilike": {
-				const left = String(getExpressionValue(func.args[0], item));
-				const right = String(getExpressionValue(func.args[1], item));
-				// Convert SQL ILIKE pattern to regex (case-insensitive)
-				const pattern = right.replace(/%/g, ".*").replace(/_/g, ".");
-				return new RegExp(`^${pattern}$`, "i").test(left);
-			}
-			case "in": {
-				const left = getExpressionValue(func.args[0], item);
-				const right = getExpressionValue(func.args[1], item);
-				// Check if left value is in the right array
-				return Array.isArray(right) && right.includes(left);
-			}
-			case "isUndefined": {
-				const value = getExpressionValue(func.args[0], item);
-				return value === null || value === undefined;
+	switch (expression.type) {
+		case "ref": {
+			const propRef = expression;
+			const columnName = propRef.path[propRef.path.length - 1];
+			return item[columnName as string] !== undefined;
+		}
+		case "val": {
+			const value = expression;
+			return !!value.value;
+		}
+		case "func": {
+			const func = expression;
+
+			switch (func.name) {
+				case "eq": {
+					const left = getExpressionValue(func.args[0], item);
+					const right = getExpressionValue(func.args[1], item);
+					return left === right;
+				}
+				case "ne": {
+					const left = getExpressionValue(func.args[0], item);
+					const right = getExpressionValue(func.args[1], item);
+					return left !== right;
+				}
+				case "gt": {
+					const left = getExpressionValue(func.args[0], item);
+					const right = getExpressionValue(func.args[1], item);
+					return left > right;
+				}
+				case "gte": {
+					const left = getExpressionValue(func.args[0], item);
+					const right = getExpressionValue(func.args[1], item);
+					return left >= right;
+				}
+				case "lt": {
+					const left = getExpressionValue(func.args[0], item);
+					const right = getExpressionValue(func.args[1], item);
+					return left < right;
+				}
+				case "lte": {
+					const left = getExpressionValue(func.args[0], item);
+					const right = getExpressionValue(func.args[1], item);
+					return left <= right;
+				}
+				case "and": {
+					return func.args.every((arg) => evaluateExpression(arg, item));
+				}
+				case "or": {
+					return func.args.some((arg) => evaluateExpression(arg, item));
+				}
+				case "not": {
+					return !evaluateExpression(func.args[0], item);
+				}
+				case "isNull": {
+					const value = getExpressionValue(func.args[0], item);
+					return value === null || value === undefined;
+				}
+				case "isNotNull": {
+					const value = getExpressionValue(func.args[0], item);
+					return value !== null && value !== undefined;
+				}
+				case "like": {
+					const left = String(getExpressionValue(func.args[0], item));
+					const right = String(getExpressionValue(func.args[1], item));
+					// Convert SQL LIKE pattern to regex (case-sensitive)
+					const pattern = right.replace(/%/g, ".*").replace(/_/g, ".");
+					return new RegExp(`^${pattern}$`).test(left);
+				}
+				case "ilike": {
+					const left = String(getExpressionValue(func.args[0], item));
+					const right = String(getExpressionValue(func.args[1], item));
+					// Convert SQL ILIKE pattern to regex (case-insensitive)
+					const pattern = right.replace(/%/g, ".*").replace(/_/g, ".");
+					return new RegExp(`^${pattern}$`, "i").test(left);
+				}
+				case "in": {
+					const left = getExpressionValue(func.args[0], item);
+					const right = getExpressionValue(func.args[1], item);
+					// Check if left value is in the right array
+					return Array.isArray(right) && right.includes(left);
+				}
+				case "isUndefined": {
+					const value = getExpressionValue(func.args[0], item);
+					return value === null || value === undefined;
+				}
+				default:
+					throw new Error(`Unsupported function: ${func.name}`);
 			}
-			default:
-				throw new Error(`Unsupported function: ${func.name}`);
+		}
+		default: {
+			const _ex: never = expression;
+			void _ex;
+			throw new Error(
+				`Unsupported expression type: ${(expression as { type: string }).type}`,
+			);
 		}
 	}
-
-	throw new Error(
-		`Unsupported expression type: ${(expression as { type: string }).type}`,
-	);
 }
 
 /**
@@ -170,18 +173,26 @@ export function getExpressionValue(
 	item: Record<string, unknown>,
 	// biome-ignore lint/suspicious/noExplicitAny: We need any here for dynamic values
 ): any {
-	if (expression.type === "ref") {
-		const propRef = expression as IR.PropRef;
-		const columnName = propRef.path[propRef.path.length - 1];
-		return item[columnName as string];
-	}
-
-	if (expression.type === "val") {
-		const value = expression as IR.Value;
-		return value.value;
+	switch (expression.type) {
+		case "ref": {
+			const propRef = expression;
+			const columnName = propRef.path[propRef.path.length - 1];
+			return item[columnName as string];
+		}
+		case "val": {
+			const value = expression;
+			return value.value;
+		}
+		case "func":
+			throw new Error("Cannot get value from func expression");
+		default: {
+			const _ex: never = expression;
+			void _ex;
+			throw new Error(
+				`Cannot get value from expression type: ${(expression as { type: string }).type}`,
+			);
+		}
 	}
-
-	throw new Error(`Cannot get value from expression type: ${expression.type}`);
 }
 
 /**

package/src/context/DrizzleIndexedDBProvider.tsx

@@ -19,13 +19,13 @@ import {
 	indexedDBCollectionOptions,
 	type IndexedDBCollectionConfig,
 } from "@firtoz/drizzle-indexeddb";
+import type { CollectionUtils } from "@firtoz/db-helpers";
 import type {
 	IdOf,
 	InsertSchema,
 	SelectSchema,
 	GetTableFromSchema,
 	InferCollectionFromTable,
-	CollectionUtils,
 } from "@firtoz/drizzle-utils";
 import {
 	type Migration,
@@ -33,7 +33,6 @@ import {
 } from "../function-migrator";
 import type { IDBCreator, IDBDatabaseLike } from "../idb-types";
 import { openIndexedDb } from "../idb-operations";
-import type { IDBProxySyncMessage } from "../proxy/idb-proxy-types";
 
 interface CollectionCacheEntry {
 	// biome-ignore lint/suspicious/noExplicitAny: Cache needs to store collections of various types
@@ -65,11 +64,6 @@ export type DrizzleIndexedDBContextValue<
 	) => IndexedDbCollection<TSchema, TTableName>;
 	incrementRefCount: (tableName: string) => void;
 	decrementRefCount: (tableName: string) => void;
-	/**
-	 * Handle a sync message from a proxy server.
-	 * Routes the message to the appropriate collection's external sync handler.
-	 */
-	handleProxySync: (message: IDBProxySyncMessage) => void;
 };
 
 export const DrizzleIndexedDBContext =
@@ -94,18 +88,6 @@ type DrizzleIndexedDBProviderProps<TSchema extends Record<string, unknown>> =
 		 * Use createInstrumentedDbCreator() to track IndexedDB operations.
 		 */
 		dbCreator?: IDBCreator;
-		/**
-		 * Called when the sync handler is ready.
-		 * Use this to connect proxy sync messages to the provider.
-		 *
-		 * @example
-		 * const proxyClient = ...;
-		 * <DrizzleIndexedDBProvider
-		 *   onSyncReady={(handleSync) => proxyClient.onSync(handleSync)}
-		 *   ...
-		 * />
-		 */
-		onSyncReady?: (handleSync: (message: IDBProxySyncMessage) => void) => void;
 	}>;
 
 export function DrizzleIndexedDBProvider<
@@ -119,7 +101,6 @@ export function DrizzleIndexedDBProvider<
 	debug = false,
 	syncMode = "eager",
 	dbCreator,
-	onSyncReady,
 }: DrizzleIndexedDBProviderProps<TSchema>) {
 	const [indexedDB, setIndexedDB] = useState<IDBDatabaseLike | null>(null);
 	const indexedDBRef = useRef<IDBDatabaseLike | null>(null);
@@ -248,80 +229,14 @@ export function DrizzleIndexedDBProvider<
 			[collections],
 		);
 
-	// Handle proxy sync messages by routing to the appropriate collection
-	const handleProxySync: DrizzleIndexedDBContextValue<TSchema>["handleProxySync"] =
-		useCallback(
-			(message: IDBProxySyncMessage) => {
-				// Find the collection for this store by checking the schema
-				for (const [tableName, table] of Object.entries(schema)) {
-					const actualStoreName = getTableName(table as Table);
-					if (actualStoreName === message.storeName) {
-						const entry = collections.get(tableName);
-						if (entry) {
-							const { pushExternalSync } = entry.collection.utils;
-							// Route sync message to collection
-							switch (message.type) {
-								case "sync:add":
-									pushExternalSync({
-										type: "insert",
-										items: message.items,
-									});
-									break;
-								case "sync:put":
-									pushExternalSync({
-										type: "update",
-										items: message.items,
-									});
-									break;
-								case "sync:delete":
-									// For delete, construct items with id
-									pushExternalSync({
-										type: "delete",
-										items: message.keys.map((key) => ({ id: key })),
-									});
-									break;
-								case "sync:truncate":
-									pushExternalSync({
-										type: "truncate",
-									});
-									break;
-							}
-						}
-						return;
-					}
-				}
-
-				if (debug) {
-					console.warn(
-						`[DrizzleIndexedDBProvider] No collection found for store: ${message.storeName}`,
-					);
-				}
-			},
-			[collections, schema, debug],
-		);
-
-	// Call onSyncReady when handleProxySync is available
-	useEffect(() => {
-		if (onSyncReady) {
-			onSyncReady(handleProxySync);
-		}
-	}, [onSyncReady, handleProxySync]);
-
 	const contextValue: DrizzleIndexedDBContextValue<TSchema> = useMemo(
 		() => ({
 			indexedDB,
 			getCollection,
 			incrementRefCount,
 			decrementRefCount,
-			handleProxySync,
 		}),
-		[
-			indexedDB,
-			getCollection,
-			incrementRefCount,
-			decrementRefCount,
-			handleProxySync,
-		],
+		[indexedDB, getCollection, incrementRefCount, decrementRefCount],
 	);
 
 	return (

package/src/function-migrator.ts

@@ -1,5 +1,6 @@
 // IndexedDB migrator with declarative migration format
 
+import { exhaustiveGuard } from "@firtoz/maybe-error";
 import type { IDBCreator, IDBDatabaseLike } from "./idb-types";
 import { openIndexedDb } from "./idb-operations";
 
@@ -107,6 +108,8 @@ function executeMigrationOperation(
 			}
 			break;
 		}
+		default:
+			exhaustiveGuard(op);
 	}
 }
 

package/src/index.ts

@@ -59,30 +59,3 @@ export {
 	useDrizzleIndexedDB,
 	type UseDrizzleIndexedDBContextReturn,
 } from "./context/useDrizzleIndexedDB";
-
-// IDB Proxy (for Chrome extension, messaging-based IDB access)
-export {
-	// Types
-	type IDBProxyRequest,
-	type IDBProxyRequestBody,
-	type IDBProxyResponse,
-	type IDBProxySyncMessage,
-	generateRequestId,
-	generateClientId,
-	// Transport
-	type IDBProxyClientTransport,
-	type IDBProxyServerTransport,
-	createInMemoryTransport,
-	createMultiClientTransport,
-	// Client
-	IDBProxyClient,
-	createProxyIDbCreator,
-	type SyncHandler,
-	// Server
-	IDBProxyServer,
-	createProxyServer,
-	type IDBProxyServerOptions,
-	// Sync adapter (connects proxy sync to collection)
-	createCollectionSyncHandler,
-	combineSyncHandlers,
-} from "./proxy";

package/src/native-idb-database.ts

@@ -1,3 +1,4 @@
+import { exhaustiveGuard } from "@firtoz/maybe-error";
 import type {
 	IDBDatabaseLike,
 	IDBCreator,
@@ -26,6 +27,8 @@ function createKeyRange(spec: KeyRangeSpec): IDBKeyRange {
 				spec.lowerOpen,
 				spec.upperOpen,
 			);
+		default:
+			exhaustiveGuard(spec.type);
 	}
 }
 

package/src/standalone-collection.ts

@@ -8,12 +8,8 @@ import {
 	type WritableDeep,
 } from "@tanstack/db";
 import type { Table } from "drizzle-orm";
-import type {
-	IdOf,
-	InsertSchema,
-	SelectSchema,
-	CollectionUtils,
-} from "@firtoz/drizzle-utils";
+import type { CollectionUtils } from "@firtoz/db-helpers";
+import type { IdOf, InsertSchema, SelectSchema } from "@firtoz/drizzle-utils";
 import {
 	indexedDBCollectionOptions,
 	type IndexedDBCollectionConfig,
@@ -151,7 +147,7 @@ export interface StandaloneCollection<TTable extends Table> {
 	truncate(): Promise<void>;
 
 	/**
-	 * Access to collection utils (truncate, pushExternalSync)
+	 * Access to collection utils (truncate, receiveSync)
 	 */
 	utils: CollectionUtils<ItemType<TTable>>;