@mentra/acs-meeting 3.2.0-dev.226 → 3.2.0-dev.232

package/build/AcsMeeting.types.d.ts

@@ -26,6 +26,11 @@ export type AcsMeetingState = {
     activeStream?: AcsActiveStream;
     audioSafety?: AcsAudioSafety;
     mediaSource?: AcsMediaSourceState;
+    /** Native receiver diagnostic, including the reason a local WHIP offer was rejected. */
+    mediaSourceReason?: string;
+    /** ACS disconnect diagnostics, emitted when the final disconnected state arrives. */
+    endReason_code?: number;
+    endReason_subcode?: number;
     /** Local WHIP endpoint, available after a SoftAP join. */
     ingestUrl?: string;
     /** Remote roster (Android emits this; iOS does not yet). */

package/build/AcsMeeting.types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AcsMeeting.types.d.ts","sourceRoot":"","sources":["../src/AcsMeeting.types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,YAAY,GAAG,OAAO,GAAG,WAAW,GAAG,cAAc,GAAG,OAAO,CAAA;AAEnG,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,OAAO,CAAA;AAChD,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,CAAA;AAC1D,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,UAAU,GAAG,QAAQ,CAAA;AAC3D;;;;GAIG;AACH,MAAM,MAAM,mBAAmB,GAAG,MAAM,GAAG,YAAY,GAAG,MAAM,GAAG,QAAQ,CAAA;AAE3E,MAAM,MAAM,0BAA0B,GAAG,MAAM,GAAG,YAAY,GAAG,WAAW,GAAG,OAAO,GAAG,MAAM,GAAG,cAAc,CAAA;AAEhH,MAAM,MAAM,qBAAqB,GAAG;IAClC,EAAE,EAAE,MAAM,CAAA;IACV,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,KAAK,EAAE,0BAA0B,CAAA;IACjC,OAAO,EAAE,OAAO,CAAA;IAChB,UAAU,EAAE,OAAO,CAAA;CACpB,CAAA;AAED,MAAM,MAAM,eAAe,GAAG;IAC5B,KAAK,EAAE,YAAY,CAAA;IACnB,KAAK,EAAE,OAAO,CAAA;IACd,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,EAAE,WAAW,CAAA;IACtB,WAAW,CAAC,EAAE,cAAc,CAAA;IAC5B,YAAY,CAAC,EAAE,eAAe,CAAA;IAC9B,WAAW,CAAC,EAAE,cAAc,CAAA;IAC5B,WAAW,CAAC,EAAE,mBAAmB,CAAA;IACjC,0DAA0D;IAC1D,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,4DAA4D;IAC5D,YAAY,CAAC,EAAE,qBAAqB,EAAE,CAAA;CACvC,CAAA;AAED,MAAM,MAAM,gBAAgB,GAAG;IAC7B,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;IACd,GAAG,EAAE,MAAM,CAAA;IACX,aAAa,EAAE,MAAM,CAAA;CACtB,CAAA;AAED,MAAM,MAAM,qBAAqB,GAAG;IAClC,UAAU,EAAE,MAAM,CAAA;IAClB,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,WAAW,CAAC,EAAE;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAC,GAAG;QAAC,IAAI,EAAE,QAAQ,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAC,CAAA;IACjF,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,gFAAgF;IAChF,WAAW,CAAC,EAAE,cAAc,CAAA;IAC5B;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,2DAA2D;IAC3D,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,yDAAyD;IACzD,KAAK,CAAC,EAAE,gBAAgB,CAAA;CACzB,CAAA;AAED,MAAM,MAAM,mBAAmB,GAAG;IAChC,MAAM,EAAE,MAAM,CAAA;IACd,UAAU,EAAE,MAAM,CAAA;IAClB,QAAQ,EAAE,MAAM,CAAA;CACjB,CAAA;AAED,MAAM,MAAM,sBAAsB,GAAG;IACnC,OAAO,EAAE,CAAC,KAAK,EAAE,eAAe,KAAK,IAAI,CAAA;IACzC,aAAa,EAAE,CAAC,GAAG,EAAE,mBAAmB,KAAK,IAAI,CAAA;CAClD,CAAA"}
+{"version":3,"file":"AcsMeeting.types.d.ts","sourceRoot":"","sources":["../src/AcsMeeting.types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,YAAY,GAAG,OAAO,GAAG,WAAW,GAAG,cAAc,GAAG,OAAO,CAAA;AAEnG,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,OAAO,CAAA;AAChD,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,CAAA;AAC1D,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,UAAU,GAAG,QAAQ,CAAA;AAC3D;;;;GAIG;AACH,MAAM,MAAM,mBAAmB,GAAG,MAAM,GAAG,YAAY,GAAG,MAAM,GAAG,QAAQ,CAAA;AAE3E,MAAM,MAAM,0BAA0B,GAAG,MAAM,GAAG,YAAY,GAAG,WAAW,GAAG,OAAO,GAAG,MAAM,GAAG,cAAc,CAAA;AAEhH,MAAM,MAAM,qBAAqB,GAAG;IAClC,EAAE,EAAE,MAAM,CAAA;IACV,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,KAAK,EAAE,0BAA0B,CAAA;IACjC,OAAO,EAAE,OAAO,CAAA;IAChB,UAAU,EAAE,OAAO,CAAA;CACpB,CAAA;AAED,MAAM,MAAM,eAAe,GAAG;IAC5B,KAAK,EAAE,YAAY,CAAA;IACnB,KAAK,EAAE,OAAO,CAAA;IACd,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,EAAE,WAAW,CAAA;IACtB,WAAW,CAAC,EAAE,cAAc,CAAA;IAC5B,YAAY,CAAC,EAAE,eAAe,CAAA;IAC9B,WAAW,CAAC,EAAE,cAAc,CAAA;IAC5B,WAAW,CAAC,EAAE,mBAAmB,CAAA;IACjC,wFAAwF;IACxF,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,qFAAqF;IACrF,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,0DAA0D;IAC1D,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,4DAA4D;IAC5D,YAAY,CAAC,EAAE,qBAAqB,EAAE,CAAA;CACvC,CAAA;AAED,MAAM,MAAM,gBAAgB,GAAG;IAC7B,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;IACd,GAAG,EAAE,MAAM,CAAA;IACX,aAAa,EAAE,MAAM,CAAA;CACtB,CAAA;AAED,MAAM,MAAM,qBAAqB,GAAG;IAClC,UAAU,EAAE,MAAM,CAAA;IAClB,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,WAAW,CAAC,EAAE;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAC,GAAG;QAAC,IAAI,EAAE,QAAQ,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAC,CAAA;IACjF,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,gFAAgF;IAChF,WAAW,CAAC,EAAE,cAAc,CAAA;IAC5B;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,2DAA2D;IAC3D,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,yDAAyD;IACzD,KAAK,CAAC,EAAE,gBAAgB,CAAA;CACzB,CAAA;AAED,MAAM,MAAM,mBAAmB,GAAG;IAChC,MAAM,EAAE,MAAM,CAAA;IACd,UAAU,EAAE,MAAM,CAAA;IAClB,QAAQ,EAAE,MAAM,CAAA;CACjB,CAAA;AAED,MAAM,MAAM,sBAAsB,GAAG;IACnC,OAAO,EAAE,CAAC,KAAK,EAAE,eAAe,KAAK,IAAI,CAAA;IACzC,aAAa,EAAE,CAAC,GAAG,EAAE,mBAAmB,KAAK,IAAI,CAAA;CAClD,CAAA"}

package/build/AcsMeeting.types.js.map

@@ -1 +1 @@
-{"version":3,"file":"AcsMeeting.types.js","sourceRoot":"","sources":["../src/AcsMeeting.types.ts"],"names":[],"mappings":"","sourcesContent":["export type MeetingPhase = \"idle\" | \"connecting\" | \"lobby\" | \"connected\" | \"disconnected\" | \"error\"\n\nexport type AcsAudioSource = \"glasses\" | \"phone\"\nexport type AcsActiveStream = \"none\" | \"virtual\" | \"local\"\nexport type AcsAudioSafety = \"safe\" | \"degraded\" | \"unsafe\"\n/**\n * Health of the glasses WHEP subscription feeding the call. `failed` = ICE dropped or\n * the WHEP endpoint went away while the ACS call may still be `connected`. Native\n * rebuilds it on its own with backoff; the host can force one via `restartVideoSource`.\n */\nexport type AcsMediaSourceState = \"idle\" | \"connecting\" | \"live\" | \"failed\"\n\nexport type AcsMeetingParticipantState = \"idle\" | \"connecting\" | \"connected\" | \"lobby\" | \"hold\" | \"disconnected\"\n\nexport type AcsMeetingParticipant = {\n  id: string\n  displayName: string | null\n  state: AcsMeetingParticipantState\n  isMuted: boolean\n  isSpeaking: boolean\n}\n\nexport type AcsMeetingState = {\n  state: MeetingPhase\n  muted: boolean\n  error?: string\n  meetingUrl?: string\n  provider?: \"acs-teams\"\n  audioSource?: AcsAudioSource\n  activeStream?: AcsActiveStream\n  audioSafety?: AcsAudioSafety\n  mediaSource?: AcsMediaSourceState\n  /** Local WHIP endpoint, available after a SoftAP join. */\n  ingestUrl?: string\n  /** Remote roster (Android emits this; iOS does not yet). */\n  participants?: AcsMeetingParticipant[]\n}\n\nexport type AcsOutgoingVideo = {\n  width: number\n  height: number\n  fps: number\n  maxBitrateBps: number\n}\n\nexport type AcsMeetingJoinOptions = {\n  meetingUrl: string\n  token: string\n  whepUrl?: string\n  videoSource?: {type: \"whep\"; url: string} | {type: \"softap\"; bindAddress: string}\n  displayName?: string\n  /** \"glasses\" sends WHEP PCM. \"phone\" uses the ACS local mic (handset or BT). */\n  audioSource?: AcsAudioSource\n  /**\n   * Hold outgoing PCM this many ms before ACS. SoftAP+LC3 sets this in the host\n   * because BLE audio reaches the phone before SoftAP video.\n   */\n  audioDelayMs?: number\n  /** Dump WHEP PCM to a WAV in cache for P4 verification. */\n  dumpPcmWav?: boolean\n  /** When omitted, native keeps 1280×720@15 / 2.5 Mbps. */\n  video?: AcsOutgoingVideo\n}\n\nexport type AcsIncomingPcmEvent = {\n  base64: string\n  sampleRate: number\n  channels: number\n}\n\nexport type AcsMeetingModuleEvents = {\n  onState: (state: AcsMeetingState) => void\n  onIncomingPcm: (pcm: AcsIncomingPcmEvent) => void\n}\n"]}
+{"version":3,"file":"AcsMeeting.types.js","sourceRoot":"","sources":["../src/AcsMeeting.types.ts"],"names":[],"mappings":"","sourcesContent":["export type MeetingPhase = \"idle\" | \"connecting\" | \"lobby\" | \"connected\" | \"disconnected\" | \"error\"\n\nexport type AcsAudioSource = \"glasses\" | \"phone\"\nexport type AcsActiveStream = \"none\" | \"virtual\" | \"local\"\nexport type AcsAudioSafety = \"safe\" | \"degraded\" | \"unsafe\"\n/**\n * Health of the glasses WHEP subscription feeding the call. `failed` = ICE dropped or\n * the WHEP endpoint went away while the ACS call may still be `connected`. Native\n * rebuilds it on its own with backoff; the host can force one via `restartVideoSource`.\n */\nexport type AcsMediaSourceState = \"idle\" | \"connecting\" | \"live\" | \"failed\"\n\nexport type AcsMeetingParticipantState = \"idle\" | \"connecting\" | \"connected\" | \"lobby\" | \"hold\" | \"disconnected\"\n\nexport type AcsMeetingParticipant = {\n  id: string\n  displayName: string | null\n  state: AcsMeetingParticipantState\n  isMuted: boolean\n  isSpeaking: boolean\n}\n\nexport type AcsMeetingState = {\n  state: MeetingPhase\n  muted: boolean\n  error?: string\n  meetingUrl?: string\n  provider?: \"acs-teams\"\n  audioSource?: AcsAudioSource\n  activeStream?: AcsActiveStream\n  audioSafety?: AcsAudioSafety\n  mediaSource?: AcsMediaSourceState\n  /** Native receiver diagnostic, including the reason a local WHIP offer was rejected. */\n  mediaSourceReason?: string\n  /** ACS disconnect diagnostics, emitted when the final disconnected state arrives. */\n  endReason_code?: number\n  endReason_subcode?: number\n  /** Local WHIP endpoint, available after a SoftAP join. */\n  ingestUrl?: string\n  /** Remote roster (Android emits this; iOS does not yet). */\n  participants?: AcsMeetingParticipant[]\n}\n\nexport type AcsOutgoingVideo = {\n  width: number\n  height: number\n  fps: number\n  maxBitrateBps: number\n}\n\nexport type AcsMeetingJoinOptions = {\n  meetingUrl: string\n  token: string\n  whepUrl?: string\n  videoSource?: {type: \"whep\"; url: string} | {type: \"softap\"; bindAddress: string}\n  displayName?: string\n  /** \"glasses\" sends WHEP PCM. \"phone\" uses the ACS local mic (handset or BT). */\n  audioSource?: AcsAudioSource\n  /**\n   * Hold outgoing PCM this many ms before ACS. SoftAP+LC3 sets this in the host\n   * because BLE audio reaches the phone before SoftAP video.\n   */\n  audioDelayMs?: number\n  /** Dump WHEP PCM to a WAV in cache for P4 verification. */\n  dumpPcmWav?: boolean\n  /** When omitted, native keeps 1280×720@15 / 2.5 Mbps. */\n  video?: AcsOutgoingVideo\n}\n\nexport type AcsIncomingPcmEvent = {\n  base64: string\n  sampleRate: number\n  channels: number\n}\n\nexport type AcsMeetingModuleEvents = {\n  onState: (state: AcsMeetingState) => void\n  onIncomingPcm: (pcm: AcsIncomingPcmEvent) => void\n}\n"]}

package/build/AcsMeetingModule.d.ts

@@ -24,8 +24,16 @@ declare class AcsMeetingNativeModule extends NativeModule<AcsMeetingModuleEvents
     restartVideoSource(): Promise<void>;
     /** SoftAP: join the glasses hotspot; resolves to the phone's IPv4 on it. */
     joinScopedNetwork(ssid: string, passphrase: string): Promise<string>;
+    /** iOS: verify DHCP against the gateway advertised by the glasses before resolving. */
+    joinScopedNetworkWithGateway?(ssid: string, passphrase: string, gateway: string): Promise<string>;
     beginTrace(traceId: string): Promise<void>;
     leaveScopedNetwork(): Promise<void>;
+    cancelScopedNetworkJoin?(): Promise<void>;
+    awaitDefaultNetworkAfterHotspot?(): Promise<{
+        usable: boolean;
+        detail: string;
+        transport: string;
+    }>;
     /** SoftAP: TCP-probe the hotspot gateway over the scoped network. */
     probeScopedGateway(): Promise<{
         reachable: boolean;

package/build/AcsMeetingModule.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AcsMeetingModule.d.ts","sourceRoot":"","sources":["../src/AcsMeetingModule.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,YAAY,EAAsB,MAAM,MAAM,CAAA;AAEtD,OAAO,KAAK,EAAC,qBAAqB,EAAE,sBAAsB,EAAE,eAAe,EAAC,MAAM,oBAAoB,CAAA;AAEtG,OAAO,OAAO,sBAAuB,SAAQ,YAAY,CAAC,sBAAsB,CAAC;IAC/E,IAAI,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,eAAe,CAAC;IAC9D,iFAAiF;IACjF,YAAY,CAAC,OAAO,EAAE;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAC,GAAG,OAAO,CAAC,eAAe,CAAC;IACtF,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IACtB;;;OAGG;IACH,aAAa,CAAC,OAAO,EAAE;QAAC,SAAS,EAAE,MAAM,CAAA;KAAC,GAAG,OAAO,CAAC;QAAC,SAAS,EAAE,OAAO,CAAA;KAAC,CAAC;IAC1E,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,eAAe,CAAC;IAClD,cAAc,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,GAAG,OAAO,CAAC,eAAe,CAAC;IACrE,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IACjD,wEAAwE;IACxE,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC;IACnC,4EAA4E;IAC5E,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IACpE,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAC1C,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC;IACnC,qEAAqE;IACrE,kBAAkB,IAAI,OAAO,CAAC;QAAC,SAAS,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAC,CAAC;IACnE,QAAQ,IAAI,OAAO,CAAC,eAAe,CAAC;CACrC;;AAED,wBAA8E"}
+{"version":3,"file":"AcsMeetingModule.d.ts","sourceRoot":"","sources":["../src/AcsMeetingModule.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,YAAY,EAAsB,MAAM,MAAM,CAAA;AAEtD,OAAO,KAAK,EAAC,qBAAqB,EAAE,sBAAsB,EAAE,eAAe,EAAC,MAAM,oBAAoB,CAAA;AAEtG,OAAO,OAAO,sBAAuB,SAAQ,YAAY,CAAC,sBAAsB,CAAC;IAC/E,IAAI,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,eAAe,CAAC;IAC9D,iFAAiF;IACjF,YAAY,CAAC,OAAO,EAAE;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAC,GAAG,OAAO,CAAC,eAAe,CAAC;IACtF,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IACtB;;;OAGG;IACH,aAAa,CAAC,OAAO,EAAE;QAAC,SAAS,EAAE,MAAM,CAAA;KAAC,GAAG,OAAO,CAAC;QAAC,SAAS,EAAE,OAAO,CAAA;KAAC,CAAC;IAC1E,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,eAAe,CAAC;IAClD,cAAc,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,GAAG,OAAO,CAAC,eAAe,CAAC;IACrE,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IACjD,wEAAwE;IACxE,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC;IACnC,4EAA4E;IAC5E,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IACpE,uFAAuF;IACvF,4BAA4B,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IACjG,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAC1C,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC;IACnC,uBAAuB,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC;IACzC,+BAA+B,CAAC,IAAI,OAAO,CAAC;QAAC,MAAM,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAC,CAAC;IACjG,qEAAqE;IACrE,kBAAkB,IAAI,OAAO,CAAC;QAAC,SAAS,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAC,CAAC;IACnE,QAAQ,IAAI,OAAO,CAAC,eAAe,CAAC;CACrC;;AAED,wBAA8E"}

package/build/AcsMeetingModule.js.map

@@ -1 +1 @@
-{"version":3,"file":"AcsMeetingModule.js","sourceRoot":"","sources":["../src/AcsMeetingModule.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,mBAAmB,EAAC,MAAM,MAAM,CAAA;AA4BtD,eAAe,mBAAmB,CAAyB,kBAAkB,CAAC,CAAA","sourcesContent":["import {NativeModule, requireNativeModule} from \"expo\"\n\nimport type {AcsMeetingJoinOptions, AcsMeetingModuleEvents, AcsMeetingState} from \"./AcsMeeting.types\"\n\ndeclare class AcsMeetingNativeModule extends NativeModule<AcsMeetingModuleEvents> {\n  join(options: AcsMeetingJoinOptions): Promise<AcsMeetingState>\n  /** Sign in to ACS before SoftAP so Teams is not resolved through glasses DNS. */\n  prepareAgent(options: {token: string; displayName?: string}): Promise<AcsMeetingState>\n  leave(): Promise<void>\n  /**\n   * Leave, and resolve only once the hang-up, the agent disposal, and the network releases have\n   * finished. Use this explicit barrier across platforms; Android `leave()` only queues cleanup.\n   */\n  leaveAndAwait(options: {timeoutMs: number}): Promise<{completed: boolean}>\n  setMuted(muted: boolean): Promise<AcsMeetingState>\n  setAudioSource(source: \"glasses\" | \"phone\"): Promise<AcsMeetingState>\n  updateVideoSource(whepUrl: string): Promise<void>\n  /** Force a WHEP rebuild on the current URL (phone changed networks). */\n  restartVideoSource(): Promise<void>\n  /** SoftAP: join the glasses hotspot; resolves to the phone's IPv4 on it. */\n  joinScopedNetwork(ssid: string, passphrase: string): Promise<string>\n  beginTrace(traceId: string): Promise<void>\n  leaveScopedNetwork(): Promise<void>\n  /** SoftAP: TCP-probe the hotspot gateway over the scoped network. */\n  probeScopedGateway(): Promise<{reachable: boolean; detail: string}>\n  getState(): Promise<AcsMeetingState>\n}\n\nexport default requireNativeModule<AcsMeetingNativeModule>(\"MentraAcsMeeting\")\n"]}
+{"version":3,"file":"AcsMeetingModule.js","sourceRoot":"","sources":["../src/AcsMeetingModule.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,mBAAmB,EAAC,MAAM,MAAM,CAAA;AAgCtD,eAAe,mBAAmB,CAAyB,kBAAkB,CAAC,CAAA","sourcesContent":["import {NativeModule, requireNativeModule} from \"expo\"\n\nimport type {AcsMeetingJoinOptions, AcsMeetingModuleEvents, AcsMeetingState} from \"./AcsMeeting.types\"\n\ndeclare class AcsMeetingNativeModule extends NativeModule<AcsMeetingModuleEvents> {\n  join(options: AcsMeetingJoinOptions): Promise<AcsMeetingState>\n  /** Sign in to ACS before SoftAP so Teams is not resolved through glasses DNS. */\n  prepareAgent(options: {token: string; displayName?: string}): Promise<AcsMeetingState>\n  leave(): Promise<void>\n  /**\n   * Leave, and resolve only once the hang-up, the agent disposal, and the network releases have\n   * finished. Use this explicit barrier across platforms; Android `leave()` only queues cleanup.\n   */\n  leaveAndAwait(options: {timeoutMs: number}): Promise<{completed: boolean}>\n  setMuted(muted: boolean): Promise<AcsMeetingState>\n  setAudioSource(source: \"glasses\" | \"phone\"): Promise<AcsMeetingState>\n  updateVideoSource(whepUrl: string): Promise<void>\n  /** Force a WHEP rebuild on the current URL (phone changed networks). */\n  restartVideoSource(): Promise<void>\n  /** SoftAP: join the glasses hotspot; resolves to the phone's IPv4 on it. */\n  joinScopedNetwork(ssid: string, passphrase: string): Promise<string>\n  /** iOS: verify DHCP against the gateway advertised by the glasses before resolving. */\n  joinScopedNetworkWithGateway?(ssid: string, passphrase: string, gateway: string): Promise<string>\n  beginTrace(traceId: string): Promise<void>\n  leaveScopedNetwork(): Promise<void>\n  cancelScopedNetworkJoin?(): Promise<void>\n  awaitDefaultNetworkAfterHotspot?(): Promise<{usable: boolean; detail: string; transport: string}>\n  /** SoftAP: TCP-probe the hotspot gateway over the scoped network. */\n  probeScopedGateway(): Promise<{reachable: boolean; detail: string}>\n  getState(): Promise<AcsMeetingState>\n}\n\nexport default requireNativeModule<AcsMeetingNativeModule>(\"MentraAcsMeeting\")\n"]}

package/ios/AcsMeetingModule.swift

@@ -21,6 +21,18 @@ public class AcsMeetingModule: Module {
         return session
     }
 
+    private func joinHotspot(ssid: String, passphrase: String, gateway: String?, promise: Promise) {
+        hotspot.onLost = { [weak self] reason in
+            self?.sendEvent("onScopedNetworkLost", ["code": "SOFTAP_LOST", "message": reason])
+        }
+        hotspot.join(ssid: ssid, passphrase: passphrase, gateway: gateway) { result in
+            switch result {
+            case let .success(address): promise.resolve(address)
+            case let .failure(error): promise.reject(error)
+            }
+        }
+    }
+
     public func definition() -> ModuleDefinition {
         Name("MentraAcsMeeting")
         Events("onState", "onIncomingPcm", "onScopedNetworkLost")
@@ -57,25 +69,30 @@ public class AcsMeetingModule: Module {
         }
 
         AsyncFunction("joinScopedNetwork") { (ssid: String, passphrase: String, promise: Promise) in
-            self.hotspot.onLost = { [weak self] reason in
-                self?.sendEvent("onScopedNetworkLost", ["code": "SOFTAP_LOST", "message": reason])
-            }
-            self.hotspot.join(ssid: ssid, passphrase: passphrase) { result in
-                switch result {
-                case let .success(address): promise.resolve(address)
-                case let .failure(error): promise.reject(error)
-                }
-            }
+            self.joinHotspot(ssid: ssid, passphrase: passphrase, gateway: nil, promise: promise)
+        }
+
+        AsyncFunction("joinScopedNetworkWithGateway") { (ssid: String, passphrase: String, gateway: String, promise: Promise) in
+            self.joinHotspot(ssid: ssid, passphrase: passphrase, gateway: gateway, promise: promise)
         }
 
         AsyncFunction("leaveScopedNetwork") { (promise: Promise) in
             self.hotspot.leave { promise.resolve(nil) }
         }
 
+        AsyncFunction("cancelScopedNetworkJoin") { (promise: Promise) in
+            self.hotspot.leave { promise.resolve(nil) }
+        }
+
+        AsyncFunction("awaitDefaultNetworkAfterHotspot") { (promise: Promise) in
+            self.hotspot.awaitInternet(requireCellular: false) { usable, detail in
+                promise.resolve(["usable": usable, "detail": detail, "transport": usable ? detail : "unknown", "validated": usable, "present": usable])
+            }
+        }
+
         AsyncFunction("beginTrace") { (traceId: String) in
             NSLog("SOFTAP_TRACE trace=\(traceId) stage=ios_begin")
         }
-
         AsyncFunction("probeScopedGateway") { (promise: Promise) in
             self.hotspot.probeGateway { reachable, detail in
                 promise.resolve(["reachable": reachable, "detail": detail])
@@ -188,6 +205,7 @@ final class AcsMeetingSession {
     private var muted = false
     private var meetingUrl: String?
     private var lastError: String?
+    private var callEndReason: (code: Int, subcode: Int)?
     private var callClient: CallClient?
     private var callAgent: CallAgent?
     private var call: Call?
@@ -213,6 +231,7 @@ final class AcsMeetingSession {
     // Health of the glasses WHEP feed, reported alongside the ACS phase so the host
     // can tell "call is up, glasses video is dead" from a healthy call.
     private var mediaSource: SourceState = .idle
+    private var mediaSourceReason: String?
     private var mediaRestartAttempts = 0
     private var mediaRestartTask: DispatchWorkItem?
     private static let mediaRestartBaseMs = 1000
@@ -254,8 +273,13 @@ final class AcsMeetingSession {
         }
         result["capabilities"] = ["hangUpForEveryone": hangUp]
         if let ingestUrl = media?.ingestUrl { result["ingestUrl"] = ingestUrl }
+        if let mediaSourceReason { result["mediaSourceReason"] = mediaSourceReason }
         if let meetingUrl { result["meetingUrl"] = meetingUrl }
         if let lastError { result["error"] = lastError }
+        if let callEndReason {
+            result["endReason_code"] = callEndReason.code
+            result["endReason_subcode"] = callEndReason.subcode
+        }
         return result
     }
 
@@ -319,6 +343,7 @@ final class AcsMeetingSession {
             self.audioSource = AcsAudioPolicy.parseSource(audioSource) == .phone ? "phone" : "glasses"
             self.meetingUrl = meetingUrl
             self.lastError = nil
+            self.callEndReason = nil
             self.emit("connecting")
             let useAgent: (CallAgent) -> Void = { agent in
                 do { try self.joinWithAgentLocked(agent, generation: generation, meetingUrl: meetingUrl,
@@ -508,6 +533,9 @@ final class AcsMeetingSession {
                 guard self.joinGeneration == generation, self.media === source else { return }
                 switch result {
                 case .success:
+                    // The SDK may have changed state before its delegate was attached.
+                    // Reading it here also makes the join result reflect admission already granted.
+                    self.refreshCallStateLocked(call)
                     let reply = self.pendingJoin
                     self.pendingJoin = nil
                     reply?(.success(self.snapshot()))
@@ -559,6 +587,7 @@ final class AcsMeetingSession {
     private func onMediaSourceState(_ state: SourceState, reason: String) {
         let previous = mediaSource
         mediaSource = state
+        mediaSourceReason = reason
         if state == .live { mediaRestartAttempts = 0 }
         if state == .failed { scheduleMediaRestart(reason: reason) }
         // start() emits idle then connecting back to back; one snapshot per real change.
@@ -787,6 +816,7 @@ final class AcsMeetingSession {
         media?.onFrame = nil
         media?.onPcm = nil
         mediaSource = .idle
+        mediaSourceReason = nil
         if let local = media as? LocalWhipIngestSource {
             cleanup.enter()
             local.stop { self.cleanup.leave() }
@@ -832,6 +862,7 @@ final class AcsMeetingSession {
         // carries it and the call delegate keeps ignoring late disconnected callbacks.
         if emitIdle {
             lastError = nil
+            callEndReason = nil
             emit("idle")
         }
     }
@@ -851,15 +882,33 @@ final class AcsMeetingSession {
     private func handleCallStateChange(_ changedCall: Call) {
         queue.async {
             guard self.call === changedCall, self.lastError == nil else { return }
-            switch changedCall.state {
-            case .connecting: self.emit("connecting")
-            case .inLobby: self.emit("lobby")
-            case .connected:
-                self.emit("connected")
-                self.applyAudioPolicyOnQueue("call-connected")
-            case .disconnecting, .disconnected: self.emit("disconnected")
-            default: break
+            self.refreshCallStateLocked(changedCall)
+        }
+    }
+
+    private func refreshCallStateLocked(_ changedCall: Call) {
+        switch changedCall.state {
+        case .connecting: emit("connecting")
+        case .inLobby: emit("lobby")
+        case .connected:
+            emit("connected")
+            applyAudioPolicyOnQueue("call-connected")
+        case .disconnected:
+            let reason = changedCall.callEndReason
+            callEndReason = (Int(reason.code), Int(reason.subcode))
+            if phase == "connecting" || phase == "lobby" {
+                let error = AcsMeetingError("The Teams call ended before admission (ACS \(reason.code)/\(reason.subcode))")
+                if pendingJoin != nil {
+                    failJoinLocked(error, generation: joinGeneration)
+                    return
+                }
+                lastError = error.localizedDescription
             }
+            emit("disconnected")
+        // The final reason is only available at disconnected. Reporting disconnecting as
+        // terminal makes the host dispose the call before that diagnostic can arrive.
+        case .disconnecting: break
+        default: break
         }
     }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mentra/acs-meeting",
-  "version": "3.2.0-dev.226",
+  "version": "3.2.0-dev.232",
   "description": "MentraOS native ACS Teams meeting module (WHEP decode → ACS raw media)",
   "main": "build/index.js",
   "react-native": "src/index.ts",
@@ -32,7 +32,7 @@
   },
   "dependencies": {
     "@expo/config-plugins": "~55.0.10",
-    "@mentra/glasses-media": "3.2.0-dev.226"
+    "@mentra/glasses-media": "3.2.0-dev.232"
   },
   "devDependencies": {
     "expo-module-scripts": "^55.0.2",

package/src/AcsMeeting.types.ts

@@ -30,6 +30,11 @@ export type AcsMeetingState = {
   activeStream?: AcsActiveStream
   audioSafety?: AcsAudioSafety
   mediaSource?: AcsMediaSourceState
+  /** Native receiver diagnostic, including the reason a local WHIP offer was rejected. */
+  mediaSourceReason?: string
+  /** ACS disconnect diagnostics, emitted when the final disconnected state arrives. */
+  endReason_code?: number
+  endReason_subcode?: number
   /** Local WHIP endpoint, available after a SoftAP join. */
   ingestUrl?: string
   /** Remote roster (Android emits this; iOS does not yet). */

package/src/AcsMeetingModule.ts

@@ -19,8 +19,12 @@ declare class AcsMeetingNativeModule extends NativeModule<AcsMeetingModuleEvents
   restartVideoSource(): Promise<void>
   /** SoftAP: join the glasses hotspot; resolves to the phone's IPv4 on it. */
   joinScopedNetwork(ssid: string, passphrase: string): Promise<string>
+  /** iOS: verify DHCP against the gateway advertised by the glasses before resolving. */
+  joinScopedNetworkWithGateway?(ssid: string, passphrase: string, gateway: string): Promise<string>
   beginTrace(traceId: string): Promise<void>
   leaveScopedNetwork(): Promise<void>
+  cancelScopedNetworkJoin?(): Promise<void>
+  awaitDefaultNetworkAfterHotspot?(): Promise<{usable: boolean; detail: string; transport: string}>
   /** SoftAP: TCP-probe the hotspot gateway over the scoped network. */
   probeScopedGateway(): Promise<{reachable: boolean; detail: string}>
   getState(): Promise<AcsMeetingState>