@webex/plugin-meetings 2.60.0-next.1 → 2.60.0-next.11

package/dist/reachability/index.d.ts

@@ -0,0 +1,194 @@
+/*!
+ * Copyright (c) 2015-2020 Cisco Systems, Inc. See LICENSE file.
+ */
+export type ReachabilityMetrics = {
+    reachability_public_udp_success: number;
+    reachability_public_udp_failed: number;
+    reachability_public_tcp_success: number;
+    reachability_public_tcp_failed: number;
+    reachability_vmn_udp_success: number;
+    reachability_vmn_udp_failed: number;
+    reachability_vmn_tcp_success: number;
+    reachability_vmn_tcp_failed: number;
+};
+export type TransportResult = {
+    reachable?: 'true' | 'false';
+    latencyInMilliseconds?: string;
+    clientMediaIPs?: string[];
+    untested?: 'true';
+};
+type ReachabilityResult = {
+    udp: TransportResult;
+    tcp: TransportResult;
+    xtls: {
+        untested: 'true';
+    };
+};
+export type ReachabilityResults = Record<string, ReachabilityResult>;
+type InternalReachabilityResults = Record<string, ReachabilityResult & {
+    isVideoMesh?: boolean;
+}>;
+export type ICECandidateResult = {
+    clusterId: string;
+    isVideoMesh: boolean;
+    elapsed?: string | null;
+    publicIPs?: string[];
+};
+/**
+ * @class Reachability
+ * @export
+ */
+export default class Reachability {
+    namespace: string;
+    webex: object;
+    reachabilityRequest: any;
+    clusterLatencyResults: any;
+    /**
+     * Creates an instance of Reachability.
+     * @param {object} webex
+     * @memberof Reachability
+     */
+    constructor(webex: object);
+    /**
+     * fetches reachability data
+     * @returns {Object} reachability data
+     * @public
+     * @async
+     * @memberof Reachability
+     */
+    gatherReachability(): Promise<InternalReachabilityResults>;
+    /**
+     * Returns statistics about last reachability results. The returned value is an object
+     * with a flat list of properties so that it can be easily sent with metrics
+     *
+     * @returns {Promise} Promise with metrics values, it never rejects/throws.
+     */
+    getReachabilityMetrics(): Promise<ReachabilityMetrics>;
+    /**
+     * Reachability results as an object in the format that backend expects
+     *
+     * @returns {any} reachability results that need to be sent to the backend
+     */
+    getReachabilityResults(): Promise<ReachabilityResults | undefined>;
+    /**
+     * fetches reachability data and checks for cluster reachability
+     * @returns {boolean}
+     * @public
+     * @memberof Reachability
+     */
+    isAnyPublicClusterReachable(): Promise<boolean>;
+    /**
+     * Generate peerConnection config settings
+     * @param {object} cluster
+     * @returns {object} peerConnectionConfig
+     * @private
+     * @memberof Reachability
+     */
+    private buildPeerConnectionConfig;
+    /**
+     * Creates an RTCPeerConnection
+     * @param {object} cluster
+     * @returns {RTCPeerConnection} peerConnection
+     * @private
+     * @memberof Reachability
+     */
+    private createPeerConnection;
+    /**
+     * Gets total elapsed time
+     * @param {RTCPeerConnection} peerConnection
+     * @returns {Number} Milliseconds
+     * @private
+     * @memberof Reachability
+     */
+    private getElapsedTime;
+    /**
+     * creates offer and generates localSDP
+     * @param {object} clusterList cluster List
+     * @returns {Promise} Reachability latency results
+     * @private
+     * @memberof Reachability
+     */
+    private getLocalSDPForClusters;
+    /**
+     * Get list of all unreachable clusters
+     * @returns {array} Unreachable clusters
+     * @private
+     * @memberof Reachability
+     */
+    private getUnreachablClusters;
+    /**
+     * Attach an event handler for the icegatheringstatechange
+     * event and measure latency.
+     * @param {RTCPeerConnection} peerConnection
+     * @returns {undefined}
+     * @private
+     * @memberof Reachability
+     */
+    private handleIceGatheringStateChange;
+    /**
+     * Attach an event handler for the icecandidate
+     * event and measure latency.
+     * @param {RTCPeerConnection} peerConnection
+     * @returns {undefined}
+     * @private
+     * @memberof Reachability
+     */
+    private handleOnIceCandidate;
+    /**
+     * An event handler on an RTCPeerConnection when the state of the ICE
+     * candidate gathering process changes. Used to measure connection
+     * speed.
+     * @private
+     * @param {RTCPeerConnection} peerConnection
+     * @param {boolean} isVideoMesh
+     * @returns {Promise}
+     */
+    private iceGatheringState;
+    /**
+     * Make a log of unreachable clusters.
+     * @returns {undefined}
+     * @private
+     * @memberof Reachability
+     */
+    private logUnreachableClusters;
+    /**
+     * Calculates time to establish connection
+     * @param {Array<ICECandidateResult>} iceResults iceResults
+     * @returns {object} reachabilityMap
+     * @protected
+     * @memberof Reachability
+     */
+    protected parseIceResultsToInternalReachabilityResults(iceResults: Array<ICECandidateResult>): InternalReachabilityResults;
+    /**
+     * fetches reachability data
+     * @param {object} clusterList
+     * @returns {Promise<InternalReachabilityResults>} reachability check results
+     * @private
+     * @memberof Reachability
+     */
+    private performReachabilityCheck;
+    /**
+     * Adds public IP (client media IPs)
+     * @param {RTCPeerConnection} peerConnection
+     * @param {string} publicIP
+     * @returns {void}
+     */
+    protected addPublicIP(peerConnection: RTCPeerConnection, publicIP?: string | null): void;
+    /**
+     * Records latency and closes the peerConnection
+     * @param {RTCPeerConnection} peerConnection
+     * @param {number} elapsed Latency in milliseconds
+     * @returns {undefined}
+     * @private
+     * @memberof Reachability
+     */
+    private setLatencyAndClose;
+    /**
+     * utility function
+     * @returns {undefined}
+     * @private
+     * @memberof Reachability
+     */
+    private setup;
+}
+export {};

