@webex/plugin-meetings 3.0.0-beta.28 → 3.0.0-beta.280

package/dist/meetings/index.js

@@ -1,17 +1,25 @@
 "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 _assertThisInitialized2 = _interopRequireDefault(require("@babel/runtime-corejs2/helpers/assertThisInitialized"));
 var _inherits2 = _interopRequireDefault(require("@babel/runtime-corejs2/helpers/inherits"));
@@ -22,13 +30,14 @@ var _classCallCheck2 = _interopRequireDefault(require("@babel/runtime-corejs2/he
 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"));
@@ -46,6 +55,13 @@ 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(nodeInterop) { if (typeof _WeakMap !== "function") return null; var cacheBabelInterop = new _WeakMap(); var cacheNodeInterop = new _WeakMap(); return (_getRequireWildcardCache = function _getRequireWildcardCache(nodeInterop) { return nodeInterop ? cacheNodeInterop : cacheBabelInterop; })(nodeInterop); }
+function _interopRequireWildcard(obj, nodeInterop) { if (!nodeInterop && obj && obj.__esModule) { return obj; } if (obj === null || _typeof(obj) !== "object" && typeof obj !== "function") { return { default: obj }; } var cache = _getRequireWildcardCache(nodeInterop); if (cache && cache.has(obj)) { return cache.get(obj); } var newObj = {}; var hasPropertyDescriptor = _Object$defineProperty && _Object$getOwnPropertyDescriptor; for (var key in obj) { if (key !== "default" && Object.prototype.hasOwnProperty.call(obj, key)) { var desc = hasPropertyDescriptor ? _Object$getOwnPropertyDescriptor(obj, key) : null; if (desc && (desc.get || desc.set)) { _Object$defineProperty(newObj, key, desc); } else { newObj[key] = obj[key]; } } } newObj.default = obj; if (cache) { cache.set(obj, newObj); } return newObj; }
+function ownKeys(object, enumerableOnly) { var keys = _Object$keys2(object); if (_Object$getOwnPropertySymbols) { var symbols = _Object$getOwnPropertySymbols(object); enumerableOnly && (symbols = symbols.filter(function (sym) { return _Object$getOwnPropertyDescriptor(object, sym).enumerable; })), keys.push.apply(keys, symbols); } return keys; }
+function _objectSpread(target) { for (var i = 1; i < arguments.length; i++) { var source = null != arguments[i] ? arguments[i] : {}; i % 2 ? ownKeys(Object(source), !0).forEach(function (key) { (0, _defineProperty2.default)(target, key, source[key]); }) : _Object$getOwnPropertyDescriptors ? _Object$defineProperties(target, _Object$getOwnPropertyDescriptors(source)) : ownKeys(Object(source)).forEach(function (key) { _Object$defineProperty(target, key, _Object$getOwnPropertyDescriptor(source, key)); }); } return target; }
 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; } }
 var mediaLogger;
@@ -157,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);
@@ -174,7 +191,61 @@ 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);
+    (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);
+      };
+    }());
+    (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
     });
@@ -198,15 +269,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}
@@ -235,50 +308,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) => {
@@ -318,6 +493,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 () {
@@ -325,11 +501,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, {
@@ -443,7 +622,7 @@ 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
@@ -480,7 +659,7 @@ var Meetings = /*#__PURE__*/function (_WebexPlugin) {
           disableNotifications: true
         });
         // @ts-ignore
-        _metrics.default.initialSetup(_this4.meetingCollection, _this4.webex);
+        _metrics.default.initialSetup(_this4.webex);
       });
     }
 
@@ -630,6 +809,17 @@ var Meetings = /*#__PURE__*/function (_WebexPlugin) {
       );
     }
 
+    /**
+     * Creates a noise reduction effect
+     *
+     * @param {INoiseReductionEffect} options optional custom effect options
+     * @returns {Promise<effect>} noise reduction effect.
+     * @public
+     * @memberof Meetings
+     */
+  }, {
+    key: "uploadLogs",
+    value:
     /**
      * Uploads logs to the webex services for tracking
      * @param {Object} [options={}]
@@ -642,14 +832,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'
@@ -667,29 +856,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}
@@ -711,9 +885,6 @@ var Meetings = /*#__PURE__*/function (_WebexPlugin) {
   }, {
     key: "startReachability",
     value: function startReachability() {
-      if (!this.reachability) {
-        this.setReachability();
-      }
       return this.getReachability().gatherReachability();
     }
 
@@ -747,6 +918,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();
       });
     }
 
