@spooky-sync/core 0.0.1-canary.86 → 0.0.1-canary.88

package/dist/index.js

@@ -414,7 +414,7 @@ var DataModule = class {
 	onDeregister;
 	sessionId = "";
 	currentUserId = null;
-	constructor(cache, local, schema, logger, streamDebounceTime = 100) {
+	constructor(cache, local, schema, logger, streamDebounceTime = 50) {
 		this.cache = cache;
 		this.local = local;
 		this.schema = schema;
@@ -3484,14 +3484,15 @@ function parseBackendInfo(raw) {
 
 //#endregion
 //#region src/modules/devtools/index.ts
-const CORE_VERSION = "0.0.1-canary.86";
-const WASM_VERSION = "0.0.1-canary.86";
+const CORE_VERSION = "0.0.1-canary.88";
+const WASM_VERSION = "0.0.1-canary.88";
 const SURREAL_VERSION = "3.0.3";
 var DevToolsService = class {
 	eventsHistory = [];
 	eventIdCounter = 0;
 	version = CORE_VERSION;
 	backendInfo = emptyBackendInfo();
+	enabled = false;
 	constructor(databaseService, remoteDatabaseService, logger, schema, authService, dataManager) {
 		this.databaseService = databaseService;
 		this.remoteDatabaseService = remoteDatabaseService;
@@ -3500,6 +3501,14 @@ var DevToolsService = class {
 		this.authService = authService;
 		this.dataManager = dataManager;
 		this.exposeToWindow();
+		if (typeof window !== "undefined") window.addEventListener("message", (e) => {
+			if (e.source !== window) return;
+			const type = e.data?.type;
+			if (type === "SP00KY_DEVTOOLS_CONNECT") {
+				this.enabled = true;
+				this.notifyDevTools();
+			} else if (type === "SP00KY_DEVTOOLS_DISCONNECT") this.enabled = false;
+		});
 		this.authService.eventSystem.subscribe(AuthEventTypes.AuthStateChanged, () => {
 			this.notifyDevTools();
 		});
@@ -3606,6 +3615,7 @@ var DevToolsService = class {
 		this.notifyDevTools();
 	}
 	addEvent(eventType, payload) {
+		if (!this.enabled) return;
 		this.eventsHistory.push({
 			id: this.eventIdCounter++,
 			timestamp: Date.now(),
@@ -3639,6 +3649,7 @@ var DevToolsService = class {
 		});
 	}
 	notifyDevTools() {
+		if (!this.enabled) return;
 		if (typeof window !== "undefined") window.postMessage({
 			type: "SP00KY_STATE_CHANGED",
 			source: "sp00ky-devtools-page",

package/dist/types.d.ts

@@ -263,8 +263,10 @@ interface Sp00kyConfig<S extends SchemaStructure> {
   /** A pino browser transmit object for forwarding logs (e.g. via @spooky-sync/core/otel). */
   otelTransmit?: PinoTransmit;
   /**
-   * Debounce time in milliseconds for stream updates.
-   * Defaults to 100ms.
+   * Debounce time in milliseconds for stream updates (the client-side SSP
+   * aggregation throttle — coalesces the in-browser StreamProcessor's
+   * per-record updates per query before notifying readers).
+   * Defaults to 50ms.
    */
   streamDebounceTime?: number;
   /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@spooky-sync/core",
-  "version": "0.0.1-canary.86",
+  "version": "0.0.1-canary.88",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -59,8 +59,8 @@
     }
   },
   "dependencies": {
-    "@spooky-sync/query-builder": "0.0.1-canary.86",
-    "@spooky-sync/ssp-wasm": "0.0.1-canary.86",
+    "@spooky-sync/query-builder": "0.0.1-canary.88",
+    "@spooky-sync/ssp-wasm": "0.0.1-canary.88",
     "@surrealdb/wasm": "^3.0.3",
     "fast-json-patch": "^3.1.1",
     "loro-crdt": "^1.5.6",

package/src/modules/data/index.ts

@@ -116,7 +116,12 @@ export class DataModule<S extends SchemaStructure> {
     private local: LocalDatabaseService,
     private schema: S,
     logger: Logger,
-    private streamDebounceTime: number = 100
+    // Client-side SSP aggregation throttle: coalesces the in-browser
+    // StreamProcessor's per-record stream updates per query before notifying
+    // readers, so a burst of synced records repaints the UI once per window
+    // rather than row-by-row. 50ms keeps it responsive while still batching the
+    // initial-sync stream. Override via `SyncedDbConfig.streamDebounceTime`.
+    private streamDebounceTime: number = 50
   ) {
     this.logger = logger.child({ service: 'DataModule' });
   }

package/src/modules/devtools/index.ts

@@ -42,6 +42,12 @@ export class DevToolsService implements StreamUpdateReceiver {
   // Backend stack info (versions + per-entity status), read via the
   // `fn::spooky::info()` SurrealQL function; empty/'unavailable' until resolved.
   private backendInfo: BackendInfo = emptyBackendInfo();
+  // Dormant until a devtools consumer (extension panel or MCP) handshakes via
+  // `SP00KY_DEVTOOLS_CONNECT`. While false, `notifyDevTools()`/`addEvent()` do no
+  // work, so prod pays zero serialization/postMessage cost for an unwatched panel.
+  // `window.__00__.getState()` stays live regardless, so the panel's first paint
+  // (the on-demand GET_STATE pull) still works before the push channel turns on.
+  private enabled = false;
 
   constructor(
     private databaseService: LocalDatabaseService,
@@ -53,6 +59,22 @@ export class DevToolsService implements StreamUpdateReceiver {
   ) {
     this.exposeToWindow();
 
+    // Stay dormant until a devtools consumer announces itself. The extension's
+    // page-script posts this once it detects `window.__00__`; the panel can also
+    // disconnect to return us to dormant. Until then we skip all serialization.
+    if (typeof window !== 'undefined') {
+      window.addEventListener('message', (e) => {
+        if (e.source !== window) return;
+        const type = (e.data as { type?: string } | undefined)?.type;
+        if (type === 'SP00KY_DEVTOOLS_CONNECT') {
+          this.enabled = true;
+          this.notifyDevTools();
+        } else if (type === 'SP00KY_DEVTOOLS_DISCONNECT') {
+          this.enabled = false;
+        }
+      });
+    }
+
     // Subscribe to auth events
     this.authService.eventSystem.subscribe(AuthEventTypes.AuthStateChanged, () => {
       this.notifyDevTools();
@@ -197,6 +219,8 @@ export class DevToolsService implements StreamUpdateReceiver {
   }
 
   private addEvent(eventType: string, payload: any) {
+    // No consumer attached → skip recording (and the recursive serialize it does).
+    if (!this.enabled) return;
     this.eventsHistory.push({
       id: this.eventIdCounter++,
       timestamp: Date.now(),
@@ -232,6 +256,8 @@ export class DevToolsService implements StreamUpdateReceiver {
   }
 
   private notifyDevTools() {
+    // No consumer attached → no getState() serialization, no postMessage broadcast.
+    if (!this.enabled) return;
     if (typeof window !== 'undefined') {
       window.postMessage(
         {

package/src/types.ts

@@ -113,8 +113,10 @@ export interface Sp00kyConfig<S extends SchemaStructure> {
   /** A pino browser transmit object for forwarding logs (e.g. via @spooky-sync/core/otel). */
   otelTransmit?: PinoTransmit;
   /**
-   * Debounce time in milliseconds for stream updates.
-   * Defaults to 100ms.
+   * Debounce time in milliseconds for stream updates (the client-side SSP
+   * aggregation throttle — coalesces the in-browser StreamProcessor's
+   * per-record updates per query before notifying readers).
+   * Defaults to 50ms.
    */
   streamDebounceTime?: number;
   /**