package/dist/reachability/request.d.ts

@@ -0,0 +1,39 @@
+import { IP_VERSION } from '../constants';
+export interface ClusterNode {
+    isVideoMesh: boolean;
+    udp: Array<string>;
+    tcp: Array<string>;
+    xtls: Array<string>;
+}
+export type ClusterList = {
+    [key: string]: ClusterNode;
+};
+/**
+ * @class ReachabilityRequest
+ */
+declare class ReachabilityRequest {
+    webex: any;
+    /**
+     * Creates an instance of ReachabilityRequest.
+     * @param {object} webex
+     * @memberof ReachabilityRequest
+     */
+    constructor(webex: object);
+    /**
+     * Gets the cluster information
+     *
+     * @param {IP_VERSION} ipVersion information about current ip network we're on
+     * @returns {Promise}
+     */
+    getClusters: (ipVersion?: IP_VERSION) => Promise<{
+        clusters: ClusterList;
+        joinCookie: any;
+    }>;
+    /**
+     * gets remote SDP For Clusters
+     * @param {Object} localSDPList localSDPs for the cluster
+     * @returns {Object}
+     */
+    remoteSDPForClusters: (localSDPList: object) => any;
+}
+export default ReachabilityRequest;

package/dist/reactions/constants.d.ts

@@ -0,0 +1,3 @@
+export declare const REACTION_RELAY_TYPES: {
+    readonly REACTION: "react";
+};

package/dist/reactions/reactions.d.ts

@@ -0,0 +1,4 @@
+import { Reaction, ReactionServerType, SkinTone, SkinToneType } from './reactions.type';
+declare const Reactions: Record<ReactionServerType, Reaction>;
+declare const SkinTones: Record<SkinToneType, SkinTone>;
+export { Reactions, SkinTones };

package/dist/reactions/reactions.type.d.ts

