@mentra/miniapp 3.2.0-dev.116 → 3.2.0-dev.121

package/src/session.ts

@@ -45,6 +45,7 @@ import {SystemModule} from "./modules/system"
 import {MiniappsModule} from "./modules/miniapps"
 import {ActionsModule} from "./modules/actions"
 import {BlobModule} from "./modules/blob"
+import {MeetingModule, parseMeetingMediaSource, parseMeetingParticipants} from "./modules/meeting"
 
 // ---------------------------------------------------------------------------
 // Public types
@@ -105,6 +106,13 @@ export interface ConnectAckPayload {
   permissions?: PermissionRecord
   /** Miniapp-scoped backend auth. Never a Core or runtime token. */
   auth?: MiniappAuthState
+  /** Host-advertised optional features. Absent on older Mentra Apps. */
+  hostFeatures?: HostFeatures
+}
+
+export interface HostFeatures {
+  /** Host honors `startStream({captureAudio})` for the lifetime of a WHIP session. */
+  captureAudio?: boolean
 }
 
 export interface MiniappAuthState {
@@ -191,6 +199,7 @@ type SessionEmitterEvents = {
   colorScheme: (scheme: MiniappColorScheme) => void
   permissions: (perms: PermissionRecord) => void
   speakerState: (event: import("./modules/speaker").SpeakerStateEvent) => void
+  meetingState: (event: import("./modules/meeting").MeetingState) => void
   auth: (auth: MiniappAuthState) => void
 }
 
@@ -211,6 +220,7 @@ export class MiniappSession<TChannels extends object = any> {
    */
   public readonly events: EventManager
   public readonly speaker: SpeakerModule
+  public readonly meeting: MeetingModule
   public readonly camera: CameraModule
   public readonly cloud: CloudModule
   public readonly dashboard: DashboardAPI
@@ -256,6 +266,11 @@ export class MiniappSession<TChannels extends object = any> {
 
   /** Phone-declared glasses capabilities. Null until CONNECT_ACK arrives. */
   public capabilities: GlassesCapabilities | null = null
+  /**
+   * Host-advertised optional features. Null until CONNECT_ACK. Older Mentra Apps
+   * omit this, so miniapps must not assume `captureAudio` is honored.
+   */
+  public hostFeatures: HostFeatures | null = null
   public userId = ""
   public packageName = ""
   public visibility: MiniappVisibility = "foreground"
@@ -308,6 +323,7 @@ export class MiniappSession<TChannels extends object = any> {
     this.auth = new AuthModule(this)
     this.events = new EventManager(this)
     this.speaker = new SpeakerModule(this)
+    this.meeting = new MeetingModule(this)
     this.camera = new CameraModule(this)
     this.cloud = new CloudModule(this)
     this.dashboard = new DashboardAPI(this)
@@ -619,6 +635,7 @@ export class MiniappSession<TChannels extends object = any> {
         this.userId = ack.userId ?? ""
         if (ack.packageName) this.packageName = ack.packageName
         this.capabilities = ack.capabilities ?? null
+        this.hostFeatures = ack.hostFeatures ?? null
         if (ack.visibility) this.visibility = ack.visibility
         if (ack.colorScheme === "light" || ack.colorScheme === "dark") {
           this.colorScheme = ack.colorScheme
@@ -667,6 +684,27 @@ export class MiniappSession<TChannels extends object = any> {
         return
       }
 
+      case MiniappResponseType.MEETING_STATE: {
+        const state = payload.state as import("./modules/meeting").MeetingPhase | undefined
+        if (!state) return
+        const event: import("./modules/meeting").MeetingState = {
+          state,
+          muted: Boolean(payload.muted),
+          error: payload.error as string | undefined,
+          meetingUrl: payload.meetingUrl as string | undefined,
+          provider: payload.provider as import("./modules/meeting").MeetingProvider | undefined,
+          audioSource: payload.audioSource as import("./modules/meeting").MeetingState["audioSource"],
+          audioSourceReason: payload.audioSourceReason as import("./modules/meeting").MeetingState["audioSourceReason"],
+          activeStream: payload.activeStream as import("./modules/meeting").MeetingState["activeStream"],
+          audioSafety: payload.audioSafety as import("./modules/meeting").MeetingState["audioSafety"],
+          mediaSource: parseMeetingMediaSource(payload.mediaSource),
+          participants: parseMeetingParticipants(payload.participants),
+        }
+        this.meeting._applyState(event)
+        this.emitter.emit("meetingState", event)
+        return
+      }
+
       case MiniappRequestType.PING: {
         // Phone → miniapp keepalive ping. Auto-reply with PONG.
         const pong: object = {type: MiniappResponseType.PONG}