@livestore/livestore 0.3.2-dev.0 → 0.3.2-dev.10

package/src/live-queries/db-query.test.ts

@@ -1,16 +1,14 @@
-import { sql } from '@livestore/common'
-import { rawSqlEvent } from '@livestore/common/schema'
 import { Effect, ReadonlyRecord, Schema } from '@livestore/utils/effect'
 import { Vitest } from '@livestore/utils-dev/node-vitest'
 import * as otel from '@opentelemetry/api'
 import { BasicTracerProvider, InMemorySpanExporter, SimpleSpanProcessor } from '@opentelemetry/sdk-trace-base'
 import { expect } from 'vitest'
 
-import * as RG from '../reactive.js'
-import { makeTodoMvc, tables } from '../utils/tests/fixture.js'
-import { getSimplifiedRootSpan } from '../utils/tests/otel.js'
-import { computed } from './computed.js'
-import { queryDb } from './db-query.js'
+import * as RG from '../reactive.ts'
+import { events, makeTodoMvc, tables } from '../utils/tests/fixture.ts'
+import { getSimplifiedRootSpan } from '../utils/tests/otel.ts'
+import { computed } from './computed.ts'
+import { queryDb } from './db-query.ts'
 
 /*
 TODO write tests for:
@@ -65,7 +63,7 @@ Vitest.describe('otel', () => {
       })
       expect(store.query(query$)).toMatchInlineSnapshot('[]')
 
-      store.commit(rawSqlEvent({ sql: sql`INSERT INTO todos (id, text, completed) VALUES ('t1', 'buy milk', 0)` }))
+      store.commit(events.todoCreated({ id: 't1', text: 'buy milk', completed: false }))
 
       expect(store.query(query$)).toMatchInlineSnapshot(`
       [
@@ -119,7 +117,7 @@ Vitest.describe('otel', () => {
 
       expect(store.reactivityGraph.getSnapshot({ includeResults: true })).toMatchSnapshot()
 
-      store.commit(rawSqlEvent({ sql: sql`INSERT INTO todos (id, text, completed) VALUES ('t1', 'buy milk', 0)` }))
+      store.commit(events.todoCreated({ id: 't1', text: 'buy milk', completed: false }))
 
       expect(store.reactivityGraph.getSnapshot({ includeResults: true })).toMatchSnapshot()
 
@@ -167,7 +165,7 @@ Vitest.describe('otel', () => {
       }
     `)
 
-      store.commit(rawSqlEvent({ sql: sql`INSERT INTO todos (id, text, completed) VALUES ('t1', 'buy milk', 0)` }))
+      store.commit(events.todoCreated({ id: 't1', text: 'buy milk', completed: false }))
 
       expect(store.query(query$)).toMatchInlineSnapshot(`
       {
@@ -212,7 +210,7 @@ Vitest.describe('otel', () => {
       expect(callbackResults).toHaveLength(1)
       expect(callbackResults[0]).toMatchObject(defaultTodo)
 
-      store.commit(rawSqlEvent({ sql: sql`INSERT INTO todos (id, text, completed) VALUES ('t1', 'buy milk', 0)` }))
+      store.commit(events.todoCreated({ id: 't1', text: 'buy milk', completed: false }))
 
       expect(callbackResults).toHaveLength(2)
       expect(callbackResults[1]).toMatchObject({
@@ -264,14 +262,14 @@ Vitest.describe('otel', () => {
       expect(callbackResults1).toHaveLength(1)
       expect(callbackResults2).toHaveLength(1)
 
-      store.commit(rawSqlEvent({ sql: sql`INSERT INTO todos (id, text, completed) VALUES ('t3', 'read book', 0)` }))
+      store.commit(events.todoCreated({ id: 't3', text: 'read book', completed: false }))
 
       expect(callbackResults1).toHaveLength(2)
       expect(callbackResults2).toHaveLength(2)
 
       unsubscribe1()
 
-      store.commit(rawSqlEvent({ sql: sql`INSERT INTO todos (id, text, completed) VALUES ('t4', 'cook dinner', 0)` }))
+      store.commit(events.todoCreated({ id: 't4', text: 'cook dinner', completed: false }))
 
       expect(callbackResults1).toHaveLength(2)
       expect(callbackResults2).toHaveLength(3)
@@ -307,7 +305,7 @@ Vitest.describe('otel', () => {
       expect(callbackResults).toHaveLength(1)
       expect(callbackResults[0]).toEqual([])
 
-      store.commit(rawSqlEvent({ sql: sql`INSERT INTO todos (id, text, completed) VALUES ('t5', 'clean house', 1)` }))
+      store.commit(events.todoCreated({ id: 't5', text: 'clean house', completed: true }))
 
       expect(callbackResults).toHaveLength(2)
       expect(callbackResults[1]).toHaveLength(1)

package/src/live-queries/db-query.ts

@@ -13,13 +13,13 @@ import { deepEqual, shouldNeverHappen } from '@livestore/utils'
 import { Predicate, Schema, TreeFormatter } from '@livestore/utils/effect'
 import * as otel from '@opentelemetry/api'
 
-import type { Thunk } from '../reactive.js'
-import { isThunk, NOT_REFRESHED_YET } from '../reactive.js'
-import type { RefreshReason } from '../store/store-types.js'
-import { isValidFunctionString } from '../utils/function-string.js'
-import type { DepKey, GetAtomResult, LiveQueryDef, ReactivityGraph, ReactivityGraphContext } from './base-class.js'
-import { depsToString, LiveStoreQueryBase, makeGetAtomResult, withRCMap } from './base-class.js'
-import { makeExecBeforeFirstRun, rowQueryLabel } from './client-document-get-query.js'
+import type { Thunk } from '../reactive.ts'
+import { isThunk, NOT_REFRESHED_YET } from '../reactive.ts'
+import type { RefreshReason } from '../store/store-types.ts'
+import { isValidFunctionString } from '../utils/function-string.ts'
+import type { DepKey, GetAtomResult, LiveQueryDef, ReactivityGraph, ReactivityGraphContext } from './base-class.ts'
+import { depsToString, LiveStoreQueryBase, makeGetAtomResult, withRCMap } from './base-class.ts'
+import { makeExecBeforeFirstRun, rowQueryLabel } from './client-document-get-query.ts'
 
 export type QueryInputRaw<TDecoded, TEncoded> = {
   query: string

package/src/live-queries/mod.ts

@@ -1,4 +1,4 @@
-export * from './base-class.js'
-export * from './computed.js'
-export * from './db-query.js'
-export * from './signal.js'
+export * from './base-class.ts'
+export * from './computed.ts'
+export * from './db-query.ts'
+export * from './signal.ts'

package/src/live-queries/signal.test.ts

@@ -2,9 +2,9 @@ import { Effect } from '@livestore/utils/effect'
 import { Vitest } from '@livestore/utils-dev/node-vitest'
 import { expect } from 'vitest'
 
-import { makeTodoMvc } from '../utils/tests/fixture.js'
-import { computed } from './computed.js'
-import { signal } from './signal.js'
+import { makeTodoMvc } from '../utils/tests/fixture.ts'
+import { computed } from './computed.ts'
+import { signal } from './signal.ts'
 
 Vitest.describe('signal', () => {
   Vitest.scopedLive('should be able to create a signal', () =>

package/src/live-queries/signal.ts

@@ -1,9 +1,9 @@
 import { nanoid } from '@livestore/utils/nanoid'
 
-import type * as RG from '../reactive.js'
-import type { RefreshReason } from '../store/store-types.js'
-import type { ISignal, ReactivityGraph, ReactivityGraphContext, SignalDef } from './base-class.js'
-import { LiveStoreQueryBase, withRCMap } from './base-class.js'
+import type * as RG from '../reactive.ts'
+import type { RefreshReason } from '../store/store-types.ts'
+import type { ISignal, ReactivityGraph, ReactivityGraphContext, SignalDef } from './base-class.ts'
+import { LiveStoreQueryBase, withRCMap } from './base-class.ts'
 
 export const signal = <T>(
   defaultValue: T,

package/src/mod.ts

@@ -1,51 +1,45 @@
-export { Store } from './store/store.js'
-export { createStore, createStorePromise, type CreateStoreOptions } from './store/create-store.js'
-export type { QueryDebugInfo, RefreshReason, OtelOptions } from './store/store-types.js'
-// We're re-exporting `Schema` from `effect` for convenience
-export { Schema } from '@livestore/utils/effect'
-
-export {
-  type LiveStoreContext,
-  type LiveStoreContextRunning,
-  type ShutdownDeferred,
-  makeShutdownDeferred,
-} from './store/store-types.js'
-
-export { SqliteDbWrapper, emptyDebugInfo } from './SqliteDbWrapper.js'
-
-export {
-  queryDb,
-  computed,
-  signal,
-  type LiveQuery,
-  type LiveQueryDef,
-  type Signal,
-  type SignalDef,
-  type RcRef,
-} from './live-queries/mod.js'
-
-export * from '@livestore/common/schema'
+export type { Adapter, ClientSession, PreparedStatement } from '@livestore/common'
 export {
-  sql,
-  SessionIdSymbol,
+  type Bindable,
   type BootStatus,
-  type SqliteDb,
   type DebugInfo,
+  IntentionalShutdownCause,
   type MutableDebugInfo,
-  prepareBindValues,
-  type Bindable,
   type PreparedBindValues,
-  type QueryBuilderAst,
+  prepareBindValues,
+  provideOtel,
   type QueryBuilder,
+  type QueryBuilderAst,
   type RowQuery,
+  SessionIdSymbol,
+  type SqliteDb,
   StoreInterrupted,
-  IntentionalShutdownCause,
-  provideOtel,
+  sql,
 } from '@livestore/common'
-
+export * from '@livestore/common/schema'
 export { deepEqual } from '@livestore/utils'
+// We're re-exporting `Schema` from `effect` for convenience
+export { Schema } from '@livestore/utils/effect'
 export { nanoid } from '@livestore/utils/nanoid'
 
-export * from './utils/stack-info.js'
-
-export type { ClientSession, Adapter, PreparedStatement } from '@livestore/common'
+export {
+  computed,
+  type LiveQuery,
+  type LiveQueryDef,
+  queryDb,
+  type RcRef,
+  type Signal,
+  type SignalDef,
+  signal,
+} from './live-queries/mod.ts'
+export { emptyDebugInfo, SqliteDbWrapper } from './SqliteDbWrapper.ts'
+export { type CreateStoreOptions, createStore, createStorePromise } from './store/create-store.ts'
+export { Store } from './store/store.ts'
+export type { OtelOptions, QueryDebugInfo, RefreshReason } from './store/store-types.ts'
+export {
+  type LiveStoreContext,
+  type LiveStoreContextRunning,
+  makeShutdownDeferred,
+  type ShutdownDeferred,
+} from './store/store-types.ts'
+export * from './utils/stack-info.ts'

package/src/reactive.test.ts

@@ -1,6 +1,6 @@
 import { describe, expect, it } from 'vitest'
 
-import { ReactiveGraph } from './reactive.js'
+import { ReactiveGraph } from './reactive.ts'
 
 describe('a trivial graph', () => {
   const makeGraph = () => {

package/src/reactive.ts

@@ -21,13 +21,11 @@
 //   is maintained eagerly as edges are added and removed.)
 // - At every thunk we check value equality with the previous value and cutoff propagation if possible.
 
-/* eslint-disable prefer-arrow/prefer-arrow-functions */
-
 import { BoundArray } from '@livestore/common'
 import { deepEqual, shouldNeverHappen } from '@livestore/utils'
 import type { Types } from '@livestore/utils/effect'
 import type * as otel from '@opentelemetry/api'
