export type MeetingPhase = "idle" | "connecting" | "lobby" | "connected" | "disconnected" | "error"

export type AcsAudioSource = "glasses" | "phone"
export type AcsActiveStream = "none" | "virtual" | "local"
export type AcsAudioSafety = "safe" | "degraded" | "unsafe"
/**
 * Health of the glasses WHEP subscription feeding the call. `failed` = ICE dropped or
 * the WHEP endpoint went away while the ACS call may still be `connected`. Native
 * rebuilds it on its own with backoff; the host can force one via `restartVideoSource`.
 */
export type AcsMediaSourceState = "idle" | "connecting" | "live" | "failed"

export type AcsMeetingParticipantState = "idle" | "connecting" | "connected" | "lobby" | "hold" | "disconnected"

export type AcsMeetingParticipant = {
  id: string
  displayName: string | null
  state: AcsMeetingParticipantState
  isMuted: boolean
  isSpeaking: boolean
}

export type AcsMeetingState = {
  state: MeetingPhase
  muted: boolean
  /** Whether ACS is sending the glasses camera. Resets to true on every join. */
  videoEnabled?: boolean
  error?: string
  meetingUrl?: string
  provider?: "acs-teams"
  audioSource?: AcsAudioSource
  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 or `rebindSoftApIngest`. */
  ingestUrl?: string
  /** Remote roster, including participant state, mute state and speaking updates. */
  participants?: AcsMeetingParticipant[]
}

export type AcsOutgoingVideo = {
  width: number
  height: number
  fps: number
  maxBitrateBps: number
}

export type AcsMeetingJoinOptions = {
  meetingUrl: string
  token: string
  identityMode?: "guest" | "teams-user"
  whepUrl?: string
  videoSource?: {type: "whep"; url: string} | {type: "softap"; bindAddress: string}
  displayName?: string
  /** "glasses" sends WHEP PCM. "phone" uses the ACS local mic (handset or BT). */
  audioSource?: AcsAudioSource
  /**
   * Hold outgoing PCM this many ms before ACS. SoftAP+LC3 sets this in the host
   * because BLE audio reaches the phone before SoftAP video.
   */
  audioDelayMs?: number
  /** Dump WHEP PCM to a WAV in cache for P4 verification. */
  dumpPcmWav?: boolean
  /** When omitted, native keeps 1280×720@15 / 2.5 Mbps. */
  video?: AcsOutgoingVideo
}

export type AcsIncomingPcmEvent = {
  base64: string
  sampleRate: number
  channels: number
}

export type AcsMeetingModuleEvents = {
  onState: (state: AcsMeetingState) => void
  onIncomingPcm: (pcm: AcsIncomingPcmEvent) => void
}