@livestore/common 0.4.0-dev.21 → 0.4.0-dev.23

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, UnknownError } 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,13 +34,27 @@ 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.
@@ -94,5 +108,5 @@ export declare const makeLeaderSyncProcessor: ({ schema, dbState, initialBlockin
             localPushProcessing?: Effect.Effect<void>;
         };
     };
-}) => Effect.Effect<LeaderSyncProcessor, UnknownError, 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,EAYP,MAAM,yBAAyB,CAAA;AAEhC,OAAO,EAAwD,KAAK,QAAQ,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAEvH,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;;;;;;;;;;;;;;;;;;;;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,YAAY,EAAE,KAAK,CAAC,KAAK,CAuR5D,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"}