@stream-io/video-react-native-sdk 1.45.1 → 1.46.0

package/dist/commonjs/modules/encryption/EncryptionManager.js

@@ -0,0 +1,305 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.EncryptionManager = void 0;
+var _reactNativeWebrtc = require("@stream-io/react-native-webrtc");
+var _videoClient = require("@stream-io/video-client");
+var _eventMapping = require("./eventMapping");
+/**
+ * Distributes keys to the native encryption manager and attaches
+ * encrypt/decrypt transforms to RTCRtpSenders and RTCRtpReceivers.
+ *
+ * The public surface matches the web
+ * {@link https://github.com/GetStream/stream-video-js/blob/main/packages/client/src/rtc/e2ee/EncryptionManager.ts | EncryptionManager}
+ * method for method, so host code is portable between the two SDKs.
+ *
+ * The crypto itself lives in the WebRTC binary, not here: frames never cross
+ * the React Native bridge. This class carries key and attach commands over it,
+ * and diagnostic events back.
+ *
+ * Like the keys it installs, the manager is application-owned: create one per
+ * call, attach it before {@link https://github.com/GetStream/stream-video-js/blob/main/packages/client/src/Call.ts | Call}`.join()`,
+ * and {@link EncryptionManager.dispose | dispose} it when that call is done.
+ * Nothing in the SDK will do it for you, and on React Native the leak is native
+ * rather than collectable.
+ *
+ * @example
+ * ```ts
+ * if (EncryptionManager.isSupported()) {
+ *   const e2ee = await EncryptionManager.create(call.currentUserId);
+ *   e2ee.setSharedKey(0, keyBytes);
+ *   call.setE2EEManager(e2ee); // must happen before call.join()
+ * }
+ * ```
+ */
+class EncryptionManager {
+  bridged = [];
+  disposed = false;
+  constructor(native, algorithm) {
+    this.native = native;
+    this.algorithm = algorithm;
+    this.logger = _videoClient.videoLoggerSystem.getLogger('EncryptionManager');
+    this.events = new _videoClient.TypedEventEmitter(this.logger);
+    // Native dispatches per event name, so the one handler is registered under
+    // each of them, and each registration has to be undone on dispose.
+    for (const type of _eventMapping.E2EE_EVENT_TYPES) {
+      this.native.on(type, this.handleNativeEvent);
+      this.bridged.push([type, this.handleNativeEvent]);
+    }
+  }
+  handleNativeEvent = data => {
+    const event = (0, _eventMapping.mapNativeEvent)(data);
+    if (!event) return;
+    this.events.emit(event.type, event.payload);
+  };
+
+  /**
+   * Whether E2EE can run here. Use it to guard UI, or to avoid calling
+   * {@link create} where it would throw.
+   *
+   * `false` means the installed `@stream-io/react-native-webrtc` predates E2EE
+   * support.
+   */
+  static isSupported = () => _reactNativeWebrtc.RTCEncryptionManager?.isSupported() ?? false;
+
+  /**
+   * Create an EncryptionManager and initialize the underlying native manager.
+   *
+   * Attach it with `call.setE2EEManager()` **before** `call.join()`: the join
+   * request carries the E2EE flag, and the peer connections are built with the
+   * transforms in place.
+   *
+   * Resolves rather than returning directly because every Stream SDK exposes
+   * this as a promise; nothing here is actually asynchronous, since a blocking
+   * native create is what keeps a sender from ever existing unencrypted.
+   *
+   * @param userId - The local user's ID, normally `call.currentUserId`.
+   * @param options - the create options.
+   * @throws {Error} If E2EE is unavailable. It never degrades to plaintext.
+   */
+  static create = async (userId, options) => {
+    if (!_reactNativeWebrtc.RTCEncryptionManager) {
+      throw new Error('E2EE requires a version of @stream-io/react-native-webrtc that supports RTCEncryptionManager');
+    }
+    if (!_reactNativeWebrtc.RTCEncryptionManager.isSupported()) {
+      throw new Error('E2EE is not supported on this device');
+    }
+    const algorithm = options?.algorithm ?? 'AES-128-GCM';
+    const native = _reactNativeWebrtc.RTCEncryptionManager.create(userId, {
+      algorithm: (0, _eventMapping.algorithmToNative)(algorithm)
+    });
+    return new EncryptionManager(native, algorithm);
+  };
+
+  /**
+   * Subscribe to an E2EE event.
+   *
+   * @returns a function that unsubscribes the listener.
+   */
+  on = (event, fn) => this.events.on(event, fn);
+
+  /** Unsubscribe a listener registered with {@link on}. */
+  off = (event, fn) => this.events.off(event, fn);
+
+  /** Drop every listener, or every listener of one event. */
+  removeAllListeners = event => this.events.removeAllListeners(event);
+
+  /**
+   * Set a per-user AES-GCM encryption key in the native key store.
+   *
+   * Use it when each participant has their own key from a central authority.
+   * The receiver picks the right one by the `keyIndex` in the frame trailer.
+   *
+   * @param userId - The key owner.
+   * @param keyIndex - Increases with each rotation.
+   * @param rawKey - 16 bytes for AES-128-GCM, 32 for AES-256-GCM.
+   */
+  setKey = (userId, keyIndex, rawKey) => {
+    this.assertUsable();
+    this.validateKeyIndex(keyIndex);
+    this.validateKeyLength(rawKey);
+    this.native.setKey(userId, keyIndex, this.copyKey(rawKey));
+  };
+
+  /**
+   * Fallback key for any user without a per-user key. The simplest E2EE mode:
+   * one key for everyone, usually passphrase-derived, no distribution needed.
+   * Setting an epoch makes it active for encryption while older epochs remain
+   * available to decrypt in-flight frames until {@link removeSharedKey}.
+   *
+   * @param keyIndex - An integer 0-255, since one trailer byte carries it.
+   * @param rawKey - 16 bytes for AES-128-GCM, 32 for AES-256-GCM.
+   */
+  setSharedKey = (keyIndex, rawKey) => {
+    this.assertUsable();
+    this.validateKeyIndex(keyIndex);
+    this.validateKeyLength(rawKey);
+    this.native.setSharedKey(keyIndex, this.copyKey(rawKey));
+  };
+
+  /**
+   * Retire one of a user's key epochs, leaving their other epochs usable.
+   *
+   * @param userId - The key owner.
+   * @param keyIndex - The exact epoch to remove. Absent epochs are a no-op.
+   */
+  removeKey = (userId, keyIndex) => {
+    this.assertUsable();
+    this.validateKeyIndex(keyIndex);
+    this.native.removeKey(userId, keyIndex);
+  };
+
+  /**
+   * Drop every key a user holds from the local key store, so later frames of
+   * theirs no longer decrypt.
+   *
+   * This is local cleanup, not remote revocation: it cannot stop that
+   * participant from decrypting anything, and a shared key still decrypts them.
+   * Revoking access means withholding future keys, which the application owns.
+   *
+   * To retire one rotated epoch instead, use {@link removeKey}.
+   */
+  removeAllKeys = userId => {
+    this.assertUsable();
+    this.native.removeAllKeys(userId);
+  };
+
+  /**
+   * Remove one shared-key epoch from the native receive key ring.
+   *
+   * If this is the active epoch, shared-key encryption stops until
+   * {@link setSharedKey} succeeds again. An older epoch is not reactivated.
+   *
+   * @param keyIndex - The exact shared-key epoch to remove.
+   */
+  removeSharedKey = keyIndex => {
+    this.assertUsable();
+    this.validateKeyIndex(keyIndex);
+    this.native.removeSharedKey(keyIndex);
+  };
+
+  /**
+   * Called by the Publisher when it adds a transceiver.
+   *
+   * Synchronous all the way to the native `SetFrameTransformer` call: were it
+   * async, the sender would exist before its transform did, which is a
+   * plaintext window. A failure throws instead of publishing cleartext.
+   *
+   * @param sender - The sender to encrypt.
+   * @param codec - Codec name, e.g. 'vp8', selecting the clear-byte rules.
+   * @param trackType - `TrackType` enum name, e.g. 'SCREEN_SHARE_AUDIO'.
+   * @internal
+   */
+  encrypt = (sender, codec, trackType) => {
+    this.assertUsable();
+    this.native.encrypt(sender, codec, (0, _eventMapping.trackTypeToNative)(trackType));
+  };
+
+  /**
+   * Called by the Subscriber when a remote track arrives.
+   *
+   * @param receiver - The receiver to decrypt.
+   * @param userId - The remote user, for key lookup.
+   * @param trackType - `TrackType` enum name, e.g. 'SCREEN_SHARE_AUDIO'.
+   * @internal
+   */
+  decrypt = (receiver, userId, trackType) => {
+    this.assertUsable();
+    this.native.decrypt(receiver, userId, (0, _eventMapping.trackTypeToNative)(trackType));
+  };
+
+  /**
+   * Toggle periodic performance reporting.
+   *
+   * While on, `e2ee.perf_report` is emitted once per second with per-track FPS
+   * and crypto timings. Useful for debugging throughput.
+   */
+  enablePerformanceReporting = enabled => {
+    this.assertUsable();
+    // Observational, so it is the one native call that need not block. Kept
+    // void-returning to match the web manager.
+    this.native.enablePerformanceReporting(enabled).catch(err => this.logger.warn('Failed to toggle performance reporting', err));
+  };
+
+  /**
+   * Request a snapshot of the installed keys. It arrives later as the
+   * `e2ee.key_state` event, listing fingerprints only, never key material.
+   */
+  requestKeyState = () => {
+    this.assertUsable();
+    this.native.requestKeyState().catch(err => this.logger.warn('Failed to request key state', err));
+  };
+
+  /**
+   * Release the native manager and all resources.
+   *
+   * **The application owns this object's lifetime — the SDK never disposes it.**
+   * Nothing releases the native manager when a peer connection closes, and there
+   * is no detach API, so an undisposed manager keeps its transforms and its key
+   * material alive for the lifetime of the process. Dispose it together with the
+   * call instance whose flow has ended; a later flow gets a fresh call and a
+   * fresh manager (see `Call.setE2EEManager`).
+   *
+   * In-flight frames are dropped rather than drained.
+   *
+   * The manager is unusable afterwards and every key or attach method throws.
+   * Call {@link create} for a new one. Safe to call more than once.
+   */
+  dispose = () => {
+    if (this.disposed) return;
+    this.disposed = true;
+    for (const [type, handler] of this.bridged) {
+      this.native.off(type, handler);
+    }
+    this.bridged.length = 0;
+    try {
+      this.native.dispose();
+    } catch (err) {
+      // Local cleanup still has to finish, or listeners outlive the manager.
+      this.logger.warn('Failed to dispose the native encryption manager', err);
+    }
+    this.events.removeAllListeners();
+  };
+
+  /**
+   * {@link dispose} releases the native manager, so an attached transform would
+   * point at nothing: frames would stall with no error and no event. Throwing
+   * is also fail-closed, since a caller that swallows it still publishes
+   * nothing rather than cleartext.
+   */
+  assertUsable = () => {
+    if (this.disposed) throw new Error(`EncryptionManager is disposed`);
+  };
+
+  /**
+   * The caller keeps ownership of its buffer and may re-import the same bytes,
+   * so hand native a copy rather than a view onto memory that can change.
+   */
+  copyKey = rawKey => {
+    const copy = new Uint8Array(rawKey.byteLength);
+    copy.set(new Uint8Array(rawKey));
+    return copy;
+  };
+  validateKeyLength = rawKey => {
+    const is256 = this.algorithm === 'AES-256-GCM';
+    const expected = is256 ? 32 : 16;
+    if (rawKey.byteLength !== expected) {
+      throw new Error(`Key must be exactly ${expected} bytes (${is256 ? 'AES-256' : 'AES-128'})`);
+    }
+  };
+
+  /**
+   * One trailer byte carries the keyIndex. A larger value would truncate to
+   * `keyIndex & 0xFF`, so the receiver would look up the wrong key and fail
+   * every decrypt. Reject it rather than ship a silently broken key epoch.
+   */
+  validateKeyIndex = keyIndex => {
+    if (!Number.isInteger(keyIndex) || keyIndex < 0 || keyIndex > 255) {
+      throw new Error(`keyIndex must be an integer between 0 and 255, got ${keyIndex}`);
+    }
+  };
+}
+exports.EncryptionManager = EncryptionManager;
+//# sourceMappingURL=EncryptionManager.js.map

