@abrar71/lib-jitsi-meet 0.0.0

package/dist/esm/modules/connectivity/ConnectionQuality.js

@@ -0,0 +1,389 @@
+import { getLogger } from '@jitsi/logger';
+import { JitsiConferenceEvents as ConferenceEvents } from '../../JitsiConferenceEvents';
+import { RTCEvents } from '../../service/RTC/RTCEvents';
+import Resolutions from '../../service/RTC/Resolutions';
+import { VIDEO_QUALITY_LEVELS } from '../../service/RTC/StandardVideoQualitySettings';
+import { VideoType } from '../../service/RTC/VideoType';
+import { ConnectionQualityEvents } from '../../service/connectivity/ConnectionQualityEvents';
+import { XMPPEvents } from '../../service/xmpp/XMPPEvents';
+const logger = getLogger('connectivity:ConnectionQuality');
+/**
+ * The value to use for the "type" field for messages sent by ConnectionQuality
+ * over the data channel.
+ */
+const STATS_MESSAGE_TYPE = 'stats';
+/**
+ * The maximum bitrate to use as a measurement against the participant's current
+ * bitrate. This cap helps in the cases where the participant's bitrate is high
+ * but not enough to fulfill high targets, such as with 1080p.
+ */
+const MAX_TARGET_BITRATE = 2500;
+/**
+ * The initial bitrate for video in kbps.
+ */
+const startBitrate = 800;
+/**
+ * Gets the expected bitrate (in kbps) in perfect network conditions.
+ * @param simulcast {boolean} whether simulcast is enabled or not.
+ * @param resolution {Resolution} the resolution.
+ * @param millisSinceStart {number} the number of milliseconds since sending video started.
+ * @param bitrates {Object} the bitrates for the local video source.
+ */
+function getTarget(simulcast, resolution, millisSinceStart, bitrates) {
+    let target = 0;
+    let height = Math.min(resolution.height, resolution.width);
+    // Find the first format with height no bigger than ours.
+    let qualityLevel = VIDEO_QUALITY_LEVELS.find(f => f.height <= height);
+    if (qualityLevel && simulcast) {
+        // Sum the target fields from all simulcast layers for the given
+        // resolution (e.g. 720p + 360p + 180p) for VP8 simulcast.
+        for (height = qualityLevel.height; height >= 180; height /= 2) {
+            const targetHeight = height;
+            qualityLevel = VIDEO_QUALITY_LEVELS.find(f => f.height === targetHeight);
+            if (qualityLevel) {
+                target += bitrates[qualityLevel.level];
+            }
+            else {
+                break;
+            }
+        }
+    }
+    else if (qualityLevel) {
+        // For VP9 SVC, H.264 (simulcast automatically disabled) and p2p, target bitrate will be
+        // same as that of the individual stream bitrate.
+        target = bitrates[qualityLevel.level];
+    }
+    // Allow for an additional 1 second for ramp up -- delay any initial drop
+    // of connection quality by 1 second. Convert target from bps to kbps.
+    return Math.min(target / 1000, rampUp(Math.max(0, millisSinceStart - 1000)));
+}
+/**
+ * Gets the bitrate to which GCC would have ramped up in perfect network
+ * conditions after millisSinceStart milliseconds.
+ * @param millisSinceStart {number} the number of milliseconds since sending
+ * video was enabled.
+ */
+function rampUp(millisSinceStart) {
+    if (millisSinceStart > 60000) {
+        return Number.MAX_SAFE_INTEGER;
+    }
+    // According to GCC the send side bandwidth estimation grows with at most
+    // 8% per second.
+    // https://tools.ietf.org/html/draft-ietf-rmcat-gcc-02#section-5.5
+    return startBitrate * Math.pow(1.08, millisSinceStart / 1000);
+}
+/**
+ * A class which monitors the local statistics coming from the RTC modules, and
+ * calculates a "connection quality" value, in percent, for the media
+ * connection. A value of 100% indicates a very good network connection, and a
+ * value of 0% indicates a poor connection.
+ */
+export default class ConnectionQuality {
+    /**
+     *
+     * @param conference
+     * @param eventEmitter
+     * @param options
+     */
+    constructor(conference, eventEmitter, options) {
+        this.eventEmitter = eventEmitter;
+        /**
+         * The owning JitsiConference.
+         */
+        this._conference = conference;
+        /**
+         * Holds statistics about the local connection quality.
+         */
+        this._localStats = {
+            connectionQuality: 100,
+            jvbRTT: undefined
+        };
+        /**
+         * The time this._localStats.connectionQuality was last updated.
+         */
+        this._lastConnectionQualityUpdate = -1;
+        /**
+         * Conference options.
+         */
+        this._options = options;
+        /**
+         * Maps a participant ID to an object holding connection quality
+         * statistics received from this participant.
+         */
+        this._remoteStats = {};
+        /**
+         * The time that the ICE state last changed to CONNECTED. We use this
+         * to calculate how much time we as a sender have had to ramp-up.
+         */
+        this._timeIceConnected = -1;
+        /**
+         * The time that local video was unmuted. We use this to calculate how
+         * much time we as a sender have had to ramp-up.
+         */
+        this._timeVideoUnmuted = -1;
+        conference.on(ConferenceEvents.BRIDGE_BWE_STATS_RECEIVED, bwe => {
+            if (bwe && this._localStats?.bandwidth) {
+                this._localStats.bandwidth.download = Math.floor(bwe / 1000);
+            }
+        });
+        // TODO: consider ignoring these events and letting the user of
+        // lib-jitsi-meet handle these separately.
+        conference.on(ConferenceEvents.CONNECTION_INTERRUPTED, () => {
+            this._updateLocalConnectionQuality(0);
+            this.eventEmitter.emit(ConnectionQualityEvents.LOCAL_STATS_UPDATED, this._localStats);
+            this._broadcastLocalStats();
+        });
+        conference.room.addListener(XMPPEvents.ICE_CONNECTION_STATE_CHANGED, (jingleSession, newState) => {
+            if (!jingleSession.isP2P && newState === 'connected') {
+                this._timeIceConnected = window.performance.now();
+            }
+        });
+        // Listen to DataChannel message from other participants in the
+        // conference, and update the _remoteStats field accordingly.
+        // TODO - Delete this when all the mobile endpoints switch to using the new Colibri
+        // message format for sending the endpoint stats.
+        conference.on(ConferenceEvents.ENDPOINT_MESSAGE_RECEIVED, (participant, payload) => {
+            if (payload.type === STATS_MESSAGE_TYPE) {
+                this._updateRemoteStats(participant.getId(), payload.values);
+            }
+        });
+        conference.on(ConferenceEvents.ENDPOINT_STATS_RECEIVED, (participant, payload) => {
+            this._updateRemoteStats(participant.getId(), payload);
+        });
+        if (!this._options.config.disableLocalStats) {
+            // Listen to local statistics events originating from the RTC module and update the _localStats field.
+            conference.statistics.addConnectionStatsListener(this._updateLocalStats.bind(this));
+        }
+        // Save the last time we were unmuted.
+        conference.on(ConferenceEvents.TRACK_MUTE_CHANGED, track => {
+            if (track.isVideoTrack()) {
+                if (track.isMuted()) {
+                    this._timeVideoUnmuted = -1;
+                }
+                else {
+                    this._maybeUpdateUnmuteTime();
+                }
+            }
+        });
+        conference.on(ConferenceEvents.TRACK_ADDED, track => {
+            if (track.isVideoTrack() && !track.isMuted()) {
+                this._maybeUpdateUnmuteTime();
+            }
+        });
+        conference.on(ConferenceEvents.VIDEO_CODEC_CHANGED, this._resetVideoUnmuteTime.bind(this));
+        conference.on(ConferenceEvents._MEDIA_SESSION_ACTIVE_CHANGED, this._resetVideoUnmuteTime.bind(this));
+        conference.rtc.on(RTCEvents.LOCAL_TRACK_MAX_ENABLED_RESOLUTION_CHANGED, track => {
+            this._localStats.maxEnabledResolution = track.maxEnabledResolution;
+        });
+        conference.on(ConferenceEvents.SERVER_REGION_CHANGED, serverRegion => {
+            this._localStats.serverRegion = serverRegion;
+        });
+        conference.on(ConferenceEvents.PROPERTIES_CHANGED, properties => {
+            this._localStats.bridgeCount
+                = Number(properties?.['bridge-count']);
+        });
+    }
+    /**
+     * Broadcasts the local statistics to all other participants in the
+     * conference.
+     */
+    _broadcastLocalStats() {
+        // broadcasting local stats is disabled
+        if (this._options.config.disableLocalStatsBroadcast) {
+            return;
+        }
+        // Send only the data that remote participants care about.
+        const data = {
+            bitrate: this._localStats.bitrate,
+            connectionQuality: this._localStats.connectionQuality,
+            jvbRTT: this._localStats.jvbRTT,
+            maxEnabledResolution: this._localStats.maxEnabledResolution,
+            packetLoss: this._localStats.packetLoss,
+            serverRegion: this._localStats.serverRegion
+        };
+        try {
+            this._conference.sendEndpointStatsMessage(data);
+        }
+        catch (err) {
+            // Ignore the error as we might hit it in the beginning of the call before the channel is ready.
+            // The statistics will be sent again after few seconds and error is logged elseware as well.
+        }
+    }
+    /**
+     * Calculates a new "connection quality" value.
+     * @param videoType {VideoType} the type of the video source (camera or a screen capture).
+     * @param isMuted {boolean} whether the local video is muted.
+     * @param resolutionName {Resolution} the input resolution used by the camera.
+     * @returns {*} the newly calculated connection quality.
+     */
+    _calculateConnectionQuality(videoType, isMuted, resolutionName) {
+        // resolutionName is an index into Resolutions (where "720" is
+        // "1280x720" and "960" is "960x720" ...).
+        const resolution = Resolutions[resolutionName];
+        let quality = 100;
+        let packetLoss;
+        // TODO: take into account packet loss for received streams
+        if (this._localStats.packetLoss) {
+            packetLoss = this._localStats.packetLoss.upload;
+        }
+        if (isMuted || !resolution || videoType === VideoType.DESKTOP
+            || this._timeIceConnected < 0
+            || this._timeVideoUnmuted < 0) {
+            // Calculate a value based on packet loss only.
+            if (packetLoss === undefined) {
+                logger.error('Cannot calculate connection quality, unknown '
+                    + 'packet loss.');
+                quality = 100;
+            }
+            else if (packetLoss <= 2) {
+                quality = 100; // Full 5 bars.
+            }
+            else if (packetLoss <= 4) {
+                quality = 70; // 4 bars
+            }
+            else if (packetLoss <= 6) {
+                quality = 50; // 3 bars
+            }
+            else if (packetLoss <= 8) {
+                quality = 30; // 2 bars
+            }
+            else if (packetLoss <= 12) {
+                quality = 10; // 1 bars
+            }
+            else {
+                quality = 0; // Still 1 bar, but slower climb-up.
+            }
+        }
+        else {
+            // Calculate a value based on the send video bitrate on the active TPC.
+            const activeTPC = this._conference.getActivePeerConnection();
+            if (activeTPC) {
+                // Time since sending of video was enabled.
+                const millisSinceStart = window.performance.now()
+                    - Math.max(this._timeVideoUnmuted, this._timeIceConnected);
+                const statsInterval = this._options.config?.pcStatsInterval ?? 10000;
+                // Expected sending bitrate in perfect conditions.
+                let target = getTarget(activeTPC.doesTrueSimulcast(undefined), resolution, millisSinceStart, activeTPC.getTargetVideoBitrates(undefined));
+                target = Math.min(target, MAX_TARGET_BITRATE);
+                // Calculate the quality only after the stats are available (after video was enabled).
+                if (millisSinceStart > statsInterval) {
+                    quality = 100 * this._localStats.bitrate.upload / target;
+                }
+            }
+            // Whatever the bitrate, drop early if there is significant loss
+            if (packetLoss && packetLoss >= 10) {
+                quality = Math.min(quality, 30);
+            }
+        }
+        // Make sure that the quality doesn't climb quickly
+        if (this._lastConnectionQualityUpdate > 0) {
+            const maxIncreasePerSecond = 2;
+            const prevConnectionQuality = this._localStats.connectionQuality;
+            const diffSeconds = (window.performance.now() - this._lastConnectionQualityUpdate) / 1000;
+            quality = Math.min(quality, prevConnectionQuality + (diffSeconds * maxIncreasePerSecond));
+        }
+        return Math.min(100, quality);
+    }
+    /**
+     * Sets _timeVideoUnmuted if it was previously unset. If it was already set,
+     * doesn't change it.
+     */
+    _maybeUpdateUnmuteTime() {
+        if (this._timeVideoUnmuted < 0) {
+            this._timeVideoUnmuted = window.performance.now();
+        }
+    }
+    /**
+     * Resets the time video was unmuted and triggers a new ramp-up.
+     *
+     * @private
+     * @returns {void}
+     */
+    _resetVideoUnmuteTime() {
+        this._timeVideoUnmuted = -1;
+        this._maybeUpdateUnmuteTime();
+    }
+    /**
+     * Updates the localConnectionQuality value
+     * @param values {number} the new value. Should be in [0, 100].
+     */
+    _updateLocalConnectionQuality(value) {
+        this._localStats.connectionQuality = value;
+        this._lastConnectionQualityUpdate = window.performance.now();
+    }
+    /**
+     * Updates the local statistics
+     * @param {TraceablePeerConnection} tpc the peerconnection which emitted
+     * the stats
+     * @param data new statistics
+     */
+    _updateLocalStats(tpc, data) {
+        // Update jvbRTT
+        if (!tpc.isP2P) {
+            const jvbRTT = data.transport?.length && data.transport[0].rtt;
+            this._localStats.jvbRTT = jvbRTT ? jvbRTT : undefined;
+        }
+        // Do not continue with processing of other stats if they do not
+        // originate from the active peerconnection
+        if (tpc !== this._conference.getActivePeerConnection()) {
+            return;
+        }
+        let key;
+        const updateLocalConnectionQuality = !this._conference.isConnectionInterrupted();
+        const localVideoTrack = this._conference.getLocalVideoTrack();
+        const videoType = localVideoTrack?.videoType;
+        const isMuted = localVideoTrack ? localVideoTrack.isMuted() : true;
+        const resolutionName = localVideoTrack
+            ? Math.min(localVideoTrack.resolution, localVideoTrack.maxEnabledResolution).toString() : null;
+        if (!isMuted) {
+            this._maybeUpdateUnmuteTime();
+        }
+        // Copy the fields already in 'data'.
+        for (key in data) {
+            if (data.hasOwnProperty(key)) {
+                // Prevent overwriting available download bandwidth as this statistic is provided by the bridge.
+                if (key === 'bandwidth' && data[key].hasOwnProperty('download') && !tpc.isP2P) {
+                    if (!this._localStats[key]) {
+                        this._localStats[key] = {};
+                    }
+                    this._localStats[key].download = this._localStats[key].download || data[key].download;
+                    this._localStats[key].upload = data[key].upload;
+                }
+                else {
+                    this._localStats[key] = data[key];
+                }
+            }
+        }
+        // And re-calculate the connectionQuality field.
+        if (updateLocalConnectionQuality) {
+            this._updateLocalConnectionQuality(this._calculateConnectionQuality(videoType, isMuted, resolutionName));
+        }
+        this.eventEmitter.emit(ConnectionQualityEvents.LOCAL_STATS_UPDATED, this._localStats);
+        this._broadcastLocalStats();
+    }
+    /**
+     * Updates remote statistics
+     * @param id the id of the remote participant
+     * @param data the statistics received
+     */
+    _updateRemoteStats(id, data) {
+        // Use only the fields we need
+        this._remoteStats[id] = {
+            bitrate: data.bitrate,
+            connectionQuality: data.connectionQuality,
+            jvbRTT: data.jvbRTT,
+            maxEnabledResolution: data.maxEnabledResolution,
+            packetLoss: data.packetLoss,
+            serverRegion: data.serverRegion
+        };
+        this.eventEmitter.emit(ConnectionQualityEvents.REMOTE_STATS_UPDATED, id, this._remoteStats[id]);
+    }
+    /**
+     * Returns the local statistics.
+     * Exported only for use in jitsi-meet-torture.
+     */
+    getStats() {
+        return this._localStats;
+    }
+}
+//# sourceMappingURL=ConnectionQuality.js.map

