@virtualdisplay.io/client 3.2.1 → 3.3.0

package/dist/virtualdisplay.client.es.js

@@ -56,7 +56,8 @@ const EVENT_NAMES = {
   MUTATION_MESSAGE: "mutation:message",
   // State flow (Server → Client)
   MESSAGE_RECEIVED: "message:received",
-  STATE_CHANGED: "state:changed"
+  STATE_CHANGED: "state:changed",
+  INITIAL_STATE_RECEIVED: "state:initial-received"
 };
 const g = Object.freeze({
   debug: 0,
@@ -359,8 +360,8 @@ o.getInstance();
 o.enableMemoryLogging.bind(o);
 const logger = o.getInstance().child({
   prefix: "Client",
-  level: "info"
-  // Default level, can be changed via enableDebugMode
+  level: "warn"
+  // Show warnings and errors by default
 });
 function enableDebugMode() {
   logger.setLevel("debug");
@@ -7224,6 +7225,7 @@ class ModelNode {
   name;
   type;
   visible;
+  onChange;
   constructor(params) {
     this.id = params.id;
     this.name = params.name;
@@ -7243,6 +7245,7 @@ class ModelNode {
 class StateService {
   nodes = /* @__PURE__ */ new Map();
   eventBus;
+  hasReceivedInitialSync = false;
   constructor(eventBus) {
     this.eventBus = eventBus;
     this.eventBus.on(EVENT_NAMES.MESSAGE_RECEIVED, (event) => {
@@ -7255,28 +7258,32 @@ class StateService {
       currentNodeCount: this.nodeCount
     });
     if (isStateMessage(message)) {
-      this.updateState(message.nodes);
+      this.updateState(message.nodes, message.isInitial);
     }
   }
-  updateState(newNodes) {
-    const wasInitial = !this.hasInitialState;
+  updateState(newNodes, isInitial) {
     logger.debug("Updating state with nodes from server", {
       incomingNodes: newNodes.length,
-      isInitialState: wasInitial,
+      isInitialState: isInitial,
       currentNodes: this.nodeCount
     });
     for (const nodeData of newNodes) {
-      this.updateOrCreateNode(nodeData);
+      const shouldProcessNode = !isInitial || !this.nodes.has(nodeData.id);
+      if (shouldProcessNode) {
+        this.updateOrCreateNode(nodeData);
+      }
     }
     this.eventBus.emit(EVENT_NAMES.STATE_CHANGED, {
       nodes: this.getAllNodes()
     });
     logger.info("State updated", {
       totalNodes: this.nodeCount,
-      wasInitialState: wasInitial
+      wasInitialState: isInitial
     });
-    if (wasInitial) {
+    if (isInitial && !this.hasReceivedInitialSync) {
+      this.hasReceivedInitialSync = true;
       logger.info("Initial state received - client is now ready");
+      this.eventBus.emit(EVENT_NAMES.INITIAL_STATE_RECEIVED, {});
     }
   }
   updateOrCreateNode(newNodeData) {
@@ -7285,8 +7292,12 @@ class StateService {
       this.createNewNode(newNodeData);
       return;
     }
+    const previousVisibility = existingNode.isVisible;
     const visibilityMethod = newNodeData.visible ? "show" : "hide";
     existingNode[visibilityMethod]();
+    if (previousVisibility !== existingNode.isVisible && existingNode.onChange !== void 0) {
+      existingNode.onChange();
+    }
     logger.debug("Updated existing node", {
       id: existingNode.id,
       name: existingNode.name,
@@ -7316,16 +7327,14 @@ class StateService {
     return Array.from(this.nodes.values());
   }
   get isReady() {
-    return this.hasInitialState;
+    return this.hasReceivedInitialSync;
   }
   get nodeCount() {
     return this.nodes.size;
   }
-  get hasInitialState() {
-    return this.nodeCount > 0;
-  }
   clear() {
     this.nodes.clear();
+    this.hasReceivedInitialSync = false;
   }
 }
 class VirtualdisplayClient {
@@ -7405,6 +7414,23 @@ class VirtualdisplayClient {
   getNodes() {
     return this.stateService.getAllNodes();
   }
+  /**
+   * Check if the client has received initial state and is ready
+   */
+  get isReady() {
+    return this.stateService.isReady;
+  }
+  /**
+   * Register a callback to be called when the client is ready
+   * If already ready, the callback is called immediately
+   */
+  onReady(callback) {
+    if (this.stateService.isReady) {
+      callback();
+      return;
+    }
+    this.eventBus.once(EVENT_NAMES.INITIAL_STATE_RECEIVED, callback);
+  }
   destroy() {
     logger.info("Destroying Virtualdisplay client");
     this.attributeService.clear();