package/dist/commonjs/modules/encryption/EncryptionManager.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_reactNativeWebrtc","require","_videoClient","_eventMapping","EncryptionManager","bridged","disposed","constructor","native","algorithm","logger","videoLoggerSystem","getLogger","events","TypedEventEmitter","type","E2EE_EVENT_TYPES","on","handleNativeEvent","push","data","event","mapNativeEvent","emit","payload","isSupported","RTCEncryptionManager","create","userId","options","Error","algorithmToNative","fn","off","removeAllListeners","setKey","keyIndex","rawKey","assertUsable","validateKeyIndex","validateKeyLength","copyKey","setSharedKey","removeKey","removeAllKeys","removeSharedKey","encrypt","sender","codec","trackType","trackTypeToNative","decrypt","receiver","enablePerformanceReporting","enabled","catch","err","warn","requestKeyState","dispose","handler","length","copy","Uint8Array","byteLength","set","is256","expected","Number","isInteger","exports"],"sourceRoot":"../../../../src","sources":["modules/encryption/EncryptionManager.ts"],"mappings":"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","ignoreList":[]}

package/dist/commonjs/modules/encryption/eventMapping.js

@@ -0,0 +1,143 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.trackTypeToNative = exports.trackTypeFromNative = exports.mapNativeEvent = exports.algorithmToNative = exports.E2EE_EVENT_TYPES = void 0;
+var _reactNativeWebrtc = require("@stream-io/react-native-webrtc");
+/**
+ * The core RTC layer labels tracks with the `TrackType` enum *name*
+ * (`SfuModels.TrackType[trackType]`), while the native manager takes a numeric
+ * enum. Screen-share audio is deliberately its own value: native keeps replay
+ * state per (userId, trackType), so folding it into `AUDIO` mis-groups it.
+ *
+ * These read the native enums inside the function body on purpose. This module
+ * is reachable from the SDK's public entry point, so an app whose
+ * `@stream-io/react-native-webrtc` predates E2EE would crash on import if the
+ * enums were dereferenced at module scope - even if it never touches E2EE.
+ */
+const trackTypeToNative = trackType => {
+  switch (trackType) {
+    case 'AUDIO':
+      return _reactNativeWebrtc.RTCEncryptionTrackType.AUDIO;
+    case 'VIDEO':
+      return _reactNativeWebrtc.RTCEncryptionTrackType.VIDEO;
+    case 'SCREEN_SHARE':
+      return _reactNativeWebrtc.RTCEncryptionTrackType.SCREEN_SHARE;
+    case 'SCREEN_SHARE_AUDIO':
+      return _reactNativeWebrtc.RTCEncryptionTrackType.SCREEN_SHARE_AUDIO;
+    default:
+      // Native infers audio vs video from the sender rather than pinning a
+      // wrong value.
+      return undefined;
+  }
+};
+
+/** Map a native track type back to the name the web events carry. */
+exports.trackTypeToNative = trackTypeToNative;
+const trackTypeFromNative = trackType => {
+  switch (trackType) {
+    case _reactNativeWebrtc.RTCEncryptionTrackType.AUDIO:
+      return 'AUDIO';
+    case _reactNativeWebrtc.RTCEncryptionTrackType.VIDEO:
+      return 'VIDEO';
+    case _reactNativeWebrtc.RTCEncryptionTrackType.SCREEN_SHARE:
+      return 'SCREEN_SHARE';
+    case _reactNativeWebrtc.RTCEncryptionTrackType.SCREEN_SHARE_AUDIO:
+      return 'SCREEN_SHARE_AUDIO';
+    default:
+      return undefined;
+  }
+};
+
+/** Map the public algorithm name to the native enum. */
+exports.trackTypeFromNative = trackTypeFromNative;
+const algorithmToNative = algorithm => algorithm === 'AES-256-GCM' ? _reactNativeWebrtc.RTCEncryptionAlgorithm.AES_256_GCM : _reactNativeWebrtc.RTCEncryptionAlgorithm.AES_128_GCM;
+exports.algorithmToNative = algorithmToNative;
+const toTrackPerf = row => ({
+  userId: row.userId,
+  trackType: trackTypeFromNative(row.trackType) ?? '',
+  fps: row.fps,
+  maxCryptoMs: row.maxCryptoMs
+});
+
+/**
+ * Translate a native event into the payload the web manager emits, so a host
+ * can write one set of handlers for both platforms.
+ *
+ * Two things have to be reshaped rather than passed through: native track types
+ * are numeric, and native flattens `managerId`/`type`/`userId` alongside the
+ * payload of every event, including the two (`perf_report`, `key_state`) that
+ * are not about a single user. Fields the web types require but native leaves
+ * optional get an explicit default, so a handler never reads `undefined` where
+ * its type promises a value.
+ *
+ * @returns the mapped event, or `undefined` for an unrecognized event name.
+ */
+const mapNativeEvent = event => {
+  const {
+    type,
+    userId,
+    trackType,
+    keyIndex,
+    version,
+    reason
+  } = event;
+  const mapped = payload => ({
+    type,
+    payload
+  });
+  switch (type) {
+    case 'e2ee.decryption_failed':
+    case 'e2ee.decryption_resumed':
+    case 'e2ee.unencrypted_frame':
+      return mapped({
+        userId,
+        trackType: trackTypeFromNative(trackType)
+      });
+    case 'e2ee.missing_key':
+      return mapped({
+        userId,
+        keyIndex,
+        trackType: trackTypeFromNative(trackType)
+      });
+    case 'e2ee.decryption_stalled':
+      return mapped({
+        userId,
+        keyIndex: keyIndex ?? 0,
+        trackType: trackTypeFromNative(trackType)
+      });
+    case 'e2ee.encryption_failed':
+      return mapped({
+        userId,
+        trackType: trackTypeFromNative(trackType),
+        reason: reason ?? ''
+      });
+    case 'e2ee.unsupported_version':
+      return mapped({
+        userId,
+        trackType: trackTypeFromNative(trackType),
+        version: version ?? 0
+      });
+    case 'e2ee.perf_report':
+      return mapped({
+        encode: (event.encode ?? []).map(row => ({
+          ...toTrackPerf(row),
+          codec: row.codec ?? ''
+        })),
+        decode: (event.decode ?? []).map(toTrackPerf)
+      });
+    case 'e2ee.key_state':
+      return mapped(event.keyState ?? {
+        perUserKeys: [],
+        sharedKeys: []
+      });
+    default:
+      return undefined;
+  }
+};
+
+/** Every event the native manager emits, i.e. what the bridge subscribes to. */
+exports.mapNativeEvent = mapNativeEvent;
+const E2EE_EVENT_TYPES = exports.E2EE_EVENT_TYPES = ['e2ee.decryption_failed', 'e2ee.decryption_resumed', 'e2ee.decryption_stalled', 'e2ee.encryption_failed', 'e2ee.missing_key', 'e2ee.unencrypted_frame', 'e2ee.unsupported_version', 'e2ee.perf_report', 'e2ee.key_state'];
+//# sourceMappingURL=eventMapping.js.map