package/dist/esm/modules/connectivity/ConnectionQuality.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConnectionQuality.js","sourceRoot":"","sources":["../../../../modules/connectivity/ConnectionQuality.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAG1C,OAAO,EAAE,qBAAqB,IAAI,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAExF,OAAO,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AACxD,OAAO,WAAW,MAAM,+BAA+B,CAAC;AACxD,OAAO,EAAE,oBAAoB,EAAE,MAAM,gDAAgD,CAAC;AACtF,OAAO,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AACxD,OAAO,EAAE,uBAAuB,EAAE,MAAM,oDAAoD,CAAC;AAC7F,OAAO,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAK3D,MAAM,MAAM,GAAG,SAAS,CAAC,gCAAgC,CAAC,CAAC;AAE3D;;;GAGG;AACH,MAAM,kBAAkB,GAAG,OAAO,CAAC;AAEnC;;;;GAIG;AACH,MAAM,kBAAkB,GAAG,IAAI,CAAC;AAEhC;;GAEG;AACH,MAAM,YAAY,GAAG,GAAG,CAAC;AAEzB;;;;;;GAMG;AACH,SAAS,SAAS,CAAC,SAAkB,EAAE,UAA8C,EAAE,gBAAwB,EAAE,QAAgD;IAC7J,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,IAAI,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,MAAM,EAAE,UAAU,CAAC,KAAK,CAAC,CAAC;IAE3D,yDAAyD;IACzD,IAAI,YAAY,GAAG,oBAAoB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,IAAI,MAAM,CAAC,CAAC;IAEtE,IAAI,YAAY,IAAI,SAAS,EAAE,CAAC;QAC5B,gEAAgE;QAChE,0DAA0D;QAC1D,KAAK,MAAM,GAAG,YAAY,CAAC,MAAM,EAAE,MAAM,IAAI,GAAG,EAAE,MAAM,IAAI,CAAC,EAAE,CAAC;YAC5D,MAAM,YAAY,GAAG,MAAM,CAAC;YAE5B,YAAY,GAAG,oBAAoB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,YAAY,CAAC,CAAC;YACzE,IAAI,YAAY,EAAE,CAAC;gBACf,MAAM,IAAI,QAAQ,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;YAC3C,CAAC;iBAAM,CAAC;gBACJ,MAAM;YACV,CAAC;QACL,CAAC;IACL,CAAC;SAAM,IAAI,YAAY,EAAE,CAAC;QACtB,wFAAwF;QACxF,iDAAiD;QACjD,MAAM,GAAG,QAAQ,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;IAC1C,CAAC;IAED,yEAAyE;IACzE,sEAAsE;IACtE,OAAO,IAAI,CAAC,GAAG,CAAC,MAAM,GAAG,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,gBAAgB,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;AACjF,CAAC;AAED;;;;;GAKG;AACH,SAAS,MAAM,CAAC,gBAAwB;IACpC,IAAI,gBAAgB,GAAG,KAAK,EAAE,CAAC;QAC3B,OAAO,MAAM,CAAC,gBAAgB,CAAC;IACnC,CAAC;IAED,yEAAyE;IACzE,iBAAiB;IACjB,kEAAkE;IAClE,OAAO,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,gBAAgB,GAAG,IAAI,CAAC,CAAC;AAClE,CAAC;AAyBD;;;;;GAKG;AACH,MAAM,CAAC,OAAO,OAAO,iBAAiB;IAUlC;;;;;OAKG;IACH,YAAY,UAA2B,EAAE,YAA0B,EAAE,OAA2B;QAC5F,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;QAEjC;;WAEG;QACH,IAAI,CAAC,WAAW,GAAG,UAAU,CAAC;QAE9B;;WAEG;QACH,IAAI,CAAC,WAAW,GAAG;YACf,iBAAiB,EAAE,GAAG;YACtB,MAAM,EAAE,SAAS;SACpB,CAAC;QAEF;;WAEG;QACH,IAAI,CAAC,4BAA4B,GAAG,CAAC,CAAC,CAAC;QAEvC;;WAEG;QACH,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC;QAExB;;;WAGG;QACH,IAAI,CAAC,YAAY,GAAG,EAAE,CAAC;QAEvB;;;WAGG;QACH,IAAI,CAAC,iBAAiB,GAAG,CAAC,CAAC,CAAC;QAE5B;;;WAGG;QACH,IAAI,CAAC,iBAAiB,GAAG,CAAC,CAAC,CAAC;QAE5B,UAAU,CAAC,EAAE,CACT,gBAAgB,CAAC,yBAAyB,EAC1C,GAAG,CAAC,EAAE;YACF,IAAI,GAAG,IAAI,IAAI,CAAC,WAAW,EAAE,SAAS,EAAE,CAAC;gBACrC,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,GAAG,IAAI,CAAC,CAAC;YACjE,CAAC;QACL,CAAC,CAAC,CAAC;QAEP,+DAA+D;QAC/D,0CAA0C;QAC1C,UAAU,CAAC,EAAE,CACT,gBAAgB,CAAC,sBAAsB,EACvC,GAAG,EAAE;YACD,IAAI,CAAC,6BAA6B,CAAC,CAAC,CAAC,CAAC;YACtC,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,uBAAuB,CAAC,mBAAmB,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;YACtF,IAAI,CAAC,oBAAoB,EAAE,CAAC;QAChC,CAAC,CAAC,CAAC;QAEP,UAAU,CAAC,IAAI,CAAC,WAAW,CACvB,UAAU,CAAC,4BAA4B,EACvC,CAAC,aAA8B,EAAE,QAAgB,EAAE,EAAE;YACjD,IAAI,CAAC,aAAa,CAAC,KAAK,IAAI,QAAQ,KAAK,WAAW,EAAE,CAAC;gBACnD,IAAI,CAAC,iBAAiB,GAAG,MAAM,CAAC,WAAW,CAAC,GAAG,EAAE,CAAC;YACtD,CAAC;QACL,CAAC,CAAC,CAAC;QAEP,+DAA+D;QAC/D,6DAA6D;QAC7D,mFAAmF;QACnF,iDAAiD;QACjD,UAAU,CAAC,EAAE,CACT,gBAAgB,CAAC,yBAAyB,EAC1C,CAAC,WAA6B,EAAE,OAAuC,EAAE,EAAE;YACvE,IAAI,OAAO,CAAC,IAAI,KAAK,kBAAkB,EAAE,CAAC;gBACtC,IAAI,CAAC,kBAAkB,CAAC,WAAW,CAAC,KAAK,EAAE,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;YACjE,CAAC;QACL,CAAC,CAAC,CAAC;QAEP,UAAU,CAAC,EAAE,CACT,gBAAgB,CAAC,uBAAuB,EACxC,CAAC,WAA6B,EAAE,OAAqB,EAAE,EAAE;YACrD,IAAI,CAAC,kBAAkB,CAAC,WAAW,CAAC,KAAK,EAAE,EAAE,OAAO,CAAC,CAAC;QAC1D,CAAC,CAAC,CAAC;QAEP,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,iBAAiB,EAAE,CAAC;YAC1C,sGAAsG;YACtG,UAAU,CAAC,UAAU,CAAC,0BAA0B,CAAC,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QACxF,CAAC;QAED,sCAAsC;QACtC,UAAU,CAAC,EAAE,CACT,gBAAgB,CAAC,kBAAkB,EACnC,KAAK,CAAC,EAAE;YACJ,IAAI,KAAK,CAAC,YAAY,EAAE,EAAE,CAAC;gBACvB,IAAI,KAAK,CAAC,OAAO,EAAE,EAAE,CAAC;oBAClB,IAAI,CAAC,iBAAiB,GAAG,CAAC,CAAC,CAAC;gBAChC,CAAC;qBAAM,CAAC;oBACJ,IAAI,CAAC,sBAAsB,EAAE,CAAC;gBAClC,CAAC;YACL,CAAC;QACL,CAAC,CAAC,CAAC;QACP,UAAU,CAAC,EAAE,CACT,gBAAgB,CAAC,WAAW,EAC5B,KAAK,CAAC,EAAE;YACJ,IAAI,KAAK,CAAC,YAAY,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,EAAE,CAAC;gBAC3C,IAAI,CAAC,sBAAsB,EAAE,CAAC;YAClC,CAAC;QACL,CAAC,CAAC,CAAC;QAEP,UAAU,CAAC,EAAE,CAAC,gBAAgB,CAAC,mBAAmB,EAAE,IAAI,CAAC,qBAAqB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QAE3F,UAAU,CAAC,EAAE,CAAC,gBAAgB,CAAC,6BAA6B,EAAE,IAAI,CAAC,qBAAqB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QAErG,UAAU,CAAC,GAAG,CAAC,EAAE,CACb,SAAS,CAAC,0CAA0C,EACpD,KAAK,CAAC,EAAE;YACJ,IAAI,CAAC,WAAW,CAAC,oBAAoB,GAAG,KAAK,CAAC,oBAAoB,CAAC;QACvE,CAAC,CAAC,CAAC;QAEP,UAAU,CAAC,EAAE,CACT,gBAAgB,CAAC,qBAAqB,EACtC,YAAY,CAAC,EAAE;YACX,IAAI,CAAC,WAAW,CAAC,YAAY,GAAG,YAAY,CAAC;QACjD,CAAC,CAAC,CAAC;QAEP,UAAU,CAAC,EAAE,CACT,gBAAgB,CAAC,kBAAkB,EACnC,UAAU,CAAC,EAAE;YACT,IAAI,CAAC,WAAW,CAAC,WAAW;kBACtB,MAAM,CAAC,UAAU,EAAE,CAAC,cAAc,CAAC,CAAC,CAAC;QAC/C,CAAC,CACJ,CAAC;IACN,CAAC;IAED;;;OAGG;IACK,oBAAoB;QACxB,uCAAuC;QACvC,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,0BAA0B,EAAE,CAAC;YAClD,OAAO;QACX,CAAC;QAED,0DAA0D;QAC1D,MAAM,IAAI,GAAG;YACT,OAAO,EAAE,IAAI,CAAC,WAAW,CAAC,OAAO;YACjC,iBAAiB,EAAE,IAAI,CAAC,WAAW,CAAC,iBAAiB;YACrD,MAAM,EAAE,IAAI,CAAC,WAAW,CAAC,MAAM;YAC/B,oBAAoB,EAAE,IAAI,CAAC,WAAW,CAAC,oBAAoB;YAC3D,UAAU,EAAE,IAAI,CAAC,WAAW,CAAC,UAAU;YACvC,YAAY,EAAE,IAAI,CAAC,WAAW,CAAC,YAAY;SAC9C,CAAC;QAEF,IAAI,CAAC;YACD,IAAI,CAAC,WAAW,CAAC,wBAAwB,CAAC,IAAI,CAAC,CAAC;QACpD,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACX,gGAAgG;YAChG,4FAA4F;QAChG,CAAC;IACL,CAAC;IAED;;;;;;OAMG;IACK,2BAA2B,CAAC,SAAoB,EAAE,OAAgB,EAAE,cAAwC;QAEhH,8DAA8D;QAC9D,0CAA0C;QAC1C,MAAM,UAAU,GAAG,WAAW,CAAC,cAAc,CAAC,CAAC;QAE/C,IAAI,OAAO,GAAG,GAAG,CAAC;QAClB,IAAI,UAAU,CAAC;QAEf,2DAA2D;QAC3D,IAAI,IAAI,CAAC,WAAW,CAAC,UAAU,EAAE,CAAC;YAC9B,UAAU,GAAG,IAAI,CAAC,WAAW,CAAC,UAAU,CAAC,MAAM,CAAC;QACpD,CAAC;QAED,IAAI,OAAO,IAAI,CAAC,UAAU,IAAI,SAAS,KAAK,SAAS,CAAC,OAAO;eACtD,IAAI,CAAC,iBAAiB,GAAG,CAAC;eAC1B,IAAI,CAAC,iBAAiB,GAAG,CAAC,EAAE,CAAC;YAEhC,+CAA+C;YAC/C,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;gBAC3B,MAAM,CAAC,KAAK,CAAC,+CAA+C;sBACtD,cAAc,CAAC,CAAC;gBACtB,OAAO,GAAG,GAAG,CAAC;YAClB,CAAC;iBAAM,IAAI,UAAU,IAAI,CAAC,EAAE,CAAC;gBACzB,OAAO,GAAG,GAAG,CAAC,CAAC,eAAe;YAClC,CAAC;iBAAM,IAAI,UAAU,IAAI,CAAC,EAAE,CAAC;gBACzB,OAAO,GAAG,EAAE,CAAC,CAAC,SAAS;YAC3B,CAAC;iBAAM,IAAI,UAAU,IAAI,CAAC,EAAE,CAAC;gBACzB,OAAO,GAAG,EAAE,CAAC,CAAC,SAAS;YAC3B,CAAC;iBAAM,IAAI,UAAU,IAAI,CAAC,EAAE,CAAC;gBACzB,OAAO,GAAG,EAAE,CAAC,CAAC,SAAS;YAC3B,CAAC;iBAAM,IAAI,UAAU,IAAI,EAAE,EAAE,CAAC;gBAC1B,OAAO,GAAG,EAAE,CAAC,CAAC,SAAS;YAC3B,CAAC;iBAAM,CAAC;gBACJ,OAAO,GAAG,CAAC,CAAC,CAAC,oCAAoC;YACrD,CAAC;QACL,CAAC;aAAM,CAAC;YACJ,uEAAuE;YACvE,MAAM,SAAS,GAAG,IAAI,CAAC,WAAW,CAAC,uBAAuB,EAAE,CAAC;YAE7D,IAAI,SAAS,EAAE,CAAC;gBACZ,2CAA2C;gBAC3C,MAAM,gBAAgB,GAAG,MAAM,CAAC,WAAW,CAAC,GAAG,EAAE;sBAC3C,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,iBAAiB,EAAE,IAAI,CAAC,iBAAiB,CAAC,CAAC;gBAC/D,MAAM,aAAa,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,eAAe,IAAI,KAAK,CAAC;gBAErE,kDAAkD;gBAClD,IAAI,MAAM,GAAG,SAAS,CAClB,SAAS,CAAC,iBAAiB,CAAC,SAAS,CAAC,EACtC,UAAU,EACV,gBAAgB,EAChB,SAAS,CAAC,sBAAsB,CAAC,SAAS,CAAC,CAAC,CAAC;gBAEjD,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;gBAE9C,sFAAsF;gBACtF,IAAI,gBAAgB,GAAG,aAAa,EAAE,CAAC;oBACnC,OAAO,GAAG,GAAG,GAAG,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,MAAM,GAAG,MAAM,CAAC;gBAC7D,CAAC;YACL,CAAC;YAED,gEAAgE;YAChE,IAAI,UAAU,IAAI,UAAU,IAAI,EAAE,EAAE,CAAC;gBACjC,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;YACpC,CAAC;QACL,CAAC;QAED,mDAAmD;QACnD,IAAI,IAAI,CAAC,4BAA4B,GAAG,CAAC,EAAE,CAAC;YACxC,MAAM,oBAAoB,GAAG,CAAC,CAAC;YAC/B,MAAM,qBAAqB,GAAG,IAAI,CAAC,WAAW,CAAC,iBAAiB,CAAC;YACjE,MAAM,WAAW,GAAG,CAAC,MAAM,CAAC,WAAW,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,4BAA4B,CAAC,GAAG,IAAI,CAAC;YAE1F,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,qBAAqB,GAAG,CAAC,WAAW,GAAG,oBAAoB,CAAC,CAAC,CAAC;QAC9F,CAAC;QAED,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IAClC,CAAC;IAED;;;OAGG;IACK,sBAAsB;QAC1B,IAAI,IAAI,CAAC,iBAAiB,GAAG,CAAC,EAAE,CAAC;YAC7B,IAAI,CAAC,iBAAiB,GAAG,MAAM,CAAC,WAAW,CAAC,GAAG,EAAE,CAAC;QACtD,CAAC;IACL,CAAC;IAED;;;;;OAKG;IACK,qBAAqB;QACzB,IAAI,CAAC,iBAAiB,GAAG,CAAC,CAAC,CAAC;QAC5B,IAAI,CAAC,sBAAsB,EAAE,CAAC;IAClC,CAAC;IAED;;;OAGG;IACK,6BAA6B,CAAC,KAAa;QAC/C,IAAI,CAAC,WAAW,CAAC,iBAAiB,GAAG,KAAK,CAAC;QAC3C,IAAI,CAAC,4BAA4B,GAAG,MAAM,CAAC,WAAW,CAAC,GAAG,EAAE,CAAC;IACjE,CAAC;IAED;;;;;OAKG;IACK,iBAAiB,CAAC,GAA4B,EAAE,IAAwC;QAC5F,gBAAgB;QAChB,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC;YACb,MAAM,MAAM,GACN,IAAI,CAAC,SAAS,EAAE,MAAM,IAAI,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;YAEtD,IAAI,CAAC,WAAW,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;QAC1D,CAAC;QAED,gEAAgE;QAChE,2CAA2C;QAC3C,IAAI,GAAG,KAAK,IAAI,CAAC,WAAW,CAAC,uBAAuB,EAAE,EAAE,CAAC;YACrD,OAAO;QACX,CAAC;QAED,IAAI,GAAG,CAAC;QACR,MAAM,4BAA4B,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC,uBAAuB,EAAE,CAAC;QACjF,MAAM,eAAe,GAAG,IAAI,CAAC,WAAW,CAAC,kBAAkB,EAAE,CAAC;QAC9D,MAAM,SAAS,GAAG,eAAe,EAAE,SAAS,CAAC;QAC7C,MAAM,OAAO,GAAG,eAAe,CAAC,CAAC,CAAC,eAAe,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;QACnE,MAAM,cAAc,GAAG,eAAe;YAClC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,eAAe,CAAC,UAAU,EAAE,eAAe,CAAC,oBAAoB,CAAC,CAAC,QAAQ,EAA8B,CAAC,CAAC,CAAC,IAAI,CAAC;QAE/H,IAAI,CAAC,OAAO,EAAE,CAAC;YACX,IAAI,CAAC,sBAAsB,EAAE,CAAC;QAClC,CAAC;QAED,qCAAqC;QACrC,KAAK,GAAG,IAAI,IAAI,EAAE,CAAC;YACf,IAAI,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,EAAE,CAAC;gBAC3B,gGAAgG;gBAChG,IAAI,GAAG,KAAK,WAAW,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,cAAc,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC;oBAC5E,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC;wBACzB,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC;oBAC/B,CAAC;oBACD,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,QAAQ,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,QAAQ,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC;oBACtF,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC;gBACpD,CAAC;qBAAM,CAAC;oBACJ,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC;gBACtC,CAAC;YACL,CAAC;QACL,CAAC;QAED,gDAAgD;QAChD,IAAI,4BAA4B,EAAE,CAAC;YAC/B,IAAI,CAAC,6BAA6B,CAC9B,IAAI,CAAC,2BAA2B,CAC5B,SAAS,EACT,OAAO,EACP,cAAc,CAAC,CAAC,CAAC;QAC7B,CAAC;QAED,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,uBAAuB,CAAC,mBAAmB,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;QACtF,IAAI,CAAC,oBAAoB,EAAE,CAAC;IAChC,CAAC;IAED;;;;OAIG;IACK,kBAAkB,CAAC,EAAU,EAAE,IAAkB;QACrD,8BAA8B;QAC9B,IAAI,CAAC,YAAY,CAAC,EAAE,CAAC,GAAG;YACpB,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,iBAAiB,EAAE,IAAI,CAAC,iBAAiB;YACzC,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,oBAAoB,EAAE,IAAI,CAAC,oBAAoB;YAC/C,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,YAAY,EAAE,IAAI,CAAC,YAAY;SAClC,CAAC;QAEF,IAAI,CAAC,YAAY,CAAC,IAAI,CAClB,uBAAuB,CAAC,oBAAoB,EAC5C,EAAE,EACF,IAAI,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC,CAAC;IAC/B,CAAC;IAED;;;OAGG;IACI,QAAQ;QACX,OAAO,IAAI,CAAC,WAAW,CAAC;IAC5B,CAAC;CACJ"}