-// import { getDurationMsFromSpan } from './otel.js'
+// import { getDurationMsFromSpan } from './otel.ts'
 
 export const NOT_REFRESHED_YET = Symbol.for('NOT_REFRESHED_YET')
 export type NOT_REFRESHED_YET = typeof NOT_REFRESHED_YET
@@ -279,7 +277,7 @@ export class ReactiveGraph<
             return compute(atom, otelContext, debugRefreshReason)
           }
 
-          let debugInfo: TDebugThunkInfo | undefined 
+          let debugInfo: TDebugThunkInfo | undefined
           const setDebugInfo = (debugInfo_: TDebugThunkInfo) => {
             debugInfo = debugInfo_
           }

package/src/store/create-store.ts

@@ -3,6 +3,7 @@ import type {
   BootStatus,
   ClientSession,
   ClientSessionDevtoolsChannel,
+  ClientSessionSyncProcessorSimulationParams,
   IntentionalShutdownCause,
   MigrationsReport,
 } from '@livestore/common'
@@ -29,13 +30,13 @@ import {
 import { nanoid } from '@livestore/utils/nanoid'
 import * as otel from '@opentelemetry/api'
 
-import { connectDevtoolsToStore } from './devtools.js'
-import { Store } from './store.js'
+import { connectDevtoolsToStore } from './devtools.ts'
+import { Store } from './store.ts'
 import type {
   LiveStoreContextRunning as LiveStoreContextRunning_,
   OtelOptions,
   ShutdownDeferred,
-} from './store-types.js'
+} from './store-types.ts'
 
 export const DEFAULT_PARAMS = {
   leaderPushBatchSize: 100,
@@ -120,6 +121,9 @@ export interface CreateStoreOptions<TSchema extends LiveStoreSchema, TContext =
   syncPayload?: Schema.JsonValue
   params?: {
     leaderPushBatchSize?: number
+    simulation?: {
+      clientSessionSyncProcessor: typeof ClientSessionSyncProcessorSimulationParams.Type
+    }
   }
   debug?: {
     instanceId?: string
@@ -274,6 +278,7 @@ export const createStore = <TSchema extends LiveStoreSchema = LiveStoreSchema, T
         storeId,
         params: {
           leaderPushBatchSize: params?.leaderPushBatchSize ?? DEFAULT_PARAMS.leaderPushBatchSize,
+          simulation: params?.simulation,
         },
       })
 