package/dist/commonjs/modules/encryption/eventMapping.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_reactNativeWebrtc","require","trackTypeToNative","trackType","RTCEncryptionTrackType","AUDIO","VIDEO","SCREEN_SHARE","SCREEN_SHARE_AUDIO","undefined","exports","trackTypeFromNative","algorithmToNative","algorithm","RTCEncryptionAlgorithm","AES_256_GCM","AES_128_GCM","toTrackPerf","row","userId","fps","maxCryptoMs","mapNativeEvent","event","type","keyIndex","version","reason","mapped","payload","encode","map","codec","decode","keyState","perUserKeys","sharedKeys","E2EE_EVENT_TYPES"],"sourceRoot":"../../../../src","sources":["modules/encryption/eventMapping.ts"],"mappings":"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","ignoreList":[]}

package/dist/commonjs/modules/encryption/index.js

@@ -0,0 +1,13 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+Object.defineProperty(exports, "EncryptionManager", {
+  enumerable: true,
+  get: function () {
+    return _EncryptionManager.EncryptionManager;
+  }
+});
+var _EncryptionManager = require("./EncryptionManager");
+//# sourceMappingURL=index.js.map

package/dist/commonjs/modules/encryption/index.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_EncryptionManager","require"],"sourceRoot":"../../../../src","sources":["modules/encryption/index.ts"],"mappings":";;;;;;;;;;;AAAA,IAAAA,kBAAA,GAAAC,OAAA","ignoreList":[]}

