@firtoz/drizzle-sqlite-wasm 1.0.4 → 1.1.1

package/dist/chunk-WFFFP6DB.js

@@ -0,0 +1,124 @@
+import { customSqliteMigrate } from './chunk-NSPVPJKE.js';
+import { isSqliteWorkerInitialized, initializeSqliteWorker } from './chunk-FIVEPVOM.js';
+import { createInstrumentedDrizzle, drizzleSqliteWasmWorker } from './chunk-FRONXNEA.js';
+import { useRef, useState, useMemo, useEffect } from 'react';
+
+var useDrizzleSqliteDb = (WorkerConstructor, dbName, schema, migrations, debug, interceptor, workerOpenOptions) => {
+  const resolveRef = useRef(null);
+  const rejectRef = useRef(null);
+  const [sqliteClient, setSqliteClient] = useState(
+    null
+  );
+  const sqliteClientRef = useRef(null);
+  const readyPromise = useMemo(() => {
+    return new Promise((resolve, reject) => {
+      resolveRef.current = resolve;
+      rejectRef.current = reject;
+    });
+  }, []);
+  useEffect(() => {
+    if (typeof window === "undefined") {
+      setSqliteClient({
+        performRemoteCallback: () => {
+        },
+        checkpoint: () => Promise.resolve(),
+        onStarted: () => {
+        },
+        terminate: () => {
+        }
+      });
+      return;
+    }
+    let mounted = true;
+    const init = async () => {
+      if (!isSqliteWorkerInitialized()) {
+        await initializeSqliteWorker(WorkerConstructor);
+      }
+      const { getSqliteWorkerManager } = await import('./worker/global-manager.js');
+      const manager = getSqliteWorkerManager();
+      const instance = await manager.getDbInstance(dbName, workerOpenOptions);
+      if (mounted) {
+        sqliteClientRef.current = instance;
+        setSqliteClient(instance);
+      }
+    };
+    init();
+    return () => {
+      mounted = false;
+    };
+  }, [dbName, WorkerConstructor, workerOpenOptions]);
+  const interceptorRef = useRef(interceptor);
+  interceptorRef.current = interceptor;
+  const drizzle = useMemo(() => {
+    if (debug) {
+      console.log(`[DEBUG] ${dbName} - creating drizzle proxy wrapper`);
+    }
+    const client = {
+      performRemoteCallback: (data, resolve, reject) => {
+        const actualClient = sqliteClientRef.current;
+        if (!actualClient) {
+          console.error(
+            `[DEBUG] ${dbName} - performRemoteCallback called but no sqliteClient yet`
+          );
+          reject(
+            new Error(`Database ${dbName} not ready yet - still initializing`)
+          );
+          return;
+        }
+        actualClient.performRemoteCallback(data, resolve, reject);
+      },
+      onStarted: (callback) => {
+        const actualClient = sqliteClientRef.current;
+        if (!actualClient) {
+          console.warn(
+            `[DEBUG] ${dbName} - onStarted called but no sqliteClient yet`
+          );
+          return;
+        }
+        actualClient.onStarted(callback);
+      },
+      terminate: () => {
+        sqliteClientRef.current?.terminate();
+      },
+      checkpoint: () => {
+        return sqliteClientRef.current?.checkpoint() ?? Promise.resolve();
+      }
+    };
+    const interceptorWrapper = {
+      onOperation: (op) => interceptorRef.current?.onOperation?.(op)
+    };
+    if (interceptor) {
+      return createInstrumentedDrizzle(
+        client,
+        { schema },
+        interceptorWrapper
+      );
+    }
+    return drizzleSqliteWasmWorker(client, { schema });
+  }, [schema, dbName, !!interceptor]);
+  useEffect(() => {
+    if (!sqliteClient) {
+      if (debug) {
+        console.log(`[DEBUG] ${dbName} - waiting for sqliteClient...`);
+      }
+      return;
+    }
+    sqliteClient.onStarted(async () => {
+      try {
+        await customSqliteMigrate(drizzle, migrations);
+        resolveRef.current?.();
+      } catch (error) {
+        console.error(`Migration error for ${dbName}:`, error);
+        rejectRef.current?.(error);
+      }
+    });
+    return () => {
+      sqliteClient.terminate();
+    };
+  }, [sqliteClient, drizzle, migrations, dbName]);
+  return { drizzle, readyPromise, sqliteClient };
+};
+
+export { useDrizzleSqliteDb };
+//# sourceMappingURL=chunk-WFFFP6DB.js.map
+//# sourceMappingURL=chunk-WFFFP6DB.js.map

