event-sourced-collection 0.0.8 → 0.0.9

package/dist/browser.d.mts

@@ -1,6 +1,36 @@
-import { a as BrowserPlatformConfig, c as BrowserWASQLiteDatabase, i as BrowserCoordinatorInstance, n as BrowserEventSourcedModules, o as BrowserPlatformDeps, r as createBrowserEventSourcedDB, s as BrowserPlatformResult, t as BrowserEventSourcedDBConfig } from "./browser-event-sourced-db-CCOAgE31.mjs";
-import { t as EventSourcedDBHandle } from "./create-event-sourced-db-handle-BAos-9pS.mjs";
+import { L as SyncLock, P as SQLiteDriver, Q as InjectedModuleFn, Z as InjectedCreateCollection, p as EventSourcedSharedOptions } from "./types-BSdudVLh.mjs";
+import { r as ModulesInput, t as EventSourcedDBHandle } from "./create-event-sourced-db-handle-BAos-9pS.mjs";
+import { PersistedCollectionPersistence } from "@tanstack/db-sqlite-persistence-core";
 
+//#region src/platforms/browser-wa-sqlite-driver.d.ts
+type BrowserWASQLiteDatabase = {
+  execute: <TRow = unknown>(sql: string, params?: ReadonlyArray<unknown>) => Promise<ReadonlyArray<TRow>>;
+  close?: () => Promise<void> | void;
+};
+//#endregion
+//#region src/platforms/browser-types.d.ts
+type BrowserCoordinatorInstance = {
+  dispose: () => void;
+};
+/**
+ * Injected TanStack browser persistence bindings. Parameters are `never` so
+ * version-skewed `@tanstack/browser-db-sqlite-persistence` exports stay assignable.
+ */
+type BrowserPlatformDeps = {
+  openBrowserWASQLiteOPFSDatabase: (options: never) => Promise<BrowserWASQLiteDatabase>;
+  createBrowserWASQLitePersistence: (options: never) => PersistedCollectionPersistence;
+  BrowserCollectionCoordinator: new (options: never) => BrowserCoordinatorInstance;
+};
+type BrowserPlatformConfig = {
+  databaseName: string;
+  coordinatorDbName?: string;
+};
+type BrowserPlatformResult = {
+  driver: SQLiteDriver;
+  persistence: PersistedCollectionPersistence;
+  close: () => Promise<void>;
+};
+//#endregion
 //#region src/platforms/browser.d.ts
 /**
  * Opens OPFS SQLite, a cross-tab coordinator, and TanStack persistence.
@@ -31,5 +61,91 @@ import { t as EventSourcedDBHandle } from "./create-event-sourced-db-handle-BAos
  */
 declare function createBrowserPlatform(deps: BrowserPlatformDeps, config: BrowserPlatformConfig): Promise<BrowserPlatformResult>;
 //#endregion
+//#region src/platforms/browser-event-sourced-db.d.ts
+type CollectionDefConstraint = {
+  getKey: (state: never) => string | number;
+};
+type BrowserEventSourcedModules = BrowserPlatformDeps & {
+  createCollection: InjectedCreateCollection;
+  persistedCollectionOptions: InjectedModuleFn;
+};
+/**
+ * Browser entry-point config. Shared sync/lifecycle fields come from
+ * {@link EventSourcedSharedOptions} (hover those properties for docs).
+ * Deep guide: `docs/usage.md`.
+ */
+type BrowserEventSourcedDBConfig<TDefs extends Record<string, CollectionDefConstraint>> = Omit<EventSourcedSharedOptions, "lock" | "lockName"> & {
+  /**
+   * User collection registry. Object keys become `db.collections.<key>` and
+   * the wire `collectionId`. Must not collide with reserved names.
+   */
+  collections: TDefs;
+  /**
+   * OPFS SQLite database file name (e.g. `"my-app.sqlite"`). Also used as the
+   * default sync lock namespace so only one tab syncs for this DB at a time.
+   */
+  databaseName: string;
+  /**
+   * Name for the cross-tab collection coordinator database. Defaults to
+   * `databaseName` with a trailing `.sqlite` stripped.
+   */
+  coordinatorDbName?: string;
+  /**
+   * Browser OPFS persistence modules from
+   * `@tanstack/browser-db-sqlite-persistence` plus `createCollection`.
+   * Pass the imported bindings directly, or a function to keep WASM off the
+   * critical path.
+   */
+  modules: ModulesInput<BrowserEventSourcedModules>;
+  /**
+   * Defaults to a Web Locks–backed lock so only one tab syncs at a time.
+   * Pass `null` to opt out and let every tab sync independently.
+   */
+  lock?: SyncLock | null;
+};
+/**
+ * Browser-flavoured event-sourced DB: OPFS SQLite + optional Web Locks sync
+ * election, returned as a lazy singleton.
+ *
+ * @param config - See {@link BrowserEventSourcedDBConfig} for every option.
+ *
+ * @example
+ * ```ts
+ * import { createBrowserEventSourcedDB } from "event-sourced-collection/browser"
+ * import type { CollectionDef, EventSourcedDB } from "event-sourced-collection"
+ *
+ * type Todo = { id: string; title: string }
+ * type Defs = { todos: CollectionDef<Todo, string> }
+ *
+ * const { ensureDb, db } = createBrowserEventSourcedDB<Defs>({
+ *   databaseName: "app.sqlite",
+ *   collections: { todos: { getKey: (todo) => todo.id } },
+ *   sync: { push: "/api/sync/events", pull: "/api/sync/events" },
+ *   modules: async () => {
+ *     const { createCollection } = await import("@tanstack/db")
+ *     const {
+ *       BrowserCollectionCoordinator,
+ *       createBrowserWASQLitePersistence,
+ *       openBrowserWASQLiteOPFSDatabase,
+ *       persistedCollectionOptions,
+ *     } = await import("@tanstack/browser-db-sqlite-persistence")
+ *     return {
+ *       createCollection,
+ *       BrowserCollectionCoordinator,
+ *       createBrowserWASQLitePersistence,
+ *       openBrowserWASQLiteOPFSDatabase,
+ *       persistedCollectionOptions,
+ *     }
+ *   },
+ * })
+ *
+ * export async function start() {
+ *   await ensureDb()
+ * }
+ * export { db }
+ * ```
+ */
+declare function createBrowserEventSourcedDB<const TDefs extends Record<string, CollectionDefConstraint>>(config: BrowserEventSourcedDBConfig<TDefs>): EventSourcedDBHandle<TDefs>;
+//#endregion
 export { type BrowserCoordinatorInstance, type BrowserEventSourcedDBConfig, type EventSourcedDBHandle as BrowserEventSourcedDBHandle, type BrowserEventSourcedModules, type BrowserPlatformConfig, type BrowserPlatformDeps, type BrowserPlatformResult, type BrowserWASQLiteDatabase, createBrowserEventSourcedDB, createBrowserPlatform };
 //# sourceMappingURL=browser.d.mts.map

package/dist/browser.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"browser.d.mts","names":[],"sources":["../src/platforms/browser.ts"],"mappings":";;;;;AA2CA;;;;;;;;;;;;;;;;AAGgC;;;;;;;;;;iBAHV,qBAAA,CACpB,IAAA,EAAM,mBAAA,EACN,MAAA,EAAQ,qBAAA,GACP,OAAA,CAAQ,qBAAA"}
+{"version":3,"file":"browser.d.mts","names":[],"sources":["../src/platforms/browser-wa-sqlite-driver.ts","../src/platforms/browser-types.ts","../src/platforms/browser.ts","../src/platforms/browser-event-sourced-db.ts"],"mappings":";;;;;KAEY,uBAAA;EACV,OAAA,mBACE,GAAA,UACA,MAAA,GAAS,aAAA,cACN,OAAA,CAAQ,aAAA,CAAc,IAAA;EAC3B,KAAA,SAAc,OAAA;AAAA;;;KCJJ,0BAAA;EACV,OAAO;AAAA;;ADFT;;;KCSY,mBAAA;EACV,+BAAA,GAAkC,OAAA,YAAmB,OAAA,CAAQ,uBAAA;EAC7D,gCAAA,GAAmC,OAAA,YAAmB,8BAAA;EACtD,4BAAA,OAAmC,OAAA,YAAmB,0BAAA;AAAA;AAAA,KAG5C,qBAAA;EACV,YAAA;EACA,iBAAiB;AAAA;AAAA,KAGP,qBAAA;EACV,MAAA,EAD+B,YAAA;EAE/B,WAAA,EAAa,8BAAA;EACb,KAAA,QAAa,OAAA;AAAA;;;;;;ADvBf;;;;;;;;;;;;;;;;;;;;;AAKuB;;;iBEoCD,qBAAA,CACpB,IAAA,EAAM,mBAAA,EACN,MAAA,EAAQ,qBAAA,GACP,OAAA,CAAQ,qBAAA;;;KC9BN,uBAAA;EACH,MAAA,GAAS,KAAY;AAAA;AAAA,KAGX,0BAAA,GAA6B,mBAAA;EACvC,gBAAA,EAAkB,wBAAA;EAClB,0BAAA,EAA4B,gBAAA;AAAA;;;;;;KAQlB,2BAAA,eAA0C,MAAA,SAAe,uBAAA,KACnE,IAAA,CAAK,yBAAA;EH5BK;;;;EGiCR,WAAA,EAAa,KAAA;EH9BF;;;;EGmCX,YAAA;EHlCmB;;;;EGuCnB,iBAAA;EF3CkC;;;AAC7B;AAOT;;EE0CI,OAAA,EAAS,YAAA,CAAa,0BAAA;EFzCqC;;;;EE8C3D,IAAA,GAAO,QAAA;AAAA;;;;;;;;;;;AF5CuE;AAGlF;;;;AAEmB;AAGnB;;;;;;;;;;;;;;;AAGsB;;;;ACkBtB;;;;;;;iBC8DgB,2BAAA,qBACM,MAAA,SAAe,uBAAA,GACnC,MAAA,EAAQ,2BAAA,CAA4B,KAAA,IAAM,oBAAA,CAAA,KAAA"}

