@webex/plugin-meetings 2.60.0-next.9 → 2.60.1-next.1

package/dist/reachability/index.d.ts

@@ -1,6 +1,8 @@
 /*!
  * Copyright (c) 2015-2020 Cisco Systems, Inc. See LICENSE file.
  */
+import ReachabilityRequest from './request';
+import { ClusterReachability, ClusterReachabilityResult } from './clusterReachability';
 export type ReachabilityMetrics = {
     reachability_public_udp_success: number;
     reachability_public_udp_failed: number;
@@ -11,29 +13,25 @@ export type ReachabilityMetrics = {
     reachability_vmn_tcp_success: number;
     reachability_vmn_tcp_failed: number;
 };
-export type TransportResult = {
+/**
+ * This is the type that matches what backend expects us to send to them. It is a bit weird, because
+ * it uses strings instead of booleans and numbers, but that's what they require.
+ */
+export type TransportResultForBackend = {
     reachable?: 'true' | 'false';
     latencyInMilliseconds?: string;
     clientMediaIPs?: string[];
     untested?: 'true';
 };
-type ReachabilityResult = {
-    udp: TransportResult;
-    tcp: TransportResult;
-    xtls: {
-        untested: 'true';
-    };
+export type ReachabilityResultForBackend = {
+    udp: TransportResultForBackend;
+    tcp: TransportResultForBackend;
+    xtls: TransportResultForBackend;
 };
-export type ReachabilityResults = Record<string, ReachabilityResult>;
-type InternalReachabilityResults = Record<string, ReachabilityResult & {
+export type ReachabilityResultsForBackend = Record<string, ReachabilityResultForBackend>;
+export type ReachabilityResults = Record<string, ClusterReachabilityResult & {
     isVideoMesh?: boolean;
 }>;
-export type ICECandidateResult = {
-    clusterId: string;
-    isVideoMesh: boolean;
-    elapsed?: string | null;
-    publicIPs?: string[];
-};
 /**
  * @class Reachability
  * @export
@@ -41,8 +39,10 @@ export type ICECandidateResult = {
 export default class Reachability {
     namespace: string;
     webex: object;
-    reachabilityRequest: any;
-    clusterLatencyResults: any;
+    reachabilityRequest: ReachabilityRequest;
+    clusterReachability: {
+        [key: string]: ClusterReachability;
+    };
     /**
      * Creates an instance of Reachability.
      * @param {object} webex
@@ -50,13 +50,12 @@ export default class Reachability {
      */
     constructor(webex: object);
     /**
-     * fetches reachability data
-     * @returns {Object} reachability data
+     * Gets a list of media clusters from the backend and performs reachability checks on all the clusters
+     * @returns {Promise<ReachabilityResults>} reachability results
      * @public
-     * @async
      * @memberof Reachability
      */
-    gatherReachability(): Promise<InternalReachabilityResults>;
+    gatherReachability(): Promise<ReachabilityResults>;
     /**
      * 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
@@ -64,12 +63,18 @@ export default class Reachability {
      * @returns {Promise} Promise with metrics values, it never rejects/throws.
      */
     getReachabilityMetrics(): Promise<ReachabilityMetrics>;
+    /**
+     * Maps our internal transport result to the format that backend expects
+     * @param {TransportResult} transportResult
+     * @returns {TransportResultForBackend}
+     */
+    private mapTransportResultToBackendDataFormat;
     /**
      * 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>;
+    getReachabilityResults(): Promise<ReachabilityResultsForBackend | undefined>;
     /**
      * fetches reachability data and checks for cluster reachability
      * @returns {boolean}
@@ -77,73 +82,13 @@ export default class Reachability {
      * @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;
+    private getUnreachableClusters;
     /**
      * Make a log of unreachable clusters.
      * @returns {undefined}
@@ -152,43 +97,9 @@ export default class 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
+     * Performs reachability checks for all clusters
+     * @param {ClusterList} clusterList
+     * @returns {Promise<ReachabilityResults>} reachability check results
      */
-    private setup;
+    private performReachabilityChecks;
 }
-export {};