@mentra/sdk 1.1.19

package/dist/tpa/session/dashboard.js

@@ -0,0 +1,149 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DashboardManager = exports.DashboardContentManager = exports.DashboardSystemManager = void 0;
+/**
+ * Dashboard API Implementation
+ *
+ * Provides dashboard functionality for TPAs, allowing them to write content
+ * to the dashboard and respond to dashboard mode changes.
+ */
+// import { systemApps } from '../../constants';
+const dashboard_1 = require("../../types/dashboard");
+const message_types_1 = require("../../types/message-types");
+const dotenv_1 = __importDefault(require("dotenv"));
+// Load environment variables from .env file
+dotenv_1.default.config();
+const SYSTEM_DASHBOARD_PACKAGE_NAME = process.env.SYSTEM_DASHBOARD_PACKAGE_NAME || 'system.augmentos.dashboard';
+/**
+ * Implementation of DashboardSystemAPI interface for system dashboard TPA
+ */
+class DashboardSystemManager {
+    constructor(session, packageName, send) {
+        this.session = session;
+        this.packageName = packageName;
+        this.send = send;
+    }
+    setTopLeft(content) {
+        this.updateSystemSection('topLeft', content);
+    }
+    setTopRight(content) {
+        this.updateSystemSection('topRight', content);
+    }
+    setBottomLeft(content) {
+        this.updateSystemSection('bottomLeft', content);
+    }
+    setBottomRight(content) {
+        this.updateSystemSection('bottomRight', content);
+    }
+    setViewMode(mode) {
+        const message = {
+            type: message_types_1.TpaToCloudMessageType.DASHBOARD_MODE_CHANGE,
+            packageName: this.packageName,
+            sessionId: `${this.session.getSessionId()}-${this.packageName}`,
+            mode,
+            timestamp: new Date()
+        };
+        this.send(message);
+    }
+    updateSystemSection(section, content) {
+        const message = {
+            type: message_types_1.TpaToCloudMessageType.DASHBOARD_SYSTEM_UPDATE,
+            packageName: this.packageName,
+            sessionId: `${this.session.getSessionId()}-${this.packageName}`,
+            section,
+            content,
+            timestamp: new Date()
+        };
+        this.send(message);
+    }
+}
+exports.DashboardSystemManager = DashboardSystemManager;
+/**
+ * Implementation of DashboardContentAPI interface for all TPAs
+ */
+class DashboardContentManager {
+    // private alwaysOnEnabled: boolean = false;
+    constructor(session, packageName, send, events) {
+        this.session = session;
+        this.packageName = packageName;
+        this.send = send;
+        this.events = events;
+        this.currentMode = 'none';
+    }
+    write(content, targets = [dashboard_1.DashboardMode.MAIN]) {
+        const message = {
+            type: message_types_1.TpaToCloudMessageType.DASHBOARD_CONTENT_UPDATE,
+            packageName: this.packageName,
+            sessionId: `${this.session.getSessionId()}-${this.packageName}`,
+            content,
+            modes: targets,
+            timestamp: new Date()
+        };
+        this.send(message);
+    }
+    writeToMain(content) {
+        this.write(content, [dashboard_1.DashboardMode.MAIN]);
+    }
+    writeToExpanded(content) {
+        const message = {
+            type: message_types_1.TpaToCloudMessageType.DASHBOARD_CONTENT_UPDATE,
+            packageName: this.packageName,
+            sessionId: `${this.session.getSessionId()}-${this.packageName}`,
+            content,
+            modes: [dashboard_1.DashboardMode.EXPANDED],
+            timestamp: new Date()
+        };
+        this.send(message);
+    }
+    // writeToAlwaysOn(content: string): void {
+    //   this.write(content, [DashboardMode.ALWAYS_ON]);
+    // }
+    async getCurrentMode() {
+        return this.currentMode;
+    }
+    // async isAlwaysOnEnabled(): Promise<boolean> {
+    //   return this.alwaysOnEnabled;
+    // }
+    onModeChange(callback) {
+        return this.events.onDashboardModeChange((data) => {
+            this.currentMode = data.mode;
+            callback(data.mode);
+        });
+    }
+    // onAlwaysOnChange(callback: (enabled: boolean) => void): () => void {
+    //   return this.events.onDashboardAlwaysOnChange((data) => {
+    //     this.alwaysOnEnabled = data.enabled;
+    //     callback(data.enabled);
+    //   });
+    // }
+    // Internal methods to update state
+    setCurrentMode(mode) {
+        this.currentMode = mode;
+        this.events.emit('dashboard_mode_change', { mode });
+    }
+}
+exports.DashboardContentManager = DashboardContentManager;
+/**
+ * Dashboard Manager - Main class that manages dashboard functionality
+ * Each TpaSession instance gets its own DashboardManager instance
+ */
+class DashboardManager {
+    constructor(session, send) {
+        const packageName = session.getPackageName();
+        const events = session.events;
+        // Create content API (available to all TPAs)
+        this.content = new DashboardContentManager(session, packageName, send, events);
+        // Add system API if this is the system dashboard TPA
+        if (packageName === SYSTEM_DASHBOARD_PACKAGE_NAME) {
+            session.logger.info({ service: "SDK:DashboardManager" }, 'Initializing system dashboard manager');
+            this.system = new DashboardSystemManager(session, packageName, send);
+        }
+        else {
+            session.logger.info({ service: "SDK:DashboardManager" }, `Not the system dashboard: ${packageName}`);
+        }
+    }
+}
+exports.DashboardManager = DashboardManager;

