Add VoIP calling capabilties to fishjam

[Magmusacy]

Description

Adds VoIP calling to the fork: native system call UI on both platforms, VoIP push delivery, and a single cross-platform JS API on top of them.

iOS — CallKit + PushKit

• VoIP push registration and token delivery (getVoIPToken); an incoming call is reported to CallKit straight from the push payload, so the phone rings with the app killed.
• Answer handshake: the native answer action is parked until JS reports media is live (fulfillIncomingCallConnected / failIncomingCallConnected), with a native timeout that tears the call down instead of leaving a stuck "Connecting…".
• Outgoing calls with ringback (DialtonePlayer) and reportOutgoingCallConnected to start the system call timer.
• Hold, mute, call waiting, and redial from Recents (getPendingCallIntent → onCallIntent).

Android — Telecom + FCM

• CallManager / TelecomController built on androidx.core:core-telecom: self-managed calls, system audio routing, and DisconnectCause mapping so calls land correctly in the call log.
• PushNotificationService receives FCM data messages and relays anything that isn't a VoIP push to the app's own messaging service, so an existing FCM library keeps working alongside it.
• Full-screen IncomingCallActivity over the lock screen, heads-up call notification with caller avatar (AvatarLoader), and a foreground service for the connected call.

Shared JS API

• useVoIPEvents({ onIncoming, onAnswered, onEnded, onRegistered, onHeldChanged, onMuteChanged, onCallIntent, onWaitingCallDeclined }) — one hook, same events on both platforms, with pending call/answer buffering so a cold start triggered by a call still delivers them.
• Platform-agnostic helpers in src/VoIP.ts: getVoIPToken, setCallHeld, setCallMuted, isCallHeld, reportOutgoingCallConnected.
• Unified CallEndedReason: local | rejected | missed | remote | answeredElsewhere | failed.

Motivation and Context

A calling app has to ring when it isn't running, show the OS call UI, respect audio routing and interop with other calls, and appear in the call log. Only CallKit and Telecom can do that, and they have to be driven from the same native module that owns the WebRTC audio session — so the integration belongs here rather than in a separate library.

Documentation impact

• Documentation update required
• Documentation updated in another PR — usage guides and the runnable voip-call example ship with the web-client-sdk PR
• No documentation update required

Types of changes

• Bug fix (non-breaking change which fixes an issue)
• New feature (non-breaking change which adds functionality)
• Breaking change (fix or feature that would cause existing functionality to not work as expected)

[Copilot]

Pull request overview

This PR adds end-to-end VoIP calling support to the Fishjam React Native WebRTC module by bridging native call UIs and VoIP push handling across iOS (CallKit + PushKit + Siri Recents intent) and Android (Core-Telecom + FCM), and exposing a unified JS API/events layer.

Changes:

• Introduces a new cross-platform JS VoIP surface (VoIP.ts, Telecom.ts, hooks) for tokens, buffered incoming calls, answer fulfillment, hold/mute, and call intent handling.
• Expands iOS CallKit/PushKit integration with buffered call intents, hold/mute controls, answer-fulfillment timeouts, ringback audio, and richer end reasons.
• Adds Android Core-Telecom call lifecycle, call-style notifications + full-screen UI, VoIP FCM service/relay, and foreground-service integration.

Reviewed changes

Copilot reviewed 43 out of 43 changed files in this pull request and generated 2 comments.

Show a summary per file

