@virtualdisplay.io/client 3.3.0 → 3.4.0

package/dist/virtualdisplay.client.es.js

@@ -54,6 +54,8 @@ const EVENT_NAMES = {
   IFRAME_READY: "iframe:ready",
   // Mutation flow (Client → Server)
   MUTATION_MESSAGE: "mutation:message",
+  // Config flow (Client → Server)
+  CONFIG_MESSAGE: "config:message",
   // State flow (Server → Client)
   MESSAGE_RECEIVED: "message:received",
   STATE_CHANGED: "state:changed",
@@ -6926,7 +6928,8 @@ class MappingValidator {
 }
 const MESSAGE_TYPES = {
   MUTATION: "mutation",
-  STATE: "state"
+  STATE: "state",
+  CONFIG: "config"
 };
 function createMutationMessage(mutations) {
   if (!Array.isArray(mutations)) {
@@ -6938,7 +6941,7 @@ function createMutationMessage(mutations) {
   };
 }
 function isValidMessage(data) {
-  return isMutationMessage(data) || isStateMessage(data);
+  return isMutationMessage(data) || isStateMessage(data) || isConfigMessage(data);
 }
 function isMutationMessage(data) {
   if (typeof data !== "object" || data === null) {
@@ -6954,6 +6957,13 @@ function isStateMessage(data) {
   const obj = data;
   return obj.type === MESSAGE_TYPES.STATE && Array.isArray(obj.nodes);
 }
+function isConfigMessage(data) {
+  if (typeof data !== "object" || data === null) {
+    return false;
+  }
+  const obj = data;
+  return obj.type === MESSAGE_TYPES.CONFIG && typeof obj.config === "object" && obj.config !== null;
+}
 class AttributeService {
   attributes = /* @__PURE__ */ new Map();
   eventBus;
@@ -7149,8 +7159,14 @@ class MessageHandler {
     logger.debug("Message handler started listening");
   }
   setupOutgoingMessages() {
-    this.eventBus.on(EVENT_NAMES.MUTATION_MESSAGE, (event) => {
-      this.queueOrSend(event.message);
+    const outgoingEvents = [
+      EVENT_NAMES.MUTATION_MESSAGE,
+      EVENT_NAMES.CONFIG_MESSAGE
+    ];
+    outgoingEvents.forEach((eventName) => {
+      this.eventBus.on(eventName, (event) => {
+        this.queueOrSend(event.message);
+      });
     });
   }
   setupReadyListener() {
@@ -7187,7 +7203,7 @@ class NodeSelector {
       logger.warn(`Cannot toggle node ${this.nodeId}: node not found`);
       return;
     }
-    if (node.isVisible === true) {
+    if (node.isVisible) {
       this.hide();
       return;
     }
@@ -7337,11 +7353,100 @@ class StateService {
     this.hasReceivedInitialSync = false;
   }
 }
+class VirtualdisplayViewerService {
+  eventBus;
+  constructor(eventBus) {
+    this.eventBus = eventBus;
+  }
+  /**
+   * Send initial configuration based on client options
+   * Only sends config when values are false (server defaults to true)
+   */
+  sendInitialConfig(options) {
+    const config = {};
+    if (options.arEnabled === false) {
+      config.arEnabled = false;
+    }
+    if (options.fullscreenEnabled === false) {
+      config.fullscreenEnabled = false;
+    }
+    if (options.loadingIndicatorEnabled === false) {
+      config.loadingIndicatorEnabled = false;
+    }
+    if (Object.keys(config).length > 0) {
+      logger.debug("Sending initial UI configuration", config);
+      this.sendUIConfig(config);
+    }
+  }
+  /**
+   * Update AR button visibility
+   */
+  setArEnabled(enabled) {
+    logger.debug(`Setting AR button enabled: ${enabled}`);
+    this.sendUIConfig({ arEnabled: enabled });
+  }
+  /**
+   * Update fullscreen button visibility
+   */
+  setFullscreenEnabled(enabled) {
+    logger.debug(`Setting fullscreen button enabled: ${enabled}`);
+    this.sendUIConfig({ fullscreenEnabled: enabled });
+  }
+  /**
+   * Update loading indicator visibility
+   */
+  setLoadingIndicatorEnabled(enabled) {
+    logger.debug(`Setting loading indicator enabled: ${enabled}`);
+    this.sendUIConfig({ loadingIndicatorEnabled: enabled });
+  }
+  /**
+   * Update multiple UI settings at once
+   */
+  updateUIConfig(config) {
+    logger.debug("Updating UI configuration", config);
+    this.sendUIConfig(config);
+  }
+  /**
+   * Hide all UI elements
+   */
+  hideAllUI() {
+    logger.debug("Hiding all UI elements");
+    this.sendUIConfig({
+      arEnabled: false,
+      fullscreenEnabled: false,
+      loadingIndicatorEnabled: false
+    });
+  }
+  /**
+   * Show all UI elements
+   */
+  showAllUI() {
+    logger.debug("Showing all UI elements");
+    this.sendUIConfig({
+      arEnabled: true,
+      fullscreenEnabled: true,
+      loadingIndicatorEnabled: true
+    });
+  }
+  /**
+   * Send UI configuration to server
+   */
+  sendUIConfig(uiConfig) {
+    const config = { ui: uiConfig };
+    const message = {
+      type: MESSAGE_TYPES.CONFIG,
+      config
+    };
+    logger.debug("Emitting CONFIG message", message);
+    this.eventBus.emit(EVENT_NAMES.CONFIG_MESSAGE, { message });
+  }
+}
 class VirtualdisplayClient {
   eventBus;
   attributeService;
   stateService;
   messageHandler;
+  viewerService;
   options;
   iframe;
   constructor(options) {
@@ -7350,8 +7455,10 @@ class VirtualdisplayClient {
     this.attributeService = new AttributeService(this.eventBus);
     this.stateService = new StateService(this.eventBus);
     this.messageHandler = new MessageHandler(this.eventBus);
+    this.viewerService = new VirtualdisplayViewerService(this.eventBus);
     this.initializeLogging();
     this.createAndConnectIframe();
+    this.setupInitialConfig();
   }
   initializeLogging() {
     if (this.options.debug === true) {
@@ -7370,6 +7477,11 @@ class VirtualdisplayClient {
     logger.debug("Iframe created, setting up messaging");
     this.messageHandler.setIframe(this.iframe);
   }
+  setupInitialConfig() {
+    this.eventBus.once(EVENT_NAMES.IFRAME_READY, () => {
+      this.viewerService.sendInitialConfig(this.options);
+    });
+  }
   /**
    * Load attribute mapping configuration
    * @throws {VirtualdisplayError} When mapping configuration is invalid
@@ -7431,6 +7543,12 @@ class VirtualdisplayClient {
     }
     this.eventBus.once(EVENT_NAMES.INITIAL_STATE_RECEIVED, callback);
   }
+  /**
+   * Get the viewer service for UI configuration
+   */
+  get viewer() {
+    return this.viewerService;
+  }
   destroy() {
     logger.info("Destroying Virtualdisplay client");
     this.attributeService.clear();
@@ -7456,6 +7574,7 @@ export {
   NodeSelector,
   VirtualdisplayClient,
   VirtualdisplayError,
+  VirtualdisplayViewerService,
   enableDebugMode,
   isDebugMode,
   logger,