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

package/lib/module/audio.js

@@ -0,0 +1,207 @@
+"use strict";
+
+/**
+ * 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.
+ */
+import { useMemo, useSyncExternalStore } from 'react';
+import { Platform } from 'react-native';
+import { RpcError } from '@voltkit-rtc/client';
+import { listen, nativeConstants, nativeModule, requireNative, toMediaDevice } from "./native.js";
+import { logError, nativeFailure } from "./errors.js";
+
+/** 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.
+ */
+export async function setSpeakerphoneOn(on) {
+  const module = 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.
+ */
+export async function selectAudioOutput(deviceId) {
+  const module = requireNative('Choosing the audio output');
+  let routed;
+  try {
+    routed = await module.selectAudioOutput(deviceId);
+  } catch (err) {
+    throw nativeFailure(err);
+  }
+  if (!routed) {
+    throw new RpcError('bad-params', 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).
+ */
+export 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 = nativeModule();
+    if (!module) return;
+    this.holder = module.audioAcquire(speakerphone).then(id => id, err => {
+      this.onError(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) nativeModule()?.audioRelease(id);
+    });
+  }
+}
+const holds = new WeakMap();
+
+/** The call audio hold of `client`. */
+export 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 = nativeModule();
+    const supported = Platform.OS === 'android' && module !== null && 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 = [listen(module.onAudioDevicesChanged, 'onAudioDevicesChanged', e => this.setOutputs(e.devices.map(toMediaDevice))), listen(module.onAudioOutputChanged, 'onAudioOutputChanged', e => this.setCurrent(e.device ? toMediaDevice(e.device) : null))];
+    this.stop = () => {
+      for (const stop of stops) stop();
+    };
+    module.listAudioDevices().then(list => this.setOutputs(list.map(toMediaDevice)), err => logError('could not list the audio devices', err));
+    module.currentAudioOutput().then(device => this.setCurrent(device ? toMediaDevice(device) : null), err => 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.
+ */
+export function useAudioOutput() {
+  const state = useSyncExternalStore(outputs.subscribe, outputs.snapshot, outputs.snapshot);
+  return useMemo(() => ({
+    ...state,
+    select: selectAudioOutput,
+    setSpeakerphoneOn
+  }), [state]);
+}
+//# sourceMappingURL=audio.js.map

package/lib/module/audio.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["useMemo","useSyncExternalStore","Platform","RpcError","listen","nativeConstants","nativeModule","requireNative","toMediaDevice","logError","nativeFailure","speakerChosen","setSpeakerphoneOn","on","module","Boolean","outputs","preferenceChanged","selectAudioOutput","deviceId","routed","err","audioMode","speakerPreference","provider","AudioHold","holder","users","pendingRelease","constructor","onError","retain","unretain","Math","max","queueMicrotask","release","acquire","speakerphone","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","OS","stops","onAudioDevicesChanged","e","setOutputs","devices","map","onAudioOutputChanged","setCurrent","device","listAudioDevices","list","currentAudioOutput","filter","d","kind","same","length","every","i","label","next","useAudioOutput","select"],"sourceRoot":"../../src","sources":["audio.ts"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,SAASA,OAAO,EAAEC,oBAAoB,QAAQ,OAAO;AACrD,SAASC,QAAQ,QAAQ,cAAc;AACvC,SAASC,QAAQ,QAA6C,qBAAqB;AACnF,SAASC,MAAM,EAAEC,eAAe,EAAEC,YAAY,EAAEC,aAAa,EAAEC,aAAa,QAAQ,aAAU;AAC9F,SAASC,QAAQ,EAAEC,aAAa,QAAQ,aAAU;;AAElD;AACA,IAAIC,aAA6B,GAAG,IAAI;;AAExC;AACA;AACA;AACA;AACA;AACA,OAAO,eAAeC,iBAAiBA,CAACC,EAAW,EAAiB;EAClE,MAAMC,MAAM,GAAGP,aAAa,CAAC,sCAAsC,CAAC;EACpEO,MAAM,CAACF,iBAAiB,CAACG,OAAO,CAACF,EAAE,CAAC,CAAC;EACrCF,aAAa,GAAGI,OAAO,CAACF,EAAE,CAAC;EAC3BG,OAAO,CAACC,iBAAiB,CAAC,CAAC;AAC7B;;AAEA;AACA;AACA;AACA;AACA;AACA,OAAO,eAAeC,iBAAiBA,CAACC,QAAgB,EAAiB;EACvE,MAAML,MAAM,GAAGP,aAAa,CAAC,2BAA2B,CAAC;EACzD,IAAIa,MAAe;EACnB,IAAI;IACFA,MAAM,GAAG,MAAMN,MAAM,CAACI,iBAAiB,CAACC,QAAQ,CAAC;EACnD,CAAC,CAAC,OAAOE,GAAG,EAAE;IACZ,MAAMX,aAAa,CAACW,GAAG,CAAC;EAC1B;EACA,IAAI,CAACD,MAAM,EAAE;IACX,MAAM,IAAIjB,QAAQ,CAAC,YAAY,EAAEE,eAAe,CAAC,CAAC,EAAEiB,SAAS,KAAK,OAAO,GACrE,kGAAkG,GAClG,wCAAwCH,QAAQ,EAAE,CAAC;EACzD;AACF;;AAEA;AACA;AACA;AACA;AACA,OAAO,SAASI,iBAAiBA,CAACC,QAA6B,EAAkB;EAC/E,OAAOb,aAAa,KAAK,IAAI,GAAG,IAAI,GAAGa,QAAQ,IAAI,IAAI;AACzD;;AAEA;;AAEA;AACA;AACA;AACA;AACA;AACA,MAAMC,SAAS,CAAC;EACNC,MAAM,GAAkC,IAAI;EAC5CC,KAAK,GAAG,CAAC;EACTC,cAAc,GAAG,KAAK;EAE9BC,WAAWA,CAAkBC,OAA+B,EAAE;IAAA,KAAjCA,OAA+B,GAA/BA,OAA+B;EAAG;EAE/DC,MAAMA,CAAA,EAAS;IACb,IAAI,CAACJ,KAAK,IAAI,CAAC;IACf,IAAI,CAACC,cAAc,GAAG,KAAK;EAC7B;;EAEA;EACAI,QAAQA,CAAA,EAAS;IACf,IAAI,CAACL,KAAK,GAAGM,IAAI,CAACC,GAAG,CAAC,CAAC,EAAE,IAAI,CAACP,KAAK,GAAG,CAAC,CAAC;IACxC,IAAI,IAAI,CAACA,KAAK,GAAG,CAAC,EAAE;IACpB,IAAI,CAACC,cAAc,GAAG,IAAI;IAC1BO,cAAc,CAAC,MAAM;MACnB,IAAI,IAAI,CAACP,cAAc,IAAI,IAAI,CAACD,KAAK,KAAK,CAAC,EAAE,IAAI,CAACS,OAAO,CAAC,CAAC;IAC7D,CAAC,CAAC;EACJ;EAEAC,OAAOA,CAACC,YAA4B,EAAQ;IAC1C,IAAI,IAAI,CAACZ,MAAM,EAAE;IACjB,MAAMZ,MAAM,GAAGR,YAAY,CAAC,CAAC;IAC7B,IAAI,CAACQ,MAAM,EAAE;IACb,IAAI,CAACY,MAAM,GAAGZ,MAAM,CAACyB,YAAY,CAACD,YAAY,CAAC,CAACE,IAAI,CACjDC,EAAE,IAAKA,EAAE,EACTpB,GAAY,IAAK;MAChB,IAAI,CAACS,OAAO,CAACpB,aAAa,CAACW,GAAG,CAAC,CAAC;MAChC,OAAO,IAAI;IACb,CACF,CAAC;EACH;EAEAe,OAAOA,CAAA,EAAS;IACd,IAAI,CAACR,cAAc,GAAG,KAAK;IAC3B,MAAMF,MAAM,GAAG,IAAI,CAACA,MAAM;IAC1B,IAAI,CAACA,MAAM,EAAE;IACb,IAAI,CAACA,MAAM,GAAG,IAAI;IAClB,KAAKA,MAAM,CAACc,IAAI,CAAEC,EAAE,IAAK;MACvB,IAAIA,EAAE,KAAK,IAAI,EAAEnC,YAAY,CAAC,CAAC,EAAEoC,YAAY,CAACD,EAAE,CAAC;IACnD,CAAC,CAAC;EACJ;AACF;AAEA,MAAME,KAAK,GAAG,IAAIC,OAAO,CAA0B,CAAC;;AAEpD;AACA,OAAO,SAASC,WAAWA,CAACC,MAAoB,EAAEhB,OAA+B,EAAa;EAC5F,IAAIiB,IAAI,GAAGJ,KAAK,CAACK,GAAG,CAACF,MAAM,CAAC;EAC5B,IAAI,CAACC,IAAI,EAAE;IACTA,IAAI,GAAG,IAAItB,SAAS,CAACK,OAAO,CAAC;IAC7Ba,KAAK,CAACM,GAAG,CAACH,MAAM,EAAEC,IAAI,CAAC;EACzB;EACA,OAAOA,IAAI;AACb;;AAEA;;AAwBA,MAAMG,IAAiB,GAAGC,MAAM,CAACC,MAAM,CAAC;EAAEC,SAAS,EAAE,KAAK;EAAErC,OAAO,EAAEmC,MAAM,CAACC,MAAM,CAAC,EAAE,CAA6B;EAAEE,OAAO,EAAE,IAAI;EAAEhB,YAAY,EAAE;AAAM,CAAC,CAAC;;AAEzJ;AACA,MAAMiB,WAAW,CAAC;EACRC,KAAK,GAAgBN,IAAI;EAChBO,SAAS,GAAG,IAAIC,GAAG,CAAa,CAAC;EAC1CC,IAAI,GAAwB,IAAI;EAExCC,SAAS,GAAIC,QAAoB,IAAmB;IAClD,IAAI,CAACJ,SAAS,CAACK,GAAG,CAACD,QAAQ,CAAC;IAC5B,IAAI,IAAI,CAACJ,SAAS,CAACM,IAAI,KAAK,CAAC,EAAE,IAAI,CAACC,KAAK,CAAC,CAAC;IAC3C,OAAO,MAAM;MACX,IAAI,CAACP,SAAS,CAACQ,MAAM,CAACJ,QAAQ,CAAC;MAC/B,IAAI,IAAI,CAACJ,SAAS,CAACM,IAAI,KAAK,CAAC,EAAE;QAC7B,IAAI,CAACJ,IAAI,GAAG,CAAC;QACb,IAAI,CAACA,IAAI,GAAG,IAAI;MAClB;IACF,CAAC;EACH,CAAC;EAEDO,QAAQ,GAAGA,CAAA,KAAmB,IAAI,CAACV,KAAK;;EAExC;EACAvC,iBAAiBA,CAAA,EAAS;IACxB,IAAI,IAAI,CAACwC,SAAS,CAACM,IAAI,GAAG,CAAC,EAAE,IAAI,CAACd,GAAG,CAAC;MAAE,GAAG,IAAI,CAACO,KAAK;MAAElB,YAAY,EAAE,IAAI,CAACkB,KAAK,CAACF,OAAO,GAAG,IAAI,CAACE,KAAK,CAACF,OAAO,CAACa,IAAI,KAAK,SAAS,GAAGxD,aAAa,IAAI;IAAK,CAAC,CAAC;EAC5J;EAEQqD,KAAKA,CAAA,EAAS;IACpB,MAAMlD,MAAM,GAAGR,YAAY,CAAC,CAAC;IAC7B,MAAM+C,SAAS,GAAGnD,QAAQ,CAACkE,EAAE,KAAK,SAAS,IAAItD,MAAM,KAAK,IAAI,IAAIT,eAAe,CAAC,CAAC,EAAEiB,SAAS,KAAK,OAAO;IAC1G,IAAI,CAACR,MAAM,EAAE;MACX,IAAI,CAACmC,GAAG,CAACC,IAAI,CAAC;MACd;IACF;IACA,IAAI,CAACD,GAAG,CAAC;MAAE,GAAG,IAAI,CAACO,KAAK;MAAEH,SAAS;MAAEf,YAAY,EAAE,IAAI,CAACkB,KAAK,CAACF,OAAO,GAAG,IAAI,CAACE,KAAK,CAACF,OAAO,CAACa,IAAI,KAAK,SAAS,GAAGxD,aAAa,IAAI;IAAK,CAAC,CAAC;IACxI,MAAM0D,KAAK,GAAG,CACZjE,MAAM,CAACU,MAAM,CAACwD,qBAAqB,EAAE,uBAAuB,EAAGC,CAAC,IAAK,IAAI,CAACC,UAAU,CAACD,CAAC,CAACE,OAAO,CAACC,GAAG,CAAClE,aAAa,CAAC,CAAC,CAAC,EACnHJ,MAAM,CAACU,MAAM,CAAC6D,oBAAoB,EAAE,sBAAsB,EAAGJ,CAAC,IAAK,IAAI,CAACK,UAAU,CAACL,CAAC,CAACM,MAAM,GAAGrE,aAAa,CAAC+D,CAAC,CAACM,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC,CAC/H;IACD,IAAI,CAAClB,IAAI,GAAG,MAAM;MAChB,KAAK,MAAMA,IAAI,IAAIU,KAAK,EAAEV,IAAI,CAAC,CAAC;IAClC,CAAC;IACD7C,MAAM,CAACgE,gBAAgB,CAAC,CAAC,CAACtC,IAAI,CAAEuC,IAAI,IAAK,IAAI,CAACP,UAAU,CAACO,IAAI,CAACL,GAAG,CAAClE,aAAa,CAAC,CAAC,EAAGa,GAAY,IAAKZ,QAAQ,CAAC,kCAAkC,EAAEY,GAAG,CAAC,CAAC;IACvJP,MAAM,CAACkE,kBAAkB,CAAC,CAAC,CAACxC,IAAI,CAAEqC,MAAM,IAAK,IAAI,CAACD,UAAU,CAACC,MAAM,GAAGrE,aAAa,CAACqE,MAAM,CAAC,GAAG,IAAI,CAAC,EAAGxD,GAAY,IAAKZ,QAAQ,CAAC,iCAAiC,EAAEY,GAAG,CAAC,CAAC;EAC1K;EAEQmD,UAAUA,CAACC,OAAsB,EAAQ;IAC/C,MAAMzD,OAAO,GAAG,IAAI,CAACwC,KAAK,CAACH,SAAS,GAAGoB,OAAO,CAACQ,MAAM,CAAEC,CAAC,IAAKA,CAAC,CAACC,IAAI,KAAK,aAAa,CAAC,GAAG,EAAE;IAC3F,MAAMC,IAAI,GAAGpE,OAAO,CAACqE,MAAM,KAAK,IAAI,CAAC7B,KAAK,CAACxC,OAAO,CAACqE,MAAM,IAAIrE,OAAO,CAACsE,KAAK,CAAC,CAACJ,CAAC,EAAEK,CAAC,KAAKL,CAAC,CAAC/D,QAAQ,KAAK,IAAI,CAACqC,KAAK,CAACxC,OAAO,CAACuE,CAAC,CAAC,CAACpE,QAAQ,IAAI+D,CAAC,CAACM,KAAK,KAAK,IAAI,CAAChC,KAAK,CAACxC,OAAO,CAACuE,CAAC,CAAC,CAACC,KAAK,CAAC;IAC9K,IAAI,CAACJ,IAAI,EAAE,IAAI,CAACnC,GAAG,CAAC;MAAE,GAAG,IAAI,CAACO,KAAK;MAAExC;IAAQ,CAAC,CAAC;EACjD;EAEQ4D,UAAUA,CAACC,MAA0B,EAAQ;IACnD,IAAIA,MAAM,EAAE1D,QAAQ,KAAK,IAAI,CAACqC,KAAK,CAACF,OAAO,EAAEnC,QAAQ,EAAE;IACvD,IAAI,CAAC8B,GAAG,CAAC;MAAE,GAAG,IAAI,CAACO,KAAK;MAAEF,OAAO,EAAEuB,MAAM;MAAEvC,YAAY,EAAEuC,MAAM,GAAGA,MAAM,CAACV,IAAI,KAAK,SAAS,GAAGxD,aAAa,IAAI;IAAK,CAAC,CAAC;EACxH;EAEQsC,GAAGA,CAACwC,IAAiB,EAAQ;IACnC,IAAI,CAACjC,KAAK,GAAGiC,IAAI;IACjB,KAAK,MAAM5B,QAAQ,IAAI,CAAC,GAAG,IAAI,CAACJ,SAAS,CAAC,EAAEI,QAAQ,CAAC,CAAC;EACxD;AACF;AAEA,MAAM7C,OAAO,GAAG,IAAIuC,WAAW,CAAC,CAAC;;AAEjC;AACA;AACA;AACA;AACA,OAAO,SAASmC,cAAcA,CAAA,EAAgB;EAC5C,MAAMlC,KAAK,GAAGvD,oBAAoB,CAACe,OAAO,CAAC4C,SAAS,EAAE5C,OAAO,CAACkD,QAAQ,EAAElD,OAAO,CAACkD,QAAQ,CAAC;EACzF,OAAOlE,OAAO,CAAC,OAAO;IAAE,GAAGwD,KAAK;IAAEmC,MAAM,EAAEzE,iBAAiB;IAAEN;EAAkB,CAAC,CAAC,EAAE,CAAC4C,KAAK,CAAC,CAAC;AAC7F","ignoreList":[]}

package/lib/module/components.js

@@ -0,0 +1,200 @@
+"use strict";
+
+/**
+ * VideoTrack and AudioTrack, React Native's versions of @voltkit-rtc/react's.
+ *
+ * VideoTrack shows a track in react-native-webrtc's RTCView, which plays a stream by URL. Its stream is a wrapper made
+ * through platform/streams.ts, one per track and shared by every view of it, released (never the track) when the last
+ * view goes -- or earlier, while the connection still exists, when the client is about to close what receives the
+ * track or stops it: releasing a wrapper after its track died kills the app (Phase 0 finding 1). The URL is set one
+ * frame after mounting, and the native view is mounted again once if no frame size arrives within 3 s
+ * (react-native-webrtc #1611, black video).
+ *
+ * AudioTrack renders nothing: React Native plays every remote audio track by itself. It sets one track's volume
+ * (react-native-webrtc's `_setVolume`, unity at 1) or mutes it here only.
+ */
+import { useCallback, useEffect, useRef, useState } from 'react';
+import { StyleSheet, View } from 'react-native';
+import { useVoltkitClient } from '@voltkit-rtc/react';
+import { loadWebRTC } from "./globals.js";
+import { logError } from "./errors.js";
+import { streamBook } from "./platform/streams.js";
+import { jsx as _jsx } from "react/jsx-runtime";
+/** How long a view waits for its first frame before its native view is mounted again (react-native-webrtc #1611). */
+export const FIRST_FRAME_TIMEOUT_MS = 3000;
+/** A video track in an RTCView, sized by `style`. */
+export function VideoTrack({
+  track,
+  producerId,
+  mirror = false,
+  objectFit = 'cover',
+  zOrder,
+  visible = true,
+  onDimensionsChange,
+  style,
+  testID
+}) {
+  const client = useVoltkitClient();
+  const [url, setUrl] = useState(null);
+  // The RTCView's key: changed once to mount it again when no frame came.
+  const [mount, setMount] = useState(0);
+  const sawFrame = useRef(false);
+  const dimensions = useRef(onDimensionsChange);
+  useEffect(() => {
+    dimensions.current = onDimensionsChange;
+  });
+
+  // The wrapper stream, held while this view shows the track; its URL one frame after mounting.
+  useEffect(() => {
+    setUrl(null);
+    if (!track) return;
+    const view = streamBook().view(track);
+    if (!view) return;
+    let frame = requestAnimationFrame(() => {
+      frame = null;
+      setUrl(view.url);
+    });
+    const stopEnd = view.onEnd(() => {
+      if (frame !== null) cancelAnimationFrame(frame);
+      frame = null;
+      setUrl(null);
+    });
+    return () => {
+      if (frame !== null) cancelAnimationFrame(frame);
+      stopEnd();
+      view.release();
+    };
+  }, [track]);
+
+  // react-native-webrtc #1611: a view that never shows a frame is mounted again, once per stream.
+  useEffect(() => {
+    sawFrame.current = false;
+    if (!url) return;
+    const timer = setTimeout(() => {
+      if (!sawFrame.current) setMount(n => n + 1);
+    }, FIRST_FRAME_TIMEOUT_MS);
+    return () => clearTimeout(timer);
+  }, [url]);
+
+  // Adaptive stream: the view reports its size (onLayout) and visibility (`visible`) through a ViewSource.
+  const box = useRef(null);
+  const shown = useRef(visible);
+  const reports = useRef(new Set());
+  const tell = (nextBox, nextVisible) => {
+    for (const report of [...reports.current]) {
+      try {
+        report(nextBox, nextVisible);
+      } catch (err) {
+        logError('listener for videoView threw', err);
+      }
+    }
+  };
+  useEffect(() => {
+    if (shown.current === visible) return;
+    shown.current = visible;
+    tell(null, visible);
+  }, [visible]);
+  useEffect(() => {
+    if (!box.current || box.current.fit === objectFit) return;
+    box.current = {
+      ...box.current,
+      fit: objectFit
+    };
+    tell(box.current, null);
+  }, [objectFit]);
+  useEffect(() => {
+    const attach = client?.attachVideo;
+    if (!client || !producerId || typeof attach !== 'function') return;
+    const source = {
+      subscribe(onChange) {
+        reports.current.add(onChange);
+        if (box.current || !shown.current) onChange(box.current, shown.current);
+        return () => {
+          reports.current.delete(onChange);
+        };
+      }
+    };
+    return attach.call(client, producerId, source);
+  }, [client, producerId]);
+  const onLayout = useCallback(event => {
+    const {
+      width,
+      height
+    } = event.nativeEvent.layout;
+    const previous = box.current;
+    if (previous && previous.width === width && previous.height === height && previous.fit === objectFit) return;
+    box.current = {
+      width,
+      height,
+      fit: objectFit
+    };
+    tell(box.current, null);
+  }, [objectFit]);
+  const onFrameSize = useCallback(event => {
+    sawFrame.current = true;
+    const {
+      width,
+      height
+    } = event.nativeEvent;
+    try {
+      dimensions.current?.({
+        width,
+        height
+      });
+    } catch (err) {
+      logError('listener for onDimensionsChange threw', err);
+    }
+  }, []);
+  const RTCView = loadWebRTC()?.RTCView;
+  return /*#__PURE__*/_jsx(View, {
+    style: style,
+    onLayout: onLayout,
+    testID: testID,
+    collapsable: false,
+    children: RTCView && url ? /*#__PURE__*/_jsx(RTCView, {
+      streamURL: url,
+      mirror: mirror,
+      objectFit: objectFit,
+      zOrder: zOrder,
+      onDimensionsChange: onFrameSize,
+      style: StyleSheet.absoluteFill
+    }, mount) : null
+  });
+}
+/** One remote audio track's volume, or muted, while mounted. Renders nothing: React Native plays remote audio itself. */
+export function AudioTrack({
+  track,
+  volume,
+  muted = false
+}) {
+  useEffect(() => {
+    const audio = track;
+    if (!audio || audio.kind !== 'audio' || typeof audio._setVolume !== 'function') return;
+    if (typeof volume !== 'number' || Number.isNaN(volume)) return;
+    const gain = Math.min(1, Math.max(0, volume));
+    try {
+      audio._setVolume(gain);
+    } catch (err) {
+      logError('could not set a track\'s volume', err);
+    }
+    return () => {
+      if (audio.readyState === 'ended') return;
+      try {
+        audio._setVolume?.(1);
+      } catch (err) {
+        logError('could not set a track\'s volume', err);
+      }
+    };
+  }, [track, volume]);
+  useEffect(() => {
+    const audio = track;
+    if (!audio || !muted) return;
+    const was = audio.enabled;
+    audio.enabled = false;
+    return () => {
+      if (audio.readyState !== 'ended') audio.enabled = was;
+    };
+  }, [track, muted]);
+  return null;
+}
+//# sourceMappingURL=components.js.map

package/lib/module/components.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["useCallback","useEffect","useRef","useState","StyleSheet","View","useVoltkitClient","loadWebRTC","logError","streamBook","jsx","_jsx","FIRST_FRAME_TIMEOUT_MS","VideoTrack","track","producerId","mirror","objectFit","zOrder","visible","onDimensionsChange","style","testID","client","url","setUrl","mount","setMount","sawFrame","dimensions","current","view","frame","requestAnimationFrame","stopEnd","onEnd","cancelAnimationFrame","release","timer","setTimeout","n","clearTimeout","box","shown","reports","Set","tell","nextBox","nextVisible","report","err","fit","attach","attachVideo","source","subscribe","onChange","add","delete","call","onLayout","event","width","height","nativeEvent","layout","previous","onFrameSize","RTCView","collapsable","children","streamURL","absoluteFill","AudioTrack","volume","muted","audio","kind","_setVolume","Number","isNaN","gain","Math","min","max","readyState","was","enabled"],"sourceRoot":"../../src","sources":["components.tsx"],"mappings":"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","ignoreList":[]}

package/lib/module/create-client.js

@@ -0,0 +1,42 @@
+"use strict";
+
+/**
+ * A StreamClient for React Native: react-native-webrtc's mediasoup handler (ReactNative106) and this package's
+ * platform, with the background pause on for the camera. The provider makes its clients this way; an app that makes and
+ * owns its client (the provider's `client` prop, a PK battle's second client) uses createClient.
+ */
+import { StreamClient } from '@voltkit-rtc/client';
+import { registerVoltkitGlobals } from "./globals.js";
+import { webrtcMissing } from "./errors.js";
+import { reactNativePlatform } from "./platform/index.js";
+
+/** What happens to the camera and microphone while the app is in the background. */
+
+/**
+ * The ClientOptions a React Native client is made with: `{ handlerName: 'ReactNative106', platform,
+ * pauseCameraInBackground, pauseMicInBackground, ...clientOptions }`.
+ */
+export function reactNativeClientOptions(options = {}) {
+  const {
+    background,
+    clientOptions
+  } = options;
+  return {
+    handlerName: 'ReactNative106',
+    platform: reactNativePlatform(),
+    pauseCameraInBackground: background?.pauseCamera ?? true,
+    pauseMicInBackground: background?.pauseMic ?? false,
+    ...clientOptions
+  };
+}
+
+/**
+ * A StreamClient for React Native, not yet connected: call `connect()`. Throws `media-unavailable` with
+ * `{ reason: 'webrtc-missing' }` where react-native-webrtc's native module is missing (Expo Go: it needs a development
+ * build).
+ */
+export function createClient(wsUrl, token, options = {}) {
+  if (!registerVoltkitGlobals()) throw webrtcMissing();
+  return new StreamClient(wsUrl, token, reactNativeClientOptions(options));
+}
+//# sourceMappingURL=create-client.js.map

package/lib/module/create-client.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["StreamClient","registerVoltkitGlobals","webrtcMissing","reactNativePlatform","reactNativeClientOptions","options","background","clientOptions","handlerName","platform","pauseCameraInBackground","pauseCamera","pauseMicInBackground","pauseMic","createClient","wsUrl","token"],"sourceRoot":"../../src","sources":["create-client.ts"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA,SAASA,YAAY,QAA4B,qBAAqB;AACtE,SAASC,sBAAsB,QAAQ,cAAW;AAClD,SAASC,aAAa,QAAQ,aAAU;AACxC,SAASC,mBAAmB,QAAQ,qBAAY;;AAEhD;;AAmBA;AACA;AACA;AACA;AACA,OAAO,SAASC,wBAAwBA,CAACC,OAA4B,GAAG,CAAC,CAAC,EAAiB;EACzF,MAAM;IAAEC,UAAU;IAAEC;EAAc,CAAC,GAAGF,OAAO;EAC7C,OAAO;IACLG,WAAW,EAAE,gBAAgB;IAC7BC,QAAQ,EAAEN,mBAAmB,CAAC,CAAC;IAC/BO,uBAAuB,EAAEJ,UAAU,EAAEK,WAAW,IAAI,IAAI;IACxDC,oBAAoB,EAAEN,UAAU,EAAEO,QAAQ,IAAI,KAAK;IACnD,GAAGN;EACL,CAAC;AACH;;AAEA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASO,YAAYA,CAACC,KAAa,EAAEC,KAAa,EAAEX,OAA4B,GAAG,CAAC,CAAC,EAAgB;EAC1G,IAAI,CAACJ,sBAAsB,CAAC,CAAC,EAAE,MAAMC,aAAa,CAAC,CAAC;EACpD,OAAO,IAAIF,YAAY,CAACe,KAAK,EAAEC,KAAK,EAAEZ,wBAAwB,CAACC,OAAO,CAAC,CAAC;AAC1E","ignoreList":[]}

package/lib/module/errors.js

@@ -0,0 +1,87 @@
+"use strict";
+
+/**
+ * The errors this package raises. Every one is an RpcError with a code from the VoltKit error registry
+ * (@voltkit-rtc/client ERROR_CODES, checked code for code against every SDK by scripts/test/sdk-contract-sdks.mjs), so
+ * an app switches on `error.code` exactly as it does in a browser or the Android SDK. What is missing goes in `data`:
+ *
+ * - `media-unavailable` `{ reason: 'webrtc-missing' }`: react-native-webrtc's native module is not in the app (Expo Go,
+ *   or an app not rebuilt after installing it). The message says it needs a development build.
+ * - `media-unavailable` `{ reason: 'native-missing', feature }`: this package's own native module is not in the app.
+ * - `media-unavailable` `{ platform: 'ios', feature }`: not in the iOS preview (audio routing: setSpeakerphoneOn,
+ *   selectAudioOutput, switchDevice('audiooutput')). The call service and screen sharing do not raise it there: the
+ *   service is simply not declared (useCallService), and the client answers `screen-share-unsupported`.
+ * - `media-unavailable` `{ permission: 'camera' | 'microphone', status: 'denied' | 'blocked' }`: a refused permission,
+ *   the field names of the Android SDK.
+ * - `media-unavailable` `{ feature: 'callService' }`: the call service could not start or keep running.
+ */
+import { RpcError } from '@voltkit-rtc/client';
+/** react-native-webrtc's native module is missing: Expo Go, or the app was not rebuilt. */
+export function webrtcMissing() {
+  return new RpcError('media-unavailable', "react-native-webrtc's native module is not in this app: @voltkit-rtc/react-native needs a development build (Expo Go cannot load it). Install react-native-webrtc and rebuild the app (npx expo run:android, or an EAS development build).", {
+    reason: 'webrtc-missing'
+  });
+}
+
+/** This package's own native module is missing: the app was not rebuilt after installing it. */
+export function nativeMissing(feature) {
+  return new RpcError('media-unavailable', `${feature} needs @voltkit-rtc/react-native's native module, which is not in this app: it needs a development build. Rebuild the app after installing the package (Expo Go cannot load it).`, {
+    reason: 'native-missing',
+    feature
+  });
+}
+
+/** Not in the iOS preview of 0.1.0. */
+export function iosUnsupported(feature) {
+  return new RpcError('media-unavailable', `${feature} is not available in the iOS preview of @voltkit-rtc/react-native`, {
+    platform: 'ios',
+    feature
+  });
+}
+
+/** A camera or microphone permission the user refused: `blocked` when Android will not ask again. */
+export function permissionRefused(permission, status) {
+  const what = permission === 'camera' ? 'camera' : 'microphone';
+  const why = status === 'blocked' ? `the ${what} permission is blocked: the user has to allow it in the app's settings` : `the ${what} permission was not granted`;
+  return new RpcError('media-unavailable', why, {
+    permission,
+    status
+  });
+}
+
+/** The call service could not start, or Android stopped it. */
+export function callServiceFailed(message) {
+  return new RpcError('media-unavailable', `the call service: ${message}`, {
+    feature: 'callService'
+  });
+}
+
+/** A failure a native module or react-native-webrtc reported, as an RpcError with a registry code. */
+export function nativeFailure(error, code = 'media-unavailable', data) {
+  if (error instanceof RpcError) return error;
+  return new RpcError(code, describeError(error), data);
+}
+
+/** A readable message from anything thrown: an Error, react-native-webrtc's MediaStreamError (not an Error), a string. */
+export function describeError(error) {
+  if (typeof error === 'string') return error;
+  if (error && typeof error === 'object') {
+    const {
+      name,
+      message
+    } = error;
+    const text = typeof message === 'string' && message.length > 0 ? message : '';
+    const label = typeof name === 'string' && name.length > 0 && name !== 'Error' ? name : '';
+    if (label && text && !text.includes(label)) return `${label}: ${text}`;
+    if (text) return text;
+    if (label) return label;
+  }
+  return String(error);
+}
+
+/** Report a failure from code no caller awaits: the error listener's own errors never escape into the app. */
+export function logError(context, error) {
+  // eslint-disable-next-line no-console
+  console.error(`[voltkit-rtc] ${context}`, error);
+}
+//# sourceMappingURL=errors.js.map

package/lib/module/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["RpcError","webrtcMissing","reason","nativeMissing","feature","iosUnsupported","platform","permissionRefused","permission","status","what","why","callServiceFailed","message","nativeFailure","error","code","data","describeError","name","text","length","label","includes","String","logError","context","console"],"sourceRoot":"../../src","sources":["errors.ts"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,SAASA,QAAQ,QAAQ,qBAAqB;AAI9C;AACA,OAAO,SAASC,aAAaA,CAAA,EAAa;EACxC,OAAO,IAAID,QAAQ,CACjB,mBAAmB,EACnB,4OAA4O,EAC5O;IAAEE,MAAM,EAAE;EAAiB,CAC7B,CAAC;AACH;;AAEA;AACA,OAAO,SAASC,aAAaA,CAACC,OAAe,EAAY;EACvD,OAAO,IAAIJ,QAAQ,CACjB,mBAAmB,EACnB,GAAGI,OAAO,kLAAkL,EAC5L;IAAEF,MAAM,EAAE,gBAAgB;IAAEE;EAAQ,CACtC,CAAC;AACH;;AAEA;AACA,OAAO,SAASC,cAAcA,CAACD,OAAe,EAAY;EACxD,OAAO,IAAIJ,QAAQ,CAAC,mBAAmB,EAAE,GAAGI,OAAO,mEAAmE,EAAE;IAAEE,QAAQ,EAAE,KAAK;IAAEF;EAAQ,CAAC,CAAC;AACvJ;;AAEA;AACA,OAAO,SAASG,iBAAiBA,CAACC,UAA+B,EAAEC,MAA4B,EAAY;EACzG,MAAMC,IAAI,GAAGF,UAAU,KAAK,QAAQ,GAAG,QAAQ,GAAG,YAAY;EAC9D,MAAMG,GAAG,GAAGF,MAAM,KAAK,SAAS,GAC5B,OAAOC,IAAI,wEAAwE,GACnF,OAAOA,IAAI,6BAA6B;EAC5C,OAAO,IAAIV,QAAQ,CAAC,mBAAmB,EAAEW,GAAG,EAAE;IAAEH,UAAU;IAAEC;EAAO,CAAC,CAAC;AACvE;;AAEA;AACA,OAAO,SAASG,iBAAiBA,CAACC,OAAe,EAAY;EAC3D,OAAO,IAAIb,QAAQ,CAAC,mBAAmB,EAAE,qBAAqBa,OAAO,EAAE,EAAE;IAAET,OAAO,EAAE;EAAc,CAAC,CAAC;AACtG;;AAEA;AACA,OAAO,SAASU,aAAaA,CAACC,KAAc,EAAEC,IAAmE,GAAG,mBAAmB,EAAEC,IAA8B,EAAY;EACjL,IAAIF,KAAK,YAAYf,QAAQ,EAAE,OAAOe,KAAK;EAC3C,OAAO,IAAIf,QAAQ,CAACgB,IAAI,EAAEE,aAAa,CAACH,KAAK,CAAC,EAAEE,IAAI,CAAC;AACvD;;AAEA;AACA,OAAO,SAASC,aAAaA,CAACH,KAAc,EAAU;EACpD,IAAI,OAAOA,KAAK,KAAK,QAAQ,EAAE,OAAOA,KAAK;EAC3C,IAAIA,KAAK,IAAI,OAAOA,KAAK,KAAK,QAAQ,EAAE;IACtC,MAAM;MAAEI,IAAI;MAAEN;IAAQ,CAAC,GAAGE,KAA8C;IACxE,MAAMK,IAAI,GAAG,OAAOP,OAAO,KAAK,QAAQ,IAAIA,OAAO,CAACQ,MAAM,GAAG,CAAC,GAAGR,OAAO,GAAG,EAAE;IAC7E,MAAMS,KAAK,GAAG,OAAOH,IAAI,KAAK,QAAQ,IAAIA,IAAI,CAACE,MAAM,GAAG,CAAC,IAAIF,IAAI,KAAK,OAAO,GAAGA,IAAI,GAAG,EAAE;IACzF,IAAIG,KAAK,IAAIF,IAAI,IAAI,CAACA,IAAI,CAACG,QAAQ,CAACD,KAAK,CAAC,EAAE,OAAO,GAAGA,KAAK,KAAKF,IAAI,EAAE;IACtE,IAAIA,IAAI,EAAE,OAAOA,IAAI;IACrB,IAAIE,KAAK,EAAE,OAAOA,KAAK;EACzB;EACA,OAAOE,MAAM,CAACT,KAAK,CAAC;AACtB;;AAEA;AACA,OAAO,SAASU,QAAQA,CAACC,OAAe,EAAEX,KAAc,EAAQ;EAC9D;EACAY,OAAO,CAACZ,KAAK,CAAC,iBAAiBW,OAAO,EAAE,EAAEX,KAAK,CAAC;AAClD","ignoreList":[]}

package/lib/module/globals.js

@@ -0,0 +1,53 @@
+"use strict";
+
+/**
+ * react-native-webrtc, loaded only once its native module is known to be in the app. Its entry module talks to
+ * WebRTCModule as soon as it runs, so in Expo Go (or an app not rebuilt after installing it) merely importing it can
+ * throw or leave the app in a broken state. This package never imports it at the top level: everything goes through
+ * `loadWebRTC()`, which answers null instead, and `registerVoltkitGlobals()` (run when the package is imported) is safe
+ * anywhere.
+ */
+import { NativeModules } from 'react-native';
+let loaded = null;
+let registered = false;
+
+/** Whether react-native-webrtc's native module is in this app. */
+export function webrtcAvailable() {
+  return NativeModules.WebRTCModule != null;
+}
+
+/** react-native-webrtc, or null when its native module is not in the app (Expo Go, an app not rebuilt). */
+export function loadWebRTC() {
+  if (loaded) return loaded;
+  if (!webrtcAvailable()) return null;
+  // eslint-disable-next-line @typescript-eslint/no-require-imports
+  loaded = require('react-native-webrtc');
+  return loaded;
+}
+
+/**
+ * Install react-native-webrtc's WebRTC classes as globals (RTCPeerConnection, MediaStream, ...), which mediasoup-client
+ * needs. Runs when the package is imported; calling it again does nothing. Returns false, without throwing, where
+ * react-native-webrtc's native module is missing: the provider then reports `media-unavailable` with
+ * `{ reason: 'webrtc-missing' }`.
+ */
+export function registerVoltkitGlobals() {
+  if (registered) return true;
+  const webrtc = loadWebRTC();
+  if (!webrtc) return false;
+  webrtc.registerGlobals();
+  registered = true;
+  return true;
+}
+
+/** The version of react-native-webrtc in the app, for getDiagnostics(); null when it cannot be read. */
+export function webrtcVersion() {
+  try {
+    // eslint-disable-next-line @typescript-eslint/no-require-imports
+    const pkg = require('react-native-webrtc/package.json');
+    return typeof pkg.version === 'string' ? pkg.version : null;
+  } catch {
+    return null;
+  }
+}
+//# sourceMappingURL=globals.js.map

package/lib/module/globals.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["NativeModules","loaded","registered","webrtcAvailable","WebRTCModule","loadWebRTC","require","registerVoltkitGlobals","webrtc","registerGlobals","webrtcVersion","pkg","version"],"sourceRoot":"../../src","sources":["globals.ts"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,SAASA,aAAa,QAAQ,cAAc;AAK5C,IAAIC,MAA2B,GAAG,IAAI;AACtC,IAAIC,UAAU,GAAG,KAAK;;AAEtB;AACA,OAAO,SAASC,eAAeA,CAAA,EAAY;EACzC,OAAQH,aAAa,CAA6BI,YAAY,IAAI,IAAI;AACxE;;AAEA;AACA,OAAO,SAASC,UAAUA,CAAA,EAAwB;EAChD,IAAIJ,MAAM,EAAE,OAAOA,MAAM;EACzB,IAAI,CAACE,eAAe,CAAC,CAAC,EAAE,OAAO,IAAI;EACnC;EACAF,MAAM,GAAGK,OAAO,CAAC,qBAAqB,CAAiB;EACvD,OAAOL,MAAM;AACf;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASM,sBAAsBA,CAAA,EAAY;EAChD,IAAIL,UAAU,EAAE,OAAO,IAAI;EAC3B,MAAMM,MAAM,GAAGH,UAAU,CAAC,CAAC;EAC3B,IAAI,CAACG,MAAM,EAAE,OAAO,KAAK;EACzBA,MAAM,CAACC,eAAe,CAAC,CAAC;EACxBP,UAAU,GAAG,IAAI;EACjB,OAAO,IAAI;AACb;;AAEA;AACA,OAAO,SAASQ,aAAaA,CAAA,EAAkB;EAC7C,IAAI;IACF;IACA,MAAMC,GAAG,GAAGL,OAAO,CAAC,kCAAkC,CAA0B;IAChF,OAAO,OAAOK,GAAG,CAACC,OAAO,KAAK,QAAQ,GAAGD,GAAG,CAACC,OAAO,GAAG,IAAI;EAC7D,CAAC,CAAC,MAAM;IACN,OAAO,IAAI;EACb;AACF","ignoreList":[]}