event-sourced-collection 0.0.1 → 0.0.2

package/README.md

@@ -1,11 +1,13 @@
-# @tanstack-db-collections/event-sourced
+# event-sourced-collection
 
 Event-sourced local-first database on top of TanStack DB persistence. Every `insert`, `update`, and `delete` is logged to a SQLite event table and synced to your backend when online.
 
+Design decisions: [ARCHITECTURE.md](./ARCHITECTURE.md)
+
 ## Install
 
 ```bash
-npm install @tanstack-db-collections/event-sourced @tanstack/db @tanstack/db-sqlite-persistence-core
+npm install event-sourced-collection @tanstack/db @tanstack/db-sqlite-persistence-core
 ```
 
 Plus a platform package:
@@ -18,9 +20,47 @@ npm install @tanstack/browser-db-sqlite-persistence
 npm install @tanstack/react-native-db-sqlite-persistence
 ```
 
+## Project structure
+
+A minimal browser app needs four pieces. Split them by concern so setup stays obvious:
+
+```
+src/
+├── data-access-layer/
+│   ├── collections.ts      # types, DB init, sync transport, `ensureDb()` + `db`
+│   └── sync-events.ts      # thin wrappers around `db.sync()` / `db.manualSync()`
+├── hooks/common/
+│   └── use-event-sourced-sync.ts   # periodic background sync (optional)
+└── routes/ or app shell
+    └── layout.tsx          # call `ensureDb()` once before rendering data UI
+```
+
+| File | Role |
+| ---- | ---- |
+| `collections.ts` | Single source of truth: row types, collection registry, push/pull handlers, one `createBrowserEventSourcedDB` call exporting `ensureDb` + `db` |
+| `sync-events.ts` | Keeps sync calls out of React; import from buttons, jobs, or hooks |
+| `use-event-sourced-sync.ts` | Polls `manualSync()` on an interval when the DB is ready |
+| App shell | `await ensureDb()` before routes that read/write collections |
+
+Flow:
+
+```
+app mount → ensureDb() → load() + platform + engine (run once, deduped)
+                ↓
+         db.collections.* available
+                ↓
+    useLiveQuery / insert / update / delete
+                ↓
+         db.sync() or useEventSourcedSync()
+```
+
 ## Quick start
 
-### 1. Define types
+Copy the pattern below into `collections.ts`, then wire `ensureDb()` in your app shell.
+
+### 1. Domain types
+
+One type per collection you will register. These are your row shapes in SQLite.
 
 ```typescript
 type User = {
@@ -46,65 +86,154 @@ type AppSettings = {
 };
 ```
 
-### 2. Create the database and collections
+### 2. Collection registry + typed DB handle
 
-Register collections in the `collections` option — that is how they are created. There is no separate `createUsersCollection()` call.
+Keys here must match the `collections` option you pass in step 4. This gives you `db.collections.users`, etc. with full inference.
 
 ```typescript
-import { createCollection } from "@tanstack/react-db";
-import {
-  BrowserCollectionCoordinator,
-  createBrowserWASQLitePersistence,
-  openBrowserWASQLiteOPFSDatabase,
-  persistedCollectionOptions,
-} from "@tanstack/browser-db-sqlite-persistence";
-import { createEventSourcedDB } from "@tanstack-db-collections/event-sourced";
-import { createBrowserPlatform } from "@tanstack-db-collections/event-sourced/browser";
-
-const platform = await createBrowserPlatform(
-  {
-    openBrowserWASQLiteOPFSDatabase,
-    createBrowserWASQLitePersistence,
-    BrowserCollectionCoordinator,
-  },
-  { databaseName: "my-app.sqlite" },
-);
+import type { EventSourcedDB } from "event-sourced-collection";
 
-export const db = await createEventSourcedDB({
-  persistence: platform.persistence,
-  createCollection,
-  persistedCollectionOptions,
-  sync: {
-    pushEvents: (events) => typedRpc.events.push({ events }),
-    pullEvents: ({ since }) => typedRpc.events.pull({ since }),
-  },
+type AppCollectionDefs = {
+  users: { getKey: (user: User) => string };
+  todos: { getKey: (todo: Todo) => string };
+  settings: { getKey: (settings: AppSettings) => string };
+};
+
+export type AppDb = EventSourcedDB<AppCollectionDefs>;
+```
+
+### 3. Sync transport
+
+Implement push/pull against your API. These run during `db.sync()` — upload local outbox rows, download server events.
+
+```typescript
+import type { OutboundEvent, PullResponse, PushResponse } from "event-sourced-collection";
+
+const getAccessToken = () => localStorage.getItem("accessToken") ?? "";
+
+async function pushEvents(events: ReadonlyArray<OutboundEvent>): Promise<PushResponse> {
+  const response = await fetch("/api/sync/events", {
+    method: "POST",
+    headers: {
+      "Content-Type": "application/json",
+      Authorization: `Bearer ${getAccessToken()}`,
+    },
+    body: JSON.stringify(events),
+  });
+  if (!response.ok) throw new Error(`Push failed: ${response.status}`);
+  return response.json();
+}
+
+async function pullEvents({ since }: { since: number }): Promise<PullResponse> {
+  const response = await fetch(`/api/sync/events?since=${since}`, {
+    headers: {
+      Accept: "application/json",
+      Authorization: `Bearer ${getAccessToken()}`,
+    },
+  });
+  if (!response.ok) throw new Error(`Pull failed: ${response.status}`);
+  return response.json();
+}
+```
+
+### 4. Create the database (one call)
+
+`createBrowserEventSourcedDB` (from `event-sourced-collection/browser`) wires the SQLite platform, registers collections, and gives you a lazy singleton (`ensureDb`) plus a `db` proxy you can import anywhere. **Collections are created here** — there is no separate `createUsersCollection()` call.
+
+The `load` callback is where you import the platform packages. Keeping the imports in *your* app (instead of inside the library) means the package never bundles a platform or a framework: you choose `@tanstack/react-db` vs `@tanstack/db`, and SSR bundles stay clean because `load` is dynamically imported on first `ensureDb()`.
+
+```typescript
+import { createBrowserEventSourcedDB } from "event-sourced-collection/browser";
+
+const { ensureDb, db, close } = createBrowserEventSourcedDB<AppCollectionDefs>({
+  databaseName: "my-app.sqlite",
+  debug: import.meta.env.DEV,
   collections: {
-    users: { getKey: (u: User) => u.id },
-    todos: { getKey: (t: Todo) => t.id },
-    settings: { getKey: (s: AppSettings) => s.id },
+    users: { getKey: (user: User) => user.id },
+    todos: { getKey: (todo: Todo) => todo.id },
+    settings: { getKey: (settings: AppSettings) => settings.id },
+  },
+  sync: { pushEvents, pullEvents },
+  load: async () => {
+    const { createCollection } = await import("@tanstack/react-db");
+    const platform = await import("@tanstack/browser-db-sqlite-persistence");
+    return { ...platform, createCollection };
   },
 });
+
+export { db, ensureDb, close };
 ```
 
+The handle is `{ ensureDb, db, close }`:
+
+- `ensureDb()` — runs `load` + setup once (deduped across concurrent calls), returns the ready DB. Throws outside a browser environment.
+- `db` — a proxy that forwards to the instance after `ensureDb()` resolves, and throws if used before then.
+- `close()` — disposes the engine and closes the SQLite platform; the next `ensureDb()` re-initializes.
+
 After setup you get:
 
 - `db.collections.users`
 - `db.collections.todos`
 - `db.collections.settings`
 
-Plus two built-in collections that are always available, even with no sync configured:
+Plus two built-in collections (always present, even without sync):
+
+- `db.collections.outbox` — local mutations waiting to be pushed
+- `db.collections.inbox` — server events pulled to this device
+
+Both are normal queryable collections for sync UI (see [Inspecting sync state](#inspecting-sync-state)). `outbox` and `inbox` are reserved ids.
+
+### 5. Wire the app shell
+
+Call `ensureDb()` once when the app mounts, before any collection reads:
+
+```typescript
+import { useEffect, useState } from "react";
+import { ensureDb } from "./data-access-layer/collections";
+
+function AppShell() {
+  const [ready, setReady] = useState(false);
 
-- `db.collections.outbox` — local mutations waiting to be pushed to the server
-- `db.collections.inbox` — server events that have been pulled to this device
+  useEffect(() => {
+    void ensureDb().then(() => setReady(true));
+  }, []);
 
-Both are normal queryable collections, so you can visualize sync state directly in your UI (see [Inspecting sync state](#inspecting-sync-state)). `outbox` and `inbox` are reserved ids — defining a collection with either name throws.
+  if (!ready) return <Loading />;
+  return <YourRoutes />;
+}
+```
+
+Optional background sync (`sync-events.ts` + hook):
+
+```typescript
+// sync-events.ts
+import { ensureDb } from "./collections";
+
+export async function manualSyncEvents() {
+  const database = await ensureDb();
+  return database.manualSync();
+}
+
+// use-event-sourced-sync.ts
+import { useQuery } from "@tanstack/react-query";
+import { manualSyncEvents } from "@/data-access-layer/sync-events";
+
+export function useEventSourcedSync(enabled: boolean) {
+  return useQuery({
+    queryKey: ["sync"],
+    queryFn: () => manualSyncEvents(),
+    enabled,
+    refetchInterval: 60_000,
+  });
+}
+```
 
-### 3. Write data
+### 6. Write data
 
 Use collections like normal TanStack DB. Mutations are logged to the event store automatically.
 
 ```typescript
-import { db } from "./db";
+import { db } from "./data-access-layer/collections";
 
 const userId = crypto.randomUUID();
 
@@ -146,11 +275,11 @@ db.collections.settings.update("app", (draft) => {
 });
 ```
 
-### 4. Read data
+### 7. Read data
 
 ```typescript
 import { useLiveQuery } from "@tanstack/react-db";
-import { db } from "./db";
+import { db } from "./data-access-layer/collections";
 
 function TodoList() {
   const { data: todos = [] } = useLiveQuery((q) =>
@@ -177,14 +306,19 @@ function TodoList() {
 }
 ```
 
-### 5. Sync
+### 8. Sync
 
 ```typescript
-const result = await db.sync();
+import { ensureDb } from "./data-access-layer/collections";
+
+const db = await ensureDb();
+await db.sync();
 
-window.addEventListener("online", () => db.sync());
+window.addEventListener("online", () => void db.sync());
 ```
 
+Or use a periodic hook (see step 5).
+
 ## Inspecting sync state
 
 `outbox` and `inbox` are queryable collections. Each row carries a `sync` flag:
@@ -195,7 +329,7 @@ window.addEventListener("online", () => db.sync());
 ```typescript
 import { useLiveQuery } from "@tanstack/react-db";
 import { eq } from "@tanstack/db";
-import { db } from "./db";
+import { db } from "./data-access-layer/collections";
 
 function SyncStatus() {
   const { data: unpushed = [] } = useLiveQuery((q) =>
@@ -218,7 +352,7 @@ function SyncStatus() {
 
 | Step | What happens |
 | ---- | ------------ |
-| Register collections | `collections: { users, todos, settings }` in `createEventSourcedDB` |
+| Register collections | `collections: { users, todos, settings }` in `createBrowserEventSourcedDB` (or low-level `createEventSourcedDB`) |
 | Access them | `db.collections.users`, etc. |
 | Write data | `.insert()`, `.update()`, `.delete()` |
 | Log mutations | Each write appends a row to `db.collections.outbox` (`sync: false`) |
@@ -227,9 +361,17 @@ function SyncStatus() {
 
 On push, confirmed outbox rows flip to `sync: true` with their server `globalSeq`. On pull, new server events are written to `inbox` (`sync: false`), replayed into the target collection via `acceptMutations`, then flipped to `sync: true`. The client's own events come back on pull and are written to `inbox` as already applied. The pull cursor is derived from the highest synced `globalSeq` in `inbox` — there is no separate cursor table.
 
+Step by step:
+
+1. User mutates `db.collections.todos` → row appended to local **outbox** (`sync: false`).
+2. `manualSync()` or background hook pushes outbox → `POST /api/sync/events`.
+3. Server assigns `globalSeq` → outbox rows flip to `sync: true`.
+4. Pull fetches newer events → `GET /api/sync/events?since=<cursor>`.
+5. Remote events land in **inbox**, replay into collections, flip to `sync: true`.
+
 ## Server contract
 
-### `POST /api/events`
+### `POST /api/sync/events`
 
 Request: array of outbound events (`eventId`, `collectionId`, `type`, `key`, `payload`, `timestamp`).
 
@@ -242,7 +384,7 @@ Response:
 }
 ```
 
-### `GET /api/events?since={globalSeq}`
+### `GET /api/sync/events?since={globalSeq}`
 
 Response:
 
@@ -270,6 +412,38 @@ CREATE TABLE events (
 CREATE INDEX idx_events_global_seq ON events (global_seq);
 ```
 
+## Simulate another device
+
+POST a fake event directly to your sync server to mimic a push from another client. Use a unique `eventId` — it must not already exist in the receiving device's local outbox.
+
+```bash
+curl -X POST http://localhost:3000/api/sync/events \
+  -H "Content-Type: application/json" \
+  -d '[{
+    "eventId": "019c0000-0000-7000-8000-remote-demo",
+    "collectionId": "todos",
+    "type": "insert",
+    "key": "remote-todo-demo",
+    "payload": {
+      "id": "remote-todo-demo",
+      "userId": "remote-user",
+      "title": "From another device",
+      "status": "pending",
+      "createdAt": 1730000000000,
+      "updatedAt": 1730000000000
+    },
+    "timestamp": 1730000000000
+  }]'
+```
+
+Then call `manualSync()` or `db.sync()` on the client. The event appears in inbox and the todo is replayed locally.
+
+Check server state:
+
+```bash
+curl "http://localhost:3000/api/sync/events?since=0"
+```
+
 ## Sync Options
 
 You can run fully offline by omitting `sync`. In that mode local mutations still append to `outbox`, and `sync()` is a no-op.
@@ -277,7 +451,7 @@ You can run fully offline by omitting `sync`. In that mode local mutations still
 Use typed functions when your app already has RPC/server-function clients:
 
 ```typescript
-import type { PullResponse, PushResponse } from "@tanstack-db-collections/event-sourced";
+import type { PullResponse, PushResponse } from "event-sourced-collection";
 
 const sync = {
   pushEvents: async (events): Promise<PushResponse> => {
@@ -309,7 +483,7 @@ You can provide only `pushEvents`/`pushUrl` for upload-only sync or only `pullEv
 For existing integrations, the legacy shapes still work:
 
 ```typescript
-import type { SyncTransport } from "@tanstack-db-collections/event-sourced";
+import type { SyncTransport } from "event-sourced-collection";
 
 const transport: SyncTransport = {
   async push(events) { /* return confirmed event ids + globalSeq */ },
@@ -321,33 +495,48 @@ const db = await createEventSourcedDB({ sync: transport, /* ... */ });
 
 ## React Native
 
+Same helper shape via `createReactNativeEventSourcedDB` (from `event-sourced-collection/react-native`). React Native can't auto-open the database, so `load` returns the `database` driver alongside the platform functions.
+
 ```typescript
-import { createCollection } from "@tanstack/react-native-db";
-import { createReactNativeSQLitePersistence, persistedCollectionOptions } from "@tanstack/react-native-db-sqlite-persistence";
-import { createEventSourcedDB } from "@tanstack-db-collections/event-sourced";
-import { createReactNativePlatform } from "@tanstack-db-collections/event-sourced/react-native";
-import { openDatabase } from "react-native-op-sqlite";
-
-const platform = createReactNativePlatform(
-  { createReactNativeSQLitePersistence },
-  { database: openDatabase({ name: "my-app.sqlite" }) },
-);
+import { createReactNativeEventSourcedDB } from "event-sourced-collection/react-native";
 
-export const db = await createEventSourcedDB({
-  persistence: platform.persistence,
-  createCollection,
-  persistedCollectionOptions,
+const { ensureDb, db } = createReactNativeEventSourcedDB<AppCollectionDefs>({
   collections: {
-    users: { getKey: (u: User) => u.id },
-    todos: { getKey: (t: Todo) => t.id },
+    users: { getKey: (user: User) => user.id },
+    todos: { getKey: (todo: Todo) => todo.id },
+  },
+  sync: { pushEvents, pullEvents },
+  load: 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 {
+      createReactNativeSQLitePersistence,
+      persistedCollectionOptions,
+      createCollection,
+      database: openDatabase({ name: "my-app.sqlite" }),
+    };
   },
 });
+
+export { db, ensureDb };
 ```
 
 Insert, update, delete, `useLiveQuery`, and `sync()` work the same as in the browser.
 
 ## Cleanup
 
+Call the handle's `close()` to dispose the engine and release the platform:
+
+```typescript
+await close();
+```
+
+If you wired things up by hand with the low-level `createEventSourcedDB` + `createBrowserPlatform`, dispose them directly instead:
+
 ```typescript
 db.dispose();
 await platform.close();
@@ -355,8 +544,34 @@ await platform.close();
 
 ## API
 
+### `createBrowserEventSourcedDB(config)` / `createReactNativeEventSourcedDB(config)`
+
+The recommended entry points. Import from `event-sourced-collection/browser` or `event-sourced-collection/react-native`.
+
+| Option | Required | Description |
+| ------ | -------- | ----------- |
+| `collections` | Yes | Collection definitions (`getKey`, optional `schemaVersion`) — must not use the reserved ids `outbox`/`inbox` |
+| `load` | Yes | Async callback returning the platform modules + `createCollection` + `persistedCollectionOptions`. Keeps platform/framework imports in your app |
+| `databaseName` | Browser only | SQLite database file name |
+| `coordinatorDbName` | No (browser) | Multi-tab coordinator name; defaults to `databaseName` without the `.sqlite` suffix |
+| `sync` | No | Offline by default. Same shapes as `createEventSourcedDB` |
+| `schemaVersion` | No | Default `1` |
+| `debug` | No | `boolean` or a custom logger |
+
+Returns `{ ensureDb, db, close }`:
+
+- `ensureDb()` — runs `load` + setup once (deduped), returns the ready DB. The browser helper throws outside a browser environment.
+- `db` — proxy that forwards to the instance after init and throws if used before `ensureDb()`.
+- `close()` — disposes the engine (and closes the SQLite platform on browser); the next `ensureDb()` re-initializes.
+
+### `createLazySingleton(factory, options?)`
+
+Dependency-free building block behind the helpers. Wraps an async `factory` into `{ ensure, proxy, reset }`: `ensure()` runs the factory once (deduped, retried after failure), `proxy` forwards to the instance and throws until initialized, `reset()` clears it. Accepts an optional `guard` and `notInitializedMessage`.
+
 ### `createEventSourcedDB(config)`
 
+Low-level core for full control or non-standard platforms. The helpers above call this for you.
+
 | Option | Required | Description |
 | ------ | -------- | ----------- |
 | `persistence` | Yes | TanStack DB persistence config |
@@ -370,8 +585,8 @@ Returns `{ collections, sync, manualSync, dispose }`, where `collections` includ
 
 ### `createBrowserPlatform(deps, config)`
 
-Import from `@tanstack-db-collections/event-sourced/browser`. Sets up browser SQLite + multi-tab coordinator.
+Import from `event-sourced-collection/browser`. Sets up browser SQLite + multi-tab coordinator.
 
 ### `createReactNativePlatform(deps, config)`
 
-Import from `@tanstack-db-collections/event-sourced/react-native`. Sets up React Native SQLite persistence.
+Import from `event-sourced-collection/react-native`. Sets up React Native SQLite persistence.

package/dist/browser.d.mts

@@ -1,4 +1,4 @@
-import { x as SQLiteDriver } from "./types-CAT14Tbj.mjs";
+import { A as PersistedCollectionOptionsFn, C as SyncHandlersConfig, D as EventSourcedLogger, E as SyncUrlConfig, T as SyncTransport, k as CreateCollectionFn, r as EventSourcedDB, x as SQLiteDriver } from "./types-CAT14Tbj.mjs";
 import { PersistedCollectionCoordinator, PersistedCollectionPersistence } from "@tanstack/db-sqlite-persistence-core";
 import { BrowserCollectionCoordinatorOptions, BrowserWASQLiteDatabase as BrowserWASQLiteDatabase$1, BrowserWASQLitePersistenceOptions, OpenBrowserWASQLiteOPFSDatabaseOptions } from "@tanstack/browser-db-sqlite-persistence";
 
@@ -30,5 +30,30 @@ type BrowserWASQLiteDatabase = {
 //#region src/platforms/browser.d.ts
 declare function createBrowserPlatform(deps: BrowserPlatformDeps, config: BrowserPlatformConfig): Promise<BrowserPlatformResult>;
 //#endregion
-export { type BrowserCoordinatorInstance, type BrowserPlatformConfig, type BrowserPlatformDeps, type BrowserPlatformResult, type BrowserWASQLiteDatabase, createBrowserPlatform };
+//#region src/platforms/browser-event-sourced-db.d.ts
+type CollectionDefConstraint = {
+  getKey: (state: never) => string | number;
+  schemaVersion?: number;
+};
+type BrowserEventSourcedModules = BrowserPlatformDeps & {
+  createCollection: CreateCollectionFn;
+  persistedCollectionOptions: PersistedCollectionOptionsFn;
+};
+type BrowserEventSourcedDBConfig<TDefs extends Record<string, CollectionDefConstraint>> = {
+  databaseName: string;
+  coordinatorDbName?: string;
+  collections: TDefs;
+  load: () => Promise<BrowserEventSourcedModules>;
+  sync?: SyncHandlersConfig | SyncUrlConfig | SyncTransport;
+  schemaVersion?: number;
+  debug?: boolean | EventSourcedLogger;
+};
+type BrowserEventSourcedDBHandle<TDefs extends Record<string, CollectionDefConstraint>> = {
+  ensureDb: () => Promise<EventSourcedDB<TDefs>>;
+  db: EventSourcedDB<TDefs>;
+  close: () => Promise<void>;
+};
+declare function createBrowserEventSourcedDB<const TDefs extends Record<string, CollectionDefConstraint>>(config: BrowserEventSourcedDBConfig<TDefs>): BrowserEventSourcedDBHandle<TDefs>;
+//#endregion
+export { type BrowserCoordinatorInstance, type BrowserEventSourcedDBConfig, type 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-types.ts","../src/platforms/browser-wa-sqlite-driver.ts","../src/platforms/browser.ts"],"mappings":";;;;;KAQY,0BAAA,GAA6B,8BAA8B;EACrE,OAAO;AAAA;AAAA,KAGG,mBAAA;EACV,+BAAA,GACE,OAAA,EAAS,sCAAA,KACN,OAAA,CAAQ,yBAAA;EACb,gCAAA,GACE,OAAA,EAAS,iCAAA,KACN,8BAAA;EACL,4BAAA,OACE,OAAA,EAAS,mCAAA,KACN,0BAAA;AAAA;AAAA,KAGK,qBAAA;EACV,YAAA;EACA,iBAAiB;AAAA;AAAA,KAGP,qBAAA;EACV,MAAA,EAD+B,YAAA;EAE/B,WAAA,EAAa,8BAAA;EACb,KAAA,QAAa,OAAA;AAAA;;;KC9BH,uBAAA;EACV,OAAA,mBACE,GAAA,UACA,MAAA,GAAS,aAAA,cACN,OAAA,CAAQ,aAAA,CAAc,IAAA;EAC3B,KAAA,SAAc,OAAA;AAAA;;;iBCUM,qBAAA,CACpB,IAAA,EAAM,mBAAA,EACN,MAAA,EAAQ,qBAAA,GACP,OAAA,CAAQ,qBAAA"}
+{"version":3,"file":"browser.d.mts","names":[],"sources":["../src/platforms/browser-types.ts","../src/platforms/browser-wa-sqlite-driver.ts","../src/platforms/browser.ts","../src/platforms/browser-event-sourced-db.ts"],"mappings":";;;;;KAQY,0BAAA,GAA6B,8BAA8B;EACrE,OAAO;AAAA;AAAA,KAGG,mBAAA;EACV,+BAAA,GACE,OAAA,EAAS,sCAAA,KACN,OAAA,CAAQ,yBAAA;EACb,gCAAA,GACE,OAAA,EAAS,iCAAA,KACN,8BAAA;EACL,4BAAA,OACE,OAAA,EAAS,mCAAA,KACN,0BAAA;AAAA;AAAA,KAGK,qBAAA;EACV,YAAA;EACA,iBAAiB;AAAA;AAAA,KAGP,qBAAA;EACV,MAAA,EAD+B,YAAA;EAE/B,WAAA,EAAa,8BAAA;EACb,KAAA,QAAa,OAAA;AAAA;;;KC9BH,uBAAA;EACV,OAAA,mBACE,GAAA,UACA,MAAA,GAAS,aAAA,cACN,OAAA,CAAQ,aAAA,CAAc,IAAA;EAC3B,KAAA,SAAc,OAAA;AAAA;;;iBCUM,qBAAA,CACpB,IAAA,EAAM,mBAAA,EACN,MAAA,EAAQ,qBAAA,GACP,OAAA,CAAQ,qBAAA;;;KCPN,uBAAA;EACH,MAAA,GAAS,KAAA;EACT,aAAA;AAAA;AAAA,KAGU,0BAAA,GAA6B,mBAAA;EACvC,gBAAA,EAAkB,kBAAA;EAClB,0BAAA,EAA4B,4BAAA;AAAA;AAAA,KAGlB,2BAAA,eAA0C,MAAA,SAAe,uBAAA;EACnE,YAAA;EACA,iBAAA;EACA,WAAA,EAAa,KAAA;EACb,IAAA,QAAY,OAAA,CAAQ,0BAAA;EACpB,IAAA,GAAO,kBAAA,GAAqB,aAAA,GAAgB,aAAA;EAC5C,aAAA;EACA,KAAA,aAAkB,kBAAA;AAAA;AAAA,KAGR,2BAAA,eAA0C,MAAA,SAAe,uBAAA;EACnE,QAAA,QAAgB,OAAA,CAAQ,cAAA,CAAe,KAAA;EACvC,EAAA,EAAI,cAAA,CAAe,KAAA;EACnB,KAAA,QAAa,OAAA;AAAA;AAAA,iBAGC,2BAAA,qBACM,MAAA,SAAe,uBAAA,GACnC,MAAA,EAAQ,2BAAA,CAA4B,KAAA,IAAS,2BAAA,CAA4B,KAAA"}

package/dist/browser.mjs

@@ -1,3 +1,4 @@
+import { n as createEventSourcedDB, t as createLazySingleton } from "./lazy-singleton-DFrAsYTV.mjs";
 //#region src/platforms/browser-wa-sqlite-driver.ts
 function assertTransactionCallbackHasDriverArg(fn) {
 	if (fn.length > 0) return;
@@ -102,6 +103,58 @@ async function createBrowserPlatform(deps, config) {
 	};
 }
 //#endregion
-export { createBrowserPlatform };
+//#region src/platforms/browser-event-sourced-db.ts
+function createBrowserEventSourcedDB(config) {
+	let activeDb = null;
+	let closePlatform = null;
+	const factory = async () => {
+		const modules = await config.load();
+		const platform = await createBrowserPlatform({
+			openBrowserWASQLiteOPFSDatabase: modules.openBrowserWASQLiteOPFSDatabase,
+			createBrowserWASQLitePersistence: modules.createBrowserWASQLitePersistence,
+			BrowserCollectionCoordinator: modules.BrowserCollectionCoordinator
+		}, {
+			databaseName: config.databaseName,
+			coordinatorDbName: config.coordinatorDbName
+		});
+		closePlatform = platform.close;
+		const database = await createEventSourcedDB({
+			persistence: platform.persistence,
+			createCollection: modules.createCollection,
+			persistedCollectionOptions: modules.persistedCollectionOptions,
+			collections: config.collections,
+			sync: config.sync,
+			schemaVersion: config.schemaVersion,
+			debug: config.debug
+		});
+		activeDb = database;
+		return database;
+	};
+	const singleton = createLazySingleton(factory, {
+		guard: assertBrowserEnvironment,
+		notInitializedMessage: "Event-sourced DB is not initialized. Call ensureDb() before using db."
+	});
+	const close = async () => {
+		if (activeDb) {
+			activeDb.dispose();
+			activeDb = null;
+		}
+		if (closePlatform) {
+			await closePlatform();
+			closePlatform = null;
+		}
+		singleton.reset();
+	};
+	return {
+		ensureDb: singleton.ensure,
+		db: singleton.proxy,
+		close
+	};
+}
+function assertBrowserEnvironment() {
+	if (typeof window === "undefined") throw new Error("Event-sourced DB (browser) is only available in a browser environment.");
+}
+//#endregion
+export { createBrowserEventSourcedDB, createBrowserPlatform };
 
 //# sourceMappingURL=browser.mjs.map

package/dist/browser.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"browser.mjs","names":[],"sources":["../src/platforms/browser-wa-sqlite-driver.ts","../src/platforms/browser.ts"],"sourcesContent":["import type { SQLiteDriver } from \"../types\";\n\nexport type BrowserWASQLiteDatabase = {\n  execute: <TRow = unknown>(\n    sql: string,\n    params?: ReadonlyArray<unknown>,\n  ) => Promise<ReadonlyArray<TRow>>;\n  close?: () => Promise<void> | void;\n};\n\nfunction assertTransactionCallbackHasDriverArg(\n  fn: (transactionDriver: SQLiteDriver) => Promise<unknown>,\n): void {\n  if (fn.length > 0) {\n    return;\n  }\n\n  throw new Error(\n    \"SQLiteDriver.transaction callback must accept the transaction driver argument\",\n  );\n}\n\nfunction assertDatabaseShape(\n  database: BrowserWASQLiteDatabase,\n): asserts database is BrowserWASQLiteDatabase {\n  if (typeof database.execute !== \"function\") {\n    throw new Error(\"Browser wa-sqlite database handle must provide execute(sql, params?)\");\n  }\n}\n\nexport class BrowserWASQLiteDriver implements SQLiteDriver {\n  private readonly database: BrowserWASQLiteDatabase;\n  private queue: Promise<void> = Promise.resolve();\n  private nextSavepointId = 1;\n  private closed = false;\n\n  constructor(database: BrowserWASQLiteDatabase) {\n    assertDatabaseShape(database);\n    this.database = database;\n  }\n\n  async exec(sql: string): Promise<void> {\n    await this.enqueue(async () => {\n      await this.database.execute(sql);\n    });\n  }\n\n  async query<T>(sql: string, params: ReadonlyArray<unknown> = []): Promise<ReadonlyArray<T>> {\n    return this.enqueue(() => this.database.execute<T>(sql, params));\n  }\n\n  async run(sql: string, params: ReadonlyArray<unknown> = []): Promise<void> {\n    await this.enqueue(async () => {\n      await this.database.execute(sql, params);\n    });\n  }\n\n  async transaction<T>(fn: (transactionDriver: SQLiteDriver) => Promise<T>): Promise<T> {\n    assertTransactionCallbackHasDriverArg(fn);\n\n    return this.enqueue(async () => {\n      await this.database.execute(`BEGIN IMMEDIATE`);\n      try {\n        const result = await fn(this.createTransactionDriver());\n        await this.database.execute(`COMMIT`);\n        return result;\n      } catch (error) {\n        try {\n          await this.database.execute(`ROLLBACK`);\n        } catch {\n        }\n        throw error;\n      }\n    });\n  }\n\n  async transactionWithDriver<T>(\n    fn: (transactionDriver: SQLiteDriver) => Promise<T>,\n  ): Promise<T> {\n    return this.transaction(fn);\n  }\n\n  async close(): Promise<void> {\n    if (this.closed) {\n      return;\n    }\n    this.closed = true;\n\n    if (typeof this.database.close === \"function\") {\n      await Promise.resolve(this.database.close());\n    }\n  }\n\n  private createTransactionDriver(): SQLiteDriver {\n    return {\n      exec: (sql) => this.database.execute(sql).then(() => undefined),\n      query: <T>(sql: string, params: ReadonlyArray<unknown> = []) =>\n        this.database.execute<T>(sql, params),\n      run: (sql: string, params: ReadonlyArray<unknown> = []) =>\n        this.database.execute(sql, params).then(() => undefined),\n      transaction: <T>(fn: (transactionDriver: SQLiteDriver) => Promise<T>) =>\n        this.runNestedTransaction(fn),\n      transactionWithDriver: <T>(fn: (transactionDriver: SQLiteDriver) => Promise<T>) =>\n        this.runNestedTransaction(fn),\n    };\n  }\n\n  private async runNestedTransaction<T>(\n    fn: (transactionDriver: SQLiteDriver) => Promise<T>,\n  ): Promise<T> {\n    assertTransactionCallbackHasDriverArg(fn);\n\n    const savepointName = `tsdb_sp_${this.nextSavepointId}`;\n    this.nextSavepointId++;\n    await this.database.execute(`SAVEPOINT ${savepointName}`);\n    try {\n      const result = await fn(this.createTransactionDriver());\n      await this.database.execute(`RELEASE SAVEPOINT ${savepointName}`);\n      return result;\n    } catch (error) {\n      await this.database.execute(`ROLLBACK TO SAVEPOINT ${savepointName}`);\n      await this.database.execute(`RELEASE SAVEPOINT ${savepointName}`);\n      throw error;\n    }\n  }\n\n  private enqueue<T>(operation: () => Promise<T> | T): Promise<T> {\n    const queuedOperation = this.queue.then(operation, operation);\n    this.queue = queuedOperation.then(\n      () => undefined,\n      () => undefined,\n    );\n    return queuedOperation;\n  }\n}\n","import type { PersistedCollectionPersistence } from \"../types\";\nimport { BrowserWASQLiteDriver } from \"./browser-wa-sqlite-driver\";\nimport type {\n  BrowserPlatformConfig,\n  BrowserPlatformDeps,\n  BrowserPlatformResult,\n} from \"./browser-types\";\n\nexport type {\n  BrowserCoordinatorInstance,\n  BrowserPlatformConfig,\n  BrowserPlatformDeps,\n  BrowserPlatformResult,\n} from \"./browser-types\";\n\nexport type { BrowserWASQLiteDatabase } from \"./browser-wa-sqlite-driver\";\n\nexport async function createBrowserPlatform(\n  deps: BrowserPlatformDeps,\n  config: BrowserPlatformConfig,\n): Promise<BrowserPlatformResult> {\n  const database = await deps.openBrowserWASQLiteOPFSDatabase({\n    databaseName: config.databaseName,\n  });\n\n  const coordinator = new deps.BrowserCollectionCoordinator({\n    dbName: config.coordinatorDbName ?? config.databaseName.replace(/\\.sqlite$/, \"\"),\n  });\n\n  const persistence = deps.createBrowserWASQLitePersistence({\n    database,\n    coordinator,\n  });\n\n  const driver = new BrowserWASQLiteDriver(database);\n\n  return {\n    driver,\n    persistence,\n    close: async () => {\n      coordinator.dispose();\n      await driver.close();\n    },\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"browser.mjs","names":[],"sources":["../src/platforms/browser-wa-sqlite-driver.ts","../src/platforms/browser.ts","../src/platforms/browser-event-sourced-db.ts"],"sourcesContent":["import type { SQLiteDriver } from \"../types\";\n\nexport type BrowserWASQLiteDatabase = {\n  execute: <TRow = unknown>(\n    sql: string,\n    params?: ReadonlyArray<unknown>,\n  ) => Promise<ReadonlyArray<TRow>>;\n  close?: () => Promise<void> | void;\n};\n\nfunction assertTransactionCallbackHasDriverArg(\n  fn: (transactionDriver: SQLiteDriver) => Promise<unknown>,\n): void {\n  if (fn.length > 0) {\n    return;\n  }\n\n  throw new Error(\n    \"SQLiteDriver.transaction callback must accept the transaction driver argument\",\n  );\n}\n\nfunction assertDatabaseShape(\n  database: BrowserWASQLiteDatabase,\n): asserts database is BrowserWASQLiteDatabase {\n  if (typeof database.execute !== \"function\") {\n    throw new Error(\"Browser wa-sqlite database handle must provide execute(sql, params?)\");\n  }\n}\n\nexport class BrowserWASQLiteDriver implements SQLiteDriver {\n  private readonly database: BrowserWASQLiteDatabase;\n  private queue: Promise<void> = Promise.resolve();\n  private nextSavepointId = 1;\n  private closed = false;\n\n  constructor(database: BrowserWASQLiteDatabase) {\n    assertDatabaseShape(database);\n    this.database = database;\n  }\n\n  async exec(sql: string): Promise<void> {\n    await this.enqueue(async () => {\n      await this.database.execute(sql);\n    });\n  }\n\n  async query<T>(sql: string, params: ReadonlyArray<unknown> = []): Promise<ReadonlyArray<T>> {\n    return this.enqueue(() => this.database.execute<T>(sql, params));\n  }\n\n  async run(sql: string, params: ReadonlyArray<unknown> = []): Promise<void> {\n    await this.enqueue(async () => {\n      await this.database.execute(sql, params);\n    });\n  }\n\n  async transaction<T>(fn: (transactionDriver: SQLiteDriver) => Promise<T>): Promise<T> {\n    assertTransactionCallbackHasDriverArg(fn);\n\n    return this.enqueue(async () => {\n      await this.database.execute(`BEGIN IMMEDIATE`);\n      try {\n        const result = await fn(this.createTransactionDriver());\n        await this.database.execute(`COMMIT`);\n        return result;\n      } catch (error) {\n        try {\n          await this.database.execute(`ROLLBACK`);\n        } catch {\n        }\n        throw error;\n      }\n    });\n  }\n\n  async transactionWithDriver<T>(\n    fn: (transactionDriver: SQLiteDriver) => Promise<T>,\n  ): Promise<T> {\n    return this.transaction(fn);\n  }\n\n  async close(): Promise<void> {\n    if (this.closed) {\n      return;\n    }\n    this.closed = true;\n\n    if (typeof this.database.close === \"function\") {\n      await Promise.resolve(this.database.close());\n    }\n  }\n\n  private createTransactionDriver(): SQLiteDriver {\n    return {\n      exec: (sql) => this.database.execute(sql).then(() => undefined),\n      query: <T>(sql: string, params: ReadonlyArray<unknown> = []) =>\n        this.database.execute<T>(sql, params),\n      run: (sql: string, params: ReadonlyArray<unknown> = []) =>\n        this.database.execute(sql, params).then(() => undefined),\n      transaction: <T>(fn: (transactionDriver: SQLiteDriver) => Promise<T>) =>\n        this.runNestedTransaction(fn),\n      transactionWithDriver: <T>(fn: (transactionDriver: SQLiteDriver) => Promise<T>) =>\n        this.runNestedTransaction(fn),\n    };\n  }\n\n  private async runNestedTransaction<T>(\n    fn: (transactionDriver: SQLiteDriver) => Promise<T>,\n  ): Promise<T> {\n    assertTransactionCallbackHasDriverArg(fn);\n\n    const savepointName = `tsdb_sp_${this.nextSavepointId}`;\n    this.nextSavepointId++;\n    await this.database.execute(`SAVEPOINT ${savepointName}`);\n    try {\n      const result = await fn(this.createTransactionDriver());\n      await this.database.execute(`RELEASE SAVEPOINT ${savepointName}`);\n      return result;\n    } catch (error) {\n      await this.database.execute(`ROLLBACK TO SAVEPOINT ${savepointName}`);\n      await this.database.execute(`RELEASE SAVEPOINT ${savepointName}`);\n      throw error;\n    }\n  }\n\n  private enqueue<T>(operation: () => Promise<T> | T): Promise<T> {\n    const queuedOperation = this.queue.then(operation, operation);\n    this.queue = queuedOperation.then(\n      () => undefined,\n      () => undefined,\n    );\n    return queuedOperation;\n  }\n}\n","import type { PersistedCollectionPersistence } from \"../types\";\nimport { BrowserWASQLiteDriver } from \"./browser-wa-sqlite-driver\";\nimport type {\n  BrowserPlatformConfig,\n  BrowserPlatformDeps,\n  BrowserPlatformResult,\n} from \"./browser-types\";\n\nexport type {\n  BrowserCoordinatorInstance,\n  BrowserPlatformConfig,\n  BrowserPlatformDeps,\n  BrowserPlatformResult,\n} from \"./browser-types\";\n\nexport type { BrowserWASQLiteDatabase } from \"./browser-wa-sqlite-driver\";\n\nexport async function createBrowserPlatform(\n  deps: BrowserPlatformDeps,\n  config: BrowserPlatformConfig,\n): Promise<BrowserPlatformResult> {\n  const database = await deps.openBrowserWASQLiteOPFSDatabase({\n    databaseName: config.databaseName,\n  });\n\n  const coordinator = new deps.BrowserCollectionCoordinator({\n    dbName: config.coordinatorDbName ?? config.databaseName.replace(/\\.sqlite$/, \"\"),\n  });\n\n  const persistence = deps.createBrowserWASQLitePersistence({\n    database,\n    coordinator,\n  });\n\n  const driver = new BrowserWASQLiteDriver(database);\n\n  return {\n    driver,\n    persistence,\n    close: async () => {\n      coordinator.dispose();\n      await driver.close();\n    },\n  };\n}\n","import { createEventSourcedDB } from \"../create-event-sourced-db\";\nimport { createLazySingleton } from \"../lazy-singleton\";\nimport type { CreateCollectionFn, PersistedCollectionOptionsFn } from \"../persisted-collection\";\nimport type {\n  EventSourcedDB,\n  EventSourcedLogger,\n  SyncHandlersConfig,\n  SyncTransport,\n  SyncUrlConfig,\n} from \"../types\";\nimport { createBrowserPlatform } from \"./browser\";\nimport type { BrowserPlatformDeps } from \"./browser-types\";\n\ntype CollectionDefConstraint = {\n  getKey: (state: never) => string | number;\n  schemaVersion?: number;\n};\n\nexport type BrowserEventSourcedModules = BrowserPlatformDeps & {\n  createCollection: CreateCollectionFn;\n  persistedCollectionOptions: PersistedCollectionOptionsFn;\n};\n\nexport type BrowserEventSourcedDBConfig<TDefs extends Record<string, CollectionDefConstraint>> = {\n  databaseName: string;\n  coordinatorDbName?: string;\n  collections: TDefs;\n  load: () => Promise<BrowserEventSourcedModules>;\n  sync?: SyncHandlersConfig | SyncUrlConfig | SyncTransport;\n  schemaVersion?: number;\n  debug?: boolean | EventSourcedLogger;\n};\n\nexport type BrowserEventSourcedDBHandle<TDefs extends Record<string, CollectionDefConstraint>> = {\n  ensureDb: () => Promise<EventSourcedDB<TDefs>>;\n  db: EventSourcedDB<TDefs>;\n  close: () => Promise<void>;\n};\n\nexport function createBrowserEventSourcedDB<\n  const TDefs extends Record<string, CollectionDefConstraint>,\n>(config: BrowserEventSourcedDBConfig<TDefs>): BrowserEventSourcedDBHandle<TDefs> {\n  let activeDb: EventSourcedDB<TDefs> | null = null;\n  let closePlatform: (() => Promise<void>) | null = null;\n\n  const factory = async (): Promise<EventSourcedDB<TDefs>> => {\n    const modules = await config.load();\n\n    const platform = await createBrowserPlatform(\n      {\n        openBrowserWASQLiteOPFSDatabase: modules.openBrowserWASQLiteOPFSDatabase,\n        createBrowserWASQLitePersistence: modules.createBrowserWASQLitePersistence,\n        BrowserCollectionCoordinator: modules.BrowserCollectionCoordinator,\n      },\n      {\n        databaseName: config.databaseName,\n        coordinatorDbName: config.coordinatorDbName,\n      },\n    );\n\n    closePlatform = platform.close;\n\n    const database = await createEventSourcedDB<TDefs>({\n      persistence: platform.persistence,\n      createCollection: modules.createCollection,\n      persistedCollectionOptions: modules.persistedCollectionOptions,\n      collections: config.collections,\n      sync: config.sync,\n      schemaVersion: config.schemaVersion,\n      debug: config.debug,\n    });\n\n    activeDb = database;\n    return database;\n  };\n\n  const singleton = createLazySingleton<EventSourcedDB<TDefs>>(factory, {\n    guard: assertBrowserEnvironment,\n    notInitializedMessage:\n      \"Event-sourced DB is not initialized. Call ensureDb() before using db.\",\n  });\n\n  const close = async (): Promise<void> => {\n    if (activeDb) {\n      activeDb.dispose();\n      activeDb = null;\n    }\n    if (closePlatform) {\n      await closePlatform();\n      closePlatform = null;\n    }\n    singleton.reset();\n  };\n\n  return {\n    ensureDb: singleton.ensure,\n    db: singleton.proxy,\n    close,\n  };\n}\n\nfunction assertBrowserEnvironment(): void {\n  if (typeof window === \"undefined\") {\n    throw new Error(\"Event-sourced DB (browser) is only available in a browser environment.\");\n  }\n}\n"],"mappings":"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"}