twilio-video 2.24.2 → 2.25.0

package/dist/twilio-video.js

@@ -1,4 +1,4 @@
-/*! twilio-video.js 2.24.2
+/*! twilio-video.js 2.25.0
 
 The following license applies to all parts of this software except as
 documented below.
@@ -1116,8 +1116,16 @@ var NoiseCancellationVendor = {
  * @property {boolean} [workaroundWebKitBug180748=false] - setting this
  *   attempts to workaround WebKit Bug 180748, where, in Safari, getUserMedia may return a silent audio
  *   MediaStreamTrack.
- * @property {NoiseCancellationOptions} [noiseCancellationOptions] - This property enables using 3rd party plugins
- *   for noise cancellation. This is a beta feature.
+ * @property {DefaultDeviceCaptureMode} [defaultDeviceCaptureMode="auto"] - This optional property only applies if the
+ *   {@link LocalAudioTrack} is capturing from the default audio input device connected to a desktop or laptop. When the
+ *   property is set to "auto", the LocalAudioTrack restarts whenever the default audio input device changes, in order to
+ *   capture audio from the new default audio input device. For example, when a bluetooth audio headset is connected to a
+ *   Macbook, the LocalAudioTrack will start capturing audio from the headset microphone. When the headset is disconnected,
+ *   the LocalAudioTrack will start capturing audio from the Macbook microphone. When the property is set to "manual", the
+ *   LocalAudioTrack continues to capture from the same audio input device even after the default audio input device changes.
+ *   When the property is not specified, it defaults to "auto".
+ * @property {NoiseCancellationOptions} [noiseCancellationOptions] - This optional property enables using 3rd party plugins
+ *   for noise cancellation.
  */
 /**
  * Create {@link LocalTrack} options. Apart from the properties listed here, you can
@@ -1218,7 +1226,7 @@ var buildLogLevels = require('./util').buildLogLevels;
 var _a = require('./webrtc'), getUserMedia = _a.getUserMedia, MediaStreamTrack = _a.MediaStreamTrack;
 var _b = require('./media/track/es5'), LocalAudioTrack = _b.LocalAudioTrack, LocalDataTrack = _b.LocalDataTrack, LocalVideoTrack = _b.LocalVideoTrack;
 var Log = require('./util/log');
-var _c = require('./util/constants'), DEFAULT_LOG_LEVEL = _c.DEFAULT_LOG_LEVEL, DEFAULT_LOGGER_NAME = _c.DEFAULT_LOGGER_NAME;
+var _c = require('./util/constants'), DEFAULT_LOG_LEVEL = _c.DEFAULT_LOG_LEVEL, DEFAULT_LOGGER_NAME = _c.DEFAULT_LOGGER_NAME, INVALID_VALUE = _c.typeErrors.INVALID_VALUE;
 var workaround180748 = require('./webaudio/workaround180748');
 // This is used to make out which createLocalTracks() call a particular Log
 // statement belongs to. Each call to createLocalTracks() increments this
@@ -1317,19 +1325,31 @@ function createLocalTracks(options) {
                     extraLocalTrackOptions = {
                         audio: typeof fullOptions.audio === 'object' && fullOptions.audio.name
                             ? { name: fullOptions.audio.name }
-                            : {},
+                            : { defaultDeviceCaptureMode: 'auto' },
                         video: typeof fullOptions.video === 'object' && fullOptions.video.name
                             ? { name: fullOptions.video.name }
                             : {}
                     };
                     extraLocalTrackOptions.audio.isCreatedByCreateLocalTracks = true;
                     extraLocalTrackOptions.video.isCreatedByCreateLocalTracks = true;
-                    if (typeof fullOptions.audio === 'object' && typeof fullOptions.audio.workaroundWebKitBug1208516 === 'boolean') {
-                        extraLocalTrackOptions.audio.workaroundWebKitBug1208516 = fullOptions.audio.workaroundWebKitBug1208516;
-                    }
-                    if (typeof fullOptions.audio === 'object' && 'noiseCancellationOptions' in fullOptions.audio) {
-                        noiseCancellationOptions = fullOptions.audio.noiseCancellationOptions;
-                        delete fullOptions.audio.noiseCancellationOptions;
+                    if (typeof fullOptions.audio === 'object') {
+                        if (typeof fullOptions.audio.workaroundWebKitBug1208516 === 'boolean') {
+                            extraLocalTrackOptions.audio.workaroundWebKitBug1208516 = fullOptions.audio.workaroundWebKitBug1208516;
+                        }
+                        if ('noiseCancellationOptions' in fullOptions.audio) {
+                            noiseCancellationOptions = fullOptions.audio.noiseCancellationOptions;
+                            delete fullOptions.audio.noiseCancellationOptions;
+                        }
+                        if (!('defaultDeviceCaptureMode' in fullOptions.audio)) {
+                            extraLocalTrackOptions.audio.defaultDeviceCaptureMode = 'auto';
+                        }
+                        else if (['auto', 'manual'].every(function (mode) { return mode !== fullOptions.audio.defaultDeviceCaptureMode; })) {
+                            // eslint-disable-next-line new-cap
+                            throw INVALID_VALUE('CreateLocalAudioTrackOptions.defaultDeviceCaptureMode', ['auto', 'manual']);
+                        }
+                        else {
+                            extraLocalTrackOptions.audio.defaultDeviceCaptureMode = fullOptions.audio.defaultDeviceCaptureMode;
+                        }
                     }
                     if (typeof fullOptions.video === 'object' && typeof fullOptions.video.workaroundWebKitBug1208516 === 'boolean') {
                         extraLocalTrackOptions.video.workaroundWebKitBug1208516 = fullOptions.video.workaroundWebKitBug1208516;
@@ -2676,17 +2696,6 @@ var AudioTrack = /** @class */ (function (_super) {
     function AudioTrack(mediaTrackTransceiver, options) {
         return _super.call(this, mediaTrackTransceiver, options) || this;
     }
-    /**
-     * @private
-     */
-    AudioTrack.prototype._start = function () {
-        _super.prototype._start.call(this);
-        if (this._dummyEl) {
-            // once started let go of dummy element
-            this._dummyEl.srcObject = null;
-            this._dummyEl = null;
-        }
-    };
     /**
      * Create an HTMLAudioElement and attach the {@link AudioTrack} to it.
      *
@@ -2980,6 +2989,7 @@ var __extends = (this && this.__extends) || (function () {
         d.prototype = b === null ? Object.create(b) : (__.prototype = b.prototype, new __());
     };
 })();
+var isIOS = require('../../util/browserdetection').isIOS;
 var AudioTrack = require('./audiotrack');
 var mixinLocalMediaTrack = require('./localmediatrack');
 var LocalMediaAudioTrack = mixinLocalMediaTrack(AudioTrack);
@@ -3012,13 +3022,61 @@ var LocalAudioTrack = /** @class */ (function (_super) {
         var _this = this;
         var noiseCancellation = (options === null || options === void 0 ? void 0 : options.noiseCancellation) || null;
         _this = _super.call(this, mediaStreamTrack, options) || this;
+        var log = _this._log;
+        var _a = mediaStreamTrack.label, defaultDeviceLabel = _a === void 0 ? '' : _a;
+        var _b = mediaStreamTrack.getSettings(), _c = _b.deviceId, defaultDeviceId = _c === void 0 ? '' : _c, _d = _b.groupId, defaultGroupId = _d === void 0 ? '' : _d;
         Object.defineProperties(_this, {
+            _currentDefaultDeviceInfo: {
+                value: { deviceId: defaultDeviceId, groupId: defaultGroupId, label: defaultDeviceLabel },
+                writable: true
+            },
+            _defaultDeviceCaptureMode: {
+                value: !isIOS()
+                    && _this._isCreatedByCreateLocalTracks
+                    && typeof navigator === 'object'
+                    && typeof navigator.mediaDevices === 'object'
+                    && typeof navigator.mediaDevices.addEventListener === 'function'
+                    && typeof navigator.mediaDevices.enumerateDevices === 'function'
+                    ? (options === null || options === void 0 ? void 0 : options.defaultDeviceCaptureMode) || 'auto'
+                    : 'manual'
+            },
+            _onDeviceChange: {
+                value: function () {
+                    navigator.mediaDevices.enumerateDevices().then(function (deviceInfos) {
+                        // NOTE(mmalavalli): In Chrome, when the default device changes, and we restart the LocalAudioTrack with
+                        // device ID "default", it will not switch to the new default device unless all LocalAudioTracks capturing
+                        // from the old default device are stopped. So, we restart the LocalAudioTrack with the actual device ID of
+                        // the new default device instead.
+                        var defaultDeviceInfo = deviceInfos.find(function (_a) {
+                            var deviceId = _a.deviceId, kind = _a.kind;
+                            return kind === 'audioinput' && deviceId !== 'default';
+                        });
+                        if (defaultDeviceInfo && ['deviceId', 'groupId'].some(function (prop) {
+                            return defaultDeviceInfo[prop] !== _this._currentDefaultDeviceInfo[prop];
+                        })) {
+                            log.info('Default device changed, restarting the LocalAudioTrack');
+                            log.debug("Old default device: \"" + _this._currentDefaultDeviceInfo.deviceId + "\" => \"" + _this._currentDefaultDeviceInfo.label + "\"");
+                            log.debug("New default device: \"" + defaultDeviceInfo.deviceId + "\" => \"" + defaultDeviceInfo.label + "\"");
+                            _this._currentDefaultDeviceInfo = defaultDeviceInfo;
+                            _this._restartDefaultDevice().catch(function (error) { return log.warn("Failed to restart: " + error.message); });
+                        }
+                    }, function (error) {
+                        log.warn("Failed to run enumerateDevices(): " + error.message);
+                    });
+                }
+            },
+            _restartOnDefaultDeviceChangeCleanup: {
+                value: null,
+                writable: true
+            },
             noiseCancellation: {
                 enumerable: true,
                 value: noiseCancellation,
                 writable: false
             },
         });
+        log.debug('defaultDeviceCaptureMode:', _this._defaultDeviceCaptureMode);
+        _this._maybeRestartOnDefaultDeviceChange();
         return _this;
     }
     LocalAudioTrack.prototype.toString = function () {
@@ -3035,6 +3093,51 @@ var LocalAudioTrack = /** @class */ (function (_super) {
     LocalAudioTrack.prototype._end = function () {
         return _super.prototype._end.apply(this, arguments);
     };
+    /**
+     * @private
+     */
+    LocalAudioTrack.prototype._maybeRestartOnDefaultDeviceChange = function () {
+        var _this = this;
+        var _a = this, constraints = _a._constraints, defaultDeviceCaptureMode = _a._defaultDeviceCaptureMode, log = _a._log;
+        var mediaStreamTrack = this.noiseCancellation ? this.noiseCancellation.sourceTrack : this.mediaStreamTrack;
+        var deviceId = mediaStreamTrack.getSettings().deviceId;
+        var isNotEqualToCapturedDeviceIdOrEqualToDefault = function (requestedDeviceId) {
+            return requestedDeviceId !== deviceId || requestedDeviceId === 'default';
+        };
+        var isCapturingFromDefaultDevice = (function checkIfCapturingFromDefaultDevice(deviceIdConstraint) {
+            if (deviceIdConstraint === void 0) { deviceIdConstraint = {}; }
+            if (typeof deviceIdConstraint === 'string') {
+                return isNotEqualToCapturedDeviceIdOrEqualToDefault(deviceIdConstraint);
+            }
+            else if (Array.isArray(deviceIdConstraint)) {
+                return deviceIdConstraint.every(isNotEqualToCapturedDeviceIdOrEqualToDefault);
+            }
+            else if (deviceIdConstraint.exact) {
+                return checkIfCapturingFromDefaultDevice(deviceIdConstraint.exact);
+            }
+            else if (deviceIdConstraint.ideal) {
+                return checkIfCapturingFromDefaultDevice(deviceIdConstraint.ideal);
+            }
+            return true;
+        }(constraints.deviceId));
+        if (defaultDeviceCaptureMode === 'auto' && isCapturingFromDefaultDevice) {
+            if (!this._restartOnDefaultDeviceChangeCleanup) {
+                log.info('LocalAudioTrack will be restarted if the default device changes');
+                navigator.mediaDevices.addEventListener('devicechange', this._onDeviceChange);
+                this._restartOnDefaultDeviceChangeCleanup = function () {
+                    log.info('Cleaning up the listener to restart the LocalAudioTrack if the default device changes');
+                    navigator.mediaDevices.removeEventListener('devicechange', _this._onDeviceChange);
+                    _this._restartOnDefaultDeviceChangeCleanup = null;
+                };
+            }
+        }
+        else {
+            log.info('LocalAudioTrack will NOT be restarted if the default device changes');
+            if (this._restartOnDefaultDeviceChangeCleanup) {
+                this._restartOnDefaultDeviceChangeCleanup();
+            }
+        }
+    };
     /**
      * @private
      */
@@ -3048,6 +3151,21 @@ var LocalAudioTrack = /** @class */ (function (_super) {
         }
         return _super.prototype._reacquireTrack.call(this, constraints);
     };
+    /**
+     * @private
+     */
+    LocalAudioTrack.prototype._restartDefaultDevice = function () {
+        var _this = this;
+        var constraints = Object.assign({}, this._constraints);
+        var restartConstraints = Object.assign({}, constraints, { deviceId: this._currentDefaultDeviceInfo.deviceId });
+        return this.restart(restartConstraints).then(function () {
+            // NOTE(mmalavalli): Since we used the new default device's ID while restarting the LocalAudioTrack,
+            // we reset the constraints to the original constraints so that the default device detection logic in
+            // _maybeRestartOnDefaultDeviceChange() still works.
+            _this._constraints = constraints;
+            _this._maybeRestartOnDefaultDeviceChange();
+        });
+    };
     /**
      * Disable the {@link LocalAudioTrack}. This is effectively "mute".
      * @returns {this}
@@ -3119,6 +3237,9 @@ var LocalAudioTrack = /** @class */ (function (_super) {
         if (this.noiseCancellation) {
             this.noiseCancellation.stop();
         }
+        if (this._restartOnDefaultDeviceChangeCleanup) {
+            this._restartOnDefaultDeviceChangeCleanup();
+        }
         return _super.prototype.stop.apply(this, arguments);
     };
     return LocalAudioTrack;
@@ -3149,7 +3270,7 @@ var LocalAudioTrack = /** @class */ (function (_super) {
  */
 module.exports = LocalAudioTrack;
 
-},{"./audiotrack":13,"./localmediatrack":23}],20:[function(require,module,exports){
+},{"../../util/browserdetection":122,"./audiotrack":13,"./localmediatrack":23}],20:[function(require,module,exports){
 'use strict';
 var __extends = (this && this.__extends) || (function () {
     var extendStatics = function (d, b) {
@@ -3398,8 +3519,8 @@ var __extends = (this && this.__extends) || (function () {
     };
 })();
 var getUserMedia = require('../../webrtc').getUserMedia;
-var _a = require('../../webrtc/util'), guessBrowser = _a.guessBrowser, isIOSChrome = _a.isIOSChrome;
-var _b = require('../../util'), capitalize = _b.capitalize, defer = _b.defer, isUserMediaTrack = _b.isUserMediaTrack, waitForSometime = _b.waitForSometime, waitForEvent = _b.waitForEvent;
+var isIOS = require('../../util/browserdetection').isIOS;
+var _a = require('../../util'), capitalize = _a.capitalize, defer = _a.defer, isUserMediaTrack = _a.isUserMediaTrack, waitForSometime = _a.waitForSometime, waitForEvent = _a.waitForEvent;
 var ILLEGAL_INVOKE = require('../../util/constants').typeErrors.ILLEGAL_INVOKE;
 var detectSilentAudio = require('../../util/detectsilentaudio');
 var detectSilentVideo = require('../../util/detectsilentvideo');
@@ -3425,10 +3546,7 @@ function mixinLocalMediaTrack(AudioOrVideoTrack) {
          */
         function LocalMediaTrack(mediaStreamTrack, options) {
             var _this = this;
-            // NOTE(mpatwardhan): by default workaround for WebKitBug1208516 will be enabled on Safari browsers
-            // although the bug is seen  mainly on iOS devices, we do not have a reliable way to tell iOS from MacOs
-            // userAgent on iOS pretends its macOs if Safari is set to request desktop pages.
-            var workaroundWebKitBug1208516 = (guessBrowser() === 'safari' || isIOSChrome())
+            var workaroundWebKitBug1208516 = isIOS()
                 && isUserMediaTrack(mediaStreamTrack)
                 && typeof document === 'object'
                 && typeof document.addEventListener === 'function'
@@ -3737,7 +3855,7 @@ function restartWhenInadvertentlyStopped(localMediaTrack) {
 }
 module.exports = mixinLocalMediaTrack;
 
-},{"../../util":131,"../../util/constants":124,"../../util/detectsilentaudio":125,"../../util/detectsilentvideo":126,"../../util/documentvisibilitymonitor.js":127,"../../util/localmediarestartdeferreds":134,"../../webaudio/workaround180748":154,"../../webrtc":157,"../../webrtc/util":170,"./sender":38}],24:[function(require,module,exports){
+},{"../../util":131,"../../util/browserdetection":122,"../../util/constants":124,"../../util/detectsilentaudio":125,"../../util/detectsilentvideo":126,"../../util/documentvisibilitymonitor.js":127,"../../util/localmediarestartdeferreds":134,"../../webaudio/workaround180748":154,"../../webrtc":157,"./sender":38}],24:[function(require,module,exports){
 /* eslint new-cap:0 */
 'use strict';
 var __extends = (this && this.__extends) || (function () {
@@ -3920,7 +4038,7 @@ var __extends = (this && this.__extends) || (function () {
         d.prototype = b === null ? Object.create(b) : (__.prototype = b.prototype, new __());
     };
 })();
-var _a = require('../../webrtc/util'), guessBrowser = _a.guessBrowser, isIOSChrome = _a.isIOSChrome;
+var isIOS = require('../../util/browserdetection').isIOS;
 var detectSilentVideo = require('../../util/detectsilentvideo');
 var mixinLocalMediaTrack = require('./localmediatrack');
 var VideoTrack = require('./videotrack');
@@ -3951,7 +4069,7 @@ var LocalVideoTrack = /** @class */ (function (_super) {
     function LocalVideoTrack(mediaStreamTrack, options) {
         var _this = this;
         options = Object.assign({
-            workaroundSilentLocalVideo: (guessBrowser() === 'safari' || isIOSChrome())
+            workaroundSilentLocalVideo: isIOS()
                 && isUserMediaTrack(mediaStreamTrack)
                 && typeof document !== 'undefined'
                 && typeof document.createElement === 'function'
@@ -4250,7 +4368,7 @@ function workaroundSilentLocalVideo(localVideoTrack, doc) {
  */
 module.exports = LocalVideoTrack;
 
-},{"../../util":131,"../../util/detectsilentvideo":126,"../../webrtc/util":170,"./localmediatrack":23,"./videotrack":42}],26:[function(require,module,exports){
+},{"../../util":131,"../../util/browserdetection":122,"../../util/detectsilentvideo":126,"./localmediatrack":23,"./videotrack":42}],26:[function(require,module,exports){
 'use strict';
 var __extends = (this && this.__extends) || (function () {
     var extendStatics = function (d, b) {
@@ -4313,9 +4431,9 @@ var __extends = (this && this.__extends) || (function () {
         d.prototype = b === null ? Object.create(b) : (__.prototype = b.prototype, new __());
     };
 })();
-var _a = require('../../webrtc/util'), guessBrowser = _a.guessBrowser, isIOSChrome = _a.isIOSChrome;
+var isIOS = require('../../util/browserdetection').isIOS;
 var MediaStream = require('../../webrtc').MediaStream;
-var _b = require('../../util'), waitForEvent = _b.waitForEvent, waitForSometime = _b.waitForSometime;
+var _a = require('../../util'), waitForEvent = _a.waitForEvent, waitForSometime = _a.waitForSometime;
 var localMediaRestartDeferreds = require('../../util/localmediarestartdeferreds');
 var Track = require('./');
 /**
@@ -4345,7 +4463,7 @@ var MediaTrack = /** @class */ (function (_super) {
     function MediaTrack(mediaTrackTransceiver, options) {
         var _this = this;
         options = Object.assign({
-            playPausedElementsIfNotBackgrounded: (guessBrowser() === 'safari' || isIOSChrome())
+            playPausedElementsIfNotBackgrounded: isIOS()
                 && typeof document === 'object'
                 && typeof document.addEventListener === 'function'
                 && typeof document.visibilityState === 'string'
@@ -4660,7 +4778,7 @@ function shimMediaElement(el, onUnintentionallyPaused) {
 }
 module.exports = MediaTrack;
 
-},{"../../util":131,"../../util/localmediarestartdeferreds":134,"../../webrtc":157,"../../webrtc/util":170,"./":18}],28:[function(require,module,exports){
+},{"../../util":131,"../../util/browserdetection":122,"../../util/localmediarestartdeferreds":134,"../../webrtc":157,"./":18}],28:[function(require,module,exports){
 'use strict';
 var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
     function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
@@ -4978,6 +5096,18 @@ var RemoteAudioTrack = /** @class */ (function (_super) {
     RemoteAudioTrack.prototype.toString = function () {
         return "[RemoteAudioTrack #" + this._instanceId + ": " + this.sid + "]";
     };
+    /**
+     * @private
+     */
+    RemoteAudioTrack.prototype._start = function () {
+        _super.prototype._start.call(this);
+        if (this._dummyEl) {
+            // NOTE(mpatwardhan): To fix VIDEO-6336, clear dummy element after the
+            // RemoteAudioTrack has started.
+            this._dummyEl.srcObject = null;
+            this._dummyEl = null;
+        }
+    };
     /**
      * Update the subscribe {@link Track.Priority} of the {@link RemoteAudioTrack}.
      * @param {?Track.Priority} priority - the new subscribe {@link Track.Priority};
@@ -5382,7 +5512,7 @@ var __spreadArray = (this && this.__spreadArray) || function (to, from) {
     return to;
 };
 var _a = require('../../util/constants'), E = _a.typeErrors, trackPriority = _a.trackPriority;
-var _b = require('../../webrtc/util'), guessBrowser = _b.guessBrowser, isIOSChrome = _b.isIOSChrome;
+var isIOS = require('../../util/browserdetection').isIOS;
 var documentVisibilityMonitor = require('../../util/documentvisibilitymonitor.js');
 function mixinRemoteMediaTrack(AudioOrVideoTrack) {
     /**
@@ -5416,7 +5546,7 @@ function mixinRemoteMediaTrack(AudioOrVideoTrack) {
                 // NOTE(mpatwardhan): WebKit bug: 212780 sometimes causes the audio/video elements to stay paused when safari
                 // regains foreground. To workaround it, when safari gains foreground - we will play any elements that were
                 // playing before safari lost foreground.
-                workaroundWebKitBug212780: (guessBrowser() === 'safari' || isIOSChrome())
+                workaroundWebKitBug212780: isIOS()
                     && typeof document === 'object'
                     && typeof document.addEventListener === 'function'
                     && typeof document.visibilityState === 'string'
@@ -5629,7 +5759,7 @@ function playIfPausedWhileInBackground(remoteMediaTrack) {
  */
 module.exports = mixinRemoteMediaTrack;
 
-},{"../../util/constants":124,"../../util/documentvisibilitymonitor.js":127,"../../webrtc/util":170}],35:[function(require,module,exports){
+},{"../../util/browserdetection":122,"../../util/constants":124,"../../util/documentvisibilitymonitor.js":127}],35:[function(require,module,exports){
 'use strict';
 var __extends = (this && this.__extends) || (function () {
     var extendStatics = function (d, b) {
@@ -20660,36 +20790,37 @@ var __read = (this && this.__read) || function (o, n) {
 function isAndroid() {
     return /Android/.test(navigator.userAgent);
 }
-/**
- * Check whether the current browser is an iOS device.
- * @returns {boolean}
- */
-function isIOS() {
-    return /iPad|iPhone|iPod/.test(navigator.userAgent);
-}
 /**
  * Detects whether or not a device is an Apple touch screen device.
  * @returns {boolean}
  */
 function hasTouchScreen() {
-    return navigator && navigator.maxTouchPoints &&
-        navigator.maxTouchPoints > 2;
+    return !!(navigator && navigator.maxTouchPoints && navigator.maxTouchPoints > 2);
 }
 /**
- * Detects whether or not a device is an iPad
+ * Detects whether or not a device is an iPad.
  * @returns {boolean}
  */
 function isIpad() {
-    return hasTouchScreen() && window.screen.width >= 744 &&
-        (/Macintosh/i.test(navigator.userAgent) || /iPad/.test(navigator.userAgent) || /iPad/.test(navigator.platform));
+    return hasTouchScreen() && window.screen.width >= 744 && (/Macintosh/i.test(navigator.userAgent)
+        || /iPad/.test(navigator.userAgent)
+        || /iPad/.test(navigator.platform));
 }
 /**
- * Detects whether or not a device is an iPhone
+ * Detects whether or not a device is an iPhone.
  * @returns {boolean}
  */
 function isIphone() {
-    return hasTouchScreen() && window.screen.width <= 476 &&
-        (/Macintosh/i.test(navigator.userAgent) || /iPhone/.test(navigator.userAgent) || /iPhone/.test(navigator.platform));
+    return hasTouchScreen() && window.screen.width <= 476 && (/Macintosh/i.test(navigator.userAgent)
+        || /iPhone/.test(navigator.userAgent)
+        || /iPhone/.test(navigator.platform));
+}
+/**
+ * Check whether the current device is an iOS device.
+ * @returns {boolean}
+ */
+function isIOS() {
+    return isIpad() || isIphone();
 }
 /**
  * Check whether the current browser is a mobile browser
@@ -27533,12 +27664,6 @@ var FirefoxRTCSessionDescription = require('../rtcsessiondescription/firefox');
 var inherits = require('../../vendor/inherits');
 var updateTracksToSSRCs = require('../util/sdp').updateUnifiedPlanTrackIdsToSSRCs;
 var util = require('../util');
-// NOTE(mroberts): This is a short-lived workaround. Checking the user agent
-// string might not fix every affected Firefox instance, but it should be good
-// enough for this bug.
-var needsWorkaroundForBug1480277 = typeof navigator === 'object'
-    && navigator.userAgent
-    && (navigator.userAgent.match(/Firefox\/61/) || navigator.userAgent.match(/Firefox\/62/));
 // NOTE(mroberts): This class wraps Firefox's RTCPeerConnection implementation.
 // It provides some functionality not currently present in Firefox, namely the
 // abilities to
@@ -27637,14 +27762,6 @@ Object.defineProperty(FirefoxRTCPeerConnection.prototype, 'peerIdentity', {
         name: ''
     })
 });
-if (needsWorkaroundForBug1480277) {
-    FirefoxRTCPeerConnection.prototype.addTrack = function addTrack() {
-        var track = arguments[0];
-        var sender = this._peerConnection.addTrack.apply(this._peerConnection, arguments);
-        sender.replaceTrack(track);
-        return sender;
-    };
-}
 FirefoxRTCPeerConnection.prototype.createAnswer = function createAnswer() {
     var args = [].slice.call(arguments);
     var promise;
@@ -29545,7 +29662,7 @@ module.exports={
   "name": "twilio-video",
   "title": "Twilio Video",
   "description": "Twilio Video JavaScript Library",
-  "version": "2.24.2",
+  "version": "2.25.0",
   "homepage": "https://twilio.com",
   "author": "Mark Andrus Roberts <mroberts@twilio.com>",
   "contributors": [
@@ -29646,7 +29763,7 @@ module.exports={
     "test:serversiderender": "mocha ./test/serversiderender/index.js",
     "test:integration:adapter": "node ./scripts/karma.js karma/integration.adapter.conf.js",
     "test:integration": "npm run build:es5 && node ./scripts/karma.js karma/integration.conf.js",
-    "test:umd:install": "npm install puppeteer@5.5.0",
+    "test:umd:install": "npm install puppeteer@19.2.2",
     "test:umd": "mocha ./test/umd/index.js",
     "test:crossbrowser:build:clean": "rimraf ./test/crossbrowser/lib ./test/crossbrowser/src/browser/index.js",
     "test:crossbrowser:build:lint": "cd ./test/crossbrowser && tslint --project tsconfig.json",