package/dist/chunk-WFFFP6DB.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/hooks/useDrizzleSqliteDb.ts"],"names":[],"mappings":"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","file":"chunk-WFFFP6DB.js","sourcesContent":["import { useEffect, useMemo, useRef, useState } from \"react\";\nimport {\n\tcustomSqliteMigrate,\n\ttype DurableSqliteMigrationConfig,\n} from \"../migration/migrator\";\nimport {\n\tdrizzleSqliteWasmWorker,\n\tcreateInstrumentedDrizzle,\n} from \"../drizzle/worker\";\nimport type { ISqliteWorkerClient } from \"../worker/manager\";\nimport {\n\tinitializeSqliteWorker,\n\tisSqliteWorkerInitialized,\n} from \"../worker/global-manager\";\nimport type { SQLInterceptor } from \"../collections/sqlite-collection\";\nimport type { SqliteWasmWorkerOpenOptions } from \"../worker/sqlite-open-options\";\n\nexport const useDrizzleSqliteDb = <TSchema extends Record<string, unknown>>(\n\tWorkerConstructor: new () => Worker,\n\tdbName: string,\n\tschema: TSchema,\n\tmigrations: DurableSqliteMigrationConfig,\n\tdebug?: boolean,\n\t/** Optional interceptor to log ALL SQL queries (including direct Drizzle queries) */\n\tinterceptor?: SQLInterceptor,\n\t/**\n\t * Pragmas applied when the worker first opens this `dbName` in the session.\n\t * Ignored if that database was already started (same global worker + dbName).\n\t */\n\tworkerOpenOptions?: SqliteWasmWorkerOpenOptions,\n) => {\n\tconst resolveRef = useRef<null | (() => void)>(null);\n\tconst rejectRef = useRef<null | ((error: unknown) => void)>(null);\n\tconst [sqliteClient, setSqliteClient] = useState<ISqliteWorkerClient | null>(\n\t\tnull,\n\t);\n\tconst sqliteClientRef = useRef<ISqliteWorkerClient | null>(null);\n\n\tconst readyPromise = useMemo(() => {\n\t\treturn new Promise<void>((resolve, reject) => {\n\t\t\tresolveRef.current = resolve;\n\t\t\trejectRef.current = reject;\n\t\t});\n\t}, []);\n\n\t// Initialize the global manager and get db instance\n\tuseEffect(() => {\n\t\tif (typeof window === \"undefined\") {\n\t\t\t// SSR stub\n\t\t\tsetSqliteClient({\n\t\t\t\tperformRemoteCallback: () => {},\n\t\t\t\tcheckpoint: () => Promise.resolve(),\n\t\t\t\tonStarted: () => {},\n\t\t\t\tterminate: () => {},\n\t\t\t});\n\t\t\treturn;\n\t\t}\n\n\t\tlet mounted = true;\n\n\t\tconst init = async () => {\n\t\t\t// Initialize manager if not already initialized\n\t\t\tif (!isSqliteWorkerInitialized()) {\n\t\t\t\tawait initializeSqliteWorker(WorkerConstructor);\n\t\t\t}\n\n\t\t\t// Get manager and create db instance\n\t\t\tconst { getSqliteWorkerManager } = await import(\n\t\t\t\t\"../worker/global-manager\"\n\t\t\t);\n\t\t\tconst manager = getSqliteWorkerManager();\n\t\t\tconst instance = await manager.getDbInstance(dbName, workerOpenOptions);\n\n\t\t\tif (mounted) {\n\t\t\t\tsqliteClientRef.current = instance;\n\t\t\t\tsetSqliteClient(instance);\n\t\t\t}\n\t\t};\n\n\t\tinit();\n\n\t\treturn () => {\n\t\t\tmounted = false;\n\t\t};\n\t}, [dbName, WorkerConstructor, workerOpenOptions]);\n\n\t// Store interceptor in a ref to avoid recreating drizzle on interceptor changes\n\tconst interceptorRef = useRef(interceptor);\n\tinterceptorRef.current = interceptor;\n\n\t// Create drizzle instance with a callback-based approach that waits for the client\n\t// Use instrumented version if interceptor is provided to log ALL queries\n\tconst drizzle = useMemo(() => {\n\t\tif (debug) {\n\t\t\tconsole.log(`[DEBUG] ${dbName} - creating drizzle proxy wrapper`);\n\t\t}\n\n\t\tconst client: ISqliteWorkerClient = {\n\t\t\tperformRemoteCallback: (data, resolve, reject) => {\n\t\t\t\tconst actualClient = sqliteClientRef.current;\n\t\t\t\tif (!actualClient) {\n\t\t\t\t\tconsole.error(\n\t\t\t\t\t\t`[DEBUG] ${dbName} - performRemoteCallback called but no sqliteClient yet`,\n\t\t\t\t\t);\n\t\t\t\t\treject(\n\t\t\t\t\t\tnew Error(`Database ${dbName} not ready yet - still initializing`),\n\t\t\t\t\t);\n\t\t\t\t\treturn;\n\t\t\t\t}\n\t\t\t\tactualClient.performRemoteCallback(data, resolve, reject);\n\t\t\t},\n\t\t\tonStarted: (callback) => {\n\t\t\t\tconst actualClient = sqliteClientRef.current;\n\t\t\t\tif (!actualClient) {\n\t\t\t\t\tconsole.warn(\n\t\t\t\t\t\t`[DEBUG] ${dbName} - onStarted called but no sqliteClient yet`,\n\t\t\t\t\t);\n\t\t\t\t\treturn;\n\t\t\t\t}\n\t\t\t\tactualClient.onStarted(callback);\n\t\t\t},\n\t\t\tterminate: () => {\n\t\t\t\tsqliteClientRef.current?.terminate();\n\t\t\t},\n\t\t\tcheckpoint: () => {\n\t\t\t\treturn sqliteClientRef.current?.checkpoint() ?? Promise.resolve();\n\t\t\t},\n\t\t};\n\n\t\t// Use instrumented version if interceptor is provided\n\t\t// Use a wrapper that accesses the ref so interceptor changes don't recreate drizzle\n\t\tconst interceptorWrapper: SQLInterceptor = {\n\t\t\tonOperation: (op) => interceptorRef.current?.onOperation?.(op),\n\t\t};\n\n\t\t// Always use instrumented if initial interceptor was provided\n\t\tif (interceptor) {\n\t\t\treturn createInstrumentedDrizzle<TSchema>(\n\t\t\t\tclient,\n\t\t\t\t{ schema },\n\t\t\t\tinterceptorWrapper,\n\t\t\t);\n\t\t}\n\n\t\treturn drizzleSqliteWasmWorker<TSchema>(client, { schema });\n\t}, [schema, dbName, !!interceptor]); // Only recreate if interceptor presence changes, not on every render\n\n\tuseEffect(() => {\n\t\tif (!sqliteClient) {\n\t\t\tif (debug) {\n\t\t\t\tconsole.log(`[DEBUG] ${dbName} - waiting for sqliteClient...`);\n\t\t\t}\n\t\t\treturn;\n\t\t}\n\n\t\tsqliteClient.onStarted(async () => {\n\t\t\ttry {\n\t\t\t\tawait customSqliteMigrate(drizzle, migrations);\n\t\t\t\tresolveRef.current?.();\n\t\t\t} catch (error) {\n\t\t\t\tconsole.error(`Migration error for ${dbName}:`, error);\n\t\t\t\trejectRef.current?.(error);\n\t\t\t}\n\t\t});\n\n\t\treturn () => {\n\t\t\tsqliteClient.terminate();\n\t\t};\n\t}, [sqliteClient, drizzle, migrations, dbName]);\n\n\treturn { drizzle, readyPromise, sqliteClient };\n};\n"]}

