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

package/lib/module/native-session.js

@@ -0,0 +1,360 @@
+"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. With how to tell the call when its state cannot be read at all.
+   */
+  wants = new Map();
+  running = false;
+  /** The call to the native module under way: a `failed` event during a start or update is its rejection's twin. */
+  inFlight = null;
+  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, report = () => undefined) {
+    if (want) this.wants.set(key, {
+      want,
+      report
+    });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() {
+    const live = [];
+    for (const [key, {
+      want,
+      report
+    }] of [...this.wants]) {
+      let w;
+      try {
+        w = want();
+      } catch (err) {
+        // A client whose state cannot be read (a wrapper that throws on a read): this call is left out of the service
+        // for good, said once, and never keeps the other calls from theirs (the verifier's F3 on 0.1.1).
+        this.wants.delete(key);
+        logError('a call is left out of the call service: its client\'s state could not be read', err);
+        try {
+          report(callServiceFailed(`this call is left out, its client's state could not be read: ${describeError(err)}`));
+        } catch (reportErr) {
+          logError('onError threw', reportErr);
+        }
+        continue;
+      }
+      if (w.live) live.push(w);
+    }
+    return live;
+  }
+  reconcile() {
+    const module = nativeModule();
+    if (!module || !nativeConstants()?.callServiceDeclared) return;
+    const live = this.live();
+    this.watch(module, live.length > 0 || this.running);
+    if (this.inFlight) {
+      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.inFlight = what;
+    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.inFlight = null;
+      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':
+        {
+          // VoltkitCallService.runWith tells `failed` and then rejects the start or update: the rejection reports it (RN010-2).
+          if (this.inFlight === 'start' || this.inFlight === 'update') return;
+          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 = {};
+    const report = error => onError.current?.(error);
+    callServices.set(key, () => wantOf(client, latest.current, report), report);
+    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: pausesCameraInBackground(client) ?? latest.pauseCamera,
+    text: latest.text,
+    leave: () => client.close(),
+    report
+  };
+}
+
+/**
+ * Whether the client switches its camera off in the background, from its own options: the provider's `background` only
+ * describes a client the provider made, and an app-made one (`createClient`, the `client` prop) keeps its camera on with
+ * `pauseCamera: false` while the service was asked for no camera type, so Android cut the camera (RN010-1). The client
+ * pauses only with `pauseCameraInBackground === true` (left out, the camera runs on). Null when the options cannot be
+ * read (missing, not an object, or a read that throws: a wrapped or stubbed client): the provider's setting stands in.
+ */
+function pausesCameraInBackground(client) {
+  let options;
+  try {
+    options = client.options;
+  } catch {
+    // A wrapper that forbids the read (a logging or sealing Proxy): not an error, the provider's setting stands in.
+    return null;
+  }
+  if (!options || typeof options !== 'object') return null;
+  return options.pauseCameraInBackground === true;
+}
+//# 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","inFlight","again","applied","failed","watching","state","listeners","Set","set","key","want","report","undefined","delete","reconcile","changed","subscribe","listener","add","snapshot","module","callServiceDeclared","status","getCallServiceStatus","err","publish","now","next","join","live","w","reportErr","push","watch","length","run","options","merged","JSON","stringify","safeVisible","what","call","stopCallService","startCallService","updateCallService","then","error","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","wantsService","latest","current","hold","retain","sync","connectionState","acquire","release","off","unretain","wantOf","update","offs","map","local","getAudioTracks","getVideoTracks","screen","pausesCameraInBackground","close","pauseCameraInBackground"],"sourceRoot":"../../src","sources":["native-session.tsx"],"mappings":"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","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.1';
+
+/** 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":[]}