package/dist/esm/modules/connectivity/IceFailedHandling.js

@@ -0,0 +1,84 @@
+import { getLogger } from '@jitsi/logger';
+import RTCStats from '../RTCStats/RTCStats';
+import { RTCStatsEvents } from '../RTCStats/RTCStatsEvents';
+const logger = getLogger('connectivity:IceFailedHandling');
+/**
+ * This class deals with shenanigans around JVB media session's ICE failed status handling.
+ *
+ * If ICE connection is not re-established within 2 secs after the internet comes back online, the client will initiate
+ * a session restart via 'session-terminate'. This results in Jicofo re-inviting the participant into the conference by
+ * recreating the jvb media session so that there is minimla disruption to the user by default.
+ */
+export default class IceFailedHandling {
+    /**
+     * Creates new {@code DelayedIceFailed} task.
+     * @param {JitsiConference} conference
+     */
+    constructor(conference) {
+        this._canceled = false;
+        this._conference = conference;
+    }
+    /**
+     * After making sure there's no way for the ICE connection to recover this method either sends ICE failed
+     * notification to Jicofo or emits the ice failed conference event.
+     * @private
+     * @returns {void}
+     */
+    _actOnIceFailed() {
+        if (!this._conference.room) {
+            return;
+        }
+        const jvbConnection = this._conference.jvbJingleSession;
+        const jvbConnIceState = jvbConnection?.getIceConnectionState();
+        if (!jvbConnection) {
+            logger.warn('Not sending ICE failed - no JVB connection');
+        }
+        else if (jvbConnIceState === 'connected') {
+            logger.info('ICE connection restored - not sending ICE failed');
+        }
+        else {
+            logger.info(`Sending ICE failed - the connection did not recover, ICE state: ${jvbConnIceState}`);
+            RTCStats.sendStatsEntry(RTCStatsEvents.JVB_ICE_RESTARTED_EVENT);
+            this._conference._stopJvbSession({
+                reason: 'connectivity-error',
+                reasonDescription: 'ICE FAILED',
+                requestRestart: true,
+                sendSessionTerminate: true
+            });
+        }
+    }
+    /**
+     * Starts the task.
+     * @returns {void}
+     */
+    start() {
+        //  Using xmpp.ping allows to handle both XMPP being disconnected and internet offline cases. The ping function
+        // uses sendIQ2 method which is resilient to XMPP connection disconnected state and will patiently wait until it
+        // gets reconnected.
+        //  This also handles the case about waiting for the internet to come back online, because ping
+        // will only succeed when the internet is online and then there's a chance for the ICE to recover from FAILED to
+        // CONNECTED which is the extra 2 second timeout after ping.
+        //  The 65 second timeout is given on purpose as there's no chance for XMPP to recover after 65 seconds of no
+        // communication with the server. Such resume attempt will result in unrecoverable conference failed event due
+        // to 'item-not-found' error returned by the server.
+        this._conference.xmpp.ping(65000).then(() => {
+            if (!this._canceled) {
+                this._iceFailedTimeout = window.setTimeout(() => {
+                    this._iceFailedTimeout = undefined;
+                    this._actOnIceFailed();
+                }, 2000);
+            }
+        }, error => {
+            logger.error('PING error/timeout - not sending ICE failed', error);
+        });
+    }
+    /**
+     * Cancels the task.
+     * @returns {void}
+     */
+    cancel() {
+        this._canceled = true;
+        window.clearTimeout(this._iceFailedTimeout);
+    }
+}
+//# sourceMappingURL=IceFailedHandling.js.map