package/src/store/devtools.ts

@@ -5,11 +5,11 @@ import type { WebChannel } from '@livestore/utils/effect'
 import { Effect, Stream } from '@livestore/utils/effect'
 import { nanoid } from '@livestore/utils/nanoid'
 
-import type { LiveQuery, ReactivityGraph } from '../live-queries/base-class.js'
-import { NOT_REFRESHED_YET } from '../reactive.js'
-import type { SqliteDbWrapper } from '../SqliteDbWrapper.js'
-import { emptyDebugInfo as makeEmptyDebugInfo } from '../SqliteDbWrapper.js'
-import type { ReferenceCountedSet } from '../utils/data-structures.js'
+import type { LiveQuery, ReactivityGraph } from '../live-queries/base-class.ts'
+import { NOT_REFRESHED_YET } from '../reactive.ts'
+import type { SqliteDbWrapper } from '../SqliteDbWrapper.ts'
+import { emptyDebugInfo as makeEmptyDebugInfo } from '../SqliteDbWrapper.ts'
+import type { ReferenceCountedSet } from '../utils/data-structures.ts'
 
 type IStore = {
   clientSession: ClientSession

package/src/store/store-types.ts

@@ -1,12 +1,18 @@
-import type { ClientSession, IntentionalShutdownCause, StoreInterrupted, UnexpectedError } from '@livestore/common'
+import type {
+  ClientSession,
+  ClientSessionSyncProcessorSimulationParams,
+  IntentionalShutdownCause,
+  StoreInterrupted,
+  UnexpectedError,
+} from '@livestore/common'
 import type { EventSequenceNumber, LiveStoreEvent, LiveStoreSchema } from '@livestore/common/schema'
 import type { Effect, Runtime, Scope } from '@livestore/utils/effect'
 import { Deferred } from '@livestore/utils/effect'
 import type * as otel from '@opentelemetry/api'
 
-import type { DebugRefreshReasonBase } from '../reactive.js'
-import type { StackInfo } from '../utils/stack-info.js'
-import type { Store } from './store.js'
+import type { DebugRefreshReasonBase } from '../reactive.ts'
+import type { StackInfo } from '../utils/stack-info.ts'
+import type { Store } from './store.ts'
 
 export type LiveStoreContext =
   | LiveStoreContextRunning
@@ -49,6 +55,9 @@ export type StoreOptions<TSchema extends LiveStoreSchema = LiveStoreSchema, TCon
   batchUpdates: (runUpdates: () => void) => void
   params: {
     leaderPushBatchSize: number
+    simulation?: {
+      clientSessionSyncProcessor: typeof ClientSessionSyncProcessorSimulationParams.Type
+    }
   }
   __runningInDevtools: boolean
 }

