@voltkit-rtc/react-native 0.0.0-stage → 0.1.0

package/android/src/main/java/com/voltkit/rtc/reactnative/VoltkitRtcModule.kt

@@ -0,0 +1,313 @@
+package com.voltkit.rtc.reactnative
+
+import android.Manifest
+import android.content.Context
+import android.content.Intent
+import android.content.pm.PackageManager
+import android.os.Build
+import android.os.Handler
+import android.os.Looper
+import androidx.core.content.ContextCompat
+import com.facebook.react.bridge.Arguments
+import com.facebook.react.bridge.Promise
+import com.facebook.react.bridge.ReactApplicationContext
+import com.facebook.react.bridge.ReadableMap
+import com.facebook.react.bridge.WritableArray
+import com.facebook.react.bridge.WritableMap
+import com.oney.WebRTCModule.MediaProjectionService
+import com.oney.WebRTCModule.WebRTCModuleOptions
+import org.webrtc.audio.JavaAudioDeviceModule
+import java.util.concurrent.atomic.AtomicBoolean
+import java.util.concurrent.atomic.AtomicInteger
+
+/**
+ * The TurboModule behind src/specs/NativeVoltkitRtc.ts (plan §5.1): audio routing ([AudioRouter]), the call service
+ * ([VoltkitCallService]), native timers ([NativeTimers]), visibility ([AppVisibility]), the network ([NetworkWatch])
+ * and stopping react-native-webrtc's screen-share service once a share ends (Phase 0 finding 5).
+ *
+ * When the React instance goes away (a reload, the app closing), [invalidate] lets go of everything this instance
+ * holds: its audio holders, timers, watchers and the call service, since the JavaScript that ran the call is gone.
+ * Rejections carry a VoltKit error registry code (`bad-params`, `media-unavailable`) as their code.
+ */
+class VoltkitRtcModule(reactContext: ReactApplicationContext) : NativeVoltkitRtcSpec(reactContext) {
+    private val app: Context = reactContext.applicationContext
+    private val config = VoltkitRtcInitProvider.configOf(app)
+    private val main = Handler(Looper.getMainLooper())
+
+    // --- audio ---------------------------------------------------------------------------------------------------
+    private val router: AudioRouter by lazy { AudioRouter.get(app, config.audioMode).also { it.addListener(audioListener) } }
+    private val holders = HashMap<Int, Any>()
+    private val nextHolder = AtomicInteger(0)
+    private val audioListener = object : AudioRouter.Listener {
+        override fun onDevicesChanged(change: DevicesChanged) {
+            emitOnAudioDevicesChanged(
+                Arguments.createMap().apply {
+                    putArray("devices", devicesArray(change.devices))
+                    putArray("added", devicesArray(change.added))
+                    putArray("removed", devicesArray(change.removed))
+                },
+            )
+        }
+
+        override fun onOutputChanged(device: MediaDevice?) {
+            emitOnAudioOutputChanged(Arguments.createMap().apply { putDevice("device", device) })
+        }
+
+        override fun onFocusChanged(focus: String) {
+            emitOnAudioFocusChanged(Arguments.createMap().apply { putString("focus", focus) })
+        }
+    }
+    private val microphoneError: (String) -> Unit = { message ->
+        emitOnMicrophoneError(Arguments.createMap().apply { putString("message", message) })
+    }
+
+    // --- timers, visibility, network, the call service --------------------------------------------------------------
+    private val timerThread = HandlerScheduler("VoltKitTimers")
+    private val timers = NativeTimers(timerThread) { id -> emitOnTimer(id) }
+    private val network = NetworkWatch(app) { handover ->
+        emitOnNetworkAvailable(Arguments.createMap().apply { putBoolean("handover", handover) })
+    }
+    private val stopVisibility: () -> Unit = AppVisibility.watch { visible ->
+        emitOnAppVisibilityChanged(Arguments.createMap().apply { putBoolean("visible", visible) })
+    }
+    private val callServiceListener = VoltkitCallService.Listener { type, types, message ->
+        emitOnCallServiceEvent(
+            Arguments.createMap().apply {
+                putString("type", type)
+                putArray("types", Arguments.fromList(CallServiceTypes.names(types)))
+                putString("message", message)
+            },
+        )
+    }
+    private val invalidated = AtomicBoolean(false)
+
+    init {
+        network.start()
+        VoltkitRtcInitProvider.microphoneErrors.add(microphoneError)
+        VoltkitCallService.listeners.add(callServiceListener)
+    }
+
+    override fun getTypedExportedConstants(): MutableMap<String, Any> {
+        val declared = VoltkitCallService.declaredTypes(app)
+        return hashMapOf(
+            "audioMode" to config.audioMode.name,
+            "hardwareEchoCancellation" to config.hardwareEchoCancellation,
+            "screenShareEnabled" to (config.screenShare || WebRTCModuleOptions.getInstance().enableMediaProjectionService),
+            "callServiceDeclared" to (declared != null),
+            "callServiceTypes" to CallServiceTypes.names(declared ?: 0),
+            "sdkInt" to Build.VERSION.SDK_INT,
+            "nativeVersion" to BuildConfig.VOLTKIT_RTC_VERSION,
+            // True only while react-native-webrtc uses the module the init provider made (the audio mode and HW_AEC apply).
+            "audioDeviceModule" to VoltkitRtcInitProvider.audioDeviceModule.let {
+                it != null && it === WebRTCModuleOptions.getInstance().audioDeviceModule
+            },
+        )
+    }
+
+    // --- audio ---------------------------------------------------------------------------------------------------
+
+    override fun audioAcquire(speakerphone: Boolean?, promise: Promise) {
+        val id = nextHolder.incrementAndGet()
+        val token = Any()
+        synchronized(holders) { holders[id] = token }
+        router.acquire(token, speakerphone) { promise.resolve(id) }
+    }
+
+    override fun audioRelease(holder: Double) {
+        val token = synchronized(holders) { holders.remove(holder.toInt()) } ?: return
+        router.release(token)
+    }
+
+    override fun setSpeakerphoneOn(on: Boolean) {
+        router.setSpeakerphoneOn(on)
+    }
+
+    override fun listAudioDevices(promise: Promise) {
+        router.list { result ->
+            result.fold({ promise.resolve(devicesArray(it)) }, { promise.reject(E_MEDIA, "could not list the audio devices: ${it.message}", it) })
+        }
+    }
+
+    override fun selectAudioOutput(deviceId: String, promise: Promise) {
+        // In media mode sound follows the system's media routing: there is nothing to choose.
+        if (!router.isRouting) return promise.resolve(false)
+        router.selectOutput(deviceId) { result ->
+            result.fold({ promise.resolve(it) }, { promise.reject(E_MEDIA, "could not route call audio: ${it.message}", it) })
+        }
+    }
+
+    override fun selectAudioInput(deviceId: String?, promise: Promise) {
+        val adm = audioDeviceModule() ?: return promise.resolve(false)
+        if (deviceId == null) return promise.resolve(PreferredInput.clear(adm))
+        router.inputInfo(deviceId) { result ->
+            result.fold(
+                { info -> promise.resolve(info != null && PreferredInput.choose(adm, info)) },
+                { promise.reject(E_MEDIA, "could not choose the microphone: ${it.message}", it) },
+            )
+        }
+    }
+
+    override fun currentAudioOutput(promise: Promise) {
+        promise.resolve(router.output?.let(::deviceMap))
+    }
+
+    /**
+     * The audio device module react-native-webrtc plays and records with, when it is a JavaAudioDeviceModule: the init
+     * provider's, or one the app set itself. Never the provider's once the app replaced it, since WebRTC does not use it.
+     */
+    private fun audioDeviceModule(): JavaAudioDeviceModule? =
+        WebRTCModuleOptions.getInstance().audioDeviceModule as? JavaAudioDeviceModule
+
+    // --- visibility ----------------------------------------------------------------------------------------------
+
+    override fun isAppVisible(): Boolean = AppVisibility.visible
+
+    // --- the call service ----------------------------------------------------------------------------------------
+
+    override fun startCallService(options: ReadableMap, promise: Promise) = callService(options, start = true, promise)
+
+    override fun updateCallService(options: ReadableMap, promise: Promise) = callService(options, start = false, promise)
+
+    override fun stopCallService(promise: Promise) {
+        main.post {
+            VoltkitCallService.stop(app)
+            promise.resolve(callServiceStatus(running = false))
+        }
+    }
+
+    override fun getCallServiceStatus(): WritableMap = callServiceStatus()
+
+    private fun callService(options: ReadableMap, start: Boolean, promise: Promise) {
+        val declared = VoltkitCallService.declaredTypes(app)
+            ?: return promise.reject(
+                E_MEDIA,
+                "the app's manifest does not declare VoltkitCallService: turn on the Expo plugin's callService option, or add its <service> block (see the docs)",
+            )
+        val decision = CallServiceTypes.decide(
+            CallServiceTypes.Input(
+                sdkInt = Build.VERSION.SDK_INT,
+                declaredTypes = declared,
+                granted = grantedPermissions(),
+                audioMode = config.audioMode,
+                micPublished = options.flag("micPublished", true),
+                cameraPublished = options.flag("cameraPublished", false),
+                pauseCamera = options.flag("pauseCamera", true),
+                sharing = options.flag("sharing", false),
+            ),
+        )
+        if (!decision.canStart) return promise.reject(E_MEDIA, decision.reason ?: "the call service cannot run")
+        val request = VoltkitCallService.Request(
+            title = options.text("title", "Call in progress"),
+            text = options.text("text", "Tap to return to the call"),
+            leaveLabel = options.text("leaveLabel", "Leave"),
+            types = decision.types,
+        )
+        val done: (Result<Int>) -> Unit = { result ->
+            result.fold({ promise.resolve(callServiceStatus()) }, { promise.reject(E_MEDIA, it.message ?: "the call service could not start", it) })
+        }
+        main.post {
+            when {
+                VoltkitCallService.running != null -> VoltkitCallService.update(request, done)
+                !start -> promise.resolve(callServiceStatus())
+                // Android 12+ refuses a foreground service started from the background; say so plainly.
+                Build.VERSION.SDK_INT >= 31 && !AppVisibility.visible ->
+                    promise.reject(E_MEDIA, "the app is in the background: Android lets the call service start only while the app is visible")
+                else -> VoltkitCallService.start(app, request, done)
+            }
+        }
+    }
+
+    private fun callServiceStatus(running: Boolean = VoltkitCallService.running != null): WritableMap = Arguments.createMap().apply {
+        putBoolean("declared", VoltkitCallService.declaredTypes(app) != null)
+        putBoolean("running", running)
+        putArray("types", Arguments.fromList(if (running) CallServiceTypes.names(VoltkitCallService.runningTypes) else emptyList<String>()))
+    }
+
+    private fun grantedPermissions(): Set<String> =
+        CALL_SERVICE_PERMISSIONS.filter { ContextCompat.checkSelfPermission(app, it) == PackageManager.PERMISSION_GRANTED }.toSet()
+
+    // --- screen share --------------------------------------------------------------------------------------------
+
+    override fun stopScreenShareService(promise: Promise) {
+        // react-native-webrtc stops its MediaProjectionService only when the screen track is released, and a stopped
+        // track is not released: the service outlived every share (Phase 0 finding 5).
+        val stopped = try {
+            app.stopService(Intent(app, MediaProjectionService::class.java))
+        } catch (_: Throwable) {
+            false
+        }
+        promise.resolve(stopped)
+    }
+
+    // --- native timers -------------------------------------------------------------------------------------------
+
+    override fun timerStart(id: Double, ms: Double, repeat: Boolean) {
+        if (invalidated.get()) return
+        timers.start(id, ms, repeat)
+    }
+
+    override fun timerStop(id: Double) {
+        timers.stop(id)
+    }
+
+    // --- the React instance went away ----------------------------------------------------------------------------
+
+    override fun invalidate() {
+        if (invalidated.compareAndSet(false, true)) {
+            timers.stopAll()
+            timerThread.quit()
+            stopVisibility()
+            network.stop()
+            VoltkitRtcInitProvider.microphoneErrors.remove(microphoneError)
+            VoltkitCallService.listeners.remove(callServiceListener)
+            val held = synchronized(holders) { holders.values.toList().also { holders.clear() } }
+            AudioRouter.existing()?.let { r ->
+                held.forEach { r.release(it) }
+                r.removeListener(audioListener)
+            }
+            main.post { VoltkitCallService.stop(app) }
+        }
+        super.invalidate()
+    }
+
+    // --- JavaScript values ---------------------------------------------------------------------------------------
+
+    private fun deviceMap(device: MediaDevice): WritableMap = Arguments.createMap().apply {
+        putString("deviceId", device.deviceId)
+        putString("kind", device.kind.name)
+        putString("label", device.label)
+        putString("type", (device.type ?: AudioDeviceType.other).name)
+        putString("groupId", device.groupId)
+    }
+
+    private fun devicesArray(devices: List<MediaDevice>): WritableArray = Arguments.createArray().apply {
+        devices.forEach { pushMap(deviceMap(it)) }
+    }
+
+    private fun WritableMap.putDevice(key: String, device: MediaDevice?) {
+        if (device == null) putNull(key) else putMap(key, deviceMap(device))
+    }
+
+    private fun ReadableMap.flag(key: String, default: Boolean): Boolean =
+        if (hasKey(key) && !isNull(key)) getBoolean(key) else default
+
+    private fun ReadableMap.text(key: String, default: String): String =
+        if (hasKey(key) && !isNull(key)) getString(key)?.takeIf { it.isNotBlank() } ?: default else default
+
+    companion object {
+        const val NAME = NativeVoltkitRtcSpec.NAME
+
+        /** Rejections use the VoltKit error registry's codes. */
+        private const val E_MEDIA = "media-unavailable"
+
+        private val CALL_SERVICE_PERMISSIONS = listOf(
+            Manifest.permission.FOREGROUND_SERVICE,
+            Manifest.permission.RECORD_AUDIO,
+            Manifest.permission.CAMERA,
+            Manifest.permission.FOREGROUND_SERVICE_MICROPHONE,
+            Manifest.permission.FOREGROUND_SERVICE_MEDIA_PLAYBACK,
+            Manifest.permission.FOREGROUND_SERVICE_CAMERA,
+            Manifest.permission.FOREGROUND_SERVICE_MEDIA_PROJECTION,
+        )
+    }
+}

