@mentra/sdk 2.1.1 → 2.1.2

package/dist/app/session/modules/camera-managed-extension.js

@@ -0,0 +1,231 @@
+"use strict";
+/**
+ * 📷 Camera Module Managed Streaming Extension
+ *
+ * Extends the camera module with managed streaming capabilities.
+ * Apps can request managed streams and receive HLS/DASH URLs without managing RTMP endpoints.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CameraManagedExtension = void 0;
+const types_1 = require("../../../types");
+/**
+ * 📹 Managed Streaming Extension for Camera Module
+ *
+ * Provides managed streaming capabilities where the cloud handles
+ * RTMP endpoints and returns HLS/DASH URLs for viewing.
+ *
+ * @example
+ * ```typescript
+ * // Start a managed stream
+ * const urls = await session.camera.startManagedStream({
+ *   quality: '720p',
+ *   enableWebRTC: true
+ * });
+ * console.log('HLS URL:', urls.hlsUrl);
+ * console.log('DASH URL:', urls.dashUrl);
+ *
+ * // Monitor managed stream status
+ * session.camera.onManagedStreamStatus((status) => {
+ *   console.log('Managed stream status:', status.status);
+ * });
+ *
+ * // Stop managed stream
+ * await session.camera.stopManagedStream();
+ * ```
+ */
+class CameraManagedExtension {
+    constructor(packageName, sessionId, send, logger, session) {
+        // Managed streaming state
+        this.isManagedStreaming = false;
+        this.packageName = packageName;
+        this.sessionId = sessionId;
+        this.send = send;
+        this.logger = logger.child({ module: 'CameraManagedExtension' });
+        this.session = session;
+    }
+    /**
+     * 📹 Start a managed stream
+     *
+     * The cloud will handle the RTMP endpoint and return HLS/DASH URLs for viewing.
+     * Multiple apps can consume the same managed stream simultaneously.
+     *
+     * @param options - Configuration options for the managed stream
+     * @returns Promise that resolves with viewing URLs when the stream is ready
+     *
+     * @example
+     * ```typescript
+     * const urls = await session.camera.startManagedStream({
+     *   quality: '1080p',
+     *   enableWebRTC: true,
+     *   video: { fps: 30 },
+     *   audio: { sampleRate: 48000 }
+     * });
+     * ```
+     */
+    async startManagedStream(options = {}) {
+        this.logger.info({ options }, '📹 Managed stream request starting');
+        if (this.isManagedStreaming) {
+            this.logger.error({
+                currentStreamId: this.currentManagedStreamId
+            }, '📹 Already managed streaming error');
+            throw new Error('Already streaming. Stop the current managed stream before starting a new one.');
+        }
+        // Create the request message
+        const request = {
+            type: types_1.AppToCloudMessageType.MANAGED_STREAM_REQUEST,
+            packageName: this.packageName,
+            quality: options.quality,
+            enableWebRTC: options.enableWebRTC,
+            video: options.video,
+            audio: options.audio,
+            stream: options.stream
+        };
+        // Send the request
+        this.send(request);
+        this.isManagedStreaming = true;
+        // Create promise to wait for URLs
+        return new Promise((resolve, reject) => {
+            this.pendingManagedStreamRequest = { resolve, reject };
+            // Set a timeout
+            setTimeout(() => {
+                if (this.pendingManagedStreamRequest) {
+                    this.pendingManagedStreamRequest = undefined;
+                    this.isManagedStreaming = false;
+                    reject(new Error('Managed stream request timeout'));
+                }
+            }, 30000); // 30 second timeout
+        });
+    }
+    /**
+     * 🛑 Stop the current managed stream
+     *
+     * This will stop streaming for this app only. If other apps are consuming
+     * the same managed stream, it will continue for them.
+     *
+     * @returns Promise that resolves when the stop request is sent
+     */
+    async stopManagedStream() {
+        if (!this.isManagedStreaming) {
+            this.logger.warn('📹 No managed stream to stop');
+            return;
+        }
+        this.logger.info({ streamId: this.currentManagedStreamId }, '📹 Stopping managed stream');
+        const request = {
+            type: types_1.AppToCloudMessageType.MANAGED_STREAM_STOP,
+            packageName: this.packageName
+        };
+        this.send(request);
+        // Clean up state
+        this.isManagedStreaming = false;
+        this.currentManagedStreamId = undefined;
+        this.currentManagedStreamUrls = undefined;
+        this.managedStreamStatus = undefined;
+        this.pendingManagedStreamRequest = undefined;
+    }
+    /**
+     * 📊 Check if currently managed streaming
+     *
+     * @returns true if a managed stream is active
+     */
+    isManagedStreamActive() {
+        return this.isManagedStreaming;
+    }
+    /**
+     * 🔗 Get current managed stream URLs
+     *
+     * @returns Current stream URLs or undefined if not streaming
+     */
+    getManagedStreamUrls() {
+        return this.currentManagedStreamUrls;
+    }
+    /**
+     * 📊 Get current managed stream status
+     *
+     * @returns Current stream status or undefined
+     */
+    getManagedStreamStatus() {
+        return this.managedStreamStatus;
+    }
+    /**
+     * 🔔 Register a handler for managed stream status updates
+     *
+     * @param handler - Function to call when stream status changes
+     * @returns Cleanup function to unregister the handler
+     *
+     * @example
+     * ```typescript
+     * const cleanup = session.camera.onManagedStreamStatus((status) => {
+     *   console.log('Status:', status.status);
+     *   if (status.status === 'active') {
+     *     console.log('Stream is live!');
+     *   }
+     * });
+     *
+     * // Later, unregister the handler
+     * cleanup();
+     * ```
+     */
+    onManagedStreamStatus(handler) {
+        if (!this.session) {
+            this.logger.error('Cannot listen for managed status updates: session reference not available');
+            return () => { };
+        }
+        this.session.subscribe(types_1.StreamType.MANAGED_STREAM_STATUS);
+        // Register the handler using the session's event system
+        return this.session.on(types_1.StreamType.MANAGED_STREAM_STATUS, handler);
+    }
+    /**
+     * Handle incoming managed stream status messages
+     * Called by the parent AppSession when messages are received
+     */
+    handleManagedStreamStatus(status) {
+        this.logger.info({
+            status: status.status,
+            streamId: status.streamId
+        }, '📹 Received managed stream status');
+        this.managedStreamStatus = status;
+        // Handle initial stream ready status
+        if (status.status === 'active' && this.pendingManagedStreamRequest && status.hlsUrl && status.dashUrl) {
+            const result = {
+                hlsUrl: status.hlsUrl,
+                dashUrl: status.dashUrl,
+                webrtcUrl: status.webrtcUrl,
+                streamId: status.streamId || ''
+            };
+            this.currentManagedStreamId = status.streamId;
+            this.currentManagedStreamUrls = result;
+            // Resolve the pending promise
+            this.pendingManagedStreamRequest.resolve(result);
+            this.pendingManagedStreamRequest = undefined;
+        }
+        // Handle error status
+        if ((status.status === 'error' || status.status === 'stopped') && this.pendingManagedStreamRequest) {
+            this.pendingManagedStreamRequest.reject(new Error(status.message || 'Managed stream failed'));
+            this.pendingManagedStreamRequest = undefined;
+            this.isManagedStreaming = false;
+        }
+        // Clean up on stopped status
+        if (status.status === 'stopped') {
+            this.isManagedStreaming = false;
+            this.currentManagedStreamId = undefined;
+            this.currentManagedStreamUrls = undefined;
+        }
+        // Notify handlers (would use event emitter in real implementation)
+        // this.emit('managedStreamStatus', status);
+    }
+    /**
+     * 🧹 Clean up all managed streaming state
+     */
+    cleanup() {
+        if (this.pendingManagedStreamRequest) {
+            this.pendingManagedStreamRequest.reject(new Error('Camera module cleanup'));
+            this.pendingManagedStreamRequest = undefined;
+        }
+        this.isManagedStreaming = false;
+        this.currentManagedStreamId = undefined;
+        this.currentManagedStreamUrls = undefined;
+        this.managedStreamStatus = undefined;
+        this.logger.info('📹 Managed streaming extension cleaned up');
+    }
+}
+exports.CameraManagedExtension = CameraManagedExtension;

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