package/dist/esm/modules/connectivity/IceFailedHandling.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IceFailedHandling.js","sourceRoot":"","sources":["../../../../modules/connectivity/IceFailedHandling.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAG1C,OAAO,QAAQ,MAAM,sBAAsB,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAE5D,MAAM,MAAM,GAAG,SAAS,CAAC,gCAAgC,CAAC,CAAC;AAE3D;;;;;;GAMG;AACH,MAAM,CAAC,OAAO,OAAO,iBAAiB;IAKlC;;;OAGG;IACH,YAAY,UAA2B;QAP/B,cAAS,GAAY,KAAK,CAAC;QAQ/B,IAAI,CAAC,WAAW,GAAG,UAAU,CAAC;IAClC,CAAC;IAED;;;;;OAKG;IACH,eAAe;QACX,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC;YACzB,OAAO;QACX,CAAC;QAED,MAAM,aAAa,GAAG,IAAI,CAAC,WAAW,CAAC,gBAAgB,CAAC;QACxD,MAAM,eAAe,GAAG,aAAa,EAAE,qBAAqB,EAAE,CAAC;QAE/D,IAAI,CAAC,aAAa,EAAE,CAAC;YACjB,MAAM,CAAC,IAAI,CAAC,4CAA4C,CAAC,CAAC;QAC9D,CAAC;aAAM,IAAI,eAAe,KAAK,WAAW,EAAE,CAAC;YACzC,MAAM,CAAC,IAAI,CAAC,kDAAkD,CAAC,CAAC;QACpE,CAAC;aAAM,CAAC;YACJ,MAAM,CAAC,IAAI,CAAC,mEAAmE,eAAe,EAAE,CAAC,CAAC;YAClG,QAAQ,CAAC,cAAc,CAAC,cAAc,CAAC,uBAAuB,CAAC,CAAC;YAChE,IAAI,CAAC,WAAW,CAAC,eAAe,CAAC;gBAC7B,MAAM,EAAE,oBAAoB;gBAC5B,iBAAiB,EAAE,YAAY;gBAC/B,cAAc,EAAE,IAAI;gBACpB,oBAAoB,EAAE,IAAI;aAC7B,CAAC,CAAC;QACP,CAAC;IACL,CAAC;IAED;;;OAGG;IACH,KAAK;QACD,+GAA+G;QAC/G,gHAAgH;QAChH,oBAAoB;QACpB,+FAA+F;QAC/F,gHAAgH;QAChH,4DAA4D;QAC5D,6GAA6G;QAC7G,8GAA8G;QAC9G,oDAAoD;QACpD,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAClC,GAAG,EAAE;YACD,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;gBAClB,IAAI,CAAC,iBAAiB,GAAG,MAAM,CAAC,UAAU,CAAC,GAAG,EAAE;oBAC5C,IAAI,CAAC,iBAAiB,GAAG,SAAS,CAAC;oBACnC,IAAI,CAAC,eAAe,EAAE,CAAC;gBAC3B,CAAC,EAAE,IAAI,CAAC,CAAC;YACb,CAAC;QACL,CAAC,EACD,KAAK,CAAC,EAAE;YACJ,MAAM,CAAC,KAAK,CAAC,6CAA6C,EAAE,KAAK,CAAC,CAAC;QACvE,CAAC,CAAC,CAAC;IACX,CAAC;IAED;;;OAGG;IACH,MAAM;QACF,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;QACtB,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;IAChD,CAAC;CACJ"}