package/dist/tpa/session/events.d.ts

@@ -0,0 +1,178 @@
+/**
+ * 🎮 Event Manager Module
+ */
+import EventEmitter from 'events';
+import { StreamType, ExtendedStreamType, AppSettings, WebSocketError, ButtonPress, HeadPosition, PhoneNotification, TranscriptionData, TranslationData, GlassesBatteryUpdate, PhoneBatteryUpdate, GlassesConnectionState, LocationUpdate, Vad, NotificationDismissed, AudioChunk, CalendarEvent, VpsCoordinates, CustomMessage, RtmpStreamStatus, PhotoTaken } from '../../types';
+import { DashboardMode } from '../../types/dashboard';
+import { PermissionErrorDetail } from '../../types/messages/cloud-to-tpa';
+/** 🎯 Type-safe event handler function */
+type Handler<T> = (data: T) => void;
+/** 🔄 System events not tied to streams */
+interface SystemEvents {
+    'connected': AppSettings | undefined;
+    'disconnected': string | {
+        message: string;
+        code: number;
+        reason: string;
+        wasClean: boolean;
+        permanent?: boolean;
+    };
+    'error': WebSocketError | Error;
+    'settings_update': AppSettings;
+    'dashboard_mode_change': {
+        mode: DashboardMode | 'none';
+    };
+    'dashboard_always_on_change': {
+        enabled: boolean;
+    };
+    'custom_message': CustomMessage;
+    'permission_error': {
+        message: string;
+        details: PermissionErrorDetail[];
+        timestamp?: Date;
+    };
+    'permission_denied': {
+        stream: string;
+        requiredPermission: string;
+        message: string;
+    };
+}
+/** 📡 All possible event types */
+type EventType = ExtendedStreamType | keyof SystemEvents;
+/** 📦 Map of stream types to their data types */
+export interface StreamDataTypes {
+    [StreamType.BUTTON_PRESS]: ButtonPress;
+    [StreamType.HEAD_POSITION]: HeadPosition;
+    [StreamType.PHONE_NOTIFICATION]: PhoneNotification;
+    [StreamType.TRANSCRIPTION]: TranscriptionData;
+    [StreamType.TRANSLATION]: TranslationData;
+    [StreamType.GLASSES_BATTERY_UPDATE]: GlassesBatteryUpdate;
+    [StreamType.PHONE_BATTERY_UPDATE]: PhoneBatteryUpdate;
+    [StreamType.GLASSES_CONNECTION_STATE]: GlassesConnectionState;
+    [StreamType.LOCATION_UPDATE]: LocationUpdate;
+    [StreamType.CALENDAR_EVENT]: CalendarEvent;
+    [StreamType.VAD]: Vad;
+    [StreamType.NOTIFICATION_DISMISSED]: NotificationDismissed;
+    [StreamType.AUDIO_CHUNK]: AudioChunk;
+    [StreamType.VIDEO]: ArrayBuffer;
+    [StreamType.RTMP_STREAM_STATUS]: RtmpStreamStatus;
+    [StreamType.VPS_COORDINATES]: VpsCoordinates;
+    [StreamType.PHOTO_TAKEN]: PhotoTaken;
+    [StreamType.OPEN_DASHBOARD]: never;
+    [StreamType.START_APP]: never;
+    [StreamType.STOP_APP]: never;
+    [StreamType.ALL]: never;
+    [StreamType.WILDCARD]: never;
+}
+/** 📦 Data type for an event */
+export type EventData<T extends EventType> = T extends keyof StreamDataTypes ? StreamDataTypes[T] : T extends keyof SystemEvents ? SystemEvents[T] : T extends string ? T extends `${StreamType.TRANSCRIPTION}:${string}` ? TranscriptionData : T extends `${StreamType.TRANSLATION}:${string}` ? TranslationData : never : never;
+export declare class EventManager {
+    private subscribe;
+    private unsubscribe;
+    private emitter;
+    private handlers;
+    private lastLanguageTranscriptioCleanupHandler;
+    private lastLanguageTranslationCleanupHandler;
+    constructor(subscribe: (type: ExtendedStreamType) => void, unsubscribe: (type: ExtendedStreamType) => void);
+    onTranscription(handler: Handler<TranscriptionData>): () => void;
+    /**
+     * 🎤 Listen for transcription events in a specific language
+     * @param language - Language code (e.g., "en-US")
+     * @param handler - Function to handle transcription data
+     * @returns Cleanup function to remove the handler
+     * @throws Error if language code is invalid
+     */
+    onTranscriptionForLanguage(language: string, handler: Handler<TranscriptionData>): () => void;
+    /**
+     * 🌐 Listen for translation events for a specific language pair
+     * @param sourceLanguage - Source language code (e.g., "es-ES")
+     * @param targetLanguage - Target language code (e.g., "en-US")
+     * @param handler - Function to handle translation data
+     * @returns Cleanup function to remove the handler
+     * @throws Error if language codes are invalid
+     */
+    ontranslationForLanguage(sourceLanguage: string, targetLanguage: string, handler: Handler<TranslationData>): () => void;
+    onHeadPosition(handler: Handler<HeadPosition>): () => void;
+    onButtonPress(handler: Handler<ButtonPress>): () => void;
+    onPhoneNotifications(handler: Handler<PhoneNotification>): () => void;
+    onGlassesBattery(handler: Handler<GlassesBatteryUpdate>): () => void;
+    onPhoneBattery(handler: Handler<PhoneBatteryUpdate>): () => void;
+    onVoiceActivity(handler: Handler<Vad>): () => void;
+    onLocation(handler: Handler<LocationUpdate>): () => void;
+    onCalendarEvent(handler: Handler<CalendarEvent>): () => void;
+    /**
+     * 🎤 Listen for audio chunk data
+     * @param handler - Function to handle audio chunks
+     * @returns Cleanup function to remove the handler
+     */
+    onAudioChunk(handler: Handler<AudioChunk>): () => void;
+    onConnected(handler: Handler<SystemEvents['connected']>): () => EventEmitter<[never]>;
+    onDisconnected(handler: Handler<SystemEvents['disconnected']>): () => EventEmitter<[never]>;
+    onError(handler: Handler<SystemEvents['error']>): () => EventEmitter<[never]>;
+    onSettingsUpdate(handler: Handler<SystemEvents['settings_update']>): () => EventEmitter<[never]>;
+    /**
+     * 🌐 Listen for dashboard mode changes
+     * @param handler - Function to handle dashboard mode changes
+     * @returns Cleanup function to remove the handler
+     */
+    onDashboardModeChange(handler: Handler<SystemEvents['dashboard_mode_change']>): () => EventEmitter<[never]>;
+    /**
+     * 🌐 Listen for dashboard always-on mode changes
+     * @param handler - Function to handle dashboard always-on mode changes
+     * @returns Cleanup function to remove the handler
+     */
+    onDashboardAlwaysOnChange(handler: Handler<SystemEvents['dashboard_always_on_change']>): () => EventEmitter<[never]>;
+    /**
+     * 🚫 Listen for permission errors when subscriptions are rejected
+     * @param handler - Function to handle permission errors
+     * @returns Cleanup function to remove the handler
+     */
+    onPermissionError(handler: Handler<SystemEvents['permission_error']>): () => EventEmitter<[never]>;
+    /**
+     * 🚫 Listen for individual permission denied events for specific streams
+     * @param handler - Function to handle permission denied events
+     * @returns Cleanup function to remove the handler
+     */
+    onPermissionDenied(handler: Handler<SystemEvents['permission_denied']>): () => EventEmitter<[never]>;
+    /**
+     * 🔄 Listen for changes to a specific setting
+     * @param key - Setting key to monitor
+     * @param handler - Function to handle setting value changes
+     * @returns Cleanup function to remove the handler
+     */
+    onSettingChange<T>(key: string, handler: (value: T, previousValue: T | undefined) => void): () => void;
+    /**
+     * 🔄 Generic event handler
+     *
+     * Use this for stream types without specific handler methods
+     */
+    on<T extends ExtendedStreamType>(type: T, handler: Handler<EventData<T>>): () => void;
+    /**
+     * ➕ Add an event handler and subscribe if needed
+     */
+    private addHandler;
+    /**
+     * ➖ Remove an event handler
+     */
+    private removeHandler;
+    /**
+     * 📡 Emit an event to all registered handlers with error isolation
+     */
+    emit<T extends EventType>(event: T, data: EventData<T>): void;
+    /**
+     * 📨 Listen for custom messages with a specific action
+     * @param action - The action identifier to filter by
+     * @param handler - Function to handle the message
+     * @returns Cleanup function to remove the handler
+     */
+    onCustomMessage(action: string, handler: (payload: any) => void): () => void;
+    onVpsCoordinates(handler: Handler<VpsCoordinates>): () => void;
+    /**
+     * 📸 Listen for photo responses
+     * @param handler - Function to handle photo response data
+     * @returns Cleanup function to remove the handler
+     */
+    onPhotoTaken(handler: Handler<PhotoTaken>): () => void;
+}
+export {};
+//# sourceMappingURL=events.d.ts.map