package/dist/commonjs/modules/encryption/parity.js

@@ -0,0 +1,6 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+//# sourceMappingURL=parity.js.map

package/dist/commonjs/modules/encryption/parity.js.map

@@ -0,0 +1 @@
+{"version":3,"names":[],"sourceRoot":"../../../../src","sources":["modules/encryption/parity.ts"],"mappings":"","ignoreList":[]}

package/dist/commonjs/utils/StreamVideoRN/index.js

@@ -4,6 +4,7 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.StreamVideoRN = void 0;
+var _ringingCallLifecycle = require("../internal/ringingCallLifecycle");
 var _pushLogoutCallback = _interopRequireDefault(require("../internal/pushLogoutCallback"));
 var _setupIosVoipPushEvents = require("../push/setupIosVoipPushEvents");
 var _setupAndroidPushEvents = require("../push/setupAndroidPushEvents");
@@ -111,6 +112,28 @@ class StreamVideoRN {
     (0, _setupIosVoipPushEvents.setupIosVoipPushEvents)(pushConfig);
     (0, _setupAndroidPushEvents.setupAndroidPushEvents)(pushConfig);
   }
+
+  /**
+   * Register hooks that run around a ringing call's join, for every ringing path:
+   * accepted from the CallKit/Telecom UI, accepted inside the app, and outgoing.
+   *
+   * Call this at your application's entry point, alongside
+   * {@link StreamVideoRN.setPushConfig} and **outside** the React tree. A call
+   * accepted from a push notification can be created and joined before any
+   * component mounts, so hooks registered from inside React would be missed on
+   * exactly the path that most needs them.
+   *
+   * Calling it again replaces the previously registered hooks.
+   *
+   * @example // in index.js
+   * StreamVideoRN.setRingingCallLifecycleHooks({
+   *   onBeforeCallJoin: (call) => attachE2EEIfConfigured(call),
+   *   onAfterCallLeave: (call) => disposeE2EEManager(call),
+   * });
+   */
+  static setRingingCallLifecycleHooks = hooks => {
+    (0, _ringingCallLifecycle.setRingingCallLifecycleHooks)(hooks);
+  };
   static getConfig() {
     return this.config;
   }

