@livestore/livestore 0.3.0-dev.10 → 0.3.0-dev.12

package/dist/utils/tests/fixture.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fixture.d.ts","sourceRoot":"","sources":["../../../src/utils/tests/fixture.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAA;AAC/D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAA;AACjD,OAAO,EAAe,QAAQ,EAA0D,MAAM,sBAAsB,CAAA;AACpH,OAAO,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAA;AAEhD,OAAO,KAAK,KAAK,IAAI,MAAM,oBAAoB,CAAA;AAE/C,MAAM,MAAM,IAAI,GAAG;IACjB,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,SAAS,EAAE,OAAO,CAAA;CACnB,CAAA;AAED,MAAM,MAAM,MAAM,GAAG,KAAK,GAAG,QAAQ,GAAG,WAAW,CAAA;AAEnD,MAAM,MAAM,QAAQ,GAAG;IACrB,WAAW,EAAE,MAAM,CAAA;IACnB,MAAM,EAAE,MAAM,CAAA;CACf,CAAA;AAED,eAAO,MAAM,KAAK;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;UAQjB,CAAA;AAED,eAAO,MAAM,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;UAQf,CAAA;AAED,eAAO,MAAM,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAAiB,CAAA;AACpC,eAAO,MAAM,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAAyB,CAAA;AAE5C,MAAM,WAAW,aAAc,SAAQ,eAAe,CAAC,YAAY,CAAC;IAAE,MAAM,EAAE,OAAO,MAAM,CAAA;CAAE,CAAC;CAAG;AAEjG,eAAO,MAAM,WAAW,4DAIrB;IACD,UAAU,CAAC,EAAE,IAAI,CAAC,MAAM,CAAA;IACxB,WAAW,CAAC,EAAE,IAAI,CAAC,OAAO,CAAA;IAC1B,wBAAwB,CAAC,EAAE,OAAO,CAAA;CACnC;;;6EAaiF,CAAA"}
+{"version":3,"file":"fixture.d.ts","sourceRoot":"","sources":["../../../src/utils/tests/fixture.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAA;AAC/D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAA;AACjD,OAAO,EAAe,QAAQ,EAAc,MAAM,sBAAsB,CAAA;AACxE,OAAO,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAA;AAEhD,OAAO,KAAK,KAAK,IAAI,MAAM,oBAAoB,CAAA;AAE/C,MAAM,MAAM,IAAI,GAAG;IACjB,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,SAAS,EAAE,OAAO,CAAA;CACnB,CAAA;AAED,MAAM,MAAM,MAAM,GAAG,KAAK,GAAG,QAAQ,GAAG,WAAW,CAAA;AAEnD,MAAM,MAAM,QAAQ,GAAG;IACrB,WAAW,EAAE,MAAM,CAAA;IACnB,MAAM,EAAE,MAAM,CAAA;CACf,CAAA;AAED,eAAO,MAAM,KAAK;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;UAQjB,CAAA;AAED,eAAO,MAAM,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;UAQf,CAAA;AAED,eAAO,MAAM,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAAiB,CAAA;AACpC,eAAO,MAAM,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAAyB,CAAA;AAE5C,MAAM,WAAW,aAAc,SAAQ,eAAe,CAAC,YAAY,CAAC;IAAE,MAAM,EAAE,OAAO,MAAM,CAAA;CAAE,CAAC;CAAG;AAEjG,eAAO,MAAM,WAAW,kCAGrB;IACD,UAAU,CAAC,EAAE,IAAI,CAAC,MAAM,CAAA;IACxB,WAAW,CAAC,EAAE,IAAI,CAAC,OAAO,CAAA;CAC3B,wHAUiF,CAAA"}

package/dist/utils/tests/fixture.js

@@ -1,5 +1,5 @@
 import { provideOtel } from '@livestore/common';
-import { createStore, DbSchema, globalReactivityGraph, makeReactivityGraph, makeSchema } from '@livestore/livestore';
+import { createStore, DbSchema, makeSchema } from '@livestore/livestore';
 import { Effect } from '@livestore/utils/effect';
 import { makeInMemoryAdapter } from '@livestore/web';
 export const todos = DbSchema.table('todos', {
@@ -14,15 +14,13 @@ export const app = DbSchema.table('app', {
 }, { isSingleton: true });
 export const tables = { todos, app };
 export const schema = makeSchema({ tables });
-export const makeTodoMvc = ({ otelTracer, otelContext, useGlobalReactivityGraph = true, } = {}) => Effect.gen(function* () {
-    const reactivityGraph = useGlobalReactivityGraph ? globalReactivityGraph : makeReactivityGraph();
+export const makeTodoMvc = ({ otelTracer, otelContext, } = {}) => Effect.gen(function* () {
     const store = yield* createStore({
         schema,
         storeId: 'default',
         adapter: makeInMemoryAdapter(),
-        reactivityGraph,
         debug: { instanceId: 'test' },
     });
-    return { store, reactivityGraph };
+    return store;
 }).pipe(provideOtel({ parentSpanContext: otelContext, otelTracer: otelTracer }));
 //# sourceMappingURL=fixture.js.map

package/dist/utils/tests/fixture.js.map

@@ -1 +1 @@
-{"version":3,"file":"fixture.js","sourceRoot":"","sources":["../../../src/utils/tests/fixture.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAG/C,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAA;AACpH,OAAO,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAA;AAChD,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAA;AAgBpD,MAAM,CAAC,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CACjC,OAAO,EACP;IACE,EAAE,EAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC;IACvC,IAAI,EAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;IACrD,SAAS,EAAE,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;CACjE,EACD,EAAE,eAAe,EAAE,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,CAC9C,CAAA;AAED,MAAM,CAAC,MAAM,GAAG,GAAG,QAAQ,CAAC,KAAK,CAC/B,KAAK,EACL;IACE,EAAE,EAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,UAAU,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC;IAC1D,WAAW,EAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IAC3D,MAAM,EAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;CAC3D,EACD,EAAE,WAAW,EAAE,IAAI,EAAE,CACtB,CAAA;AAED,MAAM,CAAC,MAAM,MAAM,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,CAAA;AACpC,MAAM,CAAC,MAAM,MAAM,GAAG,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC,CAAA;AAI5C,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,EAC1B,UAAU,EACV,WAAW,EACX,wBAAwB,GAAG,IAAI,MAK7B,EAAE,EAAE,EAAE,CACR,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;IAClB,MAAM,eAAe,GAAG,wBAAwB,CAAC,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,mBAAmB,EAAE,CAAA;IAEhG,MAAM,KAAK,GAA8B,KAAK,CAAC,CAAC,WAAW,CAAC;QAC1D,MAAM;QACN,OAAO,EAAE,SAAS;QAClB,OAAO,EAAE,mBAAmB,EAAE;QAC9B,eAAe;QACf,KAAK,EAAE,EAAE,UAAU,EAAE,MAAM,EAAE;KAC9B,CAAC,CAAA;IAEF,OAAO,EAAE,KAAK,EAAE,eAAe,EAAE,CAAA;AACnC,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,iBAAiB,EAAE,WAAW,EAAE,UAAU,EAAE,UAAU,EAAE,CAAC,CAAC,CAAA"}
+{"version":3,"file":"fixture.js","sourceRoot":"","sources":["../../../src/utils/tests/fixture.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAG/C,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAA;AACxE,OAAO,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAA;AAChD,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAA;AAgBpD,MAAM,CAAC,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CACjC,OAAO,EACP;IACE,EAAE,EAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC;IACvC,IAAI,EAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;IACrD,SAAS,EAAE,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;CACjE,EACD,EAAE,eAAe,EAAE,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,CAC9C,CAAA;AAED,MAAM,CAAC,MAAM,GAAG,GAAG,QAAQ,CAAC,KAAK,CAC/B,KAAK,EACL;IACE,EAAE,EAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,UAAU,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC;IAC1D,WAAW,EAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IAC3D,MAAM,EAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;CAC3D,EACD,EAAE,WAAW,EAAE,IAAI,EAAE,CACtB,CAAA;AAED,MAAM,CAAC,MAAM,MAAM,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,CAAA;AACpC,MAAM,CAAC,MAAM,MAAM,GAAG,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC,CAAA;AAI5C,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,EAC1B,UAAU,EACV,WAAW,MAIT,EAAE,EAAE,EAAE,CACR,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;IAClB,MAAM,KAAK,GAA8B,KAAK,CAAC,CAAC,WAAW,CAAC;QAC1D,MAAM;QACN,OAAO,EAAE,SAAS;QAClB,OAAO,EAAE,mBAAmB,EAAE;QAC9B,KAAK,EAAE,EAAE,UAAU,EAAE,MAAM,EAAE;KAC9B,CAAC,CAAA;IAEF,OAAO,KAAK,CAAA;AACd,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,iBAAiB,EAAE,WAAW,EAAE,UAAU,EAAE,UAAU,EAAE,CAAC,CAAC,CAAA"}

package/dist/utils/tests/mod.d.ts

@@ -1,3 +1,4 @@
 export * from './fixture.js';
 export * from './otel.js';
+export * as RG from '../../reactive.js';
 //# sourceMappingURL=mod.d.ts.map

package/dist/utils/tests/mod.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../../../src/utils/tests/mod.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAA;AAC5B,cAAc,WAAW,CAAA"}
+{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../../../src/utils/tests/mod.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAA;AAC5B,cAAc,WAAW,CAAA;AACzB,OAAO,KAAK,EAAE,MAAM,mBAAmB,CAAA"}

package/dist/utils/tests/mod.js

@@ -1,3 +1,4 @@
 export * from './fixture.js';
 export * from './otel.js';
+export * as RG from '../../reactive.js';
 //# sourceMappingURL=mod.js.map

package/dist/utils/tests/mod.js.map

@@ -1 +1 @@
-{"version":3,"file":"mod.js","sourceRoot":"","sources":["../../../src/utils/tests/mod.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAA;AAC5B,cAAc,WAAW,CAAA"}
+{"version":3,"file":"mod.js","sourceRoot":"","sources":["../../../src/utils/tests/mod.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAA;AAC5B,cAAc,WAAW,CAAA;AACzB,OAAO,KAAK,EAAE,MAAM,mBAAmB,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@livestore/livestore",
-  "version": "0.3.0-dev.10",
+  "version": "0.3.0-dev.12",
   "type": "module",
   "sideEffects": false,
   "exports": {
@@ -31,9 +31,9 @@
   "dependencies": {
     "@graphql-typed-document-node/core": "3.2.0",
     "@opentelemetry/api": "1.9.0",
-    "@livestore/common": "0.3.0-dev.10",
-    "@livestore/utils": "0.3.0-dev.10",
-    "@livestore/db-schema": "0.3.0-dev.10"
+    "@livestore/common": "0.3.0-dev.12",
+    "@livestore/db-schema": "0.3.0-dev.12",
+    "@livestore/utils": "0.3.0-dev.12"
   },
   "devDependencies": {
     "@opentelemetry/sdk-trace-base": "^1.30.1",
@@ -41,7 +41,7 @@
     "typescript": "^5.7.2",
     "vite": "^6.0.11",
     "vitest": "^2.1.4",
-    "@livestore/web": "0.3.0-dev.10"
+    "@livestore/web": "0.3.0-dev.12"
   },
   "peerDependencies": {
     "graphql": "~16.0"

package/src/{SynchronousDatabaseWrapper.ts → SqliteDbWrapper.ts}

@@ -5,7 +5,9 @@ import type {
   MutableDebugInfo,
   PreparedBindValues,
   PreparedStatement,
-  SynchronousDatabase,
+  SqliteDb,
+  SqliteDbChangeset,
+  SqliteDbSession,
 } from '@livestore/common'
 import { BoundArray, BoundMap, sql } from '@livestore/common'
 import { isDevEnv } from '@livestore/utils'
@@ -21,12 +23,17 @@ export const emptyDebugInfo = (): DebugInfo => ({
   events: new BoundArray(1000),
 })
 
-export class SynchronousDatabaseWrapper {
+/**
+ * This class is mostly adding result caching around a SqliteDb which is used to speed up
+ * SQLite queries when used through the reactivity graph.
+ */
+export class SqliteDbWrapper implements SqliteDb {
+  _tag = 'SqliteDb' as const
   // TODO: how many unique active statements are expected?
   private cachedStmts = new BoundMap<string, PreparedStatement>(200)
   private tablesUsedCache = new BoundMap<string, Set<string>>(200)
   private resultCache = new QueryCache()
-  private db: SynchronousDatabase
+  private db: SqliteDb
   private otelTracer: otel.Tracer
   private otelRootSpanContext: otel.Context
   private tablesUsedStmt
@@ -36,7 +43,7 @@ export class SynchronousDatabaseWrapper {
     db,
     otel,
   }: {
-    db: SynchronousDatabase
+    db: SqliteDb
     otel: {
       tracer: otel.Tracer
       rootSpanContext: otel.Context
@@ -54,6 +61,25 @@ export class SynchronousDatabaseWrapper {
 
     configureSQLite(this)
   }
+  metadata: any
+  prepare(queryStr: string): PreparedStatement {
+    return this.db.prepare(queryStr)
+  }
+  import(data: Uint8Array<ArrayBufferLike> | SqliteDb<any, any>) {
+    return this.db.import(data)
+  }
+  close(): void {
+    return this.db.close()
+  }
+  destroy(): void {
+    return this.db.destroy()
+  }
+  session(): SqliteDbSession {
+    return this.db.session()
+  }
+  makeChangeset(data: Uint8Array): SqliteDbChangeset {
+    return this.db.makeChangeset(data)
+  }
 
   txn<TRes>(callback: () => TRes): TRes {
     this.execute(sql`begin transaction;`)
@@ -121,9 +147,13 @@ export class SynchronousDatabaseWrapper {
 
   execute(
     queryStr: string,
-    bindValues?: PreparedBindValues,
-    writeTables?: ReadonlySet<string>,
-    options?: { hasNoEffects?: boolean; otelContext?: otel.Context },
+    bindValues?: PreparedBindValues | undefined,
+    options?: {
+      hasNoEffects?: boolean
+      otelContext?: otel.Context
+      writeTables?: ReadonlySet<string>
+      onRowsChanged?: (rowsChanged: number) => void
+    },
   ): { durationMs: number } {
     // console.debug('in-memory-db:execute', query, bindValues)
 
@@ -144,7 +174,7 @@ export class SynchronousDatabaseWrapper {
         if (options?.hasNoEffects !== true && !this.resultCache.ignoreQuery(queryStr)) {
           // TODO use write tables instead
           // check what queries actually end up here.
-          this.resultCache.invalidate(writeTables ?? this.getTablesUsed(queryStr))
+          this.resultCache.invalidate(options?.writeTables ?? this.getTablesUsed(queryStr))
         }
 
         span.end()
@@ -172,14 +202,14 @@ export class SynchronousDatabaseWrapper {
 
   select<T = any>(
     queryStr: string,
+    bindValues?: PreparedBindValues | undefined,
     options?: {
       queriedTables?: ReadonlySet<string>
-      bindValues?: PreparedBindValues
       skipCache?: boolean
       otelContext?: otel.Context
     },
   ): ReadonlyArray<T> {
-    const { queriedTables, bindValues, skipCache = false, otelContext } = options ?? {}
+    const { queriedTables, skipCache = false, otelContext } = options ?? {}
 
     // console.debug('in-memory-db:select', query, bindValues)
 
@@ -252,13 +282,12 @@ export class SynchronousDatabaseWrapper {
 }
 
 /** Set up SQLite performance; hasn't been super carefully optimized yet. */
-const configureSQLite = (db: SynchronousDatabaseWrapper) => {
+const configureSQLite = (db: SqliteDbWrapper) => {
   db.execute(
     // TODO: revisit these tuning parameters for max performance
     sql`
       PRAGMA page_size=32768;
       PRAGMA cache_size=10000;
-      PRAGMA journal_mode='MEMORY'; -- we don't flush to disk before committing a write
       PRAGMA synchronous='OFF';
       PRAGMA temp_store='MEMORY';
       PRAGMA foreign_keys='ON'; -- we want foreign key constraints to be enforced

package/src/effect/LiveStore.ts

@@ -5,20 +5,26 @@ import { Context, Deferred, Duration, Effect, Layer, pipe } from '@livestore/uti
 import type * as otel from '@opentelemetry/api'
 import type { GraphQLSchema } from 'graphql'
 
+import type { SqliteDbWrapper } from '../SqliteDbWrapper.js'
 import { createStore } from '../store/create-store.js'
 import type { Store } from '../store/store.js'
 import type { BaseGraphQLContext, LiveStoreContextRunning as LiveStoreContextRunning_ } from '../store/store-types.js'
-import type { SynchronousDatabaseWrapper } from '../SynchronousDatabaseWrapper.js'
 
-export type LiveStoreContextRunning = LiveStoreContextRunning_
-export const LiveStoreContextRunning = Context.GenericTag<LiveStoreContextRunning>(
-  '@livestore/livestore/effect/LiveStoreContextRunning',
-)
+export class LiveStoreContextRunning extends Context.Tag('@livestore/livestore/effect/LiveStoreContextRunning')<
+  LiveStoreContextRunning,
+  LiveStoreContextRunning_
+>() {
+  static fromDeferred = Effect.gen(function* () {
+    const deferred = yield* DeferredStoreContext
+    const ctx = yield* deferred
+    return Layer.succeed(LiveStoreContextRunning, ctx)
+  }).pipe(Layer.unwrapScoped)
+}
 
-export type DeferredStoreContext = Deferred.Deferred<LiveStoreContextRunning, UnexpectedError>
-export const DeferredStoreContext = Context.GenericTag<DeferredStoreContext>(
-  '@livestore/livestore/effect/DeferredStoreContext',
-)
+export class DeferredStoreContext extends Context.Tag('@livestore/livestore/effect/DeferredStoreContext')<
+  DeferredStoreContext,
+  Deferred.Deferred<LiveStoreContextRunning['Type'], UnexpectedError>
+>() {}
 
 export type LiveStoreContextProps<GraphQLContext extends BaseGraphQLContext> = {
   schema: LiveStoreSchema
@@ -33,9 +39,11 @@ export type LiveStoreContextProps<GraphQLContext extends BaseGraphQLContext> = {
   storeId?: string
   graphQLOptions?: {
     schema: Effect.Effect<GraphQLSchema, never, OtelTracer.OtelTracer>
-    makeContext: (db: SynchronousDatabaseWrapper, tracer: otel.Tracer, sessionId: string) => GraphQLContext
+    makeContext: (db: SqliteDbWrapper, tracer: otel.Tracer, sessionId: string) => GraphQLContext
   }
-  boot?: (store: Store<GraphQLContext, LiveStoreSchema>) => Effect.Effect<void, unknown, OtelTracer.OtelTracer>
+  boot?: (
+    store: Store<GraphQLContext, LiveStoreSchema>,
+  ) => Effect.Effect<void, unknown, OtelTracer.OtelTracer | LiveStoreContextRunning>
   adapter: Adapter
   disableDevtools?: boolean
   onBootStatus?: (status: BootStatus) => void
@@ -52,7 +60,7 @@ export const LiveStoreContextLayer = <GraphQLContext extends BaseGraphQLContext>
 
 export const LiveStoreContextDeferred = Layer.effect(
   DeferredStoreContext,
-  Deferred.make<LiveStoreContextRunning, UnexpectedError>(),
+  Deferred.make<LiveStoreContextRunning['Type'], UnexpectedError>(),
 )
 
 export const makeLiveStoreContext = <GraphQLContext extends BaseGraphQLContext>({
@@ -65,7 +73,7 @@ export const makeLiveStoreContext = <GraphQLContext extends BaseGraphQLContext>(
   onBootStatus,
   batchUpdates,
 }: LiveStoreContextProps<GraphQLContext>): Effect.Effect<
-  LiveStoreContextRunning,
+  LiveStoreContextRunning['Type'],
   UnexpectedError | Cause.TimeoutException,
   DeferredStoreContext | Scope.Scope | OtelTracer.OtelTracer
 > =>
@@ -92,7 +100,7 @@ export const makeLiveStoreContext = <GraphQLContext extends BaseGraphQLContext>(
       }
       globalThis.__debugLiveStore[storeId] = store
 
-      return { stage: 'running', store } satisfies LiveStoreContextRunning
+      return { stage: 'running', store } satisfies LiveStoreContextRunning['Type']
     }),
     Effect.tapErrorCause((cause) => Effect.flatMap(DeferredStoreContext, (def) => Deferred.failCause(def, cause))),
     Effect.tap((storeCtx) => Effect.flatMap(DeferredStoreContext, (def) => Deferred.succeed(def, storeCtx))),

package/src/index.ts

@@ -8,10 +8,15 @@ export type {
   OtelOptions,
 } from './store/store-types.js'
 
-export type { LiveStoreContextRunning } from './effect/LiveStore.js'
-export { StoreAbort, StoreInterrupted, type LiveStoreContext, type ShutdownDeferred } from './store/store-types.js'
+export {
+  StoreAbort,
+  StoreInterrupted,
+  type LiveStoreContext,
+  type ShutdownDeferred,
+  type LiveStoreContextRunning,
+} from './store/store-types.js'
 
-export { SynchronousDatabaseWrapper, emptyDebugInfo } from './SynchronousDatabaseWrapper.js'
+export { SqliteDbWrapper, emptyDebugInfo } from './SqliteDbWrapper.js'
 
 export type {
   GetAtom,
@@ -26,8 +31,9 @@ export type {
   Effect,
 } from './reactive.js'
 export { LiveStoreComputedQuery, computed } from './live-queries/computed.js'
-export { LiveStoreDbQuery, queryDb } from './live-queries/db.js'
+export { LiveStoreDbQuery, queryDb } from './live-queries/db-query.js'
 export { LiveStoreGraphQLQuery, queryGraphQL } from './live-queries/graphql.js'
+export { makeRef, type LiveQueryRef } from './live-queries/make-ref.js'
 export {
   type GetAtomResult,
   type ReactivityGraph,
@@ -35,10 +41,11 @@ export {
   type LiveQuery,
   type GetResult,
   type LiveQueryAny,
+  type LiveQueryDef,
+  type LiveQueryDefAny,
+  type RcRef,
 } from './live-queries/base-class.js'
 
-export { globalReactivityGraph } from './global-state.js'
-
 export { deriveColQuery } from './row-query-utils.js'
 
 export * from '@livestore/common/schema'
@@ -46,7 +53,7 @@ export {
   sql,
   SessionIdSymbol,
   type BootStatus,
-  type SynchronousDatabase,
+  type SqliteDb,
   type DebugInfo,
   type MutableDebugInfo,
   prepareBindValues,