package/dist/tpa/session/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../../src/tpa/session/events.ts"],"names":[],"mappings":"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"}

package/dist/tpa/session/events.js

@@ -0,0 +1,294 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EventManager = void 0;
+/**
+ * 🎮 Event Manager Module
+ */
+const events_1 = __importDefault(require("events"));
+const types_1 = require("../../types");
+class EventManager {
+    constructor(subscribe, unsubscribe) {
+        this.subscribe = subscribe;
+        this.unsubscribe = unsubscribe;
+        this.emitter = new events_1.default();
+        this.handlers = new Map();
+        this.lastLanguageTranscriptioCleanupHandler = () => { };
+        this.lastLanguageTranslationCleanupHandler = () => { };
+    }
+    // Convenience handlers for common event types
+    onTranscription(handler) {
+        // Default to en-US when using the generic transcription handler
+        return this.addHandler((0, types_1.createTranscriptionStream)('en-US'), handler);
+    }
+    /**
+     * 🎤 Listen for transcription events in a specific language
+     * @param language - Language code (e.g., "en-US")
+     * @param handler - Function to handle transcription data
+     * @returns Cleanup function to remove the handler
+     * @throws Error if language code is invalid
+     */
+    onTranscriptionForLanguage(language, handler) {
+        if (!(0, types_1.isValidLanguageCode)(language)) {
+            throw new Error(`Invalid language code: ${language}`);
+        }
+        this.lastLanguageTranscriptioCleanupHandler();
+        // console.log(`((())) onTranscriptionForLanguage: ${language}`);
+        const streamType = (0, types_1.createTranscriptionStream)(language);
+        // console.log(`((())) streamType: ${streamType}`);
+        // console.log(`^^^^^^^ handler: ${handler.toString()}`);
+        this.lastLanguageTranscriptioCleanupHandler = this.addHandler(streamType, handler);
+        return this.lastLanguageTranscriptioCleanupHandler;
+    }
+    /**
+     * 🌐 Listen for translation events for a specific language pair
+     * @param sourceLanguage - Source language code (e.g., "es-ES")
+     * @param targetLanguage - Target language code (e.g., "en-US")
+     * @param handler - Function to handle translation data
+     * @returns Cleanup function to remove the handler
+     * @throws Error if language codes are invalid
+     */
+    ontranslationForLanguage(sourceLanguage, targetLanguage, handler) {
+        if (!(0, types_1.isValidLanguageCode)(sourceLanguage)) {
+            throw new Error(`Invalid source language code: ${sourceLanguage}`);
+        }
+        if (!(0, types_1.isValidLanguageCode)(targetLanguage)) {
+            throw new Error(`Invalid target language code: ${targetLanguage}`);
+        }
+        this.lastLanguageTranslationCleanupHandler();
+        const streamType = (0, types_1.createTranslationStream)(sourceLanguage, targetLanguage);
+        this.lastLanguageTranslationCleanupHandler = this.addHandler(streamType, handler);
+        return this.lastLanguageTranslationCleanupHandler;
+    }
+    onHeadPosition(handler) {
+        return this.addHandler(types_1.StreamType.HEAD_POSITION, handler);
+    }
+    onButtonPress(handler) {
+        return this.addHandler(types_1.StreamType.BUTTON_PRESS, handler);
+    }
+    onPhoneNotifications(handler) {
+        return this.addHandler(types_1.StreamType.PHONE_NOTIFICATION, handler);
+    }
+    onGlassesBattery(handler) {
+        return this.addHandler(types_1.StreamType.GLASSES_BATTERY_UPDATE, handler);
+    }
+    onPhoneBattery(handler) {
+        return this.addHandler(types_1.StreamType.PHONE_BATTERY_UPDATE, handler);
+    }
+    onVoiceActivity(handler) {
+        return this.addHandler(types_1.StreamType.VAD, handler);
+    }
+    onLocation(handler) {
+        return this.addHandler(types_1.StreamType.LOCATION_UPDATE, handler);
+    }
+    onCalendarEvent(handler) {
+        return this.addHandler(types_1.StreamType.CALENDAR_EVENT, handler);
+    }
+    /**
+     * 🎤 Listen for audio chunk data
+     * @param handler - Function to handle audio chunks
+     * @returns Cleanup function to remove the handler
+     */
+    onAudioChunk(handler) {
+        return this.addHandler(types_1.StreamType.AUDIO_CHUNK, handler);
+    }
+    // System event handlers
+    onConnected(handler) {
+        this.emitter.on('connected', handler);
+        return () => this.emitter.off('connected', handler);
+    }
+    onDisconnected(handler) {
+        this.emitter.on('disconnected', handler);
+        return () => this.emitter.off('disconnected', handler);
+    }
+    onError(handler) {
+        this.emitter.on('error', handler);
+        return () => this.emitter.off('error', handler);
+    }
+    onSettingsUpdate(handler) {
+        this.emitter.on('settings_update', handler);
+        return () => this.emitter.off('settings_update', handler);
+    }
+    /**
+     * 🌐 Listen for dashboard mode changes
+     * @param handler - Function to handle dashboard mode changes
+     * @returns Cleanup function to remove the handler
+     */
+    onDashboardModeChange(handler) {
+        this.emitter.on('dashboard_mode_change', handler);
+        return () => this.emitter.off('dashboard_mode_change', handler);
+    }
+    /**
+     * 🌐 Listen for dashboard always-on mode changes
+     * @param handler - Function to handle dashboard always-on mode changes
+     * @returns Cleanup function to remove the handler
+     */
+    onDashboardAlwaysOnChange(handler) {
+        this.emitter.on('dashboard_always_on_change', handler);
+        return () => this.emitter.off('dashboard_always_on_change', handler);
+    }
+    /**
+     * 🚫 Listen for permission errors when subscriptions are rejected
+     * @param handler - Function to handle permission errors
+     * @returns Cleanup function to remove the handler
+     */
+    onPermissionError(handler) {
+        this.emitter.on('permission_error', handler);
+        return () => this.emitter.off('permission_error', handler);
+    }
+    /**
+     * 🚫 Listen for individual permission denied events for specific streams
+     * @param handler - Function to handle permission denied events
+     * @returns Cleanup function to remove the handler
+     */
+    onPermissionDenied(handler) {
+        this.emitter.on('permission_denied', handler);
+        return () => this.emitter.off('permission_denied', handler);
+    }
+    /**
+     * 🔄 Listen for changes to a specific setting
+     * @param key - Setting key to monitor
+     * @param handler - Function to handle setting value changes
+     * @returns Cleanup function to remove the handler
+     */
+    onSettingChange(key, handler) {
+        let previousValue = undefined;
+        const settingsHandler = (settings) => {
+            try {
+                const setting = settings.find(s => s.key === key);
+                if (setting) {
+                    // Only call handler if value has changed
+                    if (setting.value !== previousValue) {
+                        const newValue = setting.value;
+                        handler(newValue, previousValue);
+                        previousValue = newValue;
+                    }
+                }
+            }
+            catch (error) {
+                console.error(`Error in onSettingChange handler for key "${key}":`, error);
+            }
+        };
+        this.emitter.on('settings_update', settingsHandler);
+        this.emitter.on('connected', settingsHandler); // Also check when first connected
+        return () => {
+            this.emitter.off('settings_update', settingsHandler);
+            this.emitter.off('connected', settingsHandler);
+        };
+    }
+    /**
+     * 🔄 Generic event handler
+     *
+     * Use this for stream types without specific handler methods
+     */
+    on(type, handler) {
+        return this.addHandler(type, handler);
+    }
+    /**
+     * ➕ Add an event handler and subscribe if needed
+     */
+    addHandler(type, handler) {
+        const handlers = this.handlers.get(type) ?? new Set();
+        if (handlers.size === 0) {
+            this.handlers.set(type, handlers);
+            this.subscribe(type);
+        }
+        handlers.add(handler);
+        return () => this.removeHandler(type, handler);
+    }
+    /**
+     * ➖ Remove an event handler
+     */
+    removeHandler(type, handler) {
+        const handlers = this.handlers.get(type);
+        if (!handlers)
+            return;
+        handlers.delete(handler);
+        if (handlers.size === 0) {
+            this.handlers.delete(type);
+            this.unsubscribe(type);
+        }
+    }
+    /**
+     * 📡 Emit an event to all registered handlers with error isolation
+     */
+    emit(event, data) {
+        try {
+            // Emit to EventEmitter handlers (system events)
+            // console.log(`#### Emitting to ${event}`);
+            this.emitter.emit(event, data);
+            // Emit to stream handlers if applicable
+            const handlers = this.handlers.get(event);
+            // console.log(`#### Handlers: ${JSON.stringify(handlers)}`);
+            if (handlers) {
+                // Create array of handlers to prevent modification during iteration
+                const handlersArray = Array.from(handlers);
+                // console.log(`((())) HandlersArray: ${JSON.stringify(handlersArray)}`);
+                // Execute each handler in isolated try/catch to prevent one handler
+                // from crashing the entire TPA
+                handlersArray.forEach(handler => {
+                    try {
+                        handler(data);
+                    }
+                    catch (handlerError) {
+                        // Log the error but don't let it propagate
+                        console.error(`Error in handler for event '${String(event)}':`, handlerError);
+                        // Emit an error event for tracking purposes
+                        if (event !== 'error') { // Prevent infinite recursion
+                            const errorMessage = handlerError instanceof Error
+                                ? handlerError.message
+                                : String(handlerError);
+                            this.emitter.emit('error', new Error(`Handler error for event '${String(event)}': ${errorMessage}`));
+                        }
+                    }
+                });
+            }
+        }
+        catch (emitError) {
+            // Catch any errors in the emission process itself
+            console.error(`Fatal error emitting event '${String(event)}':`, emitError);
+            // Try to emit an error event if we're not already handling an error
+            if (event !== 'error') {
+                try {
+                    const errorMessage = emitError instanceof Error
+                        ? emitError.message
+                        : String(emitError);
+                    this.emitter.emit('error', new Error(`Event emission error for '${String(event)}': ${errorMessage}`));
+                }
+                catch (nestedError) {
+                    // If even this fails, just log it - nothing more we can do
+                    console.error('Failed to emit error event:', nestedError);
+                }
+            }
+        }
+    }
+    /**
+     * 📨 Listen for custom messages with a specific action
+     * @param action - The action identifier to filter by
+     * @param handler - Function to handle the message
+     * @returns Cleanup function to remove the handler
+     */
+    onCustomMessage(action, handler) {
+        const messageHandler = (message) => {
+            if (message.action === action) {
+                handler(message.payload);
+            }
+        };
+        this.emitter.on('custom_message', messageHandler);
+        return () => this.emitter.off('custom_message', messageHandler);
+    }
+    onVpsCoordinates(handler) {
+        return this.addHandler(types_1.StreamType.VPS_COORDINATES, handler);
+    }
+    /**
+     * 📸 Listen for photo responses
+     * @param handler - Function to handle photo response data
+     * @returns Cleanup function to remove the handler
+     */
+    onPhotoTaken(handler) {
+        return this.addHandler(types_1.StreamType.PHOTO_TAKEN, handler);
+    }
+}
+exports.EventManager = EventManager;