package/android/src/main/java/com/voltkit/rtc/reactnative/VoltkitRtcPackage.kt

@@ -0,0 +1,30 @@
+package com.voltkit.rtc.reactnative
+
+import com.facebook.react.BaseReactPackage
+import com.facebook.react.bridge.NativeModule
+import com.facebook.react.bridge.ReactApplicationContext
+import com.facebook.react.module.model.ReactModuleInfo
+import com.facebook.react.module.model.ReactModuleInfoProvider
+
+/**
+ * What autolinking adds to the app's package list: the one TurboModule, VoltkitRtc (New Architecture only; React
+ * Native 0.82 and later have no other). Expo's and the React Native CLI's autolinking find this class by its
+ * declaration, `class VoltkitRtcPackage : BaseReactPackage()`.
+ */
+class VoltkitRtcPackage : BaseReactPackage() {
+    override fun getModule(name: String, reactContext: ReactApplicationContext): NativeModule? =
+        if (name == VoltkitRtcModule.NAME) VoltkitRtcModule(reactContext) else null
+
+    override fun getReactModuleInfoProvider(): ReactModuleInfoProvider = ReactModuleInfoProvider {
+        mapOf(
+            VoltkitRtcModule.NAME to ReactModuleInfo(
+                name = VoltkitRtcModule.NAME,
+                className = VoltkitRtcModule::class.java.name,
+                canOverrideExistingModule = false,
+                needsEagerInit = false,
+                isCxxModule = false,
+                isTurboModule = true,
+            ),
+        )
+    }
+}

