@virtualdisplay.io/client 3.3.0 → 3.4.1

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",
@@ -394,7 +396,6 @@ class IframeBuilder {
       height: "100%",
       border: "none"
     });
-    iframe.setAttribute("allowfullscreen", "true");
     iframe.setAttribute("allow", "xr-spatial-tracking; fullscreen");
     iframe.addEventListener("load", () => {
       logger.info("Virtualdisplay iframe loaded");
@@ -6926,7 +6927,8 @@ class MappingValidator {
 }
 const MESSAGE_TYPES = {
   MUTATION: "mutation",
-  STATE: "state"
+  STATE: "state",
+  CONFIG: "config"
 };
 function createMutationMessage(mutations) {
   if (!Array.isArray(mutations)) {
@@ -6938,7 +6940,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 +6956,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;
@@ -7051,8 +7060,19 @@ class EventBus {
     this.listeners.set(event, handlers);
   }
   emit(event, payload) {
-    this.listeners.get(event)?.forEach((listener) => listener(payload));
+    const handlers = this.listeners.get(event);
+    if (handlers === void 0 || handlers.length === 0) {
+      return;
+    }
+    const handlersCopy = [...handlers];
+    handlersCopy.forEach((listener) => {
+      listener(payload);
+    });
   }
+  /**
+   * Register a listener that will be called only once
+   * The listener is automatically removed after the first call
+   */
   once(event, listener) {
     const onceWrapper = (payload) => {
       this.off(event, onceWrapper);
@@ -7060,6 +7080,9 @@ class EventBus {
     };
     this.on(event, onceWrapper);
   }
+  /**
+   * Remove a specific listener for an event
+   */
   off(event, listener) {
     const handlers = this.listeners.get(event);
     if (handlers === void 0) {
@@ -7084,16 +7107,11 @@ class MessageHandler {
   }
   setIframe(iframe) {
     this.iframe = iframe;
-    logger.debug("Message handler configured with iframe", {
-      src: iframe.src,
-      loaded: iframe.contentWindow !== null
-    });
   }
   destroy() {
     window.removeEventListener("message", this.handleWindowMessage);
     this.queue.length = 0;
     this.isReady = false;
-    logger.debug("Message handler destroyed");
   }
   queueOrSend(message) {
     if (!this.isReady) {
@@ -7118,7 +7136,7 @@ class MessageHandler {
       payload: message
     });
     this.iframe.contentWindow.postMessage(message, targetOrigin);
-    logger.info("Message sent to server", message);
+    logger.debug("Message sent to server", message);
   }
   canSend() {
     return this.iframe?.contentWindow !== null && this.iframe?.contentWindow !== void 0;
@@ -7146,11 +7164,16 @@ class MessageHandler {
   };
   setupIncomingMessages() {
     window.addEventListener("message", this.handleWindowMessage);
-    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 +7210,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 +7360,98 @@ 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) {
+      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
+    };
+    this.eventBus.emit(EVENT_NAMES.CONFIG_MESSAGE, { message });
+  }
+}
 class VirtualdisplayClient {
   eventBus;
   attributeService;
   stateService;
   messageHandler;
+  viewerService;
   options;
   iframe;
   constructor(options) {
@@ -7350,8 +7460,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 +7482,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 +7548,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 +7579,7 @@ export {
   NodeSelector,
   VirtualdisplayClient,
   VirtualdisplayError,
+  VirtualdisplayViewerService,
   enableDebugMode,
   isDebugMode,
   logger,