package/dist/collections/sqlite-collection.d.ts

@@ -0,0 +1,40 @@
+import { SyncMode, CollectionConfig, InferSchemaOutput } from '@tanstack/db';
+import { Table } from 'drizzle-orm';
+import { BaseSQLiteDatabase } from 'drizzle-orm/sqlite-core';
+import { CollectionUtils } from '@firtoz/db-helpers';
+import { TableWithRequiredFields, SQLInterceptor, SelectSchema, IdOf, InsertToSelectSchema } from '@firtoz/drizzle-utils';
+export { SQLInterceptor, SQLOperation } from '@firtoz/drizzle-utils';
+
+type AnyDrizzleDatabase = BaseSQLiteDatabase<"async", any, Record<string, unknown>>;
+type DrizzleSchema<TDrizzle extends AnyDrizzleDatabase> = TDrizzle["_"]["fullSchema"];
+interface DrizzleSqliteCollectionConfig<TDrizzle extends AnyDrizzleDatabase, TTableName extends ValidTableNames<DrizzleSchema<TDrizzle>>> {
+    drizzle: TDrizzle;
+    tableName: ValidTableNames<DrizzleSchema<TDrizzle>> extends never ? {
+        $error: "The schema needs to include at least one table that uses the syncableTable function.";
+    } : TTableName;
+    readyPromise: Promise<void>;
+    syncMode?: SyncMode;
+    /**
+     * Enable debug logging for query execution and mutations
+     */
+    debug?: boolean;
+    /**
+     * Optional callback to checkpoint the database after mutations
+     * This ensures WAL is flushed to the main database file for OPFS persistence
+     */
+    checkpoint?: () => Promise<void>;
+    /**
+     * Optional interceptor for tracking SQLite operations (for testing/debugging)
+     */
+    interceptor?: SQLInterceptor;
+}
+type ValidTableNames<TSchema extends Record<string, unknown>> = {
+    [K in keyof TSchema]: TSchema[K] extends TableWithRequiredFields ? K : never;
+}[keyof TSchema];
+type SqliteCollectionConfig<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>>>;
+};
+declare function sqliteCollectionOptions<const TDrizzle extends AnyDrizzleDatabase, const TTableName extends string & ValidTableNames<DrizzleSchema<TDrizzle>>, TTable extends DrizzleSchema<TDrizzle>[TTableName] & TableWithRequiredFields>(config: DrizzleSqliteCollectionConfig<TDrizzle, TTableName>): SqliteCollectionConfig<TTable>;
+
+export { type AnyDrizzleDatabase, type DrizzleSchema, type DrizzleSqliteCollectionConfig, type SqliteCollectionConfig, type ValidTableNames, sqliteCollectionOptions };

package/dist/collections/sqlite-collection.js

@@ -0,0 +1,3 @@
+export { sqliteCollectionOptions } from '../chunk-BZVMUTJ7.js';
+//# sourceMappingURL=sqlite-collection.js.map
+//# sourceMappingURL=sqlite-collection.js.map

package/dist/collections/sqlite-collection.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"sqlite-collection.js"}

package/dist/collections/synced-sqlite-collection.d.ts

@@ -0,0 +1,19 @@
+import { WithSyncOptions, SyncClientBridge, SyncableCollectionItem, SyncClientMessage } from '@firtoz/collection-sync';
+import { Collection } from '@tanstack/db';
+import { TableWithRequiredFields } from '@firtoz/drizzle-utils';
+import { InferSelectModel } from 'drizzle-orm';
+import { AnyDrizzleDatabase, ValidTableNames, DrizzleSchema, DrizzleSqliteCollectionConfig } from './sqlite-collection.js';
+import 'drizzle-orm/sqlite-core';
+import '@firtoz/db-helpers';
+
+/**
+ * Like {@link createSyncedCollection} from `@firtoz/collection-sync`, but row type uses Drizzle’s
+ * {@link InferSelectModel} so branded columns (e.g. ids) match `$inferSelect`, not Valibot schema output.
+ */
+declare function createSyncedSqliteCollection<const TDrizzle extends AnyDrizzleDatabase, const TTableName extends string & ValidTableNames<DrizzleSchema<TDrizzle>>, TTable extends DrizzleSchema<TDrizzle>[TTableName] & TableWithRequiredFields>(config: DrizzleSqliteCollectionConfig<TDrizzle, TTableName>, syncOptions?: WithSyncOptions): {
+    collection: Collection<InferSelectModel<TTable>>;
+    bridge: SyncClientBridge<InferSelectModel<TTable> & SyncableCollectionItem>;
+    setTransportSend: (send: (msg: SyncClientMessage) => void) => void;
+};
+
+export { createSyncedSqliteCollection };

