@webex/plugin-meetings 3.0.0-beta.394 → 3.0.0-beta.396

package/dist/roap/index.js.map

@@ -1 +1 @@
-{"version":3,"names":["Roap","attrs","options","roapRequest","RoapRequest","turnDiscovery","TurnDiscovery","resolve","then","meeting","webex","meetings","meetingCollection","getByKey","correlationId","roapMessage","messageType","ROAP","ROAP_TYPES","OK","version","ROAP_VERSION","seq","LoggerProxy","logger","log","sendRoap","locusSelfUrl","selfUrl","mediaId","meetingId","id","locusMediaRequest","ANSWER","sdps","sdp","ERROR","errorType","tieBreaker","OFFER","headers","sendEmptyMediaId","preferTranscoding","isMultistream","ipVersion","MeetingUtil","getIpVersion","locus","mediaConnections","updateMediaConnections","roapAnswer","remoteSdp","JSON","parse","answerSeq","errorCause","Metrics","sendBehavioralMetric","BEHAVIORAL_METRICS","ROAP_HTTP_RESPONSE_MISSING","isReconnecting","isForced","doTurnDiscovery","StatelessWebexPlugin"],"sources":["index.ts"],"sourcesContent":["// @ts-ignore\nimport {StatelessWebexPlugin} from '@webex/webex-core';\n\nimport {ROAP} from '../constants';\nimport LoggerProxy from '../common/logs/logger-proxy';\n\nimport RoapRequest from './request';\nimport TurnDiscovery from './turnDiscovery';\nimport Meeting from '../meeting';\nimport MeetingUtil from '../meeting/util';\nimport Metrics from '../metrics';\nimport BEHAVIORAL_METRICS from '../metrics/constants';\n\n/**\n * Roap options\n * @typedef {Object} RoapOptions\n * @property {String} sdp\n * @property {Meeting} meeting\n * @property {Number} seq\n * @property {Number} tieBreaker\n *  @property {Boolean} reconnect\n */\n\n/**\n * @typedef {Object} SeqOptions\n * @property {String} correlationId\n * @property {String} mediaId\n * @property {Number} seq\n */\n\n/**\n * @class Roap\n * @export\n * @private\n */\nexport default class Roap extends StatelessWebexPlugin {\n  attrs: any;\n  lastRoapOffer: any;\n  options: any;\n  roapHandler: any;\n  roapRequest: any;\n  turnDiscovery: any;\n\n  /**\n   *\n   * @param {Object} attrs\n   * @param {Object} options\n   */\n  constructor(attrs: any, options: any) {\n    super({}, options);\n    /**\n     * @instance\n     * @type {Object}\n     * @private\n     * @memberof Roap\n     */\n    this.attrs = attrs;\n    /**\n     * @instance\n     * @type {Object}\n     * @private\n     * @memberof Roap\n     */\n    this.options = options;\n    /**\n     * The Roap Request Server Proxy Object\n     * @instance\n     * @type {RoapRequest}\n     * @private\n     * @memberof Roap\n     */\n    // @ts-ignore\n    this.roapRequest = new RoapRequest({}, options);\n\n    this.turnDiscovery = new TurnDiscovery(this.roapRequest);\n  }\n\n  /**\n   *\n   * @param {SeqOptions} options\n   * @returns {null}\n   * @memberof Roap\n   */\n  public sendRoapOK(options: any) {\n    return Promise.resolve().then(() => {\n      // @ts-ignore\n      const meeting = this.webex.meetings.meetingCollection.getByKey(\n        'correlationId',\n        options.correlationId\n      );\n      const roapMessage = {\n        messageType: ROAP.ROAP_TYPES.OK,\n        version: ROAP.ROAP_VERSION,\n        seq: options.seq,\n      };\n\n      LoggerProxy.logger.log(`Roap:index#sendRoapOK --> ROAP OK sending with seq ${options.seq}`);\n\n      return this.roapRequest\n        .sendRoap({\n          roapMessage,\n          locusSelfUrl: meeting.selfUrl,\n          mediaId: options.mediaId,\n          meetingId: meeting.id,\n          locusMediaRequest: meeting.locusMediaRequest,\n        })\n        .then(() => {\n          LoggerProxy.logger.log(`Roap:index#sendRoapOK --> ROAP OK sent with seq ${options.seq}`);\n        });\n    });\n  }\n\n  /**\n   * Sends a ROAP answer...\n   * @param {SeqOptions} options\n   * @param {Boolean} options.audioMuted\n   * @param {Boolean} options.videoMuted\n   * @returns {Promise}\n   * @memberof Roap\n   */\n  public sendRoapAnswer(options: any) {\n    // @ts-ignore\n    const meeting = this.webex.meetings.meetingCollection.getByKey(\n      'correlationId',\n      options.correlationId\n    );\n    const roapMessage = {\n      messageType: ROAP.ROAP_TYPES.ANSWER,\n      sdps: [options.sdp],\n      version: ROAP.ROAP_VERSION,\n      seq: options.seq,\n    };\n\n    return this.roapRequest.sendRoap({\n      roapMessage,\n      locusSelfUrl: meeting.selfUrl,\n      mediaId: options.mediaId,\n      meetingId: meeting.id,\n      locusMediaRequest: meeting.locusMediaRequest,\n    });\n  }\n\n  /**\n   * Sends a ROAP error...\n   * @param {Object} options\n   * @returns {Promise}\n   * @memberof Roap\n   */\n  sendRoapError(options) {\n    // @ts-ignore\n    const meeting = this.webex.meetings.meetingCollection.getByKey(\n      'correlationId',\n      options.correlationId\n    );\n    const roapMessage = {\n      messageType: ROAP.ROAP_TYPES.ERROR,\n      version: ROAP.ROAP_VERSION,\n      errorType: options.errorType,\n      seq: options.seq,\n    };\n\n    return this.roapRequest\n      .sendRoap({\n        roapMessage,\n        locusSelfUrl: meeting.selfUrl,\n        mediaId: options.mediaId,\n        meetingId: meeting.id,\n        locusMediaRequest: meeting.locusMediaRequest,\n      })\n      .then(() => {\n        LoggerProxy.logger.log(\n          `Roap:index#sendRoapError --> ROAP ERROR sent with seq ${options.seq}`\n        );\n      });\n  }\n\n  /**\n   * sends a roap media request\n   * @param {RoapOptions} options\n   * @returns {Promise}\n   * @memberof Roap\n   */\n  sendRoapMediaRequest(options: any) {\n    const {meeting, seq, sdp, tieBreaker} = options;\n    const roapMessage = {\n      messageType: ROAP.ROAP_TYPES.OFFER,\n      sdps: [sdp],\n      version: ROAP.ROAP_VERSION,\n      seq,\n      tieBreaker,\n      headers: ['includeAnswerInHttpResponse', 'noOkInTransaction'],\n    };\n\n    // The only time we want to send an empty media id is when we are reconnecting, because this way we tell Locus\n    // that it needs to create a new confluence, but when reconnecting we always send TURN_DISCOVERY_REQUEST first,\n    // so we don't need to ever send an empty media id here\n    const sendEmptyMediaId = false;\n\n    return this.roapRequest\n      .sendRoap({\n        roapMessage,\n        locusSelfUrl: meeting.selfUrl,\n        mediaId: sendEmptyMediaId ? '' : meeting.mediaId,\n        meetingId: meeting.id,\n        preferTranscoding: !meeting.isMultistream,\n        locusMediaRequest: meeting.locusMediaRequest,\n        ipVersion: MeetingUtil.getIpVersion(meeting.webex),\n      })\n      .then(({locus, mediaConnections}) => {\n        if (mediaConnections) {\n          meeting.updateMediaConnections(mediaConnections);\n        }\n\n        let roapAnswer;\n\n        if (mediaConnections?.[0]?.remoteSdp) {\n          const remoteSdp = JSON.parse(mediaConnections[0].remoteSdp);\n\n          if (remoteSdp.roapMessage) {\n            const {\n              seq: answerSeq,\n              messageType,\n              sdps,\n              errorType,\n              errorCause,\n              headers,\n            } = remoteSdp.roapMessage;\n\n            roapAnswer = {\n              seq: answerSeq,\n              messageType,\n              sdp: sdps[0],\n              errorType,\n              errorCause,\n              headers,\n            };\n          }\n        }\n\n        if (!roapAnswer) {\n          Metrics.sendBehavioralMetric(BEHAVIORAL_METRICS.ROAP_HTTP_RESPONSE_MISSING, {\n            correlationId: meeting.correlationId,\n            messageType: 'ANSWER',\n            isMultistream: meeting.isMultistream,\n          });\n        }\n\n        return {locus, roapAnswer};\n      });\n  }\n\n  /**\n   * Performs a TURN server discovery procedure, which involves exchanging\n   * some roap messages with the server. This exchange has to be done before\n   * any other roap messages are sent\n   *\n   * @param {Meeting} meeting\n   * @param {Boolean} isReconnecting should be set to true if this is a new\n   *                                 media connection just after a reconnection\n   * @param {Boolean} [isForced]\n   * @returns {Promise}\n   */\n  doTurnDiscovery(meeting: Meeting, isReconnecting: boolean, isForced?: boolean) {\n    return this.turnDiscovery.doTurnDiscovery(meeting, isReconnecting, isForced);\n  }\n}\n"],"mappings":"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"}
+{"version":3,"names":["Roap","attrs","options","roapRequest","RoapRequest","turnDiscovery","TurnDiscovery","resolve","then","meeting","webex","meetings","meetingCollection","getByKey","correlationId","roapMessage","messageType","ROAP","ROAP_TYPES","OK","version","ROAP_VERSION","seq","LoggerProxy","logger","log","sendRoap","locusSelfUrl","selfUrl","mediaId","meetingId","id","locusMediaRequest","ANSWER","sdps","sdp","ERROR","errorType","tieBreaker","OFFER","headers","sendEmptyMediaId","preferTranscoding","isMultistream","ipVersion","MeetingUtil","getIpVersion","locus","mediaConnections","updateMediaConnections","roapAnswer","remoteSdp","JSON","parse","answerSeq","errorCause","Metrics","sendBehavioralMetric","BEHAVIORAL_METRICS","ROAP_HTTP_RESPONSE_MISSING","isReconnecting","isForced","doTurnDiscovery","generateTurnDiscoveryRequestMessage","httpResponse","handleTurnDiscoveryHttpResponse","abort","StatelessWebexPlugin"],"sources":["index.ts"],"sourcesContent":["// @ts-ignore\nimport {StatelessWebexPlugin} from '@webex/webex-core';\n\nimport {ROAP} from '../constants';\nimport LoggerProxy from '../common/logs/logger-proxy';\n\nimport RoapRequest from './request';\nimport TurnDiscovery, {TurnDiscoveryResult} from './turnDiscovery';\nimport Meeting from '../meeting';\nimport MeetingUtil from '../meeting/util';\nimport Metrics from '../metrics';\nimport BEHAVIORAL_METRICS from '../metrics/constants';\n\nexport {\n  type TurnDiscoveryResult,\n  type TurnServerInfo,\n  type TurnDiscoverySkipReason,\n} from './turnDiscovery';\n\n/**\n * Roap options\n * @typedef {Object} RoapOptions\n * @property {String} sdp\n * @property {Meeting} meeting\n * @property {Number} seq\n * @property {Number} tieBreaker\n *  @property {Boolean} reconnect\n */\n\n/**\n * @typedef {Object} SeqOptions\n * @property {String} correlationId\n * @property {String} mediaId\n * @property {Number} seq\n */\n\n/**\n * @class Roap\n * @export\n * @private\n */\nexport default class Roap extends StatelessWebexPlugin {\n  attrs: any;\n  lastRoapOffer: any;\n  options: any;\n  roapHandler: any;\n  roapRequest: any;\n  turnDiscovery: TurnDiscovery;\n\n  /**\n   *\n   * @param {Object} attrs\n   * @param {Object} options\n   */\n  constructor(attrs: any, options: any) {\n    super({}, options);\n    /**\n     * @instance\n     * @type {Object}\n     * @private\n     * @memberof Roap\n     */\n    this.attrs = attrs;\n    /**\n     * @instance\n     * @type {Object}\n     * @private\n     * @memberof Roap\n     */\n    this.options = options;\n    /**\n     * The Roap Request Server Proxy Object\n     * @instance\n     * @type {RoapRequest}\n     * @private\n     * @memberof Roap\n     */\n    // @ts-ignore\n    this.roapRequest = new RoapRequest({}, options);\n\n    this.turnDiscovery = new TurnDiscovery(this.roapRequest);\n  }\n\n  /**\n   *\n   * @param {SeqOptions} options\n   * @returns {null}\n   * @memberof Roap\n   */\n  public sendRoapOK(options: any) {\n    return Promise.resolve().then(() => {\n      // @ts-ignore\n      const meeting = this.webex.meetings.meetingCollection.getByKey(\n        'correlationId',\n        options.correlationId\n      );\n      const roapMessage = {\n        messageType: ROAP.ROAP_TYPES.OK,\n        version: ROAP.ROAP_VERSION,\n        seq: options.seq,\n      };\n\n      LoggerProxy.logger.log(`Roap:index#sendRoapOK --> ROAP OK sending with seq ${options.seq}`);\n\n      return this.roapRequest\n        .sendRoap({\n          roapMessage,\n          locusSelfUrl: meeting.selfUrl,\n          mediaId: options.mediaId,\n          meetingId: meeting.id,\n          locusMediaRequest: meeting.locusMediaRequest,\n        })\n        .then(() => {\n          LoggerProxy.logger.log(`Roap:index#sendRoapOK --> ROAP OK sent with seq ${options.seq}`);\n        });\n    });\n  }\n\n  /**\n   * Sends a ROAP answer...\n   * @param {SeqOptions} options\n   * @param {Boolean} options.audioMuted\n   * @param {Boolean} options.videoMuted\n   * @returns {Promise}\n   * @memberof Roap\n   */\n  public sendRoapAnswer(options: any) {\n    // @ts-ignore\n    const meeting = this.webex.meetings.meetingCollection.getByKey(\n      'correlationId',\n      options.correlationId\n    );\n    const roapMessage = {\n      messageType: ROAP.ROAP_TYPES.ANSWER,\n      sdps: [options.sdp],\n      version: ROAP.ROAP_VERSION,\n      seq: options.seq,\n    };\n\n    return this.roapRequest.sendRoap({\n      roapMessage,\n      locusSelfUrl: meeting.selfUrl,\n      mediaId: options.mediaId,\n      meetingId: meeting.id,\n      locusMediaRequest: meeting.locusMediaRequest,\n    });\n  }\n\n  /**\n   * Sends a ROAP error...\n   * @param {Object} options\n   * @returns {Promise}\n   * @memberof Roap\n   */\n  sendRoapError(options) {\n    // @ts-ignore\n    const meeting = this.webex.meetings.meetingCollection.getByKey(\n      'correlationId',\n      options.correlationId\n    );\n    const roapMessage = {\n      messageType: ROAP.ROAP_TYPES.ERROR,\n      version: ROAP.ROAP_VERSION,\n      errorType: options.errorType,\n      seq: options.seq,\n    };\n\n    return this.roapRequest\n      .sendRoap({\n        roapMessage,\n        locusSelfUrl: meeting.selfUrl,\n        mediaId: options.mediaId,\n        meetingId: meeting.id,\n        locusMediaRequest: meeting.locusMediaRequest,\n      })\n      .then(() => {\n        LoggerProxy.logger.log(\n          `Roap:index#sendRoapError --> ROAP ERROR sent with seq ${options.seq}`\n        );\n      });\n  }\n\n  /**\n   * sends a roap media request\n   * @param {RoapOptions} options\n   * @returns {Promise}\n   * @memberof Roap\n   */\n  sendRoapMediaRequest(options: any) {\n    const {meeting, seq, sdp, tieBreaker} = options;\n    const roapMessage = {\n      messageType: ROAP.ROAP_TYPES.OFFER,\n      sdps: [sdp],\n      version: ROAP.ROAP_VERSION,\n      seq,\n      tieBreaker,\n      headers: ['includeAnswerInHttpResponse', 'noOkInTransaction'],\n    };\n\n    // The only time we want to send an empty media id is when we are reconnecting, because this way we tell Locus\n    // that it needs to create a new confluence, but when reconnecting we always send TURN_DISCOVERY_REQUEST first,\n    // so we don't need to ever send an empty media id here\n    const sendEmptyMediaId = false;\n\n    return this.roapRequest\n      .sendRoap({\n        roapMessage,\n        locusSelfUrl: meeting.selfUrl,\n        mediaId: sendEmptyMediaId ? '' : meeting.mediaId,\n        meetingId: meeting.id,\n        preferTranscoding: !meeting.isMultistream,\n        locusMediaRequest: meeting.locusMediaRequest,\n        ipVersion: MeetingUtil.getIpVersion(meeting.webex),\n      })\n      .then(({locus, mediaConnections}) => {\n        if (mediaConnections) {\n          meeting.updateMediaConnections(mediaConnections);\n        }\n\n        let roapAnswer;\n\n        if (mediaConnections?.[0]?.remoteSdp) {\n          const remoteSdp = JSON.parse(mediaConnections[0].remoteSdp);\n\n          if (remoteSdp.roapMessage) {\n            const {\n              seq: answerSeq,\n              messageType,\n              sdps,\n              errorType,\n              errorCause,\n              headers,\n            } = remoteSdp.roapMessage;\n\n            roapAnswer = {\n              seq: answerSeq,\n              messageType,\n              sdp: sdps[0],\n              errorType,\n              errorCause,\n              headers,\n            };\n          }\n        }\n\n        if (!roapAnswer) {\n          Metrics.sendBehavioralMetric(BEHAVIORAL_METRICS.ROAP_HTTP_RESPONSE_MISSING, {\n            correlationId: meeting.correlationId,\n            messageType: 'ANSWER',\n            isMultistream: meeting.isMultistream,\n          });\n        }\n\n        return {locus, roapAnswer};\n      });\n  }\n\n  /**\n   * Performs a TURN server discovery procedure, which involves exchanging\n   * some roap messages with the server. This exchange has to be done before\n   * any other roap messages are sent\n   *\n   * @param {Meeting} meeting\n   * @param {Boolean} isReconnecting should be set to true if this is a new\n   *                                 media connection just after a reconnection\n   * @param {Boolean} [isForced]\n   * @returns {Promise}\n   */\n  doTurnDiscovery(\n    meeting: Meeting,\n    isReconnecting: boolean,\n    isForced?: boolean\n  ): Promise<TurnDiscoveryResult> {\n    return this.turnDiscovery.doTurnDiscovery(meeting, isReconnecting, isForced);\n  }\n\n  generateTurnDiscoveryRequestMessage(meeting: Meeting, isForced: boolean) {\n    return this.turnDiscovery.generateTurnDiscoveryRequestMessage(meeting, isForced);\n  }\n\n  handleTurnDiscoveryHttpResponse(meeting: Meeting, httpResponse: object) {\n    return this.turnDiscovery.handleTurnDiscoveryHttpResponse(meeting, httpResponse);\n  }\n\n  abortTurnDiscovery() {\n    return this.turnDiscovery.abort();\n  }\n}\n"],"mappings":"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"}

