@whereby.com/media 1.17.15 → 1.18.0

package/dist/index.cjs

@@ -12,14 +12,14 @@ var EventEmitter = require('events');
 var mediasoupClient = require('mediasoup-client');
 var uaParserJs = require('ua-parser-js');
 var Logger_js = require('mediasoup-client/lib/Logger.js');
-var utils = require('mediasoup-client/lib/utils');
-var ortc = require('mediasoup-client/lib/ortc');
-var sdpCommonUtils = require('mediasoup-client/lib/handlers/sdp/commonUtils');
-var ortcUtils = require('mediasoup-client/lib/handlers/ortc/utils');
-var errors = require('mediasoup-client/lib/errors');
-var HandlerInterface = require('mediasoup-client/lib/handlers/HandlerInterface');
-var RemoteSdp = require('mediasoup-client/lib/handlers/sdp/RemoteSdp');
-var scalabilityModes = require('mediasoup-client/lib/scalabilityModes');
+var utils = require('mediasoup-client/lib/utils.js');
+var ortc = require('mediasoup-client/lib/ortc.js');
+var sdpCommonUtils = require('mediasoup-client/lib/handlers/sdp/commonUtils.js');
+var ortcUtils = require('mediasoup-client/lib/handlers/ortc/utils.js');
+var errors_js = require('mediasoup-client/lib/errors.js');
+var HandlerInterface_js = require('mediasoup-client/lib/handlers/HandlerInterface.js');
+var RemoteSdp_js = require('mediasoup-client/lib/handlers/sdp/RemoteSdp.js');
+var scalabilityModes_js = require('mediasoup-client/lib/scalabilityModes.js');
 var Safari12_js = require('mediasoup-client/lib/handlers/Safari12.js');
 var socket_ioClient = require('socket.io-client');
 
