twilio-video 3.0.0-preview.1 → 3.0.0-preview.2

package/CHANGELOG.md

@@ -2,6 +2,15 @@ The Twilio Programmable Video SDKs use [Semantic Versioning](http://www.semver.o
 
 **Version 1.x reached End of Life on September 8th, 2021.** See the changelog entry [here](https://www.twilio.com/changelog/end-of-life-complete-for-unsupported-versions-of-the-programmable-video-sdk). Support for the 1.x version ended on December 4th, 2020.
 
+3.0.0-preview.2 (August 18, 2022)
+=================================
+
+Changes
+-------
+
+- `Room.getStats()`, which was broken in `3.0.0-preview.1`, has been fixed in this release. Note that the values reported
+  are best-effort approximations based off of the raw WebRTC statistics. (VIDEO-8756)
+
 3.0.0-preview.1 (July 25, 2022)
 ===============================
 

package/README.md

@@ -74,7 +74,7 @@ Releases of twilio-video.js are hosted on a CDN, and you can include these
 directly in your web app using a <script> tag.
 
 ```html
-<script src="//sdk.twilio.com/js/video/releases/3.0.0-preview.1/twilio-video.min.js"></script>
+<script src="//sdk.twilio.com/js/video/releases/3.0.0-preview.2/twilio-video.min.js"></script>
 
 ```
 

package/dist/twilio-video.js

@@ -1,4 +1,4 @@
-/*! twilio-video.js 3.0.0-preview.1
+/*! twilio-video.js 3.0.0-preview.2
 
 The following license applies to all parts of this software except as
 documented below.
@@ -9625,8 +9625,8 @@ var Room = /** @class */ (function (_super) {
     };
     /**
      * Get the {@link Room}'s media statistics. This is not supported in Safari 12.0 or below
-     * due to this bug : https://bugs.webkit.org/show_bug.cgi?id=192601
-     *
+     * due to this bug : https://bugs.webkit.org/show_bug.cgi?id=192601. Note that the values
+     * reported are best-effort approximations based off of the raw WebRTC statistics.
      * @returns {Promise.<Array<StatsReport>>}
      */
     Room.prototype.getStats = function () {
@@ -12840,7 +12840,7 @@ var __spreadArray = (this && this.__spreadArray) || function (to, from) {
     return to;
 };
 var DefaultBackoff = require('../../util/backoff');
-var _a = require('../../webrtc'), DefaultRTCIceCandidate = _a.RTCIceCandidate, DefaultRTCPeerConnection = _a.RTCPeerConnection, DefaultRTCSessionDescription = _a.RTCSessionDescription, getStatistics = _a.getStats;
+var _a = require('../../webrtc'), DefaultRTCIceCandidate = _a.RTCIceCandidate, DefaultRTCPeerConnection = _a.RTCPeerConnection, DefaultRTCSessionDescription = _a.RTCSessionDescription, getStatistics = _a.getStats, getTrackStatistics = _a.getTrackStats;
 var util = require('../../webrtc/util');
 var _b = require('../../util/constants'), DEFAULT_ICE_GATHERING_TIMEOUT_MS = _b.DEFAULT_ICE_GATHERING_TIMEOUT_MS, DEFAULT_LOG_LEVEL = _b.DEFAULT_LOG_LEVEL, DEFAULT_SESSION_TIMEOUT_SEC = _b.DEFAULT_SESSION_TIMEOUT_SEC, iceRestartBackoffConfig = _b.iceRestartBackoffConfig;
 var _c = require('../../util/sdp'), addOrRewriteNewTrackIds = _c.addOrRewriteNewTrackIds, addOrRewriteTrackIds = _c.addOrRewriteTrackIds, createCodecMapForMediaSection = _c.createCodecMapForMediaSection, disableRtx = _c.disableRtx, enableDtxForOpus = _c.enableDtxForOpus, filterLocalCodecs = _c.filterLocalCodecs, getMediaSections = _c.getMediaSections, removeSSRCAttributes = _c.removeSSRCAttributes, revertSimulcast = _c.revertSimulcast, setCodecPreferences = _c.setCodecPreferences, setSimulcast = _c.setSimulcast;
@@ -14380,6 +14380,19 @@ var PeerConnectionV2 = /** @class */ (function (_super) {
             });
         });
     };
+    /**
+     * Get the statistics for a given remote MediaStreamTrack
+     * @param {MediaStreamTrack} mediaStreamTrack
+     * @returns {Promise<StandardizedTrackStatsReport>}
+     */
+    PeerConnectionV2.prototype.getRemoteTrackStats = function (mediaStreamTrack) {
+        var _this = this;
+        return getTrackStatistics(this._peerConnection, mediaStreamTrack, { isRemote: true })
+            .then(function (_a) {
+            var _b = __read(_a, 1), stats = _b[0];
+            return rewriteTrackId(_this, stats);
+        });
+    };
     /**
      * Get the {@link PeerConnectionV2}'s media statistics.
      * @returns {Promise<StandardizedStatsResponse>}
@@ -15030,6 +15043,18 @@ var PeerConnectionManager = /** @class */ (function (_super) {
             return _this;
         });
     };