package/dist/esm/modules/connectivity/NetworkInfo.js

@@ -0,0 +1,49 @@
+import { getLogger } from '@jitsi/logger';
+import Listenable from '../util/Listenable';
+export const NETWORK_INFO_EVENT = 'NETWORK_INFO_CHANGED';
+const logger = getLogger('connectivity:NetworkInfo');
+/**
+ * Module provides information about the current status of the internet
+ * connection. Lib-jitsi-meet doesn't have any logic for detecting internet
+ * online/offline, but rather it relies on the information supplied by the app
+ * that uses it. By default the online state is assumed and the lib acts as if
+ * it was connected. See {@link JitsiMeetJS.setNetworkInfo}.
+ */
+export class NetworkInfo extends Listenable {
+    /**
+     * Creates new {@link NetworkInfo} instance.
+     */
+    constructor() {
+        super();
+        this._current = {
+            isOnline: true
+        };
+    }
+    /**
+     * Updates the network info state.
+     *
+     * @param {object} state - The network info state.
+     * @param {boolean} state.isOnline - {@code true} if the internet connectivity is online or {@code false}
+     * otherwise.
+     */
+    updateNetworkInfo({ isOnline }) {
+        logger.debug('updateNetworkInfo', { isOnline });
+        this._current = {
+            isOnline: isOnline === true
+        };
+        this.eventEmitter.emit(NETWORK_INFO_EVENT, this._current);
+    }
+    /**
+     * Returns the online/offline internet status. By default the value is {@code true} and changes only if
+     * the lib's user wires the state through {@link JitsiMeetJS.setNetworkInfo} like the jitsi-meet does. Because of
+     * that any logic should still assume that the internet may be offline and should handle the failure gracefully.
+     * It's only a good hint in the other way around: to pause internet operations until it comes back online.
+     * @returns {boolean}
+     */
+    isOnline() {
+        return this._current.isOnline === true;
+    }
+}
+const networkInfo = new NetworkInfo();
+export default networkInfo;
+//# sourceMappingURL=NetworkInfo.js.map

