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

package/lib/module/native-session.js

@@ -0,0 +1,309 @@
+"use strict";
+
+/**
+ * What a connected call needs from the device on Android, kept by the provider for its client:
+ *
+ * - The call audio (audio.ts): held from the join to the close, so the audio mode, focus and routing are a call's; two
+ *   clients (a PK battle) hold it together and the last out restores the device.
+ * - The call service: a foreground service that keeps the call's network, microphone and timers alive while the app is
+ *   in the background or the screen is off. Without it Android cuts the app's sockets about 6 s after it leaves the
+ *   foreground or the screen goes off (Phase 0 finding 3). It runs while any call is live, for every client together
+ *   (one notification), when the app's manifest declares it (the Expo plugin's callService, default on). Android lets
+ *   it start, and take new foreground service types (the camera, a screen share), only while the app is visible: it
+ *   starts on the join and is brought up to date whenever the app comes back to the front. Its notification's Leave
+ *   action, and the app being swiped away from Recents, close every client it runs for (close code 1000, `left`).
+ *   Failures reach the provider's onError as `media-unavailable` with `{ feature: 'callService' }`.
+ */
+import { useEffect, useMemo, useRef, useSyncExternalStore } from 'react';
+import { useVoltkitClient } from '@voltkit-rtc/react';
+import { listen, nativeConstants, nativeModule } from "./native.js";
+import { callServiceFailed, describeError, logError } from "./errors.js";
+import { audioHoldOf, speakerPreference } from "./audio.js";
+import { localSessionOf } from "./local-media.js";
+import { nativeVisibility } from "./platform/visibility.js";
+import { localStream } from "./platform/common.js";
+
+/** The call service's notification. */
+
+/** How the provider manages the call audio. */
+
+// ----------------------------------------------------------------------------------------- the call service, shared
+
+const NOT_DECLARED = Object.freeze({
+  declared: false,
+  running: false,
+  types: Object.freeze([])
+});
+class CallServices {
+  /** What each call wants, read afresh at every decision: a call's state is its client's, which emits no event for some changes. */
+  wants = new Map();
+  running = false;
+  busy = false;
+  again = false;
+  /** The options the service runs with, as sent. */
+  applied = null;
+  /** Options a start failed for: not tried again until they change or the app comes back to the front. */
+  failed = null;
+  watching = null;
+  state = null;
+  listeners = new Set();
+  set(key, want) {
+    if (want) this.wants.set(key, want);else this.wants.delete(key);
+    this.reconcile();
+  }
+
+  /** Something a call publishes may have changed: decide again. */
+  changed() {
+    this.reconcile();
+  }
+  subscribe = listener => {
+    this.listeners.add(listener);
+    return () => {
+      this.listeners.delete(listener);
+    };
+  };
+  snapshot = () => {
+    if (this.state) return this.state;
+    const module = nativeModule();
+    if (!module || !nativeConstants()?.callServiceDeclared) return NOT_DECLARED;
+    let status = {
+      declared: true,
+      running: false,
+      types: []
+    };
+    try {
+      status = module.getCallServiceStatus();
+    } catch (err) {
+      logError('could not read the call service\'s status', err);
+    }
+    this.state = {
+      declared: status.declared,
+      running: status.running,
+      types: [...status.types]
+    };
+    return this.state;
+  };
+  publish(status) {
+    const now = this.snapshot();
+    const next = {
+      ...now,
+      ...status
+    };
+    if (next.running === now.running && next.declared === now.declared && next.types.join() === now.types.join()) return;
+    this.state = next;
+    for (const listener of [...this.listeners]) listener();
+  }
+  live() {
+    return [...this.wants.values()].map(want => want()).filter(w => w.live);
+  }
+  reconcile() {
+    const module = nativeModule();
+    if (!module || !nativeConstants()?.callServiceDeclared) return;
+    const live = this.live();
+    this.watch(module, live.length > 0 || this.running);
+    if (this.busy) {
+      this.again = true;
+      return;
+    }
+    if (live.length === 0) {
+      this.failed = null;
+      if (this.running || this.applied !== null) this.run(module, 'stop', null);
+      return;
+    }
+    const options = merged(live);
+    const key = JSON.stringify(options);
+    if (this.running && key === this.applied || key === this.failed) return;
+    // Android lets a foreground service start, or widen its types, only while the app is visible.
+    if (!safeVisible(module)) return;
+    this.run(module, this.running ? 'update' : 'start', options);
+  }
+  run(module, what, options) {
+    this.busy = true;
+    const key = options ? JSON.stringify(options) : null;
+    const call = what === 'stop' ? module.stopCallService() : what === 'start' ? module.startCallService(options) : module.updateCallService(options);
+    call.then(status => {
+      this.running = status.running;
+      this.applied = status.running ? key : null;
+      if (status.running) this.failed = null;
+      this.publish({
+        declared: status.declared,
+        running: status.running,
+        types: [...status.types]
+      });
+    }, err => {
+      if (what === 'stop') {
+        logError('could not stop the call service', err);
+        return;
+      }
+      this.failed = key;
+      const error = callServiceFailed(describeError(err));
+      for (const want of this.live()) want.report(error);
+    }).finally(() => {
+      this.busy = false;
+      if (this.again) {
+        this.again = false;
+        this.reconcile();
+        return;
+      }
+      // Nothing left to keep running: stop listening until the next call.
+      if (!this.running && this.live().length === 0) this.watch(module, false);
+    });
+  }
+
+  /** Visibility and the service's own events, while a call is live or the service runs. */
+  watch(module, on) {
+    if (on === (this.watching !== null)) return;
+    if (!on) {
+      this.watching?.();
+      this.watching = null;
+      return;
+    }
+    const visibility = nativeVisibility(module);
+    const stops = [visibility.subscribe(visible => {
+      if (!visible) return;
+      // Back in front: try again what failed, and bring the service up to date.
+      this.failed = null;
+      this.reconcile();
+    }), listen(module.onCallServiceEvent, 'onCallServiceEvent', event => this.onEvent(event.type, event.types, event.message))];
+    this.watching = () => {
+      for (const stop of stops) stop();
+    };
+  }
+  onEvent(type, types, message) {
+    switch (type) {
+      case 'started':
+      case 'updated':
+        this.running = true;
+        this.publish({
+          running: true,
+          types: [...types]
+        });
+        return;
+      case 'stopped':
+        this.running = false;
+        this.applied = null;
+        // Stopped from outside while a call is live: started again when the app next comes to the front, not now.
+        if (this.live().length > 0) this.failed = JSON.stringify(merged(this.live()));
+        this.publish({
+          running: false,
+          types: []
+        });
+        this.reconcile();
+        return;
+      case 'leave':
+      case 'taskRemoved':
+        for (const want of this.live()) want.leave();
+        return;
+      case 'failed':
+        {
+          const error = callServiceFailed(message || 'Android refused it');
+          for (const want of this.live()) want.report(error);
+          return;
+        }
+      default:
+    }
+  }
+}
+function safeVisible(module) {
+  try {
+    return module.isAppVisible();
+  } catch {
+    return true;
+  }
+}
+
+/** What the service runs with for these calls together. */
+function merged(live) {
+  const text = [...live].reverse();
+  const pick = field => text.find(w => w.text[field])?.text[field] ?? '';
+  return {
+    title: pick('title'),
+    text: pick('text'),
+    leaveLabel: pick('leaveLabel'),
+    // The camera type only for a call that keeps its camera on in the background.
+    pauseCamera: !live.some(w => w.cameraPublished && !w.pauseCamera),
+    micPublished: live.some(w => w.micPublished),
+    cameraPublished: live.some(w => w.cameraPublished),
+    sharing: live.some(w => w.sharing)
+  };
+}
+const callServices = new CallServices();
+
+/** The call service: whether the app declares it, whether it runs and with which types. */
+export function useCallService() {
+  return useSyncExternalStore(callServices.subscribe, callServices.snapshot, callServices.snapshot);
+}
+
+// ---------------------------------------------------------------------------------------------- the provider's part
+
+/** Rendered by the provider inside @voltkit-rtc/react's provider: keeps the call audio and the call service for its client. */
+export function NativeSession({
+  audio,
+  callService,
+  pauseCamera,
+  onError
+}) {
+  const client = useVoltkitClient();
+  const manage = audio !== false && audio?.manage !== false;
+  const speakerphone = audio === false ? undefined : audio?.speakerphone;
+  const wantsService = callService !== false;
+  const text = useMemo(() => typeof callService === 'object' && callService !== null ? callService : {}, [callService]);
+  const latest = useRef({
+    speakerphone,
+    text,
+    pauseCamera
+  });
+  useEffect(() => {
+    latest.current = {
+      speakerphone,
+      text,
+      pauseCamera
+    };
+  });
+
+  // What useLocalMedia shows (the screen being shared) is recorded for as long as the provider has the client.
+  useEffect(() => client ? localSessionOf(client).hold() : undefined, [client]);
+  useEffect(() => {
+    if (!client || !manage || !nativeModule()) return;
+    const hold = audioHoldOf(client, error => onError.current?.(error));
+    hold.retain();
+    const sync = () => {
+      const state = client.connectionState;
+      if (state === 'connected' || state === 'reconnecting') hold.acquire(speakerPreference(latest.current.speakerphone));else if (state === 'closed') hold.release();
+    };
+    sync();
+    const off = client.on('connectionStateChanged', sync);
+    return () => {
+      off();
+      hold.unretain();
+    };
+  }, [client, manage, onError]);
+  useEffect(() => {
+    if (!client || !wantsService || !nativeModule()) return;
+    const key = {};
+    callServices.set(key, () => wantOf(client, latest.current, error => onError.current?.(error)));
+    const update = () => callServices.changed();
+    // publish() and a camera switch emit no event of their own: useLocalMedia's calls say so through the local session.
+    const offs = [...['connectionStateChanged', 'localMediaChanged', 'localStreamChanged', 'screenShareStarted', 'screenShareEnded'].map(event => client.on(event, update)), localSessionOf(client).subscribe(update)];
+    return () => {
+      for (const off of offs) off();
+      callServices.set(key, null);
+    };
+  }, [client, wantsService, onError]);
+  return null;
+}
+function wantOf(client, latest, report) {
+  const state = client.connectionState;
+  const local = localStream(client);
+  return {
+    live: state === 'connected' || state === 'reconnecting',
+    micPublished: (local?.getAudioTracks().length ?? 0) > 0,
+    cameraPublished: (local?.getVideoTracks().length ?? 0) > 0,
+    sharing: localSessionOf(client).screen !== null,
+    pauseCamera: latest.pauseCamera,
+    text: latest.text,
+    leave: () => client.close(),
+    report
+  };
+}
+//# sourceMappingURL=native-session.js.map