@@ -0,0 +1,52 @@
+import { REACTION_RELAY_TYPES } from './constants';
+export type EmoticonData = {
+    type: string;
+    codepoints?: string;
+    shortcodes?: string;
+};
+export type SkinTone = EmoticonData;
+export type Reaction = EmoticonData & {
+    tone?: SkinTone;
+};
+export declare enum ReactionServerType {
+    smile = "smile",
+    sad = "sad",
+    wow = "wow",
+    haha = "haha",
+    celebrate = "celebrate",
+    clap = "clap",
+    thumb_up = "thumb_up",
+    thumb_down = "thumb_down",
+    heart = "heart",
+    fire = "fire",
+    prayer = "prayer",
+    speed_up = "speed_up",
+    slow_down = "slow_down"
+}
+export declare enum SkinToneType {
+    normal = "normal",
+    light = "light",
+    medium_light = "medium_light",
+    medium = "medium",
+    medium_dark = "medium_dark",
+    dark = "dark"
+}
+export type Sender = {
+    participantId: string;
+};
+export type ProcessedReaction = {
+    reaction: Reaction;
+    sender: {
+        id: Sender['participantId'];
+        name: string;
+    };
+};
+type RelayEventData = {
+    relayType: (typeof REACTION_RELAY_TYPES)['REACTION'];
+    reaction: Reaction;
+    sender: Sender;
+};
+export type RelayEvent = {
+    data: RelayEventData;
+};
+export {};

package/dist/reconnection-manager/index.d.ts

@@ -0,0 +1,136 @@
+/*!
+ * Copyright (c) 2015-2020 Cisco Systems, Inc. See LICENSE file.
+ */
+import { RECONNECTION_STATE } from '../constants';
+import Meeting from '../meeting';
+/**
+ * @export
+ * @class ReconnectionManager
+ */
+export default class ReconnectionManager {
+    autoRejoinEnabled: any;
+    iceState: any;
+    maxRejoinAttempts: any;
+    meeting: any;
+    rejoinAttempts: any;
+    shareStatus: any;
+    status: any;
+    tryCount: any;
+    webex: any;
+    /**
+     * @param {Meeting} meeting
+     */
+    constructor(meeting: Meeting);
+    /**
+     * @public
+     * @memberof ReconnectionManager
+     * @returns {void}
+     */
+    resetReconnectionTimer(): void;
+    /**
+     * Sets the iceState to connected and clears any disconnect timeouts and
+     * related timeout data within the iceState.
+     *
+     * @returns {undefined}
+     * @public
+     * @memberof ReconnectionManager
+     */
+    iceReconnected(): void;
+    /**
+     * Set the iceState to disconnected and generates a timeout that waits for the
+     * iceState to reconnect and then resolves. If the ice state is already
+     * processing a reconnect, it immediately resolves. Rejects if the timeout
+     * duration is reached.
+     *
+     * @returns {Promise<undefined>}
+     * @public
+     * @memberof ReconnectionManager
+     */
+    waitForIceReconnect(): Promise<void>;
+    /**
+     * @returns {undefined}
+     * @public
+     * @memberof ReconnectionManager
+     */
+    reset(): void;
+    /**
+     * @returns {undefined}
+     * @public
+     * @memberof ReconnectionManager
+     */
+    cleanUp(): void;
+    /**
+     * Stop the local share stream.
+     *
+     * @param {string} reason a {@link SHARE_STOPPED_REASON}
+     * @returns {undefined}
+     * @private
+     * @memberof ReconnectionManager
+     */
+    private stopLocalShareStream;
+    /**
+     * @public
+     * @memberof ReconnectionManager
+     * @returns {Boolean} true if reconnection operation is in progress
+     */
+    isReconnectInProgress(): boolean;
+    /**
+     * Sets the reconnection status
+     *
+     * @public
+     * @param {RECONNECTION_STATE} status
+     * @memberof ReconnectionManager
+     * @returns {undefined}
+     */
+    setStatus(status: RECONNECTION_STATE): void;
+    /**
+     * @returns {Boolean}
+     * @throws {ReconnectionError}
+     * @private
+     * @memberof ReconnectionManager
+     */
+    private validate;
+    /**
+     * Initiates a media reconnect for the active meeting
+     * @param {Object} reconnectOptions
+     * @param {boolean} [reconnectOptions.networkDisconnect=false] indicates if a network disconnect event happened
+     * @param {boolean} [reconnectOptions.networkRetry=false] indicates if we are retrying the reconnect
+     * @returns {Promise}
+     * @public
+     * @memberof ReconnectionManager
+     */
+    reconnect({ networkDisconnect, networkRetry, }?: {
+        networkDisconnect?: boolean;
+        networkRetry?: boolean;
+    }): any;
+    /**
+     * @param {Object} reconnectOptions
+     * @param {boolean} [reconnectOptions.networkDisconnect=false] indicates if a network disconnect event happened
+     * @returns {Promise}
+     * @throws {NeedsRetryError}
+     * @private
+     * @memberof ReconnectionManager
+     */
+    private executeReconnection;
+    /**
+     * Rejoins a meeting after detecting the member was in a LEFT state
+     *
+     * @async
+     * @param {boolean} wasSharing
+     * @returns {Promise}
+     */
+    rejoinMeeting(wasSharing?: boolean): Promise<void>;
+    /**
+     * @returns {Promise}
+     * @private
+     * @memberof ReconnectionManager
+     */
+    reconnectMedia(): Promise<void>;
+    /**
+     * Attempt to Reconnect Mercury Websocket
+     * @returns {Promise}
+     * @private
+     * @memberof ReconnectionManager
+     */
+    private reconnectMercuryWebSocket;
+}