package/dist/commonjs/utils/StreamVideoRN/index.js.map

@@ -1 +1 @@
-{"version":3,"names":["_pushLogoutCallback","_interopRequireDefault","require","_setupIosVoipPushEvents","_setupAndroidPushEvents","_setupCallingExpEvents","_callingx","_reactNative","_videoClient","e","__esModule","default","deepMerge","target","source","result","key","undefined","Array","isArray","DEFAULT_STREAM_VIDEO_CONFIG","foregroundService","android","channel","id","name","notificationTexts","title","body","taskToRun","Promise","StreamVideoRN","config","updateConfig","setPushConfig","pushConfig","push","callingx","getCallingxLib","videoLoggerSystem","getLogger","info","JSON","stringify","options","extractCallingExpOptions","setup","Error","setupCallingExpEvents","setupIosVoipPushEvents","setupAndroidPushEvents","getConfig","onPushLogout","callbacks","pushLogoutCallbacks","current","resolve","all","map","callback","then","clearPushLogoutCallbacks","setDisableCommunicationModeWorkaround","disabled","Platform","OS","NativeModules","StreamInCallManager","error","warn","playBusyTone","StreamVideoReactNative","stopBusyTone","androidHasAudioOutputHardware","hasAudioOutputHardware","androidHasMicrophoneHardware","hasMicrophoneHardware","androidHasCameraHardware","hasCameraHardware","exports"],"sourceRoot":"../../../../src","sources":["utils/StreamVideoRN/index.ts"],"mappings":"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","ignoreList":[]}
+{"version":3,"names":["_ringingCallLifecycle","require","_pushLogoutCallback","_interopRequireDefault","_setupIosVoipPushEvents","_setupAndroidPushEvents","_setupCallingExpEvents","_callingx","_reactNative","_videoClient","e","__esModule","default","deepMerge","target","source","result","key","undefined","Array","isArray","DEFAULT_STREAM_VIDEO_CONFIG","foregroundService","android","channel","id","name","notificationTexts","title","body","taskToRun","Promise","StreamVideoRN","config","updateConfig","setPushConfig","pushConfig","push","callingx","getCallingxLib","videoLoggerSystem","getLogger","info","JSON","stringify","options","extractCallingExpOptions","setup","Error","setupCallingExpEvents","setupIosVoipPushEvents","setupAndroidPushEvents","setRingingCallLifecycleHooks","hooks","storeRingingCallLifecycleHooks","getConfig","onPushLogout","callbacks","pushLogoutCallbacks","current","resolve","all","map","callback","then","clearPushLogoutCallbacks","setDisableCommunicationModeWorkaround","disabled","Platform","OS","NativeModules","StreamInCallManager","error","warn","playBusyTone","StreamVideoReactNative","stopBusyTone","androidHasAudioOutputHardware","hasAudioOutputHardware","androidHasMicrophoneHardware","hasMicrophoneHardware","androidHasCameraHardware","hasCameraHardware","exports"],"sourceRoot":"../../../../src","sources":["utils/StreamVideoRN/index.ts"],"mappings":"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","ignoreList":[]}