package/src/store/store.ts

@@ -32,15 +32,15 @@ import type {
   ReactivityGraph,
   ReactivityGraphContext,
   SignalDef,
-} from '../live-queries/base-class.js'
-import { makeReactivityGraph } from '../live-queries/base-class.js'
-import { makeExecBeforeFirstRun } from '../live-queries/client-document-get-query.js'
-import { queryDb } from '../live-queries/db-query.js'
-import type { Ref } from '../reactive.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'
+} from '../live-queries/base-class.ts'
+import { makeReactivityGraph } from '../live-queries/base-class.ts'
+import { makeExecBeforeFirstRun } from '../live-queries/client-document-get-query.ts'
+import { queryDb } from '../live-queries/db-query.ts'
+import type { Ref } from '../reactive.ts'
+import { SqliteDbWrapper } from '../SqliteDbWrapper.ts'
+import { ReferenceCountedSet } from '../utils/data-structures.ts'
+import { downloadBlob, exposeDebugUtils } from '../utils/dev.ts'
+import type { StackInfo } from '../utils/stack-info.ts'
 import type {
   RefreshReason,
   StoreCommitOptions,
@@ -48,7 +48,7 @@ import type {
   StoreOptions,
   StoreOtel,
   Unsubscribe,
-} from './store-types.js'
+} from './store-types.ts'
 
 if (isDevEnv()) {
   exposeDebugUtils()
@@ -195,6 +195,7 @@ export class Store<TSchema extends LiveStoreSchema = LiveStoreSchema, TContext =
       span: syncSpan,
       params: {
         leaderPushBatchSize: params.leaderPushBatchSize,
+        simulation: params.simulation?.clientSessionSyncProcessor,
       },
       confirmUnsavedChanges,
     })

