@mentra/sdk 2.0.4 → 2.1.1

package/dist/app/server/index.d.ts

@@ -1,7 +1,7 @@
 /**
  * 🚀 App Server Module
  *
- * Creates and manages a server for Third Party Apps (Apps) in the MentraOS ecosystem.
+ * Creates and manages a server for Apps in the MentraOS ecosystem.
  * Handles webhook endpoints, session management, and cleanup.
  */
 import { type Express } from 'express';
@@ -189,6 +189,15 @@ export declare class AppServer {
      * Closes all active sessions and runs cleanup handlers.
      */
     private cleanup;
+    /**
+     * 🎯 Setup Photo Upload Endpoint
+     * Creates a /photo-upload endpoint for receiving photos directly from ASG glasses
+     */
+    private setupPhotoUploadEndpoint;
+    /**
+     * Find session that has a pending photo request for the given requestId
+     */
+    private findSessionByPhotoRequestId;
 }
 /**
  * @deprecated Use `AppServerConfig` instead. `TpaServerConfig` is deprecated and will be removed in a future version.

package/dist/app/server/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/app/server/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAgB,EAAE,KAAK,OAAO,EAAE,MAAM,SAAS,CAAC;AAEhD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C,OAAO,EAQL,QAAQ,EACT,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAI9B;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,eAAe;IAC9B,oIAAoI;IACpI,WAAW,EAAE,MAAM,CAAC;IACpB,wDAAwD;IACxD,MAAM,EAAE,MAAM,CAAC;IACf,oDAAoD;IACpD,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,+FAA+F;IAC/F,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;IAE3B,iEAAiE;IACjE,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,gDAAgD;IAChD,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,qBAAa,SAAS;IAYR,OAAO,CAAC,MAAM;IAX1B,2BAA2B;IAC3B,OAAO,CAAC,GAAG,CAAU;IACrB,+CAA+C;IAC/C,OAAO,CAAC,cAAc,CAAiC;IACvD,mDAAmD;IACnD,OAAO,CAAC,eAAe,CAAyB;IAChD,gDAAgD;IAChD,OAAO,CAAC,eAAe,CAAuB;IAE9C,SAAgB,MAAM,EAAE,MAAM,CAAC;gBAEX,MAAM,EAAE,eAAe;IAuCpC,aAAa,IAAI,OAAO;IAI/B;;;;;;;;OAQG;cACa,SAAS,CAAC,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAMhG;;;;;;;;OAQG;cACa,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAWxF;;;;;;;OAOG;cACa,UAAU,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAM3E;;;;;OAKG;IACI,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAY7B;;;OAGG;IACI,IAAI,IAAI,IAAI;IAMnB;;;;;;;;KAQC;IACD,SAAS,CAAC,aAAa,CACrB,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,GAChB,MAAM;IAYT;;;;;OAKG;IACH,SAAS,CAAC,iBAAiB,CAAC,OAAO,EAAE,MAAM,IAAI,GAAG,IAAI;IAItD;;;OAGG;IACH,OAAO,CAAC,YAAY;IAoCpB;;;OAGG;IACH,OAAO,CAAC,qBAAqB;IA2B7B;;OAEG;YACW,oBAAoB;IA6DlC;;OAEG;YACW,iBAAiB;IAgB/B;;;OAGG;IACH,OAAO,CAAC,gBAAgB;IAYxB;;;OAGG;IACH,OAAO,CAAC,qBAAqB;IAyD7B;;;OAGG;IACH,OAAO,CAAC,cAAc;IAQtB;;;OAGG;IACH,OAAO,CAAC,aAAa;IAKrB;;;OAGG;IACH,OAAO,CAAC,OAAO;CAWhB;AAGD;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,eAAe,GAAG,eAAe,CAAC;AAE9C;;;;;;;;;;;;GAYG;AACH,qBAAa,SAAU,SAAQ,SAAS;gBAC1B,MAAM,EAAE,eAAe;CASpC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/app/server/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAgB,EAAE,KAAK,OAAO,EAAE,MAAM,SAAS,CAAC;AAEhD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C,OAAO,EAQL,QAAQ,EACT,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAI9B;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,eAAe;IAC9B,oIAAoI;IACpI,WAAW,EAAE,MAAM,CAAC;IACpB,wDAAwD;IACxD,MAAM,EAAE,MAAM,CAAC;IACf,oDAAoD;IACpD,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,+FAA+F;IAC/F,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;IAE3B,iEAAiE;IACjE,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,gDAAgD;IAChD,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,qBAAa,SAAS;IAYR,OAAO,CAAC,MAAM;IAX1B,2BAA2B;IAC3B,OAAO,CAAC,GAAG,CAAU;IACrB,+CAA+C;IAC/C,OAAO,CAAC,cAAc,CAAiC;IACvD,mDAAmD;IACnD,OAAO,CAAC,eAAe,CAAyB;IAChD,gDAAgD;IAChD,OAAO,CAAC,eAAe,CAAuB;IAE9C,SAAgB,MAAM,EAAE,MAAM,CAAC;gBAEX,MAAM,EAAE,eAAe;IAwCpC,aAAa,IAAI,OAAO;IAI/B;;;;;;;;OAQG;cACa,SAAS,CAAC,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAMhG;;;;;;;;OAQG;cACa,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAWxF;;;;;;;OAOG;cACa,UAAU,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAM3E;;;;;OAKG;IACI,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAY7B;;;OAGG;IACI,IAAI,IAAI,IAAI;IAMnB;;;;;;;;KAQC;IACD,SAAS,CAAC,aAAa,CACrB,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,GAChB,MAAM;IAYT;;;;;OAKG;IACH,SAAS,CAAC,iBAAiB,CAAC,OAAO,EAAE,MAAM,IAAI,GAAG,IAAI;IAItD;;;OAGG;IACH,OAAO,CAAC,YAAY;IAoCpB;;;OAGG;IACH,OAAO,CAAC,qBAAqB;IA2B7B;;OAEG;YACW,oBAAoB;IA6DlC;;OAEG;YACW,iBAAiB;IAgB/B;;;OAGG;IACH,OAAO,CAAC,gBAAgB;IAYxB;;;OAGG;IACH,OAAO,CAAC,qBAAqB;IAyD7B;;;OAGG;IACH,OAAO,CAAC,cAAc;IAQtB;;;OAGG;IACH,OAAO,CAAC,aAAa;IAKrB;;;OAGG;IACH,OAAO,CAAC,OAAO;IAYf;;;OAGG;IACH,OAAO,CAAC,wBAAwB;IAkFhC;;OAEG;IACH,OAAO,CAAC,2BAA2B;CAQpC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,eAAe,GAAG,eAAe,CAAC;AAE9C;;;;;;;;;;;;GAYG;AACH,qBAAa,SAAU,SAAQ,SAAS;gBAC1B,MAAM,EAAE,eAAe;CASpC"}

package/dist/app/server/index.js

@@ -7,7 +7,7 @@ exports.TpaServer = exports.AppServer = void 0;
 /**
  * 🚀 App Server Module
  *
- * Creates and manages a server for Third Party Apps (Apps) in the MentraOS ecosystem.
+ * Creates and manages a server for Apps in the MentraOS ecosystem.
  * Handles webhook endpoints, session management, and cleanup.
  */
 const express_1 = __importDefault(require("express"));