package/dist/collections/synced-sqlite-collection.js

@@ -0,0 +1,4 @@
+export { createSyncedSqliteCollection } from '../chunk-7JJHY44Q.js';
+import '../chunk-BZVMUTJ7.js';
+//# sourceMappingURL=synced-sqlite-collection.js.map
+//# sourceMappingURL=synced-sqlite-collection.js.map

package/dist/collections/synced-sqlite-collection.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"synced-sqlite-collection.js"}

package/dist/collections/websocket-collection.d.ts

@@ -0,0 +1,18 @@
+import { BaseCollectionConfig, InferSchemaOutput, CollectionConfig, UtilsRecord } from '@tanstack/db';
+import { StandardSchemaV1 } from '@standard-schema/spec';
+
+interface WebSocketCollectionConfig<TSchema extends StandardSchemaV1> extends Omit<BaseCollectionConfig<InferSchemaOutput<TSchema>, string | number, TSchema>, "onInsert" | "onUpdate" | "onDelete" | "sync" | "schema"> {
+    url: string;
+    reconnectInterval?: number;
+    schema: TSchema;
+}
+interface WebSocketUtils extends UtilsRecord {
+    reconnect: () => void;
+    getConnectionState: () => "connected" | "disconnected" | "connecting";
+}
+declare function webSocketCollectionOptions<TSchema extends StandardSchemaV1>(config: WebSocketCollectionConfig<TSchema>): CollectionConfig<InferSchemaOutput<TSchema>, string | number, TSchema> & {
+    utils: WebSocketUtils;
+    schema: TSchema;
+};
+
+export { webSocketCollectionOptions };

package/dist/collections/websocket-collection.js

@@ -0,0 +1,185 @@
+import { exhaustiveGuard } from '@firtoz/maybe-error';
+
+// src/collections/websocket-collection.ts
+function webSocketCollectionOptions(config) {
+  let ws = null;
+  let reconnectTimer = null;
+  let connectionState = "disconnected";
+  const pendingTransactions = /* @__PURE__ */ new Map();
+  const handlers = {};
+  const connect = () => {
+    connectionState = "connecting";
+    ws = new WebSocket(config.url);
+    ws.onopen = () => {
+      handlers.onOpen?.();
+    };
+    ws.onmessage = (event) => {
+      handlers.onMessage?.(event);
+    };
+    ws.onerror = (error) => {
+      handlers.onError?.(error);
+    };
+    ws.onclose = () => {
+      handlers.onClose?.();
+    };
+  };
+  const sync = (params) => {
+    const { begin, write, commit, markReady } = params;
+    handlers.onOpen = () => {
+      if (!ws) return;
+      connectionState = "connected";
+      ws.send(JSON.stringify({ type: "sync" }));
+    };
+    handlers.onMessage = (event) => {
+      if (!ws) return;
+      const message = JSON.parse(event.data);
+      switch (message.type) {
+        case "sync":
+          begin();
+          if (Array.isArray(message.data)) {
+            for (const item of message.data) {
+              write({ type: "insert", value: item });
+            }
+          }
+          commit();
+          markReady();
+          break;
+        case "insert":
+        case "update":
+        case "delete":
+          begin();
+          write({
+            type: message.type,
+            value: message.data
+          });
+          commit();
+          break;
+        case "ack":
+          if (message.transactionId) {
+            const pending = pendingTransactions.get(message.transactionId);
+            if (pending) {
+              clearTimeout(pending.timeout);
+              pendingTransactions.delete(message.transactionId);
+              pending.resolve();
+            }
+          }
+          break;
+        case "transaction":
+          if (message.mutations) {
+            begin();
+            for (const mutation of message.mutations) {
+              write({
+                type: mutation.type,
+                value: mutation.data
+              });
+            }
+            commit();
+          }
+          break;
+        default:
+          exhaustiveGuard(message.type);
+      }
+    };
+    handlers.onError = (error) => {
+      console.error("WebSocket error:", error);
+      connectionState = "disconnected";
+    };
+    handlers.onClose = () => {
+      connectionState = "disconnected";
+      if (!reconnectTimer) {
+        reconnectTimer = setTimeout(() => {
+          reconnectTimer = null;
+          connect();
+        }, config.reconnectInterval || 5e3);
+      }
+    };
+    connect();
+    return () => {
+      if (reconnectTimer) {
+        clearTimeout(reconnectTimer);
+        reconnectTimer = null;
+      }
+      if (ws) {
+        ws.close();
+        ws = null;
+      }
+    };
+  };
+  const sendTransaction = async (params) => {
+    if (ws?.readyState !== WebSocket.OPEN) {
+      throw new Error("WebSocket not connected");
+    }
+    const transactionId = crypto.randomUUID();
+    const mutations = params.transaction.mutations.map((mutation) => {
+      switch (mutation.type) {
+        case "insert":
+          return {
+            type: mutation.type,
+            id: mutation.key,
+            data: mutation.modified
+          };
+        case "update":
+          return {
+            type: mutation.type,
+            id: mutation.key,
+            data: mutation.changes
+          };
+        case "delete":
+          return {
+            type: mutation.type,
+            id: mutation.key,
+            data: void 0
+          };
+        default:
+          return exhaustiveGuard(mutation);
+      }
+    });
+    ws.send(
+      JSON.stringify({
+        type: "transaction",
+        transactionId,
+        mutations
+      })
+    );
+    return new Promise((resolve, reject) => {
+      const timeout = setTimeout(() => {
+        pendingTransactions.delete(transactionId);
+        reject(new Error(`Transaction ${transactionId} timed out`));
+      }, 1e4);
+      pendingTransactions.set(transactionId, {
+        resolve,
+        reject,
+        timeout
+      });
+    });
+  };
+  const onInsert = async (params) => {
+    await sendTransaction(params);
+  };
+  const onUpdate = async (params) => {
+    await sendTransaction(params);
+  };
+  const onDelete = async (params) => {
+    await sendTransaction(params);
+  };
+  return {
+    id: config.id,
+    schema: config.schema,
+    getKey: config.getKey,
+    sync: { sync },
+    onInsert,
+    onUpdate,
+    onDelete,
+    utils: {
+      reconnect: () => {
+        if (ws) ws.close();
+        connect();
+      },
+      getConnectionState: () => connectionState
+    }
+  };
+}
+
+export { webSocketCollectionOptions };
+//# sourceMappingURL=websocket-collection.js.map
+//# sourceMappingURL=websocket-collection.js.map