package/dist/esm/modules/connectivity/NetworkInfo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"NetworkInfo.js","sourceRoot":"","sources":["../../../../modules/connectivity/NetworkInfo.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAE1C,OAAO,UAAU,MAAM,oBAAoB,CAAC;AAE5C,MAAM,CAAC,MAAM,kBAAkB,GAAG,sBAAsB,CAAC;AAEzD,MAAM,MAAM,GAAG,SAAS,CAAC,0BAA0B,CAAC,CAAC;AAMrD;;;;;;GAMG;AACH,MAAM,OAAO,WAAY,SAAQ,UAAU;IAGvC;;OAEG;IACH;QACI,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,QAAQ,GAAG;YACZ,QAAQ,EAAE,IAAI;SACjB,CAAC;IACN,CAAC;IAED;;;;;;OAMG;IACH,iBAAiB,CAAC,EAAE,QAAQ,EAA0B;QAClD,MAAM,CAAC,KAAK,CAAC,mBAAmB,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC;QAChD,IAAI,CAAC,QAAQ,GAAG;YACZ,QAAQ,EAAE,QAAQ,KAAK,IAAI;SAC9B,CAAC;QACF,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,kBAAkB,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC9D,CAAC;IAED;;;;;;OAMG;IACH,QAAQ;QACJ,OAAO,IAAI,CAAC,QAAQ,CAAC,QAAQ,KAAK,IAAI,CAAC;IAC3C,CAAC;CACJ;AAED,MAAM,WAAW,GAAG,IAAI,WAAW,EAAE,CAAC;AAEtC,eAAe,WAAW,CAAC"}