@virtualdisplay.io/client 3.3.0 → 3.4.1

package/CHANGELOG.md

@@ -2,6 +2,18 @@
 
 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.4.1](https://github.com/virtualdisplay-io/client/compare/v3.4.0...v3.4.1) (2025-07-10)
+
+### 🐛 Bug Fixes
+
+* EventBus once handlers and logging improvements ([#3](https://github.com/virtualdisplay-io/client/issues/3)) ([5a99d8d](https://github.com/virtualdisplay-io/client/commit/5a99d8d6ef82d058799734b54c98ca171d17dd36))
+
+## [3.4.0](https://github.com/virtualdisplay-io/client/compare/v3.3.0...v3.4.0) (2025-07-09)
+
+### ✨ Features
+
+* implement UI configuration via PostMessage CONFIG messages ([#2](https://github.com/virtualdisplay-io/client/issues/2)) ([abc2294](https://github.com/virtualdisplay-io/client/commit/abc229414f9f70c54f37db903c46c0612c5eb6cf))
+
 ## [3.3.0](https://github.com/virtualdisplay-io/client/compare/v3.2.2...v3.3.0) (2025-07-07)
 
 ### ✨ Features

package/dist/index.d.ts

@@ -121,13 +121,6 @@ export declare interface AttributeValueConfig {
     readonly isSelected?: boolean;
 }
 
-/**
- * Base message interface
- */
-declare interface BaseMessage {
-    readonly type: MessageType;
-}
-
 /**
  * Configuration options for VirtualdisplayClient
  */
@@ -137,6 +130,17 @@ export declare interface ClientOptions {
     readonly license: string;
     readonly debug?: boolean;
     readonly language?: string;
+    readonly arEnabled?: boolean;
+    readonly fullscreenEnabled?: boolean;
+    readonly loadingIndicatorEnabled?: boolean;
+}
+
+/**
+ * Configuration message sent to server
+ */
+export declare interface ConfigMessage {
+    readonly type: typeof MESSAGE_TYPES.CONFIG;
+    readonly config: ViewerConfig;
 }
 
 declare interface CreateNodeParams {
@@ -151,9 +155,11 @@ declare interface CreateNodeParams {
  */
 export declare interface DomainEvents extends Record<string, unknown> {
     [EVENT_NAMES.IFRAME_READY]: VoidEvent;
-    [EVENT_NAMES.MUTATION_MESSAGE]: MutationMessageEvent;
-    [EVENT_NAMES.MESSAGE_RECEIVED]: MessageReceivedEvent;
+    [EVENT_NAMES.MUTATION_MESSAGE]: MessageEvent_2<MutationMessage>;
+    [EVENT_NAMES.CONFIG_MESSAGE]: MessageEvent_2<ConfigMessage>;
+    [EVENT_NAMES.MESSAGE_RECEIVED]: MessageEvent_2;
     [EVENT_NAMES.STATE_CHANGED]: StateChangedEvent;
+    [EVENT_NAMES.INITIAL_STATE_RECEIVED]: VoidEvent;
 }
 
 export declare function enableDebugMode(): void;
@@ -178,6 +184,7 @@ export declare type ErrorCode = typeof ERROR_CODES[keyof typeof ERROR_CODES];
 export declare const EVENT_NAMES: {
     readonly IFRAME_READY: "iframe:ready";
     readonly MUTATION_MESSAGE: "mutation:message";
+    readonly CONFIG_MESSAGE: "config:message";
     readonly MESSAGE_RECEIVED: "message:received";
     readonly STATE_CHANGED: "state:changed";
     readonly INITIAL_STATE_RECEIVED: "state:initial-received";
@@ -191,7 +198,14 @@ declare class EventBus {
     private readonly listeners;
     on<K extends keyof DomainEvents>(event: K, listener: EventListener_2<DomainEvents[K]>): void;
     emit<K extends keyof DomainEvents>(event: K, payload: DomainEvents[K]): void;
+    /**
+     * Register a listener that will be called only once
+     * The listener is automatically removed after the first call
+     */
     once<K extends keyof DomainEvents>(event: K, listener: EventListener_2<DomainEvents[K]>): void;
+    /**
+     * Remove a specific listener for an event
+     */
     off<K extends keyof DomainEvents>(event: K, listener: EventListener_2<DomainEvents[K]>): void;
 }
 
@@ -292,7 +306,7 @@ export declare class MappingValidator {
 /**
  * Union of all possible messages
  */
-export declare type Message = MutationMessage | StateMessage;
+export declare type Message = MutationMessage | StateMessage | ConfigMessage;
 
 /**
  * Types of messages exchanged between client and server
@@ -301,17 +315,16 @@ export declare type Message = MutationMessage | StateMessage;
 export declare const MESSAGE_TYPES: {
     readonly MUTATION: "mutation";
     readonly STATE: "state";
+    readonly CONFIG: "config";
 };
 
 /**
- * State Flow Events (Server → Client)
+ * Generic message event - used for all message passing
  */
-declare interface MessageReceivedEvent {
-    message: unknown;
+declare interface MessageEvent_2<T extends Message = Message> {
+    message: T;
 }
 
-declare type MessageType = typeof MESSAGE_TYPES[keyof typeof MESSAGE_TYPES];
-
 /**
  * Represents a 3D node in the scene
  * Live object that can be updated to reflect state changes
@@ -373,18 +386,11 @@ export declare interface MutationDto {
 /**
  * Mutation message sent to server
  */
-export declare interface MutationMessage extends BaseMessage {
+export declare interface MutationMessage {
     readonly type: typeof MESSAGE_TYPES.MUTATION;
     readonly mutations: MutationDto[];
 }
 
-/**
- * Mutation Flow Events (Client → Server)
- */
-declare interface MutationMessageEvent {
-    message: MutationMessage;
-}
-
 export declare type MutationType = typeof MUTATION_TYPES[keyof typeof MUTATION_TYPES];
 
 /**
@@ -425,7 +431,7 @@ declare interface StateChangedEvent {
  * State message received from server
  * Contains array of model node DTOs
  */
-export declare interface StateMessage extends BaseMessage {
+export declare interface StateMessage {
     readonly type: typeof MESSAGE_TYPES.STATE;
     readonly nodes: ModelNodeDto[];
     readonly isInitial: boolean;
@@ -451,6 +457,22 @@ declare class StateService {
     clear(): void;
 }
 
+/**
+ * UI configuration options
+ */
+export declare interface UIConfig {
+    readonly arEnabled?: boolean;
+    readonly fullscreenEnabled?: boolean;
+    readonly loadingIndicatorEnabled?: boolean;
+}
+
+/**
+ * Viewer configuration
+ */
+export declare interface ViewerConfig {
+    readonly ui?: UIConfig;
+}
+
 /**
  * Main Virtualdisplay Client
  * Provides the public API for 3D product visualization
@@ -460,11 +482,13 @@ export declare class VirtualdisplayClient {
     private readonly attributeService;
     private readonly stateService;
     private readonly messageHandler;
+    private readonly viewerService;
     private readonly options;
     private iframe;
     constructor(options: ClientOptions);
     private initializeLogging;
     private createAndConnectIframe;
+    private setupInitialConfig;
     /**
      * Load attribute mapping configuration
      * @throws {VirtualdisplayError} When mapping configuration is invalid
@@ -492,6 +516,10 @@ export declare class VirtualdisplayClient {
      * If already ready, the callback is called immediately
      */
     onReady(callback: () => void): void;
+    /**
+     * Get the viewer service for UI configuration
+     */
+    get viewer(): VirtualdisplayViewerService;
     destroy(): void;
 }
 
@@ -509,6 +537,48 @@ export declare class VirtualdisplayError extends Error {
     static invalidMutations(reason?: string): VirtualdisplayError;
 }
 
+/**
+ * Service responsible for managing viewer UI configuration
+ * Sends CONFIG messages to control AR button, fullscreen button, and loading indicator
+ */
+export declare class VirtualdisplayViewerService {
+    private readonly eventBus;
+    constructor(eventBus: EventBus);
+    /**
+     * Send initial configuration based on client options
+     * Only sends config when values are false (server defaults to true)
+     */
+    sendInitialConfig(options: ClientOptions): void;
+    /**
+     * Update AR button visibility
+     */
+    setArEnabled(enabled: boolean): void;
+    /**
+     * Update fullscreen button visibility
+     */
+    setFullscreenEnabled(enabled: boolean): void;
+    /**
+     * Update loading indicator visibility
+     */
+    setLoadingIndicatorEnabled(enabled: boolean): void;
+    /**
+     * Update multiple UI settings at once
+     */
+    updateUIConfig(config: Partial<UIConfig>): void;
+    /**
+     * Hide all UI elements
+     */
+    hideAllUI(): void;
+    /**
+     * Show all UI elements
+     */
+    showAllUI(): void;
+    /**
+     * Send UI configuration to server
+     */
+    private sendUIConfig;
+}
+
 declare interface VoidEvent {
 }