package/dist/collections/websocket-collection.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/collections/websocket-collection.ts"],"names":[],"mappings":"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","file":"websocket-collection.js","sourcesContent":["import type {\n\tCollectionConfig,\n\tSyncConfig,\n\tInsertMutationFnParams,\n\tUpdateMutationFnParams,\n\tDeleteMutationFnParams,\n\tUtilsRecord,\n\tBaseCollectionConfig,\n\tInferSchemaOutput,\n\tInferSchemaInput,\n} from \"@tanstack/db\";\nimport { exhaustiveGuard } from \"@firtoz/maybe-error\";\nimport type { StandardSchemaV1 } from \"@standard-schema/spec\";\n\ninterface WebSocketMessage<T> {\n\ttype: \"insert\" | \"update\" | \"delete\" | \"sync\" | \"transaction\" | \"ack\";\n\tdata?: T | T[];\n\tmutations?: Array<{\n\t\ttype: \"insert\" | \"update\" | \"delete\";\n\t\tdata: T;\n\t\tid?: string;\n\t}>;\n\ttransactionId?: string;\n\tid?: string;\n}\n\ninterface WebSocketCollectionConfig<TSchema extends StandardSchemaV1>\n\textends Omit<\n\t\tBaseCollectionConfig<InferSchemaOutput<TSchema>, string | number, TSchema>,\n\t\t\"onInsert\" | \"onUpdate\" | \"onDelete\" | \"sync\" | \"schema\"\n\t> {\n\turl: string;\n\treconnectInterval?: number;\n\tschema: TSchema;\n\n\t// Note: onInsert/onUpdate/onDelete are handled by the WebSocket connection\n\t// Users don't provide these handlers\n}\n\ninterface WebSocketUtils extends UtilsRecord {\n\treconnect: () => void;\n\tgetConnectionState: () => \"connected\" | \"disconnected\" | \"connecting\";\n}\n\nexport function webSocketCollectionOptions<TSchema extends StandardSchemaV1>(\n\tconfig: WebSocketCollectionConfig<TSchema>,\n): CollectionConfig<InferSchemaOutput<TSchema>, string | number, TSchema> & {\n\tutils: WebSocketUtils;\n\tschema: TSchema;\n} {\n\ttype TItem = InferSchemaOutput<TSchema>;\n\n\tlet ws: WebSocket | null = null;\n\tlet reconnectTimer: NodeJS.Timeout | null = null;\n\tlet connectionState: \"connected\" | \"disconnected\" | \"connecting\" =\n\t\t\"disconnected\";\n\n\t// Track pending transactions awaiting acknowledgment\n\tconst pendingTransactions = new Map<\n\t\tstring,\n\t\t{\n\t\t\tresolve: () => void;\n\t\t\treject: (error: Error) => void;\n\t\t\ttimeout: NodeJS.Timeout;\n\t\t}\n\t>();\n\n\tconst handlers: {\n\t\tonOpen?: () => void;\n\t\tonMessage?: (event: MessageEvent) => void;\n\t\tonError?: (error: Event) => void;\n\t\tonClose?: () => void;\n\t} = {};\n\n\tconst connect = () => {\n\t\tconnectionState = \"connecting\";\n\t\tws = new WebSocket(config.url);\n\n\t\tws.onopen = () => {\n\t\t\thandlers.onOpen?.();\n\t\t};\n\t\tws.onmessage = (event) => {\n\t\t\thandlers.onMessage?.(event);\n\t\t};\n\t\tws.onerror = (error) => {\n\t\t\thandlers.onError?.(error);\n\t\t};\n\t\tws.onclose = () => {\n\t\t\thandlers.onClose?.();\n\t\t};\n\t};\n\n\tconst sync: SyncConfig<TItem>[\"sync\"] = (params) => {\n\t\tconst { begin, write, commit, markReady } = params;\n\n\t\thandlers.onOpen = () => {\n\t\t\tif (!ws) return;\n\n\t\t\tconnectionState = \"connected\";\n\t\t\t// Request initial sync\n\t\t\tws.send(JSON.stringify({ type: \"sync\" }));\n\t\t};\n\n\t\thandlers.onMessage = (event) => {\n\t\t\tif (!ws) return;\n\n\t\t\tconst message: WebSocketMessage<TItem> = JSON.parse(event.data);\n\n\t\t\tswitch (message.type) {\n\t\t\t\tcase \"sync\":\n\t\t\t\t\t// Initial sync with array of items\n\t\t\t\t\tbegin();\n\t\t\t\t\tif (Array.isArray(message.data)) {\n\t\t\t\t\t\tfor (const item of message.data) {\n\t\t\t\t\t\t\twrite({ type: \"insert\", value: item });\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\t\t\t\t\tcommit();\n\t\t\t\t\tmarkReady();\n\t\t\t\t\tbreak;\n\n\t\t\t\tcase \"insert\":\n\t\t\t\tcase \"update\":\n\t\t\t\tcase \"delete\":\n\t\t\t\t\t// Real-time updates from other clients\n\t\t\t\t\tbegin();\n\t\t\t\t\twrite({\n\t\t\t\t\t\ttype: message.type,\n\t\t\t\t\t\tvalue: message.data as InferSchemaInput<TSchema>,\n\t\t\t\t\t});\n\t\t\t\t\tcommit();\n\t\t\t\t\tbreak;\n\n\t\t\t\tcase \"ack\":\n\t\t\t\t\t// Server acknowledged our transaction\n\t\t\t\t\tif (message.transactionId) {\n\t\t\t\t\t\tconst pending = pendingTransactions.get(message.transactionId);\n\t\t\t\t\t\tif (pending) {\n\t\t\t\t\t\t\tclearTimeout(pending.timeout);\n\t\t\t\t\t\t\tpendingTransactions.delete(message.transactionId);\n\t\t\t\t\t\t\tpending.resolve();\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\t\t\t\t\tbreak;\n\n\t\t\t\tcase \"transaction\":\n\t\t\t\t\t// Server sending back the actual data after processing our transaction\n\t\t\t\t\tif (message.mutations) {\n\t\t\t\t\t\tbegin();\n\t\t\t\t\t\tfor (const mutation of message.mutations) {\n\t\t\t\t\t\t\twrite({\n\t\t\t\t\t\t\t\ttype: mutation.type,\n\t\t\t\t\t\t\t\tvalue: mutation.data,\n\t\t\t\t\t\t\t});\n\t\t\t\t\t\t}\n\t\t\t\t\t\tcommit();\n\t\t\t\t\t}\n\t\t\t\t\tbreak;\n\t\t\t\tdefault:\n\t\t\t\t\texhaustiveGuard(message.type);\n\t\t\t}\n\t\t};\n\n\t\thandlers.onError = (error) => {\n\t\t\tconsole.error(\"WebSocket error:\", error);\n\t\t\tconnectionState = \"disconnected\";\n\t\t};\n\n\t\thandlers.onClose = () => {\n\t\t\tconnectionState = \"disconnected\";\n\t\t\t// Auto-reconnect\n\t\t\tif (!reconnectTimer) {\n\t\t\t\treconnectTimer = setTimeout(() => {\n\t\t\t\t\treconnectTimer = null;\n\t\t\t\t\tconnect();\n\t\t\t\t}, config.reconnectInterval || 5000);\n\t\t\t}\n\t\t};\n\n\t\t// Start connection\n\t\tconnect();\n\n\t\t// Return cleanup function\n\t\treturn () => {\n\t\t\tif (reconnectTimer) {\n\t\t\t\tclearTimeout(reconnectTimer);\n\t\t\t\treconnectTimer = null;\n\t\t\t}\n\t\t\tif (ws) {\n\t\t\t\tws.close();\n\t\t\t\tws = null;\n\t\t\t}\n\t\t};\n\t};\n\n\t// Helper function to send transaction and wait for server acknowledgment\n\tconst sendTransaction = async (\n\t\tparams:\n\t\t\t| InsertMutationFnParams<TItem>\n\t\t\t| UpdateMutationFnParams<TItem>\n\t\t\t| DeleteMutationFnParams<TItem>,\n\t): Promise<void> => {\n\t\tif (ws?.readyState !== WebSocket.OPEN) {\n\t\t\tthrow new Error(\"WebSocket not connected\");\n\t\t}\n\n\t\tconst transactionId = crypto.randomUUID();\n\n\t\t// Convert all mutations in the transaction to the wire format\n\t\tconst mutations = params.transaction.mutations.map((mutation) => {\n\t\t\tswitch (mutation.type) {\n\t\t\t\tcase \"insert\":\n\t\t\t\t\treturn {\n\t\t\t\t\t\ttype: mutation.type,\n\t\t\t\t\t\tid: mutation.key,\n\t\t\t\t\t\tdata: mutation.modified,\n\t\t\t\t\t};\n\t\t\t\tcase \"update\":\n\t\t\t\t\treturn {\n\t\t\t\t\t\ttype: mutation.type,\n\t\t\t\t\t\tid: mutation.key,\n\t\t\t\t\t\tdata: mutation.changes,\n\t\t\t\t\t};\n\t\t\t\tcase \"delete\":\n\t\t\t\t\treturn {\n\t\t\t\t\t\ttype: mutation.type,\n\t\t\t\t\t\tid: mutation.key,\n\t\t\t\t\t\tdata: undefined,\n\t\t\t\t\t};\n\t\t\t\tdefault:\n\t\t\t\t\treturn exhaustiveGuard(mutation);\n\t\t\t}\n\t\t});\n\n\t\t// Send the entire transaction at once\n\t\tws.send(\n\t\t\tJSON.stringify({\n\t\t\t\ttype: \"transaction\",\n\t\t\t\ttransactionId,\n\t\t\t\tmutations,\n\t\t\t}),\n\t\t);\n\n\t\t// Wait for server acknowledgment\n\t\treturn new Promise<void>((resolve, reject) => {\n\t\t\tconst timeout = setTimeout(() => {\n\t\t\t\tpendingTransactions.delete(transactionId);\n\t\t\t\treject(new Error(`Transaction ${transactionId} timed out`));\n\t\t\t}, 10000); // 10 second timeout\n\n\t\t\tpendingTransactions.set(transactionId, {\n\t\t\t\tresolve,\n\t\t\t\treject,\n\t\t\t\ttimeout,\n\t\t\t});\n\t\t});\n\t};\n\n\t// All mutation handlers use the same transaction sender\n\tconst onInsert = async (params: InsertMutationFnParams<TItem>) => {\n\t\tawait sendTransaction(params);\n\t};\n\n\tconst onUpdate = async (params: UpdateMutationFnParams<TItem>) => {\n\t\tawait sendTransaction(params);\n\t};\n\n\tconst onDelete = async (params: DeleteMutationFnParams<TItem>) => {\n\t\tawait sendTransaction(params);\n\t};\n\n\treturn {\n\t\tid: config.id,\n\t\tschema: config.schema,\n\t\tgetKey: config.getKey,\n\t\tsync: { sync },\n\t\tonInsert,\n\t\tonUpdate,\n\t\tonDelete,\n\t\tutils: {\n\t\t\treconnect: () => {\n\t\t\t\tif (ws) ws.close();\n\t\t\t\tconnect();\n\t\t\t},\n\t\t\tgetConnectionState: () => connectionState,\n\t\t},\n\t};\n}\n"]}

