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

package/build/AcsMeeting.types.d.ts

@@ -26,6 +26,8 @@ export type AcsMeetingState = {
     activeStream?: AcsActiveStream;
     audioSafety?: AcsAudioSafety;
     mediaSource?: AcsMediaSourceState;
+    /** Native receiver diagnostic, including the reason a local WHIP offer was rejected. */
+    mediaSourceReason?: string;
     /** 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,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  /** 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,6 +24,8 @@ 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>;
     /** SoftAP: TCP-probe the hotspot gateway over the scoped network. */

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,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;AA8BtD,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  /** 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,17 +69,14 @@ 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) }
         }
@@ -75,7 +84,6 @@ public class AcsMeetingModule: Module {
         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])
@@ -213,6 +221,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,6 +263,7 @@ 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 }
         return result
@@ -559,6 +569,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 +798,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() }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mentra/acs-meeting",
-  "version": "3.2.0-dev.226",
+  "version": "3.2.0-dev.227",
   "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.227"
   },
   "devDependencies": {
     "expo-module-scripts": "^55.0.2",

package/src/AcsMeeting.types.ts

@@ -30,6 +30,8 @@ export type AcsMeetingState = {
   activeStream?: AcsActiveStream
   audioSafety?: AcsAudioSafety
   mediaSource?: AcsMediaSourceState
+  /** Native receiver diagnostic, including the reason a local WHIP offer was rejected. */
+  mediaSourceReason?: string
   /** Local WHIP endpoint, available after a SoftAP join. */
   ingestUrl?: string
   /** Remote roster (Android emits this; iOS does not yet). */

package/src/AcsMeetingModule.ts

@@ -19,6 +19,8 @@ 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>
   /** SoftAP: TCP-probe the hotspot gateway over the scoped network. */