package/android/src/main/res/drawable/voltkit_rtc_default_call_icon.xml

@@ -0,0 +1,15 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!--
+  The call notification's small icon when the app ships none of its own (VoltkitCallService.smallIcon): a white handset.
+  Android draws a small icon from its alpha channel only, so it must be a shape on transparency, never the launcher
+  icon. An app chooses its own by adding a drawable named voltkit_call_notification_icon.
+-->
+<vector xmlns:android="http://schemas.android.com/apk/res/android"
+    android:width="24dp"
+    android:height="24dp"
+    android:viewportWidth="24"
+    android:viewportHeight="24">
+    <path
+        android:fillColor="#FFFFFFFF"
+        android:pathData="M4.5,3L8.2,3C8.9,3 9.3,3.5 9.4,4.1L9.9,7.2C10,7.8 9.8,8.4 9.3,8.8L7.7,10.1C9,12.6 11.4,15 13.9,16.3L15.2,14.7C15.6,14.2 16.2,14 16.8,14.1L19.9,14.6C20.5,14.7 21,15.1 21,15.8L21,19.5C21,20.3 20.3,21 19.5,21C10.4,21 3,13.6 3,4.5C3,3.7 3.7,3 4.5,3Z" />
+</vector>

package/android/src/main/res/raw/voltkit_rtc_keep.xml

