@virtualdisplay.io/client 3.5.0 → 3.5.1

package/CHANGELOG.md

@@ -2,6 +2,12 @@
 
 All notable changes to this project will be documented in this file. See [standard-version](https://github.com/conventional-changelog/standard-version) for commit guidelines.
 
+## [3.5.1](https://github.com/virtualdisplay-io/client/compare/v3.5.0...v3.5.1) (2025-07-18)
+
+### ♻️ Code Refactoring
+
+* remove validation of outgoing message types ([#5](https://github.com/virtualdisplay-io/client/issues/5)) ([5f4f985](https://github.com/virtualdisplay-io/client/commit/5f4f9853d65af676aec3a865864f43461fdb6ca5))
+
 ## [3.5.0](https://github.com/virtualdisplay-io/client/compare/v3.4.1...v3.5.0) (2025-07-16)
 
 ### ✨ Features

package/dist/index.d.ts

@@ -225,6 +225,7 @@ export declare const ERROR_CODES: {
     readonly INVALID_MAPPING: "INVALID_MAPPING";
     readonly PARENT_NOT_FOUND: "PARENT_NOT_FOUND";
     readonly INVALID_MUTATIONS: "INVALID_MUTATIONS";
+    readonly INVALID_PARAMETER: "INVALID_PARAMETER";
 };
 
 export declare type ErrorCode = typeof ERROR_CODES[keyof typeof ERROR_CODES];
@@ -240,6 +241,8 @@ export declare const EVENT_NAMES: {
     readonly MESSAGE_RECEIVED: "message:received";
     readonly STATE_CHANGED: "state:changed";
     readonly INITIAL_STATE_RECEIVED: "state:initial-received";
+    readonly SNAPSHOT_MESSAGE: "snapshot:take";
+    readonly SNAPSHOT_DEVELOPED: "snapshot:developed";
 };
 
 /**
@@ -358,7 +361,7 @@ export declare class MappingValidator {
 /**
  * Union of all possible messages
  */
-export declare type Message = MutationMessage | StateMessage | ConfigMessage | CameraMessage;
+export declare type Message = MutationMessage | StateMessage | ConfigMessage | CameraMessage | SnapshotRequestMessage | SnapshotDevelopedMessage;
 
 /**
  * Types of messages exchanged between client and server
@@ -369,6 +372,7 @@ export declare const MESSAGE_TYPES: {
     readonly STATE: "state";
     readonly CONFIG: "config";
     readonly CAMERA: "camera";
+    readonly SNAPSHOT: "snapshot";
 };
 
 /**
@@ -476,6 +480,80 @@ export declare class NodeSelector {
 
 declare type NodeType = typeof NODE_TYPES[keyof typeof NODE_TYPES];
 
+/**
+ * Represents a photo being captured
+ * Pure domain object that manages callbacks for when the photo is developed
+ */
+export declare class Photo {
+    private readonly filename;
+    private readonly callbacks;
+    private developed;
+    private photoData;
+    constructor(filename: string);
+    /**
+     * Register a callback for when the photo is developed
+     * If the photo is already developed, the callback is called immediately
+     *
+     * @param callback Function to call with photo data
+     * @returns This Photo instance for chaining
+     */
+    onDeveloped(callback: (photo: PhotoData) => void): this;
+    /**
+     * Get the filename for this photo
+     */
+    getFilename(): string;
+    /**
+     * Mark the photo as developed and notify all callbacks
+     * This method is called by the SnapshotMessageHandler when the photo data arrives
+     */
+    develop(photoData: PhotoData): void;
+}
+
+export declare interface PhotoData {
+    readonly filename: string;
+    readonly data: string;
+}
+
+/**
+ * API for taking screenshots of the 3D model
+ * Following the camera analogy: take() triggers capture, onDeveloped() gets result
+ */
+export declare class Snapshot {
+    private readonly eventBus;
+    private readonly validExtensions;
+    private readonly messageHandler;
+    constructor(eventBus: EventBus);
+    /**
+     * Take a snapshot of the current 3D model view
+     *
+     * @param filename The filename for the snapshot (must include valid extension)
+     * @returns Photo object for registering callbacks
+     * @throws VirtualdisplayError if filename is invalid
+     */
+    take(filename: string): Photo;
+    /**
+     * Validate filename has a valid image extension
+     */
+    private validateFilename;
+}
+
+/**
+ * Snapshot developed message received from server
+ */
+export declare interface SnapshotDevelopedMessage {
+    readonly type: typeof MESSAGE_TYPES.SNAPSHOT;
+    readonly filename: string;
+    readonly data: string;
+}
+
+/**
+ * Snapshot request message sent to server
+ */
+export declare interface SnapshotRequestMessage {
+    readonly type: typeof MESSAGE_TYPES.SNAPSHOT;
+    readonly filename: string;
+}
+
 declare interface StateChangedEvent {
     nodes: ModelNode[];
 }
@@ -537,6 +615,7 @@ export declare class VirtualdisplayClient {
     private readonly messageHandler;
     private readonly viewerService;
     private readonly cameraApi;
+    private readonly snapshotApi;
     private readonly options;
     private iframe;
     constructor(options: ClientOptions);
@@ -578,6 +657,10 @@ export declare class VirtualdisplayClient {
      * Get the camera control API
      */
     get camera(): Camera;
+    /**
+     * Get the snapshot API for taking screenshots
+     */
+    get snapshot(): Snapshot;
     destroy(): void;
 }