package/dist/roap/turnDiscovery.js

@@ -28,7 +28,13 @@ var TURN_DISCOVERY_TIMEOUT = 10; // in seconds
 // so we can do it with seq=0 or not do it at all and then we create the RoapMediaConnection
 // and do the SDP offer with seq=1
 var TURN_DISCOVERY_SEQ = 0;
-
+var TurnDiscoverySkipReason = {
+  missingHttpResponse: 'missing http response',
+  // when we asked for the TURN discovery response to be in the http response, but it wasn't there
+  reachability: 'reachability',
+  // when udp reachability to public clusters is ok, so we don't need TURN (this doens't apply when joinWithMedia() is used)
+  alreadyInProgress: 'already in progress' // when we try to start TURN discovery while it's already in progress
+};
 /**
  * Handles the process of finding out TURN server information from Linus.
  * This is achieved by sending a TURN_DISCOVERY_REQUEST.
@@ -79,7 +85,8 @@ var TurnDiscovery = /*#__PURE__*/function () {
     }
 
     /**
-     * handles TURN_DISCOVERY_RESPONSE roap message
+     * Handles TURN_DISCOVERY_RESPONSE roap message. Use it if the roap message comes over the websocket,
+     * otherwise use handleTurnDiscoveryHttpResponse() if it comes in the http response.
      *
      * @param {Object} roapMessage
      * @param {string} from string to indicate how we got the response (used just for logging)
@@ -133,32 +140,233 @@ var TurnDiscovery = /*#__PURE__*/function () {
     }
 
     /**
-     * handles TURN_DISCOVERY_RESPONSE roap message that came in http response
+     * Generates TURN_DISCOVERY_REQUEST roap message. When this method returns a roapMessage, it means that a TURN discovery process has started.
+     * It needs be ended by calling handleTurnDiscoveryHttpResponse() once you get a response from the backend. If you don't get any response
+     * or want to abort, you need to call abort().
      *
-     * @param {Object} roapMessage
-     * @returns {Promise}
-     * @memberof Roap
+     * @param {Meeting} meeting
+     * @param {boolean} isForced
+     * @returns {Object}
      */
   }, {
-    key: "handleTurnDiscoveryResponseInHttpResponse",
+    key: "generateTurnDiscoveryRequestMessage",
     value: function () {
-      var _handleTurnDiscoveryResponseInHttpResponse = (0, _asyncToGenerator2.default)( /*#__PURE__*/_regenerator.default.mark(function _callee(roapMessage) {
+      var _generateTurnDiscoveryRequestMessage = (0, _asyncToGenerator2.default)( /*#__PURE__*/_regenerator.default.mark(function _callee(meeting, isForced) {
+        var turnDiscoverySkippedReason, roapMessage;
         return _regenerator.default.wrap(function _callee$(_context) {
           while (1) switch (_context.prev = _context.next) {
             case 0:
-              this.handleTurnDiscoveryResponse(roapMessage, 'in http response');
-              return _context.abrupt("return", this.defer.promise);
-            case 2:
+              if (!this.defer) {
+                _context.next = 3;
+                break;
+              }
+              _loggerProxy.default.logger.warn('Roap:turnDiscovery#generateTurnDiscoveryRequestMessage --> TURN discovery already in progress');
+              return _context.abrupt("return", {
+                roapMessage: undefined,
+                turnDiscoverySkippedReason: TurnDiscoverySkipReason.alreadyInProgress
+              });
+            case 3:
+              if (isForced) {
+                _context.next = 7;
+                break;
+              }
+              _context.next = 6;
+              return this.getSkipReason(meeting);
+            case 6:
+              turnDiscoverySkippedReason = _context.sent;
+            case 7:
+              if (!turnDiscoverySkippedReason) {
+                _context.next = 9;
+                break;
+              }
+              return _context.abrupt("return", {
+                roapMessage: undefined,
+                turnDiscoverySkippedReason: turnDiscoverySkippedReason
+              });
+            case 9:
+              this.defer = new _common.Defer();
+              roapMessage = {
+                messageType: _constants2.ROAP.ROAP_TYPES.TURN_DISCOVERY_REQUEST,
+                version: _constants2.ROAP.ROAP_VERSION,
+                seq: TURN_DISCOVERY_SEQ,
+                headers: ['includeAnswerInHttpResponse', 'noOkInTransaction']
+              };
+              _loggerProxy.default.logger.info('Roap:turnDiscovery#generateTurnDiscoveryRequestMessage --> generated TURN_DISCOVERY_REQUEST message');
+              return _context.abrupt("return", {
+                roapMessage: roapMessage,
+                turnDiscoverySkippedReason: undefined
+              });
+            case 13:
             case "end":
               return _context.stop();
           }
         }, _callee, this);
       }));
-      function handleTurnDiscoveryResponseInHttpResponse(_x) {
-        return _handleTurnDiscoveryResponseInHttpResponse.apply(this, arguments);
+      function generateTurnDiscoveryRequestMessage(_x, _x2) {
+        return _generateTurnDiscoveryRequestMessage.apply(this, arguments);
       }
-      return handleTurnDiscoveryResponseInHttpResponse;
+      return generateTurnDiscoveryRequestMessage;
     }()
+    /**
+     * Handles any errors that occur during TURN discovery without re-throwing them.
+     *
+     * @param {Meeting} meeting
+     * @param {Error} error
+     * @returns {TurnDiscoveryResult}
+     */
+  }, {
+    key: "handleTurnDiscoveryFailure",
+    value: function handleTurnDiscoveryFailure(meeting, error) {
+      // we catch any errors and resolve with no turn information so that the normal call join flow can continue without TURN
+      _loggerProxy.default.logger.info("Roap:turnDiscovery#doTurnDiscovery --> TURN discovery failed, continuing without TURN: ".concat(error));
+      _metrics.default.sendBehavioralMetric(_constants.default.TURN_DISCOVERY_FAILURE, {
+        correlation_id: meeting.correlationId,
+        locus_id: meeting.locusUrl.split('/').pop(),
+        reason: error.message,
+        stack: error.stack
+      });
+      return {
+        turnServerInfo: undefined,
+        turnDiscoverySkippedReason: "failure: ".concat(error.message)
+      };
+    }
+
+    /**
+     * Handles TURN_DISCOVERY_RESPONSE roap message that came in http response. If the response is not valid,
+     * it returns an object with turnServerInfo set to undefined. In that case you need to call abort()
+     * to end the TURN discovery process.
+     *
+     * @param {Meeting} meeting
+     * @param {Object|undefined} httpResponse can be undefined to indicate that we didn't get the response
+     * @returns {Promise<TurnDiscoveryResult>}
+     * @memberof Roap
+     */
+  }, {
+    key: "handleTurnDiscoveryHttpResponse",
+    value: function () {
+      var _handleTurnDiscoveryHttpResponse = (0, _asyncToGenerator2.default)( /*#__PURE__*/_regenerator.default.mark(function _callee2(meeting, httpResponse) {
+        var roapMessage, _yield$this$defer$pro, isOkRequired;
+        return _regenerator.default.wrap(function _callee2$(_context2) {
+          while (1) switch (_context2.prev = _context2.next) {
+            case 0:
+              if (this.defer) {
+                _context2.next = 3;
+                break;
+              }
+              _loggerProxy.default.logger.warn('Roap:turnDiscovery#handleTurnDiscoveryHttpResponse --> unexpected http response, TURN discovery is not in progress');
+              throw new Error('handleTurnDiscoveryHttpResponse() called before generateTurnDiscoveryRequestMessage()');
+            case 3:
+              if (!(httpResponse === undefined)) {
+                _context2.next = 5;
+                break;
+              }
+              return _context2.abrupt("return", {
+                turnServerInfo: undefined,
+                turnDiscoverySkippedReason: TurnDiscoverySkipReason.missingHttpResponse
+              });
+            case 5:
+              _context2.prev = 5;
+              roapMessage = this.parseHttpTurnDiscoveryResponse(meeting, httpResponse);
+              if (roapMessage) {
+                _context2.next = 9;
+                break;
+              }
+              return _context2.abrupt("return", {
+                turnServerInfo: undefined,
+                turnDiscoverySkippedReason: TurnDiscoverySkipReason.missingHttpResponse
+              });
+            case 9:
+              this.handleTurnDiscoveryResponse(roapMessage, 'in http response');
+              _context2.next = 12;
+              return this.defer.promise;
+            case 12:
+              _yield$this$defer$pro = _context2.sent;
+              isOkRequired = _yield$this$defer$pro.isOkRequired;
+              if (!isOkRequired) {
+                _context2.next = 17;
+                break;
+              }
+              _context2.next = 17;
+              return this.sendRoapOK(meeting);
+            case 17:
+              this.defer = undefined;
+              _loggerProxy.default.logger.info('Roap:turnDiscovery#doTurnDiscovery --> TURN discovery completed');
+              return _context2.abrupt("return", {
+                turnServerInfo: this.turnInfo,
+                turnDiscoverySkippedReason: undefined
+              });
+            case 22:
+              _context2.prev = 22;
+              _context2.t0 = _context2["catch"](5);
+              this.abort();
+              return _context2.abrupt("return", this.handleTurnDiscoveryFailure(meeting, _context2.t0));
+            case 26:
+            case "end":
+              return _context2.stop();
+          }
+        }, _callee2, this, [[5, 22]]);
+      }));
+      function handleTurnDiscoveryHttpResponse(_x3, _x4) {
+        return _handleTurnDiscoveryHttpResponse.apply(this, arguments);
+      }
+      return handleTurnDiscoveryHttpResponse;
+    }()
+    /**
+     * Aborts current TURN discovery. This method needs to be called if you called generateTurnDiscoveryRequestMessage(),
+     * but then never got any response from the server.
+     * @returns {void}
+     */
+  }, {
+    key: "abort",
+    value: function abort() {
+      if (this.defer) {
+        this.defer.reject(new Error('TURN discovery aborted'));
+        this.defer = undefined;
+      }
+    }
+
+    /**
+     * Parses the TURN_DISCOVERY_RESPONSE roap message out of the http response
+     * and returns it.
+     *
+     * @param {Meeting} meeting
+     * @param {any} httpResponse
+     * @returns {any}
+     */
+  }, {
+    key: "parseHttpTurnDiscoveryResponse",
+    value: function parseHttpTurnDiscoveryResponse(meeting, httpResponse) {
+      var _httpResponse$mediaCo, _httpResponse$mediaCo2;
+      var turnDiscoveryResponse;
+      if ((_httpResponse$mediaCo = httpResponse.mediaConnections) !== null && _httpResponse$mediaCo !== void 0 && (_httpResponse$mediaCo2 = _httpResponse$mediaCo[0]) !== null && _httpResponse$mediaCo2 !== void 0 && _httpResponse$mediaCo2.remoteSdp) {
+        var remoteSdp = JSON.parse(httpResponse.mediaConnections[0].remoteSdp);
+        if (remoteSdp.roapMessage) {
+          // yes, it's misleading that remoteSdp actually contains a TURN discovery response, but that's how the backend works...
+          var _remoteSdp$roapMessag = remoteSdp.roapMessage,
+            seq = _remoteSdp$roapMessag.seq,
+            messageType = _remoteSdp$roapMessag.messageType,
+            errorType = _remoteSdp$roapMessag.errorType,
+            errorCause = _remoteSdp$roapMessag.errorCause,
+            headers = _remoteSdp$roapMessag.headers;
+          turnDiscoveryResponse = {
+            seq: seq,
+            messageType: messageType,
+            errorType: errorType,
+            errorCause: errorCause,
+            headers: headers
+          };
+        }
+      }
+      if (!turnDiscoveryResponse) {
+        _metrics.default.sendBehavioralMetric(_constants.default.ROAP_HTTP_RESPONSE_MISSING, {
+          correlationId: meeting.correlationId,
+          messageType: 'TURN_DISCOVERY_RESPONSE',
+          isMultistream: meeting.isMultistream
+        });
+      }
+      return turnDiscoveryResponse;
+    }
+
     /**
      * sends the TURN_DISCOVERY_REQUEST roap request
      *
@@ -171,9 +379,13 @@ var TurnDiscovery = /*#__PURE__*/function () {
   }, {
     key: "sendRoapTurnDiscoveryRequest",
     value: function sendRoapTurnDiscoveryRequest(meeting, isReconnecting) {
+      var _this2 = this;
       if (this.defer) {
         _loggerProxy.default.logger.warn('Roap:turnDiscovery#sendRoapTurnDiscoveryRequest --> already in progress');
-        return _promise.default.resolve();
+        return _promise.default.resolve({
+          turnServerInfo: undefined,
+          turnDiscoverySkippedReason: TurnDiscoverySkipReason.alreadyInProgress
+        });
       }
       this.defer = new _common.Defer();
       var roapMessage = {
@@ -193,41 +405,27 @@ var TurnDiscovery = /*#__PURE__*/function () {
         locusMediaRequest: meeting.locusMediaRequest,
         // @ts-ignore - because of meeting.webex
         ipVersion: _util.default.getIpVersion(meeting.webex)
-      }).then(function (response) {
-        var mediaConnections = response.mediaConnections;
-        var turnDiscoveryResponse;
-        if (mediaConnections) {
-          var _mediaConnections$;
-          meeting.updateMediaConnections(mediaConnections);
-          if ((_mediaConnections$ = mediaConnections[0]) !== null && _mediaConnections$ !== void 0 && _mediaConnections$.remoteSdp) {
-            var remoteSdp = JSON.parse(mediaConnections[0].remoteSdp);
-            if (remoteSdp.roapMessage) {
-              // yes, it's misleading that remoteSdp actually contains a TURN discovery response, but that's how the backend works...
-              var _remoteSdp$roapMessag = remoteSdp.roapMessage,
-                seq = _remoteSdp$roapMessag.seq,
-                messageType = _remoteSdp$roapMessag.messageType,
-                errorType = _remoteSdp$roapMessag.errorType,
-                errorCause = _remoteSdp$roapMessag.errorCause,
-                headers = _remoteSdp$roapMessag.headers;
-              turnDiscoveryResponse = {
-                seq: seq,
-                messageType: messageType,
-                errorType: errorType,
-                errorCause: errorCause,
-                headers: headers
-              };
+      }).then( /*#__PURE__*/function () {
+        var _ref = (0, _asyncToGenerator2.default)( /*#__PURE__*/_regenerator.default.mark(function _callee3(response) {
+          var mediaConnections;
+          return _regenerator.default.wrap(function _callee3$(_context3) {
+            while (1) switch (_context3.prev = _context3.next) {
+              case 0:
+                mediaConnections = response.mediaConnections;
+                if (mediaConnections) {
+                  meeting.updateMediaConnections(mediaConnections);
+                }
+                return _context3.abrupt("return", _this2.handleTurnDiscoveryHttpResponse(meeting, response));
+              case 3:
+              case "end":
+                return _context3.stop();
             }
-          }
-        }
-        if (!turnDiscoveryResponse) {
-          _metrics.default.sendBehavioralMetric(_constants.default.ROAP_HTTP_RESPONSE_MISSING, {
-            correlationId: meeting.correlationId,
-            messageType: 'TURN_DISCOVERY_RESPONSE',
-            isMultistream: meeting.isMultistream
-          });
-        }
-        return turnDiscoveryResponse;
-      });
+          }, _callee3);
+        }));
+        return function (_x5) {
+          return _ref.apply(this, arguments);
+        };
+      }());
     }
 
     /**
@@ -240,7 +438,11 @@ var TurnDiscovery = /*#__PURE__*/function () {
   }, {
     key: "sendRoapOK",
     value: function sendRoapOK(meeting) {
-      _loggerProxy.default.logger.info('Roap:turnDiscovery#sendRoapOK --> sending OK');
+      _loggerProxy.default.logger.info('Roap:turnDiscovery#sendRoapOK --> TURN discovery response requires OK, sending it...');
+      _metrics.default.sendBehavioralMetric(_constants.default.TURN_DISCOVERY_REQUIRES_OK, {
+        correlation_id: meeting.correlationId,
+        locus_id: meeting.locusUrl.split('/').pop()
+      });
       return this.roapRequest.sendRoap({
         roapMessage: {
           messageType: _constants2.ROAP.ROAP_TYPES.OK,
@@ -265,30 +467,30 @@ var TurnDiscovery = /*#__PURE__*/function () {
   }, {
     key: "getSkipReason",
     value: function () {
-      var _getSkipReason = (0, _asyncToGenerator2.default)( /*#__PURE__*/_regenerator.default.mark(function _callee2(meeting) {
+      var _getSkipReason = (0, _asyncToGenerator2.default)( /*#__PURE__*/_regenerator.default.mark(function _callee4(meeting) {
         var isAnyPublicClusterReachable;
-        return _regenerator.default.wrap(function _callee2$(_context2) {
-          while (1) switch (_context2.prev = _context2.next) {
+        return _regenerator.default.wrap(function _callee4$(_context4) {
+          while (1) switch (_context4.prev = _context4.next) {
             case 0:
-              _context2.next = 2;
+              _context4.next = 2;
               return meeting.webex.meetings.reachability.isAnyPublicClusterReachable();
             case 2:
-              isAnyPublicClusterReachable = _context2.sent;
+              isAnyPublicClusterReachable = _context4.sent;
               if (!isAnyPublicClusterReachable) {
-                _context2.next = 6;
+                _context4.next = 6;
                 break;
               }
               _loggerProxy.default.logger.info('Roap:turnDiscovery#getSkipReason --> reachability has not failed, skipping TURN discovery');
-              return _context2.abrupt("return", 'reachability');
+              return _context4.abrupt("return", TurnDiscoverySkipReason.reachability);
             case 6:
-              return _context2.abrupt("return", '');
+              return _context4.abrupt("return", undefined);
             case 7:
             case "end":
-              return _context2.stop();
+              return _context4.stop();
           }
-        }, _callee2);
+        }, _callee4);
       }));
-      function getSkipReason(_x2) {
+      function getSkipReason(_x6) {
         return _getSkipReason.apply(this, arguments);
       }
       return getSkipReason;
@@ -302,23 +504,23 @@ var TurnDiscovery = /*#__PURE__*/function () {
   }, {
     key: "isSkipped",
     value: function () {
-      var _isSkipped = (0, _asyncToGenerator2.default)( /*#__PURE__*/_regenerator.default.mark(function _callee3(meeting) {
+      var _isSkipped = (0, _asyncToGenerator2.default)( /*#__PURE__*/_regenerator.default.mark(function _callee5(meeting) {
         var skipReason;
-        return _regenerator.default.wrap(function _callee3$(_context3) {
-          while (1) switch (_context3.prev = _context3.next) {
+        return _regenerator.default.wrap(function _callee5$(_context5) {
+          while (1) switch (_context5.prev = _context5.next) {
             case 0:
-              _context3.next = 2;
+              _context5.next = 2;
               return this.getSkipReason(meeting);
             case 2:
-              skipReason = _context3.sent;
-              return _context3.abrupt("return", !!skipReason);
+              skipReason = _context5.sent;
+              return _context5.abrupt("return", !!skipReason);
             case 4:
             case "end":
-              return _context3.stop();
+              return _context5.stop();
           }
-        }, _callee3, this);
+        }, _callee5, this);
       }));
-      function isSkipped(_x3) {
+      function isSkipped(_x7) {
         return _isSkipped.apply(this, arguments);
       }
       return isSkipped;
@@ -344,93 +546,69 @@ var TurnDiscovery = /*#__PURE__*/function () {
   }, {
     key: "doTurnDiscovery",
     value: function () {
-      var _doTurnDiscovery = (0, _asyncToGenerator2.default)( /*#__PURE__*/_regenerator.default.mark(function _callee4(meeting, isReconnecting, isForced) {
-        var turnDiscoverySkippedReason, httpResponse, _ref, isOkRequired;
-        return _regenerator.default.wrap(function _callee4$(_context4) {
-          while (1) switch (_context4.prev = _context4.next) {
+      var _doTurnDiscovery = (0, _asyncToGenerator2.default)( /*#__PURE__*/_regenerator.default.mark(function _callee6(meeting, isReconnecting, isForced) {
+        var turnDiscoverySkippedReason, turnDiscoveryResult, _yield$this$waitForTu, isOkRequired;
+        return _regenerator.default.wrap(function _callee6$(_context6) {
+          while (1) switch (_context6.prev = _context6.next) {
             case 0:
               if (isForced) {
-                _context4.next = 4;
+                _context6.next = 4;
                 break;
               }
-              _context4.next = 3;
+              _context6.next = 3;
               return this.getSkipReason(meeting);
             case 3:
-              turnDiscoverySkippedReason = _context4.sent;
+              turnDiscoverySkippedReason = _context6.sent;
             case 4:
               if (!turnDiscoverySkippedReason) {
-                _context4.next = 6;
+                _context6.next = 6;
                 break;
               }
-              return _context4.abrupt("return", {
+              return _context6.abrupt("return", {
                 turnServerInfo: undefined,
                 turnDiscoverySkippedReason: turnDiscoverySkippedReason
               });
             case 6:
-              _context4.prev = 6;
-              _context4.next = 9;
+              _context6.prev = 6;
+              _context6.next = 9;
               return this.sendRoapTurnDiscoveryRequest(meeting, isReconnecting);
             case 9:
-              httpResponse = _context4.sent;
-              if (!httpResponse) {
-                _context4.next = 16;
+              turnDiscoveryResult = _context6.sent;
+              if (!(turnDiscoveryResult.turnDiscoverySkippedReason !== TurnDiscoverySkipReason.missingHttpResponse)) {
+                _context6.next = 12;
                 break;
               }
-              _context4.next = 13;
-              return this.handleTurnDiscoveryResponseInHttpResponse(httpResponse);
-            case 13:
-              _context4.t0 = _context4.sent;
-              _context4.next = 19;
-              break;
-            case 16:
-              _context4.next = 18;
+              return _context6.abrupt("return", turnDiscoveryResult);
+            case 12:
+              _context6.next = 14;
               return this.waitForTurnDiscoveryResponse();
-            case 18:
-              _context4.t0 = _context4.sent;
-            case 19:
-              _ref = _context4.t0;
-              isOkRequired = _ref.isOkRequired;
+            case 14:
+              _yield$this$waitForTu = _context6.sent;
+              isOkRequired = _yield$this$waitForTu.isOkRequired;
               if (!isOkRequired) {
-                _context4.next = 26;
+                _context6.next = 19;
                 break;
               }
-              _context4.next = 24;
+              _context6.next = 19;
               return this.sendRoapOK(meeting);
-            case 24:
-              _loggerProxy.default.logger.info('Roap:turnDiscovery#doTurnDiscovery --> TURN discovery response requires OK');
-              _metrics.default.sendBehavioralMetric(_constants.default.TURN_DISCOVERY_REQUIRES_OK, {
-                correlation_id: meeting.correlationId,
-                locus_id: meeting.locusUrl.split('/').pop()
-              });
-            case 26:
+            case 19:
               this.defer = undefined;
               _loggerProxy.default.logger.info('Roap:turnDiscovery#doTurnDiscovery --> TURN discovery completed');
-              return _context4.abrupt("return", {
+              return _context6.abrupt("return", {
                 turnServerInfo: this.turnInfo,
                 turnDiscoverySkippedReason: undefined
               });
-            case 31:
-              _context4.prev = 31;
-              _context4.t1 = _context4["catch"](6);
-              // we catch any errors and resolve with no turn information so that the normal call join flow can continue without TURN
-              _loggerProxy.default.logger.info("Roap:turnDiscovery#doTurnDiscovery --> TURN discovery failed, continuing without TURN: ".concat(_context4.t1));
-              _metrics.default.sendBehavioralMetric(_constants.default.TURN_DISCOVERY_FAILURE, {
-                correlation_id: meeting.correlationId,
-                locus_id: meeting.locusUrl.split('/').pop(),
-                reason: _context4.t1.message,
-                stack: _context4.t1.stack
-              });
-              return _context4.abrupt("return", {
-                turnServerInfo: undefined,
-                turnDiscoverySkippedReason: undefined
-              });
-            case 36:
+            case 24:
+              _context6.prev = 24;
+              _context6.t0 = _context6["catch"](6);
+              return _context6.abrupt("return", this.handleTurnDiscoveryFailure(meeting, _context6.t0));
+            case 27:
             case "end":
-              return _context4.stop();
+              return _context6.stop();
           }
-        }, _callee4, this, [[6, 31]]);
+        }, _callee6, this, [[6, 24]]);
       }));
-      function doTurnDiscovery(_x4, _x5, _x6) {
+      function doTurnDiscovery(_x8, _x9, _x10) {
         return _doTurnDiscovery.apply(this, arguments);
       }
       return doTurnDiscovery;