@@ -1741,6 +1741,7 @@ var rtcManagerEvents = {
     NEW_PC: "new_pc",
     SFU_CONNECTION_OPEN: "sfu_connection_open",
     SFU_CONNECTION_CLOSED: "sfu_connection_closed",
+    SFU_CONNECTION_INFO: "sfu_connection_info",
     COLOCATION_SPEAKER: "colocation_speaker",
     DOMINANT_SPEAKER: "dominant_speaker",
     PC_SLD_FAILURE: "pc_sld_failure",
@@ -3513,7 +3514,7 @@ const modifyMediaCapabilities = (routerRtpCapabilities, features) => {
 const logger$5 = new Logger_js.Logger("Safari17");
 const NAME = "Safari17";
 const SCTP_NUM_STREAMS = { OS: 1024, MIS: 1024 };
-class Safari17 extends HandlerInterface.HandlerInterface {
+class Safari17 extends HandlerInterface_js.HandlerInterface {
     static createFactory() {
         return () => new Safari17();
     }
@@ -3588,7 +3589,7 @@ class Safari17 extends HandlerInterface.HandlerInterface {
         this.assertNotClosed();
         logger$5.debug("run()");
         this._direction = direction;
-        this._remoteSdp = new RemoteSdp.RemoteSdp({
+        this._remoteSdp = new RemoteSdp_js.RemoteSdp({
             iceParameters,
             iceCandidates,
             dtlsParameters,
@@ -3704,7 +3705,7 @@ class Safari17 extends HandlerInterface.HandlerInterface {
                 }
                 Object.assign(sendingRtpParameters.encodings, encodings);
             }
-            const layers = scalabilityModes.parse((encodings !== null && encodings !== void 0 ? encodings : [{}])[0].scalabilityMode);
+            const layers = scalabilityModes_js.parse((encodings !== null && encodings !== void 0 ? encodings : [{}])[0].scalabilityMode);
             if (sendingRtpParameters.encodings &&
                 sendingRtpParameters.encodings.length > 1 &&
                 (sendingRtpParameters.codecs[0].mimeType.toLowerCase() === "video/vp8" ||
@@ -4156,7 +4157,7 @@ class Safari17 extends HandlerInterface.HandlerInterface {
     }
     assertNotClosed() {
         if (this._closed) {
-            throw new errors.InvalidStateError("method called in a closed handler");
+            throw new errors_js.InvalidStateError("method called in a closed handler");
         }
     }
     assertSendDirection() {
@@ -4249,6 +4250,167 @@ function getNumberOfTemporalLayers(consumer) {
     return /T3/.test(((_c = (_b = (_a = consumer._rtpParameters) === null || _a === void 0 ? void 0 : _a.encodings) === null || _b === void 0 ? void 0 : _b[0]) === null || _c === void 0 ? void 0 : _c.scalabilityMode) || "") ? 3 : 2;
 }
 
+const timeNextServer = 500;
+const minTimeNextServerSameDC = 2000;
+const timeToWaitForEarlyServerClose = 100;
+function convertToProperHostList(hostList) {
+    if (typeof hostList === "string") {
+        return hostList
+            .split(",")
+            .filter(Boolean)
+            .map((hostString) => {
+            const [dc, host] = /\|/.test(hostString) ? hostString.split("|") : ["", hostString];
+            return { host, dc };
+        });
+    }
+    return hostList.filter((item) => item.host).map((item) => ({ host: item.host, dc: item.dc || "" }));
+}
+function createVegaConnectionManager(config) {
+    let connectionInfo;
+    let lastDisconnectTime;
+    let lastNetworkUpTime;
+    let lastNetworkPossiblyDownTime;
+    let hostList = [];
+    const updateHostList = (updatedHostList) => {
+        hostList = convertToProperHostList(updatedHostList);
+    };
+    let connectionAttemptInProgress = false;
+    let hasPendingConnectionAttempt = false;
+    const connect = () => {
+        if (connectionAttemptInProgress) {
+            hasPendingConnectionAttempt = true;
+            return;
+        }
+        connectionAttemptInProgress = true;
+        hasPendingConnectionAttempt = false;
+        let targetHostList = hostList;
+        if (connectionInfo) {
+            const now = Date.now();
+            const isLongEnoughSinceDisconnect = now - 3000 > (lastDisconnectTime || 0);
+            const isNetworkUp = !lastNetworkPossiblyDownTime || (lastNetworkUpTime || 0) > lastNetworkPossiblyDownTime;
+            const hasNetworkBeenUpLongEnough = isNetworkUp && now - 3000 > (lastNetworkUpTime || 0);
+            if (!isLongEnoughSinceDisconnect || !hasNetworkBeenUpLongEnough) {
+                targetHostList = [{ host: connectionInfo.host, dc: connectionInfo.dc }];
+            }
+        }
+        const dcIndexByDC = {};
+        let currentDCIndex = 0;
+        targetHostList.forEach(({ dc }) => {
+            if (typeof dcIndexByDC[dc] === "undefined")
+                dcIndexByDC[dc] = currentDCIndex++;
+        });
+        let timeBeforeConnect = 0;
+        const prevTimeBeforeConnectByDC = {};
+        let nominatedConnection;
+        let connectionsToResolve = targetHostList.length;
+        let hasNotifiedDisconnect = false;
+        let wasConnected = false;
+        targetHostList.forEach(({ host, dc }, index) => {
+            if (index > 0) {
+                timeBeforeConnect += timeNextServer;
+                const minTimeBeforeConnect = (prevTimeBeforeConnectByDC[dc] || 0) + minTimeNextServerSameDC;
+                timeBeforeConnect = Math.max(timeBeforeConnect, minTimeBeforeConnect);
+            }
+            prevTimeBeforeConnectByDC[dc] = timeBeforeConnect;
+            setTimeout(() => {
+                var _a;
+                if (wasConnected)
+                    return;
+                const vegaConnection = new VegaConnection(((_a = config.getUrlForHost) === null || _a === void 0 ? void 0 : _a.call(config, host)) || host);
+                let wasClosed = false;
+                vegaConnection.on("open", () => {
+                    setTimeout(() => {
+                        var _a;
+                        if (wasClosed)
+                            return;
+                        if (!nominatedConnection && !wasConnected) {
+                            nominatedConnection = vegaConnection;
+                            wasConnected = true;
+                            const thisRoundFailedHosts = [
+                                ...new Set(targetHostList
+                                    .slice(0, index)
+                                    .filter((o) => o.host !== host)
+                                    .map((o) => o.host)),
+                            ];
+                            const thisRoundFailedDCs = [
+                                ...new Set(targetHostList
+                                    .slice(0, index)
+                                    .filter((o) => o.dc !== dc)
+                                    .map((o) => o.dc)),
+                            ];
+                            if (!connectionInfo) {
+                                connectionInfo = {
+                                    host,
+                                    dc,
+                                    initialHost: host,
+                                    initialDC: dc,
+                                    initialHostIndex: index,
+                                    initialDCIndex: dcIndexByDC[dc],
+                                    failedHosts: thisRoundFailedHosts,
+                                    failedDCs: thisRoundFailedDCs,
+                                    usedHosts: [host],
+                                    usedDCs: [dc],
+                                    numConnections: 1,
+                                    numUsedDCs: 1,
+                                    numUsedHosts: 1,
+                                    numFailedDCs: 0,
+                                    numFailedHosts: 0,
+                                };
+                            }
+                            else {
+                                connectionInfo = Object.assign(Object.assign({}, connectionInfo), { host,
+                                    dc, failedHosts: [
+                                        ...new Set([...thisRoundFailedHosts, ...connectionInfo.failedHosts]),
+                                    ].filter((failedHost) => failedHost !== host && !connectionInfo.usedHosts.includes(failedHost)), failedDCs: [
+                                        ...new Set([...thisRoundFailedDCs, ...connectionInfo.failedDCs]),
+                                    ].filter((failedDC) => failedDC !== dc && !connectionInfo.usedDCs.includes(failedDC)), usedHosts: [...new Set([...connectionInfo.usedHosts, host])], usedDCs: [...new Set([...connectionInfo.usedDCs, dc])], numConnections: connectionInfo.numConnections + 1 });
+                            }
+                            connectionInfo.numUsedDCs = connectionInfo.usedDCs.length;
+                            connectionInfo.numUsedHosts = connectionInfo.usedHosts.length;
+                            connectionInfo.numFailedDCs = connectionInfo.failedDCs.length;
+                            connectionInfo.numFailedHosts = connectionInfo.failedHosts.length;
+                            hasPendingConnectionAttempt = false;
+                            connectionAttemptInProgress = false;
+                            (_a = config.onConnected) === null || _a === void 0 ? void 0 : _a.call(config, vegaConnection, connectionInfo);
+                        }
+                        else {
+                            vegaConnection.close();
+                        }
+                    }, timeToWaitForEarlyServerClose);
+                });
+                vegaConnection.on("close", () => {
+                    var _a, _b;
+                    wasClosed = true;
+                    if (vegaConnection === nominatedConnection) {
+                        nominatedConnection = undefined;
+                        lastDisconnectTime = Date.now();
+                        hasNotifiedDisconnect = true;
+                        (_a = config.onDisconnected) === null || _a === void 0 ? void 0 : _a.call(config);
+                    }
+                    connectionsToResolve--;
+                    if (connectionsToResolve === 0 && !hasNotifiedDisconnect) {
+                        connectionAttemptInProgress = false;
+                        if (hasPendingConnectionAttempt) {
+                            setTimeout(connect, 0);
+                        }
+                        else {
+                            (_b = config.onFailed) === null || _b === void 0 ? void 0 : _b.call(config);
+                        }
+                    }
+                });
+            }, timeBeforeConnect);
+        });
+    };
+    updateHostList(config.initialHostList);
+    const networkIsUp = () => {
+        lastNetworkUpTime = Math.max(Date.now(), lastNetworkUpTime || 0);
+    };
+    const networkIsPossiblyDown = () => {
+        lastNetworkPossiblyDownTime = Date.now();
+    };
+    return { connect, updateHostList, networkIsUp, networkIsPossiblyDown };
+}
+
 var _a$2;
 const adapter$2 = (_a$2 = adapterRaw.default) !== null && _a$2 !== void 0 ? _a$2 : adapterRaw;
 const logger$4 = new Logger();
@@ -4262,7 +4424,7 @@ if (browserName === "chrome")
     window.document.addEventListener("beforeunload", () => (unloading = true));
 class VegaRtcManager {
     constructor({ selfId, room, emitter, serverSocket, webrtcProvider, features, eventClaim, }) {
-        const { session, iceServers, sfuServer, mediaserverConfigTtlSeconds } = room;
+        const { session, iceServers, sfuServer, sfuServers, mediaserverConfigTtlSeconds } = room;
         this._selfId = selfId;
         this._room = room;
         this._roomSessionId = session === null || session === void 0 ? void 0 : session.id;
@@ -4314,6 +4476,7 @@ class VegaRtcManager {
         };
         this._updateAndScheduleMediaServersRefresh({
             sfuServer,
+            sfuServers,
             iceServers: iceServers.iceServers || [],
             mediaserverConfigTtlSeconds,
         });
@@ -4321,18 +4484,31 @@ class VegaRtcManager {
         this._reconnect = true;
         this._reconnectTimeOut = null;
         this._hasVegaConnection = false;
+        this._isConnectingOrConnected = false;
         this._qualityMonitor = new VegaMediaQualityMonitor();
         this._qualityMonitor.on(PROTOCOL_EVENTS.MEDIA_QUALITY_CHANGED, (payload) => {
             this._emitToPWA(PROTOCOL_EVENTS.MEDIA_QUALITY_CHANGED, payload);
         });
+        this._networkIsDetectedUpBySignal = false;
     }
-    _updateAndScheduleMediaServersRefresh({ iceServers, sfuServer, mediaserverConfigTtlSeconds, }) {
-        var _a, _b;
+    _updateAndScheduleMediaServersRefresh({ iceServers, sfuServer, sfuServers, mediaserverConfigTtlSeconds, }) {
+        var _a, _b, _c;
         this._iceServers = iceServers;
         this._sfuServer = sfuServer;
+        this._sfuServers = sfuServers;
+        if (!sfuServers && (sfuServer === null || sfuServer === void 0 ? void 0 : sfuServer.fallbackServers)) {
+            this._sfuServers = sfuServer.fallbackServers.map((entry) => ({
+                host: entry.host || entry.fqdn,
+                dc: entry.dc,
+            }));
+        }
         this._mediaserverConfigTtlSeconds = mediaserverConfigTtlSeconds;
-        (_a = this._sendTransport) === null || _a === void 0 ? void 0 : _a.updateIceServers({ iceServers: this._iceServers });
-        (_b = this._receiveTransport) === null || _b === void 0 ? void 0 : _b.updateIceServers({ iceServers: this._iceServers });
+        (_a = this._vegaConnectionManager) === null || _a === void 0 ? void 0 : _a.updateHostList(this._features.sfuServersOverride ||
+            this._sfuServers ||
+            this._features.sfuServerOverrideHost ||
+            sfuServer.url);
+        (_b = this._sendTransport) === null || _b === void 0 ? void 0 : _b.updateIceServers({ iceServers: this._iceServers });
+        (_c = this._receiveTransport) === null || _c === void 0 ? void 0 : _c.updateIceServers({ iceServers: this._iceServers });
         this._clearMediaServersRefresh();
         if (!mediaserverConfigTtlSeconds) {
             return;
@@ -4345,6 +4521,20 @@ class VegaRtcManager {
         clearTimeout(this._fetchMediaServersTimer);
         this._fetchMediaServersTimer = null;
     }
+    _onNetworkIsDetectedUpBySignal() {
+        var _a;
+        if (!this._networkIsDetectedUpBySignal) {
+            this._networkIsDetectedUpBySignal = true;
+            (_a = this._vegaConnectionManager) === null || _a === void 0 ? void 0 : _a.networkIsUp();
+        }
+    }
+    _onNetworkIsDetectedPossiblyDownBySignal() {
+        var _a;
+        if (this._networkIsDetectedUpBySignal) {
+            this._networkIsDetectedUpBySignal = false;
+            (_a = this._vegaConnectionManager) === null || _a === void 0 ? void 0 : _a.networkIsPossiblyDown();
+        }
+    }
     setupSocketListeners() {
         this._socketListenerDeregisterFunctions.push(() => this._clearMediaServersRefresh(), this._serverSocket.on(PROTOCOL_RESPONSES.MEDIASERVER_CONFIG, (data) => {
             if (data.error) {
@@ -4358,7 +4548,7 @@ class VegaRtcManager {
             if (this._features.sfuReconnectV2On && !this._hasVegaConnection && this._reconnect) {
                 this._connect();
             }
-        }));
+        }), this._serverSocket.on("connect", () => this._onNetworkIsDetectedUpBySignal()), this._serverSocket.onEngineEvent("packet", () => this._onNetworkIsDetectedUpBySignal()), this._serverSocket.on("disconnect", () => this._onNetworkIsDetectedPossiblyDownBySignal()));
         this._connect();
     }
     _emitScreenshareStarted() {
@@ -4368,6 +4558,8 @@ class VegaRtcManager {
         });
     }
     _connect() {
+        if (this._features.sfuConnectionManagerOn)
+            return this._connect_v2();
         if (this._features.sfuReconnectV2On) {
             if (this._hasVegaConnection)
                 return;
@@ -4393,6 +4585,56 @@ class VegaRtcManager {
         this._vegaConnection.on("close", () => this._onClose());
         this._vegaConnection.on("message", (message) => this._onMessage(message));
     }
+    _connect_v2() {
+        if (this._features.sfuReconnectV2On) {
+            if (this._isConnectingOrConnected)
+                return;
+            if (!this._serverSocket.isConnected()) {
+                const reconnectThresholdInMs = this._serverSocket.getReconnectThreshold();
+                if (!reconnectThresholdInMs)
+                    return;
+                if (Date.now() > (this._serverSocket.disconnectTimestamp || 0) + reconnectThresholdInMs)
+                    return;
+            }
+            if (this._reconnectTimeOut)
+                clearTimeout(this._reconnectTimeOut);
+        }
+        if (!this._vegaConnectionManager) {
+            const hostList = this._features.sfuServersOverride ||
+                this._sfuServers ||
+                this._features.sfuServerOverrideHost ||
+                this._sfuServer.url;
+            this._vegaConnectionManager = createVegaConnectionManager({
+                initialHostList: hostList,
+                getUrlForHost: (host) => {
+                    const searchParams = new URLSearchParams(Object.assign({ clientId: this._selfId, organizationId: this._room.organizationId, roomName: this._room.name, eventClaim: this._room.isClaimed ? this._eventClaim : null, lowBw: "true" }, Object.keys(this._features || {})
+                        .filter((featureKey) => this._features[featureKey] && /^sfu/.test(featureKey))
+                        .reduce((prev, current) => (Object.assign(Object.assign({}, prev), { [current]: this._features[current] })), {})));
+                    const queryString = searchParams.toString();
+                    const wsUrl = `wss://${host}?${queryString}`;
+                    return wsUrl;
+                },
+                onConnected: (vegaConnection, info) => {
+                    this._vegaConnection = vegaConnection;
+                    this._vegaConnection.on("message", (message) => this._onMessage(message));
+                    this._emitToPWA(rtcManagerEvents.SFU_CONNECTION_INFO, info);
+                    this._join();
+                },
+                onDisconnected: () => {
+                    this._vegaConnection = null;
+                    this._isConnectingOrConnected = false;
+                    this._onClose();
+                },
+                onFailed: () => {
+                    this._vegaConnection = null;
+                    this._isConnectingOrConnected = false;
+                    this._onClose();
+                },
+            });
+        }
+        this._vegaConnectionManager.connect();
+        this._isConnectingOrConnected = true;
+    }
     _onClose() {
         var _a, _b;
         logger$4.info("_onClose()");
@@ -6086,6 +6328,14 @@ class ServerSocket {
             this._socket.off(eventName, handler);
         };
     }
+    onEngineEvent(eventName, handler) {
+        var _a;
+        (_a = this._socket.io) === null || _a === void 0 ? void 0 : _a.on(eventName, handler);
+        return () => {
+            var _a;
+            (_a = this._socket.io) === null || _a === void 0 ? void 0 : _a.off(eventName, handler);
+        };
+    }
     once(eventName, handler) {
         this._socket.once(eventName, handler);
     }

package/dist/index.d.cts

@@ -655,6 +655,7 @@ declare class ServerSocket {
     isConnecting(): any;
     isConnected(): any;
     on(eventName: string, handler: Function): () => void;
+    onEngineEvent(eventName: string, handler: Function): () => void;
     once(eventName: string, handler: Function): void;
     off(eventName: string, handler: Function): void;
     _interceptEvent(eventName: string, handler: any): () => void;
@@ -1045,6 +1046,7 @@ declare const _default: {
     NEW_PC: string;
     SFU_CONNECTION_OPEN: string;
     SFU_CONNECTION_CLOSED: string;
+    SFU_CONNECTION_INFO: string;
     COLOCATION_SPEAKER: string;
     DOMINANT_SPEAKER: string;
     PC_SLD_FAILURE: string;
@@ -1252,6 +1254,40 @@ declare const standardDeviation: (arr: any[]) => {
 };
 declare const variance: (arr: any[], usePopulation?: boolean) => number;
 
+type ConnectionInfo = {
+    host: string;
+    dc: string;
+    initialHost: string;
+    initialDC: string;
+    initialHostIndex: number;
+    initialDCIndex: number;
+    failedDCs: string[];
+    numFailedDCs: number;
+    failedHosts: string[];
+    numFailedHosts: number;
+    usedDCs: string[];
+    numUsedDCs: number;
+    usedHosts: string[];
+    numUsedHosts: number;
+    numConnections: number;
+};
+type HostListEntryOptionalDC = {
+    host: string;
+    dc?: string;
+};
+declare function createVegaConnectionManager(config: {
+    initialHostList: string | any[];
+    getUrlForHost?: (host: string) => string;
+    onConnected?: (vegaConnection: VegaConnection, info: ConnectionInfo) => void;
+    onDisconnected?: () => void;
+    onFailed?: () => void;
+}): {
+    connect: () => void;
+    updateHostList: (updatedHostList: string | HostListEntryOptionalDC[]) => void;
+    networkIsUp: () => void;
+    networkIsPossiblyDown: () => void;
+};
+
 declare class VegaRtcManager implements RtcManager {
     _selfId: any;
     _room: any;
@@ -1306,10 +1342,14 @@ declare class VegaRtcManager implements RtcManager {
     _fetchMediaServersTimer: any;
     _iceServers: any;
     _sfuServer: any;
+    _sfuServers?: HostListEntryOptionalDC[];
     _mediaserverConfigTtlSeconds: any;
     _videoTrackBeingMonitored?: CustomMediaStreamTrack;
     _audioTrackBeingMonitored?: CustomMediaStreamTrack;
     _hasVegaConnection: boolean;
+    _isConnectingOrConnected: boolean;
+    _vegaConnectionManager?: ReturnType<typeof createVegaConnectionManager>;
+    _networkIsDetectedUpBySignal: boolean;
     constructor({ selfId, room, emitter, serverSocket, webrtcProvider, features, eventClaim, }: {
         selfId: any;
         room: any;
@@ -1319,15 +1359,19 @@ declare class VegaRtcManager implements RtcManager {
         features?: any;
         eventClaim?: string;
     });
-    _updateAndScheduleMediaServersRefresh({ iceServers, sfuServer, mediaserverConfigTtlSeconds, }: {
+    _updateAndScheduleMediaServersRefresh({ iceServers, sfuServer, sfuServers, mediaserverConfigTtlSeconds, }: {
         iceServers: any;
         sfuServer: any;
+        sfuServers: any;
         mediaserverConfigTtlSeconds: any;
     }): void;
     _clearMediaServersRefresh(): void;
+    _onNetworkIsDetectedUpBySignal(): void;
+    _onNetworkIsDetectedPossiblyDownBySignal(): void;
     setupSocketListeners(): void;
     _emitScreenshareStarted(): void;
     _connect(): void;
+    _connect_v2(): void;
     _onClose(): void;
     _join(): Promise<void>;
     _createTransport(send: any): Promise<void>;

package/dist/index.d.mts

@@ -655,6 +655,7 @@ declare class ServerSocket {
     isConnecting(): any;
     isConnected(): any;
     on(eventName: string, handler: Function): () => void;
+    onEngineEvent(eventName: string, handler: Function): () => void;
     once(eventName: string, handler: Function): void;
     off(eventName: string, handler: Function): void;
     _interceptEvent(eventName: string, handler: any): () => void;
@@ -1045,6 +1046,7 @@ declare const _default: {
     NEW_PC: string;
     SFU_CONNECTION_OPEN: string;
     SFU_CONNECTION_CLOSED: string;
+    SFU_CONNECTION_INFO: string;
     COLOCATION_SPEAKER: string;
     DOMINANT_SPEAKER: string;
     PC_SLD_FAILURE: string;
@@ -1252,6 +1254,40 @@ declare const standardDeviation: (arr: any[]) => {
 };
 declare const variance: (arr: any[], usePopulation?: boolean) => number;
 
+type ConnectionInfo = {
+    host: string;
+    dc: string;
+    initialHost: string;
+    initialDC: string;
+    initialHostIndex: number;
+    initialDCIndex: number;
+    failedDCs: string[];
+    numFailedDCs: number;
+    failedHosts: string[];
+    numFailedHosts: number;
+    usedDCs: string[];
+    numUsedDCs: number;
+    usedHosts: string[];
+    numUsedHosts: number;
+    numConnections: number;
+};
+type HostListEntryOptionalDC = {
+    host: string;
+    dc?: string;
+};
+declare function createVegaConnectionManager(config: {
+    initialHostList: string | any[];
+    getUrlForHost?: (host: string) => string;
+    onConnected?: (vegaConnection: VegaConnection, info: ConnectionInfo) => void;
+    onDisconnected?: () => void;
+    onFailed?: () => void;
+}): {
+    connect: () => void;
+    updateHostList: (updatedHostList: string | HostListEntryOptionalDC[]) => void;
+    networkIsUp: () => void;
+    networkIsPossiblyDown: () => void;
+};
+
 declare class VegaRtcManager implements RtcManager {
     _selfId: any;
     _room: any;
@@ -1306,10 +1342,14 @@ declare class VegaRtcManager implements RtcManager {
     _fetchMediaServersTimer: any;
     _iceServers: any;
     _sfuServer: any;
+    _sfuServers?: HostListEntryOptionalDC[];
     _mediaserverConfigTtlSeconds: any;
     _videoTrackBeingMonitored?: CustomMediaStreamTrack;
     _audioTrackBeingMonitored?: CustomMediaStreamTrack;
     _hasVegaConnection: boolean;
+    _isConnectingOrConnected: boolean;
+    _vegaConnectionManager?: ReturnType<typeof createVegaConnectionManager>;
+    _networkIsDetectedUpBySignal: boolean;
     constructor({ selfId, room, emitter, serverSocket, webrtcProvider, features, eventClaim, }: {
         selfId: any;
         room: any;
@@ -1319,15 +1359,19 @@ declare class VegaRtcManager implements RtcManager {
         features?: any;
         eventClaim?: string;
     });
-    _updateAndScheduleMediaServersRefresh({ iceServers, sfuServer, mediaserverConfigTtlSeconds, }: {
+    _updateAndScheduleMediaServersRefresh({ iceServers, sfuServer, sfuServers, mediaserverConfigTtlSeconds, }: {
         iceServers: any;
         sfuServer: any;
+        sfuServers: any;
         mediaserverConfigTtlSeconds: any;
     }): void;
     _clearMediaServersRefresh(): void;
+    _onNetworkIsDetectedUpBySignal(): void;
+    _onNetworkIsDetectedPossiblyDownBySignal(): void;
     setupSocketListeners(): void;
     _emitScreenshareStarted(): void;
     _connect(): void;
+    _connect_v2(): void;
     _onClose(): void;
     _join(): Promise<void>;
     _createTransport(send: any): Promise<void>;

package/dist/index.d.ts

@@ -655,6 +655,7 @@ declare class ServerSocket {
     isConnecting(): any;
     isConnected(): any;
     on(eventName: string, handler: Function): () => void;
+    onEngineEvent(eventName: string, handler: Function): () => void;
     once(eventName: string, handler: Function): void;
     off(eventName: string, handler: Function): void;
     _interceptEvent(eventName: string, handler: any): () => void;
@@ -1045,6 +1046,7 @@ declare const _default: {
     NEW_PC: string;
     SFU_CONNECTION_OPEN: string;
     SFU_CONNECTION_CLOSED: string;
+    SFU_CONNECTION_INFO: string;
     COLOCATION_SPEAKER: string;
     DOMINANT_SPEAKER: string;
     PC_SLD_FAILURE: string;
@@ -1252,6 +1254,40 @@ declare const standardDeviation: (arr: any[]) => {
 };
 declare const variance: (arr: any[], usePopulation?: boolean) => number;
 
+type ConnectionInfo = {
+    host: string;
+    dc: string;
+    initialHost: string;
+    initialDC: string;
+    initialHostIndex: number;
+    initialDCIndex: number;
+    failedDCs: string[];
+    numFailedDCs: number;
+    failedHosts: string[];
+    numFailedHosts: number;
+    usedDCs: string[];
+    numUsedDCs: number;
+    usedHosts: string[];
+    numUsedHosts: number;
+    numConnections: number;
+};
+type HostListEntryOptionalDC = {
+    host: string;
+    dc?: string;
+};
+declare function createVegaConnectionManager(config: {
+    initialHostList: string | any[];
+    getUrlForHost?: (host: string) => string;
+    onConnected?: (vegaConnection: VegaConnection, info: ConnectionInfo) => void;
+    onDisconnected?: () => void;
+    onFailed?: () => void;
+}): {
+    connect: () => void;
+    updateHostList: (updatedHostList: string | HostListEntryOptionalDC[]) => void;
+    networkIsUp: () => void;
+    networkIsPossiblyDown: () => void;
+};
+
 declare class VegaRtcManager implements RtcManager {
     _selfId: any;
     _room: any;
@@ -1306,10 +1342,14 @@ declare class VegaRtcManager implements RtcManager {
     _fetchMediaServersTimer: any;
     _iceServers: any;
     _sfuServer: any;
+    _sfuServers?: HostListEntryOptionalDC[];
     _mediaserverConfigTtlSeconds: any;
     _videoTrackBeingMonitored?: CustomMediaStreamTrack;
     _audioTrackBeingMonitored?: CustomMediaStreamTrack;
     _hasVegaConnection: boolean;
+    _isConnectingOrConnected: boolean;
+    _vegaConnectionManager?: ReturnType<typeof createVegaConnectionManager>;
+    _networkIsDetectedUpBySignal: boolean;
     constructor({ selfId, room, emitter, serverSocket, webrtcProvider, features, eventClaim, }: {
         selfId: any;
         room: any;
@@ -1319,15 +1359,19 @@ declare class VegaRtcManager implements RtcManager {
         features?: any;
         eventClaim?: string;
     });
-    _updateAndScheduleMediaServersRefresh({ iceServers, sfuServer, mediaserverConfigTtlSeconds, }: {
+    _updateAndScheduleMediaServersRefresh({ iceServers, sfuServer, sfuServers, mediaserverConfigTtlSeconds, }: {
         iceServers: any;
         sfuServer: any;
+        sfuServers: any;
         mediaserverConfigTtlSeconds: any;
     }): void;
     _clearMediaServersRefresh(): void;
+    _onNetworkIsDetectedUpBySignal(): void;
+    _onNetworkIsDetectedPossiblyDownBySignal(): void;
     setupSocketListeners(): void;
     _emitScreenshareStarted(): void;
     _connect(): void;
+    _connect_v2(): void;
     _onClose(): void;
     _join(): Promise<void>;
     _createTransport(send: any): Promise<void>;