package/src/utils/dev.ts

@@ -1,7 +1,6 @@
 import { isDevEnv } from '@livestore/utils'
 import { Effect } from '@livestore/utils/effect'
 
-/* eslint-disable unicorn/prefer-global-this */
 export const downloadBlob = (
   data: Uint8Array | Blob | string,
   fileName: string,

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

@@ -1,6 +1,6 @@
 import { expect, it } from 'vitest'
 
-import { extractStackInfoFromStackTrace } from './stack-info.js'
+import { extractStackInfoFromStackTrace } from './stack-info.ts'
 
 it('RouteLink stacktrace', async () => {
   const stackTrace = `\

package/src/utils/tests/fixture.ts

@@ -1,6 +1,6 @@
 import { makeInMemoryAdapter } from '@livestore/adapter-web'
 import { provideOtel } from '@livestore/common'
-import { createStore, makeSchema, State } from '@livestore/livestore'
+import { createStore, Events, makeSchema, State } from '@livestore/livestore'
 import { Effect, Schema } from '@livestore/utils/effect'
 import type * as otel from '@opentelemetry/api'
 
@@ -37,8 +37,23 @@ export const app = State.SQLite.clientDocument({
 
 export const tables = { todos, app }
 
-export const state = State.SQLite.makeState({ tables, materializers: {} })
-export const schema = makeSchema({ state, events: {} })
+export const events = {
+  todoCreated: Events.synced({
+    name: 'todo.created',
+    schema: Schema.Struct({
+      id: Schema.String,
+      text: Schema.String,
+      completed: Schema.Boolean,
+    }),
+  }),
+}
+
+const materializers = State.SQLite.materializers(events, {
+  'todo.created': ({ id, text, completed }) => tables.todos.insert({ id, text, completed }),
+})
+
+export const state = State.SQLite.makeState({ tables, materializers })
+export const schema = makeSchema({ state, events })
 
 export const makeTodoMvc = ({
   otelTracer,

package/src/utils/tests/mod.ts

@@ -1,3 +1,3 @@
-export * from './fixture.js'
-export * from './otel.js'
-export * as RG from '../../reactive.js'
+export * as RG from '../../reactive.ts'
+export * from './fixture.ts'
+export * from './otel.ts'

package/src/utils/tests/otel.ts

@@ -1,6 +1,7 @@
 import { identity } from '@livestore/utils/effect'
 import type { Attributes } from '@opentelemetry/api'
 import type { InMemorySpanExporter, ReadableSpan } from '@opentelemetry/sdk-trace-base'
+
 type SimplifiedNestedSpan = { _name: string; attributes: any; children: SimplifiedNestedSpan[] }
 
 export const getSimplifiedRootSpan = (