@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!--
+  The call notification's icon is looked up by name in the app (VoltkitCallService.smallIcon), which resource shrinking
+  cannot see: keep the app's drawables of those names, when it has them. The SDK's own default is referenced from code.
+-->
+<resources xmlns:tools="http://schemas.android.com/tools"
+    tools:keep="@drawable/voltkit_call_notification_icon,@drawable/notification_icon,@drawable/ic_notification" />

package/app.plugin.js

@@ -0,0 +1,17 @@
+// The Expo config plugin of @voltkit-rtc/react-native: Expo loads this file when app.json lists the package in
+// "plugins". The plugin is TypeScript in plugin/src, built to plugin/build by `npm run build:plugin` (and by
+// prepublishOnly, so a published package always carries it); see plugin/src/index.ts for what it writes.
+try {
+  module.exports = require('./plugin/build');
+} catch (error) {
+  // plugin/build is build output (git-ignored): in a checkout it has to be built first. Anything else (a missing expo,
+  // an error inside the build) is reported as it is.
+  if (error && error.code === 'MODULE_NOT_FOUND' && String(error.message).includes("Cannot find module './plugin/build'")) {
+    throw new Error(
+      "@voltkit-rtc/react-native: the Expo config plugin's build, plugin/build, is missing. A published package carries " +
+        'it; in a checkout run `npm run build:plugin` in react-native-sdk first.',
+      { cause: error },
+    );
+  }
+  throw error;
+}

