@syncular/client 0.30.0 → 0.30.1

package/README.md

@@ -221,7 +221,8 @@ with `client.follower_timeout` when the link goes `blocked`, with
 `client.leader_handover` when another leader announces or this tab promotes
 before the answer arrives, and with `client.worker_failed` when the handle
 closes. Only calls queued while no leader is bound keep the
-`followerCallTimeoutMs` deadline.
+`followerCallTimeoutMs` deadline; when this tab wins the lock itself, its own
+core runs them.
 
 **Tabs of different builds never serve each other.** Every `hello`, `req`,
 and `announce` carries `MULTI_TAB_PROTOCOL_VERSION` and the schema version.

package/dist/multi-tab.d.ts

@@ -192,6 +192,11 @@ export declare class FollowerLink {
      * flushes the queued ones.
      */
     unbind(): void;
+    /**
+     * This tab won the lock and runs its own core: calls queued for the next
+     * leader run on `invoke` instead of failing, then the link closes.
+     */
+    handOver(invoke: (method: string, args: readonly unknown[]) => Promise<unknown>): void;
     close(): void;
 }
 export {};

package/dist/multi-tab.js

@@ -502,6 +502,19 @@ export class FollowerLink {
         this.#armUnboundDeadline();
         this.#probe();
     }
+    /**
+     * This tab won the lock and runs its own core: calls queued for the next
+     * leader run on `invoke` instead of failing, then the link closes.
+     */
+    handOver(invoke) {
+        const queued = this.#queue;
+        this.#queue = [];
+        for (const call of queued) {
+            call.cancelTimer?.();
+            invoke(call.method, call.args).then(call.resolve, call.reject);
+        }
+        this.close();
+    }
     close() {
         if (this.#closed)
             return;

package/dist/reactive-store.js

@@ -233,6 +233,10 @@ class ObservationCache {
         for (const entry of this.#active)
             entry.onChange(batch);
     }
+    onLeaderServing() {
+        for (const entry of this.#active)
+            entry.onLeaderServing?.();
+    }
     clear() {
         for (const entry of this.#entries.values())
             entry.dispose();
@@ -386,6 +390,15 @@ class QueryEntry {
         this.store.releaseWindowClaims(this.#owner);
         this.reset();
     }
+    /** A claim rejected while no leader served this tab (blocked, handover,
+     * another build) is claimed again; its stored error would fail every read. */
+    onLeaderServing() {
+        if (this.#delegate !== undefined || this.#claimError === undefined)
+            return;
+        this.#claimError = undefined;
+        this.#claimCoverage();
+        this.#requestRead();
+    }
     onChange(batch) {
         if (!batchMatches(batch, this.spec))
             return;
@@ -446,12 +459,6 @@ class QueryEntry {
             return;
         }
         const wasBlocked = this.#state.phase === 'blocked';
-        // A claim that failed while the leader link was blocked is retried with
-        // the link: its stored error would otherwise fail every later read.
-        if (wasBlocked && this.#claimError !== undefined) {
-            this.#claimError = undefined;
-            this.#claimCoverage();
-        }
         this.#publish({
             ...this.#state,
             phase: wasBlocked
@@ -1002,6 +1009,7 @@ export class ReactiveClientStore {
                     if (group.claims.size > 0)
                         this.#scheduleWindow(group);
                 }
+                this.#queries.onLeaderServing();
             }
         });
         this.status.refresh();

package/dist/worker-host.js

@@ -128,7 +128,8 @@ export class SyncClientHandle {
     }
     /** @internal — swap this handle from follower to leader (promotion). */
     __becomeLeader(core) {
-        this.#follower?.close();
+        // Calls queued for the next leader run on this tab's own core.
+        this.#follower?.handOver(core.invoke);
         this.#follower = undefined;
         this.#core = core;
         this.#clientId = core.clientId;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@syncular/client",
-  "version": "0.30.0",
+  "version": "0.30.1",
   "description": "Syncular TypeScript client core — offline-first sync over SQLite (WASM/OPFS, Bun, Node)",
   "license": "Apache-2.0",
   "author": "Benjamin Kniffler",
@@ -89,10 +89,10 @@
   },
   "dependencies": {
     "@sqlite.org/sqlite-wasm": "^3.53.0-build1",
-    "@syncular/core": "0.30.0"
+    "@syncular/core": "0.30.1"
   },
   "devDependencies": {
-    "@syncular/server": "0.30.0",
+    "@syncular/server": "0.30.1",
     "playwright": "1.63.0"
   }
 }

package/src/multi-tab.ts

@@ -724,6 +724,22 @@ export class FollowerLink {
     this.#probe();
   }
 
+  /**
+   * This tab won the lock and runs its own core: calls queued for the next
+   * leader run on `invoke` instead of failing, then the link closes.
+   */
+  handOver(
+    invoke: (method: string, args: readonly unknown[]) => Promise<unknown>,
+  ): void {
+    const queued = this.#queue;
+    this.#queue = [];
+    for (const call of queued) {
+      call.cancelTimer?.();
+      invoke(call.method, call.args).then(call.resolve, call.reject);
+    }
+    this.close();
+  }
+
   close(): void {
     if (this.#closed) return;
     this.#closed = true;

package/src/reactive-store.ts

@@ -315,6 +315,8 @@ function reconcileRows<Row>(
 
 interface CachedObservation {
   onChange(batch: ClientChangeBatch): void;
+  /** A leader serves this tab again (it leads or follows a bound leader). */
+  onLeaderServing?(): void;
   reset(): void;
   dispose(): void;
 }
@@ -356,6 +358,9 @@ class ObservationCache {
   onChange(batch: ClientChangeBatch): void {
     for (const entry of this.#active) entry.onChange(batch);
   }
+  onLeaderServing(): void {
+    for (const entry of this.#active) entry.onLeaderServing?.();
+  }
   clear(): void {
     for (const entry of this.#entries.values()) entry.dispose();
     this.#entries.clear();
@@ -523,6 +528,15 @@ class QueryEntry<Row> implements ExternalStoreEntry<LiveQueryResult<Row>> {
     this.reset();
   }
 
+  /** A claim rejected while no leader served this tab (blocked, handover,
+   * another build) is claimed again; its stored error would fail every read. */
+  onLeaderServing(): void {
+    if (this.#delegate !== undefined || this.#claimError === undefined) return;
+    this.#claimError = undefined;
+    this.#claimCoverage();
+    this.#requestRead();
+  }
+
   onChange(batch: ClientChangeBatch): void {
     if (!batchMatches(batch, this.spec)) return;
     if (batch.revision > this.#desiredRevision) {
@@ -584,12 +598,6 @@ class QueryEntry<Row> implements ExternalStoreEntry<LiveQueryResult<Row>> {
       return;
     }
     const wasBlocked = this.#state.phase === 'blocked';
-    // A claim that failed while the leader link was blocked is retried with
-    // the link: its stored error would otherwise fail every later read.
-    if (wasBlocked && this.#claimError !== undefined) {
-      this.#claimError = undefined;
-      this.#claimCoverage();
-    }
     this.#publish({
       ...this.#state,
       phase: wasBlocked
@@ -1188,6 +1196,7 @@ export class ReactiveClientStore {
         for (const group of this.#windowClaims.values()) {
           if (group.claims.size > 0) this.#scheduleWindow(group);
         }
+        this.#queries.onLeaderServing();
       }
     });
     this.status.refresh();

package/src/worker-host.ts

@@ -385,7 +385,8 @@ export class SyncClientHandle implements PromiseMethods<WorkerApi> {
 
   /** @internal — swap this handle from follower to leader (promotion). */
   __becomeLeader(core: LeaderCore): void {
-    this.#follower?.close();
+    // Calls queued for the next leader run on this tab's own core.
+    this.#follower?.handOver(core.invoke);
     this.#follower = undefined;
     this.#core = core;
     this.#clientId = core.clientId;