@virtualdisplay.io/client 3.4.1 → 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",
@@ -6928,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)) {
@@ -7052,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) {
@@ -7168,7 +7226,8 @@ class MessageHandler {
   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) => {
@@ -7452,6 +7511,7 @@ class VirtualdisplayClient {
   stateService;
   messageHandler;
   viewerService;
+  cameraApi;
   options;
   iframe;
   constructor(options) {
@@ -7461,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();
@@ -7554,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();
@@ -7568,6 +7635,7 @@ class VirtualdisplayClient {
 }
 export {
   AttributeSelector,
+  Camera,
   ERROR_CODES,
   EVENT_NAMES,
   MESSAGE_TYPES,