package/lib/commonjs/audio.js

@@ -0,0 +1,215 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.audioHoldOf = audioHoldOf;
+exports.selectAudioOutput = selectAudioOutput;
+exports.setSpeakerphoneOn = setSpeakerphoneOn;
+exports.speakerPreference = speakerPreference;
+exports.useAudioOutput = useAudioOutput;
+var _react = require("react");
+var _reactNative = require("react-native");
+var _client = require("@voltkit-rtc/client");
+var _native = require("./native.js");
+var _errors = require("./errors.js");
+/**
+ * Call audio on Android: the speaker or the earpiece, headsets and Bluetooth, through this package's audio router (a
+ * port of the Android SDK's AudioRouter, AudioSwitch's rules). Process-wide, like Android's AudioManager: every
+ * connected client holds the call audio (the provider does it), and the last to let go puts the device's audio mode,
+ * speakerphone and microphone mute back as it found them. setSpeakerphoneOn and selectAudioOutput work before any
+ * client exists: the choice is kept for the call.
+ *
+ * In the audio mode `media` (the Expo plugin's android.audioMode, for apps whose users only listen) sound follows the
+ * system's media routing: there is no earpiece and nothing to choose. On iOS (preview) there is no routing at all.
+ */
+
+/** Whether this app chose the speaker itself (setSpeakerphoneOn): the provider then leaves that choice alone. */
+let speakerChosen = null;
+
+/**
+ * Play call audio on the loudspeaker (true) or the earpiece (false) when no headset is connected; a wired or Bluetooth
+ * headset still wins. Kept until changed, and applied to calls joined later. Rejects with `media-unavailable` on iOS
+ * and where the native module is missing.
+ */
+async function setSpeakerphoneOn(on) {
+  const module = (0, _native.requireNative)('Choosing the speaker or the earpiece');
+  module.setSpeakerphoneOn(Boolean(on));
+  speakerChosen = Boolean(on);
+  outputs.preferenceChanged();
+}
+
+/**
+ * Play call audio on this output (a deviceId from useAudioOutput().outputs) while it stays connected. Rejects with
+ * `bad-params` for an output that is not there and in the audio mode `media`, and with `media-unavailable` on iOS and
+ * where the native module is missing.
+ */
+async function selectAudioOutput(deviceId) {
+  const module = (0, _native.requireNative)('Choosing the audio output');
+  let routed;
+  try {
+    routed = await module.selectAudioOutput(deviceId);
+  } catch (err) {
+    throw (0, _errors.nativeFailure)(err);
+  }
+  if (!routed) {
+    throw new _client.RpcError('bad-params', (0, _native.nativeConstants)()?.audioMode === 'media' ? 'in the audio mode media, sound follows the system\'s media routing: there is no output to choose' : `there is no audio output with the id ${deviceId}`);
+  }
+}
+
+/**
+ * The speaker preference a newly joined call holds the audio with: the provider's (default the loudspeaker), unless
+ * the app chose with setSpeakerphoneOn, which the router keeps (null).
+ */
+function speakerPreference(provider) {
+  return speakerChosen !== null ? null : provider ?? true;
+}
+
+// ------------------------------------------------------------------------------------------- holding the call audio
+
+/**
+ * One client's hold on the call audio: acquired once it is connected, released when it closes or the provider lets go
+ * of it. Released a moment late, so React's StrictMode (an effect unmounted and mounted again at once) neither
+ * releases nor acquires twice.
+ */
+class AudioHold {
+  holder = null;
+  users = 0;
+  pendingRelease = false;
+  constructor(onError) {
+    this.onError = onError;
+  }
+  retain() {
+    this.users += 1;
+    this.pendingRelease = false;
+  }
+
+  /** One user less; the hold goes when none is left. */
+  unretain() {
+    this.users = Math.max(0, this.users - 1);
+    if (this.users > 0) return;
+    this.pendingRelease = true;
+    queueMicrotask(() => {
+      if (this.pendingRelease && this.users === 0) this.release();
+    });
+  }
+  acquire(speakerphone) {
+    if (this.holder) return;
+    const module = (0, _native.nativeModule)();
+    if (!module) return;
+    this.holder = module.audioAcquire(speakerphone).then(id => id, err => {
+      this.onError((0, _errors.nativeFailure)(err));
+      return null;
+    });
+  }
+  release() {
+    this.pendingRelease = false;
+    const holder = this.holder;
+    if (!holder) return;
+    this.holder = null;
+    void holder.then(id => {
+      if (id !== null) (0, _native.nativeModule)()?.audioRelease(id);
+    });
+  }
+}
+const holds = new WeakMap();
+
+/** The call audio hold of `client`. */
+function audioHoldOf(client, onError) {
+  let hold = holds.get(client);
+  if (!hold) {
+    hold = new AudioHold(onError);
+    holds.set(client, hold);
+  }
+  return hold;
+}
+
+// ------------------------------------------------------------------------------------------- useAudioOutput
+
+const NONE = Object.freeze({
+  supported: false,
+  outputs: Object.freeze([]),
+  current: null,
+  speakerphone: false
+});
+
+/** The audio outputs, kept current from the router's events while something listens. */
+class OutputStore {
+  state = NONE;
+  listeners = new Set();
+  stop = null;
+  subscribe = listener => {
+    this.listeners.add(listener);
+    if (this.listeners.size === 1) this.start();
+    return () => {
+      this.listeners.delete(listener);
+      if (this.listeners.size === 0) {
+        this.stop?.();
+        this.stop = null;
+      }
+    };
+  };
+  snapshot = () => this.state;
+
+  /** The app changed the speaker preference: what is shown before a call holds the audio follows it. */
+  preferenceChanged() {
+    if (this.listeners.size > 0) this.set({
+      ...this.state,
+      speakerphone: this.state.current ? this.state.current.type === 'speaker' : speakerChosen ?? true
+    });
+  }
+  start() {
+    const module = (0, _native.nativeModule)();
+    const supported = _reactNative.Platform.OS === 'android' && module !== null && (0, _native.nativeConstants)()?.audioMode !== 'media';
+    if (!module) {
+      this.set(NONE);
+      return;
+    }
+    this.set({
+      ...this.state,
+      supported,
+      speakerphone: this.state.current ? this.state.current.type === 'speaker' : speakerChosen ?? true
+    });
+    const stops = [(0, _native.listen)(module.onAudioDevicesChanged, 'onAudioDevicesChanged', e => this.setOutputs(e.devices.map(_native.toMediaDevice))), (0, _native.listen)(module.onAudioOutputChanged, 'onAudioOutputChanged', e => this.setCurrent(e.device ? (0, _native.toMediaDevice)(e.device) : null))];
+    this.stop = () => {
+      for (const stop of stops) stop();
+    };
+    module.listAudioDevices().then(list => this.setOutputs(list.map(_native.toMediaDevice)), err => (0, _errors.logError)('could not list the audio devices', err));
+    module.currentAudioOutput().then(device => this.setCurrent(device ? (0, _native.toMediaDevice)(device) : null), err => (0, _errors.logError)('could not read the audio output', err));
+  }
+  setOutputs(devices) {
+    const outputs = this.state.supported ? devices.filter(d => d.kind === 'audiooutput') : [];
+    const same = outputs.length === this.state.outputs.length && outputs.every((d, i) => d.deviceId === this.state.outputs[i].deviceId && d.label === this.state.outputs[i].label);
+    if (!same) this.set({
+      ...this.state,
+      outputs
+    });
+  }
+  setCurrent(device) {
+    if (device?.deviceId === this.state.current?.deviceId) return;
+    this.set({
+      ...this.state,
+      current: device,
+      speakerphone: device ? device.type === 'speaker' : speakerChosen ?? true
+    });
+  }
+  set(next) {
+    this.state = next;
+    for (const listener of [...this.listeners]) listener();
+  }
+}
+const outputs = new OutputStore();
+
+/**
+ * Where call audio plays, and the choice of output (an Android "speaker / phone / headset" picker). Works before any
+ * call: a choice made then is kept. On iOS and without the native module `supported` is false and the calls reject.
+ */
+function useAudioOutput() {
+  const state = (0, _react.useSyncExternalStore)(outputs.subscribe, outputs.snapshot, outputs.snapshot);
+  return (0, _react.useMemo)(() => ({
+    ...state,
+    select: selectAudioOutput,
+    setSpeakerphoneOn
+  }), [state]);
+}
+//# sourceMappingURL=audio.js.map

package/lib/commonjs/audio.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_react","require","_reactNative","_client","_native","_errors","speakerChosen","setSpeakerphoneOn","on","module","requireNative","Boolean","outputs","preferenceChanged","selectAudioOutput","deviceId","routed","err","nativeFailure","RpcError","nativeConstants","audioMode","speakerPreference","provider","AudioHold","holder","users","pendingRelease","constructor","onError","retain","unretain","Math","max","queueMicrotask","release","acquire","speakerphone","nativeModule","audioAcquire","then","id","audioRelease","holds","WeakMap","audioHoldOf","client","hold","get","set","NONE","Object","freeze","supported","current","OutputStore","state","listeners","Set","stop","subscribe","listener","add","size","start","delete","snapshot","type","Platform","OS","stops","listen","onAudioDevicesChanged","e","setOutputs","devices","map","toMediaDevice","onAudioOutputChanged","setCurrent","device","listAudioDevices","list","logError","currentAudioOutput","filter","d","kind","same","length","every","i","label","next","useAudioOutput","useSyncExternalStore","useMemo","select"],"sourceRoot":"../../src","sources":["audio.ts"],"mappings":"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","ignoreList":[]}