package/lib/module/native-session.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["useEffect","useMemo","useRef","useSyncExternalStore","useVoltkitClient","listen","nativeConstants","nativeModule","callServiceFailed","describeError","logError","audioHoldOf","speakerPreference","localSessionOf","nativeVisibility","localStream","NOT_DECLARED","Object","freeze","declared","running","types","CallServices","wants","Map","busy","again","applied","failed","watching","state","listeners","Set","set","key","want","delete","reconcile","changed","subscribe","listener","add","snapshot","module","callServiceDeclared","status","getCallServiceStatus","err","publish","now","next","join","live","values","map","filter","w","watch","length","run","options","merged","JSON","stringify","safeVisible","what","call","stopCallService","startCallService","updateCallService","then","error","report","finally","on","visibility","stops","visible","onCallServiceEvent","event","onEvent","type","message","stop","leave","isAppVisible","text","reverse","pick","field","find","title","leaveLabel","pauseCamera","some","cameraPublished","micPublished","sharing","callServices","useCallService","NativeSession","audio","callService","onError","client","manage","speakerphone","undefined","wantsService","latest","current","hold","retain","sync","connectionState","acquire","release","off","unretain","wantOf","update","offs","local","getAudioTracks","getVideoTracks","screen","close"],"sourceRoot":"../../src","sources":["native-session.tsx"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,SAASA,SAAS,EAAEC,OAAO,EAAEC,MAAM,EAAEC,oBAAoB,QAAQ,OAAO;AAExE,SAASC,gBAAgB,QAAQ,oBAAoB;AAErD,SAASC,MAAM,EAAEC,eAAe,EAAEC,YAAY,QAAQ,aAAU;AAChE,SAASC,iBAAiB,EAAEC,aAAa,EAAEC,QAAQ,QAAQ,aAAU;AACrE,SAASC,WAAW,EAAEC,iBAAiB,QAAQ,YAAS;AACxD,SAASC,cAAc,QAAQ,kBAAe;AAC9C,SAASC,gBAAgB,QAAQ,0BAAuB;AACxD,SAASC,WAAW,QAAQ,sBAAmB;;AAE/C;;AAUA;;AAQA;;AAsBA,MAAMC,YAA8B,GAAGC,MAAM,CAACC,MAAM,CAAC;EAAEC,QAAQ,EAAE,KAAK;EAAEC,OAAO,EAAE,KAAK;EAAEC,KAAK,EAAEJ,MAAM,CAACC,MAAM,CAAC,EAAE;AAAyB,CAAC,CAAC;AAE1I,MAAMI,YAAY,CAAC;EACjB;EACiBC,KAAK,GAAG,IAAIC,GAAG,CAAqB,CAAC;EAC9CJ,OAAO,GAAG,KAAK;EACfK,IAAI,GAAG,KAAK;EACZC,KAAK,GAAG,KAAK;EACrB;EACQC,OAAO,GAAkB,IAAI;EACrC;EACQC,MAAM,GAAkB,IAAI;EAC5BC,QAAQ,GAAwB,IAAI;EACpCC,KAAK,GAA4B,IAAI;EAC5BC,SAAS,GAAG,IAAIC,GAAG,CAAa,CAAC;EAElDC,GAAGA,CAACC,GAAW,EAAEC,IAAyB,EAAQ;IAChD,IAAIA,IAAI,EAAE,IAAI,CAACZ,KAAK,CAACU,GAAG,CAACC,GAAG,EAAEC,IAAI,CAAC,CAAC,KAC/B,IAAI,CAACZ,KAAK,CAACa,MAAM,CAACF,GAAG,CAAC;IAC3B,IAAI,CAACG,SAAS,CAAC,CAAC;EAClB;;EAEA;EACAC,OAAOA,CAAA,EAAS;IACd,IAAI,CAACD,SAAS,CAAC,CAAC;EAClB;EAEAE,SAAS,GAAIC,QAAoB,IAAmB;IAClD,IAAI,CAACT,SAAS,CAACU,GAAG,CAACD,QAAQ,CAAC;IAC5B,OAAO,MAAM;MACX,IAAI,CAACT,SAAS,CAACK,MAAM,CAACI,QAAQ,CAAC;IACjC,CAAC;EACH,CAAC;EAEDE,QAAQ,GAAGA,CAAA,KAAwB;IACjC,IAAI,IAAI,CAACZ,KAAK,EAAE,OAAO,IAAI,CAACA,KAAK;IACjC,MAAMa,MAAM,GAAGpC,YAAY,CAAC,CAAC;IAC7B,IAAI,CAACoC,MAAM,IAAI,CAACrC,eAAe,CAAC,CAAC,EAAEsC,mBAAmB,EAAE,OAAO5B,YAAY;IAC3E,IAAI6B,MAAyB,GAAG;MAAE1B,QAAQ,EAAE,IAAI;MAAEC,OAAO,EAAE,KAAK;MAAEC,KAAK,EAAE;IAAG,CAAC;IAC7E,IAAI;MACFwB,MAAM,GAAGF,MAAM,CAACG,oBAAoB,CAAC,CAAC;IACxC,CAAC,CAAC,OAAOC,GAAG,EAAE;MACZrC,QAAQ,CAAC,2CAA2C,EAAEqC,GAAG,CAAC;IAC5D;IACA,IAAI,CAACjB,KAAK,GAAG;MAAEX,QAAQ,EAAE0B,MAAM,CAAC1B,QAAQ;MAAEC,OAAO,EAAEyB,MAAM,CAACzB,OAAO;MAAEC,KAAK,EAAE,CAAC,GAAGwB,MAAM,CAACxB,KAAK;IAAE,CAAC;IAC7F,OAAO,IAAI,CAACS,KAAK;EACnB,CAAC;EAEOkB,OAAOA,CAACH,MAAiC,EAAQ;IACvD,MAAMI,GAAG,GAAG,IAAI,CAACP,QAAQ,CAAC,CAAC;IAC3B,MAAMQ,IAAI,GAAG;MAAE,GAAGD,GAAG;MAAE,GAAGJ;IAAO,CAAC;IAClC,IAAIK,IAAI,CAAC9B,OAAO,KAAK6B,GAAG,CAAC7B,OAAO,IAAI8B,IAAI,CAAC/B,QAAQ,KAAK8B,GAAG,CAAC9B,QAAQ,IAAI+B,IAAI,CAAC7B,KAAK,CAAC8B,IAAI,CAAC,CAAC,KAAKF,GAAG,CAAC5B,KAAK,CAAC8B,IAAI,CAAC,CAAC,EAAE;IAC9G,IAAI,CAACrB,KAAK,GAAGoB,IAAI;IACjB,KAAK,MAAMV,QAAQ,IAAI,CAAC,GAAG,IAAI,CAACT,SAAS,CAAC,EAAES,QAAQ,CAAC,CAAC;EACxD;EAEQY,IAAIA,CAAA,EAAW;IACrB,OAAO,CAAC,GAAG,IAAI,CAAC7B,KAAK,CAAC8B,MAAM,CAAC,CAAC,CAAC,CAACC,GAAG,CAAEnB,IAAI,IAAKA,IAAI,CAAC,CAAC,CAAC,CAACoB,MAAM,CAAEC,CAAC,IAAKA,CAAC,CAACJ,IAAI,CAAC;EAC7E;EAEQf,SAASA,CAAA,EAAS;IACxB,MAAMM,MAAM,GAAGpC,YAAY,CAAC,CAAC;IAC7B,IAAI,CAACoC,MAAM,IAAI,CAACrC,eAAe,CAAC,CAAC,EAAEsC,mBAAmB,EAAE;IACxD,MAAMQ,IAAI,GAAG,IAAI,CAACA,IAAI,CAAC,CAAC;IACxB,IAAI,CAACK,KAAK,CAACd,MAAM,EAAES,IAAI,CAACM,MAAM,GAAG,CAAC,IAAI,IAAI,CAACtC,OAAO,CAAC;IACnD,IAAI,IAAI,CAACK,IAAI,EAAE;MACb,IAAI,CAACC,KAAK,GAAG,IAAI;MACjB;IACF;IACA,IAAI0B,IAAI,CAACM,MAAM,KAAK,CAAC,EAAE;MACrB,IAAI,CAAC9B,MAAM,GAAG,IAAI;MAClB,IAAI,IAAI,CAACR,OAAO,IAAI,IAAI,CAACO,OAAO,KAAK,IAAI,EAAE,IAAI,CAACgC,GAAG,CAAChB,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC;MACzE;IACF;IACA,MAAMiB,OAAO,GAAGC,MAAM,CAACT,IAAI,CAAC;IAC5B,MAAMlB,GAAG,GAAG4B,IAAI,CAACC,SAAS,CAACH,OAAO,CAAC;IACnC,IAAK,IAAI,CAACxC,OAAO,IAAIc,GAAG,KAAK,IAAI,CAACP,OAAO,IAAKO,GAAG,KAAK,IAAI,CAACN,MAAM,EAAE;IACnE;IACA,IAAI,CAACoC,WAAW,CAACrB,MAAM,CAAC,EAAE;IAC1B,IAAI,CAACgB,GAAG,CAAChB,MAAM,EAAE,IAAI,CAACvB,OAAO,GAAG,QAAQ,GAAG,OAAO,EAAEwC,OAAO,CAAC;EAC9D;EAEQD,GAAGA,CAAChB,MAAY,EAAEsB,IAAiC,EAAEL,OAAwC,EAAQ;IAC3G,IAAI,CAACnC,IAAI,GAAG,IAAI;IAChB,MAAMS,GAAG,GAAG0B,OAAO,GAAGE,IAAI,CAACC,SAAS,CAACH,OAAO,CAAC,GAAG,IAAI;IACpD,MAAMM,IAAI,GAAGD,IAAI,KAAK,MAAM,GAAGtB,MAAM,CAACwB,eAAe,CAAC,CAAC,GAAGF,IAAI,KAAK,OAAO,GAAGtB,MAAM,CAACyB,gBAAgB,CAACR,OAAQ,CAAC,GAAGjB,MAAM,CAAC0B,iBAAiB,CAACT,OAAQ,CAAC;IACnJM,IAAI,CAACI,IAAI,CACNzB,MAAM,IAAK;MACV,IAAI,CAACzB,OAAO,GAAGyB,MAAM,CAACzB,OAAO;MAC7B,IAAI,CAACO,OAAO,GAAGkB,MAAM,CAACzB,OAAO,GAAGc,GAAG,GAAG,IAAI;MAC1C,IAAIW,MAAM,CAACzB,OAAO,EAAE,IAAI,CAACQ,MAAM,GAAG,IAAI;MACtC,IAAI,CAACoB,OAAO,CAAC;QAAE7B,QAAQ,EAAE0B,MAAM,CAAC1B,QAAQ;QAAEC,OAAO,EAAEyB,MAAM,CAACzB,OAAO;QAAEC,KAAK,EAAE,CAAC,GAAGwB,MAAM,CAACxB,KAAK;MAAE,CAAC,CAAC;IAChG,CAAC,EACA0B,GAAY,IAAK;MAChB,IAAIkB,IAAI,KAAK,MAAM,EAAE;QACnBvD,QAAQ,CAAC,iCAAiC,EAAEqC,GAAG,CAAC;QAChD;MACF;MACA,IAAI,CAACnB,MAAM,GAAGM,GAAG;MACjB,MAAMqC,KAAK,GAAG/D,iBAAiB,CAACC,aAAa,CAACsC,GAAG,CAAC,CAAC;MACnD,KAAK,MAAMZ,IAAI,IAAI,IAAI,CAACiB,IAAI,CAAC,CAAC,EAAEjB,IAAI,CAACqC,MAAM,CAACD,KAAK,CAAC;IACpD,CACF,CAAC,CAACE,OAAO,CAAC,MAAM;MACd,IAAI,CAAChD,IAAI,GAAG,KAAK;MACjB,IAAI,IAAI,CAACC,KAAK,EAAE;QACd,IAAI,CAACA,KAAK,GAAG,KAAK;QAClB,IAAI,CAACW,SAAS,CAAC,CAAC;QAChB;MACF;MACA;MACA,IAAI,CAAC,IAAI,CAACjB,OAAO,IAAI,IAAI,CAACgC,IAAI,CAAC,CAAC,CAACM,MAAM,KAAK,CAAC,EAAE,IAAI,CAACD,KAAK,CAACd,MAAM,EAAE,KAAK,CAAC;IAC1E,CAAC,CAAC;EACJ;;EAEA;EACQc,KAAKA,CAACd,MAAY,EAAE+B,EAAW,EAAQ;IAC7C,IAAIA,EAAE,MAAM,IAAI,CAAC7C,QAAQ,KAAK,IAAI,CAAC,EAAE;IACrC,IAAI,CAAC6C,EAAE,EAAE;MACP,IAAI,CAAC7C,QAAQ,GAAG,CAAC;MACjB,IAAI,CAACA,QAAQ,GAAG,IAAI;MACpB;IACF;IACA,MAAM8C,UAAU,GAAG7D,gBAAgB,CAAC6B,MAAM,CAAC;IAC3C,MAAMiC,KAAK,GAAG,CACZD,UAAU,CAACpC,SAAS,CAAEsC,OAAO,IAAK;MAChC,IAAI,CAACA,OAAO,EAAE;MACd;MACA,IAAI,CAACjD,MAAM,GAAG,IAAI;MAClB,IAAI,CAACS,SAAS,CAAC,CAAC;IAClB,CAAC,CAAC,EACFhC,MAAM,CAACsC,MAAM,CAACmC,kBAAkB,EAAE,oBAAoB,EAAGC,KAAK,IAAK,IAAI,CAACC,OAAO,CAACD,KAAK,CAACE,IAAI,EAAEF,KAAK,CAAC1D,KAAK,EAAE0D,KAAK,CAACG,OAAO,CAAC,CAAC,CACzH;IACD,IAAI,CAACrD,QAAQ,GAAG,MAAM;MACpB,KAAK,MAAMsD,IAAI,IAAIP,KAAK,EAAEO,IAAI,CAAC,CAAC;IAClC,CAAC;EACH;EAEQH,OAAOA,CAACC,IAAY,EAAE5D,KAAe,EAAE6D,OAAe,EAAQ;IACpE,QAAQD,IAAI;MACV,KAAK,SAAS;MACd,KAAK,SAAS;QACZ,IAAI,CAAC7D,OAAO,GAAG,IAAI;QACnB,IAAI,CAAC4B,OAAO,CAAC;UAAE5B,OAAO,EAAE,IAAI;UAAEC,KAAK,EAAE,CAAC,GAAGA,KAAK;QAAE,CAAC,CAAC;QAClD;MACF,KAAK,SAAS;QACZ,IAAI,CAACD,OAAO,GAAG,KAAK;QACpB,IAAI,CAACO,OAAO,GAAG,IAAI;QACnB;QACA,IAAI,IAAI,CAACyB,IAAI,CAAC,CAAC,CAACM,MAAM,GAAG,CAAC,EAAE,IAAI,CAAC9B,MAAM,GAAGkC,IAAI,CAACC,SAAS,CAACF,MAAM,CAAC,IAAI,CAACT,IAAI,CAAC,CAAC,CAAC,CAAC;QAC7E,IAAI,CAACJ,OAAO,CAAC;UAAE5B,OAAO,EAAE,KAAK;UAAEC,KAAK,EAAE;QAAG,CAAC,CAAC;QAC3C,IAAI,CAACgB,SAAS,CAAC,CAAC;QAChB;MACF,KAAK,OAAO;MACZ,KAAK,aAAa;QAChB,KAAK,MAAMF,IAAI,IAAI,IAAI,CAACiB,IAAI,CAAC,CAAC,EAAEjB,IAAI,CAACiD,KAAK,CAAC,CAAC;QAC5C;MACF,KAAK,QAAQ;QAAE;UACb,MAAMb,KAAK,GAAG/D,iBAAiB,CAAC0E,OAAO,IAAI,oBAAoB,CAAC;UAChE,KAAK,MAAM/C,IAAI,IAAI,IAAI,CAACiB,IAAI,CAAC,CAAC,EAAEjB,IAAI,CAACqC,MAAM,CAACD,KAAK,CAAC;UAClD;QACF;MACA;IACF;EACF;AACF;AAEA,SAASP,WAAWA,CAACrB,MAAY,EAAW;EAC1C,IAAI;IACF,OAAOA,MAAM,CAAC0C,YAAY,CAAC,CAAC;EAC9B,CAAC,CAAC,MAAM;IACN,OAAO,IAAI;EACb;AACF;;AAEA;AACA,SAASxB,MAAMA,CAACT,IAAY,EAA4B;EACtD,MAAMkC,IAAI,GAAG,CAAC,GAAGlC,IAAI,CAAC,CAACmC,OAAO,CAAC,CAAC;EAChC,MAAMC,IAAI,GAAIC,KAA4B,IAAKH,IAAI,CAACI,IAAI,CAAElC,CAAC,IAAKA,CAAC,CAAC8B,IAAI,CAACG,KAAK,CAAC,CAAC,EAAEH,IAAI,CAACG,KAAK,CAAC,IAAI,EAAE;EACjG,OAAO;IACLE,KAAK,EAAEH,IAAI,CAAC,OAAO,CAAC;IACpBF,IAAI,EAAEE,IAAI,CAAC,MAAM,CAAC;IAClBI,UAAU,EAAEJ,IAAI,CAAC,YAAY,CAAC;IAC9B;IACAK,WAAW,EAAE,CAACzC,IAAI,CAAC0C,IAAI,CAAEtC,CAAC,IAAKA,CAAC,CAACuC,eAAe,IAAI,CAACvC,CAAC,CAACqC,WAAW,CAAC;IACnEG,YAAY,EAAE5C,IAAI,CAAC0C,IAAI,CAAEtC,CAAC,IAAKA,CAAC,CAACwC,YAAY,CAAC;IAC9CD,eAAe,EAAE3C,IAAI,CAAC0C,IAAI,CAAEtC,CAAC,IAAKA,CAAC,CAACuC,eAAe,CAAC;IACpDE,OAAO,EAAE7C,IAAI,CAAC0C,IAAI,CAAEtC,CAAC,IAAKA,CAAC,CAACyC,OAAO;EACrC,CAAC;AACH;AAEA,MAAMC,YAAY,GAAG,IAAI5E,YAAY,CAAC,CAAC;;AAEvC;AACA,OAAO,SAAS6E,cAAcA,CAAA,EAAqB;EACjD,OAAOhG,oBAAoB,CAAC+F,YAAY,CAAC3D,SAAS,EAAE2D,YAAY,CAACxD,QAAQ,EAAEwD,YAAY,CAACxD,QAAQ,CAAC;AACnG;;AAEA;;AAUA;AACA,OAAO,SAAS0D,aAAaA,CAAC;EAAEC,KAAK;EAAEC,WAAW;EAAET,WAAW;EAAEU;AAA4B,CAAC,EAAQ;EACpG,MAAMC,MAAM,GAAGpG,gBAAgB,CAAC,CAAC;EACjC,MAAMqG,MAAM,GAAGJ,KAAK,KAAK,KAAK,IAAIA,KAAK,EAAEI,MAAM,KAAK,KAAK;EACzD,MAAMC,YAAY,GAAGL,KAAK,KAAK,KAAK,GAAGM,SAAS,GAAGN,KAAK,EAAEK,YAAY;EACtE,MAAME,YAAY,GAAGN,WAAW,KAAK,KAAK;EAC1C,MAAMhB,IAAI,GAAGrF,OAAO,CAAC,MAAO,OAAOqG,WAAW,KAAK,QAAQ,IAAIA,WAAW,KAAK,IAAI,GAAGA,WAAW,GAAG,CAAC,CAAE,EAAE,CAACA,WAAW,CAAC,CAAC;EACvH,MAAMO,MAAM,GAAG3G,MAAM,CAAC;IAAEwG,YAAY;IAAEpB,IAAI;IAAEO;EAAY,CAAC,CAAC;EAC1D7F,SAAS,CAAC,MAAM;IACd6G,MAAM,CAACC,OAAO,GAAG;MAAEJ,YAAY;MAAEpB,IAAI;MAAEO;IAAY,CAAC;EACtD,CAAC,CAAC;;EAEF;EACA7F,SAAS,CAAC,MAAOwG,MAAM,GAAG3F,cAAc,CAAC2F,MAAM,CAAC,CAACO,IAAI,CAAC,CAAC,GAAGJ,SAAU,EAAE,CAACH,MAAM,CAAC,CAAC;EAE/ExG,SAAS,CAAC,MAAM;IACd,IAAI,CAACwG,MAAM,IAAI,CAACC,MAAM,IAAI,CAAClG,YAAY,CAAC,CAAC,EAAE;IAC3C,MAAMwG,IAAI,GAAGpG,WAAW,CAAC6F,MAAM,EAAGjC,KAAK,IAAKgC,OAAO,CAACO,OAAO,GAAGvC,KAAK,CAAC,CAAC;IACrEwC,IAAI,CAACC,MAAM,CAAC,CAAC;IACb,MAAMC,IAAI,GAAGA,CAAA,KAAM;MACjB,MAAMnF,KAAK,GAAG0E,MAAM,CAACU,eAAe;MACpC,IAAIpF,KAAK,KAAK,WAAW,IAAIA,KAAK,KAAK,cAAc,EAAEiF,IAAI,CAACI,OAAO,CAACvG,iBAAiB,CAACiG,MAAM,CAACC,OAAO,CAACJ,YAAY,CAAC,CAAC,CAAC,KAC/G,IAAI5E,KAAK,KAAK,QAAQ,EAAEiF,IAAI,CAACK,OAAO,CAAC,CAAC;IAC7C,CAAC;IACDH,IAAI,CAAC,CAAC;IACN,MAAMI,GAAG,GAAGb,MAAM,CAAC9B,EAAE,CAAC,wBAAwB,EAAEuC,IAAI,CAAC;IACrD,OAAO,MAAM;MACXI,GAAG,CAAC,CAAC;MACLN,IAAI,CAACO,QAAQ,CAAC,CAAC;IACjB,CAAC;EACH,CAAC,EAAE,CAACd,MAAM,EAAEC,MAAM,EAAEF,OAAO,CAAC,CAAC;EAE7BvG,SAAS,CAAC,MAAM;IACd,IAAI,CAACwG,MAAM,IAAI,CAACI,YAAY,IAAI,CAACrG,YAAY,CAAC,CAAC,EAAE;IACjD,MAAM2B,GAAG,GAAG,CAAC,CAAC;IACdgE,YAAY,CAACjE,GAAG,CAACC,GAAG,EAAE,MAAMqF,MAAM,CAACf,MAAM,EAAEK,MAAM,CAACC,OAAO,EAAGvC,KAAK,IAAKgC,OAAO,CAACO,OAAO,GAAGvC,KAAK,CAAC,CAAC,CAAC;IAChG,MAAMiD,MAAM,GAAGA,CAAA,KAAMtB,YAAY,CAAC5D,OAAO,CAAC,CAAC;IAC3C;IACA,MAAMmF,IAAI,GAAG,CACX,GAAI,CAAC,wBAAwB,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,kBAAkB,CAAC,CAChHnE,GAAG,CAAEyB,KAAK,IAAKyB,MAAM,CAAC9B,EAAE,CAACK,KAAK,EAAEyC,MAAM,CAAC,CAAC,EAC3C3G,cAAc,CAAC2F,MAAM,CAAC,CAACjE,SAAS,CAACiF,MAAM,CAAC,CACzC;IACD,OAAO,MAAM;MACX,KAAK,MAAMH,GAAG,IAAII,IAAI,EAAEJ,GAAG,CAAC,CAAC;MAC7BnB,YAAY,CAACjE,GAAG,CAACC,GAAG,EAAE,IAAI,CAAC;IAC7B,CAAC;EACH,CAAC,EAAE,CAACsE,MAAM,EAAEI,YAAY,EAAEL,OAAO,CAAC,CAAC;EAEnC,OAAO,IAAI;AACb;AAEA,SAASgB,MAAMA,CAACf,MAAoB,EAAEK,MAAuD,EAAErC,MAA8B,EAAQ;EACnI,MAAM1C,KAAK,GAAG0E,MAAM,CAACU,eAAe;EACpC,MAAMQ,KAAK,GAAG3G,WAAW,CAACyF,MAAM,CAAC;EACjC,OAAO;IACLpD,IAAI,EAAEtB,KAAK,KAAK,WAAW,IAAIA,KAAK,KAAK,cAAc;IACvDkE,YAAY,EAAE,CAAC0B,KAAK,EAAEC,cAAc,CAAC,CAAC,CAACjE,MAAM,IAAI,CAAC,IAAI,CAAC;IACvDqC,eAAe,EAAE,CAAC2B,KAAK,EAAEE,cAAc,CAAC,CAAC,CAAClE,MAAM,IAAI,CAAC,IAAI,CAAC;IAC1DuC,OAAO,EAAEpF,cAAc,CAAC2F,MAAM,CAAC,CAACqB,MAAM,KAAK,IAAI;IAC/ChC,WAAW,EAAEgB,MAAM,CAAChB,WAAW;IAC/BP,IAAI,EAAEuB,MAAM,CAACvB,IAAI;IACjBF,KAAK,EAAEA,CAAA,KAAMoB,MAAM,CAACsB,KAAK,CAAC,CAAC;IAC3BtD;EACF,CAAC;AACH","ignoreList":[]}

package/lib/module/native.js

@@ -0,0 +1,87 @@
+"use strict";
+
+/**
+ * This package's native module (src/specs/NativeVoltkitRtc.ts), read only through here: it is null on iOS (JavaScript
+ * only in 0.1.0), in Expo Go and wherever the app was not rebuilt after installing the package. Everything that can do
+ * without it does (JavaScript timers, AppState); what cannot raises `media-unavailable` (errors.ts).
+ */
+import { Platform } from 'react-native';
+import NativeVoltkitRtc from "./specs/NativeVoltkitRtc.js";
+import { iosUnsupported, logError, nativeMissing } from "./errors.js";
+/** The version of this package: what getDiagnostics() reports, and what the native side was built from. */
+export const SDK_VERSION = '0.1.0';
+
+/** The native module, or null where there is none (iOS, Expo Go, an app not rebuilt). */
+export function nativeModule() {
+  if (Platform.OS !== 'android') return null;
+  return NativeVoltkitRtc ?? null;
+}
+let constants = null;
+let staleWarned = false;
+
+/** The module's constants, read once: the audio mode, screen sharing, the call service as the manifest declares them. */
+export function nativeConstants() {
+  const module = nativeModule();
+  if (!module) return null;
+  if (constants?.module === module) return constants.value;
+  let value;
+  try {
+    value = module.getConstants();
+  } catch (err) {
+    logError('could not read the native module\'s constants', err);
+    return null;
+  }
+  constants = {
+    module,
+    value
+  };
+  if (!staleWarned && value.nativeVersion && value.nativeVersion !== SDK_VERSION) {
+    staleWarned = true;
+    // eslint-disable-next-line no-console
+    console.warn(`[voltkit-rtc] the app's native code is @voltkit-rtc/react-native ${value.nativeVersion} but its JavaScript is ${SDK_VERSION}: rebuild the app`);
+  }
+  return value;
+}
+
+/** The native module for `feature`, or the error that says why there is none. */
+export function requireNative(feature) {
+  if (Platform.OS === 'ios') throw iosUnsupported(feature);
+  const module = nativeModule();
+  if (!module) throw nativeMissing(feature);
+  return module;
+}
+
+/** Subscribe to one of the module's events; a listener that throws is logged and the others still run. */
+export function listen(emitter, name, listener) {
+  if (typeof emitter !== 'function') return () => undefined;
+  const subscription = emitter(value => {
+    try {
+      listener(value);
+    } catch (err) {
+      logError(`listener for ${name} threw`, err);
+    }
+  });
+  return () => subscription.remove();
+}
+const AUDIO_TYPES = ['speaker', 'earpiece', 'wiredHeadset', 'bluetooth', 'usb', 'builtinMic', 'other'];
+const KINDS = ['audioinput', 'audiooutput', 'videoinput'];
+
+/** A native audio device as the client's MediaDevice. */
+export function toMediaDevice(device) {
+  const type = AUDIO_TYPES.includes(device.type) ? device.type : 'other';
+  const kind = KINDS.includes(device.kind) ? device.kind : 'audiooutput';
+  return {
+    deviceId: device.deviceId,
+    groupId: device.groupId ?? '',
+    kind,
+    label: device.label,
+    type
+  };
+}
+
+/** For tests: forget the cached constants. */
+export function resetNativeForTests() {
+  constants = null;
+  staleWarned = false;
+}
+//# sourceMappingURL=native.js.map

package/lib/module/native.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["Platform","NativeVoltkitRtc","iosUnsupported","logError","nativeMissing","SDK_VERSION","nativeModule","OS","constants","staleWarned","nativeConstants","module","value","getConstants","err","nativeVersion","console","warn","requireNative","feature","listen","emitter","name","listener","undefined","subscription","remove","AUDIO_TYPES","KINDS","toMediaDevice","device","type","includes","kind","deviceId","groupId","label","resetNativeForTests"],"sourceRoot":"../../src","sources":["native.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/package.json

@@ -0,0 +1 @@
+{"type":"module"}

package/lib/module/permissions.js

@@ -0,0 +1,160 @@
+"use strict";
+
+/**
+ * Camera, microphone and notification permissions.
+ *
+ * Android: PermissionsAndroid. `blocked` is Android's "never ask again" (the user refused twice, or chose "Don't ask
+ * again"): only the app's settings can grant it now. The notification permission (Android 13+, POST_NOTIFICATIONS,
+ * for the call service's notification) is asked only when asked for; below Android 13 there is none to ask.
+ *
+ * iOS (preview): react-native-webrtc's permissions module. iOS asks once: a refusal is `blocked` from then on.
+ *
+ * useLocalMedia().publish() asks for what it needs before any device opens, so a refusal is a `media-unavailable`
+ * error with `{ permission, status }` and the camera light never comes on. The SDK's own captures afterwards (a
+ * reconnect, a switch) only check, never ask: a dialog must not open in the background.
+ */
+import { useCallback, useEffect, useMemo, useRef, useState } from 'react';
+import { AppState, PermissionsAndroid, Platform } from 'react-native';
+import { loadWebRTC } from "./globals.js";
+import { logError } from "./errors.js";
+
+/** What can be asked for. */
+
+/** `granted`; `denied` (not granted yet: asking may still show the dialog); `blocked` (only the settings can grant it). */
+
+const ANDROID = {
+  camera: 'android.permission.CAMERA',
+  microphone: 'android.permission.RECORD_AUDIO',
+  notifications: 'android.permission.POST_NOTIFICATIONS'
+};
+const unique = kinds => [...new Set(kinds)];
+
+/** Android 13 and later have a notification permission; below, notifications need none. */
+const notificationsNeedAsking = () => Platform.OS === 'android' && Number(Platform.Version) >= 33;
+
+/**
+ * Ask for these permissions, showing the system's dialogs for those not granted yet. Resolves with each one's status;
+ * never rejects.
+ */
+export async function requestMediaPermissions(kinds) {
+  const wanted = unique(kinds);
+  const out = {};
+  if (wanted.length === 0) return out;
+  if (Platform.OS === 'android') {
+    const ask = wanted.filter(k => k !== 'notifications' || notificationsNeedAsking());
+    for (const kind of wanted) if (!ask.includes(kind)) out[kind] = 'granted';
+    if (ask.length === 0) return out;
+    let results = {};
+    try {
+      results = await PermissionsAndroid.requestMultiple(ask.map(k => ANDROID[k]));
+    } catch (err) {
+      logError('could not ask for permissions', err);
+    }
+    for (const kind of ask) out[kind] = androidStatus(results[ANDROID[kind]]);
+    return out;
+  }
+  for (const kind of wanted) out[kind] = await requestIos(kind);
+  return out;
+}
+
+/** Each permission's status now, without asking. Never rejects. */
+export async function checkMediaPermissions(kinds) {
+  const wanted = unique(kinds);
+  const out = {};
+  for (const kind of wanted) {
+    if (Platform.OS === 'android') {
+      if (kind === 'notifications' && !notificationsNeedAsking()) {
+        out[kind] = 'granted';
+        continue;
+      }
+      try {
+        out[kind] = (await PermissionsAndroid.check(ANDROID[kind])) ? 'granted' : 'denied';
+      } catch (err) {
+        logError('could not check a permission', err);
+        out[kind] = 'denied';
+      }
+    } else {
+      out[kind] = await queryIos(kind);
+    }
+  }
+  return out;
+}
+function androidStatus(result) {
+  if (result === 'granted') return 'granted';
+  if (result === 'never_ask_again') return 'blocked';
+  return 'denied';
+}
+async function queryIos(kind) {
+  // The SDK shows no notification of its own on iOS: nothing to ask.
+  if (kind === 'notifications') return 'granted';
+  const webrtc = loadWebRTC();
+  if (!webrtc) return 'denied';
+  try {
+    const result = await webrtc.permissions.query({
+      name: kind
+    });
+    if (result === 'granted') return 'granted';
+    return result === 'denied' ? 'blocked' : 'denied';
+  } catch (err) {
+    logError('could not check a permission', err);
+    return 'denied';
+  }
+}
+async function requestIos(kind) {
+  const now = await queryIos(kind);
+  if (now !== 'denied') return now;
+  const webrtc = loadWebRTC();
+  if (!webrtc) return 'denied';
+  try {
+    return (await webrtc.permissions.request({
+      name: kind
+    })) ? 'granted' : 'blocked';
+  } catch (err) {
+    logError('could not ask for a permission', err);
+    return 'denied';
+  }
+}
+/**
+ * The status of these permissions, checked on mount and whenever the app returns to the front (the user may have
+ * changed them in the settings), with `request()` to ask for them.
+ */
+export function usePermissions(kinds) {
+  const key = unique(kinds).sort().join(',');
+  const wanted = useMemo(() => key ? key.split(',') : [], [key]);
+  const [statuses, setStatuses] = useState(null);
+  const live = useRef(true);
+  const refresh = useCallback(async () => {
+    const next = await checkMediaPermissions(wanted);
+    if (live.current) setStatuses(previous => same(previous, next) ? previous : next);
+    return next;
+  }, [wanted]);
+  const request = useCallback(async () => {
+    const next = await requestMediaPermissions(wanted);
+    if (live.current) setStatuses(previous => same(previous, next) ? previous : next);
+    return next;
+  }, [wanted]);
+  useEffect(() => {
+    live.current = true;
+    void refresh();
+    const subscription = AppState.addEventListener('change', state => {
+      if (state === 'active') void refresh();
+    });
+    return () => {
+      live.current = false;
+      subscription?.remove();
+    };
+  }, [refresh]);
+  const granted = statuses !== null && wanted.every(k => statuses[k] === 'granted');
+  return useMemo(() => ({
+    statuses,
+    granted,
+    request,
+    refresh
+  }), [statuses, granted, request, refresh]);
+}
+function same(a, b) {
+  if (!a) return false;
+  const keys = Object.keys(b);
+  return keys.length === Object.keys(a).length && keys.every(k => a[k] === b[k]);
+}
+//# sourceMappingURL=permissions.js.map

package/lib/module/permissions.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["useCallback","useEffect","useMemo","useRef","useState","AppState","PermissionsAndroid","Platform","loadWebRTC","logError","ANDROID","camera","microphone","notifications","unique","kinds","Set","notificationsNeedAsking","OS","Number","Version","requestMediaPermissions","wanted","out","length","ask","filter","k","kind","includes","results","requestMultiple","map","err","androidStatus","requestIos","checkMediaPermissions","check","queryIos","result","webrtc","permissions","query","name","now","request","usePermissions","key","sort","join","split","statuses","setStatuses","live","refresh","next","current","previous","same","subscription","addEventListener","state","remove","granted","every","a","b","keys","Object"],"sourceRoot":"../../src","sources":["permissions.ts"],"mappings":"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","ignoreList":[]}