@livestore/livestore 0.0.0-snapshot-2b8a9de3ec1a701aca891ebc2c98eb328274ae9e → 0.0.0-snapshot-2c861249e50661661613204300b1fc0d902c2e46

package/src/store/store.ts

@@ -9,7 +9,7 @@ import type {
 import {
   Devtools,
   getDurationMsFromSpan,
-  getExecArgsFromMutation,
+  getExecArgsFromEvent,
   getResultSchema,
   IntentionalShutdownCause,
   isQueryBuilder,
@@ -21,25 +21,16 @@ import {
 } from '@livestore/common'
 import type { LiveStoreSchema } from '@livestore/common/schema'
 import {
-  getMutationDef,
-  MutationEvent,
+  getEventDef,
+  LEADER_MERGE_COUNTER_TABLE,
+  LiveStoreEvent,
+  SCHEMA_EVENT_DEFS_META_TABLE,
   SCHEMA_META_TABLE,
-  SCHEMA_MUTATIONS_META_TABLE,
   SESSION_CHANGESET_META_TABLE,
 } from '@livestore/common/schema'
 import { assertNever, isDevEnv } from '@livestore/utils'
 import type { Scope } from '@livestore/utils/effect'
-import {
-  Cause,
-  Data,
-  Effect,
-  Inspectable,
-  MutableHashMap,
-  OtelTracer,
-  Runtime,
-  Schema,
-  Stream,
-} from '@livestore/utils/effect'
+import { Cause, Effect, Inspectable, OtelTracer, Runtime, Schema, Stream } from '@livestore/utils/effect'
 import { nanoid } from '@livestore/utils/nanoid'
 import * as otel from '@opentelemetry/api'
 
@@ -51,13 +42,13 @@ import type {
   ReactivityGraphContext,
 } from '../live-queries/base-class.js'
 import { makeReactivityGraph } from '../live-queries/base-class.js'
+import { makeExecBeforeFirstRun } from '../live-queries/row-query-utils.js'
 import type { Ref } from '../reactive.js'
-import { makeExecBeforeFirstRun } from '../row-query-utils.js'
 import { SqliteDbWrapper } from '../SqliteDbWrapper.js'
 import { ReferenceCountedSet } from '../utils/data-structures.js'
 import { downloadBlob, exposeDebugUtils } from '../utils/dev.js'
 import type { StackInfo } from '../utils/stack-info.js'
-import type { RefreshReason, StoreMutateOptions, StoreOptions, StoreOtel, Unsubscribe } from './store-types.js'
+import type { RefreshReason, StoreCommitOptions, StoreOptions, StoreOtel, Unsubscribe } from './store-types.js'
 
 if (isDevEnv()) {
   exposeDebugUtils()
@@ -77,16 +68,17 @@ export class Store<TSchema extends LiveStoreSchema = LiveStoreSchema, TContext =
    */
   tableRefs: { [key: string]: Ref<null, ReactivityGraphContext, RefreshReason> }
 
-  private runtime: Runtime.Runtime<Scope.Scope>
+  private effectContext: {
+    runtime: Runtime.Runtime<Scope.Scope>
+    lifetimeScope: Scope.Scope
+  }
 
   /** RC-based set to see which queries are currently subscribed to */
   activeQueries: ReferenceCountedSet<LiveQuery<any>>
 
-  // NOTE this is currently exposed for the Devtools databrowser to emit mutation events
-  readonly __mutationEventSchema
-  private unsyncedMutationEvents
+  // NOTE this is currently exposed for the Devtools databrowser to commit events
+  readonly __eventSchema
   readonly syncProcessor: ClientSessionSyncProcessor
-  readonly lifetimeScope: Scope.Scope
 
   readonly boot: Effect.Effect<void, UnexpectedError, Scope.Scope>
 
@@ -96,27 +88,23 @@ export class Store<TSchema extends LiveStoreSchema = LiveStoreSchema, TContext =
     schema,
     otelOptions,
     context,
-    disableDevtools,
     batchUpdates,
-    unsyncedMutationEvents,
     storeId,
-    lifetimeScope,
-    runtime,
+    effectContext,
     params,
     confirmUnsavedChanges,
+    __runningInDevtools,
   }: StoreOptions<TSchema, TContext>) {
     super()
 
     this.storeId = storeId
-    this.unsyncedMutationEvents = unsyncedMutationEvents
 
     this.sqliteDbWrapper = new SqliteDbWrapper({ otel: otelOptions, db: clientSession.sqliteDb })
     this.clientSession = clientSession
     this.schema = schema
     this.context = context
 
-    this.lifetimeScope = lifetimeScope
-    this.runtime = runtime
+    this.effectContext = effectContext
 
     const reactivityGraph = makeReactivityGraph()
 
@@ -125,13 +113,13 @@ export class Store<TSchema extends LiveStoreSchema = LiveStoreSchema, TContext =
     this.syncProcessor = makeClientSessionSyncProcessor({
       schema,
       clientSession,
-      runtime,
-      applyMutation: (mutationEventDecoded, { otelContext, withChangeset }) => {
-        const mutationDef = getMutationDef(schema, mutationEventDecoded.mutation)
+      runtime: effectContext.runtime,
+      applyEvent: (eventDecoded, { otelContext, withChangeset }) => {
+        const eventDef = getEventDef(schema, eventDecoded.name)
 
-        const execArgsArr = getExecArgsFromMutation({
-          mutationDef,
-          mutationEvent: { decoded: mutationEventDecoded, encoded: undefined },
+        const execArgsArr = getExecArgsFromEvent({
+          eventDef,
+          event: { decoded: eventDecoded, encoded: undefined },
         })
 
         const writeTablesForEvent = new Set<string>()
@@ -149,7 +137,10 @@ export class Store<TSchema extends LiveStoreSchema = LiveStoreSchema, TContext =
           }
         }
 
-        let sessionChangeset: Uint8Array | undefined
+        let sessionChangeset:
+          | { _tag: 'sessionChangeset'; data: Uint8Array; debug: any }
+          | { _tag: 'no-op' }
+          | { _tag: 'unset' } = { _tag: 'unset' }
         if (withChangeset === true) {
           sessionChangeset = this.sqliteDbWrapper.withChangeset(exec).changeset
         } else {
@@ -177,14 +168,14 @@ export class Store<TSchema extends LiveStoreSchema = LiveStoreSchema, TContext =
       confirmUnsavedChanges,
     })
 
-    this.__mutationEventSchema = MutationEvent.makeMutationEventSchemaMemo(schema)
+    this.__eventSchema = LiveStoreEvent.makeEventDefSchemaMemo(schema)
 
     // TODO generalize the `tableRefs` concept to allow finer-grained refs
     this.tableRefs = {}
     this.activeQueries = new ReferenceCountedSet()
 
-    const mutationsSpan = otelOptions.tracer.startSpan('LiveStore:mutations', {}, otelOptions.rootSpanContext)
-    const otelMuationsSpanContext = otel.trace.setSpan(otel.context.active(), mutationsSpan)
+    const commitsSpan = otelOptions.tracer.startSpan('LiveStore:commits', {}, otelOptions.rootSpanContext)
+    const otelMuationsSpanContext = otel.trace.setSpan(otel.context.active(), commitsSpan)
 
     const queriesSpan = otelOptions.tracer.startSpan('LiveStore:queries', {}, otelOptions.rootSpanContext)
     const otelQueriesSpanContext = otel.trace.setSpan(otel.context.active(), queriesSpan)
@@ -201,22 +192,22 @@ export class Store<TSchema extends LiveStoreSchema = LiveStoreSchema, TContext =
 
     this.otel = {
       tracer: otelOptions.tracer,
-      mutationsSpanContext: otelMuationsSpanContext,
+      commitsSpanContext: otelMuationsSpanContext,
       queriesSpanContext: otelQueriesSpanContext,
     }
 
-    // TODO find a better way to detect if we're running LiveStore in the LiveStore devtools
-    // But for now this is a good enough approximation with little downsides
-    const isRunningInDevtools = disableDevtools === true
-
     // Need a set here since `schema.tables` might contain duplicates and some componentStateTables
     const allTableNames = new Set(
-      // NOTE we're excluding the LiveStore schema and mutations tables as they are not user-facing
+      // NOTE we're excluding the LiveStore schema and events tables as they are not user-facing
       // unless LiveStore is running in the devtools
-      isRunningInDevtools
+      __runningInDevtools
         ? this.schema.tables.keys()
         : Array.from(this.schema.tables.keys()).filter(
-            (_) => _ !== SCHEMA_META_TABLE && _ !== SCHEMA_MUTATIONS_META_TABLE && _ !== SESSION_CHANGESET_META_TABLE,
+            (_) =>
+              _ !== SCHEMA_META_TABLE &&
+              _ !== SCHEMA_EVENT_DEFS_META_TABLE &&
+              _ !== SESSION_CHANGESET_META_TABLE &&
+              _ !== LEADER_MERGE_COUNTER_TABLE,
           ),
     )
     const existingTableRefs = new Map(
@@ -240,7 +231,7 @@ export class Store<TSchema extends LiveStoreSchema = LiveStoreSchema, TContext =
 
           // End the otel spans
           syncSpan.end()
-          mutationsSpan.end()
+          commitsSpan.end()
           queriesSpan.end()
         }),
       )
@@ -268,11 +259,11 @@ export class Store<TSchema extends LiveStoreSchema = LiveStoreSchema, TContext =
    * ```
    */
   subscribe = <TResult>(
-    query: LiveQueryDef<TResult, any> | LiveQuery<TResult, any>,
+    query: LiveQueryDef<TResult> | LiveQuery<TResult>,
     options: {
       /** Called when the query result has changed */
       onUpdate: (value: TResult) => void
-      onSubscribe?: (query$: LiveQuery<TResult, any>) => void
+      onSubscribe?: (query$: LiveQuery<TResult>) => void
       /** Gets called after the query subscription has been removed */
       onUnsubsubscribe?: () => void
       label?: string
@@ -346,7 +337,7 @@ export class Store<TSchema extends LiveStoreSchema = LiveStoreSchema, TContext =
     )
 
   subscribeStream = <TResult>(
-    query$: LiveQueryDef<TResult, any>,
+    query$: LiveQueryDef<TResult>,
     options?: { label?: string; skipInitialRun?: boolean } | undefined,
   ): Stream.Stream<TResult> =>
     Stream.asyncPush<TResult>((emit) =>
@@ -386,8 +377,8 @@ export class Store<TSchema extends LiveStoreSchema = LiveStoreSchema, TContext =
   query = <TResult>(
     query:
       | QueryBuilder<TResult, any, any>
-      | LiveQuery<TResult, any>
-      | LiveQueryDef<TResult, any>
+      | LiveQuery<TResult>
+      | LiveQueryDef<TResult>
       | { query: string; bindValues: ParamsObject },
     options?: { otelContext?: otel.Context; debugRefreshReason?: RefreshReason },
   ): TResult => {
@@ -401,7 +392,7 @@ export class Store<TSchema extends LiveStoreSchema = LiveStoreSchema, TContext =
         makeExecBeforeFirstRun({
           table: ast.tableDef,
           id: ast.id,
-          insertValues: ast.insertValues,
+          explicitDefaultValues: ast.explicitDefaultValues,
           otelContext: options?.otelContext,
         })(this.reactivityGraph.context!)
       }
@@ -424,6 +415,8 @@ export class Store<TSchema extends LiveStoreSchema = LiveStoreSchema, TContext =
     }
   }
 
+  atom = (): TODO => {}
+
   // makeLive: {
   //   <T>(def: LiveQueryDef<T, any>): LiveQuery<T, any>
   //   <T>(def: ILiveQueryRefDef<T>): ILiveQueryRef<T>
@@ -443,42 +436,42 @@ export class Store<TSchema extends LiveStoreSchema = LiveStoreSchema, TContext =
 
   // #region commit
   /**
-   * Commit a list of mutations to the store which will immediately update the local database
-   * and sync the mutations across other clients (similar to a `git commit`).
+   * Commit a list of events to the store which will immediately update the local database
+   * and sync the events across other clients (similar to a `git commit`).
    *
    * @example
    * ```ts
-   * store.commit(mutations.todoCreated({ id: nanoid(), text: 'Make coffee' }))
+   * store.commit(events.todoCreated({ id: nanoid(), text: 'Make coffee' }))
    * ```
    *
-   * You can call `commit` with multiple mutations to apply them in a single database transaction.
+   * You can call `commit` with multiple events to apply them in a single database transaction.
    *
    * @example
    * ```ts
    * const todoId = nanoid()
    * store.commit(
-   *   mutations.todoCreated({ id: todoId, text: 'Make coffee' }),
-   *   mutations.todoCompleted({ id: todoId }))
+   *   events.todoCreated({ id: todoId, text: 'Make coffee' }),
+   *   events.todoCompleted({ id: todoId }))
    * ```
    *
    * For more advanced transaction scenarios, you can pass a synchronous function to `commit` which will receive a callback
-   * to which you can pass multiple mutations to be committed in the same database transaction.
-   * Under the hood this will simply collect all mutations and apply them in a single database transaction.
+   * to which you can pass multiple events to be committed in the same database transaction.
+   * Under the hood this will simply collect all events and apply them in a single database transaction.
    *
    * @example
    * ```ts
    * store.commit((commit) => {
    *   const todoId = nanoid()
    *   if (Math.random() > 0.5) {
-   *     commit(mutations.todoCreated({ id: todoId, text: 'Make coffee' }))
+   *     commit(events.todoCreated({ id: todoId, text: 'Make coffee' }))
    *   } else {
-   *     commit(mutations.todoCompleted({ id: todoId }))
+   *     commit(events.todoCompleted({ id: todoId }))
    *   }
    * })
    * ```
    *
-   * When committing a large batch of mutations, you can also skip the database refresh to improve performance
-   * and call `store.manualRefresh()` after all mutations have been committed.
+   * When committing a large batch of events, you can also skip the database refresh to improve performance
+   * and call `store.manualRefresh()` after all events have been committed.
    *
    * @example
    * ```ts
@@ -488,44 +481,44 @@ export class Store<TSchema extends LiveStoreSchema = LiveStoreSchema, TContext =
    *   // ... 1000 more todos
    * ]
    * for (const todo of todos) {
-   *   store.commit({ skipRefresh: true }, mutations.todoCreated({ id: todo.id, text: todo.text }))
+   *   store.commit({ skipRefresh: true }, events.todoCreated({ id: todo.id, text: todo.text }))
    * }
    * store.manualRefresh()
    * ```
    */
   commit: {
-    <const TMutationArg extends ReadonlyArray<MutationEvent.PartialForSchema<TSchema>>>(...list: TMutationArg): void
+    <const TCommitArg extends ReadonlyArray<LiveStoreEvent.PartialForSchema<TSchema>>>(...list: TCommitArg): void
     (
-      txn: <const TMutationArg extends ReadonlyArray<MutationEvent.PartialForSchema<TSchema>>>(
-        ...list: TMutationArg
+      txn: <const TCommitArg extends ReadonlyArray<LiveStoreEvent.PartialForSchema<TSchema>>>(
+        ...list: TCommitArg
       ) => void,
     ): void
-    <const TMutationArg extends ReadonlyArray<MutationEvent.PartialForSchema<TSchema>>>(
-      options: StoreMutateOptions,
-      ...list: TMutationArg
+    <const TCommitArg extends ReadonlyArray<LiveStoreEvent.PartialForSchema<TSchema>>>(
+      options: StoreCommitOptions,
+      ...list: TCommitArg
     ): void
     (
-      options: StoreMutateOptions,
-      txn: <const TMutationArg extends ReadonlyArray<MutationEvent.PartialForSchema<TSchema>>>(
-        ...list: TMutationArg
+      options: StoreCommitOptions,
+      txn: <const TCommitArg extends ReadonlyArray<LiveStoreEvent.PartialForSchema<TSchema>>>(
+        ...list: TCommitArg
       ) => void,
     ): void
-  } = (firstMutationOrTxnFnOrOptions: any, ...restMutations: any[]) => {
-    const { mutationsEvents, options } = this.getMutateArgs(firstMutationOrTxnFnOrOptions, restMutations)
+  } = (firstEventOrTxnFnOrOptions: any, ...restEvents: any[]) => {
+    const { events, options } = this.getCommitArgs(firstEventOrTxnFnOrOptions, restEvents)
 
-    for (const mutationEvent of mutationsEvents) {
-      replaceSessionIdSymbol(mutationEvent.args, this.clientSession.sessionId)
+    for (const event of events) {
+      replaceSessionIdSymbol(event.args, this.clientSession.sessionId)
     }
 
-    if (mutationsEvents.length === 0) return
+    if (events.length === 0) return
 
     const skipRefresh = options?.skipRefresh ?? false
 
-    const mutationsSpan = otel.trace.getSpan(this.otel.mutationsSpanContext)!
-    mutationsSpan.addEvent('commit')
+    const commitsSpan = otel.trace.getSpan(this.otel.commitsSpanContext)!
+    commitsSpan.addEvent('commit')
 
     // console.group('LiveStore.commit', { skipRefresh, wasSyncMessage, label })
-    // mutationsEvents.forEach((_) => console.debug(_.mutation, _.id, _.args))
+    // events.forEach((_) => console.debug(_.name, _.id, _.args))
     // console.groupEnd()
 
     let durationMs: number
@@ -534,26 +527,26 @@ export class Store<TSchema extends LiveStoreSchema = LiveStoreSchema, TContext =
       'LiveStore:commit',
       {
         attributes: {
-          'livestore.mutationEventsCount': mutationsEvents.length,
-          'livestore.mutationEventTags': mutationsEvents.map((_) => _.mutation),
+          'livestore.eventsCount': events.length,
+          'livestore.eventTags': events.map((_) => _.name),
           'livestore.commitLabel': options?.label,
         },
         links: options?.spanLinks,
       },
-      options?.otelContext ?? this.otel.mutationsSpanContext,
+      options?.otelContext ?? this.otel.commitsSpanContext,
       (span) => {
         const otelContext = otel.trace.setSpan(otel.context.active(), span)
 
         try {
           const { writeTables } = (() => {
             try {
-              const applyMutations = () => this.syncProcessor.push(mutationsEvents, { otelContext })
+              const applyEvents = () => this.syncProcessor.push(events, { otelContext })
 
-              if (mutationsEvents.length > 1) {
+              if (events.length > 1) {
                 // TODO: what to do about leader transaction here?
-                return this.sqliteDbWrapper.txn(applyMutations)
+                return this.sqliteDbWrapper.txn(applyEvents)
               } else {
-                return applyMutations()
+                return applyEvents()
               }
             } catch (e: any) {
               console.error(e)
@@ -573,7 +566,7 @@ export class Store<TSchema extends LiveStoreSchema = LiveStoreSchema, TContext =
 
           const debugRefreshReason = {
             _tag: 'commit' as const,
-            mutations: mutationsEvents,
+            events,
             writeTables: Array.from(writeTables),
           }
 
@@ -596,7 +589,7 @@ export class Store<TSchema extends LiveStoreSchema = LiveStoreSchema, TContext =
   // #endregion commit
 
   /**
-   * This can be used in combination with `skipRefresh` when applying mutations.
+   * This can be used in combination with `skipRefresh` when committing events.
    * We might need a better solution for this. Let's see.
    */
   manualRefresh = (options?: { label?: string }) => {
@@ -604,7 +597,7 @@ export class Store<TSchema extends LiveStoreSchema = LiveStoreSchema, TContext =
     this.otel.tracer.startActiveSpan(
       'LiveStore:manualRefresh',
       { attributes: { 'livestore.manualRefreshLabel': label } },
-      this.otel.mutationsSpanContext,
+      this.otel.commitsSpanContext,
       (span) => {
         const otelContext = otel.trace.setSpan(otel.context.active(), span)
         this.reactivityGraph.runDeferredEffects({ otelContext })
@@ -633,10 +626,10 @@ export class Store<TSchema extends LiveStoreSchema = LiveStoreSchema, TContext =
       }).pipe(this.runEffectFork)
     },
 
-    downloadMutationLogDb: () => {
+    downloadEventlogDb: () => {
       Effect.gen(this, function* () {
-        const data = yield* this.clientSession.leaderThread.getMutationLogData
-        downloadBlob(data, `livestore-mutationlog-${Date.now()}.db`)
+        const data = yield* this.clientSession.leaderThread.getEventlogData
+        downloadBlob(data, `livestore-eventlog-${Date.now()}.db`)
       }).pipe(this.runEffectFork)
     },
 
@@ -671,41 +664,46 @@ export class Store<TSchema extends LiveStoreSchema = LiveStoreSchema, TContext =
   })
 
   private runEffectFork = <A, E>(effect: Effect.Effect<A, E, Scope.Scope>) =>
-    effect.pipe(Effect.forkIn(this.lifetimeScope), Effect.tapCauseLogPretty, Runtime.runFork(this.runtime))
+    effect.pipe(
+      Effect.forkIn(this.effectContext.lifetimeScope),
+      Effect.tapCauseLogPretty,
+      Runtime.runFork(this.effectContext.runtime),
+    )
 
-  private getMutateArgs = (
-    firstMutationOrTxnFnOrOptions: any,
-    restMutations: any[],
+  private getCommitArgs = (
+    firstEventOrTxnFnOrOptions: any,
+    restEvents: any[],
   ): {
-    mutationsEvents: (MutationEvent.ForSchema<TSchema> | MutationEvent.PartialForSchema<TSchema>)[]
-    options: StoreMutateOptions | undefined
+    events: LiveStoreEvent.PartialForSchema<TSchema>[]
+    options: StoreCommitOptions | undefined
   } => {
-    let mutationsEvents: (MutationEvent.ForSchema<TSchema> | MutationEvent.PartialForSchema<TSchema>)[]
-    let options: StoreMutateOptions | undefined
+    let events: LiveStoreEvent.PartialForSchema<TSchema>[]
+    let options: StoreCommitOptions | undefined
 
-    if (typeof firstMutationOrTxnFnOrOptions === 'function') {
+    if (typeof firstEventOrTxnFnOrOptions === 'function') {
       // TODO ensure that function is synchronous and isn't called in a async way (also write tests for this)
-      mutationsEvents = firstMutationOrTxnFnOrOptions((arg: any) => mutationsEvents.push(arg))
+      events = firstEventOrTxnFnOrOptions((arg: any) => events.push(arg))
     } else if (
-      firstMutationOrTxnFnOrOptions?.label !== undefined ||
-      firstMutationOrTxnFnOrOptions?.skipRefresh !== undefined ||
-      firstMutationOrTxnFnOrOptions?.otelContext !== undefined ||
-      firstMutationOrTxnFnOrOptions?.spanLinks !== undefined
+      firstEventOrTxnFnOrOptions?.label !== undefined ||
+      firstEventOrTxnFnOrOptions?.skipRefresh !== undefined ||
+      firstEventOrTxnFnOrOptions?.otelContext !== undefined ||
+      firstEventOrTxnFnOrOptions?.spanLinks !== undefined
     ) {
-      options = firstMutationOrTxnFnOrOptions
-      mutationsEvents = restMutations
-    } else if (firstMutationOrTxnFnOrOptions === undefined) {
-      // When `commit` is called with no arguments (which sometimes happens when dynamically filtering mutations)
-      mutationsEvents = []
+      options = firstEventOrTxnFnOrOptions
+      events = restEvents
+    } else if (firstEventOrTxnFnOrOptions === undefined) {
+      // When `commit` is called with no arguments (which sometimes happens when dynamically filtering events)
+      events = []
     } else {
-      mutationsEvents = [firstMutationOrTxnFnOrOptions, ...restMutations]
+      events = [firstEventOrTxnFnOrOptions, ...restEvents]
     }
 
-    mutationsEvents = mutationsEvents.filter(
-      // @ts-expect-error TODO
-      (_) => _.id === undefined || !MutableHashMap.has(this.unsyncedMutationEvents, Data.struct(_.id)),
-    )
+    // for (const event of events) {
+    //   if (event.args.id === SessionIdSymbol) {
+    //     event.args.id = this.clientSession.sessionId
+    //   }
+    // }
 
-    return { mutationsEvents, options }
+    return { events, options }
   }
 }

package/src/utils/stack-info.test.ts

@@ -86,7 +86,7 @@ Error:
     at Object.useMemo (/Users/schickling/Code/overtone/node_modules/.pnpm/react-dom@19.0.0_react@19.0.0/node_modules/react-dom/cjs/react-dom-client.development.js:22757:18)
     at Object.process.env.NODE_ENV.exports.useMemo (/Users/schickling/Code/overtone/node_modules/.pnpm/react@19.0.0/node_modules/react/cjs/react.development.js:1488:34)
     at Module.useQueryRef (/Users/schickling/Code/overtone/submodules/livestore/packages/@livestore/react/src/useQuery.ts:54:27)
-    at Module.useRow (/Users/schickling/Code/overtone/submodules/livestore/packages/@livestore/react/src/useRow.ts:111:20)
+    at Module.useClientDocument (/Users/schickling/Code/overtone/submodules/livestore/packages/@livestore/react/src/useClientDocument.ts:111:20)
     at TestComponent (/Users/schickling/Code/overtone/node_modules/.pnpm/@testing-library+react@16.1.0_@testing-library+dom@10.4.0_@types+react-dom@19.0.3_@types+reac_2jaiibiag2sxou3wtzbuqx3r5a/node_modules/@testing-library/react/dist/pure.js:309:27)
     at Object.react-stack-bottom-frame (/Users/schickling/Code/overtone/node_modules/.pnpm/react-dom@19.0.0_react@19.0.0/node_modules/react-dom/cjs/react-dom-client.development.js:22428:20)
     at renderWithHooks (/Users/schickling/Code/overtone/node_modules/.pnpm/react-dom@19.0.0_react@19.0.0/node_modules/react-dom/cjs/react-dom-client.development.js:5757:22)
@@ -101,8 +101,8 @@ Error:
           "name": "TestComponent",
         },
         {
-          "filePath": "/Users/schickling/Code/overtone/submodules/livestore/packages/@livestore/react/src/useRow.ts:111:20",
-          "name": "useRow",
+          "filePath": "/Users/schickling/Code/overtone/submodules/livestore/packages/@livestore/react/src/useClientDocument.ts:111:20",
+          "name": "useClientDocument",
         },
       ],
     }
@@ -117,7 +117,7 @@ Error:
     at Object.useMemo (/Users/schickling/Code/overtone/node_modules/.pnpm/react-dom@19.0.0_react@19.0.0/node_modules/react-dom/cjs/react-dom-client.development.js:22757:18)
     at Object.process.env.NODE_ENV.exports.useMemo (/Users/schickling/Code/overtone/node_modules/.pnpm/react@19.0.0/node_modules/react/cjs/react.development.js:1488:34)
     at Module.useQueryRef (/Users/schickling/Code/overtone/submodules/livestore/packages/@livestore/react/src/useQuery.ts:54:27)
-    at Module.useRow (/Users/schickling/Code/overtone/submodules/livestore/packages/@livestore/react/src/useRow.ts:111:20)
+    at Module.useClientDocument (/Users/schickling/Code/overtone/submodules/livestore/packages/@livestore/react/src/useClientDocument.ts:111:20)
     at Object.react-stack-bottom-frame (/Users/schickling/Code/overtone/node_modules/.pnpm/react-dom@19.0.0_react@19.0.0/node_modules/react-dom/cjs/react-dom-client.development.js:22428:20)
     at renderWithHooks (/Users/schickling/Code/overtone/node_modules/.pnpm/react-dom@19.0.0_react@19.0.0/node_modules/react-dom/cjs/react-dom-client.development.js:5757:22)
   `
@@ -127,8 +127,8 @@ Error:
     {
       "frames": [
         {
-          "filePath": "/Users/schickling/Code/overtone/submodules/livestore/packages/@livestore/react/src/useRow.ts:111:20",
-          "name": "useRow",
+          "filePath": "/Users/schickling/Code/overtone/submodules/livestore/packages/@livestore/react/src/useClientDocument.ts:111:20",
+          "name": "useClientDocument",
         },
       ],
     }

package/src/utils/tests/fixture.ts

@@ -1,9 +1,7 @@
 import { makeInMemoryAdapter } from '@livestore/adapter-web'
 import { provideOtel } from '@livestore/common'
-import type { FromInputSchema } from '@livestore/common/schema'
-import type { Store } from '@livestore/livestore'
-import { createStore, DbSchema, makeSchema } from '@livestore/livestore'
-import { Effect } from '@livestore/utils/effect'
+import { createStore, makeSchema, State } from '@livestore/livestore'
+import { Effect, Schema } from '@livestore/utils/effect'
 import type * as otel from '@opentelemetry/api'
 
 export type Todo = {
@@ -19,30 +17,28 @@ export type AppState = {
   filter: Filter
 }
 
-export const todos = DbSchema.table(
-  'todos',
-  {
-    id: DbSchema.text({ primaryKey: true }),
-    text: DbSchema.text({ default: '', nullable: false }),
-    completed: DbSchema.boolean({ default: false, nullable: false }),
+export const todos = State.SQLite.table({
+  name: 'todos',
+  columns: {
+    id: State.SQLite.text({ primaryKey: true }),
+    text: State.SQLite.text({ default: '', nullable: false }),
+    completed: State.SQLite.boolean({ default: false, nullable: false }),
   },
-  { deriveMutations: true, isSingleton: false },
-)
-
-export const app = DbSchema.table(
-  'app',
-  {
-    id: DbSchema.text({ primaryKey: true, default: 'static' }),
-    newTodoText: DbSchema.text({ default: '', nullable: true }),
-    filter: DbSchema.text({ default: 'all', nullable: false }),
-  },
-  { isSingleton: true },
-)
+})
+
+export const app = State.SQLite.clientDocument({
+  name: 'app',
+  schema: Schema.Struct({
+    newTodoText: Schema.String,
+    filter: Schema.String,
+  }),
+  default: { value: { newTodoText: '', filter: 'all' } },
+})
 
 export const tables = { todos, app }
-export const schema = makeSchema({ tables })
 
-export interface FixtureSchema extends FromInputSchema.DeriveSchema<{ tables: typeof tables }> {}
+export const state = State.SQLite.makeState({ tables, materializers: {} })
+export const schema = makeSchema({ state, events: {} })
 
 export const makeTodoMvc = ({
   otelTracer,
@@ -52,7 +48,7 @@ export const makeTodoMvc = ({
   otelContext?: otel.Context
 } = {}) =>
   Effect.gen(function* () {
-    const store: Store<FixtureSchema> = yield* createStore({
+    const store = yield* createStore({
       schema,
       storeId: 'default',
       adapter: makeInMemoryAdapter(),

package/dist/row-query-utils.d.ts

@@ -1,17 +0,0 @@
-import type { QueryInfo } from '@livestore/common';
-import { SessionIdSymbol } from '@livestore/common';
-import { DbSchema } from '@livestore/common/schema';
-import type * as otel from '@opentelemetry/api';
-import type { GetResult, LiveQueryDef, ReactivityGraphContext } from './live-queries/base-class.js';
-export declare const rowQueryLabel: (table: DbSchema.TableDefBase, id: string | SessionIdSymbol | number | undefined) => string;
-export declare const deriveColQuery: {
-    <TQueryDef extends LiveQueryDef<any, QueryInfo.None>, TCol extends keyof GetResult<TQueryDef> & string>(queryDef: TQueryDef, colName: TCol): LiveQueryDef<GetResult<TQueryDef>[TCol], QueryInfo.None>;
-    <TQueryDef extends LiveQueryDef<any, QueryInfo.Row>, TCol extends keyof GetResult<TQueryDef> & string>(queryDef: TQueryDef, colName: TCol): LiveQueryDef<GetResult<TQueryDef>[TCol], QueryInfo.Col>;
-};
-export declare const makeExecBeforeFirstRun: ({ id, insertValues, table, otelContext: otelContext_, }: {
-    id?: string | SessionIdSymbol | number;
-    insertValues?: any;
-    table: DbSchema.TableDefBase;
-    otelContext: otel.Context | undefined;
-}) => ({ store }: ReactivityGraphContext) => undefined;
-//# sourceMappingURL=row-query-utils.d.ts.map

package/dist/row-query-utils.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"row-query-utils.d.ts","sourceRoot":"","sources":["../src/row-query-utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAsB,SAAS,EAAE,MAAM,mBAAmB,CAAA;AACtE,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AACnD,OAAO,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAA;AAEnD,OAAO,KAAK,KAAK,IAAI,MAAM,oBAAoB,CAAA;AAE/C,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,sBAAsB,EAAE,MAAM,8BAA8B,CAAA;AAGnG,eAAO,MAAM,aAAa,GAAI,OAAO,QAAQ,CAAC,YAAY,EAAE,IAAI,MAAM,GAAG,eAAe,GAAG,MAAM,GAAG,SAAS,WACH,CAAA;AAE1G,eAAO,MAAM,cAAc,EAAE;IAC3B,CAAC,SAAS,SAAS,YAAY,CAAC,GAAG,EAAE,SAAS,CAAC,IAAI,CAAC,EAAE,IAAI,SAAS,MAAM,SAAS,CAAC,SAAS,CAAC,GAAG,MAAM,EACpG,QAAQ,EAAE,SAAS,EACnB,OAAO,EAAE,IAAI,GACZ,YAAY,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,EAAE,SAAS,CAAC,IAAI,CAAC,CAAA;IAC3D,CAAC,SAAS,SAAS,YAAY,CAAC,GAAG,EAAE,SAAS,CAAC,GAAG,CAAC,EAAE,IAAI,SAAS,MAAM,SAAS,CAAC,SAAS,CAAC,GAAG,MAAM,EACnG,QAAQ,EAAE,SAAS,EACnB,OAAO,EAAE,IAAI,GACZ,YAAY,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,EAAE,SAAS,CAAC,GAAG,CAAC,CAAA;CAc3D,CAAA;AAED,eAAO,MAAM,sBAAsB,GAChC,yDAKE;IACD,EAAE,CAAC,EAAE,MAAM,GAAG,eAAe,GAAG,MAAM,CAAA;IACtC,YAAY,CAAC,EAAE,GAAG,CAAA;IAClB,KAAK,EAAE,QAAQ,CAAC,YAAY,CAAA;IAC5B,WAAW,EAAE,IAAI,CAAC,OAAO,GAAG,SAAS,CAAA;CACtC,MACA,WAAW,sBAAsB,cA2BjC,CAAA"}