@webex/plugin-meetings 2.60.0 → 2.60.1-next.10

package/dist/meetings/index.js

@@ -1,32 +1,43 @@
 "use strict";
 
+var _typeof = require("@babel/runtime-corejs2/helpers/typeof");
 var _Reflect$construct = require("@babel/runtime-corejs2/core-js/reflect/construct");
+var _Object$keys2 = require("@babel/runtime-corejs2/core-js/object/keys");
+var _Object$getOwnPropertySymbols = require("@babel/runtime-corejs2/core-js/object/get-own-property-symbols");
+var _Object$getOwnPropertyDescriptor = require("@babel/runtime-corejs2/core-js/object/get-own-property-descriptor");
+var _Object$getOwnPropertyDescriptors = require("@babel/runtime-corejs2/core-js/object/get-own-property-descriptors");
+var _Object$defineProperties = require("@babel/runtime-corejs2/core-js/object/define-properties");
 var _Object$defineProperty = require("@babel/runtime-corejs2/core-js/object/define-property");
+var _WeakMap = require("@babel/runtime-corejs2/core-js/weak-map");
 var _interopRequireDefault = require("@babel/runtime-corejs2/helpers/interopRequireDefault");
 _Object$defineProperty(exports, "__esModule", {
   value: true
 });
 exports.default = void 0;
-var _regenerator = _interopRequireDefault(require("@babel/runtime-corejs2/regenerator"));
 var _promise = _interopRequireDefault(require("@babel/runtime-corejs2/core-js/promise"));
 var _now = _interopRequireDefault(require("@babel/runtime-corejs2/core-js/date/now"));
 var _keys = _interopRequireDefault(require("@babel/runtime-corejs2/core-js/object/keys"));
 var _values = _interopRequireDefault(require("@babel/runtime-corejs2/core-js/object/values"));
+var _regenerator = _interopRequireDefault(require("@babel/runtime-corejs2/regenerator"));
+var _toConsumableArray2 = _interopRequireDefault(require("@babel/runtime-corejs2/helpers/toConsumableArray"));
 var _asyncToGenerator2 = _interopRequireDefault(require("@babel/runtime-corejs2/helpers/asyncToGenerator"));
-var _classCallCheck2 = _interopRequireDefault(require("@babel/runtime-corejs2/helpers/classCallCheck"));
-var _createClass2 = _interopRequireDefault(require("@babel/runtime-corejs2/helpers/createClass"));
 var _assertThisInitialized2 = _interopRequireDefault(require("@babel/runtime-corejs2/helpers/assertThisInitialized"));
 var _inherits2 = _interopRequireDefault(require("@babel/runtime-corejs2/helpers/inherits"));
 var _possibleConstructorReturn2 = _interopRequireDefault(require("@babel/runtime-corejs2/helpers/possibleConstructorReturn"));
 var _getPrototypeOf2 = _interopRequireDefault(require("@babel/runtime-corejs2/helpers/getPrototypeOf"));
 var _defineProperty2 = _interopRequireDefault(require("@babel/runtime-corejs2/helpers/defineProperty"));
+var _classCallCheck2 = _interopRequireDefault(require("@babel/runtime-corejs2/helpers/classCallCheck"));
+var _createClass2 = _interopRequireDefault(require("@babel/runtime-corejs2/helpers/createClass"));
 require("@webex/internal-plugin-mercury");
+require("@webex/internal-plugin-conversation");
+require("@webex/internal-plugin-metrics");
 var _webexCore = require("@webex/webex-core");
+var _internalMediaCore = require("@webex/internal-media-core");
+var mediaHelpersModule = _interopRequireWildcard(require("@webex/media-helpers"));
 require("webrtc-adapter");
 var _metrics = _interopRequireDefault(require("../metrics"));
-var _config = require("../metrics/config");
 var _loggerConfig = _interopRequireDefault(require("../common/logs/logger-config"));
-var _config2 = _interopRequireDefault(require("../common/config"));
+var _config = _interopRequireDefault(require("../common/config"));
 var _loggerProxy = _interopRequireDefault(require("../common/logs/logger-proxy"));
 var _request = _interopRequireDefault(require("../common/logs/request"));
 var _triggerProxy = _interopRequireDefault(require("../common/events/trigger-proxy"));
@@ -44,8 +55,59 @@ var _passwordError = _interopRequireDefault(require("../common/errors/password-e
 var _captchaError = _interopRequireDefault(require("../common/errors/captcha-error"));
 var _collection = _interopRequireDefault(require("./collection"));
 var _util2 = _interopRequireDefault(require("./util"));
+var _permission = _interopRequireDefault(require("../common/errors/permission"));
+var _webexErrors = require("../common/errors/webex-errors");
+var _noMeetingInfo = _interopRequireDefault(require("../common/errors/no-meeting-info"));
+function _getRequireWildcardCache(e) { if ("function" != typeof _WeakMap) return null; var r = new _WeakMap(), t = new _WeakMap(); return (_getRequireWildcardCache = function _getRequireWildcardCache(e) { return e ? t : r; })(e); }
+function _interopRequireWildcard(e, r) { if (!r && e && e.__esModule) return e; if (null === e || "object" != _typeof(e) && "function" != typeof e) return { default: e }; var t = _getRequireWildcardCache(r); if (t && t.has(e)) return t.get(e); var n = { __proto__: null }, a = _Object$defineProperty && _Object$getOwnPropertyDescriptor; for (var u in e) if ("default" !== u && Object.prototype.hasOwnProperty.call(e, u)) { var i = a ? _Object$getOwnPropertyDescriptor(e, u) : null; i && (i.get || i.set) ? _Object$defineProperty(n, u, i) : n[u] = e[u]; } return n.default = e, t && t.set(e, n), n; }
+function ownKeys(e, r) { var t = _Object$keys2(e); if (_Object$getOwnPropertySymbols) { var o = _Object$getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return _Object$getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
+function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { (0, _defineProperty2.default)(e, r, t[r]); }) : _Object$getOwnPropertyDescriptors ? _Object$defineProperties(e, _Object$getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { _Object$defineProperty(e, r, _Object$getOwnPropertyDescriptor(t, r)); }); } return e; }
 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; } }
+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; } } /* eslint no-shadow: ["error", { "allow": ["eventType"] }] */ // @ts-ignore
+var mediaLogger;
+var MediaLogger = /*#__PURE__*/function () {
+  function MediaLogger() {
+    (0, _classCallCheck2.default)(this, MediaLogger);
+  }
+  (0, _createClass2.default)(MediaLogger, [{
+    key: "info",
+    value: function info() {
+      var _LoggerProxy$logger;
+      (_LoggerProxy$logger = _loggerProxy.default.logger).info.apply(_LoggerProxy$logger, arguments);
+    }
+  }, {
+    key: "log",
+    value: function log() {
+      var _LoggerProxy$logger2;
+      (_LoggerProxy$logger2 = _loggerProxy.default.logger).log.apply(_LoggerProxy$logger2, arguments);
+    }
+  }, {
+    key: "error",
+    value: function error() {
+      var _LoggerProxy$logger3;
+      (_LoggerProxy$logger3 = _loggerProxy.default.logger).error.apply(_LoggerProxy$logger3, arguments);
+    }
+  }, {
+    key: "warn",
+    value: function warn() {
+      var _LoggerProxy$logger4;
+      (_LoggerProxy$logger4 = _loggerProxy.default.logger).warn.apply(_LoggerProxy$logger4, arguments);
+    }
+  }, {
+    key: "trace",
+    value: function trace() {
+      var _LoggerProxy$logger5;
+      (_LoggerProxy$logger5 = _loggerProxy.default.logger).trace.apply(_LoggerProxy$logger5, arguments);
+    }
+  }, {
+    key: "debug",
+    value: function debug() {
+      var _LoggerProxy$logger6;
+      (_LoggerProxy$logger6 = _loggerProxy.default.logger).debug.apply(_LoggerProxy$logger6, arguments);
+    }
+  }]);
+  return MediaLogger;
+}();
 /**
  * Meetings Ready Event
  * Emitted when the meetings instance on webex is ready
@@ -93,7 +155,7 @@ function _isNativeReflectConstruct() { if (typeof Reflect === "undefined" || !_R
  * Maintain a cache of meetings and sync with services.
  * @class
  */