@@ -4,9 +4,10 @@
  * Unified camera functionality for App Sessions.
  * Handles both photo requests and RTMP streaming from connected glasses.
  */
-import { PhotoData, RtmpStreamStatus } from '../../../types';
+import { PhotoData, RtmpStreamStatus, ManagedStreamStatus } from '../../../types';
 import { VideoConfig, AudioConfig, StreamConfig, StreamStatusHandler } from '../../../types/rtmp-stream';
 import { Logger } from 'pino';
+import { ManagedStreamOptions, ManagedStreamResult } from './camera-managed-extension';
 /**
  * Options for photo requests
  */
@@ -65,6 +66,7 @@ export declare class CameraModule {
     private isStreaming;
     private currentStreamUrl?;
     private currentStreamState?;
+    private managedExtension;
     /**
      * Create a new CameraModule
      *
@@ -210,6 +212,58 @@ export declare class CameraModule {
      * @internal This method is used internally by AppSession
      */
     updateStreamState(message: any): void;
+    /**
+     * 📹 Start a managed stream
+     *
+     * The cloud handles the RTMP endpoint and returns HLS/DASH URLs for viewing.
+     * Multiple apps can consume the same managed stream simultaneously.
+     *
+     * @param options - Configuration options for the managed stream
+     * @returns Promise that resolves with viewing URLs when the stream is ready
+     *
+     * @example
+     * ```typescript
+     * const urls = await session.camera.startManagedStream({
+     *   quality: '720p',
+     *   enableWebRTC: true
+     * });
+     * console.log('HLS URL:', urls.hlsUrl);
+     * ```
+     */
+    startManagedStream(options?: ManagedStreamOptions): Promise<ManagedStreamResult>;
+    /**
+     * 🛑 Stop the current managed stream
+     *
+     * This will stop streaming for this app only. If other apps are consuming
+     * the same managed stream, it will continue for them.
+     *
+     * @returns Promise that resolves when the stop request is sent
+     */
+    stopManagedStream(): Promise<void>;
+    /**
+     * 🔔 Register a handler for managed stream status updates
+     *
+     * @param handler - Function to call when stream status changes
+     * @returns Cleanup function to unregister the handler
+     */
+    onManagedStreamStatus(handler: (status: ManagedStreamStatus) => void): () => void;
+    /**
+     * 📊 Check if currently managed streaming
+     *
+     * @returns true if a managed stream is active
+     */
+    isManagedStreamActive(): boolean;
+    /**
+     * 🔗 Get current managed stream URLs
+     *
+     * @returns Current stream URLs or undefined if not streaming
+     */
+    getManagedStreamUrls(): ManagedStreamResult | undefined;
+    /**
+     * Handle incoming managed stream status messages
+     * @internal
+     */
+    handleManagedStreamStatus(message: ManagedStreamStatus): void;
     /**
      * 🔧 Update the session ID (used when reconnecting)
      *

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

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

package/dist/app/session/modules/camera.js

@@ -9,6 +9,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.CameraModule = void 0;
 const types_1 = require("../../../types");
 const streams_1 = require("../../../types/streams");
+const camera_managed_extension_1 = require("./camera-managed-extension");
 /**
  * 📷 Camera Module Implementation
  *
@@ -57,6 +58,8 @@ class CameraModule {
         this.send = send;
         this.session = session;
         this.logger = logger || console;
+        // Initialize managed extension
+        this.managedExtension = new camera_managed_extension_1.CameraManagedExtension(packageName, sessionId, send, this.logger, session);
     }
     // =====================================
     // 📸 Photo Functionality
@@ -409,6 +412,73 @@ class CameraModule {
         this.currentStreamState = status;
     }
     // =====================================
+    // 📹 Managed Streaming Functionality
+    // =====================================
+    /**
+     * 📹 Start a managed stream
+     *
+     * The cloud handles the RTMP endpoint and returns HLS/DASH URLs for viewing.
+     * Multiple apps can consume the same managed stream simultaneously.
+     *
+     * @param options - Configuration options for the managed stream
+     * @returns Promise that resolves with viewing URLs when the stream is ready
+     *
+     * @example
+     * ```typescript
+     * const urls = await session.camera.startManagedStream({
+     *   quality: '720p',
+     *   enableWebRTC: true
+     * });
+     * console.log('HLS URL:', urls.hlsUrl);
+     * ```
+     */
+    async startManagedStream(options) {
+        return this.managedExtension.startManagedStream(options);
+    }
+    /**
+     * 🛑 Stop the current managed stream
+     *
+     * This will stop streaming for this app only. If other apps are consuming
+     * the same managed stream, it will continue for them.
+     *
+     * @returns Promise that resolves when the stop request is sent
+     */
+    async stopManagedStream() {
+        return this.managedExtension.stopManagedStream();
+    }
+    /**
+     * 🔔 Register a handler for managed stream status updates
+     *
+     * @param handler - Function to call when stream status changes
+     * @returns Cleanup function to unregister the handler
+     */
+    onManagedStreamStatus(handler) {
+        return this.managedExtension.onManagedStreamStatus(handler);
+    }
+    /**
+     * 📊 Check if currently managed streaming
+     *
+     * @returns true if a managed stream is active
+     */
+    isManagedStreamActive() {
+        return this.managedExtension.isManagedStreamActive();
+    }
+    /**
+     * 🔗 Get current managed stream URLs
+     *
+     * @returns Current stream URLs or undefined if not streaming
+     */
+    getManagedStreamUrls() {
+        return this.managedExtension.getManagedStreamUrls();
+    }
+    /**
+     * Handle incoming managed stream status messages
+     * @internal
+     */
+    handleManagedStreamStatus(message) {
+        this.managedExtension.handleManagedStreamStatus(message);
+    }
+    // =====================================
     // 🔧 General Utilities
     // =====================================
     /**
@@ -433,6 +503,8 @@ class CameraModule {
                 this.logger.error({ error }, 'Error stopping stream during cleanup');
             });
         }
+        // Clean up managed extension
+        this.managedExtension.cleanup();
         return { photoRequests };
     }
 }

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

@@ -0,0 +1,4 @@
+export * from './audio';
+export * from './camera';
+export * from './camera-managed-extension';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/app/session/modules/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC;AACzB,cAAc,4BAA4B,CAAC"}

package/dist/app/session/modules/index.js

@@ -0,0 +1,19 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./audio"), exports);
+__exportStar(require("./camera"), exports);
+__exportStar(require("./camera-managed-extension"), exports);

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

@@ -0,0 +1,16 @@
+import { AppSession } from '..';
+import { LocationUpdate } from '../../../types';
+export declare class LocationManager {
+    private session;
+    private send;
+    private lastLocationCleanupHandler;
+    constructor(session: AppSession, send: (message: any) => void);
+    subscribeToStream(options: {
+        accuracy: 'standard' | 'high' | 'realtime' | 'tenMeters' | 'hundredMeters' | 'kilometer' | 'threeKilometers' | 'reduced';
+    }, handler: (data: LocationUpdate) => void): () => void;
+    unsubscribeFromStream(): void;
+    getLatestLocation(options: {
+        accuracy: string;
+    }): Promise<LocationUpdate>;
+}
+//# sourceMappingURL=location.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"location.d.ts","sourceRoot":"","sources":["../../../../src/app/session/modules/location.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AAChC,OAAO,EAAqC,cAAc,EAAyB,MAAM,gBAAgB,CAAC;AAE1G,qBAAa,eAAe;IAGd,OAAO,CAAC,OAAO;IAAc,OAAO,CAAC,IAAI;IAFrD,OAAO,CAAC,0BAA0B,CAAwB;gBAEtC,OAAO,EAAE,UAAU,EAAU,IAAI,EAAE,CAAC,OAAO,EAAE,GAAG,KAAK,IAAI;IAGtE,iBAAiB,CAAC,OAAO,EAAE;QAAE,QAAQ,EAAE,UAAU,GAAG,MAAM,GAAG,UAAU,GAAG,WAAW,GAAG,eAAe,GAAG,WAAW,GAAG,iBAAiB,GAAG,SAAS,CAAA;KAAE,EAAE,OAAO,EAAE,CAAC,IAAI,EAAE,cAAc,KAAK,IAAI,GAAG,MAAM,IAAI;IAQ7M,qBAAqB,IAAI,IAAI;IAUvB,iBAAiB,CAAC,OAAO,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,cAAc,CAAC;CA4BvF"}

package/dist/app/session/modules/location.js

@@ -0,0 +1,55 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LocationManager = void 0;
+const types_1 = require("../../../types");
+class LocationManager {
+    constructor(session, send) {
+        this.session = session;
+        this.send = send;
+        this.lastLocationCleanupHandler = () => { };
+    }
+    // subscribes to the continuous location stream with a specified accuracy tier
+    subscribeToStream(options, handler) {
+        const subscription = { stream: 'location_stream', rate: options.accuracy };
+        this.session.subscribe(subscription);
+        this.lastLocationCleanupHandler = this.session.events.onLocation(handler);
+        return this.lastLocationCleanupHandler;
+    }
+    // unsubscribes from the continuous location stream
+    unsubscribeFromStream() {
+        if (this.lastLocationCleanupHandler) {
+            this.lastLocationCleanupHandler();
+            this.lastLocationCleanupHandler = () => { };
+        }
+        else {
+            this.session.unsubscribe('location_stream');
+        }
+    }
+    // performs a one-time, intelligent poll for a location fix
+    async getLatestLocation(options) {
+        return new Promise((resolve, reject) => {
+            const requestId = `poll_${Date.now()}_${Math.random().toString(36).substring(2, 9)}`;
+            // listens for a location update with a matching correlationId
+            const unsubscribe = this.session.events.on('location_update', (data) => {
+                if (data.correlationId === requestId) {
+                    unsubscribe(); // clean up the listener
+                    resolve(data);
+                }
+            });
+            // sends the poll request message to the cloud
+            this.send({
+                type: types_1.AppToCloudMessageType.LOCATION_POLL_REQUEST,
+                correlationId: requestId,
+                packageName: this.session.getPackageName(),
+                sessionId: this.session.getSessionId(),
+                accuracy: options.accuracy
+            });
+            // sets a timeout to prevent the promise from hanging indefinitely
+            setTimeout(() => {
+                unsubscribe();
+                reject(new Error('Location poll request timed out'));
+            }, 15000); // 15 second timeout
+        });
+    }
+}
+exports.LocationManager = LocationManager;

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/app/webview/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACjD,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAUnD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAQ3D;AAED;;;;;;;;GAQG;AACH,wBAAsB,aAAa,CACjC,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAmC7B;AAsID;;;;;;;;;;;;GAYG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE;IAC5C,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE;QACd,QAAQ,CAAC,EAAE,OAAO,CAAC;QACnB,MAAM,CAAC,EAAE,OAAO,CAAC;QACjB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,QAAQ,CAAC,EAAE,OAAO,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;QAC/C,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,CAAC;CACH,IAuBe,KAAK,oBAAoB,EAAE,KAAK,QAAQ,EAAE,MAAM,YAAY,mBAkG3E"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/app/webview/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACjD,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAUnD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAQ3D;AAED;;;;;;;;GAQG;AACH,wBAAsB,aAAa,CACjC,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAmC7B;AAsID;;;;;;;;;;;;GAYG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE;IAC5C,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE;QACd,QAAQ,CAAC,EAAE,OAAO,CAAC;QACnB,MAAM,CAAC,EAAE,OAAO,CAAC;QACjB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,QAAQ,CAAC,EAAE,OAAO,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;QAC/C,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,CAAC;CACH,IAuBe,KAAK,oBAAoB,EAAE,KAAK,QAAQ,EAAE,MAAM,YAAY,mBAiG3E"}

package/dist/app/webview/index.js

@@ -324,7 +324,6 @@ function createAuthMiddleware(options) {
             try {
                 // Verify the signed session cookie and extract the user ID
                 const userId = verifySession(sessionCookie, cookieSecret, cookieOptions.maxAge);
-                console.log(`User ID verified from session cookie: ${userId}`);
                 if (userId) {
                     req.authUserId = userId;
                     return next();

package/dist/examples/managed-rtmp-streaming-example.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=managed-rtmp-streaming-example.d.ts.map

package/dist/examples/managed-rtmp-streaming-example.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"managed-rtmp-streaming-example.d.ts","sourceRoot":"","sources":["../../src/examples/managed-rtmp-streaming-example.ts"],"names":[],"mappings":""}