package/dist/context/DrizzleSqliteProvider.d.ts

@@ -0,0 +1,50 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import * as react from 'react';
+import { PropsWithChildren } from 'react';
+import { SqliteRemoteDatabase } from 'drizzle-orm/sqlite-proxy';
+import { Collection, InferSchemaOutput } from '@tanstack/db';
+import { ValidTableNames } from '../collections/sqlite-collection.js';
+import { DurableSqliteMigrationConfig } from '../migration/migrator.js';
+import { SqliteWasmWorkerOpenOptions } from '../worker/sqlite-open-options.js';
+import { GetTableFromSchema, IdOf, SQLInterceptor, InferCollectionFromTable } from '@firtoz/drizzle-utils';
+import 'drizzle-orm';
+import 'drizzle-orm/sqlite-core';
+import '@firtoz/db-helpers';
+import 'drizzle-orm/durable-sqlite/migrator';
+import 'zod';
+
+type SqliteCollection<TSchema extends Record<string, unknown>, TTableName extends string & ValidTableNames<TSchema>> = Collection<InferSchemaOutput<GetTableFromSchema<TSchema, TTableName>["$inferSelect"]>, IdOf<GetTableFromSchema<TSchema, TTableName>>, any, any, Omit<GetTableFromSchema<TSchema, TTableName>["$inferInsert"], "id"> & {
+    id?: IdOf<GetTableFromSchema<TSchema, TTableName>>;
+}>;
+type DrizzleSqliteContextValue<TSchema extends Record<string, unknown>> = {
+    drizzle: SqliteRemoteDatabase<TSchema>;
+    readyPromise: Promise<void>;
+    getCollection: <TTableName extends string & ValidTableNames<TSchema>>(tableName: TTableName) => SqliteCollection<TSchema, TTableName>;
+    incrementRefCount: (tableName: string) => void;
+    decrementRefCount: (tableName: string) => void;
+};
+declare const DrizzleSqliteContext: react.Context<DrizzleSqliteContextValue<any> | null>;
+type DrizzleSqliteProviderProps<TSchema extends Record<string, unknown>> = PropsWithChildren<{
+    worker: new () => Worker;
+    dbName: string;
+    schema: TSchema;
+    migrations: DurableSqliteMigrationConfig;
+    debug?: boolean;
+    enableCheckpoint?: boolean;
+    /**
+     * Sync mode: 'eager' (immediate) or 'on-demand' (lazy)
+     */
+    syncMode?: "eager" | "on-demand";
+    /**
+     * Optional interceptor for tracking SQLite operations (for testing/debugging)
+     */
+    interceptor?: SQLInterceptor;
+    /**
+     * Worker DB pragmas on first open of `dbName` this session (see `useDrizzleSqliteDb`).
+     */
+    workerOpenOptions?: SqliteWasmWorkerOpenOptions;
+}>;
+declare function DrizzleSqliteProvider<TSchema extends Record<string, unknown>>({ children, worker, dbName, schema, migrations, debug, enableCheckpoint, syncMode, interceptor, workerOpenOptions, }: DrizzleSqliteProviderProps<TSchema>): react_jsx_runtime.JSX.Element;
+declare function useSqliteCollection<TSchema extends Record<string, unknown>, TTableName extends string & ValidTableNames<TSchema>>(context: DrizzleSqliteContextValue<TSchema>, tableName: TTableName): InferCollectionFromTable<GetTableFromSchema<TSchema, TTableName>>;
+
+export { DrizzleSqliteContext, type DrizzleSqliteContextValue, DrizzleSqliteProvider, useSqliteCollection };

