@virtualdisplay.io/client 3.4.0 → 3.5.0

package/dist/virtualdisplay.client.es.js

@@ -56,6 +56,8 @@ const EVENT_NAMES = {
   MUTATION_MESSAGE: "mutation:message",
   // Config flow (Client → Server)
   CONFIG_MESSAGE: "config:message",
+  // Camera flow (Client → Server)
+  CAMERA_MESSAGE: "camera:message",
   // State flow (Server → Client)
   MESSAGE_RECEIVED: "message:received",
   STATE_CHANGED: "state:changed",
@@ -396,7 +398,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");
@@ -6929,7 +6930,8 @@ class MappingValidator {
 const MESSAGE_TYPES = {
   MUTATION: "mutation",
   STATE: "state",
-  CONFIG: "config"
+  CONFIG: "config",
+  CAMERA: "camera"
 };
 function createMutationMessage(mutations) {
   if (!Array.isArray(mutations)) {
@@ -7053,6 +7055,61 @@ class AttributeService {
     this.isInitialized = false;
   }
 }
+class Camera {
+  constructor(eventBus) {
+    this.eventBus = eventBus;
+  }
+  commands = [];
+  /**
+   * Rotate camera horizontally
+   * @param degrees - Absolute rotation in degrees (0 = front view)
+   */
+  rotate(degrees) {
+    this.commands.push({ action: "rotate", value: degrees });
+    return this;
+  }
+  /**
+   * Tilt camera vertically
+   * @param degrees - Absolute tilt in degrees (0 = top view, 90 = horizontal)
+   */
+  tilt(degrees) {
+    this.commands.push({ action: "tilt", value: degrees });
+    return this;
+  }
+  /**
+   * Zoom camera
+   * @param percentage - Zoom percentage (100 = normal, >100 = zoom in, <100 = zoom out)
+   */
+  zoom(percentage) {
+    this.commands.push({ action: "zoom", value: percentage });
+    return this;
+  }
+  /**
+   * Execute accumulated camera commands
+   */
+  set() {
+    if (this.commands.length === 0) {
+      return;
+    }
+    const message = {
+      type: MESSAGE_TYPES.CAMERA,
+      commands: this.commands
+    };
+    this.eventBus.emit(EVENT_NAMES.CAMERA_MESSAGE, { message });
+    this.commands = [];
+  }
+  /**
+   * Reset camera to initial position
+   * This is not chainable and executes immediately
+   */
+  reset() {
+    const message = {
+      type: MESSAGE_TYPES.CAMERA,
+      commands: [{ action: "reset" }]
+    };
+    this.eventBus.emit(EVENT_NAMES.CAMERA_MESSAGE, { message });
+  }
+}
 class EventBus {
   listeners = /* @__PURE__ */ new Map();
   on(event, listener) {
@@ -7061,8 +7118,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);
@@ -7070,6 +7138,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) {
@@ -7094,16 +7165,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) {
@@ -7128,7 +7194,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;
@@ -7156,12 +7222,12 @@ class MessageHandler {
   };
   setupIncomingMessages() {
     window.addEventListener("message", this.handleWindowMessage);
-    logger.debug("Message handler started listening");
   }
   setupOutgoingMessages() {
     const outgoingEvents = [
       EVENT_NAMES.MUTATION_MESSAGE,
-      EVENT_NAMES.CONFIG_MESSAGE
+      EVENT_NAMES.CONFIG_MESSAGE,
+      EVENT_NAMES.CAMERA_MESSAGE
     ];
     outgoingEvents.forEach((eventName) => {
       this.eventBus.on(eventName, (event) => {
@@ -7374,7 +7440,6 @@ class VirtualdisplayViewerService {
       config.loadingIndicatorEnabled = false;
     }
     if (Object.keys(config).length > 0) {
-      logger.debug("Sending initial UI configuration", config);
       this.sendUIConfig(config);
     }
   }
@@ -7437,7 +7502,6 @@ class VirtualdisplayViewerService {
       type: MESSAGE_TYPES.CONFIG,
       config
     };
-    logger.debug("Emitting CONFIG message", message);
     this.eventBus.emit(EVENT_NAMES.CONFIG_MESSAGE, { message });
   }
 }
@@ -7447,6 +7511,7 @@ class VirtualdisplayClient {
   stateService;
   messageHandler;
   viewerService;
+  cameraApi;
   options;
   iframe;
   constructor(options) {
@@ -7456,6 +7521,7 @@ class VirtualdisplayClient {
     this.stateService = new StateService(this.eventBus);
     this.messageHandler = new MessageHandler(this.eventBus);
     this.viewerService = new VirtualdisplayViewerService(this.eventBus);
+    this.cameraApi = new Camera(this.eventBus);
     this.initializeLogging();
     this.createAndConnectIframe();
     this.setupInitialConfig();
@@ -7549,6 +7615,12 @@ class VirtualdisplayClient {
   get viewer() {
     return this.viewerService;
   }
+  /**
+   * Get the camera control API
+   */
+  get camera() {
+    return this.cameraApi;
+  }
   destroy() {
     logger.info("Destroying Virtualdisplay client");
     this.attributeService.clear();
@@ -7563,6 +7635,7 @@ class VirtualdisplayClient {
 }
 export {
   AttributeSelector,
+  Camera,
   ERROR_CODES,
   EVENT_NAMES,
   MESSAGE_TYPES,