File	Description
src/VoIP.ts	New cross-platform VoIP JS API (token, pending calls/intents, answer fulfillment, hold/mute, outgoing connected).
src/useVoIPEvents.ts	Expands VoIP event hook to support Android Telecom events, call intents, hold/mute, end reasons, and answer request IDs.
src/useTelecom.ts	New Android-only Telecom hook and event hook wrapper.
src/useCallKit.ts	Extends CallKit hook API to support end reasons + hold state; adjusts service config typing.
src/Telecom.ts	New Android Telecom JS bridge (start/end/hold/answered/active/pending request id).
src/PushKit.ts	Removes legacy iOS-only PushKit helper surface (replaced by VoIP.ts).
src/index.ts	Re-exports new VoIP/Telecom APIs, hooks, and types from the package entrypoint.
src/EventEmitter.ts	Registers the new telecomActionPerformed native event (Android-only).
src/CallKit.ts	Extends iOS CallKit JS bridge with handle support, end reasons, answer fulfillment, hold/mute, and pending answer request ID.
ios/RCTWebRTC/WebRTCModule+PushKit.m	Renames/updates PushKit module integration to VoIPManager, adds waiting-declined + call-intent events and new native getters/clearers.
ios/RCTWebRTC/WebRTCModule+CallKit.m	Extends native CallKit module methods for handle, end reason, fulfill/fail answer, outgoing connected, hold/mute, and pending request ID.
ios/RCTWebRTC/WebRTCModule.m	Updates exported event constant name for VoIP push event.
ios/RCTWebRTC/WebRTCModule.h	Renames VoIP push event constant symbol (string remains "voipPushEvent").
ios/RCTWebRTC/VoIPManager.m	New PushKit + Siri Recents intent manager with buffering and waiting-call behavior.
ios/RCTWebRTC/VoipManager.m	Removes old PushKit manager implementation.
ios/RCTWebRTC/VoIPManager.h	New header for VoIPManager including call intent and waiting-call declined support.
ios/RCTWebRTC/VoipManager.h	Removes old VoipManager header.
ios/RCTWebRTC/FulfillRequestManager.m	New request/timeout manager for deferring CallKit answer fulfillment until media is live.
ios/RCTWebRTC/FulfillRequestManager.h	Header for fulfill-request manager and result enum.
ios/RCTWebRTC/DialtonePlayer.m	Adds synthesized ringback playback for outgoing calls during CallKit audio session activation.
ios/RCTWebRTC/DialtonePlayer.h	Dialtone player interface documentation and API.
ios/RCTWebRTC/CallKitManager.m	Major CallKit lifecycle enhancements: waiting calls, timeouts, end reasons, fulfill/timeout answer, hold/mute, ringback, and cleanup logic.
ios/RCTWebRTC/CallKitManager.h	Updates CallKit manager public API for handles, end reasons, waiting slots, hold/mute, and pending answer request ID.
FishjamReactNativeWebrtc.podspec	Enables DEFINES_MODULE to support Swift module import by downstream pods.
android/src/main/java/com/oney/WebRTCModule/WebRTCModule.java	Wires new TelecomController/VoIPController and exposes new ReactMethods for Telecom/VoIP.
android/src/main/java/com/oney/WebRTCModule/VoIPController.java	Bridges VoIP token/incoming/waiting-declined events and pending-call buffering to JS.
android/src/main/java/com/oney/WebRTCModule/voip/VoIPPushRegistry.kt	Process-wide registry buffering VoIP token + incoming/waiting call payloads (killed-state safe).
android/src/main/java/com/oney/WebRTCModule/voip/VoIPForegroundServiceController.kt	Maps call state transitions to foreground-service requests.
android/src/main/java/com/oney/WebRTCModule/voip/VoIPForegroundRequest.java	Immutable model for call-driven foreground-service requirements.
android/src/main/java/com/oney/WebRTCModule/voip/PushNotificationService.kt	New FCM messaging service handling VoIP pushes + relaying non-VoIP traffic to a fallback service.
android/src/main/java/com/oney/WebRTCModule/voip/LockScreenController.kt	Enables showing the host activity over the lockscreen after answering.
android/src/main/java/com/oney/WebRTCModule/voip/IncomingCallActivity.kt	Full-screen incoming-call UI (programmatic layout) + swipe answer/decline + avatar updates.
android/src/main/java/com/oney/WebRTCModule/voip/FulfillRequestManager.kt	Kotlin counterpart for answer-fulfillment timeout management.
android/src/main/java/com/oney/WebRTCModule/voip/EndCallNotificationReceiver.kt	Handles notification actions (decline/hangup/answer waiting) without launching an activity.
android/src/main/java/com/oney/WebRTCModule/voip/DialtonePlayer.kt	Outgoing ringback playback using ToneGenerator on voice-call stream.
android/src/main/java/com/oney/WebRTCModule/voip/CallNotificationManager.kt	Builds incoming/ongoing/waiting CallStyle notifications and vibration behavior.
android/src/main/java/com/oney/WebRTCModule/voip/CallManager.kt	Core-Telecom call registration, lifecycle handling, timeouts, endpoints, notifications, avatars, and JS event dispatch.
android/src/main/java/com/oney/WebRTCModule/voip/AvatarLoader.kt	Downloads and circular-crops caller avatars off-main-thread for notifications/UI.
android/src/main/java/com/oney/WebRTCModule/TelecomController.java	Bridges CallManager lifecycle events and commands to React Native + lockscreen behavior.
android/src/main/java/com/oney/WebRTCModule/foregroundService/WebRTCForegroundService.java	Posts CallStyle ongoing notification via FGS when a VoIP call is active.
android/src/main/java/com/oney/WebRTCModule/foregroundService/ForegroundServiceController.java	Merges VoIP foreground requirements with existing camera/mic/screen-share requirements.
android/src/main/java/com/oney/WebRTCModule/AudioOutputManager.java	Adds Telecom-aware endpoint routing + selection confirmation when Telecom owns audio.
android/build.gradle	Enables Kotlin Android plugin, sets Kotlin JVM target, and adds core-telecom + messaging dependencies.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.