package/dist/context/DrizzleSqliteProvider.js

@@ -0,0 +1,11 @@
+export { DrizzleSqliteContext, DrizzleSqliteProvider, useSqliteCollection } from '../chunk-AEYHRJVN.js';
+import '../chunk-WFFFP6DB.js';
+import '../chunk-NSPVPJKE.js';
+import '../chunk-FIVEPVOM.js';
+import '../chunk-AGMKOHXO.js';
+import '../chunk-GVUNHU6J.js';
+import '../chunk-6LNYKOKR.js';
+import '../chunk-BZVMUTJ7.js';
+import '../chunk-FRONXNEA.js';
+//# sourceMappingURL=DrizzleSqliteProvider.js.map
+//# sourceMappingURL=DrizzleSqliteProvider.js.map

package/dist/context/DrizzleSqliteProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"DrizzleSqliteProvider.js"}

package/dist/context/useDrizzleSqlite.d.ts

@@ -0,0 +1,23 @@
+import { DrizzleSqliteContextValue, useSqliteCollection } from './DrizzleSqliteProvider.js';
+import { ValidTableNames } from '../collections/sqlite-collection.js';
+import 'react/jsx-runtime';
+import 'react';
+import 'drizzle-orm/sqlite-proxy';
+import '@tanstack/db';
+import '../migration/migrator.js';
+import 'drizzle-orm/durable-sqlite/migrator';
+import '../worker/sqlite-open-options.js';
+import 'zod';
+import '@firtoz/drizzle-utils';
+import 'drizzle-orm';
+import 'drizzle-orm/sqlite-core';
+import '@firtoz/db-helpers';
+
+type UseDrizzleSqliteReturn<TSchema extends Record<string, unknown>> = {
+    drizzle: DrizzleSqliteContextValue<TSchema>["drizzle"];
+    readyPromise: DrizzleSqliteContextValue<TSchema>["readyPromise"];
+    useCollection: <TTableName extends string & ValidTableNames<TSchema>>(tableName: TTableName) => ReturnType<typeof useSqliteCollection<TSchema, TTableName>>;
+};
+declare function useDrizzleSqlite<TSchema extends Record<string, unknown>>(): UseDrizzleSqliteReturn<TSchema>;
+
+export { type UseDrizzleSqliteReturn, useDrizzleSqlite };

