@livestore/common 0.4.0-dev.9 → 0.5.0-dev.0

package/dist/ClientSessionLeaderThreadProxy.d.ts

@@ -1,33 +1,48 @@
-import type { Effect, Stream } from '@livestore/utils/effect';
+import type { Effect, Stream, Subscribable } from '@livestore/utils/effect';
+import type { StorageMode } from './adapter-types.ts';
 import type { MigrationsReport } from './defs.ts';
 import type * as Devtools from './devtools/mod.ts';
-import type { UnexpectedError } from './errors.ts';
-import type * as EventSequenceNumber from './schema/EventSequenceNumber.ts';
+import type { RejectedPushError } from './leader-thread/RejectedPushError.ts';
+import type { StreamEventsOptions } from './leader-thread/types.ts';
+import type * as EventSequenceNumber from './schema/EventSequenceNumber/mod.ts';
 import type { LiveStoreEvent } from './schema/mod.ts';
-import type { LeaderAheadError } from './sync/sync.ts';
+import type { SyncBackend } from './sync/sync.ts';
 import type { PayloadUpstream, SyncState } from './sync/syncstate.ts';
 export interface ClientSessionLeaderThreadProxy {
     events: {
         pull: (args: {
-            cursor: EventSequenceNumber.EventSequenceNumber;
+            cursor: EventSequenceNumber.Client.Composite;
         }) => Stream.Stream<{
             payload: typeof PayloadUpstream.Type;
-        }, UnexpectedError>;
+        }>;
         /** It's important that a client session doesn't call `push` concurrently. */
-        push(batch: ReadonlyArray<LiveStoreEvent.AnyEncoded>): Effect.Effect<void, UnexpectedError | LeaderAheadError>;
+        push(batch: ReadonlyArray<LiveStoreEvent.Client.Encoded>): Effect.Effect<void, RejectedPushError>;
+        /** Stream events with filtering */
+        stream(options: StreamEventsOptions): Stream.Stream<LiveStoreEvent.Client.Encoded>;
     };
     /** The initial state after the leader thread has booted */
     readonly initialState: {
         /** The latest event sequence number during boot. Used for the client session to resume syncing. */
-        readonly leaderHead: EventSequenceNumber.EventSequenceNumber;
+        readonly leaderHead: EventSequenceNumber.Client.Composite;
         /** The migrations report from the leader thread */
         readonly migrationsReport: MigrationsReport;
+        /**
+         * Indicates how data is being stored.
+         * - `persisted`: Data is persisted to disk (e.g., via OPFS)
+         * - `in-memory`: Data is only stored in memory and will be lost on page refresh (e.g., private browsing)
+         */
+        readonly storageMode: StorageMode;
     };
-    export: Effect.Effect<Uint8Array<ArrayBuffer>, UnexpectedError>;
-    getEventlogData: Effect.Effect<Uint8Array<ArrayBuffer>, UnexpectedError>;
-    getSyncState: Effect.Effect<SyncState, UnexpectedError>;
+    export: Effect.Effect<Uint8Array<ArrayBuffer>>;
+    getEventlogData: Effect.Effect<Uint8Array<ArrayBuffer>>;
+    syncState: Subscribable.Subscribable<SyncState>;
     /** For debugging purposes it can be useful to manually trigger devtools messages (e.g. to reset the database) */
