@spooky-sync/core 0.0.1-canary.155 → 0.0.1-canary.156

package/dist/index.js

@@ -5694,8 +5694,8 @@ async function walkOpfs(maxEntries = 2e3, maxDepth = 8) {
 
 //#endregion
 //#region src/modules/devtools/index.ts
-const CORE_VERSION = "0.0.1-canary.155";
-const WASM_VERSION = "0.0.1-canary.155";
+const CORE_VERSION = "0.0.1-canary.156";
+const WASM_VERSION = "0.0.1-canary.156";
 const SURREAL_VERSION = "3.0.3";
 var DevToolsService = class {
 	eventsHistory = [];
@@ -5703,7 +5703,8 @@ var DevToolsService = class {
 	version = CORE_VERSION;
 	backendInfo = emptyBackendInfo();
 	enabled = false;
-	/** Shared-tabs snapshot for the panel, wired by Sp00kyClient when active. */
+	/** Shared-tabs snapshot for the panel, wired by Sp00kyClient whenever the
+	*  feature was REQUESTED (so an inactive/degraded tab still reports why). */
 	tabsInfoProvider = null;
 	setTabsInfoProvider(provider) {
 		this.tabsInfoProvider = provider;
@@ -5925,6 +5926,7 @@ var DevToolsService = class {
 				status: "unknown",
 				fallback: false
 			},
+			tabs: this.tabsInfoProvider?.() ?? null,
 			browser: {},
 			opfs: {
 				supported: false,
@@ -8784,24 +8786,33 @@ var Sp00kyClient = class {
 		this.devTools = new DevToolsService(this.local, this.remote, logger, this.config.schema, this.auth, this.dataModule);
 		this.streamProcessor.addReceiver(this.devTools);
 		this.setupCallbacks();
-		if (tabsSupport.supported) {
-			this.tabsCoordinator = this.buildTabsCoordinator();
+		if (tabsSupport.supported) this.tabsCoordinator = this.buildTabsCoordinator();
+		else if (this.config.sharedTabs) this.logger.info({
+			reason: tabsSupport.reason,
+			Category: "sp00ky-client::Sp00kyClient::tabs"
+		}, "sharedTabs requested but unsupported here; running solo");
+		if (this.config.sharedTabs) {
+			const unsupportedReason = tabsSupport.supported ? void 0 : tabsSupport.reason;
 			this.devTools.setTabsInfoProvider(() => {
-				if (!this.sharedActive || !this.tabsCoordinator) return null;
 				const c = this.tabsCoordinator;
+				if (!this.sharedActive || !c) return {
+					active: false,
+					reason: unsupportedReason ?? "fell-back"
+				};
+				const hub = c.syncHub;
 				return {
+					active: true,
 					role: c.role,
 					tabId: c.tabId,
 					leadershipId: c.leadershipId,
-					leaderTabId: c.leaderTabId,
-					followers: c.syncHub?.followerCount ?? null,
-					relayedBatches: c.syncHub?.relayedBatches ?? null
+					leaderTabId: c.role === "leader" ? c.tabId : c.leaderTabId,
+					...hub ? {
+						followers: hub.followerCount,
+						relayedBatches: hub.relayedBatches
+					} : {}
 				};
 			});
-		} else if (this.config.sharedTabs) this.logger.info({
-			reason: tabsSupport.reason,
-			Category: "sp00ky-client::Sp00kyClient::tabs"
-		}, "sharedTabs requested but unsupported here; running solo");
+		}
 	}
 	/** The shared-tabs role machinery, wired to this client's modules. */
 	buildTabsCoordinator() {
@@ -8810,7 +8821,7 @@ var Sp00kyClient = class {
 		return new TabsCoordinator({
 			tabId,
 			fingerprint: computeTabsFingerprint({
-				coreVersion: "0.0.1-canary.155",
+				coreVersion: "0.0.1-canary.156",
 				schemaHash: hash53(this.config.schemaSurql),
 				endpoint: this.config.database.endpoint ?? "",
 				namespace: this.config.database.namespace,

package/dist/types.d.ts

@@ -199,6 +199,13 @@ interface EngineStorageDiagnostics {
   }[];
   error?: string;
 }
+/**
+ * Shared-tabs coordination state. Reported ONLY when `sharedTabs: true` was
+ * configured (apps that never asked for it get `null`, so the panel shows
+ * nothing). `active: false` with a `reason` is itself the useful signal: the
+ * app asked to share one store and this tab is not, so it owns or contends for
+ * the OPFS pool alone.
+ */
 //#endregion
 //#region src/services/database/cache-engine.d.ts
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@spooky-sync/core",
-  "version": "0.0.1-canary.155",
+  "version": "0.0.1-canary.156",
   "type": "module",
   "sideEffects": false,
   "main": "./dist/index.js",
@@ -60,8 +60,8 @@
     }
   },
   "dependencies": {
-    "@spooky-sync/query-builder": "0.0.1-canary.155",
-    "@spooky-sync/ssp-wasm": "0.0.1-canary.155",
+    "@spooky-sync/query-builder": "0.0.1-canary.156",
+    "@spooky-sync/ssp-wasm": "0.0.1-canary.156",
     "@sqlite.org/sqlite-wasm": "3.53.0-build1",
     "@surrealdb/wasm": "^3.0.3",
     "fast-json-patch": "^3.1.1",

package/src/modules/devtools/index.ts

@@ -22,7 +22,7 @@ import {
   parseBackendInfo,
   UNAVAILABLE,
 } from './versions';
-import { walkOpfs, type StorageInfo } from './storage-info';
+import { walkOpfs, type SharedTabsInfo, type StorageInfo } from './storage-info';
 
 // Real bundled frontend versions, injected at build time by tsdown's
 // version-define plugin (see tsdown.config.ts). The `typeof` guard keeps these
@@ -51,10 +51,11 @@ export class DevToolsService implements StreamUpdateReceiver {
   // (the on-demand GET_STATE pull) still works before the push channel turns on.
   private enabled = false;
 
-  /** Shared-tabs snapshot for the panel, wired by Sp00kyClient when active. */
-  private tabsInfoProvider: (() => Record<string, unknown> | null) | null = null;
+  /** Shared-tabs snapshot for the panel, wired by Sp00kyClient whenever the
+   *  feature was REQUESTED (so an inactive/degraded tab still reports why). */
+  private tabsInfoProvider: (() => SharedTabsInfo | null) | null = null;
 
-  setTabsInfoProvider(provider: () => Record<string, unknown> | null): void {
+  setTabsInfoProvider(provider: () => SharedTabsInfo | null): void {
     this.tabsInfoProvider = provider;
   }
 
@@ -357,6 +358,7 @@ export class DevToolsService implements StreamUpdateReceiver {
         bucketId: this.databaseService.currentBucketId,
       },
       health: this.databaseService.storageHealth ?? { status: 'unknown', fallback: false },
+      tabs: this.tabsInfoProvider?.() ?? null,
       browser: {},
       opfs: { supported: false, entries: [], totalBytes: 0, truncated: false },
     };

package/src/modules/devtools/storage-info.ts

@@ -31,10 +31,37 @@ export interface EngineStorageDiagnostics {
   error?: string;
 }
 
+/**
+ * Shared-tabs coordination state. Reported ONLY when `sharedTabs: true` was
+ * configured (apps that never asked for it get `null`, so the panel shows
+ * nothing). `active: false` with a `reason` is itself the useful signal: the
+ * app asked to share one store and this tab is not, so it owns or contends for
+ * the OPFS pool alone.
+ */
+export interface SharedTabsInfo {
+  active: boolean;
+  /** Why inactive: a capability gate reason, or 'fell-back' when the broker
+   *  was reachable but no role landed (election timeout, rejected tab). */
+  reason?: string;
+  role?: 'solo' | 'leader' | 'follower';
+  /** This tab's id (also the suffix of every mutation id it mints). */
+  tabId?: string;
+  /** Monotonic id of the current leadership term; embedded in the worker lock. */
+  leadershipId?: number;
+  /** Who owns the store: this tab when leader, else the leader's tab id. */
+  leaderTabId?: string | null;
+  /** Leader only: attached follower tabs. */
+  followers?: number;
+  /** Leader only: ingest batches relayed to followers so far. */
+  relayedBatches?: number;
+}
+
 export interface StorageInfo {
   at: number;
   engine: { kind: 'surrealdb' | 'sqlite' | 'custom'; store: string; bucketId: string };
   health: { status: 'unknown' | 'persistent' | 'memory'; fallback: boolean; error?: string };
+  /** Shared-tabs state, or null when the feature was never requested. */
+  tabs?: SharedTabsInfo | null;
   browser: {
     /** `navigator.storage.persisted()` — whether the origin's storage is
      *  exempt from eviction (unrelated to the OPFS pool lock). */

package/src/sp00ky.ts

@@ -368,23 +368,35 @@ export class Sp00kyClient<S extends SchemaStructure> {
     // every module. Nothing starts until init() calls coordinator.start().
     if (tabsSupport.supported) {
       this.tabsCoordinator = this.buildTabsCoordinator();
+    } else if (this.config.sharedTabs) {
+      this.logger.info(
+        { reason: (tabsSupport as { reason: string }).reason, Category: 'sp00ky-client::Sp00kyClient::tabs' },
+        'sharedTabs requested but unsupported here; running solo'
+      );
+    }
+    // Report shared-tabs state whenever the feature was REQUESTED, active or
+    // not: "asked to share one store, running alone because X" is exactly the
+    // thing you need to see in the panel. Apps that never set the flag report
+    // null and the panel shows no section at all.
+    if (this.config.sharedTabs) {
+      const unsupportedReason = tabsSupport.supported
+        ? undefined
+        : (tabsSupport as { reason: string }).reason;
       this.devTools.setTabsInfoProvider(() => {
-        if (!this.sharedActive || !this.tabsCoordinator) return null;
         const c = this.tabsCoordinator;
+        if (!this.sharedActive || !c) {
+          return { active: false, reason: unsupportedReason ?? 'fell-back' };
+        }
+        const hub = c.syncHub;
         return {
+          active: true,
           role: c.role,
           tabId: c.tabId,
           leadershipId: c.leadershipId,
-          leaderTabId: c.leaderTabId,
-          followers: c.syncHub?.followerCount ?? null,
-          relayedBatches: c.syncHub?.relayedBatches ?? null,
+          leaderTabId: c.role === 'leader' ? c.tabId : c.leaderTabId,
+          ...(hub ? { followers: hub.followerCount, relayedBatches: hub.relayedBatches } : {}),
         };
       });
-    } else if (this.config.sharedTabs) {
-      this.logger.info(
-        { reason: (tabsSupport as { reason: string }).reason, Category: 'sp00ky-client::Sp00kyClient::tabs' },
-        'sharedTabs requested but unsupported here; running solo'
-      );
     }
   }