-var Meetings = /*#__PURE__*/function (_WebexPlugin) {
+var Meetings = exports.default = /*#__PURE__*/function (_WebexPlugin) {
   (0, _inherits2.default)(Meetings, _WebexPlugin);
   var _super = _createSuper(Meetings);
   /**
@@ -111,13 +173,14 @@ var Meetings = /*#__PURE__*/function (_WebexPlugin) {
     _this = _super.call.apply(_super, [this].concat(args));
 
     /**
-     * The Meetings request to interact with server
+     * The webrtc-core media helpers. This is a temporary solution required for the SDK sample app
+     * to be able to call media helper functions.
+     *
      * @instance
      * @type {Object}
      * @private
      * @memberof Meetings
      */
-    // @ts-ignore
     (0, _defineProperty2.default)((0, _assertThisInitialized2.default)(_this), "loggerRequest", void 0);
     (0, _defineProperty2.default)((0, _assertThisInitialized2.default)(_this), "media", void 0);
     (0, _defineProperty2.default)((0, _assertThisInitialized2.default)(_this), "meetingCollection", void 0);
@@ -128,7 +191,77 @@ var Meetings = /*#__PURE__*/function (_WebexPlugin) {
     (0, _defineProperty2.default)((0, _assertThisInitialized2.default)(_this), "request", void 0);
     (0, _defineProperty2.default)((0, _assertThisInitialized2.default)(_this), "geoHintInfo", void 0);
     (0, _defineProperty2.default)((0, _assertThisInitialized2.default)(_this), "meetingInfo", void 0);
+    (0, _defineProperty2.default)((0, _assertThisInitialized2.default)(_this), "mediaHelpers", void 0);
+    (0, _defineProperty2.default)((0, _assertThisInitialized2.default)(_this), "breakoutLocusForHandleLater", void 0);
     (0, _defineProperty2.default)((0, _assertThisInitialized2.default)(_this), "namespace", _constants.MEETINGS);
+    /**
+     * Creates a noise reduction effect
+     *
+     * @param {INoiseReductionEffect} options optional custom effect options
+     * @returns {Promise<effect>} noise reduction effect.
+     * @public
+     * @memberof Meetings
+     */
+    (0, _defineProperty2.default)((0, _assertThisInitialized2.default)(_this), "createNoiseReductionEffect", /*#__PURE__*/function () {
+      var _ref = (0, _asyncToGenerator2.default)( /*#__PURE__*/_regenerator.default.mark(function _callee(options) {
+        var authToken;
+        return _regenerator.default.wrap(function _callee$(_context) {
+          while (1) switch (_context.prev = _context.next) {
+            case 0:
+              // @ts-ignore
+              authToken = _this.webex.credentials.supertoken.access_token;
+              return _context.abrupt("return", new mediaHelpersModule.NoiseReductionEffect(_objectSpread({
+                authToken: authToken
+              }, options)));
+            case 2:
+            case "end":
+              return _context.stop();
+          }
+        }, _callee);
+      }));
+      return function (_x) {
+        return _ref.apply(this, arguments);
+      };
+    }());
+    /**
+     * Creates a virtual background effect
+     *
+     * @param {IVirtualBackgroundEffect} options optional custom effect options
+     * @returns {Promise<effect>} virtual background effect.
+     * @public
+     * @memberof Meetings
+     */
+    (0, _defineProperty2.default)((0, _assertThisInitialized2.default)(_this), "createVirtualBackgroundEffect", /*#__PURE__*/function () {
+      var _ref2 = (0, _asyncToGenerator2.default)( /*#__PURE__*/_regenerator.default.mark(function _callee2(options) {
+        var authToken;
+        return _regenerator.default.wrap(function _callee2$(_context2) {
+          while (1) switch (_context2.prev = _context2.next) {
+            case 0:
+              // @ts-ignore
+              authToken = _this.webex.credentials.supertoken.access_token;
+              return _context2.abrupt("return", new mediaHelpersModule.VirtualBackgroundEffect(_objectSpread({
+                authToken: authToken
+              }, options)));
+            case 2:
+            case "end":
+              return _context2.stop();
+          }
+        }, _callee2);
+      }));
+      return function (_x2) {
+        return _ref2.apply(this, arguments);
+      };
+    }());
+    _this.mediaHelpers = mediaHelpersModule;
+
+    /**
+     * The Meetings request to interact with server
+     * @instance
+     * @type {Object}
+     * @private
+     * @memberof Meetings
+     */
+    // @ts-ignore
     _this.request = new _request2.default({}, {
       parent: _this.webex
     });
@@ -152,15 +285,17 @@ var Meetings = /*#__PURE__*/function (_WebexPlugin) {
      * @memberof Meetings
      */
     _this.personalMeetingRoom = null;
+
     /**
-     * The Reachability object to interact with server, starts as null until {@link Meeting#setReachability} is called
+     * The Reachability object to interact with server
      * starts as null
      * @instance
      * @type {Object}
      * @private
      * @memberof Meetings
      */
-    _this.reachability = null;
+    // @ts-ignore
+    _this.reachability = new _reachability.default(_this.webex);
 
     /**
      * If the meetings plugin has been registered and listening via {@link Meetings#register}
@@ -189,50 +324,152 @@ var Meetings = /*#__PURE__*/function (_WebexPlugin) {
      * @memberof Meetings
      */
     _this.media = {
-      getUserMedia: _media.default.getUserMedia,
-      getSupportedDevice: _media.default.getSupportedDevice
+      getUserMedia: _media.default.getUserMedia
     };
     _this.onReady();
     return _this;
   }
 
   /**
-   * handle locus events and takes meeting actions with them as they come in
-   * @param {Object} data a locus event
-   * @param {String} data.locusUrl
-   * @param {Object} data.locus
-   * @param {Boolean} useRandomDelayForInfo whether a random delay should be added to fetching meeting info
-   * @param {String} data.eventType
-   * @returns {undefined}
+   * check whether you need to handle this main session's locus data or not
+   * @param {Object} meeting current meeting data
+   * @param {Object} newLocus new locus data
+   * @returns {boolean}
    * @private
    * @memberof Meetings
    */
   (0, _createClass2.default)(Meetings, [{
-    key: "handleLocusEvent",
-    value: function handleLocusEvent(data) {
-      var _data$locus$info,
-        _data$locus,
-        _data$locus$replaces,
-        _this2 = this;
-      var useRandomDelayForInfo = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : false;
-      var meeting = null;
+    key: "isNeedHandleMainLocus",
+    value: function isNeedHandleMainLocus(meeting, newLocus) {
+      var _newLocus$controls, _newLocus$controls$br, _newLocus$self, _newLocus$self2, _newLocus$self3, _breakoutLocus$joined, _newLocus$self4;
+      var breakoutUrl = (_newLocus$controls = newLocus.controls) === null || _newLocus$controls === void 0 ? void 0 : (_newLocus$controls$br = _newLocus$controls.breakout) === null || _newLocus$controls$br === void 0 ? void 0 : _newLocus$controls$br.url;
+      var breakoutLocus = this.meetingCollection.getActiveBreakoutLocus(breakoutUrl);
+      var isSelfJoined = (newLocus === null || newLocus === void 0 ? void 0 : (_newLocus$self = newLocus.self) === null || _newLocus$self === void 0 ? void 0 : _newLocus$self.state) === _constants._JOINED_;
+      var isSelfMoved = (newLocus === null || newLocus === void 0 ? void 0 : (_newLocus$self2 = newLocus.self) === null || _newLocus$self2 === void 0 ? void 0 : _newLocus$self2.state) === _constants._LEFT_ && (newLocus === null || newLocus === void 0 ? void 0 : (_newLocus$self3 = newLocus.self) === null || _newLocus$self3 === void 0 ? void 0 : _newLocus$self3.reason) === _constants._MOVED_;
+      // @ts-ignore
+      var deviceFromNewLocus = _util2.default.getThisDevice(newLocus, this.webex.internal.device.url);
+      var isResourceMovedOnThisDevice = (deviceFromNewLocus === null || deviceFromNewLocus === void 0 ? void 0 : deviceFromNewLocus.state) === _constants._LEFT_ && (deviceFromNewLocus === null || deviceFromNewLocus === void 0 ? void 0 : deviceFromNewLocus.reason) === _constants._MOVED_;
+      var isNewLocusJoinThisDevice = _util2.default.joinedOnThisDevice(meeting, newLocus,
+      // @ts-ignore
+      this.webex.internal.device.url);
+      var isBreakoutLocusJoinThisDevice = (breakoutLocus === null || breakoutLocus === void 0 ? void 0 : (_breakoutLocus$joined = breakoutLocus.joinedWith) === null || _breakoutLocus$joined === void 0 ? void 0 : _breakoutLocus$joined.correlationId) && breakoutLocus.joinedWith.correlationId === (meeting === null || meeting === void 0 ? void 0 : meeting.correlationId);
+      if (isSelfJoined && isNewLocusJoinThisDevice) {
+        _loggerProxy.default.logger.log('Meetings:index#isNeedHandleMainLocus --> self this device shown as JOINED in the main session');
+        if (breakoutLocus !== null && breakoutLocus !== void 0 && breakoutLocus.joinedWith && deviceFromNewLocus) {
+          var _breakoutLocus$joined2, _deviceFromNewLocus$r;
+          var breakoutReplaceAt = ((_breakoutLocus$joined2 = breakoutLocus.joinedWith.replaces) === null || _breakoutLocus$joined2 === void 0 ? void 0 : _breakoutLocus$joined2.length) > 0 ? breakoutLocus.joinedWith.replaces[0].replaceAt : '';
+          var newLocusReplaceAt = ((_deviceFromNewLocus$r = deviceFromNewLocus.replaces) === null || _deviceFromNewLocus$r === void 0 ? void 0 : _deviceFromNewLocus$r.length) > 0 ? deviceFromNewLocus.replaces[0].replaceAt : '';
+          if (breakoutReplaceAt && newLocusReplaceAt && breakoutReplaceAt > newLocusReplaceAt) {
+            _loggerProxy.default.logger.log("Meetings:index#isNeedHandleMainLocus --> this is expired main joined status locus_dto replacedAt ".concat(newLocusReplaceAt, " bo replacedAt ").concat(breakoutReplaceAt));
+            return false;
+          }
+        }
+        return true;
+      }
+      if (isBreakoutLocusJoinThisDevice) {
+        _loggerProxy.default.logger.log("Meetings:index#isNeedHandleMainLocus --> there is active breakout session and joined on this device, and don't need to handle main session: ".concat(breakoutUrl));
+        return false;
+      }
+      if (isSelfMoved && (newLocus !== null && newLocus !== void 0 && (_newLocus$self4 = newLocus.self) !== null && _newLocus$self4 !== void 0 && _newLocus$self4.removed || isResourceMovedOnThisDevice)) {
+        _loggerProxy.default.logger.log('Meetings:index#isNeedHandleMainLocus --> self moved main locus with self removed status or with device resource moved, not need to handle');
+        return false;
+      }
+      if (isSelfJoined && isResourceMovedOnThisDevice) {
+        _loggerProxy.default.logger.log('Meetings:index#isNeedHandleMainLocus --> self device left&moved in main locus with self joined status, not need to handle');
+        return false;
+      }
+      _loggerProxy.default.logger.log('Meetings:index#isNeedHandleMainLocus --> this is a normal main session locusDTO update case');
+      return true;
+    }
 
+    /**
+     * check whether you need to handle this locus data or not
+     * @param {Object} meeting old locus data
+     * @param {Object} newLocus new locus data
+     * @returns {boolean}
+     * @private
+     * @memberof Meetings
+     */
+  }, {
+    key: "isNeedHandleLocusDTO",
+    value: function isNeedHandleLocusDTO(meeting, newLocus) {
+      if (newLocus) {
+        var _newLocus$self5, _newLocus$self6;
+        var isNewLocusAsBreakout = _util2.default.isBreakoutLocusDTO(newLocus);
+        var isSelfMoved = (newLocus === null || newLocus === void 0 ? void 0 : (_newLocus$self5 = newLocus.self) === null || _newLocus$self5 === void 0 ? void 0 : _newLocus$self5.state) === _constants._LEFT_ && (newLocus === null || newLocus === void 0 ? void 0 : (_newLocus$self6 = newLocus.self) === null || _newLocus$self6 === void 0 ? void 0 : _newLocus$self6.reason) === _constants._MOVED_;
+        if (!meeting) {
+          if (isNewLocusAsBreakout) {
+            var _newLocus$fullState, _newLocus$self7;
+            _loggerProxy.default.logger.log("Meetings:index#isNeedHandleLocusDTO --> the first breakout session locusDTO active status: ".concat((_newLocus$fullState = newLocus.fullState) === null || _newLocus$fullState === void 0 ? void 0 : _newLocus$fullState.active));
+            return ((_newLocus$self7 = newLocus.self) === null || _newLocus$self7 === void 0 ? void 0 : _newLocus$self7.state) === _constants._JOINED_;
+          }
+          return this.isNeedHandleMainLocus(meeting, newLocus);
+        }
+        if (!isNewLocusAsBreakout) {
+          return this.isNeedHandleMainLocus(meeting, newLocus);
+        }
+        return !isSelfMoved;
+      }
+      return true;
+    }
+
+    /**
+     * get corresponding meeting object by locus data
+     * @param {Object} data a locus event
+     * @param {String} data.locusUrl
+     * @param {Object} data.locus
+     * @returns {Object}
+     * @private
+     * @memberof Meetings
+     */
+  }, {
+    key: "getCorrespondingMeetingByLocus",
+    value: function getCorrespondingMeetingByLocus(data) {
+      var _data$locus$info, _data$locus, _data$locus$info2;
       // getting meeting by correlationId. This will happen for the new event
       // Either the locus
       // TODO : Add check for the callBack Address
-      meeting = this.meetingCollection.getByKey(_constants.LOCUS_URL, data.locusUrl) ||
+      return this.meetingCollection.getByKey(_constants.LOCUS_URL, data.locusUrl) ||
       // @ts-ignore
       this.meetingCollection.getByKey(_constants.CORRELATION_ID,
       // @ts-ignore
-      _util2.default.checkForCorrelationId(this.webex.internal.device.url, data.locus)) || this.meetingCollection.getByKey(_constants.SIP_URI, data.locus.self && data.locus.self.callbackInfo && data.locus.self.callbackInfo.callbackAddress) || ((_data$locus$info = data.locus.info) !== null && _data$locus$info !== void 0 && _data$locus$info.isUnifiedSpaceMeeting ? undefined : this.meetingCollection.getByKey(_constants.CONVERSATION_URL, data.locus.conversationUrl));
+      _util2.default.checkForCorrelationId(this.webex.internal.device.url, data.locus)) || this.meetingCollection.getByKey(_constants.SIP_URI, data.locus.self && data.locus.self.callbackInfo && data.locus.self.callbackInfo.callbackAddress) || ((_data$locus$info = data.locus.info) !== null && _data$locus$info !== void 0 && _data$locus$info.isUnifiedSpaceMeeting ? undefined : this.meetingCollection.getByKey(_constants.CONVERSATION_URL, data.locus.conversationUrl)) || this.meetingCollection.getByKey(_constants.MEETINGNUMBER, (_data$locus = data.locus) === null || _data$locus === void 0 ? void 0 : (_data$locus$info2 = _data$locus.info) === null || _data$locus$info2 === void 0 ? void 0 : _data$locus$info2.webExMeetingId);
+    }
+
+    /**
+     * handle locus events and takes meeting actions with them as they come in
+     * @param {Object} data a locus event
+     * @param {String} data.locusUrl
+     * @param {Object} data.locus
+     * @param {Boolean} useRandomDelayForInfo whether a random delay should be added to fetching meeting info
+     * @param {String} data.eventType
+     * @returns {undefined}
+     * @private
+     * @memberof Meetings
+     */
+  }, {
+    key: "handleLocusEvent",
+    value: function handleLocusEvent(data) {
+      var _data$locus2,
+        _data$locus2$replaces,
+        _this2 = this;
+      var useRandomDelayForInfo = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : false;
+      var meeting = this.getCorrespondingMeetingByLocus(data);
 
       // Special case when locus has got replaced, This only happend once if a replace locus exists
       // https://sqbu-github.cisco.com/WebExSquared/locus/wiki/Locus-changing-mid-call
 
-      if (!meeting && ((_data$locus = data.locus) === null || _data$locus === void 0 ? void 0 : (_data$locus$replaces = _data$locus.replaces) === null || _data$locus$replaces === void 0 ? void 0 : _data$locus$replaces.length) > 0) {
+      if (!meeting && ((_data$locus2 = data.locus) === null || _data$locus2 === void 0 ? void 0 : (_data$locus2$replaces = _data$locus2.replaces) === null || _data$locus2$replaces === void 0 ? void 0 : _data$locus2$replaces.length) > 0) {
         // Always the last element in the replace is the active one
         meeting = this.meetingCollection.getByKey(_constants.LOCUS_URL, data.locus.replaces[data.locus.replaces.length - 1].locusUrl);
       }
+      if (meeting && !_util2.default.isBreakoutLocusDTO(data.locus)) {
+        meeting.locusInfo.updateMainSessionLocusCache(data.locus);
+      }
+      if (!this.isNeedHandleLocusDTO(meeting, data.locus)) {
+        _loggerProxy.default.logger.log("Meetings:index#handleLocusEvent --> doesn't need to process locus event");
+        return;
+      }
       if (!meeting) {
         // TODO: create meeting when we get a meeting object
         // const checkForEnded = (locus) => {
@@ -272,6 +509,7 @@ var Meetings = /*#__PURE__*/function (_WebexPlugin) {
 
           // It's a new meeting so initialize the locus data
           meeting.locusInfo.initialSetup(data.locus);
+          _this2.checkHandleBreakoutLocus(data.locus);
         }).catch(function (e) {
           _loggerProxy.default.logger.error(e);
         }).finally(function () {
@@ -279,11 +517,14 @@ var Meetings = /*#__PURE__*/function (_WebexPlugin) {
           // because the other user left so before sending 'added' event make sure it exists in the collection
 
           if (_this2.getMeetingByType(_constants._ID_, meeting.id)) {
-            _metrics.default.postEvent({
-              event: _config.eventType.REMOTE_STARTED,
-              meeting: meeting,
-              data: {
-                trigger: _config.trigger.MERCURY_EVENT
+            // @ts-ignore
+            _this2.webex.internal.newMetrics.submitClientEvent({
+              name: 'client.call.remote-started',
+              payload: {
+                trigger: 'mercury-event'
+              },
+              options: {
+                meetingId: meeting.id
               }
             });
             _triggerProxy.default.trigger(_this2, {
@@ -359,7 +600,9 @@ var Meetings = /*#__PURE__*/function (_WebexPlugin) {
 
       // @ts-ignore
       this.webex.internal.mercury.on(_constants.ONLINE, function () {
-        _this3.syncMeetings();
+        _this3.syncMeetings({
+          keepOnlyLocusMeetings: false
+        });
       });
 
       // @ts-ignore
@@ -397,11 +640,13 @@ var Meetings = /*#__PURE__*/function (_WebexPlugin) {
       // @ts-ignore
       this.webex.once(_constants.READY, function () {
         // @ts-ignore
-        _config2.default.set(_this4.config);
+        _config.default.set(_this4.config);
         // @ts-ignore
         _loggerConfig.default.set(_this4.config.logging);
         // @ts-ignore
         _loggerProxy.default.set(_this4.webex.logger);
+        mediaLogger = new MediaLogger();
+        (0, _internalMediaCore.setLogger)(mediaLogger);
 
         /**
          * The MeetingInfo object to interact with server
@@ -432,7 +677,7 @@ var Meetings = /*#__PURE__*/function (_WebexPlugin) {
           disableNotifications: true
         });
         // @ts-ignore
-        _metrics.default.initialSetup(_this4.meetingCollection, _this4.webex);
+        _metrics.default.initialSetup(_this4.webex);
       });
     }
 
@@ -460,40 +705,43 @@ var Meetings = /*#__PURE__*/function (_WebexPlugin) {
     }
 
     /**
-     * API to enable or disable TURN discovery
-     * @param {Boolean} enable
+     * API to toggle starting adhoc meeting
+     * @param {Boolean} changeState
      * @private
      * @memberof Meetings
      * @returns {undefined}
      */
   }, {
-    key: "_toggleTurnDiscovery",
-    value: function _toggleTurnDiscovery(enable) {
-      if (typeof enable !== 'boolean') {
+    key: "_toggleAdhocMeetings",
+    value: function _toggleAdhocMeetings(changeState) {
+      var _this$config2, _this$config2$experim;
+      if (typeof changeState !== 'boolean') {
         return;
       }
       // @ts-ignore
-      this.config.experimental.enableTurnDiscovery = enable;
+      if (((_this$config2 = this.config) === null || _this$config2 === void 0 ? void 0 : (_this$config2$experim = _this$config2.experimental) === null || _this$config2$experim === void 0 ? void 0 : _this$config2$experim.enableAdhocMeetings) !== changeState) {
+        // @ts-ignore
+        this.config.experimental.enableAdhocMeetings = changeState;
+      }
     }
 
     /**
-     * API to toggle starting adhoc meeting
-     * @param {Boolean} changeState
+     * API to toggle TCP reachability, needs to be called before webex.meetings.register()
+     * @param {Boolean} newValue
      * @private
      * @memberof Meetings
      * @returns {undefined}
      */
   }, {
-    key: "_toggleAdhocMeetings",
-    value: function _toggleAdhocMeetings(changeState) {
-      var _this$config2, _this$config2$experim;
-      if (typeof changeState !== 'boolean') {
+    key: "_toggleTcpReachability",
+    value: function _toggleTcpReachability(newValue) {
+      if (typeof newValue !== 'boolean') {
         return;
       }
       // @ts-ignore
-      if (((_this$config2 = this.config) === null || _this$config2 === void 0 ? void 0 : (_this$config2$experim = _this$config2.experimental) === null || _this$config2$experim === void 0 ? void 0 : _this$config2$experim.enableAdhocMeetings) !== changeState) {
+      if (this.config.experimental.enableTcpReachability !== newValue) {
         // @ts-ignore
-        this.config.experimental.enableAdhocMeetings = changeState;
+        this.config.experimental.enableTcpReachability = newValue;
       }
     }
 
@@ -581,7 +829,9 @@ var Meetings = /*#__PURE__*/function (_WebexPlugin) {
         })
       );
     }
-
+  }, {
+    key: "uploadLogs",
+    value:
     /**
      * Uploads logs to the webex services for tracking
      * @param {Object} [options={}]
@@ -594,14 +844,13 @@ var Meetings = /*#__PURE__*/function (_WebexPlugin) {
      * @param {String} [options.orgId] org id
      * @returns {String} feedback ID logs were submitted under
      */
-  }, {
-    key: "uploadLogs",
-    value: function uploadLogs() {
+    function uploadLogs() {
       var _this7 = this;
       var options = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};
       _loggerProxy.default.logger.info('Meetings:index#uploadLogs --> uploading logs');
       return this.loggerRequest.uploadLogs(options).then(function (uploadResult) {
         _loggerProxy.default.logger.info('Meetings:index#uploadLogs --> Upload logs for meeting completed.', uploadResult);
+        _metrics.default.sendBehavioralMetric(_constants2.default.UPLOAD_LOGS_SUCCESS, options);
         _triggerProxy.default.trigger(_this7, {
           file: 'meetings',
           function: 'uploadLogs'
@@ -619,29 +868,14 @@ var Meetings = /*#__PURE__*/function (_WebexPlugin) {
           meetingId: options.meetingId,
           reason: uploadError
         });
-        _metrics.default.sendBehavioralMetric(_constants2.default.UPLOAD_LOGS_FAILURE, {
-          // @ts-ignore - seems like typo
-          meetingId: options.meetingsId,
+        _metrics.default.sendBehavioralMetric(_constants2.default.UPLOAD_LOGS_FAILURE, _objectSpread(_objectSpread({}, options), {}, {
           reason: uploadError.message,
           stack: uploadError.stack,
           code: uploadError.code
-        });
+        }));
       });
     }
 
-    /**
-     * initializes the reachability instance for Meetings
-     * @returns {undefined}
-     * @public
-     * @memberof Meetings
-     */
-  }, {
-    key: "setReachability",
-    value: function setReachability() {
-      // @ts-ignore
-      this.reachability = new _reachability.default(this.webex);
-    }
-
     /**
      * gets the reachability instance for Meetings
      * @returns {Reachability}
@@ -663,9 +897,6 @@ var Meetings = /*#__PURE__*/function (_WebexPlugin) {
   }, {
     key: "startReachability",
     value: function startReachability() {
-      if (!this.reachability) {
-        this.setReachability();
-      }
       return this.getReachability().gatherReachability();
     }
 
@@ -699,6 +930,23 @@ var Meetings = /*#__PURE__*/function (_WebexPlugin) {
         if (res) {
           _this9.preferredWebexSite = _util2.default.parseDefaultSiteFromMeetingPreferences(res);
         }
+
+        // fall back to getting the preferred site from the user information
+        if (!_this9.preferredWebexSite) {
+          // @ts-ignore
+          return _this9.webex.internal.user.get().then(function (user) {
+            var _user$userPreferences, _user$userPreferences2;
+            var preferredWebexSite = user === null || user === void 0 ? void 0 : (_user$userPreferences = user.userPreferences) === null || _user$userPreferences === void 0 ? void 0 : (_user$userPreferences2 = _user$userPreferences.userPreferencesItems) === null || _user$userPreferences2 === void 0 ? void 0 : _user$userPreferences2.preferredWebExSite;
+            if (preferredWebexSite) {
+              _this9.preferredWebexSite = preferredWebexSite;
+            } else {
+              throw new Error('site not found');
+            }
+          }).catch(function () {
+            _loggerProxy.default.logger.error('Failed to fetch preferred site from user - no site will be set');
+          });
+        }
+        return _promise.default.resolve();
       });
     }
 
@@ -737,10 +985,19 @@ var Meetings = /*#__PURE__*/function (_WebexPlugin) {
     }
 
     /**
-     * Create a meeting.
-     * @param {string} destination - sipURL, spaceId, phonenumber, or locus object}
+     * Create a meeting or return an existing meeting.
+     *
+     * When meeting info passed it should be complete, e.g.: fetched after password or captcha provided
+     *
+     * @param {string} destination - sipURL, phonenumber, or locus object}
      * @param {string} [type] - the optional specified type, such as locusId
      * @param {Boolean} useRandomDelayForInfo - whether a random delay should be added to fetching meeting info
+     * @param {Object} infoExtraParams extra parameters to be provided when fetching meeting info
+     * @param {string} correlationId - the optional specified correlationId (callStateForMetrics.correlationId can be provided instead)
+     * @param {Boolean} failOnMissingMeetingInfo - whether to throw an error if meeting info fails to fetch (for calls that are not 1:1 or content share)
+     * @param {CallStateForMetrics} callStateForMetrics - information about call state for metrics
+     * @param {Object} [meetingInfo] - Pre-fetched complete meeting info
+     * @param {String} [meetingLookupUrl] - meeting info prefetch url
      * @returns {Promise<Meeting>} A new Meeting.
      * @public
      * @memberof Meetings
@@ -751,16 +1008,30 @@ var Meetings = /*#__PURE__*/function (_WebexPlugin) {
       var _this10 = this;
       var type = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : null;
       var useRandomDelayForInfo = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : false;
+      var infoExtraParams = arguments.length > 3 && arguments[3] !== undefined ? arguments[3] : {};
+      var correlationId = arguments.length > 4 && arguments[4] !== undefined ? arguments[4] : undefined;
+      var failOnMissingMeetingInfo = arguments.length > 5 && arguments[5] !== undefined ? arguments[5] : false;
+      var callStateForMetrics = arguments.length > 6 && arguments[6] !== undefined ? arguments[6] : undefined;
+      var meetingInfo = arguments.length > 7 && arguments[7] !== undefined ? arguments[7] : undefined;
+      var meetingLookupUrl = arguments.length > 8 && arguments[8] !== undefined ? arguments[8] : undefined;
       // TODO: type should be from a dictionary
 
       // Validate meeting information based on the provided destination and
       // type. This must be performed prior to determining if the meeting is
       // found in the collection, as we mutate the destination for hydra person
       // id values.
+      if (correlationId) {
+        callStateForMetrics = _objectSpread(_objectSpread({}, callStateForMetrics || {}), {}, {
+          correlationId: correlationId
+        });
+      }
       return this.meetingInfo.fetchInfoOptions(destination, type)
       // Catch a failure to fetch info options.
       .catch(function (error) {
-        _loggerProxy.default.logger.info("Meetings:index#create --> INFO, unable to determine info options: ".concat(error.message));
+        _loggerProxy.default.logger.error("Meetings:index#create --> ERROR, unable to determine info options: ".concat(error.message));
+        if (error instanceof _webexErrors.SpaceIDDeprecatedError) {
+          throw new _webexErrors.SpaceIDDeprecatedError();
+        }
       }).then(function () {
         var options = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};
         // Normalize the destination.
@@ -789,20 +1060,22 @@ var Meetings = /*#__PURE__*/function (_WebexPlugin) {
         // Validate if a meeting was found.
         if (!meeting) {
           // Create a meeting based on the normalized destination and type.
-          return _this10.createMeeting(targetDest, type, useRandomDelayForInfo).then(function (createdMeeting) {
+          return _this10.createMeeting(targetDest, type, useRandomDelayForInfo, infoExtraParams, callStateForMetrics, failOnMissingMeetingInfo, meetingInfo, meetingLookupUrl).then(function (createdMeeting) {
             // If the meeting was successfully created.
             if (createdMeeting && createdMeeting.on) {
               // Create a destruction event for the meeting.
               createdMeeting.on(_constants.EVENTS.DESTROY_MEETING, function (payload) {
                 // @ts-ignore
                 if (_this10.config.autoUploadLogs) {
-                  var _createdMeeting$locus, _createdMeeting$locus2, _createdMeeting$locus3, _createdMeeting$locus4;
+                  var _createdMeeting$locus, _createdMeeting$locus2, _createdMeeting$locus3, _createdMeeting$locus4, _createdMeeting$locus5, _createdMeeting$locus6;
                   _this10.uploadLogs({
                     callStart: (_createdMeeting$locus = createdMeeting.locusInfo) === null || _createdMeeting$locus === void 0 ? void 0 : (_createdMeeting$locus2 = _createdMeeting$locus.fullState) === null || _createdMeeting$locus2 === void 0 ? void 0 : _createdMeeting$locus2.lastActive,
+                    locussessionid: (_createdMeeting$locus3 = createdMeeting.locusInfo) === null || _createdMeeting$locus3 === void 0 ? void 0 : (_createdMeeting$locus4 = _createdMeeting$locus3.fullState) === null || _createdMeeting$locus4 === void 0 ? void 0 : _createdMeeting$locus4.sessionId,
                     correlationId: createdMeeting.correlationId,
                     feedbackId: createdMeeting.correlationId,
                     locusId: createdMeeting.locusId,
-                    meetingId: (_createdMeeting$locus3 = createdMeeting.locusInfo) === null || _createdMeeting$locus3 === void 0 ? void 0 : (_createdMeeting$locus4 = _createdMeeting$locus3.info) === null || _createdMeeting$locus4 === void 0 ? void 0 : _createdMeeting$locus4.webExMeetingId
+                    meetingId: (_createdMeeting$locus5 = createdMeeting.locusInfo) === null || _createdMeeting$locus5 === void 0 ? void 0 : (_createdMeeting$locus6 = _createdMeeting$locus5.info) === null || _createdMeeting$locus6 === void 0 ? void 0 : _createdMeeting$locus6.webExMeetingId,
+                    autoupload: true
                   }).then(function () {
                     return _this10.destroy(createdMeeting, payload.reason);
                   });
@@ -813,13 +1086,15 @@ var Meetings = /*#__PURE__*/function (_WebexPlugin) {
               createdMeeting.on(_constants.EVENTS.REQUEST_UPLOAD_LOGS, function (meetingInstance) {
                 // @ts-ignore
                 if (_this10.config.autoUploadLogs) {
-                  var _meetingInstance$locu, _meetingInstance$locu2, _meetingInstance$locu3, _meetingInstance$locu4;
+                  var _meetingInstance$locu, _meetingInstance$locu2, _meetingInstance$locu3, _meetingInstance$locu4, _meetingInstance$locu5, _meetingInstance$locu6;
                   _this10.uploadLogs({
                     callStart: meetingInstance === null || meetingInstance === void 0 ? void 0 : (_meetingInstance$locu = meetingInstance.locusInfo) === null || _meetingInstance$locu === void 0 ? void 0 : (_meetingInstance$locu2 = _meetingInstance$locu.fullState) === null || _meetingInstance$locu2 === void 0 ? void 0 : _meetingInstance$locu2.lastActive,
+                    locussessionid: meetingInstance === null || meetingInstance === void 0 ? void 0 : (_meetingInstance$locu3 = meetingInstance.locusInfo) === null || _meetingInstance$locu3 === void 0 ? void 0 : (_meetingInstance$locu4 = _meetingInstance$locu3.fullState) === null || _meetingInstance$locu4 === void 0 ? void 0 : _meetingInstance$locu4.sessionId,
                     correlationId: meetingInstance.correlationId,
                     feedbackId: meetingInstance.correlationId,
                     locusId: meetingInstance.locusId,
-                    meetingId: (_meetingInstance$locu3 = meetingInstance.locusInfo) === null || _meetingInstance$locu3 === void 0 ? void 0 : (_meetingInstance$locu4 = _meetingInstance$locu3.info) === null || _meetingInstance$locu4 === void 0 ? void 0 : _meetingInstance$locu4.webExMeetingId
+                    meetingId: (_meetingInstance$locu5 = meetingInstance.locusInfo) === null || _meetingInstance$locu5 === void 0 ? void 0 : (_meetingInstance$locu6 = _meetingInstance$locu5.info) === null || _meetingInstance$locu6 === void 0 ? void 0 : _meetingInstance$locu6.webExMeetingId,
+                    autoupload: true
                   });
                 }
               });
@@ -831,6 +1106,7 @@ var Meetings = /*#__PURE__*/function (_WebexPlugin) {
             return _promise.default.resolve(createdMeeting);
           });
         }
+        meeting.setCallStateForMetrics(callStateForMetrics);
 
         // Return the existing meeting.
         return _promise.default.resolve(meeting);
@@ -838,19 +1114,33 @@ var Meetings = /*#__PURE__*/function (_WebexPlugin) {
     }
 
     /**
+     * Create meeting
+     *
+     * When meeting info passed it should be complete, e.g.: fetched after password or captcha provided
+     *
      * @param {String} destination see create()
      * @param {String} type see create()
      * @param {Boolean} useRandomDelayForInfo whether a random delay should be added to fetching meeting info
+     * @param {Object} infoExtraParams extra parameters to be provided when fetching meeting info
+     * @param {CallStateForMetrics} callStateForMetrics - information about call state for metrics
+     * @param {Boolean} failOnMissingMeetingInfo - whether to throw an error if meeting info fails to fetch (for calls that are not 1:1 or content share)
+     * @param {Object} [meetingInfo] - Pre-fetched complete meeting info
+     * @param {String} [meetingLookupUrl] - meeting info prefetch url
      * @returns {Promise} a new meeting instance complete with meeting info and destination
      * @private
      * @memberof Meetings
      */
   }, {
     key: "createMeeting",
-    value: function () {
-      var _createMeeting = (0, _asyncToGenerator2.default)( /*#__PURE__*/_regenerator.default.mark(function _callee(destination) {
+    value: (function () {
+      var _createMeeting = (0, _asyncToGenerator2.default)( /*#__PURE__*/_regenerator.default.mark(function _callee3(destination) {
         var type,
           useRandomDelayForInfo,
+          infoExtraParams,
+          callStateForMetrics,
+          failOnMissingMeetingInfo,
+          meetingInfo,
+          meetingLookupUrl,
           meeting,
           _destination$fullStat,
           waitingTime,
@@ -861,13 +1151,19 @@ var Meetings = /*#__PURE__*/function (_WebexPlugin) {
           maxWaitingTime,
           isMeetingActive,
           enableUnifiedMeetings,
+          meetingInfoOptions,
           meetingAddedType,
-          _args = arguments;
-        return _regenerator.default.wrap(function _callee$(_context) {
-          while (1) switch (_context.prev = _context.next) {
+          _args3 = arguments;
+        return _regenerator.default.wrap(function _callee3$(_context3) {
+          while (1) switch (_context3.prev = _context3.next) {
             case 0:
-              type = _args.length > 1 && _args[1] !== undefined ? _args[1] : null;
-              useRandomDelayForInfo = _args.length > 2 && _args[2] !== undefined ? _args[2] : false;
+              type = _args3.length > 1 && _args3[1] !== undefined ? _args3[1] : null;
+              useRandomDelayForInfo = _args3.length > 2 && _args3[2] !== undefined ? _args3[2] : false;
+              infoExtraParams = _args3.length > 3 && _args3[3] !== undefined ? _args3[3] : {};
+              callStateForMetrics = _args3.length > 4 && _args3[4] !== undefined ? _args3[4] : undefined;
+              failOnMissingMeetingInfo = _args3.length > 5 && _args3[5] !== undefined ? _args3[5] : false;
+              meetingInfo = _args3.length > 6 && _args3[6] !== undefined ? _args3[6] : undefined;
+              meetingLookupUrl = _args3.length > 7 && _args3[7] !== undefined ? _args3[7] : undefined;
               meeting = new _meeting.default({
                 // @ts-ignore
                 userId: this.webex.internal.device.userId,
@@ -875,18 +1171,18 @@ var Meetings = /*#__PURE__*/function (_WebexPlugin) {
                 deviceUrl: this.webex.internal.device.url,
                 // @ts-ignore
                 orgId: this.webex.internal.device.orgId,
-                roapSeq: 0,
                 locus: type === _constants._LOCUS_ID_ ? destination : null,
                 // pass the locus object if present
                 meetingInfoProvider: this.meetingInfo,
                 destination: destination,
-                destinationType: type
+                destinationType: type,
+                callStateForMetrics: callStateForMetrics
               }, {
                 // @ts-ignore
                 parent: this.webex
               });
               this.meetingCollection.set(meeting);
-              _context.prev = 4;
+              _context3.prev = 9;
               // if no participant has joined the scheduled meeting (meaning meeting is not active) and we get a locusEvent,
               // it means the meeting will start in 5-6 min. In that case, we want to fetchMeetingInfo
               // between 5 and 2 min (random between 3 minutes) before the meeting starts
@@ -902,33 +1198,57 @@ var Meetings = /*#__PURE__*/function (_WebexPlugin) {
               }
               isMeetingActive = !!((_destination$fullStat = destination.fullState) !== null && _destination$fullStat !== void 0 && _destination$fullStat.active); // @ts-ignore
               enableUnifiedMeetings = this.config.experimental.enableUnifiedMeetings;
+              meetingInfoOptions = {
+                extraParams: infoExtraParams,
+                sendCAevents: !!(callStateForMetrics !== null && callStateForMetrics !== void 0 && callStateForMetrics.correlationId) // if client sends correlation id as argument of public create(), then it means that this meeting creation is part of a pre-join intent from user
+              };
+              if (!meetingInfo) {
+                _context3.next = 19;
+                break;
+              }
+              meeting.injectMeetingInfo(meetingInfo, meetingInfoOptions, meetingLookupUrl);
+              _context3.next = 26;
+              break;
+            case 19:
               if (!(enableUnifiedMeetings && !isMeetingActive && useRandomDelayForInfo && waitingTime > 0)) {
-                _context.next = 14;
+                _context3.next = 24;
                 break;
               }
               meeting.fetchMeetingInfoTimeoutId = setTimeout(function () {
-                return meeting.fetchMeetingInfo({});
+                return meeting.fetchMeetingInfo(meetingInfoOptions);
               }, waitingTime);
               meeting.parseMeetingInfo(undefined, destination);
-              _context.next = 16;
+              _context3.next = 26;
               break;
-            case 14:
-              _context.next = 16;
-              return meeting.fetchMeetingInfo({});
-            case 16:
-              _context.next = 22;
+            case 24:
+              _context3.next = 26;
+              return meeting.fetchMeetingInfo(meetingInfoOptions);
+            case 26:
+              _context3.next = 38;
               break;
-            case 18:
-              _context.prev = 18;
-              _context.t0 = _context["catch"](4);
-              if (!(_context.t0 instanceof _captchaError.default) && !(_context.t0 instanceof _passwordError.default)) {
-                // if there is no meeting info we assume its a 1:1 call or wireless share
-                _loggerProxy.default.logger.info("Meetings:index#createMeeting --> Info Unable to fetch meeting info for ".concat(destination, "."));
-                _loggerProxy.default.logger.info('Meetings:index#createMeeting --> Info assuming this destination is a 1:1 or wireless share');
+            case 28:
+              _context3.prev = 28;
+              _context3.t0 = _context3["catch"](9);
+              if (!(!(_context3.t0 instanceof _captchaError.default) && !(_context3.t0 instanceof _passwordError.default) && !(_context3.t0 instanceof _permission.default))) {
+                _context3.next = 37;
+                break;
               }
-              _loggerProxy.default.logger.debug("Meetings:index#createMeeting --> Debug ".concat(_context.t0, " fetching /meetingInfo for creation."));
-            case 22:
-              _context.prev = 22;
+              _loggerProxy.default.logger.info("Meetings:index#createMeeting --> Info Unable to fetch meeting info for ".concat(destination, "."));
+              if (!failOnMissingMeetingInfo) {
+                _context3.next = 36;
+                break;
+              }
+              _loggerProxy.default.logger.info("Meetings:index#createMeeting --> Destroying meeting due to missing meeting info.");
+              // @ts-ignore
+              this.destroy(meeting, _constants.MEETING_REMOVED_REASON.MISSING_MEETING_INFO);
+              throw new _noMeetingInfo.default();
+            case 36:
+              // if there is no meeting info and no error should be thrown then we assume its a 1:1 call or wireless share
+              _loggerProxy.default.logger.info('Meetings:index#createMeeting --> Info assuming this destination is a 1:1 or wireless share');
+            case 37:
+              _loggerProxy.default.logger.debug("Meetings:index#createMeeting --> Debug ".concat(_context3.t0, " fetching /meetingInfo for creation."));
+            case 38:
+              _context3.prev = 38;
               // For type LOCUS_ID we need to parse the locus object to get the information
               // about the caller and callee
               // Meeting Added event will be created in `handleLocusEvent`
@@ -948,16 +1268,16 @@ var Meetings = /*#__PURE__*/function (_WebexPlugin) {
                   type: meetingAddedType
                 });
               }
-              return _context.finish(22);
-            case 25:
-              return _context.abrupt("return", meeting);
-            case 26:
+              return _context3.finish(38);
+            case 41:
+              return _context3.abrupt("return", meeting);
+            case 42:
             case "end":
-              return _context.stop();
+              return _context3.stop();
           }
-        }, _callee, this, [[4, 18, 22, 25]]);
+        }, _callee3, this, [[9, 28, 38, 41]]);
       }));
-      function createMeeting(_x) {
+      function createMeeting(_x3) {
         return _createMeeting.apply(this, arguments);
       }
       return createMeeting;
@@ -970,6 +1290,7 @@ var Meetings = /*#__PURE__*/function (_WebexPlugin) {
      * @public
      * @memberof Meetings
      */
+    )
   }, {
     key: "getMeetingByType",
     value: function getMeetingByType(type, value) {
@@ -996,7 +1317,8 @@ var Meetings = /*#__PURE__*/function (_WebexPlugin) {
 
     /**
      * syncs all the meeting from server
-     * @returns {undefined}
+     * @param {boolean} keepOnlyLocusMeetings - whether the sync should keep only locus meetings or any other meeting in meetingCollection
+     * @returns {Promise<void>}
      * @public
      * @memberof Meetings
      */
@@ -1004,10 +1326,14 @@ var Meetings = /*#__PURE__*/function (_WebexPlugin) {
     key: "syncMeetings",
     value: function syncMeetings() {
       var _this11 = this;
+      var _ref3 = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {},
+        _ref3$keepOnlyLocusMe = _ref3.keepOnlyLocusMeetings,
+        keepOnlyLocusMeetings = _ref3$keepOnlyLocusMe === void 0 ? true : _ref3$keepOnlyLocusMe;
       return this.request.getActiveMeetings().then(function (locusArray) {
         var activeLocusUrl = [];
         if (locusArray !== null && locusArray !== void 0 && locusArray.loci && locusArray.loci.length > 0) {
-          locusArray.loci.forEach(function (locus) {
+          var lociToUpdate = _this11.sortLocusArrayToUpdate(locusArray.loci);
+          lociToUpdate.forEach(function (locus) {
             activeLocusUrl.push(locus.url);
             _this11.handleLocusEvent({
               locus: locus,
@@ -1017,19 +1343,95 @@ var Meetings = /*#__PURE__*/function (_WebexPlugin) {
         }
         var meetingsCollection = _this11.meetingCollection.getAll();
         if ((0, _keys.default)(meetingsCollection).length > 0) {
-          // Some time the mercury event is missed after mercury reconnect
-          // if sync returns no locus then clear all the meetings
+          // Sometimes the mercury events are lost after mercury reconnect
+          // Remove any Locus meetings that are not returned by Locus
+          // (they had a locusUrl previously but are no longer active) in the sync
           for (var _i = 0, _Object$values = (0, _values.default)(meetingsCollection); _i < _Object$values.length; _i++) {
             var meeting = _Object$values[_i];
             // @ts-ignore
-            if (!activeLocusUrl.includes(meeting.locusUrl)) {
+            var locusUrl = meeting.locusUrl;
+            if ((keepOnlyLocusMeetings || locusUrl) && !activeLocusUrl.includes(locusUrl)) {
               // destroy function also uploads logs
               // @ts-ignore
               _this11.destroy(meeting, _constants.MEETING_REMOVED_REASON.NO_MEETINGS_TO_SYNC);
             }
           }
         }
+      }).catch(function (error) {
+        _loggerProxy.default.logger.error("Meetings:index#syncMeetings --> failed to sync meetings, ".concat(error));
+        throw new Error(error);
+      });
+    }
+
+    /**
+     * sort out locus array for initial creating
+     * @param {Array} loci original locus array
+     * @returns {undefined}
+     * @public
+     * @memberof Meetings
+     */
+  }, {
+    key: "sortLocusArrayToUpdate",
+    value: function sortLocusArrayToUpdate(loci) {
+      var _this12 = this;
+      var mainLoci = loci.filter(function (locus) {
+        return !_util2.default.isBreakoutLocusDTO(locus);
+      });
+      var breakoutLoci = loci.filter(function (locus) {
+        return _util2.default.isValidBreakoutLocus(locus);
+      });
+      this.breakoutLocusForHandleLater = [];
+      var lociToUpdate = (0, _toConsumableArray2.default)(mainLoci);
+      breakoutLoci.forEach(function (breakoutLocus) {
+        var associateMainLocus = mainLoci.find(function (mainLocus) {
+          var _mainLocus$controls, _mainLocus$controls$b, _breakoutLocus$contro, _breakoutLocus$contro2;
+          return ((_mainLocus$controls = mainLocus.controls) === null || _mainLocus$controls === void 0 ? void 0 : (_mainLocus$controls$b = _mainLocus$controls.breakout) === null || _mainLocus$controls$b === void 0 ? void 0 : _mainLocus$controls$b.url) === ((_breakoutLocus$contro = breakoutLocus.controls) === null || _breakoutLocus$contro === void 0 ? void 0 : (_breakoutLocus$contro2 = _breakoutLocus$contro.breakout) === null || _breakoutLocus$contro2 === void 0 ? void 0 : _breakoutLocus$contro2.url);
+        });
+        var existCorrespondingMeeting = _this12.getCorrespondingMeetingByLocus({
+          locus: breakoutLocus,
+          locusUrl: breakoutLocus.url
+        });
+        if (associateMainLocus && !existCorrespondingMeeting) {
+          // if exists both main session and breakout session locus of the same non-exist meeting, handle main locus first,
+          // after meeting create with main locus, then handle the associate breakout locus.
+          // if only handle breakout locus, will miss some date
+          _this12.breakoutLocusForHandleLater.push(breakoutLocus);
+        } else {
+          lociToUpdate.push(breakoutLocus);
+        }
       });
+      return lociToUpdate;
+    }
+
+    /**
+     * check breakout locus which waiting for main locus's meeting to be created, then handle the breakout locus
+     * @param {Object} newCreatedLocus the locus which just create meeting object of it
+     * @returns {undefined}
+     * @public
+     * @memberof Meetings
+     */
+  }, {
+    key: "checkHandleBreakoutLocus",
+    value: function checkHandleBreakoutLocus(newCreatedLocus) {
+      if (!newCreatedLocus || !this.breakoutLocusForHandleLater || !this.breakoutLocusForHandleLater.length) {
+        return;
+      }
+      if (_util2.default.isBreakoutLocusDTO(newCreatedLocus)) {
+        return;
+      }
+      var existIndex = this.breakoutLocusForHandleLater.findIndex(function (breakoutLocus) {
+        var _breakoutLocus$contro3, _breakoutLocus$contro4, _newCreatedLocus$cont, _newCreatedLocus$cont2;
+        return ((_breakoutLocus$contro3 = breakoutLocus.controls) === null || _breakoutLocus$contro3 === void 0 ? void 0 : (_breakoutLocus$contro4 = _breakoutLocus$contro3.breakout) === null || _breakoutLocus$contro4 === void 0 ? void 0 : _breakoutLocus$contro4.url) === ((_newCreatedLocus$cont = newCreatedLocus.controls) === null || _newCreatedLocus$cont === void 0 ? void 0 : (_newCreatedLocus$cont2 = _newCreatedLocus$cont.breakout) === null || _newCreatedLocus$cont2 === void 0 ? void 0 : _newCreatedLocus$cont2.url);
+      });
+      if (existIndex < 0) {
+        return;
+      }
+      var associateBreakoutLocus = this.breakoutLocusForHandleLater[existIndex];
+      this.handleLocusEvent({
+        locus: associateBreakoutLocus,
+        locusUrl: associateBreakoutLocus.url
+      });
+      this.breakoutLocusForHandleLater.splice(existIndex, 1);
     }
 
     /**
@@ -1057,8 +1459,20 @@ var Meetings = /*#__PURE__*/function (_WebexPlugin) {
     value: function getLogger() {
       return _loggerProxy.default.get();
     }
+
+    /**
+     * Returns the first meeting it finds that has the webrtc media connection created.
+     * Useful for debugging in the console.
+     *
+     * @private
+     * @returns {Meeting} Meeting object that has a webrtc media connection, else undefined
+     */
+  }, {
+    key: "getActiveWebrtcMeeting",
+    value: function getActiveWebrtcMeeting() {
+      return this.meetingCollection.getActiveWebrtcMeeting();
+    }
   }]);
   return Meetings;
 }(_webexCore.WebexPlugin);
-exports.default = Meetings;
 //# sourceMappingURL=index.js.map