package/dist/commonjs/utils/internal/callingx/callingx.js

@@ -48,11 +48,14 @@ function getCallDisplayName(callMembers, participants, currentUserId) {
  */
 function getCallingxCallArgs(call) {
   const callDisplayName = call.state.custom?.display_name || getCallDisplayName(call.state.members, call.state.participants, call.currentUserId);
+  const createdByHandle = call.state.createdBy?.id ?? callDisplayName;
   return [call.cid,
   // unique id for call
-  call.state.createdBy?.id ?? callDisplayName,
-  // handle for native call UI (prefer createdBy user id, fallback to call display name)
-  callDisplayName,
+  // handle for the native call UI. On iOS it is shown in CallKit Recents and used for
+  // call-back, so we send the caller's user id (matches the Swift SDK). On Android the
+  // self-managed Telecom address is never displayed and callingx wraps it as
+  // `<packageName>:<handle>`, so we send the call id (matches the Android SDK).
+  _reactNative.Platform.OS === 'android' ? call.id : createdByHandle, callDisplayName,
   // display name for display in call screen
   call.state.settings?.video?.enabled ?? false // is video call?
   ];
@@ -82,7 +85,7 @@ async function registerOutgoingCall(call) {
  * 2. Displays the incoming call in the callingx library
  * 3. Optionally for non-ringing calls also when ongoing calls are enabled.
  */
-async function joinCallingxCall(call, activeCalls) {
+async function joinCallingxCall(call, activeCalls, isCancelled) {
   if (!CallingxModule || !CallingxModule.isSetup || call.isOwnTracksLoopbackAllowed) {
     return;
   }
@@ -103,16 +106,38 @@ async function joinCallingxCall(call, activeCalls) {
         logger.error(`failed to leave active call ${activeCall.cid}`, e);
       });
     }
+    // Leaving the other calls above can take arbitrarily long, and this join may
+    // have been cancelled meanwhile. Registering now would create a native call
+    // nobody owns. The caller decides, not the call's state: a `Call` reused for
+    // a fresh ring is still `LEFT` here, because `setup()` runs after this.
+    if (isCancelled?.()) {
+      logger.debug(`joinCallingxCall: skipping registration for ${call.cid}: join cancelled while waiting for other calls`);
+      return;
+    }
     logger.debug(`joinCallingxCall: Joining call ${call.cid} isIncoming: ${isIncomingCall} isOutgoing: ${isOutcomingCall}`);
     const callArgs = getCallingxCallArgs(call);
     if (isIncomingCall) {
       await CallingxModule.displayIncomingCall(...callArgs);
+      // never answer a call that was hung up while the OS was displaying it -
+      // the cleanup below ends the registration instead
+      if (isCancelled?.()) return;
       await CallingxModule.answerIncomingCall(call.cid);
     } else {
       await CallingxModule.startCall(...callArgs);
     }
   } catch (error) {
     logger.error(`startCallingxCall: Error starting call in callingx: ${call.cid} isIncoming: ${isIncomingCall} isOutgoing: ${isOutcomingCall}`, error);
+  } finally {
+    // The registration above can outlive the join that asked for it: `leave()`
+    // may land while native is still bringing the call up, and by the time the
+    // caller aborts, the call exists natively with nobody to end it. Ringing
+    // calls have a lifecycle owner that would clean up; ordinary ones do not.
+    // Nothing was registered when the check above already skipped it, and
+    // `endCallingxCall` no-ops for an untracked cid, so this is safe either way.
+    if (isCancelled?.()) {
+      logger.debug(`joinCallingxCall: ending ${call.cid}: join was cancelled while registering`);
+      await endCallingxCall(call, 'canceled');
+    }
   }
 }
 async function endCallingxCall(call, reason) {