+    /**
+     * Get the statistics for a remote MediaStreamTrack.
+     * @param {MediaStreamTrack} mediaStreamTrack
+     * @returns {Promise<Map<PeerConnectionV2#id, StandardizedTrackStatsReport>>}
+     */
+    PeerConnectionManager.prototype.getRemoteTrackStats = function (mediaStreamTrack) {
+        var peerConnections = Array.from(this._peerConnections.values());
+        return Promise.all(peerConnections.map(function (peerConnection) { return peerConnection.getRemoteTrackStats(mediaStreamTrack).then(function (stats) { return [
+            peerConnection.id,
+            stats
+        ]; }); })).then(function (reports) { return new Map(reports); });
+    };
     /**
      * Get the {@link PeerConnectionManager}'s media statistics.
      * @returns {Promise.<Map<PeerConnectionV2#id, StandardizedStatsResponse>>}
@@ -15422,6 +15447,9 @@ var RemoteParticipantV2 = /** @class */ (function (_super) {
             _getPendingTrackReceiver: {
                 value: options.getPendingTrackReceiver
             },
+            _getTrackStats: {
+                value: options.getTrackStats
+            },
             updateSubscriberTrackPriority: {
                 value: function (trackSid, priority) { return setPriority(trackSid, priority); }
             },
@@ -15820,9 +15848,6 @@ var RoomV2 = /** @class */ (function (_super) {
             _RemoteParticipantSignaling: {
                 value: options.RemoteParticipantSignaling
             },
-            _subscribed: {
-                value: new Map()
-            },
             _subscribedRevision: {
                 value: 0,
                 writable: true
@@ -15830,6 +15855,9 @@ var RoomV2 = /** @class */ (function (_super) {
             _subscriptionFailures: {
                 value: new Map()
             },
+            _trackSidsToTrackIds: {
+                value: new Map()
+            },
             _dominantSpeakerSignaling: {
                 value: new options.DominantSpeakerSignaling(getTrackReceiver, { log: log })
             },
@@ -16101,7 +16129,7 @@ var RoomV2 = /** @class */ (function (_super) {
             }
         });
         trackSidsToTrackSignalings.forEach(function (trackSignaling) {
-            var trackId = _this._subscribed.get(trackSignaling.sid);
+            var trackId = _this._trackSidsToTrackIds.get(trackSignaling.sid);
             if (!trackId || (trackSignaling.isSubscribed && trackSignaling.trackTransceiver.id !== trackId)) {
                 trackSignaling.setTrackTransceiver(null);
             }
@@ -16228,7 +16256,7 @@ var RoomV2 = /** @class */ (function (_super) {
         subscribed.tracks.forEach(function (trackState) {
             if (trackState.id) {
                 _this._subscriptionFailures.delete(trackState.sid);
-                _this._subscribed.set(trackState.sid, trackState.id);
+                _this._trackSidsToTrackIds.set(trackState.sid, trackState.id);
             }
             else if (trackState.error && !_this._subscriptionFailures.has(trackState.sid)) {
                 _this._subscriptionFailures.set(trackState.sid, trackState.error);
@@ -16237,9 +16265,9 @@ var RoomV2 = /** @class */ (function (_super) {
         var subscribedTrackSids = new Set(subscribed.tracks
             .filter(function (trackState) { return !!trackState.id; })
             .map(function (trackState) { return trackState.sid; }));
-        this._subscribed.forEach(function (trackId, trackSid) {
+        this._trackSidsToTrackIds.forEach(function (trackId, trackSid) {
             if (!subscribedTrackSids.has(trackSid)) {
-                _this._subscribed.delete(trackSid);
+                _this._trackSidsToTrackIds.delete(trackSid);
             }
         });
     };
@@ -16380,7 +16408,7 @@ function filterAndAddLocalTrackSids(roomV2, localTrackStats) {
  * @returns {Array<RemoteTrackStats>}
  */
 function filterAndAddRemoteTrackSids(roomV2, remoteTrackStats) {
-    var idToSid = new Map(Array.from(roomV2._subscribed.entries()).map(function (_a) {
+    var idToSid = new Map(Array.from(roomV2._trackSidsToTrackIds.entries()).map(function (_a) {
         var _b = __read(_a, 2), sid = _b[0], id = _b[1];
         return [id, sid];
     }));
@@ -17383,13 +17411,15 @@ var RemoteParticipantV3 = /** @class */ (function (_super) {
      * @param {function(Track.SID, Track.Priority): boolean} setPriority
      * @param {function(Track.SID, ClientRenderHint): Promise<void>} setRenderHint
      * @param {function(Track.SID): void} clearTrackHint
+     * @param {function(MediaStreamTrack): Promise<Map<PeerConnectionV2#id, StandardizedTrackStatsReport>>} getTrackStats
      * @param {object} [options]
      */
-    function RemoteParticipantV3(participantState, getPendingTrackReceiver, getInitialTrackSwitchOffState, setPriority, setRenderHint, clearTrackHint, options) {
+    function RemoteParticipantV3(participantState, getPendingTrackReceiver, getInitialTrackSwitchOffState, setPriority, setRenderHint, clearTrackHint, getTrackStats, options) {
         var _this = this;
         options = Object.assign({
             RemoteTrackPublicationSignaling: RemoteTrackPublicationV3,
-            getPendingTrackReceiver: getPendingTrackReceiver
+            getPendingTrackReceiver: getPendingTrackReceiver,
+            getTrackStats: getTrackStats
         }, options);
         _this = _super.call(this, participantState, getInitialTrackSwitchOffState, setPriority, setRenderHint, clearTrackHint, options) || this;
         return _this;
@@ -17398,13 +17428,13 @@ var RemoteParticipantV3 = /** @class */ (function (_super) {
      * @private
      */
     RemoteParticipantV3.prototype._getOrCreateTrack = function (trackState) {
-        var _a = this, RemoteTrackPublicationV3 = _a._RemoteTrackPublicationSignaling, getPendingTrackReceiver = _a._getPendingTrackReceiver;
+        var _a = this, RemoteTrackPublicationV3 = _a._RemoteTrackPublicationSignaling, getPendingTrackReceiver = _a._getPendingTrackReceiver, getTrackStats = _a._getTrackStats;
         var track = this.tracks.get(trackState.sid);
         if (!track) {
             var _b = this.kind === 'data'
                 ? { state: 'ON', switchOffReason: null }
-                : this._getInitialTrackSwitchOffState(trackState.sid), state = _b.state, switchOffReason = _b.switchOffReason;
-            track = new RemoteTrackPublicationV3(trackState, state === 'OFF', switchOffReason);
+                : this._getInitialTrackSwitchOffState(trackState.sid), state = _b.state, _c = _b.switchOffReason, switchOffReason = _c === void 0 ? null : _c;
+            track = new RemoteTrackPublicationV3(trackState, state === 'OFF', switchOffReason, getTrackStats);
             this.addTrack(track);
             getPendingTrackReceiver(track.sid).then(function (trackReceiver) {
                 // NOTE(mmalavalli): DataTracks are subscribed to only if corresponding DataTrackReceivers
@@ -17448,22 +17478,37 @@ var RemoteTrackPublicationV3 = /** @class */ (function (_super) {
      * @param {RemoteTrackPublicationV3#Representation} track
      * @param {boolean} isSwitchedOff
      * @param {?string} switchOffReason
+     * @param {function(MediaStreamTrack): Promise<Map<PeerConnectionV2#id, StandardizedTrackStatsReport>>} getTrackStats
      */
-    function RemoteTrackPublicationV3(track, isSwitchedOff, switchOffReason) {
-        if (switchOffReason === void 0) { switchOffReason = null; }
+    function RemoteTrackPublicationV3(track, isSwitchedOff, switchOffReason, getTrackStats) {
         var _this = this;
         switchOffReason = isSwitchedOff ? switchOffReason : null;
         var enabled = isEnabled(isSwitchedOff, switchOffReason);
         var kind = track.kind, name = track.name, priority = track.priority, sid = track.sid;
         _this = _super.call(this, sid, name, kind, enabled, priority, isSwitchedOff, 3) || this;
         Object.defineProperties(_this, {
+            _getTrackStats: {
+                value: getTrackStats
+            },
             _isSubscribed: {
                 value: false,
                 writable: true
             },
+            _pendingGetTrackStatsPromise: {
+                value: Promise.resolve(),
+                writable: true
+            },
             _switchOffReason: {
                 value: switchOffReason,
                 writable: true
+            },
+            _switchOffStateChangeStats: {
+                value: initialTrackStats(sid, kind),
+                writable: true
+            },
+            _switchOnMediaStreamTrackStats: {
+                value: initialTrackStats(sid, kind),
+                writable: true
             }
         });
         return _this;
@@ -17490,6 +17535,55 @@ var RemoteTrackPublicationV3 = /** @class */ (function (_super) {
         enumerable: false,
         configurable: true
     });
+    /**
+     * Adjust Track statistics based on new stats. Returns the most recent switched
+     * off state change Track statistics if no argument is provided.
+     * @param {StandardizedTrackStatsReport} [newMediaStreamTrackStats]
+     * @returns {StandardizedTrackStatsReport}
+     */
+    RemoteTrackPublicationV3.prototype.adjustTrackStats = function (newMediaStreamTrackStats) {
+        var _this = this;
+        if (newMediaStreamTrackStats === void 0) { newMediaStreamTrackStats = {}; }
+        var cumulativeStatsProps = [
+            'bytesReceived',
+            'framesDecoded',
+            'packetsLost',
+            'packetsReceived',
+            'totalDecodeTime'
+        ];
+        var snapshotStatsProps = [
+            'audioOutputLevel',
+            'codecName',
+            'estimatedPlayoutTimestamp',
+            'frameHeightReceived',
+            'frameRateReceived',
+            'frameWidthReceived',
+            'jitter',
+            'jitterBufferDelay',
+            'jitterBufferEmittedCount',
+            'roundTripTime',
+            'ssrc',
+            'timestamp',
+            'trackId'
+        ];
+        var trackStats = Object.assign({}, this._switchOffStateChangeStats);
+        cumulativeStatsProps.forEach(function (prop) {
+            if (prop in newMediaStreamTrackStats) {
+                trackStats[prop] = _this._switchOffStateChangeStats[prop] + newMediaStreamTrackStats[prop] - _this._switchOnMediaStreamTrackStats[prop];
+            }
+        });
+        snapshotStatsProps.forEach(function (prop) {
+            if (prop in newMediaStreamTrackStats) {
+                trackStats[prop] = newMediaStreamTrackStats[prop];
+            }
+        });
+        if (!this.isSubscribed || this.isSwitchedOff) {
+            trackStats.ssrc = '';
+            trackStats.timestamp = Date.now();
+            trackStats.trackId = '';
+        }
+        return trackStats;
+    };
     /**
      * Updates track switch on/off state.
      * @param {boolean} isSwitchedOff
@@ -17515,8 +17609,22 @@ var RemoteTrackPublicationV3 = /** @class */ (function (_super) {
      * @returns {this}
      */
     RemoteTrackPublicationV3.prototype.setTrackTransceiver = function (trackReceiver, isSubscribed) {
+        var _this = this;
         isSubscribed = !!trackReceiver || isSubscribed;
         var shouldEmitUpdated = trackReceiver !== this.trackTransceiver || isSubscribed !== this.isSubscribed;
+        if (this.kind !== 'data' && trackReceiver !== this.trackTransceiver) {
+            var track_1 = (trackReceiver || this.trackTransceiver).track;
+            this._pendingGetTrackStatsPromise = this._pendingGetTrackStatsPromise.then(function () { return _this._getTrackStats(track_1); }).then(function (report) {
+                // NOTE(mmalavalli): Because RSPv3 is associated with Large Rooms only, the statistics
+                // map will contain an entry associated with only one RTCPeerConnection.
+                var mediaStreamTrackStats = report.values().next().value;
+                if (trackReceiver) {
+                    _this._switchOnMediaStreamTrackStats = mediaStreamTrackStats;
+                }
+                _this._switchOffStateChangeStats = _this.adjustTrackStats(mediaStreamTrackStats);
+                _this._pendingGetTrackStatsPromise = Promise.resolve();
+            });
+        }
         this._trackTransceiver = trackReceiver;
         this._isSubscribed = isSubscribed;
         if (shouldEmitUpdated) {
@@ -17547,6 +17655,41 @@ var RemoteTrackPublicationV3 = /** @class */ (function (_super) {
 function isEnabled(isSwitchedOff, switchOffReason) {
     return !(isSwitchedOff && switchOffReason === 'DISABLED_BY_PUBLISHER');
 }
+/**
+ * @private
+ * @param {Track.SID} sid
+ * @param {Track.Kind} kind
+ * @returns {StandardizedTrackStatsReport}
+ */
+function initialTrackStats(sid, kind) {
+    return Object.assign({
+        bytesReceived: 0,
+        codecName: '',
+        estimatedPlayoutTimestamp: 0,
+        jitter: 0,
+        jitterBufferDelay: 0,
+        jitterBufferEmittedCount: 0,
+        packetsLost: 0,
+        packetsReceived: 0,
+        roundTripTime: 0,
+        ssrc: '',
+        timestamp: 0,
+        trackId: '',
+        trackSid: sid
+    }, {
+        audio: {
+            audioOutputLevel: 0
+        },
+        data: {},
+        video: {
+            frameHeightReceived: 0,
+            frameRateReceived: 0,
+            framesDecoded: 0,
+            frameWidthReceived: 0,
+            totalDecodeTime: 0
+        }
+    }[kind]);
+}
 /**
  * The Room Signaling Protocol (RSP) representation of a {@link RemoteTrackPublicationV3}.
  * @typedef {object} RemoteTrackPublicationV3#Representation
@@ -17609,7 +17752,7 @@ var RoomV3 = /** @class */ (function (_super) {
     RoomV3.prototype._createRemoteParticipant = function (participantState) {
         var _this = this;
         var RemoteParticipantV3 = this._RemoteParticipantSignaling;
-        return new RemoteParticipantV3(participantState, function (trackSid) { return _this._getPendingTrackReceiver(trackSid); }, function (trackSid) { return _this._getInitialTrackSwitchOffState(trackSid); }, function (trackSid, priority) { return _this._trackPrioritySignaling.sendTrackPriorityUpdate(trackSid, 'subscribe', priority); }, function (trackSid, hint) { return _this._renderHintsSignaling.setTrackHint(trackSid, hint); }, function (trackSid) { return _this._renderHintsSignaling.clearTrackHint(trackSid); });
+        return new RemoteParticipantV3(participantState, function (trackSid) { return _this._getPendingTrackReceiver(trackSid); }, function (trackSid) { return _this._getInitialTrackSwitchOffState(trackSid); }, function (trackSid, priority) { return _this._trackPrioritySignaling.sendTrackPriorityUpdate(trackSid, 'subscribe', priority); }, function (trackSid, hint) { return _this._renderHintsSignaling.setTrackHint(trackSid, hint); }, function (trackSid) { return _this._renderHintsSignaling.clearTrackHint(trackSid); }, function (track) { return _this._peerConnectionManager.getRemoteTrackStats(track); });
     };
     /**
      * @private
@@ -17693,10 +17836,12 @@ var RoomV3 = /** @class */ (function (_super) {
                     // MID. If a RemoteTrackPublicationV3's RemoteTrack is switched off, then we should still be subscribed
                     // to it, even though it no longer has an MID associated with it.
                     trackSignaling.setTrackTransceiver(null, isSwitchedOff);
+                    _this._trackSidsToTrackIds.delete(trackSignaling.sid);
                 }
                 if (!isSwitchedOff) {
                     _this._getTrackReceiver(mid, 'mid').then(function (trackReceiver) {
                         trackSignaling.setTrackTransceiver(trackReceiver, true);
+                        _this._trackSidsToTrackIds.set(trackSignaling.sid, trackReceiver.id);
                         // NOTE(mpatwardhan): when track is switched on, send the switchOn message
                         // only after track receiver is set so that application can access (new) mediaStreamTrack
                         trackSignaling.setSwitchedOff(isSwitchedOff, switchOffReason);
@@ -17728,6 +17873,7 @@ var RoomV3 = /** @class */ (function (_super) {
                     _this._pendingSwitchOffStates.delete(sid);
                     _this._pendingTrackMids.delete(sid);
                     trackSignaling.setTrackTransceiver(null, false);
+                    _this._trackSidsToTrackIds.delete(trackSignaling.sid);
                 }
             });
         });
@@ -17739,6 +17885,55 @@ var RoomV3 = /** @class */ (function (_super) {
     RoomV3.prototype._updateSubscribed = function (roomState) {
         /* Do nothing since RSP v3 messages will not contain the "subscribed" property. */
     };
+    /**
+     * Get the {@link RoomV3}'s media statistics. Note that the values reported
+     * are best-effort approximations based off of the raw WebRTC statistics.
+     * @returns {Promise.<Map<PeerConnectionV2#id, StandardizedStatsResponse>>}
+     */
+    RoomV3.prototype.getStats = function () {
+        var _this = this;
+        return _super.prototype.getStats.call(this).then(function (responses) {
+            var trackSidsToTrackSignalings = _this._getTrackSidsToTrackSignalings();
+            var trackSignalings = Array.from(trackSidsToTrackSignalings.values());
+            var switchedOffMediaTrackSignalings = trackSignalings.filter(function (_a) {
+                var isSubscribed = _a.isSubscribed, isSwitchedOff = _a.isSwitchedOff, kind = _a.kind;
+                return kind !== 'data' && isSubscribed && isSwitchedOff;
+            });
+            var switchedOffMediaTrackSidsToTrackStats = new Map(switchedOffMediaTrackSignalings.map(function (trackSignaling) { return [trackSignaling.sid, trackSignaling.adjustTrackStats()]; }));
+            responses.forEach(function (response) {
+                var remoteAudioTrackStats = response.remoteAudioTrackStats, remoteVideoTrackStats = response.remoteVideoTrackStats;
+                // NOTE(mmalavalli): Adjust stats for switched on RemoteAudioTracks with respect
+                // to its associated MediaStreamTrack.
+                remoteAudioTrackStats.forEach(function (stats, i) {
+                    var trackSignaling = trackSidsToTrackSignalings.get(stats.trackSid);
+                    if (trackSignaling) {
+                        remoteAudioTrackStats[i] = trackSignaling.adjustTrackStats(stats);
+                    }
+                });
+                // NOTE(mmalavalli): Adjust stats for switched on RemoteVideoTracks with respect
+                // to its associated MediaStreamTrack.
+                remoteVideoTrackStats.forEach(function (stats, i) {
+                    var trackSignaling = trackSidsToTrackSignalings.get(stats.trackSid);
+                    if (trackSignaling) {
+                        remoteVideoTrackStats[i] = trackSignaling.adjustTrackStats(stats);
+                    }
+                });
+                // NOTE(mmalavalli): Add stats for switched off media RemoteTracks in
+                // remoteAudioTrackStats and remoteVideoTrackStats respectively.
+                switchedOffMediaTrackSidsToTrackStats.forEach(function (trackStats, trackSid) {
+                    var trackSignaling = trackSidsToTrackSignalings.get(trackSid) || {};
+                    var trackStatsWithTrackSid = Object.assign({ trackSid: trackSid }, trackStats);
+                    if (trackSignaling.kind === 'audio') {
+                        remoteAudioTrackStats.push(trackStatsWithTrackSid);
+                    }
+                    else if (trackSignaling.kind === 'video') {
+                        remoteVideoTrackStats.push(trackStatsWithTrackSid);
+                    }
+                });
+            });
+            return responses;
+        });
+    };
     return RoomV3;
 }(RoomV2));
 module.exports = RoomV3;
@@ -26618,7 +26813,6 @@ function _getStats(peerConnection, options) {
                 isRemote: isRemote
             }, options)).then(function (trackStatsArray) {
                 trackStatsArray.forEach(function (trackStats) {
-                    trackStats.trackId = track.id;
                     statsResponse[statsArrayName].push(trackStats);
                 });
             });
@@ -26879,7 +27073,7 @@ function chromeOrSafariGetTrackStats(peerConnection, track) {
             return;
         }
         peerConnection.getStats(track).then(function (response) {
-            resolve(standardizeChromeOrSafariStats(response));
+            resolve(standardizeChromeOrSafariStats(response, track));
         }, reject);
     });
 }
@@ -26893,7 +27087,7 @@ function chromeOrSafariGetTrackStats(peerConnection, track) {
 function firefoxGetTrackStats(peerConnection, track, isRemote) {
     return new Promise(function (resolve, reject) {
         peerConnection.getStats(track).then(function (response) {
-            resolve([standardizeFirefoxStats(response, isRemote)]);
+            resolve([standardizeFirefoxStats(response, track, isRemote)]);
         }, reject);
     });
 }
@@ -26907,7 +27101,7 @@ function standardizeChromeLegacyStats(response, track) {
     var ssrcReport = response.result().find(function (report) {
         return report.type === 'ssrc' && report.stat('googTrackId') === track.id;
     });
-    var standardizedStats = {};
+    var standardizedStats = { trackId: track.id };
     if (ssrcReport) {
         standardizedStats.timestamp = Math.round(Number(ssrcReport.timestamp));
         standardizedStats = ssrcReport.names().reduce(function (stats, name) {
@@ -26969,9 +27163,10 @@ function standardizeChromeLegacyStats(response, track) {
 /**
  * Standardize the MediaStreamTrack's statistics in Chrome or Safari.
  * @param {RTCStatsResponse} response
+ * @param {MediaStreamTrack} track
  * @returns {Array<StandardizedTrackStatsReport>}
  */
-function standardizeChromeOrSafariStats(response) {
+function standardizeChromeOrSafariStats(response, mediaStreamTrack) {
     var inbound = null;
     // NOTE(mpatwardhan): We should expect more than one "outbound-rtp" stats for a
     // VP8 simulcast MediaStreamTrack.
@@ -27011,7 +27206,7 @@ function standardizeChromeOrSafariStats(response) {
     var stats = [];
     var remoteSource = isRemote ? remoteOutbound : remoteInbound; // remote rtp stats
     mainSources.forEach(function (source) {
-        var standardizedStats = {};
+        var standardizedStats = { trackId: mediaStreamTrack.id };
         var statSources = [
             source,
             localMedia,
@@ -27137,10 +27332,11 @@ function standardizeChromeOrSafariStats(response) {
 /**
  * Standardize the MediaStreamTrack's statistics in Firefox.
  * @param {RTCStatsReport} response
+ * @param {MediaStreamTrack} track
  * @param {boolean} isRemote
  * @returns {StandardizedTrackStatsReport}
  */
-function standardizeFirefoxStats(response, isRemote) {
+function standardizeFirefoxStats(response, track, isRemote) {
     // NOTE(mroberts): If getStats is called on a closed RTCPeerConnection,
     // Firefox returns undefined instead of an RTCStatsReport. We workaround this
     // here. See the following bug for more details:
@@ -27185,7 +27381,7 @@ function standardizeFirefoxStats(response, isRemote) {
         }
         return null;
     }
-    var standardizedStats = {};
+    var standardizedStats = { trackId: track.id };
     var timestamp = getStatValue('timestamp');
     standardizedStats.timestamp = Math.round(timestamp);
     var ssrc = getStatValue('ssrc');
@@ -27353,7 +27549,8 @@ function standardizeFirefoxStats(response, isRemote) {
  * @property {AudioLevel} [audioInputLevel] - The {@link AudioLevel} of the local audio MediaStreamTrack
  * @property {AudioLevel} [audioOutputLevel] - The {@link AudioLevel} of the remote video MediaStreamTrack
  */
-module.exports = getStats;
+exports.getStats = getStats;
+exports.getTrackStats = getTrackStats;
 
 },{"./util":171,"./util/sdp":173}],157:[function(require,module,exports){
 /* globals navigator */
@@ -27381,11 +27578,16 @@ module.exports = getUserMedia;
 
 },{}],158:[function(require,module,exports){
 'use strict';
+var stats = require('./getstats');
 var WebRTC = {};
 Object.defineProperties(WebRTC, {
     getStats: {
         enumerable: true,
-        value: require('./getstats')
+        value: stats.getStats
+    },
+    getTrackStats: {
+        enumerable: true,
+        value: stats.getTrackStats
     },
     getUserMedia: {
         enumerable: true,
@@ -29981,13 +30183,15 @@ module.exports={
   "name": "twilio-video",
   "title": "Twilio Video",
   "description": "Twilio Video JavaScript Library",
-  "version": "3.0.0-preview.1",
+  "version": "3.0.0-preview.2",
   "homepage": "https://twilio.com",
   "author": "Mark Andrus Roberts <mroberts@twilio.com>",
   "contributors": [
     "Ryan Rowland <rrowland@twilio.com>",
     "Manjesh Malavalli <mmalavalli@twilio.com>",
-    "Makarand Patwardhan <mpatwardhan@twilio.com>"
+    "Makarand Patwardhan <mpatwardhan@twilio.com>",
+    "Charlemegne Santos <csantos@twilio.com>",
+    "Joyce Ma <joma@twilio.com>"
   ],
   "keywords": [
     "twilio",