package/dist/node.d.mts

@@ -1,6 +1,5 @@
 import { Q as InjectedModuleFn, S as PersistedCollectionPersistence, Z as InjectedCreateCollection, p as EventSourcedSharedOptions } from "./types-BSdudVLh.mjs";
 import { r as ModulesInput, t as EventSourcedDBHandle } from "./create-event-sourced-db-handle-BAos-9pS.mjs";
-
 //#region src/platforms/node.d.ts
 type NodePlatformDeps = {
   createNodeSQLitePersistence: (options: {

package/dist/node.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"node.d.mts","names":[],"sources":["../src/platforms/node.ts","../src/platforms/node-event-sourced-db.ts"],"mappings":";;;;KAEY,gBAAA;EACV,2BAAA,GAA8B,OAAA;IAAW,QAAA;EAAA,MAAsB,8BAA8B;AAAA;AAAA,KAGnF,kBAAA;EACV,QAAQ;AAAA;AAAA,KAGE,kBAAA;EACV,WAAA,EAAa,8BAA8B;AAAA;;;AARkD;AAG/F;;;;AACU;AAGV;;;;AAC6C;AA6B7C;;;;;;;;;;;;;iBAAgB,kBAAA,CACd,IAAA,EAAM,gBAAA,EACN,MAAA,EAAQ,kBAAA,GACP,kBAAA;;;KC7BE,uBAAA;EACH,MAAA,GAAS,KAAY;AAAA;AAAA,KAGX,uBAAA;EACV,2BAAA,GAA8B,OAAA;IAAW,QAAA;EAAA,MAAsB,8BAAA,EDhBtB;ECkBzC,QAAA;EACA,gBAAA,EAAkB,wBAAA;EAClB,0BAAA,EAA4B,gBAAA;AAAA;AAAA,KAGlB,wBAAA,eAAuC,MAAA,SAAe,uBAAA,KAChE,yBAAA;EACE,WAAA,EAAa,KAAA;;;ADrBP;AAGV;ECuBI,OAAA,EAAS,YAAA,CAAa,uBAAA;AAAA;;ADtBmB;AA6B7C;;;;;;;;;;;;;;AAGqB;;;;AChC0E;;;;AAIxE;AAGvB;;;;;;;;;iBAoDgB,wBAAA,qBACM,MAAA,SAAe,uBAAA,GACnC,MAAA,EAAQ,wBAAA,CAAyB,KAAA,IAAM,oBAAA,CAAA,KAAA"}
+{"version":3,"file":"node.d.mts","names":[],"sources":["../src/platforms/node.ts","../src/platforms/node-event-sourced-db.ts"],"mappings":";;;KAEY,gBAAA;EACV,2BAAA,GAA8B,OAAA;IAAW,QAAA;EAAA,MAAsB,8BAA8B;AAAA;AAAA,KAGnF,kBAAA;EACV,QAAQ;AAAA;AAAA,KAGE,kBAAA;EACV,WAAA,EAAa,8BAA8B;AAAA;;;AARkD;AAG/F;;;;AACU;AAGV;;;;AAC6C;AA6B7C;;;;;;;;;;;;;iBAAgB,kBAAA,CACd,IAAA,EAAM,gBAAA,EACN,MAAA,EAAQ,kBAAA,GACP,kBAAA;;;KC7BE,uBAAA;EACH,MAAA,GAAS,KAAY;AAAA;AAAA,KAGX,uBAAA;EACV,2BAAA,GAA8B,OAAA;IAAW,QAAA;EAAA,MAAsB,8BAAA,EDhBtB;ECkBzC,QAAA;EACA,gBAAA,EAAkB,wBAAA;EAClB,0BAAA,EAA4B,gBAAA;AAAA;AAAA,KAGlB,wBAAA,eAAuC,MAAA,SAAe,uBAAA,KAChE,yBAAA;EACE,WAAA,EAAa,KAAA;;;ADrBP;AAGV;ECuBI,OAAA,EAAS,YAAA,CAAa,uBAAA;AAAA;;ADtBmB;AA6B7C;;;;;;;;;;;;;;AAGqB;;;;AChC0E;;;;AAIxE;AAGvB;;;;;;;;;iBAoDgB,wBAAA,qBACM,MAAA,SAAe,uBAAA,GACnC,MAAA,EAAQ,wBAAA,CAAyB,KAAA,IAAM,oBAAA,CAAA,KAAA"}

package/dist/react-native-event-sourced-db-CTS4b8o9.d.mts

@@ -0,0 +1,61 @@
+import { Q as InjectedModuleFn, S as PersistedCollectionPersistence, Z as InjectedCreateCollection, p as EventSourcedSharedOptions } from "./types-BSdudVLh.mjs";
+import { r as ModulesInput, t as EventSourcedDBHandle } from "./create-event-sourced-db-handle-BAos-9pS.mjs";
+
+//#region src/platforms/react-native-event-sourced-db.d.ts
+type CollectionDefConstraint = {
+  getKey: (state: never) => string | number;
+};
+type ReactNativeEventSourcedModules = {
+  createReactNativeSQLitePersistence: (options: {
+    database: never;
+  }) => PersistedCollectionPersistence; /** Already-opened op-sqlite (or compatible) database. */
+  database: unknown;
+  createCollection: InjectedCreateCollection;
+  persistedCollectionOptions: InjectedModuleFn;
+};
+/**
+ * React Native entry-point config. Shared sync/lifecycle fields come from
+ * {@link EventSourcedSharedOptions} (hover those properties for docs).
+ * Deep guide: `docs/usage.md`.
+ */
+type ReactNativeEventSourcedDBConfig<TDefs extends Record<string, CollectionDefConstraint>> = EventSourcedSharedOptions & {
+  collections: TDefs;
+  /**
+   * React Native persistence modules from
+   * `@tanstack/react-native-db-sqlite-persistence` plus `createCollection`.
+   * Pass the imported bindings directly, or a function to delay native SQLite.
+   */
+  modules: ModulesInput<ReactNativeEventSourcedModules>;
+};
+/**
+ * React Native–flavoured event-sourced DB, returned as a lazy singleton.
+ *
+ * @param config - See {@link ReactNativeEventSourcedDBConfig} for every option.
+ *
+ * @example
+ * ```ts
+ * import { createReactNativeEventSourcedDB } from "event-sourced-collection/react-native"
+ *
+ * const { ensureDb, db } = createReactNativeEventSourcedDB({
+ *   collections: { todos: { getKey: (todo: { id: string }) => todo.id } },
+ *   modules: async () => {
+ *     const { createCollection } = await import("@tanstack/react-native-db")
+ *     const { createReactNativeSQLitePersistence, persistedCollectionOptions } =
+ *       await import("@tanstack/react-native-db-sqlite-persistence")
+ *     const { openDatabase } = await import("react-native-op-sqlite")
+ *     return {
+ *       createCollection,
+ *       createReactNativeSQLitePersistence,
+ *       persistedCollectionOptions,
+ *       database: openDatabase({ name: "app.sqlite" }),
+ *     }
+ *   },
+ * })
+ *
+ * await ensureDb()
+ * ```
+ */
+declare function createReactNativeEventSourcedDB<const TDefs extends Record<string, CollectionDefConstraint>>(config: ReactNativeEventSourcedDBConfig<TDefs>): EventSourcedDBHandle<TDefs>;
+//#endregion
+export { ReactNativeEventSourcedModules as n, createReactNativeEventSourcedDB as r, ReactNativeEventSourcedDBConfig as t };
+//# sourceMappingURL=react-native-event-sourced-db-CTS4b8o9.d.mts.map

package/dist/react-native-event-sourced-db-CTS4b8o9.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"react-native-event-sourced-db-CTS4b8o9.d.mts","names":[],"sources":["../src/platforms/react-native-event-sourced-db.ts"],"mappings":";;;;KAcK,uBAAA;EACH,MAAA,GAAS,KAAY;AAAA;AAAA,KAGX,8BAAA;EACV,kCAAA,GAAqC,OAAA;IACnC,QAAA;EAAA,MACI,8BAAA,EAHkC;EAKxC,QAAA;EACA,gBAAA,EAAkB,wBAAA;EAClB,0BAAA,EAA4B,gBAAA;AAAA;;;;;;KAQlB,+BAAA,eAA8C,MAAA,SAAe,uBAAA,KACvE,yBAAA;EACE,WAAA,EAAa,KAAA;EAXf;;;;;EAiBE,OAAA,EAAS,YAAA,CAAa,8BAAA;AAAA;;;;;;;;;;;;;;;;;;;;AAA8B;AAiCxD;;;;;;;;iBAAgB,+BAAA,qBACM,MAAA,SAAe,uBAAA,GACnC,MAAA,EAAQ,+BAAA,CAAgC,KAAA,IAAM,oBAAA,CAAA,KAAA"}

package/dist/react-native.d.mts

@@ -1,5 +1,6 @@
-import { Q as InjectedModuleFn, S as PersistedCollectionPersistence, Z as InjectedCreateCollection, p as EventSourcedSharedOptions } from "./types-BSdudVLh.mjs";
-import { r as ModulesInput, t as EventSourcedDBHandle } from "./create-event-sourced-db-handle-BAos-9pS.mjs";
+import { S as PersistedCollectionPersistence } from "./types-BSdudVLh.mjs";
+import { t as EventSourcedDBHandle } from "./create-event-sourced-db-handle-BAos-9pS.mjs";
+import { n as ReactNativeEventSourcedModules, r as createReactNativeEventSourcedDB, t as ReactNativeEventSourcedDBConfig } from "./react-native-event-sourced-db-CTS4b8o9.mjs";
 
 //#region src/platforms/react-native.d.ts
 type ReactNativePlatformDeps = {
@@ -44,61 +45,5 @@ type ReactNativePlatformResult = {
  */
 declare function createReactNativePlatform(deps: ReactNativePlatformDeps, config: ReactNativePlatformConfig): ReactNativePlatformResult;
 //#endregion
-//#region src/platforms/react-native-event-sourced-db.d.ts
-type CollectionDefConstraint = {
-  getKey: (state: never) => string | number;
-};
-type ReactNativeEventSourcedModules = {
-  createReactNativeSQLitePersistence: (options: {
-    database: never;
-  }) => PersistedCollectionPersistence; /** Already-opened op-sqlite (or compatible) database. */
-  database: unknown;
-  createCollection: InjectedCreateCollection;
-  persistedCollectionOptions: InjectedModuleFn;
-};
-/**
- * React Native entry-point config. Shared sync/lifecycle fields come from
- * {@link EventSourcedSharedOptions} (hover those properties for docs).
- * Deep guide: `docs/usage.md`.
- */
-type ReactNativeEventSourcedDBConfig<TDefs extends Record<string, CollectionDefConstraint>> = EventSourcedSharedOptions & {
-  collections: TDefs;
-  /**
-   * React Native persistence modules from
-   * `@tanstack/react-native-db-sqlite-persistence` plus `createCollection`.
-   * Pass the imported bindings directly, or a function to delay native SQLite.
-   */
-  modules: ModulesInput<ReactNativeEventSourcedModules>;
-};
-/**
- * React Native–flavoured event-sourced DB, returned as a lazy singleton.
- *
- * @param config - See {@link ReactNativeEventSourcedDBConfig} for every option.
- *
- * @example
- * ```ts
- * import { createReactNativeEventSourcedDB } from "event-sourced-collection/react-native"
- *
- * const { ensureDb, db } = createReactNativeEventSourcedDB({
- *   collections: { todos: { getKey: (todo: { id: string }) => todo.id } },
- *   modules: async () => {
- *     const { createCollection } = await import("@tanstack/react-native-db")
- *     const { createReactNativeSQLitePersistence, persistedCollectionOptions } =
- *       await import("@tanstack/react-native-db-sqlite-persistence")
- *     const { openDatabase } = await import("react-native-op-sqlite")
- *     return {
- *       createCollection,
- *       createReactNativeSQLitePersistence,
- *       persistedCollectionOptions,
- *       database: openDatabase({ name: "app.sqlite" }),
- *     }
- *   },
- * })
- *
- * await ensureDb()
- * ```
- */
-declare function createReactNativeEventSourcedDB<const TDefs extends Record<string, CollectionDefConstraint>>(config: ReactNativeEventSourcedDBConfig<TDefs>): EventSourcedDBHandle<TDefs>;
-//#endregion
 export { type ReactNativeEventSourcedDBConfig, type EventSourcedDBHandle as ReactNativeEventSourcedDBHandle, type ReactNativeEventSourcedModules, type ReactNativePlatformConfig, type ReactNativePlatformDeps, type ReactNativePlatformResult, createReactNativeEventSourcedDB, createReactNativePlatform };
 //# sourceMappingURL=react-native.d.mts.map

package/dist/react-native.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"react-native.d.mts","names":[],"sources":["../src/platforms/react-native.ts","../src/platforms/react-native-event-sourced-db.ts"],"mappings":";;;;KAEY,uBAAA;EACV,kCAAA,GAAqC,OAAA;IACnC,QAAA;EAAA,MACI,8BAA8B;AAAA;AAAA,KAG1B,yBAAA;EACV,QAAQ;AAAA;AAAA,KAGE,yBAAA;EACV,WAAA,EAAa,8BAA8B;AAAA;;;AARP;AAGtC;;;;AACU;AAGV;;;;AAC6C;AAgC7C;;;;;;;;;;;;;;AAG4B;;iBAHZ,yBAAA,CACd,IAAA,EAAM,uBAAA,EACN,MAAA,EAAQ,yBAAA,GACP,yBAAA;;;KClCE,uBAAA;EACH,MAAA,GAAS,KAAY;AAAA;AAAA,KAGX,8BAAA;EACV,kCAAA,GAAqC,OAAA;IACnC,QAAA;EAAA,MACI,8BAAA,EDjBJ;ECmBF,QAAA;EACA,gBAAA,EAAkB,wBAAA;EAClB,0BAAA,EAA4B,gBAAA;AAAA;ADjB9B;;;;AACU;AADV,KCyBY,+BAAA,eAA8C,MAAA,SAAe,uBAAA,KACvE,yBAAA;EACE,WAAA,EAAa,KAAA;;;ADtB4B;AAgC7C;;ECJI,OAAA,EAAS,YAAA,CAAa,8BAAA;AAAA;;;;;;;;;;ADOE;;;;ACrCmE;;;;AAIxE;AAGvB;;;;;;;;;;iBAwDgB,+BAAA,qBACM,MAAA,SAAe,uBAAA,GACnC,MAAA,EAAQ,+BAAA,CAAgC,KAAA,IAAM,oBAAA,CAAA,KAAA"}
+{"version":3,"file":"react-native.d.mts","names":[],"sources":["../src/platforms/react-native.ts"],"mappings":";;;;;KAEY,uBAAA;EACV,kCAAA,GAAqC,OAAA;IACnC,QAAA;EAAA,MACI,8BAA8B;AAAA;AAAA,KAG1B,yBAAA;EACV,QAAQ;AAAA;AAAA,KAGE,yBAAA;EACV,WAAA,EAAa,8BAA8B;AAAA;;;AARP;AAGtC;;;;AACU;AAGV;;;;AAC6C;AAgC7C;;;;;;;;;;;;;;AAG4B;;iBAHZ,yBAAA,CACd,IAAA,EAAM,uBAAA,EACN,MAAA,EAAQ,yBAAA,GACP,yBAAA"}

package/dist/react.d.mts

@@ -1,8 +1,55 @@
-import { _ as ManualSyncResult } from "./types-BSdudVLh.mjs";
+import { V as SyncStatus, _ as ManualSyncResult } from "./types-BSdudVLh.mjs";
 
 //#region src/react/format-manual-sync-message.d.ts
 declare function formatManualSyncMessage(result: ManualSyncResult): string;
 //#endregion
+//#region src/react/use-ensure-db.d.ts
+type UseEnsureDbOptions<TDb> = {
+  /** Lazy singleton opener from `createBrowserEventSourcedDB` / platform helpers. */ensureDb: () => Promise<TDb>;
+  /**
+   * Re-run init when these change (e.g. `[isAuthenticated]`).
+   * `ensureDb` itself stays idempotent; use this to re-apply app gates.
+   */
+  deps?: ReadonlyArray<unknown>;
+  /**
+   * After OPFS/SQLite is ready. Use for settings gates, `setSyncEnabled`,
+   * fire-and-forget `db.sync()`, e2e handles, etc. Errors here fail the hook.
+   */
+  onReady?: (db: TDb) => void | Promise<void>;
+};
+type UseEnsureDbResult = {
+  ready: false;
+  error: null;
+} | {
+  ready: false;
+  error: Error;
+} | {
+  ready: true;
+  error: null;
+};
+/**
+ * Browser-safe `ensureDb()` for React: runs in `useEffect`, exposes ready/error.
+ *
+ * Does not know about auth or settings — pass those through `onReady` / `deps`.
+ *
+ * @example
+ * ```tsx
+ * const { ready, error } = useEnsureDb({
+ *   ensureDb,
+ *   deps: [isAuthenticated],
+ *   onReady: (db) => {
+ *     db.setSyncEnabled(isAuthenticated && settings.syncEnabled)
+ *     if (db.getSyncEnabled()) void db.sync()
+ *   },
+ * })
+ * ```
+ */
+declare function useEnsureDb<TDb>({
+  ensureDb,
+  deps,
+  onReady
+}: UseEnsureDbOptions<TDb>): UseEnsureDbResult;
+//#endregion
 //#region src/react/settings-collection.d.ts
 type SettingsRow = {
   syncEnabled?: boolean;
@@ -19,35 +66,74 @@ type DbWithSettings = {
   };
 };
 //#endregion
+//#region src/react/use-sync-status.d.ts
+/**
+ * Minimal DB surface needed for sync status. Accepts the full
+ * {@link import("../core/types").EventSourcedDB} or a test double.
+ */
+type SyncStatusSource = {
+  getSyncStatus: () => SyncStatus;
+  subscribeSyncStatus: (listener: (status: SyncStatus) => void) => () => void;
+};
+/**
+ * Live {@link SyncStatus} for spinners, badges, and pending counts.
+ *
+ * `getSyncStatus()` alone is a snapshot — it will go stale in React. Always
+ * subscribe (this hook, or `db.subscribeSyncStatus` directly).
+ *
+ * @example
+ * ```tsx
+ * import { useSyncStatus } from "event-sourced-collection/react"
+ *
+ * function SyncBadge({ db }: { db: SyncStatusSource }) {
+ *   const { isSyncing, pendingCount } = useSyncStatus(db)
+ *   if (isSyncing) return <Spinner />
+ *   return <span>{pendingCount} pending</span>
+ * }
+ * ```
+ */
+declare function useSyncStatus(db: SyncStatusSource): SyncStatus;
+//#endregion
 //#region src/react/use-manual-sync.d.ts
 type UseManualSyncOptions = {
   /** When false, skips reading settings and treats sync as enabled. */enabled?: boolean;
   settingsId: string;
-  ensureDb: () => Promise<DbWithSettings>; /** Typically `() => ensureDb().then((db) => db.manualSync())`. */
+  ensureDb: () => Promise<DbWithSettings>; /** Typically `() => db.manualSync()` or `() => ensureDb().then((d) => d.manualSync())`. */
   sync: () => Promise<ManualSyncResult>;
   disabledMessage?: string;
+  /**
+   * Live DB handle. When set, `syncing` follows {@link SyncStatusSource.subscribeSyncStatus}
+   * so the button tracks load sync, background sync, and this `runSync` call.
+   *
+   * When omitted, `syncing` is only true while `runSync` is awaiting (legacy).
+   */
+  db?: SyncStatusSource;
 };
 type UseManualSyncReturn = {
-  syncEnabled: boolean;
+  syncEnabled: boolean; /** True while any sync is in flight when `db` was passed; otherwise only during `runSync`. */
   syncing: boolean;
   syncMessage: string | null;
   /**
-   * Runs the sync callback, updates `syncing` / `syncMessage`, and returns the
-   * raw result on success (including results that contain `errors`).
+   * Runs the sync callback, updates `syncMessage`, and returns the raw result
+   * on success (including results that contain `errors`).
    * Returns `undefined` when sync is disabled or the callback throws.
    */
   runSync: () => Promise<ManualSyncResult | undefined>;
 };
 /**
- * Encapsulates settings-gated manual sync UI state so callers don't format
- * `ManualSyncResult` themselves.
+ * Settings-gated manual sync UI helper.
+ *
+ * Prefer passing `db` so `syncing` shares the same global tracker as
+ * {@link import("./use-sync-status").useSyncStatus} — then a load-time
+ * `db.sync()` also disables the button / shows a spinner.
  */
 declare function useManualSync({
   enabled,
   settingsId,
   ensureDb,
   sync,
-  disabledMessage
+  disabledMessage,
+  db
 }: UseManualSyncOptions): UseManualSyncReturn;
 //#endregion
 //#region src/react/use-sync-enabled.d.ts
@@ -65,5 +151,5 @@ declare function useSyncEnabled({
   ensureDb
 }: UseSyncEnabledOptions): boolean;
 //#endregion
-export { type DbWithSettings, type SettingsCollectionLike, type SettingsRow, type UseManualSyncOptions, type UseManualSyncReturn, type UseSyncEnabledOptions, formatManualSyncMessage, useManualSync, useSyncEnabled };
+export { type DbWithSettings, type SettingsCollectionLike, type SettingsRow, type SyncStatusSource, type UseEnsureDbOptions, type UseEnsureDbResult, type UseManualSyncOptions, type UseManualSyncReturn, type UseSyncEnabledOptions, formatManualSyncMessage, useEnsureDb, useManualSync, useSyncEnabled, useSyncStatus };
 //# sourceMappingURL=react.d.mts.map

package/dist/react.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"react.d.mts","names":[],"sources":["../src/react/format-manual-sync-message.ts","../src/react/settings-collection.ts","../src/react/use-manual-sync.ts","../src/react/use-sync-enabled.ts"],"mappings":";;;iBAEgB,uBAAA,CAAwB,MAAwB,EAAhB,gBAAgB;;;KCFpD,WAAA;EACV,WAAW;AAAA;AAAA,KAGD,sBAAA;EACV,GAAA,GAAM,EAAA,aAAe,WAAW;EAChC,gBAAA,GAAmB,QAAA;IAA2B,WAAA;EAAA;AAAA;AAAA,KAGpC,cAAA;EACV,WAAA;IACE,QAAA,EAAU,sBAAsB;EAAA;AAAA;;;KCJxB,oBAAA;EFLI,qEEOd,OAAA;EACA,UAAA;EACA,QAAA,QAAgB,OAAA,CAAQ,cAAA,GFTsC;EEW9D,IAAA,QAAY,OAAA,CAAQ,gBAAA;EACpB,eAAA;AAAA;AAAA,KAGU,mBAAA;EACV,WAAA;EACA,OAAA;EACA,WAAA;EDnBW;AAGb;;;;ECsBE,OAAA,QAAe,OAAO,CAAC,gBAAA;AAAA;;;;;iBAST,aAAA;EACd,OAAA;EACA,UAAA;EACA,QAAA;EACA,IAAA;EACA;AAAA,GACC,oBAAA,GAAuB,mBAAA;;;KCrCd,qBAAA;+DAEV,OAAA;EACA,UAAA;EACA,QAAA,QAAgB,OAAO,CAAC,cAAA;AAAA;AHNsC;;;AAAA,iBGYhD,cAAA;EACd,OAAA;EACA,UAAA;EACA;AAAA,GACC,qBAAA"}
+{"version":3,"file":"react.d.mts","names":[],"sources":["../src/react/format-manual-sync-message.ts","../src/react/use-ensure-db.ts","../src/react/settings-collection.ts","../src/react/use-sync-status.ts","../src/react/use-manual-sync.ts","../src/react/use-sync-enabled.ts"],"mappings":";;;iBAEgB,uBAAA,CAAwB,MAAwB,EAAhB,gBAAgB;;;KCApD,kBAAA;qFAEV,QAAA,QAAgB,OAAA,CAAQ,GAAA;EDFV;;;;ECOd,IAAA,GAAO,aAAA;;;;AAPT;EAYE,OAAA,IAAW,EAAA,EAAI,GAAA,YAAe,OAAA;AAAA;AAAA,KAGpB,iBAAA;EACN,KAAA;EAAc,KAAA;AAAA;EACd,KAAA;EAAc,KAAA,EAAO,KAAK;AAAA;EAC1B,KAAA;EAAa,KAAA;AAAA;;;;;;;;;AANoB;AAGvC;;;;;;;;iBAsBgB,WAAA;EACd,QAAA;EACA,IAAA;EACA;AAAA,GACC,kBAAA,CAAmB,GAAA,IAAO,iBAAA;;;KC3CjB,WAAA;EACV,WAAW;AAAA;AAAA,KAGD,sBAAA;EACV,GAAA,GAAM,EAAA,aAAe,WAAW;EAChC,gBAAA,GAAmB,QAAA;IAA2B,WAAA;EAAA;AAAA;AAAA,KAGpC,cAAA;EACV,WAAA;IACE,QAAA,EAAU,sBAAsB;EAAA;AAAA;;;;;AFTpC;;KGMY,gBAAA;EACV,aAAA,QAAqB,UAAA;EACrB,mBAAA,GAAsB,QAAA,GAAW,MAAA,EAAQ,UAAU;AAAA;;;AFRrD;;;;;;;;;;;;;;;iBE4BgB,aAAA,CAAc,EAAA,EAAI,gBAAA,GAAmB,UAAU;;;KCtBnD,oBAAA;EJN2B,qEIQrC,OAAA;EACA,UAAA;EACA,QAAA,QAAgB,OAAA,CAAQ,cAAA;EAExB,IAAA,QAAY,OAAA,CAAQ,gBAAA;EACpB,eAAA;EHbU;;;;;;EGoBV,EAAA,GAAK,gBAAA;AAAA;AAAA,KAGK,mBAAA;EACV,WAAA,WHxB6B;EG0B7B,OAAA;EACA,WAAA;EHzBwB;;;;;EG+BxB,OAAA,QAAe,OAAO,CAAC,gBAAA;AAAA;;AHrBc;AAGvC;;;;;iBG8BgB,aAAA;EACd,OAAA;EACA,UAAA;EACA,QAAA;EACA,IAAA;EACA,eAAA;EACA;AAAA,GACC,oBAAA,GAAuB,mBAAA;;;KClDd,qBAAA;+DAEV,OAAA;EACA,UAAA;EACA,QAAA,QAAgB,OAAO,CAAC,cAAA;AAAA;ALNsC;;;AAAA,iBKYhD,cAAA;EACd,OAAA;EACA,UAAA;EACA;AAAA,GACC,qBAAA"}

package/dist/react.mjs

@@ -9,6 +9,58 @@ function formatManualSyncMessage(result) {
 	return parts.join(" ");
 }
 //#endregion
+//#region src/react/use-ensure-db.ts
+/**
+* Browser-safe `ensureDb()` for React: runs in `useEffect`, exposes ready/error.
+*
+* Does not know about auth or settings — pass those through `onReady` / `deps`.
+*
+* @example
+* ```tsx
+* const { ready, error } = useEnsureDb({
+*   ensureDb,
+*   deps: [isAuthenticated],
+*   onReady: (db) => {
+*     db.setSyncEnabled(isAuthenticated && settings.syncEnabled)
+*     if (db.getSyncEnabled()) void db.sync()
+*   },
+* })
+* ```
+*/
+function useEnsureDb({ ensureDb, deps = [], onReady }) {
+	const [ready, setReady] = useState(false);
+	const [error, setError] = useState(null);
+	useEffect(() => {
+		let cancelled = false;
+		ensureDb().then(async (db) => {
+			if (cancelled) return;
+			if (onReady) await onReady(db);
+			if (cancelled) return;
+			setReady(true);
+			setError(null);
+		}).catch((err) => {
+			if (cancelled) return;
+			setReady(false);
+			setError(err instanceof Error ? err : new Error(String(err)));
+		});
+		return () => {
+			cancelled = true;
+		};
+	}, deps);
+	if (error) return {
+		ready: false,
+		error
+	};
+	if (!ready) return {
+		ready: false,
+		error: null
+	};
+	return {
+		ready: true,
+		error: null
+	};
+}
+//#endregion
 //#region src/react/use-sync-enabled.ts
 /**
 * Live-reads `settings.syncEnabled` for the given settings row id.
@@ -43,27 +95,40 @@ function useSyncEnabled({ enabled = true, settingsId, ensureDb }) {
 //#region src/react/use-manual-sync.ts
 const DEFAULT_DISABLED_MESSAGE = "Sync is disabled in Settings.";
 /**
-* Encapsulates settings-gated manual sync UI state so callers don't format
-* `ManualSyncResult` themselves.
+* Settings-gated manual sync UI helper.
+*
+* Prefer passing `db` so `syncing` shares the same global tracker as
+* {@link import("./use-sync-status").useSyncStatus} — then a load-time
+* `db.sync()` also disables the button / shows a spinner.
 */
-function useManualSync({ enabled = true, settingsId, ensureDb, sync, disabledMessage = DEFAULT_DISABLED_MESSAGE }) {
+function useManualSync({ enabled = true, settingsId, ensureDb, sync, disabledMessage = DEFAULT_DISABLED_MESSAGE, db }) {
 	const syncEnabled = useSyncEnabled({
 		enabled,
 		settingsId,
 		ensureDb
 	});
-	const [syncing, setSyncing] = useState(false);
+	const [legacySyncing, setLegacySyncing] = useState(false);
+	const [liveSyncing, setLiveSyncing] = useState(() => db?.getSyncStatus().isSyncing ?? false);
 	const [syncMessage, setSyncMessage] = useState(null);
+	useEffect(() => {
+		if (!db) {
+			setLiveSyncing(false);
+			return;
+		}
+		return db.subscribeSyncStatus((status) => {
+			setLiveSyncing(status.isSyncing);
+		});
+	}, [db]);
 	return {
 		syncEnabled,
-		syncing,
+		syncing: db ? liveSyncing : legacySyncing,
 		syncMessage,
 		runSync: useCallback(async () => {
 			if (!syncEnabled) {
 				setSyncMessage(disabledMessage);
 				return;
 			}
-			setSyncing(true);
+			if (!db) setLegacySyncing(true);
 			setSyncMessage(null);
 			try {
 				const result = await sync();
@@ -73,9 +138,10 @@ function useManualSync({ enabled = true, settingsId, ensureDb, sync, disabledMes
 				setSyncMessage(error instanceof Error ? error.message : "Sync failed");
 				return;
 			} finally {
-				setSyncing(false);
+				if (!db) setLegacySyncing(false);
 			}
 		}, [
+			db,
 			disabledMessage,
 			sync,
 			syncEnabled
@@ -83,6 +149,30 @@ function useManualSync({ enabled = true, settingsId, ensureDb, sync, disabledMes
 	};
 }
 //#endregion
-export { formatManualSyncMessage, useManualSync, useSyncEnabled };
+//#region src/react/use-sync-status.ts
+/**
+* Live {@link SyncStatus} for spinners, badges, and pending counts.
+*
+* `getSyncStatus()` alone is a snapshot — it will go stale in React. Always
+* subscribe (this hook, or `db.subscribeSyncStatus` directly).
+*
+* @example
+* ```tsx
+* import { useSyncStatus } from "event-sourced-collection/react"
+*
+* function SyncBadge({ db }: { db: SyncStatusSource }) {
+*   const { isSyncing, pendingCount } = useSyncStatus(db)
+*   if (isSyncing) return <Spinner />
+*   return <span>{pendingCount} pending</span>
+* }
+* ```
+*/
+function useSyncStatus(db) {
+	const [status, setStatus] = useState(() => db.getSyncStatus());
+	useEffect(() => db.subscribeSyncStatus(setStatus), [db]);
+	return status;
+}
+//#endregion
+export { formatManualSyncMessage, useEnsureDb, useManualSync, useSyncEnabled, useSyncStatus };
 
 //# sourceMappingURL=react.mjs.map

package/dist/react.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"react.mjs","names":[],"sources":["../src/react/format-manual-sync-message.ts","../src/react/use-sync-enabled.ts","../src/react/use-manual-sync.ts"],"sourcesContent":["import type { ManualSyncResult } from \"../core/types\";\n\nexport function formatManualSyncMessage(result: ManualSyncResult): string {\n  if (result.errors.length > 0) {\n    return `Sync failed: ${result.errors[0]?.message ?? \"Unknown error\"}`;\n  }\n\n  if (result.deferred) {\n    return \"Another tab is already syncing.\";\n  }\n\n  const parts = [\n    `Pushed ${result.pushed}, pulled ${result.pulled}, replayed ${result.replayed} inbox event(s).`,\n  ];\n\n  if (result.skipped > 0) {\n    parts.push(`Skipped ${result.skipped} unrecognized event(s).`);\n  }\n\n  if (result.deadLettered > 0) {\n    parts.push(`Moved ${result.deadLettered} rejected event(s) to the dead-letter queue.`);\n  }\n\n  return parts.join(\" \");\n}\n","import { useEffect, useState } from \"react\";\n\nimport type { DbWithSettings } from \"./settings-collection\";\n\nexport type UseSyncEnabledOptions = {\n  /** When false, skips reading settings and returns `true`. */\n  enabled?: boolean;\n  settingsId: string;\n  ensureDb: () => Promise<DbWithSettings>;\n};\n\n/**\n * Live-reads `settings.syncEnabled` for the given settings row id.\n */\nexport function useSyncEnabled({\n  enabled = true,\n  settingsId,\n  ensureDb,\n}: UseSyncEnabledOptions): boolean {\n  const [syncEnabled, setSyncEnabled] = useState(true);\n\n  useEffect(() => {\n    if (!enabled) {\n      return;\n    }\n\n    let cancelled = false;\n    let subscription: { unsubscribe: () => void } | undefined;\n\n    void ensureDb().then((database) => {\n      if (cancelled) {\n        return;\n      }\n\n      const read = () => {\n        const setting = database.collections.settings.get(settingsId);\n        setSyncEnabled(setting?.syncEnabled ?? true);\n      };\n\n      read();\n      subscription = database.collections.settings.subscribeChanges(read);\n    });\n\n    return () => {\n      cancelled = true;\n      subscription?.unsubscribe();\n    };\n  }, [enabled, ensureDb, settingsId]);\n\n  if (!enabled) {\n    return true;\n  }\n\n  return syncEnabled;\n}\n","import { useCallback, useState } from \"react\";\n\nimport type { ManualSyncResult } from \"../core/types\";\nimport { formatManualSyncMessage } from \"./format-manual-sync-message\";\nimport type { DbWithSettings } from \"./settings-collection\";\nimport { useSyncEnabled } from \"./use-sync-enabled\";\n\nexport type UseManualSyncOptions = {\n  /** When false, skips reading settings and treats sync as enabled. */\n  enabled?: boolean;\n  settingsId: string;\n  ensureDb: () => Promise<DbWithSettings>;\n  /** Typically `() => ensureDb().then((db) => db.manualSync())`. */\n  sync: () => Promise<ManualSyncResult>;\n  disabledMessage?: string;\n};\n\nexport type UseManualSyncReturn = {\n  syncEnabled: boolean;\n  syncing: boolean;\n  syncMessage: string | null;\n  /**\n   * Runs the sync callback, updates `syncing` / `syncMessage`, and returns the\n   * raw result on success (including results that contain `errors`).\n   * Returns `undefined` when sync is disabled or the callback throws.\n   */\n  runSync: () => Promise<ManualSyncResult | undefined>;\n};\n\nconst DEFAULT_DISABLED_MESSAGE = \"Sync is disabled in Settings.\";\n\n/**\n * Encapsulates settings-gated manual sync UI state so callers don't format\n * `ManualSyncResult` themselves.\n */\nexport function useManualSync({\n  enabled = true,\n  settingsId,\n  ensureDb,\n  sync,\n  disabledMessage = DEFAULT_DISABLED_MESSAGE,\n}: UseManualSyncOptions): UseManualSyncReturn {\n  const syncEnabled = useSyncEnabled({ enabled, settingsId, ensureDb });\n  const [syncing, setSyncing] = useState(false);\n  const [syncMessage, setSyncMessage] = useState<string | null>(null);\n\n  const runSync = useCallback(async (): Promise<ManualSyncResult | undefined> => {\n    if (!syncEnabled) {\n      setSyncMessage(disabledMessage);\n      return undefined;\n    }\n\n    setSyncing(true);\n    setSyncMessage(null);\n\n    try {\n      const result = await sync();\n      setSyncMessage(formatManualSyncMessage(result));\n      return result;\n    } catch (error) {\n      setSyncMessage(error instanceof Error ? error.message : \"Sync failed\");\n      return undefined;\n    } finally {\n      setSyncing(false);\n    }\n  }, [disabledMessage, sync, syncEnabled]);\n\n  return {\n    syncEnabled,\n    syncing,\n    syncMessage,\n    runSync,\n  };\n}\n"],"mappings":";;AAEA,SAAgB,wBAAwB,QAAkC;CACxE,IAAI,OAAO,OAAO,SAAS,GACzB,OAAO,gBAAgB,OAAO,OAAO,EAAE,EAAE,WAAW;CAGtD,IAAI,OAAO,UACT,OAAO;CAGT,MAAM,QAAQ,CACZ,UAAU,OAAO,OAAO,WAAW,OAAO,OAAO,aAAa,OAAO,SAAS,iBAChF;CAEA,IAAI,OAAO,UAAU,GACnB,MAAM,KAAK,WAAW,OAAO,QAAQ,wBAAwB;CAG/D,IAAI,OAAO,eAAe,GACxB,MAAM,KAAK,SAAS,OAAO,aAAa,6CAA6C;CAGvF,OAAO,MAAM,KAAK,GAAG;AACvB;;;;;;ACVA,SAAgB,eAAe,EAC7B,UAAU,MACV,YACA,YACiC;CACjC,MAAM,CAAC,aAAa,kBAAkB,SAAS,IAAI;CAEnD,gBAAgB;EACd,IAAI,CAAC,SACH;EAGF,IAAI,YAAY;EAChB,IAAI;EAEJ,SAAc,CAAC,CAAC,MAAM,aAAa;GACjC,IAAI,WACF;GAGF,MAAM,aAAa;IAEjB,eADgB,SAAS,YAAY,SAAS,IAAI,UAC7B,CAAC,EAAE,eAAe,IAAI;GAC7C;GAEA,KAAK;GACL,eAAe,SAAS,YAAY,SAAS,iBAAiB,IAAI;EACpE,CAAC;EAED,aAAa;GACX,YAAY;GACZ,cAAc,YAAY;EAC5B;CACF,GAAG;EAAC;EAAS;EAAU;CAAU,CAAC;CAElC,IAAI,CAAC,SACH,OAAO;CAGT,OAAO;AACT;;;ACzBA,MAAM,2BAA2B;;;;;AAMjC,SAAgB,cAAc,EAC5B,UAAU,MACV,YACA,UACA,MACA,kBAAkB,4BAC0B;CAC5C,MAAM,cAAc,eAAe;EAAE;EAAS;EAAY;CAAS,CAAC;CACpE,MAAM,CAAC,SAAS,cAAc,SAAS,KAAK;CAC5C,MAAM,CAAC,aAAa,kBAAkB,SAAwB,IAAI;CAuBlE,OAAO;EACL;EACA;EACA;EACA,SAzBc,YAAY,YAAmD;GAC7E,IAAI,CAAC,aAAa;IAChB,eAAe,eAAe;IAC9B;GACF;GAEA,WAAW,IAAI;GACf,eAAe,IAAI;GAEnB,IAAI;IACF,MAAM,SAAS,MAAM,KAAK;IAC1B,eAAe,wBAAwB,MAAM,CAAC;IAC9C,OAAO;GACT,SAAS,OAAO;IACd,eAAe,iBAAiB,QAAQ,MAAM,UAAU,aAAa;IACrE;GACF,UAAU;IACR,WAAW,KAAK;GAClB;EACF,GAAG;GAAC;GAAiB;GAAM;EAAW,CAM9B;CACR;AACF"}
+{"version":3,"file":"react.mjs","names":[],"sources":["../src/react/format-manual-sync-message.ts","../src/react/use-ensure-db.ts","../src/react/use-sync-enabled.ts","../src/react/use-manual-sync.ts","../src/react/use-sync-status.ts"],"sourcesContent":["import type { ManualSyncResult } from \"../core/types\";\n\nexport function formatManualSyncMessage(result: ManualSyncResult): string {\n  if (result.errors.length > 0) {\n    return `Sync failed: ${result.errors[0]?.message ?? \"Unknown error\"}`;\n  }\n\n  if (result.deferred) {\n    return \"Another tab is already syncing.\";\n  }\n\n  const parts = [\n    `Pushed ${result.pushed}, pulled ${result.pulled}, replayed ${result.replayed} inbox event(s).`,\n  ];\n\n  if (result.skipped > 0) {\n    parts.push(`Skipped ${result.skipped} unrecognized event(s).`);\n  }\n\n  if (result.deadLettered > 0) {\n    parts.push(`Moved ${result.deadLettered} rejected event(s) to the dead-letter queue.`);\n  }\n\n  return parts.join(\" \");\n}\n","import { useEffect, useState } from \"react\";\n\nexport type UseEnsureDbOptions<TDb> = {\n  /** Lazy singleton opener from `createBrowserEventSourcedDB` / platform helpers. */\n  ensureDb: () => Promise<TDb>;\n  /**\n   * Re-run init when these change (e.g. `[isAuthenticated]`).\n   * `ensureDb` itself stays idempotent; use this to re-apply app gates.\n   */\n  deps?: ReadonlyArray<unknown>;\n  /**\n   * After OPFS/SQLite is ready. Use for settings gates, `setSyncEnabled`,\n   * fire-and-forget `db.sync()`, e2e handles, etc. Errors here fail the hook.\n   */\n  onReady?: (db: TDb) => void | Promise<void>;\n};\n\nexport type UseEnsureDbResult =\n  | { ready: false; error: null }\n  | { ready: false; error: Error }\n  | { ready: true; error: null };\n\n/**\n * Browser-safe `ensureDb()` for React: runs in `useEffect`, exposes ready/error.\n *\n * Does not know about auth or settings — pass those through `onReady` / `deps`.\n *\n * @example\n * ```tsx\n * const { ready, error } = useEnsureDb({\n *   ensureDb,\n *   deps: [isAuthenticated],\n *   onReady: (db) => {\n *     db.setSyncEnabled(isAuthenticated && settings.syncEnabled)\n *     if (db.getSyncEnabled()) void db.sync()\n *   },\n * })\n * ```\n */\nexport function useEnsureDb<TDb>({\n  ensureDb,\n  deps = [],\n  onReady,\n}: UseEnsureDbOptions<TDb>): UseEnsureDbResult {\n  const [ready, setReady] = useState(false);\n  const [error, setError] = useState<Error | null>(null);\n\n  useEffect(() => {\n    let cancelled = false;\n\n    ensureDb()\n      .then(async (db) => {\n        if (cancelled) return;\n        if (onReady) await onReady(db);\n        if (cancelled) return;\n        setReady(true);\n        setError(null);\n      })\n      .catch((err: unknown) => {\n        if (cancelled) return;\n        setReady(false);\n        setError(err instanceof Error ? err : new Error(String(err)));\n      });\n\n    return () => {\n      cancelled = true;\n    };\n    // Caller owns stability of ensureDb / onReady; deps drive re-init.\n    // eslint-disable-next-line react-hooks/exhaustive-deps -- intentional deps array API\n  }, deps);\n\n  if (error) return { ready: false, error };\n  if (!ready) return { ready: false, error: null };\n  return { ready: true, error: null };\n}\n","import { useEffect, useState } from \"react\";\n\nimport type { DbWithSettings } from \"./settings-collection\";\n\nexport type UseSyncEnabledOptions = {\n  /** When false, skips reading settings and returns `true`. */\n  enabled?: boolean;\n  settingsId: string;\n  ensureDb: () => Promise<DbWithSettings>;\n};\n\n/**\n * Live-reads `settings.syncEnabled` for the given settings row id.\n */\nexport function useSyncEnabled({\n  enabled = true,\n  settingsId,\n  ensureDb,\n}: UseSyncEnabledOptions): boolean {\n  const [syncEnabled, setSyncEnabled] = useState(true);\n\n  useEffect(() => {\n    if (!enabled) {\n      return;\n    }\n\n    let cancelled = false;\n    let subscription: { unsubscribe: () => void } | undefined;\n\n    void ensureDb().then((database) => {\n      if (cancelled) {\n        return;\n      }\n\n      const read = () => {\n        const setting = database.collections.settings.get(settingsId);\n        setSyncEnabled(setting?.syncEnabled ?? true);\n      };\n\n      read();\n      subscription = database.collections.settings.subscribeChanges(read);\n    });\n\n    return () => {\n      cancelled = true;\n      subscription?.unsubscribe();\n    };\n  }, [enabled, ensureDb, settingsId]);\n\n  if (!enabled) {\n    return true;\n  }\n\n  return syncEnabled;\n}\n","import { useCallback, useEffect, useState } from \"react\";\n\nimport type { ManualSyncResult } from \"../core/types\";\nimport { formatManualSyncMessage } from \"./format-manual-sync-message\";\nimport type { DbWithSettings } from \"./settings-collection\";\nimport type { SyncStatusSource } from \"./use-sync-status\";\nimport { useSyncEnabled } from \"./use-sync-enabled\";\n\nexport type UseManualSyncOptions = {\n  /** When false, skips reading settings and treats sync as enabled. */\n  enabled?: boolean;\n  settingsId: string;\n  ensureDb: () => Promise<DbWithSettings>;\n  /** Typically `() => db.manualSync()` or `() => ensureDb().then((d) => d.manualSync())`. */\n  sync: () => Promise<ManualSyncResult>;\n  disabledMessage?: string;\n  /**\n   * Live DB handle. When set, `syncing` follows {@link SyncStatusSource.subscribeSyncStatus}\n   * so the button tracks load sync, background sync, and this `runSync` call.\n   *\n   * When omitted, `syncing` is only true while `runSync` is awaiting (legacy).\n   */\n  db?: SyncStatusSource;\n};\n\nexport type UseManualSyncReturn = {\n  syncEnabled: boolean;\n  /** True while any sync is in flight when `db` was passed; otherwise only during `runSync`. */\n  syncing: boolean;\n  syncMessage: string | null;\n  /**\n   * Runs the sync callback, updates `syncMessage`, and returns the raw result\n   * on success (including results that contain `errors`).\n   * Returns `undefined` when sync is disabled or the callback throws.\n   */\n  runSync: () => Promise<ManualSyncResult | undefined>;\n};\n\nconst DEFAULT_DISABLED_MESSAGE = \"Sync is disabled in Settings.\";\n\n/**\n * Settings-gated manual sync UI helper.\n *\n * Prefer passing `db` so `syncing` shares the same global tracker as\n * {@link import(\"./use-sync-status\").useSyncStatus} — then a load-time\n * `db.sync()` also disables the button / shows a spinner.\n */\nexport function useManualSync({\n  enabled = true,\n  settingsId,\n  ensureDb,\n  sync,\n  disabledMessage = DEFAULT_DISABLED_MESSAGE,\n  db,\n}: UseManualSyncOptions): UseManualSyncReturn {\n  const syncEnabled = useSyncEnabled({ enabled, settingsId, ensureDb });\n  const [legacySyncing, setLegacySyncing] = useState(false);\n  const [liveSyncing, setLiveSyncing] = useState(() => db?.getSyncStatus().isSyncing ?? false);\n  const [syncMessage, setSyncMessage] = useState<string | null>(null);\n\n  useEffect(() => {\n    if (!db) {\n      setLiveSyncing(false);\n      return;\n    }\n    return db.subscribeSyncStatus((status) => {\n      setLiveSyncing(status.isSyncing);\n    });\n  }, [db]);\n\n  const syncing = db ? liveSyncing : legacySyncing;\n\n  const runSync = useCallback(async (): Promise<ManualSyncResult | undefined> => {\n    if (!syncEnabled) {\n      setSyncMessage(disabledMessage);\n      return undefined;\n    }\n\n    if (!db) setLegacySyncing(true);\n    setSyncMessage(null);\n\n    try {\n      const result = await sync();\n      setSyncMessage(formatManualSyncMessage(result));\n      return result;\n    } catch (error) {\n      setSyncMessage(error instanceof Error ? error.message : \"Sync failed\");\n      return undefined;\n    } finally {\n      if (!db) setLegacySyncing(false);\n    }\n  }, [db, disabledMessage, sync, syncEnabled]);\n\n  return {\n    syncEnabled,\n    syncing,\n    syncMessage,\n    runSync,\n  };\n}\n","import { useEffect, useState } from \"react\";\n\nimport type { SyncStatus } from \"../core/types\";\n\n/**\n * Minimal DB surface needed for sync status. Accepts the full\n * {@link import(\"../core/types\").EventSourcedDB} or a test double.\n */\nexport type SyncStatusSource = {\n  getSyncStatus: () => SyncStatus;\n  subscribeSyncStatus: (listener: (status: SyncStatus) => void) => () => void;\n};\n\n/**\n * Live {@link SyncStatus} for spinners, badges, and pending counts.\n *\n * `getSyncStatus()` alone is a snapshot — it will go stale in React. Always\n * subscribe (this hook, or `db.subscribeSyncStatus` directly).\n *\n * @example\n * ```tsx\n * import { useSyncStatus } from \"event-sourced-collection/react\"\n *\n * function SyncBadge({ db }: { db: SyncStatusSource }) {\n *   const { isSyncing, pendingCount } = useSyncStatus(db)\n *   if (isSyncing) return <Spinner />\n *   return <span>{pendingCount} pending</span>\n * }\n * ```\n */\nexport function useSyncStatus(db: SyncStatusSource): SyncStatus {\n  const [status, setStatus] = useState(() => db.getSyncStatus());\n\n  useEffect(() => db.subscribeSyncStatus(setStatus), [db]);\n\n  return status;\n}\n"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "event-sourced-collection",
-  "version": "0.0.8",
+  "version": "0.0.9",
   "description": "Event-sourced local-first database built on TanStack DB persistence",
   "keywords": [
     "event-sourcing",
@@ -44,12 +44,25 @@
     "access": "public",
     "registry": "https://registry.npmjs.org/"
   },
+  "scripts": {
+    "build": "tsdown",
+    "dev": "tsdown --watch",
+    "test": "vp test run",
+    "test:unit": "vp test run src/__tests__/unit",
+    "test:integration": "vp test run src/__tests__/integration",
+    "check-types": "tsgo --noEmit",
+    "prepublishOnly": "pnpm run build",
+    "check-exports": "attw --pack . --profile node16 --ignore-rules cjs-resolves-to-esm",
+    "postbuild": "npm run check-exports",
+    "release": "changeset publish --no-git-checks"
+  },
   "dependencies": {
     "uuidv7": "^1.2.1"
   },
   "devDependencies": {
     "@arethetypeswrong/cli": "^0.18.4",
     "@changesets/cli": "^2.31.0",
+    "@repo/typescript-config": "workspace:*",
     "@tanstack/browser-db-sqlite-persistence": "^0.2.12",
     "@tanstack/db": "^0.7.2",
     "@tanstack/db-sqlite-persistence-core": "^0.2.12",
@@ -60,11 +73,10 @@
     "better-sqlite3": "^13.0.3",
     "react": "^19.2.0",
     "tsdown": "^0.22.3",
-    "typescript": "6.0.3",
-    "vite": "npm:@voidzero-dev/vite-plus-core@latest",
-    "vite-plus": "latest",
-    "vitest": "^4.1.10",
-    "@repo/typescript-config": "0.0.0"
+    "typescript": "catalog:",
+    "vite": "catalog:",
+    "vite-plus": "catalog:",
+    "vitest": "catalog:"
   },
   "peerDependencies": {
     "@tanstack/browser-db-sqlite-persistence": ">=0.2.0",
@@ -94,16 +106,5 @@
   },
   "engines": {
     "node": ">=18"
-  },
-  "scripts": {
-    "build": "tsdown",
-    "dev": "tsdown --watch",
-    "test": "vp test run",
-    "test:unit": "vp test run src/__tests__/unit",
-    "test:integration": "vp test run src/__tests__/integration",
-    "check-types": "tsgo --noEmit",
-    "check-exports": "attw --pack . --profile node16 --ignore-rules cjs-resolves-to-esm",
-    "postbuild": "npm run check-exports",
-    "release": "changeset publish --no-git-checks"
   }
-}
+}

package/dist/browser-event-sourced-db-CCOAgE31.d.mts

@@ -1,121 +0,0 @@
-import { L as SyncLock, P as SQLiteDriver, Q as InjectedModuleFn, Z as InjectedCreateCollection, p as EventSourcedSharedOptions } from "./types-BSdudVLh.mjs";
-import { r as ModulesInput, t as EventSourcedDBHandle } from "./create-event-sourced-db-handle-BAos-9pS.mjs";
-import { PersistedCollectionPersistence } from "@tanstack/db-sqlite-persistence-core";
-
-//#region src/platforms/browser-wa-sqlite-driver.d.ts
-type BrowserWASQLiteDatabase = {
-  execute: <TRow = unknown>(sql: string, params?: ReadonlyArray<unknown>) => Promise<ReadonlyArray<TRow>>;
-  close?: () => Promise<void> | void;
-};
-//#endregion
-//#region src/platforms/browser-types.d.ts
-type BrowserCoordinatorInstance = {
-  dispose: () => void;
-};
-/**
- * Injected TanStack browser persistence bindings. Parameters are `never` so
- * version-skewed `@tanstack/browser-db-sqlite-persistence` exports stay assignable.
- */
-type BrowserPlatformDeps = {
-  openBrowserWASQLiteOPFSDatabase: (options: never) => Promise<BrowserWASQLiteDatabase>;
-  createBrowserWASQLitePersistence: (options: never) => PersistedCollectionPersistence;
-  BrowserCollectionCoordinator: new (options: never) => BrowserCoordinatorInstance;
-};
-type BrowserPlatformConfig = {
-  databaseName: string;
-  coordinatorDbName?: string;
-};
-type BrowserPlatformResult = {
-  driver: SQLiteDriver;
-  persistence: PersistedCollectionPersistence;
-  close: () => Promise<void>;
-};
-//#endregion
-//#region src/platforms/browser-event-sourced-db.d.ts
-type CollectionDefConstraint = {
-  getKey: (state: never) => string | number;
-};
-type BrowserEventSourcedModules = BrowserPlatformDeps & {
-  createCollection: InjectedCreateCollection;
-  persistedCollectionOptions: InjectedModuleFn;
-};
-/**
- * Browser entry-point config. Shared sync/lifecycle fields come from
- * {@link EventSourcedSharedOptions} (hover those properties for docs).
- * Deep guide: `docs/usage.md`.
- */
-type BrowserEventSourcedDBConfig<TDefs extends Record<string, CollectionDefConstraint>> = Omit<EventSourcedSharedOptions, "lock" | "lockName"> & {
-  /**
-   * User collection registry. Object keys become `db.collections.<key>` and
-   * the wire `collectionId`. Must not collide with reserved names.
-   */
-  collections: TDefs;
-  /**
-   * OPFS SQLite database file name (e.g. `"my-app.sqlite"`). Also used as the
-   * default sync lock namespace so only one tab syncs for this DB at a time.
-   */
-  databaseName: string;
-  /**
-   * Name for the cross-tab collection coordinator database. Defaults to
-   * `databaseName` with a trailing `.sqlite` stripped.
-   */
-  coordinatorDbName?: string;
-  /**
-   * Browser OPFS persistence modules from
-   * `@tanstack/browser-db-sqlite-persistence` plus `createCollection`.
-   * Pass the imported bindings directly, or a function to keep WASM off the
-   * critical path.
-   */
-  modules: ModulesInput<BrowserEventSourcedModules>;
-  /**
-   * Defaults to a Web Locks–backed lock so only one tab syncs at a time.
-   * Pass `null` to opt out and let every tab sync independently.
-   */
-  lock?: SyncLock | null;
-};
-/**
- * Browser-flavoured event-sourced DB: OPFS SQLite + optional Web Locks sync
- * election, returned as a lazy singleton.
- *
- * @param config - See {@link BrowserEventSourcedDBConfig} for every option.
- *
- * @example
- * ```ts
- * import { createBrowserEventSourcedDB } from "event-sourced-collection/browser"
- * import type { CollectionDef, EventSourcedDB } from "event-sourced-collection"
- *
- * type Todo = { id: string; title: string }
- * type Defs = { todos: CollectionDef<Todo, string> }
- *
- * const { ensureDb, db } = createBrowserEventSourcedDB<Defs>({
- *   databaseName: "app.sqlite",
- *   collections: { todos: { getKey: (todo) => todo.id } },
- *   sync: { push: "/api/sync/events", pull: "/api/sync/events" },
- *   modules: async () => {
- *     const { createCollection } = await import("@tanstack/db")
- *     const {
- *       BrowserCollectionCoordinator,
- *       createBrowserWASQLitePersistence,
- *       openBrowserWASQLiteOPFSDatabase,
- *       persistedCollectionOptions,
- *     } = await import("@tanstack/browser-db-sqlite-persistence")
- *     return {
- *       createCollection,
- *       BrowserCollectionCoordinator,
- *       createBrowserWASQLitePersistence,
- *       openBrowserWASQLiteOPFSDatabase,
- *       persistedCollectionOptions,
- *     }
- *   },
- * })
- *
- * export async function start() {
- *   await ensureDb()
- * }
- * export { db }
- * ```
- */
-declare function createBrowserEventSourcedDB<const TDefs extends Record<string, CollectionDefConstraint>>(config: BrowserEventSourcedDBConfig<TDefs>): EventSourcedDBHandle<TDefs>;
-//#endregion
-export { BrowserPlatformConfig as a, BrowserWASQLiteDatabase as c, BrowserCoordinatorInstance as i, BrowserEventSourcedModules as n, BrowserPlatformDeps as o, createBrowserEventSourcedDB as r, BrowserPlatformResult as s, BrowserEventSourcedDBConfig as t };
-//# sourceMappingURL=browser-event-sourced-db-CCOAgE31.d.mts.map

package/dist/browser-event-sourced-db-CCOAgE31.d.mts.map

@@ -1 +0,0 @@
-{"version":3,"file":"browser-event-sourced-db-CCOAgE31.d.mts","names":[],"sources":["../src/platforms/browser-wa-sqlite-driver.ts","../src/platforms/browser-types.ts","../src/platforms/browser-event-sourced-db.ts"],"mappings":";;;;;KAEY,uBAAA;EACV,OAAA,mBACE,GAAA,UACA,MAAA,GAAS,aAAA,cACN,OAAA,CAAQ,aAAA,CAAc,IAAA;EAC3B,KAAA,SAAc,OAAA;AAAA;;;KCJJ,0BAAA;EACV,OAAO;AAAA;ADFT;;;;AAAA,KCSY,mBAAA;EACV,+BAAA,GAAkC,OAAA,YAAmB,OAAA,CAAQ,uBAAA;EAC7D,gCAAA,GAAmC,OAAA,YAAmB,8BAAA;EACtD,4BAAA,OAAmC,OAAA,YAAmB,0BAAA;AAAA;AAAA,KAG5C,qBAAA;EACV,YAAA;EACA,iBAAiB;AAAA;AAAA,KAGP,qBAAA;EACV,MAAA,EAD+B,YAAA;EAE/B,WAAA,EAAa,8BAAA;EACb,KAAA,QAAa,OAAA;AAAA;;;KCTV,uBAAA;EACH,MAAA,GAAS,KAAY;AAAA;AAAA,KAGX,0BAAA,GAA6B,mBAAA;EACvC,gBAAA,EAAkB,wBAAA;EAClB,0BAAA,EAA4B,gBAAA;AAAA;;;;;;KAQlB,2BAAA,eAA0C,MAAA,SAAe,uBAAA,KACnE,IAAA,CAAK,yBAAA;EF3BH;;;;EEgCA,WAAA,EAAa,KAAA;EF9BY;;;;EEmCzB,YAAA;;;;ADtCJ;EC2CI,iBAAA;;;AD1CK;AAOT;;;EC0CI,OAAA,EAAS,YAAA,CAAa,0BAAA;EDzC6B;;;;EC8CnD,IAAA,GAAO,QAAA;AAAA;;;;;;;;;;AD5CuE;AAGlF;;;;AAEmB;AAGnB;;;;;;;;;;;;;;;AAGsB;;;;ACZqC;;;;AAIpC;AAGvB;;;iBAqFgB,2BAAA,qBACM,MAAA,SAAe,uBAAA,GACnC,MAAA,EAAQ,2BAAA,CAA4B,KAAA,IAAM,oBAAA,CAAA,KAAA"}