@@ -81,6 +81,7 @@ class AppServer {
         this.setupSettingsEndpoint();
         this.setupHealthCheck();
         this.setupToolCallEndpoint();
+        this.setupPhotoUploadEndpoint();
         this.setupPublicDir();
         this.setupShutdown();
     }
@@ -432,6 +433,94 @@ class AppServer {
         // Run cleanup handlers
         this.cleanupHandlers.forEach(handler => handler());
     }
+    /**
+     * 🎯 Setup Photo Upload Endpoint
+     * Creates a /photo-upload endpoint for receiving photos directly from ASG glasses
+     */
+    setupPhotoUploadEndpoint() {
+        const multer = require('multer');
+        // Configure multer for handling multipart form data
+        const upload = multer({
+            storage: multer.memoryStorage(),
+            limits: {
+                fileSize: 10 * 1024 * 1024, // 10MB limit
+            },
+            fileFilter: (req, file, cb) => {
+                // Accept image files only
+                if (file.mimetype && file.mimetype.startsWith('image/')) {
+                    cb(null, true);
+                }
+                else {
+                    cb(new Error('Only image files are allowed'), false);
+                }
+            }
+        });
+        this.app.post('/photo-upload', upload.single('photo'), async (req, res) => {
+            try {
+                const { requestId, type } = req.body;
+                const photoFile = req.file;
+                this.logger.info({ requestId, type }, `📸 Received photo upload: ${requestId}`);
+                if (!photoFile) {
+                    this.logger.error({ requestId }, 'No photo file in upload');
+                    return res.status(400).json({
+                        success: false,
+                        error: 'No photo file provided'
+                    });
+                }
+                if (!requestId) {
+                    this.logger.error('No requestId in photo upload');
+                    return res.status(400).json({
+                        success: false,
+                        error: 'No requestId provided'
+                    });
+                }
+                // Find the corresponding session that made this photo request
+                const session = this.findSessionByPhotoRequestId(requestId);
+                if (!session) {
+                    this.logger.warn({ requestId }, 'No active session found for photo request');
+                    return res.status(404).json({
+                        success: false,
+                        error: 'No active session found for this photo request'
+                    });
+                }
+                // Create photo data object
+                const photoData = {
+                    buffer: photoFile.buffer,
+                    mimeType: photoFile.mimetype,
+                    filename: photoFile.originalname || 'photo.jpg',
+                    requestId,
+                    size: photoFile.size,
+                    timestamp: new Date()
+                };
+                // Deliver photo to the session
+                session.camera.handlePhotoReceived(photoData);
+                // Respond to ASG client
+                res.json({
+                    success: true,
+                    requestId,
+                    message: 'Photo received successfully'
+                });
+            }
+            catch (error) {
+                this.logger.error(error, '❌ Error handling photo upload');
+                res.status(500).json({
+                    success: false,
+                    error: 'Internal server error processing photo upload'
+                });
+            }
+        });
+    }
+    /**
+     * Find session that has a pending photo request for the given requestId
+     */
+    findSessionByPhotoRequestId(requestId) {
+        for (const [sessionId, session] of this.activeSessions) {
+            if (session.camera.hasPhotoPendingRequest(requestId)) {
+                return session;
+            }
+        }
+        return undefined;
+    }
 }
 exports.AppServer = AppServer;
 /**

package/dist/app/session/index.d.ts

@@ -1,7 +1,7 @@
 import { EventManager, EventData } from './events';
 import { LayoutManager } from './layouts';
 import { SettingsManager } from './settings';
-import { StreamingModule } from './modules/streaming';
+import { CameraModule } from './modules/camera';
 import { ExtendedStreamType, ButtonPress, HeadPosition, PhoneNotification, TranscriptionData, TranslationData, AppSettings, AppSetting, AppConfig, VpsCoordinates, PhotoTaken, Capabilities } from '../../types';
 import { DashboardAPI } from '../../types/dashboard';
 import { Logger } from 'pino';
@@ -83,8 +83,6 @@ export declare class AppSession {
     private subscriptionSettingsHandler?;
     /** Settings that should trigger subscription updates when changed */
     private subscriptionUpdateTriggers;