-    sendDevtoolsMessage: (message: Devtools.Leader.MessageToApp) => Effect.Effect<void, UnexpectedError>;
+    sendDevtoolsMessage: (message: Devtools.Leader.MessageToApp) => Effect.Effect<void>;
+    /**
+     * Reactive stream describing the connectivity between the leader and its upstream sync backend.
+     * Includes raw connection state, last transition timestamp, and devtools overrides (latch state).
+     */
+    networkStatus: Subscribable.Subscribable<SyncBackend.NetworkStatus>;
 }
 export declare const of: (proxy: ClientSessionLeaderThreadProxy, options?: {
     overrides?: (original: ClientSessionLeaderThreadProxy) => Partial<ClientSessionLeaderThreadProxy>;

package/dist/ClientSessionLeaderThreadProxy.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ClientSessionLeaderThreadProxy.d.ts","sourceRoot":"","sources":["../src/ClientSessionLeaderThreadProxy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAA;AAE7D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAA;AACjD,OAAO,KAAK,KAAK,QAAQ,MAAM,mBAAmB,CAAA;AAClD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAClD,OAAO,KAAK,KAAK,mBAAmB,MAAM,iCAAiC,CAAA;AAC3E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AACrD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAA;AACtD,OAAO,KAAK,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAA;AAErE,MAAM,WAAW,8BAA8B;IAC7C,MAAM,EAAE;QACN,IAAI,EAAE,CAAC,IAAI,EAAE;YACX,MAAM,EAAE,mBAAmB,CAAC,mBAAmB,CAAA;SAChD,KAAK,MAAM,CAAC,MAAM,CAAC;YAAE,OAAO,EAAE,OAAO,eAAe,CAAC,IAAI,CAAA;SAAE,EAAE,eAAe,CAAC,CAAA;QAC9E,6EAA6E;QAC7E,IAAI,CAAC,KAAK,EAAE,aAAa,CAAC,cAAc,CAAC,UAAU,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,eAAe,GAAG,gBAAgB,CAAC,CAAA;KAC/G,CAAA;IACD,2DAA2D;IAC3D,QAAQ,CAAC,YAAY,EAAE;QACrB,mGAAmG;QACnG,QAAQ,CAAC,UAAU,EAAE,mBAAmB,CAAC,mBAAmB,CAAA;QAC5D,mDAAmD;QACnD,QAAQ,CAAC,gBAAgB,EAAE,gBAAgB,CAAA;KAC5C,CAAA;IACD,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,eAAe,CAAC,CAAA;IAC/D,eAAe,EAAE,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,eAAe,CAAC,CAAA;IACxE,YAAY,EAAE,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,eAAe,CAAC,CAAA;IACvD,iHAAiH;IACjH,mBAAmB,EAAE,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,YAAY,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,eAAe,CAAC,CAAA;CACrG;AAED,eAAO,MAAM,EAAE,GACb,OAAO,8BAA8B,EACrC,UAAU;IAAE,SAAS,CAAC,EAAE,CAAC,QAAQ,EAAE,8BAA8B,KAAK,OAAO,CAAC,8BAA8B,CAAC,CAAA;CAAE,KAC9G,8BAIF,CAAA"}
+{"version":3,"file":"ClientSessionLeaderThreadProxy.d.ts","sourceRoot":"","sources":["../src/ClientSessionLeaderThreadProxy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAA;AAE3E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AACrD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAA;AACjD,OAAO,KAAK,KAAK,QAAQ,MAAM,mBAAmB,CAAA;AAClD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sCAAsC,CAAA;AAC7E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAA;AACnE,OAAO,KAAK,KAAK,mBAAmB,MAAM,qCAAqC,CAAA;AAC/E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AACrD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AACjD,OAAO,KAAK,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAA;AAErE,MAAM,WAAW,8BAA8B;IAC7C,MAAM,EAAE;QACN,IAAI,EAAE,CAAC,IAAI,EAAE;YACX,MAAM,EAAE,mBAAmB,CAAC,MAAM,CAAC,SAAS,CAAA;SAC7C,KAAK,MAAM,CAAC,MAAM,CAAC;YAAE,OAAO,EAAE,OAAO,eAAe,CAAC,IAAI,CAAA;SAAE,CAAC,CAAA;QAC7D,6EAA6E;QAC7E,IAAI,CAAC,KAAK,EAAE,aAAa,CAAC,cAAc,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,iBAAiB,CAAC,CAAA;QACjG,mCAAmC;QACnC,MAAM,CAAC,OAAO,EAAE,mBAAmB,GAAG,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;KACnF,CAAA;IACD,2DAA2D;IAC3D,QAAQ,CAAC,YAAY,EAAE;QACrB,mGAAmG;QACnG,QAAQ,CAAC,UAAU,EAAE,mBAAmB,CAAC,MAAM,CAAC,SAAS,CAAA;QACzD,mDAAmD;QACnD,QAAQ,CAAC,gBAAgB,EAAE,gBAAgB,CAAA;QAC3C;;;;WAIG;QACH,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAA;KAClC,CAAA;IACD,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC,CAAA;IAC9C,eAAe,EAAE,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC,CAAA;IACvD,SAAS,EAAE,YAAY,CAAC,YAAY,CAAC,SAAS,CAAC,CAAA;IAC/C,iHAAiH;IACjH,mBAAmB,EAAE,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,YAAY,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;IACnF;;;OAGG;IACH,aAAa,EAAE,YAAY,CAAC,YAAY,CAAC,WAAW,CAAC,aAAa,CAAC,CAAA;CACpE;AAED,eAAO,MAAM,EAAE,GACb,OAAO,8BAA8B,EACrC,UAAU;IAAE,SAAS,CAAC,EAAE,CAAC,QAAQ,EAAE,8BAA8B,KAAK,OAAO,CAAC,8BAA8B,CAAC,CAAA;CAAE,KAC9G,8BAIF,CAAA"}

package/dist/ClientSessionLeaderThreadProxy.js.map

@@ -1 +1 @@
-{"version":3,"file":"ClientSessionLeaderThreadProxy.js","sourceRoot":"","sources":["../src/ClientSessionLeaderThreadProxy.ts"],"names":[],"mappings":"AAgCA,MAAM,CAAC,MAAM,EAAE,GAAG,CAChB,KAAqC,EACrC,OAA+G,EAC/E,EAAE;IAClC,IAAI,OAAO,EAAE,SAAS,KAAK,SAAS;QAAE,OAAO,KAAK,CAAA;IAElD,OAAO,EAAE,GAAG,KAAK,EAAE,GAAG,OAAO,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAA;AAClD,CAAC,CAAA"}
+{"version":3,"file":"ClientSessionLeaderThreadProxy.js","sourceRoot":"","sources":["../src/ClientSessionLeaderThreadProxy.ts"],"names":[],"mappings":"AA+CA,MAAM,CAAC,MAAM,EAAE,GAAG,CAChB,KAAqC,EACrC,OAA+G,EAC/E,EAAE;IAClC,IAAI,OAAO,EAAE,SAAS,KAAK,SAAS;QAAE,OAAO,KAAK,CAAA;IAElD,OAAO,EAAE,GAAG,KAAK,EAAE,GAAG,OAAO,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAA;AAClD,CAAC,CAAA"}

package/dist/MaterializationJournal.d.ts

@@ -0,0 +1,44 @@
+import { Context, Effect, Layer, Schema } from '@livestore/utils/effect';
+import { type SqliteDb } from './adapter-types.ts';
+import * as EventSequenceNumber from './schema/EventSequenceNumber/mod.ts';
+export declare const TypeId: "~@livestore/common/MaterializationJournal";
+export type TypeId = typeof TypeId;
+export declare const MaterializationJournalErrorTypeId: "~@livestore/common/MaterializationJournalError";
+export declare const isMaterializationJournalError: (u: unknown) => u is MaterializationJournalError;
+declare const MaterializationJournalError_base: Schema.Class<MaterializationJournalError, Schema.TaggedStruct<"MaterializationJournalError", {
+    readonly method: Schema.Literals<readonly ["record", "rollback", "discardUpTo"]>;
+    readonly cause: Schema.Defect;
+}>, import("effect/Cause").YieldableError>;
+export declare class MaterializationJournalError extends MaterializationJournalError_base {
+    readonly [MaterializationJournalErrorTypeId]: "~@livestore/common/MaterializationJournalError";
+}
+export type MaterializationChangeset = {
+    _tag: 'changeset';
+    data: Uint8Array<ArrayBuffer>;
+} | {
+    _tag: 'no-op';
+};
+export type MaterializationRecord = {
+    key: EventSequenceNumber.Client.Composite;
+    changeset: MaterializationChangeset;
+};
+export interface Service {
+    readonly [TypeId]: TypeId;
+    /** Stores a materialization record, replacing any record at the same key. */
+    record: (record: MaterializationRecord) => Effect.Effect<void, MaterializationJournalError>;
+    /** Reverts the keyed materializations in reverse order, then discards their records. */
+    rollback: (keys: ReadonlyArray<EventSequenceNumber.Client.Composite>) => Effect.Effect<void, MaterializationJournalError>;
+    /** Discards records whose key is less than or equal to `key`, ignoring rebase generation. */
+    discardUpTo: (key: EventSequenceNumber.Client.Composite) => Effect.Effect<void, MaterializationJournalError>;
+}
+declare const MaterializationJournal_base: Context.ServiceClass<MaterializationJournal, "@livestore/common/MaterializationJournal", Service>;
+export declare class MaterializationJournal extends MaterializationJournal_base {
+}
+interface Options {
+    readonly dbState: SqliteDb;
+}
+export declare const make: ({ dbState }: Options) => Service;
+export declare const layer: (options: Options) => Layer.Layer<MaterializationJournal, never, never>;
+export declare const layerTest: Layer.Layer<MaterializationJournal, never, never>;
+export {};
+//# sourceMappingURL=MaterializationJournal.d.ts.map

package/dist/MaterializationJournal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MaterializationJournal.d.ts","sourceRoot":"","sources":["../src/MaterializationJournal.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAA4B,MAAM,EAAE,MAAM,yBAAyB,CAAA;AAElG,OAAO,EAAe,KAAK,QAAQ,EAAE,MAAM,oBAAoB,CAAA;AAE/D,OAAO,KAAK,mBAAmB,MAAM,qCAAqC,CAAA;AAM1E,eAAO,MAAM,MAAM,EAAG,2CAAoD,CAAA;AAC1E,MAAM,MAAM,MAAM,GAAG,OAAO,MAAM,CAAA;AAElC,eAAO,MAAM,iCAAiC,EAAG,gDAAyD,CAAA;AAE1G,eAAO,MAAM,6BAA6B,GAAI,GAAG,OAAO,KAAG,CAAC,IAAI,2BACH,CAAA;;;;;AAE7D,qBAAa,2BAA4B,SAAQ,gCAK/C;IACA,QAAQ,CAAC,CAAC,iCAAiC,CAAC,mDAAoC;CACjF;AAED,MAAM,MAAM,wBAAwB,GAAG;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,IAAI,EAAE,UAAU,CAAC,WAAW,CAAC,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,CAAA;AAE/G,MAAM,MAAM,qBAAqB,GAAG;IAClC,GAAG,EAAE,mBAAmB,CAAC,MAAM,CAAC,SAAS,CAAA;IACzC,SAAS,EAAE,wBAAwB,CAAA;CACpC,CAAA;AAED,MAAM,WAAW,OAAO;IACtB,QAAQ,CAAC,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;IACzB,6EAA6E;IAC7E,MAAM,EAAE,CAAC,MAAM,EAAE,qBAAqB,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,2BAA2B,CAAC,CAAA;IAC3F,wFAAwF;IACxF,QAAQ,EAAE,CACR,IAAI,EAAE,aAAa,CAAC,mBAAmB,CAAC,MAAM,CAAC,SAAS,CAAC,KACtD,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,2BAA2B,CAAC,CAAA;IACrD,6FAA6F;IAC7F,WAAW,EAAE,CAAC,GAAG,EAAE,mBAAmB,CAAC,MAAM,CAAC,SAAS,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,2BAA2B,CAAC,CAAA;CAC7G;;AAED,qBAAa,sBAAuB,SAAQ,2BAE3C;CAAG;AAEJ,UAAU,OAAO;IACf,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAA;CAC3B;AAED,eAAO,MAAM,IAAI,GAAI,aAAa,OAAO,YAqHxC,CAAA;AAED,eAAO,MAAM,KAAK,GAAI,SAAS,OAAO,sDAAyD,CAAA;AAE/F,eAAO,MAAM,SAAS,mDAQrB,CAAA"}

package/dist/MaterializationJournal.js

@@ -0,0 +1,112 @@
+import { Context, Effect, Layer, Predicate, ReadonlyArray, Schema } from '@livestore/utils/effect';
+import { SqliteError } from "./adapter-types.js";
+import { execSql, execSqlPrepared } from "./leader-thread/connection.js";
+import * as EventSequenceNumber from "./schema/EventSequenceNumber/mod.js";
+import { SystemTables } from "./schema/mod.js";
+import { findManyRows, insertRow } from "./sql-queries/index.js";
+import * as SqliteDbHelper from "./sqlite-db-helper.js";
+import { prepareBindValues, sql } from "./util.js";
+export const TypeId = '~@livestore/common/MaterializationJournal';
+export const MaterializationJournalErrorTypeId = '~@livestore/common/MaterializationJournalError';
+export const isMaterializationJournalError = (u) => Predicate.hasProperty(u, MaterializationJournalErrorTypeId);
+export class MaterializationJournalError extends Schema.TaggedError(MaterializationJournalErrorTypeId)('MaterializationJournalError', {
+    method: Schema.Literals(['record', 'rollback', 'discardUpTo']),
+    cause: Schema.Defect(),
+}) {
+    [MaterializationJournalErrorTypeId] = MaterializationJournalErrorTypeId;
+}
+export class MaterializationJournal extends Context.Service()('@livestore/common/MaterializationJournal') {
+}
+export const make = ({ dbState }) => {
+    const deleteByKeys = Effect.fnUntraced(function* (keys) {
+        // Keep DELETE statements below SQLite's bound-parameter limit.
+        const keyChunks = ReadonlyArray.chunksOf(100)(keys);
+        for (const keyChunk of keyChunks) {
+            const placeholders = keyChunk.map(() => '(?, ?, ?)').join(', ');
+            const bindValues = keyChunk.flatMap((key) => [key.global, key.client, key.rebaseGeneration]);
+            const statement = sql `DELETE FROM ${SystemTables.MATERIALIZATION_JOURNAL_META_TABLE}
+                            WHERE (seqNumGlobal, seqNumClient, seqNumRebaseGeneration) IN (${placeholders})`;
+            yield* execSqlPrepared(dbState, statement, prepareBindValues(bindValues, statement));
+        }
+    }, SqliteDbHelper.withSavepoint(dbState));
+    return MaterializationJournal.of({
+        [TypeId]: TypeId,
+        record: Effect.fnUntraced(function* (record) {
+            yield* deleteByKeys([record.key]);
+            // Generate the parameterized INSERT statement
+            const [statement, bindValues] = insertRow({
+                tableName: SystemTables.MATERIALIZATION_JOURNAL_META_TABLE,
+                columns: SystemTables.materializationJournalMetaTable.sqliteDef.columns,
+                values: {
+                    seqNumGlobal: record.key.global,
+                    seqNumClient: record.key.client,
+                    seqNumRebaseGeneration: record.key.rebaseGeneration,
+                    changeset: record.changeset._tag === 'changeset' ? record.changeset.data : null,
+                    // Legacy processors still expose this column for development diagnostics.
+                    debug: null,
+                },
+            });
+            yield* execSqlPrepared(dbState, statement, prepareBindValues(bindValues, statement));
+        }, SqliteDbHelper.withSavepoint(dbState), Effect.mapError((cause) => new MaterializationJournalError({ method: 'record', cause }))),
+        rollback: Effect.fnUntraced(function* (keys) {
+            const sortedKeys = keys.toSorted((a, b) => EventSequenceNumber.Client.compare(b, a));
+            const rollbackRecords = yield* Effect.forEach(sortedKeys, Effect.fnUntraced(function* (key) {
+                const [statement, bindValues] = findManyRows({
+                    tableName: SystemTables.MATERIALIZATION_JOURNAL_META_TABLE,
+                    columns: SystemTables.materializationJournalMetaTable.sqliteDef.columns,
+                    where: {
+                        seqNumGlobal: key.global,
+                        seqNumClient: key.client,
+                        seqNumRebaseGeneration: key.rebaseGeneration,
+                    },
+                    limit: 1,
+                });
+                const preparedBindValues = prepareBindValues(bindValues, statement);
+                const row = yield* Effect.try({
+                    try: () => dbState.select(statement, preparedBindValues)[0],
+                    catch: (cause) => new SqliteError({ cause, query: { sql: statement, bindValues: preparedBindValues } }),
+                });
+                if (row === undefined) {
+                    return yield* new MaterializationJournalError({
+                        method: 'rollback',
+                        cause: new Error(`Missing materialization journal record for ${EventSequenceNumber.Client.toString(key)}`),
+                    });
+                }
+                return {
+                    key,
+                    changeset: row.changeset === null
+                        ? { _tag: 'no-op' }
+                        : { _tag: 'changeset', data: row.changeset },
+                };
+            }));
+            for (const record of rollbackRecords) {
+                if (record.changeset._tag === 'changeset') {
+                    const data = record.changeset.data;
+                    yield* Effect.try({
+                        try: () => dbState.makeChangeset(data).invert().apply(),
+                        catch: (cause) => new SqliteError({ cause }),
+                    });
+                }
+            }
+            yield* deleteByKeys(sortedKeys);
+        }, SqliteDbHelper.withSavepoint(dbState), Effect.mapError((cause) => isMaterializationJournalError(cause) === true
+            ? cause
+            : new MaterializationJournalError({ method: 'rollback', cause }))),
+        discardUpTo: Effect.fnUntraced(function* (key) {
+            yield* execSql(dbState, sql `DELETE FROM ${SystemTables.MATERIALIZATION_JOURNAL_META_TABLE}
+              WHERE seqNumGlobal < ${key.global}
+                 OR (
+                  seqNumGlobal = ${key.global}
+                      AND seqNumClient <= ${key.client}
+                  )`, {});
+        }, SqliteDbHelper.withSavepoint(dbState), Effect.mapError((cause) => new MaterializationJournalError({ method: 'discardUpTo', cause }))),
+    });
+};
+export const layer = (options) => Layer.succeed(MaterializationJournal, make(options));
+export const layerTest = Layer.succeed(MaterializationJournal, MaterializationJournal.of({
+    [TypeId]: TypeId,
+    record: () => Effect.void,
+    rollback: () => Effect.void,
+    discardUpTo: () => Effect.void,
+}));
+//# sourceMappingURL=MaterializationJournal.js.map

package/dist/MaterializationJournal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MaterializationJournal.js","sourceRoot":"","sources":["../src/MaterializationJournal.ts"],"names":[],"mappings":"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"}

package/dist/StateHead.d.ts

@@ -0,0 +1,26 @@
+import { Context, Effect, Layer } from '@livestore/utils/effect';
+import type { SqliteDb, SqliteError } from './adapter-types.ts';
+import * as EventSequenceNumber from './schema/EventSequenceNumber/mod.ts';
+export declare const TypeId: "~@livestore/common/StateHead";
+export type TypeId = typeof TypeId;
+/**
+ * Persists and reads the latest event sequence number reflected by the state database.
+ */
+export interface Service {
+    readonly [TypeId]: TypeId;
+    /** Persists the latest event sequence number reflected by the state database. */
+    set: (head: EventSequenceNumber.Client.Composite) => Effect.Effect<void, SqliteError>;
+    /** Returns the persisted head, or the root when the current-schema table has no row. */
+    get: Effect.Effect<EventSequenceNumber.Client.Composite, SqliteError>;
+}
+declare const StateHead_base: Context.ServiceClass<StateHead, "@livestore/common/StateHead", Service>;
+export declare class StateHead extends StateHead_base {
+}
+interface Options {
+    readonly dbState: SqliteDb;
+}
+export declare const make: ({ dbState }: Options) => Service;
+export declare const layer: (options: Options) => Layer.Layer<StateHead, never, never>;
+export declare const layerTest: Layer.Layer<StateHead, never, never>;
+export {};
+//# sourceMappingURL=StateHead.d.ts.map

package/dist/StateHead.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StateHead.d.ts","sourceRoot":"","sources":["../src/StateHead.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,yBAAyB,CAAA;AAEhE,OAAO,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAE/D,OAAO,KAAK,mBAAmB,MAAM,qCAAqC,CAAA;AAI1E,eAAO,MAAM,MAAM,EAAG,8BAAuC,CAAA;AAC7D,MAAM,MAAM,MAAM,GAAG,OAAO,MAAM,CAAA;AAIlC;;GAEG;AACH,MAAM,WAAW,OAAO;IACtB,QAAQ,CAAC,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;IACzB,iFAAiF;IACjF,GAAG,EAAE,CAAC,IAAI,EAAE,mBAAmB,CAAC,MAAM,CAAC,SAAS,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,WAAW,CAAC,CAAA;IACrF,wFAAwF;IACxF,GAAG,EAAE,MAAM,CAAC,MAAM,CAAC,mBAAmB,CAAC,MAAM,CAAC,SAAS,EAAE,WAAW,CAAC,CAAA;CACtE;;AAED,qBAAa,SAAU,SAAQ,cAAoE;CAAG;AAEtG,UAAU,OAAO;IACf,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAA;CAC3B;AAED,eAAO,MAAM,IAAI,GAAI,aAAa,OAAO,YAsCxC,CAAA;AAED,eAAO,MAAM,KAAK,GAAI,SAAS,OAAO,yCAA4C,CAAA;AAElF,eAAO,MAAM,SAAS,sCAOrB,CAAA"}

package/dist/StateHead.js

@@ -0,0 +1,50 @@
+import { Context, Effect, Layer } from '@livestore/utils/effect';
+import { execSql, selectSql } from "./leader-thread/connection.js";
+import * as EventSequenceNumber from "./schema/EventSequenceNumber/mod.js";
+import { SystemTables } from "./schema/mod.js";
+import { findManyRows, insertRow } from "./sql-queries/index.js";
+export const TypeId = '~@livestore/common/StateHead';
+const STATE_HEAD_ROW_ID = 1;
+export class StateHead extends Context.Service()('@livestore/common/StateHead') {
+}
+export const make = ({ dbState }) => {
+    return StateHead.of({
+        [TypeId]: TypeId,
+        set: (head) => {
+            const [statement, bindValues] = insertRow({
+                tableName: SystemTables.STATE_HEAD_META_TABLE,
+                columns: SystemTables.stateHeadMetaTable.sqliteDef.columns,
+                values: {
+                    id: STATE_HEAD_ROW_ID,
+                    seqNumGlobal: head.global,
+                    seqNumClient: head.client,
+                    seqNumRebaseGeneration: head.rebaseGeneration,
+                },
+                options: { orReplace: true },
+            });
+            return execSql(dbState, statement, bindValues);
+        },
+        get: Effect.suspend(() => {
+            const [statement, bindValues] = findManyRows({
+                tableName: SystemTables.STATE_HEAD_META_TABLE,
+                columns: SystemTables.stateHeadMetaTable.sqliteDef.columns,
+                where: { id: STATE_HEAD_ROW_ID },
+                limit: 1,
+            });
+            return selectSql(dbState, statement, bindValues).pipe(Effect.map(([row]) => row === undefined
+                ? EventSequenceNumber.Client.ROOT
+                : EventSequenceNumber.Client.Composite.make({
+                    global: row.seqNumGlobal,
+                    client: row.seqNumClient,
+                    rebaseGeneration: row.seqNumRebaseGeneration,
+                })));
+        }),
+    });
+};
+export const layer = (options) => Layer.succeed(StateHead, make(options));
+export const layerTest = Layer.succeed(StateHead, StateHead.of({
+    [TypeId]: TypeId,
+    set: () => Effect.void,
+    get: Effect.succeed(EventSequenceNumber.Client.ROOT),
+}));
+//# sourceMappingURL=StateHead.js.map

package/dist/StateHead.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"StateHead.js","sourceRoot":"","sources":["../src/StateHead.ts"],"names":[],"mappings":"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"}

package/dist/WorkerTransportError.d.ts

@@ -0,0 +1,11 @@
+import { Schema, WorkerError } from '@livestore/utils/effect';
+/**
+ * Type guard that identifies infrastructure errors from the Effect Worker transport layer.
+ *
+ * @remarks
+ *
+ * These errors ({@link WorkerError.WorkerError}, {@link Schema.SchemaError}) represent communication failures between
+ * threads/processes — not application-level failures.
+ */
+export declare const isWorkerTransportError: (e: unknown) => e is WorkerError.WorkerError | Schema.SchemaError;
+//# sourceMappingURL=WorkerTransportError.d.ts.map

package/dist/WorkerTransportError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WorkerTransportError.d.ts","sourceRoot":"","sources":["../src/WorkerTransportError.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAA;AAE7D;;;;;;;GAOG;AACH,eAAO,MAAM,sBAAsB,GAAI,GAAG,OAAO,KAAG,CAAC,IAAI,WAAW,CAAC,WAAW,GAAG,MAAM,CAAC,WACjC,CAAA"}

package/dist/WorkerTransportError.js

@@ -0,0 +1,11 @@
+import { Schema, WorkerError } from '@livestore/utils/effect';
+/**
+ * Type guard that identifies infrastructure errors from the Effect Worker transport layer.
+ *
+ * @remarks
+ *
+ * These errors ({@link WorkerError.WorkerError}, {@link Schema.SchemaError}) represent communication failures between
+ * threads/processes — not application-level failures.
+ */
+export const isWorkerTransportError = (e) => Schema.isSchemaError(e) || WorkerError.isWorkerError(e);
+//# sourceMappingURL=WorkerTransportError.js.map

package/dist/WorkerTransportError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"WorkerTransportError.js","sourceRoot":"","sources":["../src/WorkerTransportError.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAA;AAE7D;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAU,EAAqD,EAAE,CACtG,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,WAAW,CAAC,aAAa,CAAC,CAAC,CAAC,CAAA"}

package/dist/__tests__/fixture.d.ts

@@ -1,5 +1,5 @@
-import { SessionIdSymbol } from '../adapter-types.ts';
 import { State } from '../schema/mod.ts';
+import { SessionIdSymbol } from '../session-id-symbol.ts';
 export declare const UiState: State.SQLite.ClientDocumentTableDef<"UiState", {
     readonly showSidebar: boolean;
 }, {

package/dist/__tests__/fixture.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fixture.d.ts","sourceRoot":"","sources":["../../src/__tests__/fixture.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA;AACrD,OAAO,EAAc,KAAK,EAAE,MAAM,kBAAkB,CAAA;AAEpD,eAAO,MAAM,OAAO;;;;;;;;;;;;EAQlB,CAAA;AAOF,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;EAOpB,CAAA;AAEF,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;EAOrB,CAAA;AAOF,eAAO,MAAM,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAAyB,CAAA;AAI5C,eAAO,MAAM,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAAgC,CAAA"}
+{"version":3,"file":"fixture.d.ts","sourceRoot":"","sources":["../../src/__tests__/fixture.ts"],"names":[],"mappings":"AAEA,OAAO,EAAc,KAAK,EAAE,MAAM,kBAAkB,CAAA;AACpD,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAA;AAEzD,eAAO,MAAM,OAAO;;;;;;;;;;;;EAQlB,CAAA;AAOF,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;EAOpB,CAAA;AAEF,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;EAOrB,CAAA;AAOF,eAAO,MAAM,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAAyB,CAAA;AAI5C,eAAO,MAAM,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAAgC,CAAA"}

package/dist/__tests__/fixture.js

@@ -1,6 +1,6 @@
 import { Schema } from '@livestore/utils/effect';
-import { SessionIdSymbol } from "../adapter-types.js";
 import { makeSchema, State } from "../schema/mod.js";
+import { SessionIdSymbol } from "../session-id-symbol.js";
 export const UiState = State.SQLite.clientDocument({
     name: 'UiState',
     schema: Schema.Struct({
@@ -11,8 +11,8 @@ export const UiState = State.SQLite.clientDocument({
     },
 });
 const Config = Schema.Struct({
-    fontSize: Schema.Number,
-    theme: Schema.Literal('light', 'dark'),
+    fontSize: Schema.Finite,
+    theme: Schema.Literals(['light', 'dark']),
 });
 export const appConfig = State.SQLite.clientDocument({
     name: 'AppConfig',

package/dist/__tests__/fixture.js.map

@@ -1 +1 @@
-{"version":3,"file":"fixture.js","sourceRoot":"","sources":["../../src/__tests__/fixture.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAA;AAEhD,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA;AACrD,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAA;AAEpD,MAAM,CAAC,MAAM,OAAO,GAAG,KAAK,CAAC,MAAM,CAAC,cAAc,CAAC;IACjD,IAAI,EAAE,SAAS;IACf,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC;QACpB,WAAW,EAAE,MAAM,CAAC,OAAO;KAC5B,CAAC;IACF,OAAO,EAAE;QACP,KAAK,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE;KAC7B;CACF,CAAC,CAAA;AAEF,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;IAC3B,QAAQ,EAAE,MAAM,CAAC,MAAM;IACvB,KAAK,EAAE,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,MAAM,CAAC;CACvC,CAAC,CAAA;AAEF,MAAM,CAAC,MAAM,SAAS,GAAG,KAAK,CAAC,MAAM,CAAC,cAAc,CAAC;IACnD,IAAI,EAAE,WAAW;IACjB,MAAM,EAAE,MAAM;IACd,OAAO,EAAE;QACP,EAAE,EAAE,QAAQ;QACZ,KAAK,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE;KACxC;CACF,CAAC,CAAA;AAEF,MAAM,CAAC,MAAM,UAAU,GAAG,KAAK,CAAC,MAAM,CAAC,cAAc,CAAC;IACpD,IAAI,EAAE,WAAW;IACjB,MAAM,EAAE,MAAM;IACd,OAAO,EAAE;QACP,EAAE,EAAE,eAAe;QACnB,KAAK,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE;KACxC;CACF,CAAC,CAAA;AAEF,MAAM,MAAM,GAAG;IACb,UAAU,EAAE,OAAO,CAAC,GAAG;IACvB,YAAY,EAAE,SAAS,CAAC,GAAG;CAC5B,CAAA;AAED,MAAM,CAAC,MAAM,MAAM,GAAG,EAAE,OAAO,EAAE,SAAS,EAAE,CAAA;AAE5C,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,aAAa,EAAE,EAAE,EAAE,CAAC,CAAA;AAEnE,MAAM,CAAC,MAAM,MAAM,GAAG,UAAU,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAA"}
+{"version":3,"file":"fixture.js","sourceRoot":"","sources":["../../src/__tests__/fixture.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAA;AAEhD,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAA;AACpD,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAA;AAEzD,MAAM,CAAC,MAAM,OAAO,GAAG,KAAK,CAAC,MAAM,CAAC,cAAc,CAAC;IACjD,IAAI,EAAE,SAAS;IACf,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC;QACpB,WAAW,EAAE,MAAM,CAAC,OAAO;KAC5B,CAAC;IACF,OAAO,EAAE;QACP,KAAK,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE;KAC7B;CACF,CAAC,CAAA;AAEF,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;IAC3B,QAAQ,EAAE,MAAM,CAAC,MAAM;IACvB,KAAK,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;CAC1C,CAAC,CAAA;AAEF,MAAM,CAAC,MAAM,SAAS,GAAG,KAAK,CAAC,MAAM,CAAC,cAAc,CAAC;IACnD,IAAI,EAAE,WAAW;IACjB,MAAM,EAAE,MAAM;IACd,OAAO,EAAE;QACP,EAAE,EAAE,QAAQ;QACZ,KAAK,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE;KACxC;CACF,CAAC,CAAA;AAEF,MAAM,CAAC,MAAM,UAAU,GAAG,KAAK,CAAC,MAAM,CAAC,cAAc,CAAC;IACpD,IAAI,EAAE,WAAW;IACjB,MAAM,EAAE,MAAM;IACd,OAAO,EAAE;QACP,EAAE,EAAE,eAAe;QACnB,KAAK,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE;KACxC;CACF,CAAC,CAAA;AAEF,MAAM,MAAM,GAAG;IACb,UAAU,EAAE,OAAO,CAAC,GAAG;IACvB,YAAY,EAAE,SAAS,CAAC,GAAG;CAC5B,CAAA;AAED,MAAM,CAAC,MAAM,MAAM,GAAG,EAAE,OAAO,EAAE,SAAS,EAAE,CAAA;AAE5C,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,aAAa,EAAE,EAAE,EAAE,CAAC,CAAA;AAEnE,MAAM,CAAC,MAAM,MAAM,GAAG,UAAU,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAA"}

package/dist/adapter-types.d.ts

@@ -1,14 +1,19 @@
-import { type Effect, type Exit, type Queue, Schema, type Scope, type SubscriptionRef, type WebChannel } from '@livestore/utils/effect';
+import { type Effect, type Exit, type Queue, type Latch, Schema, type Scope, type SubscriptionRef, type WebChannel } from '@livestore/utils/effect';
 import type { ClientSessionLeaderThreadProxy } from './ClientSessionLeaderThreadProxy.ts';
 import type * as Devtools from './devtools/mod.ts';
-import type { IntentionalShutdownCause, MaterializeError, UnexpectedError } from './errors.ts';
+import type { IntentionalShutdownCause, MaterializeError, UnknownError } from './errors.ts';
 import type { LiveStoreSchema } from './schema/mod.ts';
 import type { SqliteDb } from './sqlite-types.ts';
-import type { IsOfflineError, SyncError } from './sync/index.js';
+import type { BackendIdMismatchError } from './sync/index.ts';
 export * as ClientSessionLeaderThreadProxy from './ClientSessionLeaderThreadProxy.ts';
 export * from './defs.ts';
 export * from './errors.ts';
 export * from './sqlite-types.ts';
+/**
+ * Runtime handle to an active LiveStore client session within the current process.
+ * Provides direct access to the embedded SQLite database, leader thread bridge,
+ * and lifecycle controls useful for application-level coordination.
+ */
 export interface ClientSession {
     /** SQLite database with synchronous API running in the same thread (usually in-memory) */
     sqliteDb: SqliteDb;
@@ -16,14 +21,14 @@ export interface ClientSession {
         enabled: false;
     } | {
         enabled: true;
-        pullLatch: Effect.Latch;
-        pushLatch: Effect.Latch;
+        pullLatch: Latch.Latch;
+        pushLatch: Latch.Latch;
     };
     clientId: string;
     sessionId: string;
     /** Status info whether current session is leader or not */
     lockStatus: SubscriptionRef.SubscriptionRef<LockStatus>;
-    shutdown: (cause: Exit.Exit<IntentionalShutdownCause, UnexpectedError | SyncError | MaterializeError>) => Effect.Effect<void>;
+    shutdown: (cause: Exit.Exit<IntentionalShutdownCause, UnknownError | MaterializeError | BackendIdMismatchError>) => Effect.Effect<void>;
     /** A proxy API to communicate with the leader thread */
     leaderThread: ClientSessionLeaderThreadProxy;
     /** A unique identifier for the current instance of the client session. Used for debugging purposes. */
@@ -31,94 +36,91 @@ export interface ClientSession {
 }
 export type ResetMode = 'all-data' | 'only-app-db';
 export declare const BootStateProgress: Schema.Struct<{
-    done: typeof Schema.Number;
-    total: typeof Schema.Number;
+    readonly done: Schema.Finite;
+    readonly total: Schema.Finite;
 }>;
-export declare const BootStatus: Schema.Union<[Schema.Struct<{
-    stage: Schema.Literal<["loading"]>;
+/**
+ * Describes known reasons why LiveStore boot may encounter storage issues.
+ *
+ * @remarks
+ * - `private-browsing`: OPFS unavailable due to private/incognito browsing mode (Safari, Firefox)
+ * - `storage-unavailable`: OPFS access denied for other reasons (permissions, quota)
+ * - `unknown`: Unexpected error during storage initialization
+ */
+export declare const BootWarningReason: Schema.Literals<readonly ["private-browsing", "storage-unavailable", "unknown"]>;
+export type BootWarningReason = typeof BootWarningReason.Type;
+/**
+ * Describes the storage mode the store is operating in.
+ *
+ * @remarks
+ * - `persisted`: Data is persisted to disk (e.g., via OPFS)
+ * - `in-memory`: Data is only stored in memory and will be lost on page refresh
+ */
+export declare const StorageMode: Schema.Literals<readonly ["persisted", "in-memory"]>;
+export type StorageMode = typeof StorageMode.Type;
+export declare const BootStatus: Schema.Union<readonly [Schema.Struct<{
+    readonly stage: Schema.Literal<"loading">;
 }>, Schema.Struct<{
-    stage: Schema.Literal<["migrating"]>;
-    progress: Schema.Struct<{
-        done: typeof Schema.Number;
-        total: typeof Schema.Number;
+    readonly stage: Schema.Literal<"migrating">;
+    readonly progress: Schema.Struct<{
+        readonly done: Schema.Finite;
+        readonly total: Schema.Finite;
     }>;
 }>, Schema.Struct<{
-    stage: Schema.Literal<["rehydrating"]>;
-    progress: Schema.Struct<{
-        done: typeof Schema.Number;
-        total: typeof Schema.Number;
+    readonly stage: Schema.Literal<"rehydrating">;
+    readonly progress: Schema.Struct<{
+        readonly done: Schema.Finite;
+        readonly total: Schema.Finite;
     }>;
 }>, Schema.Struct<{
-    stage: Schema.Literal<["syncing"]>;
-    progress: Schema.Struct<{
-        done: typeof Schema.Number;
-        total: typeof Schema.Number;
+    readonly stage: Schema.Literal<"syncing">;
+    readonly progress: Schema.Struct<{
+        readonly done: Schema.Finite;
+        readonly total: Schema.Finite;
     }>;
 }>, Schema.Struct<{
-    stage: Schema.Literal<["done"]>;
+    readonly stage: Schema.Literal<"done">;
+}>, Schema.Struct<{
+    readonly stage: Schema.Literal<"warning">;
+    readonly reason: Schema.Literals<readonly ["private-browsing", "storage-unavailable", "unknown"]>;
+    readonly message: Schema.String;
 }>]>;
 export type BootStatus = typeof BootStatus.Type;
-/**
- * Can be used in queries to refer to the current session id.
- * Will be replaced with the actual session id at runtime
- *
- * In client document table:
- * ```ts
- * const uiState = State.SQLite.clientDocument({
- *   name: 'ui_state',
- *   schema: Schema.Struct({
- *     theme: Schema.Literal('dark', 'light', 'system'),
- *     user: Schema.String,
- *     showToolbar: Schema.Boolean,
- *   }),
- *   default: { value: defaultFrontendState, id: SessionIdSymbol },
- * })
- * ```
- *
- * Or in a client document query:
- * ```ts
- * const query$ = queryDb(tables.uiState.get(SessionIdSymbol))
- * ```
- */
-export declare const SessionIdSymbol: unique symbol;
-export type SessionIdSymbol = typeof SessionIdSymbol;
 export type LockStatus = 'has-lock' | 'no-lock';
 export type MigrationOptions = {
-    strategy: 'auto';
     hooks?: Partial<MigrationHooks>;
     logging?: {
         excludeAffectedRows?: (sqlStmt: string) => boolean;
     };
-} | {
-    strategy: 'manual';
-    migrate: (oldDb: Uint8Array<ArrayBuffer>) => Uint8Array<ArrayBuffer> | Promise<Uint8Array<ArrayBuffer>> | Effect.Effect<Uint8Array<ArrayBuffer>, unknown>;
 };
 export type MigrationHooks = {
     /** Runs on the empty in-memory database with no database schemas applied yet */
     init: MigrationHook;
-    /** Runs before applying the migration strategy but after table schemas have been applied and singleton rows have been created */
+    /** Runs after table schemas and singleton rows are created, but before rematerializing state from the eventlog */
     pre: MigrationHook;
-    /** Runs after applying the migration strategy before creating export snapshot and closing the database */
+    /** Runs after rematerializing state from the eventlog */
     post: MigrationHook;
 };
 export type MigrationHook = (db: SqliteDb) => void | Promise<void> | Effect.Effect<void, unknown>;
 export interface ClientSessionDevtoolsChannel extends WebChannel.WebChannel<Devtools.ClientSession.MessageToApp, Devtools.ClientSession.MessageFromApp> {
 }
-export type ConnectDevtoolsToStore = (storeDevtoolsChannel: ClientSessionDevtoolsChannel) => Effect.Effect<void, UnexpectedError, Scope.Scope>;
-export type Adapter = (args: AdapterArgs) => Effect.Effect<ClientSession, UnexpectedError, Scope.Scope>;
+export type ConnectDevtoolsToStore = (storeDevtoolsChannel: ClientSessionDevtoolsChannel) => Effect.Effect<void, UnknownError, Scope.Scope>;
+export type Adapter = (args: AdapterArgs) => Effect.Effect<ClientSession, UnknownError, Scope.Scope>;
 export interface AdapterArgs {
     schema: LiveStoreSchema;
     storeId: string;
     devtoolsEnabled: boolean;
     debugInstanceId: string;
     bootStatusQueue: Queue.Queue<BootStatus>;
-    shutdown: (exit: Exit.Exit<IntentionalShutdownCause, UnexpectedError | SyncError | MaterializeError | IsOfflineError>) => Effect.Effect<void>;
+    shutdown: (exit: Exit.Exit<IntentionalShutdownCause, UnknownError | MaterializeError | BackendIdMismatchError>) => Effect.Effect<void>;
     connectDevtoolsToStore: ConnectDevtoolsToStore;
     /**
      * Payload that will be passed to the sync backend when connecting
      *
      * @default undefined
      */
-    syncPayload: Schema.JsonValue | undefined;
+    syncPayloadSchema: Schema.Decoder<Schema.Json> | undefined;
+    /** Encoded representation of the sync payload matching `syncPayloadSchema`. */
+    syncPayloadEncoded: Schema.Json | undefined;
 }
 //# sourceMappingURL=adapter-types.d.ts.map