@@ -786,9 +974,12 @@ var Meetings = /*#__PURE__*/function (_WebexPlugin) {
 
     /**
      * Create a meeting.
-     * @param {string} destination - sipURL, spaceId, phonenumber, or locus object}
+     * @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
+     * @param {Boolean} failOnMissingMeetingInfo - whether to throw an error if meeting info fails to fetch (for calls that are not 1:1 or content share)
      * @returns {Promise<Meeting>} A new Meeting.
      * @public
      * @memberof Meetings
@@ -799,6 +990,9 @@ 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;
       // TODO: type should be from a dictionary
 
       // Validate meeting information based on the provided destination and
@@ -808,7 +1002,10 @@ var Meetings = /*#__PURE__*/function (_WebexPlugin) {
       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.
@@ -837,7 +1034,7 @@ 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, correlationId, failOnMissingMeetingInfo).then(function (createdMeeting) {
             // If the meeting was successfully created.
             if (createdMeeting && createdMeeting.on) {
               // Create a destruction event for the meeting.
@@ -889,6 +1086,9 @@ var Meetings = /*#__PURE__*/function (_WebexPlugin) {
      * @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 {String} correlationId the optional specified correlationId
+     * @param {Boolean} failOnMissingMeetingInfo - whether to throw an error if meeting info fails to fetch (for calls that are not 1:1 or content share)
      * @returns {Promise} a new meeting instance complete with meeting info and destination
      * @private
      * @memberof Meetings
@@ -896,9 +1096,12 @@ var Meetings = /*#__PURE__*/function (_WebexPlugin) {
   }, {
     key: "createMeeting",
     value: function () {
-      var _createMeeting = (0, _asyncToGenerator2.default)( /*#__PURE__*/_regenerator.default.mark(function _callee(destination) {
+      var _createMeeting = (0, _asyncToGenerator2.default)( /*#__PURE__*/_regenerator.default.mark(function _callee3(destination) {
         var type,
           useRandomDelayForInfo,
+          infoExtraParams,
+          correlationId,
+          failOnMissingMeetingInfo,
           meeting,
           _destination$fullStat,
           waitingTime,
@@ -910,12 +1113,15 @@ var Meetings = /*#__PURE__*/function (_WebexPlugin) {
           isMeetingActive,
           enableUnifiedMeetings,
           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] : {};
+              correlationId = _args3.length > 4 && _args3[4] !== undefined ? _args3[4] : undefined;
+              failOnMissingMeetingInfo = _args3.length > 5 && _args3[5] !== undefined ? _args3[5] : false;
               meeting = new _meeting.default({
                 // @ts-ignore
                 userId: this.webex.internal.device.userId,
@@ -927,13 +1133,14 @@ var Meetings = /*#__PURE__*/function (_WebexPlugin) {
                 // pass the locus object if present
                 meetingInfoProvider: this.meetingInfo,
                 destination: destination,
-                destinationType: type
+                destinationType: type,
+                correlationId: correlationId
               }, {
                 // @ts-ignore
                 parent: this.webex
               });
               this.meetingCollection.set(meeting);
-              _context.prev = 4;
+              _context3.prev = 7;
               // 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
@@ -950,32 +1157,50 @@ 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;
               if (!(enableUnifiedMeetings && !isMeetingActive && useRandomDelayForInfo && waitingTime > 0)) {
-                _context.next = 14;
+                _context3.next = 17;
                 break;
               }
               meeting.fetchMeetingInfoTimeoutId = setTimeout(function () {
-                return meeting.fetchMeetingInfo({});
+                return meeting.fetchMeetingInfo({
+                  extraParams: infoExtraParams,
+                  sendCAevents: !!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
+                });
               }, waitingTime);
               meeting.parseMeetingInfo(undefined, destination);
-              _context.next = 16;
+              _context3.next = 19;
               break;
-            case 14:
-              _context.next = 16;
-              return meeting.fetchMeetingInfo({});
-            case 16:
-              _context.next = 22;
+            case 17:
+              _context3.next = 19;
+              return meeting.fetchMeetingInfo({
+                extraParams: infoExtraParams,
+                sendCAevents: !!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
+              });
+            case 19:
+              _context3.next = 31;
               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 21:
+              _context3.prev = 21;
+              _context3.t0 = _context3["catch"](7);
+              if (!(!(_context3.t0 instanceof _captchaError.default) && !(_context3.t0 instanceof _passwordError.default) && !(_context3.t0 instanceof _permission.default))) {
+                _context3.next = 30;
+                break;
+              }
+              _loggerProxy.default.logger.info("Meetings:index#createMeeting --> Info Unable to fetch meeting info for ".concat(destination, "."));
+              if (!failOnMissingMeetingInfo) {
+                _context3.next = 29;
+                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 --> Destroying meeting due to missing meeting info.");
+              // @ts-ignore
+              this.destroy(meeting, _constants.MEETING_REMOVED_REASON.MISSING_MEETING_INFO);
+              throw new _noMeetingInfo.default();
+            case 29:
+              // 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 30:
+              _loggerProxy.default.logger.debug("Meetings:index#createMeeting --> Debug ".concat(_context3.t0, " fetching /meetingInfo for creation."));
+            case 31:
+              _context3.prev = 31;
               // 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`
@@ -995,16 +1220,16 @@ var Meetings = /*#__PURE__*/function (_WebexPlugin) {
                   type: meetingAddedType
                 });
               }
-              return _context.finish(22);
-            case 25:
-              return _context.abrupt("return", meeting);
-            case 26:
+              return _context3.finish(31);
+            case 34:
+              return _context3.abrupt("return", meeting);
+            case 35:
             case "end":
-              return _context.stop();
+              return _context3.stop();
           }
-        }, _callee, this, [[4, 18, 22, 25]]);
+        }, _callee3, this, [[7, 21, 31, 34]]);
       }));
-      function createMeeting(_x) {
+      function createMeeting(_x3) {
         return _createMeeting.apply(this, arguments);
       }
       return createMeeting;
@@ -1054,7 +1279,8 @@ var Meetings = /*#__PURE__*/function (_WebexPlugin) {
       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,
@@ -1076,7 +1302,81 @@ var Meetings = /*#__PURE__*/function (_WebexPlugin) {
             }
           }
         }
+      }).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);
     }
 
     /**