package/dist/context/useDrizzleSqlite.js

@@ -0,0 +1,12 @@
+export { useDrizzleSqlite } from '../chunk-H2F2HZ2A.js';
+import '../chunk-AEYHRJVN.js';
+import '../chunk-WFFFP6DB.js';
+import '../chunk-NSPVPJKE.js';
+import '../chunk-FIVEPVOM.js';
+import '../chunk-AGMKOHXO.js';
+import '../chunk-GVUNHU6J.js';
+import '../chunk-6LNYKOKR.js';
+import '../chunk-BZVMUTJ7.js';
+import '../chunk-FRONXNEA.js';
+//# sourceMappingURL=useDrizzleSqlite.js.map
+//# sourceMappingURL=useDrizzleSqlite.js.map

package/dist/context/useDrizzleSqlite.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"useDrizzleSqlite.js"}

package/dist/drizzle/direct.d.ts

@@ -0,0 +1,8 @@
+import * as drizzle_orm_sqlite_proxy from 'drizzle-orm/sqlite-proxy';
+import { Database } from '../types.js';
+import { DrizzleConfig } from 'drizzle-orm';
+import '@sqlite.org/sqlite-wasm';
+
+declare const drizzleSqliteWasm: <TSchema extends Record<string, unknown> = Record<string, never>>(sqliteDb: Database, config?: DrizzleConfig<TSchema>, debug?: boolean) => drizzle_orm_sqlite_proxy.SqliteRemoteDatabase<TSchema>;
+
+export { drizzleSqliteWasm };

package/dist/drizzle/direct.js

@@ -0,0 +1,4 @@
+export { drizzleSqliteWasm } from '../chunk-TZP4AIBR.js';
+import '../chunk-BJDPMGFF.js';
+//# sourceMappingURL=direct.js.map
+//# sourceMappingURL=direct.js.map

package/dist/drizzle/direct.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"direct.js"}

package/dist/drizzle/handle-callback.d.ts

@@ -0,0 +1,15 @@
+import { MaybeError } from '@firtoz/maybe-error';
+import { Database } from '../types.js';
+import '@sqlite.org/sqlite-wasm';
+
+declare const handleRemoteCallback: ({ sqliteDb, sql, params, method, debug: _debug, }: {
+    sqliteDb: Database;
+    sql: string;
+    params: any[];
+    method: "run" | "all" | "values" | "get";
+    debug?: boolean;
+}) => Promise<MaybeError<{
+    rows: unknown[];
+}, string>>;
+
+export { handleRemoteCallback };

package/dist/drizzle/handle-callback.js

@@ -0,0 +1,3 @@
+export { handleRemoteCallback } from '../chunk-BJDPMGFF.js';
+//# sourceMappingURL=handle-callback.js.map
+//# sourceMappingURL=handle-callback.js.map

package/dist/drizzle/handle-callback.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"handle-callback.js"}

package/dist/drizzle/worker.d.ts

@@ -0,0 +1,15 @@
+import * as drizzle_orm_sqlite_proxy from 'drizzle-orm/sqlite-proxy';
+import { DrizzleConfig } from 'drizzle-orm';
+import { ISqliteWorkerClient } from '../worker/client.js';
+import { SQLInterceptor } from '@firtoz/drizzle-utils';
+import '../worker/schema.js';
+import 'zod';
+
+declare const drizzleSqliteWasmWorker: <TSchema extends Record<string, unknown> = Record<string, never>>(client: ISqliteWorkerClient, config?: DrizzleConfig<TSchema>) => drizzle_orm_sqlite_proxy.SqliteRemoteDatabase<TSchema>;
+/**
+ * Creates an instrumented Drizzle instance that logs all SQL queries.
+ * This wraps the standard drizzleSqliteWasmWorker to intercept every query.
+ */
+declare const createInstrumentedDrizzle: <TSchema extends Record<string, unknown> = Record<string, never>>(client: ISqliteWorkerClient, config?: DrizzleConfig<TSchema>, interceptor?: SQLInterceptor) => drizzle_orm_sqlite_proxy.SqliteRemoteDatabase<TSchema>;
+
+export { createInstrumentedDrizzle, drizzleSqliteWasmWorker };

package/dist/drizzle/worker.js

@@ -0,0 +1,3 @@
+export { createInstrumentedDrizzle, drizzleSqliteWasmWorker } from '../chunk-FRONXNEA.js';
+//# sourceMappingURL=worker.js.map
+//# sourceMappingURL=worker.js.map

package/dist/drizzle/worker.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"worker.js"}