-    /** Pending photo requests waiting for responses */
-    private pendingPhotoRequests;
     /** Pending user discovery requests waiting for responses */
     private pendingUserDiscoveryRequests;
     /** Pending direct message requests waiting for responses */
@@ -97,8 +95,8 @@ export declare class AppSession {
     readonly settings: SettingsManager;
     /** 📊 Dashboard management interface */
     readonly dashboard: DashboardAPI;
-    /** 📹 RTMP streaming interface */
-    readonly streaming: StreamingModule;
+    /** 📷 Camera interface for photos and streaming */
+    readonly camera: CameraModule;
     readonly appServer: AppServer;
     readonly logger: Logger;
     readonly userId: string;
@@ -201,14 +199,6 @@ export declare class AppSession {
      * 👋 Disconnect from MentraOS Cloud
      */
     disconnect(): void;
-    /**
-     * 📸 Request a photo from the connected glasses
-     * @param options - Optional configuration for the photo request
-     * @returns Promise that resolves with the URL to the captured photo
-     */
-    requestPhoto(options?: {
-        saveToGallery?: boolean;
-    }): Promise<string>;
     /**
      * 🛠️ Get all current user settings
      * @returns A copy of the current settings array
@@ -425,4 +415,5 @@ export type TpaSessionConfig = AppSessionConfig;
 export declare class TpaSession extends AppSession {
     constructor(config: TpaSessionConfig);
 }
+export { CameraModule, PhotoRequestOptions, RtmpStreamOptions } from './modules/camera';
 //# sourceMappingURL=index.d.ts.map

package/dist/app/session/index.d.ts.map

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

package/dist/app/session/index.js

@@ -3,7 +3,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.TpaSession = exports.AppSession = void 0;
+exports.CameraModule = exports.TpaSession = exports.AppSession = void 0;
 /**
  * 🎯 App Session Module
  *
@@ -14,7 +14,7 @@ const ws_1 = require("ws");
 const events_1 = require("./events");
 const layouts_1 = require("./layouts");
 const settings_1 = require("./settings");
-const streaming_1 = require("./modules/streaming");
+const camera_1 = require("./modules/camera");
 const resource_tracker_1 = require("../../utils/resource-tracker");
 const types_1 = require("../../types");
 const axios_1 = __importDefault(require("axios"));
@@ -76,8 +76,6 @@ class AppSession {
         this.shouldUpdateSubscriptionsOnSettingsChange = false;
         /** Settings that should trigger subscription updates when changed */
         this.subscriptionUpdateTriggers = [];
-        /** Pending photo requests waiting for responses */
-        this.pendingPhotoRequests = new Map();
         /** Pending user discovery requests waiting for responses */
         this.pendingUserDiscoveryRequests = new Map();
         /** Pending direct message requests waiting for responses */
@@ -155,9 +153,9 @@ class AppSession {
         // Import DashboardManager dynamically to avoid circular dependency
         const { DashboardManager } = require('./dashboard');
         this.dashboard = new DashboardManager(this, this.send.bind(this));
-        // Initialize streaming module with session reference
-        this.streaming = new streaming_1.StreamingModule(this.config.packageName, this.sessionId || 'unknown-session-id', this.send.bind(this), this // Pass session reference
-        );
+        // Initialize camera module with session reference
+        this.camera = new camera_1.CameraModule(this.config.packageName, this.sessionId || 'unknown-session-id', this.send.bind(this), this, // Pass session reference
+        this.logger.child({ module: 'camera' }));
     }
     /**
      * Get the current session ID
@@ -304,9 +302,9 @@ class AppSession {
         // Configure settings API client with the WebSocket URL and session ID
         // This allows settings to be fetched from the correct server
         this.settings.configureApiClient(this.config.packageName, this.config.mentraOSWebsocketUrl || '', sessionId);
-        // Update the sessionId in the streaming module
-        if (this.streaming) {
-            Object.defineProperty(this.streaming, 'sessionId', { value: sessionId });
+        // Update the sessionId in the camera module
+        if (this.camera) {
+            this.camera.updateSessionId(sessionId);
         }
         return new Promise((resolve, reject) => {
             try {
@@ -521,6 +519,10 @@ class AppSession {
      * 👋 Disconnect from MentraOS Cloud
      */
     disconnect() {
+        // Clean up camera module first
+        if (this.camera) {
+            this.camera.cancelAllRequests();
+        }
         // Use the resource tracker to clean up everything
         this.resources.dispose();
         // Clean up additional resources not handled by the tracker
@@ -529,43 +531,6 @@ class AppSession {
         this.subscriptions.clear();
         this.reconnectAttempts = 0;
     }
-    /**
-     * 📸 Request a photo from the connected glasses
-     * @param options - Optional configuration for the photo request
-     * @returns Promise that resolves with the URL to the captured photo
-     */
-    requestPhoto(options) {
-        return new Promise((resolve, reject) => {
-            try {
-                // Generate unique request ID
-                const requestId = `photo_req_${Date.now()}_${Math.random().toString(36).substring(2, 9)}`;
-                // Store promise resolvers for when we get the response
-                this.pendingPhotoRequests.set(requestId, { resolve, reject });
-                // Create photo request message
-                const message = {
-                    type: types_1.AppToCloudMessageType.PHOTO_REQUEST,
-                    packageName: this.config.packageName,
-                    sessionId: this.sessionId,
-                    timestamp: new Date(),
-                    saveToGallery: options?.saveToGallery || false
-                };
-                // Send request to cloud
-                this.send(message);
-                // Set timeout to avoid hanging promises
-                const timeoutMs = 30000; // 30 seconds
-                this.resources.setTimeout(() => {
-                    if (this.pendingPhotoRequests.has(requestId)) {
-                        this.pendingPhotoRequests.get(requestId).reject(new Error('Photo request timed out'));
-                        this.pendingPhotoRequests.delete(requestId);
-                    }
-                }, timeoutMs);
-            }
-            catch (error) {
-                const errorMessage = error instanceof Error ? error.message : String(error);
-                reject(new Error(`Failed to request photo: ${errorMessage}`));
-            }
-        });
-    }
     /**
      * 🛠️ Get all current user settings
      * @returns A copy of the current settings array
@@ -814,21 +779,13 @@ class AppSession {
                         this.events.emit(messageStreamType, sanitizedData);
                     }
                 }
-                else if ((0, cloud_to_app_1.isPhotoResponse)(message)) {
-                    // Handle photo response by resolving the pending promise
-                    if (this.pendingPhotoRequests.has(message.requestId)) {
-                        const { resolve } = this.pendingPhotoRequests.get(message.requestId);
-                        resolve(message.photoUrl);
-                        this.pendingPhotoRequests.delete(message.requestId);
-                    }
-                }
                 else if ((0, cloud_to_app_1.isRtmpStreamStatus)(message)) {
                     // Emit as a standard stream event if subscribed
                     if (this.subscriptions.has(types_1.StreamType.RTMP_STREAM_STATUS)) {
                         this.events.emit(types_1.StreamType.RTMP_STREAM_STATUS, message);
                     }
-                    // Update streaming module's internal state
-                    this.streaming.updateStreamState(message);
+                    // Update camera module's internal stream state
+                    this.camera.updateStreamState(message);
                 }
                 else if ((0, types_1.isSettingsUpdate)(message)) {
                     // Store previous settings to check for changes
@@ -960,6 +917,11 @@ class AppSession {
                         });
                     });
                 }
+                else if ((0, cloud_to_app_1.isPhotoResponse)(message)) {
+                    // Legacy photo response handling - now photos come directly via webhook
+                    // This branch can be removed in the future as all photos now go through /photo-upload
+                    this.logger.warn('Received legacy photo response - photos should now come via /photo-upload webhook');
+                }
                 // Handle unrecognized message types gracefully
                 else {
                     console.log(`Unrecognized message type: ${message.type}. Full message details:`, {
@@ -1488,3 +1450,6 @@ class TpaSession extends AppSession {
     }
 }
 exports.TpaSession = TpaSession;
+// Export camera module types for developers
+var camera_2 = require("./modules/camera");
+Object.defineProperty(exports, "CameraModule", { enumerable: true, get: function () { return camera_2.CameraModule; } });

package/dist/app/session/modules/camera.d.ts

@@ -0,0 +1,230 @@
+/**
+ * 📷 Camera Module
+ *
+ * Unified camera functionality for App Sessions.
+ * Handles both photo requests and RTMP streaming from connected glasses.
+ */
+import { PhotoData, RtmpStreamStatus } from '../../../types';
+import { VideoConfig, AudioConfig, StreamConfig, StreamStatusHandler } from '../../../types/rtmp-stream';
+import { Logger } from 'pino';
+/**
+ * Options for photo requests
+ */
+export interface PhotoRequestOptions {
+    /** Whether to save the photo to the device gallery */
+    saveToGallery?: boolean;
+}
+/**
+ * Configuration options for an RTMP stream
+ */
+export interface RtmpStreamOptions {
+    /** The RTMP URL to stream to (e.g., rtmp://server.example.com/live/stream-key) */
+    rtmpUrl: string;
+    /** Optional video configuration settings */
+    video?: VideoConfig;
+    /** Optional audio configuration settings */
+    audio?: AudioConfig;
+    /** Optional stream configuration settings */
+    stream?: StreamConfig;
+}
+/**
+ * 📷 Camera Module Implementation
+ *
+ * Unified camera management for App Sessions.
+ * Provides methods for:
+ * - 📸 Requesting photos from glasses
+ * - 📹 Starting/stopping RTMP streams
+ * - 🔍 Monitoring photo and stream status
+ * - 🧹 Cleanup and cancellation
+ *
+ * @example
+ * ```typescript
+ * // Request a photo
+ * const photoData = await session.camera.requestPhoto({ saveToGallery: true });
+ *
+ * // Start streaming
+ * await session.camera.startStream({ rtmpUrl: 'rtmp://example.com/live/key' });
+ *
+ * // Monitor stream status
+ * session.camera.onStreamStatus((status) => {
+ *   console.log('Stream status:', status.status);
+ * });
+ *
+ * // Stop streaming
+ * await session.camera.stopStream();
+ * ```
+ */
+export declare class CameraModule {
+    private send;
+    private packageName;
+    private sessionId;
+    private session?;
+    private logger;
+    /** Map to store pending photo request promises */
+    private pendingPhotoRequests;
+    private isStreaming;
+    private currentStreamUrl?;
+    private currentStreamState?;
+    /**
+     * Create a new CameraModule
+     *
+     * @param packageName - The App package name
+     * @param sessionId - The current session ID
+     * @param send - Function to send messages to the cloud
+     * @param session - Reference to the parent AppSession (optional)
+     * @param logger - Logger instance for debugging
+     */
+    constructor(packageName: string, sessionId: string, send: (message: any) => void, session?: any, logger?: Logger);
+    /**
+     * 📸 Request a photo from the connected glasses
+     *
+     * @param options - Optional configuration for the photo request
+     * @returns Promise that resolves with the actual photo data
+     *
+     * @example
+     * ```typescript
+     * // Request a photo
+     * const photo = await session.camera.requestPhoto();
+     * ```
+     */
+    requestPhoto(options?: PhotoRequestOptions): Promise<PhotoData>;
+    /**
+     * 📥 Handle photo received from /photo-upload endpoint
+     *
+     * This method is called internally when a photo response is received.
+     * It resolves the corresponding pending promise with the photo data.
+     *
+     * @param photoData - The photo data received
+     * @internal This method is used internally by AppSession
+     */
+    handlePhotoReceived(photoData: PhotoData): void;
+    /**
+     * 🔍 Check if there's a pending photo request for the given request ID
+     *
+     * @param requestId - The request ID to check
+     * @returns true if there's a pending request
+     */
+    hasPhotoPendingRequest(requestId: string): boolean;
+    /**
+     * 📊 Get the number of pending photo requests
+     *
+     * @returns Number of pending photo requests
+     */
+    getPhotoPendingRequestCount(): number;
+    /**
+     * 📋 Get all pending photo request IDs
+     *
+     * @returns Array of pending request IDs
+     */
+    getPhotoPendingRequestIds(): string[];
+    /**
+     * ❌ Cancel a pending photo request
+     *
+     * @param requestId - The request ID to cancel
+     * @returns true if the request was cancelled, false if it wasn't found
+     */
+    cancelPhotoRequest(requestId: string): boolean;
+    /**
+     * 🧹 Cancel all pending photo requests
+     *
+     * @returns Number of requests that were cancelled
+     */
+    cancelAllPhotoRequests(): number;
+    /**
+     * 📹 Start an RTMP stream to the specified URL
+     *
+     * @param options - Configuration options for the stream
+     * @returns Promise that resolves when the stream request is sent (not when streaming begins)
+     *
+     * @example
+     * ```typescript
+     * await session.camera.startStream({
+     *   rtmpUrl: 'rtmp://live.example.com/stream/key',
+     *   video: { resolution: '1920x1080', bitrate: 5000 },
+     *   audio: { bitrate: 128 }
+     * });
+     * ```
+     */
+    startStream(options: RtmpStreamOptions): Promise<void>;
+    /**
+     * 🛑 Stop the current RTMP stream
+     *
+     * @returns Promise that resolves when the stop request is sent
+     *
+     * @example
+     * ```typescript
+     * await session.camera.stopStream();
+     * ```
+     */
+    stopStream(): Promise<void>;
+    /**
+     * 🔍 Check if currently streaming
+     *
+     * @returns True if a stream is active or initializing
+     */
+    isCurrentlyStreaming(): boolean;
+    /**
+     * 📍 Get the URL of the current stream (if any)
+     *
+     * @returns The RTMP URL of the current stream, or undefined if not streaming
+     */
+    getCurrentStreamUrl(): string | undefined;
+    /**
+     * 📊 Get the current stream status
+     *
+     * @returns The current stream status, or undefined if not available
+     */
+    getStreamStatus(): RtmpStreamStatus | undefined;
+    /**
+     * 📺 Subscribe to RTMP stream status updates
+     * This uses the standard stream subscription mechanism
+     */
+    subscribeToStreamStatusUpdates(): void;
+    /**
+     * 📺 Unsubscribe from RTMP stream status updates
+     */
+    unsubscribeFromStreamStatusUpdates(): void;
+    /**
+     * 👂 Listen for stream status updates using the standard event system
+     * @param handler - Function to call when stream status changes
+     * @returns Cleanup function to remove the handler
+     *
+     * @example
+     * ```typescript
+     * const cleanup = session.camera.onStreamStatus((status) => {
+     *   console.log('Stream status:', status.status);
+     *   if (status.status === 'error') {
+     *     console.error('Stream error:', status.errorDetails);
+     *   }
+     * });
+     *
+     * // Later, cleanup the listener
+     * cleanup();
+     * ```
+     */
+    onStreamStatus(handler: StreamStatusHandler): () => void;
+    /**
+     * 🔄 Update internal stream state based on a status message
+     * For internal use by AppSession
+     * @param message - The status message from the cloud
+     * @internal This method is used internally by AppSession
+     */
+    updateStreamState(message: any): void;
+    /**
+     * 🔧 Update the session ID (used when reconnecting)
+     *
+     * @param newSessionId - The new session ID
+     * @internal This method is used internally by AppSession
+     */
+    updateSessionId(newSessionId: string): void;
+    /**
+     * 🧹 Cancel all pending requests and clean up resources
+     *
+     * @returns Object with counts of cancelled requests
+     */
+    cancelAllRequests(): {
+        photoRequests: number;
+    };
+}
+export { VideoConfig, AudioConfig, StreamConfig, StreamStatusHandler };
+//# sourceMappingURL=camera.d.ts.map

package/dist/app/session/modules/camera.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"camera.d.ts","sourceRoot":"","sources":["../../../../src/app/session/modules/camera.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAEL,SAAS,EAIT,gBAAgB,EAEjB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,WAAW,EACX,WAAW,EACX,YAAY,EACZ,mBAAmB,EACpB,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAE9B;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,sDAAsD;IACtD,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,kFAAkF;IAClF,OAAO,EAAE,MAAM,CAAC;IAChB,4CAA4C;IAC5C,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,4CAA4C;IAC5C,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,6CAA6C;IAC7C,MAAM,CAAC,EAAE,YAAY,CAAC;CACvB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,IAAI,CAAyB;IACrC,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,OAAO,CAAC,CAAM;IACtB,OAAO,CAAC,MAAM,CAAS;IAGvB,kDAAkD;IAClD,OAAO,CAAC,oBAAoB,CAGvB;IAGL,OAAO,CAAC,WAAW,CAAkB;IACrC,OAAO,CAAC,gBAAgB,CAAC,CAAS;IAClC,OAAO,CAAC,kBAAkB,CAAC,CAAmB;IAE9C;;;;;;;;OAQG;gBACS,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,OAAO,EAAE,GAAG,KAAK,IAAI,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,EAAE,MAAM;IAYhH;;;;;;;;;;;OAWG;IACG,YAAY,CAAC,OAAO,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,SAAS,CAAC;IAoDrE;;;;;;;;OAQG;IACH,mBAAmB,CAAC,SAAS,EAAE,SAAS,GAAG,IAAI;IAiB/C;;;;;OAKG;IACH,sBAAsB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAIlD;;;;OAIG;IACH,2BAA2B,IAAI,MAAM;IAIrC;;;;OAIG;IACH,yBAAyB,IAAI,MAAM,EAAE;IAIrC;;;;;OAKG;IACH,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAW9C;;;;OAIG;IACH,sBAAsB,IAAI,MAAM;IAgBhC;;;;;;;;;;;;;;OAcG;IACG,WAAW,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IA4C5D;;;;;;;;;OASG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IA+BjC;;;;OAIG;IACH,oBAAoB,IAAI,OAAO;IAI/B;;;;OAIG;IACH,mBAAmB,IAAI,MAAM,GAAG,SAAS;IAIzC;;;;OAIG;IACH,eAAe,IAAI,gBAAgB,GAAG,SAAS;IAI/C;;;OAGG;IACH,8BAA8B,IAAI,IAAI;IAQtC;;OAEG;IACH,kCAAkC,IAAI,IAAI;IAM1C;;;;;;;;;;;;;;;;;OAiBG;IACH,cAAc,CAAC,OAAO,EAAE,mBAAmB,GAAG,MAAM,IAAI;IAUxD;;;;;OAKG;IACH,iBAAiB,CAAC,OAAO,EAAE,GAAG,GAAG,IAAI;IAiDrC;;;;;OAKG;IACH,eAAe,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI;IAI3C;;;;OAIG;IACH,iBAAiB,IAAI;QAAE,aAAa,EAAE,MAAM,CAAA;KAAE;CAY/C;AAGD,OAAO,EACL,WAAW,EACX,WAAW,EACX,YAAY,EACZ,mBAAmB,EACpB,CAAC"}