@livestore/common 0.4.0-dev.9 → 0.4.0

package/dist/errors.d.ts

@@ -1,18 +1,18 @@
 import { Effect, Layer, Schema, Stream } from '@livestore/utils/effect';
-declare const UnexpectedError_base: Schema.TaggedErrorClass<UnexpectedError, "LiveStore.UnexpectedError", {
-    readonly _tag: Schema.tag<"LiveStore.UnexpectedError">;
+declare const UnknownError_base: Schema.TaggedErrorClass<UnknownError, "UnknownError", {
+    readonly _tag: Schema.tag<"UnknownError">;
 } & {
     cause: typeof Schema.Defect;
     note: Schema.optional<typeof Schema.String>;
     payload: Schema.optional<typeof Schema.Any>;
 }>;
-export declare class UnexpectedError extends UnexpectedError_base {
-    static mapToUnexpectedError: <A, E, R>(effect: Effect.Effect<A, E, R>) => Effect.Effect<A, UnexpectedError, R>;
-    static mapToUnexpectedErrorLayer: <A, E, R>(layer: Layer.Layer<A, E, R>) => Layer.Layer<A, UnexpectedError, R>;
-    static mapToUnexpectedErrorStream: <A, E, R>(stream: Stream.Stream<A, E, R>) => Stream.Stream<A, UnexpectedError, R>;
+export declare class UnknownError extends UnknownError_base {
+    static mapToUnknownError: <A, E, R>(effect: Effect.Effect<A, E, R>) => Effect.Effect<A, UnknownError, R>;
+    static mapToUnknownErrorLayer: <A, E, R>(layer: Layer.Layer<A, E, R>) => Layer.Layer<A, UnknownError, R>;
+    static mapToUnknownErrorStream: <A, E, R>(stream: Stream.Stream<A, E, R>) => Stream.Stream<A, UnknownError, R>;
 }
-declare const MaterializerHashMismatchError_base: Schema.TaggedErrorClass<MaterializerHashMismatchError, "LiveStore.MaterializerHashMismatchError", {
-    readonly _tag: Schema.tag<"LiveStore.MaterializerHashMismatchError">;
+declare const MaterializerHashMismatchError_base: Schema.TaggedErrorClass<MaterializerHashMismatchError, "MaterializerHashMismatchError", {
+    readonly _tag: Schema.tag<"MaterializerHashMismatchError">;
 } & {
     eventName: typeof Schema.String;
     note: Schema.optionalWith<typeof Schema.String, {
@@ -21,22 +21,22 @@ declare const MaterializerHashMismatchError_base: Schema.TaggedErrorClass<Materi
 }>;
 export declare class MaterializerHashMismatchError extends MaterializerHashMismatchError_base {
 }
-declare const IntentionalShutdownCause_base: Schema.TaggedErrorClass<IntentionalShutdownCause, "LiveStore.IntentionalShutdownCause", {
-    readonly _tag: Schema.tag<"LiveStore.IntentionalShutdownCause">;
+declare const IntentionalShutdownCause_base: Schema.TaggedErrorClass<IntentionalShutdownCause, "IntentionalShutdownCause", {
+    readonly _tag: Schema.tag<"IntentionalShutdownCause">;
 } & {
-    reason: Schema.Literal<["devtools-reset", "devtools-import", "adapter-reset", "manual"]>;
+    reason: Schema.Literal<["devtools-reset", "devtools-import", "adapter-reset", "manual", "backend-id-mismatch"]>;
 }>;
 export declare class IntentionalShutdownCause extends IntentionalShutdownCause_base {
 }
-declare const StoreInterrupted_base: Schema.TaggedErrorClass<StoreInterrupted, "LiveStore.StoreInterrupted", {
-    readonly _tag: Schema.tag<"LiveStore.StoreInterrupted">;
+declare const StoreInterrupted_base: Schema.TaggedErrorClass<StoreInterrupted, "StoreInterrupted", {
+    readonly _tag: Schema.tag<"StoreInterrupted">;
 } & {
     reason: typeof Schema.String;
 }>;
 export declare class StoreInterrupted extends StoreInterrupted_base {
 }
-declare const SqliteError_base: Schema.TaggedErrorClass<SqliteError, "LiveStore.SqliteError", {
-    readonly _tag: Schema.tag<"LiveStore.SqliteError">;
+declare const SqliteError_base: Schema.TaggedErrorClass<SqliteError, "SqliteError", {
+    readonly _tag: Schema.tag<"SqliteError">;
 } & {
     query: Schema.optional<Schema.Struct<{
         sql: typeof Schema.String;
@@ -50,10 +50,40 @@ declare const SqliteError_base: Schema.TaggedErrorClass<SqliteError, "LiveStore.
 }>;
 export declare class SqliteError extends SqliteError_base {
 }
-declare const MaterializeError_base: Schema.TaggedErrorClass<MaterializeError, "LiveStore.MaterializeError", {
-    readonly _tag: Schema.tag<"LiveStore.MaterializeError">;
+declare const UnknownEventError_base: Schema.TaggedErrorClass<UnknownEventError, "UnknownEventError", {
+    readonly _tag: Schema.tag<"UnknownEventError">;
 } & {
-    cause: Schema.Union<[typeof MaterializerHashMismatchError, typeof SqliteError]>;
+    event: Schema.SchemaClass<{
+        readonly clientId: string;
+        readonly sessionId: string;
+        readonly name: string;
+        readonly seqNum: {
+            readonly global: number & import("effect/Brand").Brand<"GlobalEventSequenceNumber">;
+            readonly client: number & import("effect/Brand").Brand<"ClientEventSequenceNumber">;
+            readonly rebaseGeneration: number;
+        };
+        readonly args: any;
+    }, {
+        readonly clientId: string;
+        readonly sessionId: string;
+        readonly name: string;
+        readonly seqNum: {
+            readonly global: number;
+            readonly client: number;
+            readonly rebaseGeneration: number;
+        };
+        readonly args: any;
+    }, never>;
+    reason: Schema.Literal<["event-definition-missing", "materializer-missing"]>;
+    operation: typeof Schema.String;
+    note: Schema.optional<typeof Schema.String>;
+}>;
+export declare class UnknownEventError extends UnknownEventError_base {
+}
+declare const MaterializeError_base: Schema.TaggedErrorClass<MaterializeError, "MaterializeError", {
+    readonly _tag: Schema.tag<"MaterializeError">;
+} & {
+    cause: Schema.Union<[typeof MaterializerHashMismatchError, typeof SqliteError, typeof UnknownEventError]>;
     note: Schema.optional<typeof Schema.String>;
 }>;
 export declare class MaterializeError extends MaterializeError_base {

package/dist/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAS,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAA;;;;;;;;AAE9E,qBAAa,eAAgB,SAAQ,oBAInC;IACA,MAAM,CAAC,oBAAoB,GAAI,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,QAAQ,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,0CAInE;IAEH,MAAM,CAAC,yBAAyB,GAAI,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,wCAOrE;IAEH,MAAM,CAAC,0BAA0B,GAAI,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,QAAQ,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,0CAGzE;CACJ;;;;;;;;;AAED,qBAAa,6BAA8B,SAAQ,kCAQlD;CAAG;;;;;;AAEJ,qBAAa,wBAAyB,SAAQ,6BAK7C;CAAG;;;;;;AAEJ,qBAAa,gBAAiB,SAAQ,qBAEpC;CAAG;;;;;;;;IASH,6BAA6B;;IAI7B,iCAAiC;;;;AAXnC,qBAAa,WAAY,SAAQ,gBAc/B;CAAG;;;;;;;AAEL,qBAAa,gBAAiB,SAAQ,qBAGpC;CAAG"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAS,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAA;;;;;;;;AAI9E,qBAAa,YAAa,SAAQ,iBAIhC;IACA,MAAM,CAAC,iBAAiB,GAAI,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,QAAQ,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,uCAIhE;IAEH,MAAM,CAAC,sBAAsB,GAAI,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,qCAOlE;IAEH,MAAM,CAAC,uBAAuB,GAAI,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,QAAQ,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,uCACiD;CAC3H;;;;;;;;;AAED,qBAAa,6BAA8B,SAAQ,kCAQlD;CAAG;;;;;;AAEJ,qBAAa,wBAAyB,SAAQ,6BAI5C;CAAG;;;;;;AAEL,qBAAa,gBAAiB,SAAQ,qBAIpC;CAAG;;;;;;;;IASH,6BAA6B;;IAI7B,iCAAiC;;;;AAXnC,qBAAa,WAAY,SAAQ,gBAc/B;CAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEL,qBAAa,iBAAkB,SAAQ,sBAKrC;CAAG;;;;;;;AAEL,qBAAa,gBAAiB,SAAQ,qBAGpC;CAAG"}

package/dist/errors.js

@@ -1,31 +1,32 @@
 import { Cause, Effect, Layer, Schema, Stream } from '@livestore/utils/effect';
-export class UnexpectedError extends Schema.TaggedError()('LiveStore.UnexpectedError', {
+import * as LiveStoreEvent from "./schema/LiveStoreEvent/mod.js";
+export class UnknownError extends Schema.TaggedError('~@livestore/common/UnknownError')('UnknownError', {
     cause: Schema.Defect,
     note: Schema.optional(Schema.String),
     payload: Schema.optional(Schema.Any),
 }) {
-    static mapToUnexpectedError = (effect) => effect.pipe(Effect.mapError((cause) => (Schema.is(UnexpectedError)(cause) ? cause : new UnexpectedError({ cause }))), Effect.catchAllDefect((cause) => new UnexpectedError({ cause })));
-    static mapToUnexpectedErrorLayer = (layer) => layer.pipe(Layer.catchAllCause((cause) => Cause.isFailType(cause) && Schema.is(UnexpectedError)(cause.error)
+    static mapToUnknownError = (effect) => effect.pipe(Effect.mapError((cause) => (Schema.is(UnknownError)(cause) === true ? cause : new UnknownError({ cause }))), Effect.catchAllDefect((cause) => new UnknownError({ cause })));
+    static mapToUnknownErrorLayer = (layer) => layer.pipe(Layer.catchAllCause((cause) => Cause.isFailType(cause) === true && Schema.is(UnknownError)(cause.error) === true
         ? Layer.fail(cause.error)
-        : Layer.fail(new UnexpectedError({ cause: cause }))));
-    static mapToUnexpectedErrorStream = (stream) => stream.pipe(Stream.mapError((cause) => (Schema.is(UnexpectedError)(cause) ? cause : new UnexpectedError({ cause }))));
+        : Layer.fail(new UnknownError({ cause: cause }))));
+    static mapToUnknownErrorStream = (stream) => stream.pipe(Stream.mapError((cause) => (Schema.is(UnknownError)(cause) === true ? cause : new UnknownError({ cause }))));
 }
-export class MaterializerHashMismatchError extends Schema.TaggedError()('LiveStore.MaterializerHashMismatchError', {
+export class MaterializerHashMismatchError extends Schema.TaggedError('~@livestore/common/MaterializerHashMismatchError')('MaterializerHashMismatchError', {
     eventName: Schema.String,
     note: Schema.optionalWith(Schema.String, {
         default: () => 'Please make sure your event materializer is a pure function without side effects.',
     }),
 }) {
 }
-export class IntentionalShutdownCause extends Schema.TaggedError()('LiveStore.IntentionalShutdownCause', {
-    reason: Schema.Literal('devtools-reset', 'devtools-import', 'adapter-reset', 'manual'),
+export class IntentionalShutdownCause extends Schema.TaggedError('~@livestore/common/IntentionalShutdownCause')('IntentionalShutdownCause', {
+    reason: Schema.Literal('devtools-reset', 'devtools-import', 'adapter-reset', 'manual', 'backend-id-mismatch'),
 }) {
 }
-export class StoreInterrupted extends Schema.TaggedError()('LiveStore.StoreInterrupted', {
+export class StoreInterrupted extends Schema.TaggedError('~@livestore/common/StoreInterrupted')('StoreInterrupted', {
     reason: Schema.String,
 }) {
 }
-export class SqliteError extends Schema.TaggedError()('LiveStore.SqliteError', {
+export class SqliteError extends Schema.TaggedError('~@livestore/common/SqliteError')('SqliteError', {
     query: Schema.optional(Schema.Struct({
         sql: Schema.String,
         bindValues: Schema.Union(Schema.Record({ key: Schema.String, value: Schema.Any }), Schema.Array(Schema.Any)),
@@ -39,8 +40,15 @@ export class SqliteError extends Schema.TaggedError()('LiveStore.SqliteError', {
     note: Schema.optional(Schema.String),
 }) {
 }
-export class MaterializeError extends Schema.TaggedError()('LiveStore.MaterializeError', {
-    cause: Schema.Union(MaterializerHashMismatchError, SqliteError),
+export class UnknownEventError extends Schema.TaggedError('~@livestore/common/UnknownEventError')('UnknownEventError', {
+    event: LiveStoreEvent.Client.Encoded.pipe(Schema.pick('name', 'args', 'seqNum', 'clientId', 'sessionId')),
+    reason: Schema.Literal('event-definition-missing', 'materializer-missing'),
+    operation: Schema.String,
+    note: Schema.optional(Schema.String),
+}) {
+}
+export class MaterializeError extends Schema.TaggedError('~@livestore/common/MaterializeError')('MaterializeError', {
+    cause: Schema.Union(MaterializerHashMismatchError, SqliteError, UnknownEventError),
     note: Schema.optional(Schema.String),
 }) {
 }

package/dist/errors.js.map

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

package/dist/index.d.ts

@@ -2,16 +2,19 @@ export * from './adapter-types.ts';
 export * from './bounded-collections.ts';
 export * from './debug-info.ts';
 export * as Devtools from './devtools/mod.ts';
+export * as LogConfig from './logging.ts';
 export * from './make-client-session.ts';
 export * from './materializer-helper.ts';
 export * from './otel.ts';
 export * from './rematerialize-from-eventlog.ts';
 export * from './schema/state/sqlite/query-builder/mod.ts';
-export * from './schema/state/sqlite/system-tables.ts';
+export * from './schema/state/sqlite/system-tables/mod.ts';
 export * from './schema-management/migrations.ts';
 export * as SqliteDbHelper from './sqlite-db-helper.ts';
+export * from './leader-thread/RejectedPushError.ts';
 export * from './sync/index.ts';
 export * as SyncState from './sync/syncstate.ts';
 export * from './util.ts';
 export * from './version.ts';
+export * from './WorkerTransportError.ts';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAA;AAClC,cAAc,0BAA0B,CAAA;AACxC,cAAc,iBAAiB,CAAA;AAC/B,OAAO,KAAK,QAAQ,MAAM,mBAAmB,CAAA;AAC7C,cAAc,0BAA0B,CAAA;AACxC,cAAc,0BAA0B,CAAA;AACxC,cAAc,WAAW,CAAA;AACzB,cAAc,kCAAkC,CAAA;AAChD,cAAc,4CAA4C,CAAA;AAC1D,cAAc,wCAAwC,CAAA;AACtD,cAAc,mCAAmC,CAAA;AACjD,OAAO,KAAK,cAAc,MAAM,uBAAuB,CAAA;AACvD,cAAc,iBAAiB,CAAA;AAC/B,OAAO,KAAK,SAAS,MAAM,qBAAqB,CAAA;AAChD,cAAc,WAAW,CAAA;AACzB,cAAc,cAAc,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAA;AAClC,cAAc,0BAA0B,CAAA;AACxC,cAAc,iBAAiB,CAAA;AAC/B,OAAO,KAAK,QAAQ,MAAM,mBAAmB,CAAA;AAC7C,OAAO,KAAK,SAAS,MAAM,cAAc,CAAA;AACzC,cAAc,0BAA0B,CAAA;AACxC,cAAc,0BAA0B,CAAA;AACxC,cAAc,WAAW,CAAA;AACzB,cAAc,kCAAkC,CAAA;AAChD,cAAc,4CAA4C,CAAA;AAC1D,cAAc,4CAA4C,CAAA;AAC1D,cAAc,mCAAmC,CAAA;AACjD,OAAO,KAAK,cAAc,MAAM,uBAAuB,CAAA;AACvD,cAAc,sCAAsC,CAAA;AACpD,cAAc,iBAAiB,CAAA;AAC/B,OAAO,KAAK,SAAS,MAAM,qBAAqB,CAAA;AAChD,cAAc,WAAW,CAAA;AACzB,cAAc,cAAc,CAAA;AAC5B,cAAc,2BAA2B,CAAA"}

package/dist/index.js

@@ -2,16 +2,19 @@ export * from "./adapter-types.js";
 export * from "./bounded-collections.js";
 export * from "./debug-info.js";
 export * as Devtools from "./devtools/mod.js";
+export * as LogConfig from "./logging.js";
 export * from "./make-client-session.js";
 export * from "./materializer-helper.js";
 export * from "./otel.js";
 export * from "./rematerialize-from-eventlog.js";
 export * from "./schema/state/sqlite/query-builder/mod.js";
-export * from "./schema/state/sqlite/system-tables.js";
+export * from "./schema/state/sqlite/system-tables/mod.js";
 export * from "./schema-management/migrations.js";
 export * as SqliteDbHelper from "./sqlite-db-helper.js";
+export * from "./leader-thread/RejectedPushError.js";
 export * from "./sync/index.js";
 export * as SyncState from "./sync/syncstate.js";
 export * from "./util.js";
 export * from "./version.js";
+export * from "./WorkerTransportError.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAA;AAClC,cAAc,0BAA0B,CAAA;AACxC,cAAc,iBAAiB,CAAA;AAC/B,OAAO,KAAK,QAAQ,MAAM,mBAAmB,CAAA;AAC7C,cAAc,0BAA0B,CAAA;AACxC,cAAc,0BAA0B,CAAA;AACxC,cAAc,WAAW,CAAA;AACzB,cAAc,kCAAkC,CAAA;AAChD,cAAc,4CAA4C,CAAA;AAC1D,cAAc,wCAAwC,CAAA;AACtD,cAAc,mCAAmC,CAAA;AACjD,OAAO,KAAK,cAAc,MAAM,uBAAuB,CAAA;AACvD,cAAc,iBAAiB,CAAA;AAC/B,OAAO,KAAK,SAAS,MAAM,qBAAqB,CAAA;AAChD,cAAc,WAAW,CAAA;AACzB,cAAc,cAAc,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAA;AAClC,cAAc,0BAA0B,CAAA;AACxC,cAAc,iBAAiB,CAAA;AAC/B,OAAO,KAAK,QAAQ,MAAM,mBAAmB,CAAA;AAC7C,OAAO,KAAK,SAAS,MAAM,cAAc,CAAA;AACzC,cAAc,0BAA0B,CAAA;AACxC,cAAc,0BAA0B,CAAA;AACxC,cAAc,WAAW,CAAA;AACzB,cAAc,kCAAkC,CAAA;AAChD,cAAc,4CAA4C,CAAA;AAC1D,cAAc,4CAA4C,CAAA;AAC1D,cAAc,mCAAmC,CAAA;AACjD,OAAO,KAAK,cAAc,MAAM,uBAAuB,CAAA;AACvD,cAAc,sCAAsC,CAAA;AACpD,cAAc,iBAAiB,CAAA;AAC/B,OAAO,KAAK,SAAS,MAAM,qBAAqB,CAAA;AAChD,cAAc,WAAW,CAAA;AACzB,cAAc,cAAc,CAAA;AAC5B,cAAc,2BAA2B,CAAA"}

package/dist/leader-thread/LeaderSyncProcessor.d.ts

@@ -1,6 +1,6 @@
 import type { Scope } from '@livestore/utils/effect';
 import { Effect } from '@livestore/utils/effect';
-import { type SqliteDb, UnexpectedError } from '../adapter-types.ts';
+import { type SqliteDb } from '../adapter-types.ts';
 import type { LiveStoreSchema } from '../schema/mod.ts';
 import * as SyncState from '../sync/syncstate.ts';
 import type { InitialBlockingSyncContext, LeaderSyncProcessor } from './types.ts';
@@ -22,11 +22,11 @@ import type { InitialBlockingSyncContext, LeaderSyncProcessor } from './types.ts
  *   - Maintains events in ascending order.
  *   - Uses `Deferred` objects to resolve/reject events based on application success.
  * - Processes events from the queue, applying events in batches.
- * - Controlled by a `Latch` to manage execution flow.
- * - The latch closes on pull receipt and re-opens post-pull completion.
+ * - Controlled by a mutex (`Semaphore(1)`) to ensure mutual exclusion between local push and backend pull processing.
+ * - The backend pull side acquires the mutex before processing and releases it on post-pull completion.
  * - Processes up to `maxBatchSize` events per cycle.
  *
- * Currently we're advancing the state db and eventlog in lockstep, but we could also decouple this in the future
+ * Currently, we're advancing the state db and eventlog in lockstep, but we could also decouple this in the future
  *
  * Tricky concurrency scenarios:
  * - Queued local push batches becoming invalid due to a prior local push item being rejected.
@@ -34,19 +34,66 @@ import type { InitialBlockingSyncContext, LeaderSyncProcessor } from './types.ts
  *
  * See ClientSessionSyncProcessor for how the leader and session sync processors are similar/different.
  */
-export declare const makeLeaderSyncProcessor: ({ schema, dbState, initialBlockingSyncContext, initialSyncState, onError, livePull, params, testing, }: {
+export declare const makeLeaderSyncProcessor: ({ schema, dbState, initialBlockingSyncContext, initialSyncState, onError, onBackendIdMismatch, livePull, params, testing, }: {
     schema: LiveStoreSchema;
     dbState: SqliteDb;
     initialBlockingSyncContext: InitialBlockingSyncContext;
     /** Initial sync state rehydrated from the persisted eventlog or initial sync state */
     initialSyncState: SyncState.SyncState;
+    /**
+     * What to do when a failure (any cause) occurs (except `BackendIdMismatchError`).
+     *
+     * - `'shutdown'`: Send the error to the shutdown channel and terminate the sync processor.
+     * - `'ignore'`: Continue running.
+     */
     onError: "shutdown" | "ignore";
+    /**
+     * What to do when the sync backend identity has changed (i.e. the backend was reset).
+     *
+     * - `'reset'`: Clear local databases (eventlog and state) and send an intentional shutdown signal.
+     * - `'shutdown'`: Send a shutdown signal without clearing local storage.
+     * - `'ignore'`: Continue running with stale data.
+     */
+    onBackendIdMismatch: "reset" | "shutdown" | "ignore";
     params: {
         /**
+         * Maximum number of local events to process per batch cycle.
+         *
+         * This controls how many events from client sessions are applied to the local state
+         * in a single iteration before yielding to allow potential backend pulls.
+         *
+         * **Trade-offs:**
+         * - **Lower values (1-5):** More responsive to remote updates since pull processing can
+         *   interleave more frequently. Better for high-conflict scenarios where rebases are common.
+         *   Slightly higher per-event overhead due to more frequent transaction commits.
+         *
+         * - **Higher values (10-50+):** Better throughput for bulk local writes as more events are
+         *   batched into a single transaction. However, may delay remote update processing and
+         *   increase rebase complexity if many local events queue up during a slow pull.
+         *
+         * - **Very high values (100+):** Risk of starvation for pull processing if local pushes
+         *   arrive continuously. May cause larger rollbacks during rebases. Not recommended
+         *   unless you have a write-heavy workload with minimal remote synchronization.
+         *
          * @default 10
          */
         localPushBatchSize?: number;
         /**
+         * Maximum number of events to push to the sync backend per batch.
+         *
+         * This controls how many events are sent in a single push request to the remote server.
+         *
+         * **Trade-offs:**
+         * - **Lower values (1-10):** Lower latency for each push operation. Faster feedback on
+         *   push success/failure. Slightly higher network overhead due to more requests.
+         *
+         * - **Higher values (50-100):** Better network efficiency by amortizing request overhead.
+         *   Preferred for high-throughput scenarios. May increase latency to first confirmation.
+         *
+         * - **Very high values (200+):** Risk of hitting server request size limits or timeouts.
+         *   A single failed request loses the entire batch (will be retried). May cause memory
+         *   pressure if events accumulate faster than they can be pushed.
+         *
          * @default 50
          */
         backendPushBatchSize?: number;
@@ -61,5 +108,5 @@ export declare const makeLeaderSyncProcessor: ({ schema, dbState, initialBlockin
             localPushProcessing?: Effect.Effect<void>;
         };
     };
-}) => Effect.Effect<LeaderSyncProcessor, UnexpectedError, Scope.Scope>;
+}) => Effect.Effect<LeaderSyncProcessor, never, Scope.Scope>;
 //# sourceMappingURL=LeaderSyncProcessor.d.ts.map

package/dist/leader-thread/LeaderSyncProcessor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"LeaderSyncProcessor.d.ts","sourceRoot":"","sources":["../../src/leader-thread/LeaderSyncProcessor.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAuB,KAAK,EAAU,MAAM,yBAAyB,CAAA;AACjF,OAAO,EAKL,MAAM,EAaP,MAAM,yBAAyB,CAAA;AAEhC,OAAO,EAGL,KAAK,QAAQ,EACb,eAAe,EAChB,MAAM,qBAAqB,CAAA;AAE5B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AASvD,OAAO,KAAK,SAAS,MAAM,sBAAsB,CAAA;AAIjD,OAAO,KAAK,EAAE,0BAA0B,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAA;AAQjF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,eAAO,MAAM,uBAAuB,GAAI,wGASrC;IACD,MAAM,EAAE,eAAe,CAAA;IACvB,OAAO,EAAE,QAAQ,CAAA;IACjB,0BAA0B,EAAE,0BAA0B,CAAA;IACtD,sFAAsF;IACtF,gBAAgB,EAAE,SAAS,CAAC,SAAS,CAAA;IACrC,OAAO,EAAE,UAAU,GAAG,QAAQ,CAAA;IAC9B,MAAM,EAAE;QACN;;WAEG;QACH,kBAAkB,CAAC,EAAE,MAAM,CAAA;QAC3B;;WAEG;QACH,oBAAoB,CAAC,EAAE,MAAM,CAAA;KAC9B,CAAA;IACD;;;OAGG;IACH,QAAQ,EAAE,OAAO,CAAA;IACjB,OAAO,EAAE;QACP,MAAM,CAAC,EAAE;YACP,mBAAmB,CAAC,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;SAC1C,CAAA;KACF,CAAA;CACF,KAAG,MAAM,CAAC,MAAM,CAAC,mBAAmB,EAAE,eAAe,EAAE,KAAK,CAAC,KAAK,CAuQ/D,CAAA"}
+{"version":3,"file":"LeaderSyncProcessor.d.ts","sourceRoot":"","sources":["../../src/leader-thread/LeaderSyncProcessor.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAuB,KAAK,EAAU,MAAM,yBAAyB,CAAA;AACjF,OAAO,EAKL,MAAM,EAYP,MAAM,yBAAyB,CAAA;AAEhC,OAAO,EAAyB,KAAK,QAAQ,EAAgB,MAAM,qBAAqB,CAAA;AAGxF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AAKvD,OAAO,KAAK,SAAS,MAAM,sBAAsB,CAAA;AAKjD,OAAO,KAAK,EAAE,0BAA0B,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAA;AAWjF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,eAAO,MAAM,uBAAuB,GAAI,6HAUrC;IACD,MAAM,EAAE,eAAe,CAAA;IACvB,OAAO,EAAE,QAAQ,CAAA;IACjB,0BAA0B,EAAE,0BAA0B,CAAA;IACtD,sFAAsF;IACtF,gBAAgB,EAAE,SAAS,CAAC,SAAS,CAAA;IACrC;;;;;OAKG;IACH,OAAO,EAAE,UAAU,GAAG,QAAQ,CAAA;IAC9B;;;;;;OAMG;IACH,mBAAmB,EAAE,OAAO,GAAG,UAAU,GAAG,QAAQ,CAAA;IACpD,MAAM,EAAE;QACN;;;;;;;;;;;;;;;;;;;;WAoBG;QACH,kBAAkB,CAAC,EAAE,MAAM,CAAA;QAC3B;;;;;;;;;;;;;;;;;WAiBG;QACH,oBAAoB,CAAC,EAAE,MAAM,CAAA;KAC9B,CAAA;IACD;;;OAGG;IACH,QAAQ,EAAE,OAAO,CAAA;IACjB,OAAO,EAAE;QACP,MAAM,CAAC,EAAE;YACP,mBAAmB,CAAC,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;SAC1C,CAAA;KACF,CAAA;CACF,KAAG,MAAM,CAAC,MAAM,CAAC,mBAAmB,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,CA2RrD,CAAA"}