package/dist/reconnection-manager/index.js

@@ -23,9 +23,9 @@ var _loggerProxy = _interopRequireDefault(require("../common/logs/logger-proxy")
 var _triggerProxy = _interopRequireDefault(require("../common/events/trigger-proxy"));
 var _constants = require("../constants");
 var _constants2 = _interopRequireDefault(require("../metrics/constants"));
-var _reconnection = _interopRequireDefault(require("../common/errors/reconnection"));
 var _reconnectionInProgress = _interopRequireDefault(require("../common/errors/reconnection-in-progress"));
 var _metrics = _interopRequireDefault(require("../metrics"));
+var _reconnection = _interopRequireDefault(require("../common/errors/reconnection"));
 function _createSuper(Derived) { var hasNativeReflectConstruct = _isNativeReflectConstruct(); return function _createSuperInternal() { var Super = (0, _getPrototypeOf2.default)(Derived), result; if (hasNativeReflectConstruct) { var NewTarget = (0, _getPrototypeOf2.default)(this).constructor; result = _Reflect$construct(Super, arguments, NewTarget); } else { result = Super.apply(this, arguments); } return (0, _possibleConstructorReturn2.default)(this, result); }; }
 function _isNativeReflectConstruct() { if (typeof Reflect === "undefined" || !_Reflect$construct) return false; if (_Reflect$construct.sham) return false; if (typeof Proxy === "function") return true; try { Boolean.prototype.valueOf.call(_Reflect$construct(Boolean, [], function () {})); return true; } catch (e) { return false; } } /*!
  * Copyright (c) 2015-2020 Cisco Systems, Inc. See LICENSE file.
@@ -112,7 +112,7 @@ var ReconnectionManager = exports.default = /*#__PURE__*/function () {
 
     /**
      * @instance
-     * @type {String}
+     * @type {RECONNECTION_STATE}
      * @private
      * @memberof ReconnectionManager
      */
@@ -244,7 +244,6 @@ var ReconnectionManager = exports.default = /*#__PURE__*/function () {
     key: "cleanUp",
     value: function cleanUp() {
       this.reset();
-      this.meeting = null;
     }
 
     /**
@@ -294,6 +293,20 @@ var ReconnectionManager = exports.default = /*#__PURE__*/function () {
       return this.status === _constants.RECONNECTION.STATE.IN_PROGRESS;
     }
 
+    /**
+     * Sets the reconnection status
+     *
+     * @public
+     * @param {RECONNECTION_STATE} status
+     * @memberof ReconnectionManager
+     * @returns {undefined}
+     */
+  }, {
+    key: "setStatus",
+    value: function setStatus(status) {
+      this.status = status;
+    }
+
     /**
      * @returns {Boolean}
      * @throws {ReconnectionError}
@@ -364,20 +377,6 @@ var ReconnectionManager = exports.default = /*#__PURE__*/function () {
               }
               return _context2.abrupt("return", this.executeReconnection({
                 networkDisconnect: networkDisconnect
-              }).then(function () {
-                _loggerProxy.default.logger.info('ReconnectionManager:index#reconnect --> Reconnection successful.');
-                _loggerProxy.default.logger.info('ReconnectionManager:index#reconnect --> Sending reconnect success metric.');
-
-                // @ts-ignore
-                _this3.webex.internal.newMetrics.submitClientEvent({
-                  name: 'client.media.recovered',
-                  payload: {
-                    recoveredBy: 'new'
-                  },
-                  options: {
-                    meetingId: _this3.meeting.id
-                  }
-                });
               }).catch(function (reconnectError) {
                 if (reconnectError instanceof NeedsRetryError) {
                   _loggerProxy.default.logger.info('ReconnectionManager:index#reconnect --> Reconnection not successful, retrying.');
@@ -523,20 +522,19 @@ var ReconnectionManager = exports.default = /*#__PURE__*/function () {
               return this.reconnectMedia();
             case 41:
               media = _context3.sent;
-              _loggerProxy.default.logger.log('ReconnectionManager:index#executeReconnection --> Media reestablished');
-              this.status = _constants.RECONNECTION.STATE.COMPLETE;
+              _loggerProxy.default.logger.log('ReconnectionManager:index#executeReconnection --> webRTC media connection renewed and local sdp offer sent');
               return _context3.abrupt("return", media);
-            case 47:
-              _context3.prev = 47;
+            case 46:
+              _context3.prev = 46;
               _context3.t2 = _context3["catch"](38);
-              _loggerProxy.default.logger.error('ReconnectionManager:index#executeReconnection --> Media reestablishment failed');
+              _loggerProxy.default.logger.error('ReconnectionManager:index#executeReconnection --> failed to renew webRTC media connection or initiate offer');
               this.status = _constants.RECONNECTION.STATE.FAILURE;
               throw _context3.t2;
-            case 52:
+            case 51:
             case "end":
               return _context3.stop();
           }
-        }, _callee3, this, [[8, 14], [20, 26], [38, 47]]);
+        }, _callee3, this, [[8, 14], [20, 26], [38, 46]]);
       }));
       function executeReconnection(_x2) {
         return _executeReconnection.apply(this, arguments);
@@ -636,7 +634,7 @@ var ReconnectionManager = exports.default = /*#__PURE__*/function () {
         return _regenerator.default.wrap(function _callee5$(_context5) {
           while (1) switch (_context5.prev = _context5.next) {
             case 0:
-              _loggerProxy.default.logger.log('ReconnectionManager:index#reconnectMedia --> Begin reestablishment of media');
+              _loggerProxy.default.logger.log('ReconnectionManager:index#reconnectMedia --> do turn discovery');
 
               // do the TURN server discovery again and ignore reachability results since the TURN server might change
               _context5.next = 3;
@@ -651,9 +649,10 @@ var ReconnectionManager = exports.default = /*#__PURE__*/function () {
                   credential: turnServerResult.turnServerInfo.password || ''
                 });
               }
-              _context5.next = 8;
+              _loggerProxy.default.logger.log('ReconnectionManager:index#reconnectMedia --> renew webRTC media connection and send local sdp offer');
+              _context5.next = 9;
               return this.meeting.mediaProperties.webrtcMediaConnection.reconnect(iceServers);
-            case 8:
+            case 9:
               // resend media requests
               if (this.meeting.isMultistream) {
                 (0, _values.default)(this.meeting.mediaRequestManagers).forEach(function (mediaRequestManager) {
@@ -661,7 +660,7 @@ var ReconnectionManager = exports.default = /*#__PURE__*/function () {
                   mediaRequestManager.commit();
                 });
               }
-            case 9:
+            case 10:
             case "end":
               return _context5.stop();
           }