@webex/plugin-meetings 3.12.0-next.9 → 3.12.0-next.90

package/dist/locus-info/index.js

@@ -32,9 +32,9 @@ var _defineProperty2 = _interopRequireDefault(require("@babel/runtime-corejs2/he
 var _values = _interopRequireDefault(require("@babel/runtime-corejs2/core-js/object/values"));
 var _assign = _interopRequireDefault(require("@babel/runtime-corejs2/core-js/object/assign"));
 var _map = _interopRequireDefault(require("@babel/runtime-corejs2/core-js/map"));
+var _isArray = _interopRequireDefault(require("@babel/runtime-corejs2/core-js/array/is-array"));
 var _keys = _interopRequireDefault(require("@babel/runtime-corejs2/core-js/object/keys"));
 var _stringify = _interopRequireDefault(require("@babel/runtime-corejs2/core-js/json/stringify"));
-var _isArray = _interopRequireDefault(require("@babel/runtime-corejs2/core-js/array/is-array"));
 var _lodash = require("lodash");
 var _loggerProxy = _interopRequireDefault(require("../common/logs/logger-proxy"));
 var _eventsScope = _interopRequireDefault(require("../common/events/events-scope"));
@@ -53,7 +53,7 @@ var _hashTreeParser2 = _interopRequireWildcard(require("../hashTree/hashTreePars
 var _types = require("../hashTree/types");
 var _utils = require("../hashTree/utils");
 var _util = _interopRequireDefault(require("../meetings/util"));
-function _interopRequireWildcard(e, t) { if ("function" == typeof _WeakMap) var r = new _WeakMap(), n = new _WeakMap(); return (_interopRequireWildcard = function _interopRequireWildcard(e, t) { if (!t && e && e.__esModule) return e; var o, i, f = { __proto__: null, default: e }; if (null === e || "object" != _typeof(e) && "function" != typeof e) return f; if (o = t ? n : r) { if (o.has(e)) return o.get(e); o.set(e, f); } for (var _t2 in e) "default" !== _t2 && {}.hasOwnProperty.call(e, _t2) && ((i = (o = _Object$defineProperty) && _Object$getOwnPropertyDescriptor(e, _t2)) && (i.get || i.set) ? o(f, _t2, i) : f[_t2] = e[_t2]); return f; })(e, t); }
+function _interopRequireWildcard(e, t) { if ("function" == typeof _WeakMap) var r = new _WeakMap(), n = new _WeakMap(); return (_interopRequireWildcard = function _interopRequireWildcard(e, t) { if (!t && e && e.__esModule) return e; var o, i, f = { __proto__: null, default: e }; if (null === e || "object" != _typeof(e) && "function" != typeof e) return f; if (o = t ? n : r) { if (o.has(e)) return o.get(e); o.set(e, f); } for (var _t3 in e) "default" !== _t3 && {}.hasOwnProperty.call(e, _t3) && ((i = (o = _Object$defineProperty) && _Object$getOwnPropertyDescriptor(e, _t3)) && (i.get || i.set) ? o(f, _t3, i) : f[_t3] = e[_t3]); return f; })(e, t); }
 function _callSuper(t, o, e) { return o = (0, _getPrototypeOf2.default)(o), (0, _possibleConstructorReturn2.default)(t, _isNativeReflectConstruct() ? _Reflect$construct(o, e || [], (0, _getPrototypeOf2.default)(t).constructor) : o.apply(t, e)); }
 function _isNativeReflectConstruct() { try { var t = !Boolean.prototype.valueOf.call(_Reflect$construct(Boolean, [], function () {})); } catch (t) {} return (_isNativeReflectConstruct = function _isNativeReflectConstruct() { return !!t; })(); }
 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; }
@@ -76,7 +76,7 @@ var LocusObjectStateAfterUpdates = {
  * Gets the replacement information
  *
  * @param {any} self - "self" object from Locus DTO
- * @param {string} deviceUrl - The URL of the user's device
+ * @param {string} deviceUrl - The URL of the specified device
  * @returns {any} The replace information if available, otherwise undefined
  */
 function getReplaceInfoFromSelf(self, deviceUrl) {
@@ -115,11 +115,13 @@ function findLocusUrlInAnyHashTreeParser(meetingCollection, locusUrl) {
  *
  * @param {HashTreeMessage} message - The hash tree message to find the meeting for
  * @param {MeetingCollection} meetingCollection - The collection of meetings to search
- * @param {string} deviceUrl - The URL of the user's device
  * @returns {any} The meeting if found, otherwise undefined
  */
-function findMeetingForHashTreeMessage(message, meetingCollection, deviceUrl) {
+function findMeetingForHashTreeMessage(message, meetingCollection) {
   var _message$locusStateEl, _message$locusStateEl2;
+  if (!message) {
+    return undefined;
+  }
   var foundMeeting = findLocusUrlInAnyHashTreeParser(meetingCollection, message.locusUrl);
   if (foundMeeting) {
     return foundMeeting;
@@ -130,7 +132,7 @@ function findMeetingForHashTreeMessage(message, meetingCollection, deviceUrl) {
   var self = (_message$locusStateEl = message.locusStateElements) === null || _message$locusStateEl === void 0 ? void 0 : (_message$locusStateEl2 = _message$locusStateEl.find(function (el) {
     return (0, _utils.isSelf)(el);
   })) === null || _message$locusStateEl2 === void 0 ? void 0 : _message$locusStateEl2.data;
-  var replaces = getReplaceInfoFromSelf(self, deviceUrl);
+  var replaces = getReplaceInfoFromSelf(self, self === null || self === void 0 ? void 0 : self.deviceUrl);
   if (replaces !== null && replaces !== void 0 && replaces.locusUrl) {
     foundMeeting = findLocusUrlInAnyHashTreeParser(meetingCollection, replaces.locusUrl);
     return foundMeeting;
@@ -511,7 +513,7 @@ var LocusInfo = exports.default = /*#__PURE__*/function (_EventsScope) {
   }, {
     key: "createHashTreeParser",
     value: function createHashTreeParser(_ref) {
-      var _this$webex$config$me;
+      var _locusUrl$split, _locusUrl$split$pop, _this$webex$config$me;
       var locusUrl = _ref.locusUrl,
         initialLocus = _ref.initialLocus,
         metadata = _ref.metadata,
@@ -521,7 +523,7 @@ var LocusInfo = exports.default = /*#__PURE__*/function (_EventsScope) {
         metadata: metadata,
         webexRequest: this.webex.request.bind(this.webex),
         locusInfoUpdateCallback: this.updateFromHashTree.bind(this, locusUrl),
-        debugId: "HT-".concat(locusUrl.split('/').pop().substring(0, 4)),
+        debugId: "HT-".concat((_locusUrl$split = locusUrl.split('/')) === null || _locusUrl$split === void 0 ? void 0 : (_locusUrl$split$pop = _locusUrl$split.pop()) === null || _locusUrl$split$pop === void 0 ? void 0 : _locusUrl$split$pop.substring(0, 4)),
         excludedDataSets: (_this$webex$config$me = this.webex.config.meetings.locus) === null || _this$webex$config$me === void 0 ? void 0 : _this$webex$config$me.excludedDataSets
       });
 
@@ -558,18 +560,20 @@ var LocusInfo = exports.default = /*#__PURE__*/function (_EventsScope) {
 
     /**
      * @param {Object} data - data to initialize locus info with. It may be from a join or GET /loci response or from a Mercury event that triggers a creation of meeting object
+     * @param {Function} [onLocusSynced] - optional callback that will be called at the end of initial setup, when locus info is fully synced. It will be called with the full locus snapshot as an argument (which may be null if we haven't received any full locus DTOs during the initial setup, for example in case we receive only hash tree messages without full locus DTOs)
      * @returns {undefined}
      * @memberof LocusInfo
      */
   }, {
     key: "initialSetup",
     value: (function () {
-      var _initialSetup = (0, _asyncToGenerator2.default)(/*#__PURE__*/_regenerator.default.mark(function _callee(data) {
+      var _initialSetup = (0, _asyncToGenerator2.default)(/*#__PURE__*/_regenerator.default.mark(function _callee(data, onLocusSynced) {
         var _data$locus, _data$locus$links, _data$locus$links$res, _data$locus$links$res2;
-        var _data$hashTreeMessage, _metadataObject$data, metadataObject, hashTreeParser, _hashTreeParser, _t;
+        var initialFullLocus, _data$hashTreeMessage, _metadataObject$data, metadataObject, hashTreeParser, _hashTreeParser, _t;
         return _regenerator.default.wrap(function (_context) {
           while (1) switch (_context.prev = _context.next) {
             case 0:
+              initialFullLocus = null;
               _t = data.trigger;
               _context.next = _t === 'locus-message' ? 1 : _t === 'join-response' ? 6 : _t === 'get-loci-response' ? 7 : 10;
               break;
@@ -621,6 +625,7 @@ var LocusInfo = exports.default = /*#__PURE__*/function (_EventsScope) {
             case 6:
               this.updateLocusCache(data.locus);
               this.onFullLocus('join response', data.locus, undefined, data.dataSets, data.metadata);
+              initialFullLocus = data.locus;
               return _context.abrupt("continue", 10);
             case 7:
               if (!((_data$locus = data.locus) !== null && _data$locus !== void 0 && (_data$locus$links = _data$locus.links) !== null && _data$locus$links !== void 0 && (_data$locus$links$res = _data$locus$links.resources) !== null && _data$locus$links$res !== void 0 && (_data$locus$links$res2 = _data$locus$links$res.visibleDataSets) !== null && _data$locus$links$res2 !== void 0 && _data$locus$links$res2.url)) {
@@ -646,7 +651,16 @@ var LocusInfo = exports.default = /*#__PURE__*/function (_EventsScope) {
               // "classic" Locus case, no hash trees involved
               this.updateLocusCache(data.locus);
               this.onFullLocus('classic get-loci-response', data.locus, undefined);
+              initialFullLocus = data.locus || null;
             case 10:
+              if (onLocusSynced) {
+                try {
+                  onLocusSynced(initialFullLocus || this.getCurrentLocusSnapshot());
+                } catch (error) {
+                  _loggerProxy.default.logger.warn("Locus-info:index#initialSetup --> onLocusSynced callback failed: ".concat(error));
+                }
+              }
+
               // Change it to true after it receives it first locus object
               this.emitChange = true;
             case 11:
@@ -655,18 +669,40 @@ var LocusInfo = exports.default = /*#__PURE__*/function (_EventsScope) {
           }
         }, _callee, this);
       }));
-      function initialSetup(_x) {
+      function initialSetup(_x, _x2) {
         return _initialSetup.apply(this, arguments);
       }
       return initialSetup;
     }()
+    /**
+     * Builds a full locus DTO snapshot from current internal locus state.
+     *
+     * @returns {LocusDTO}
+     */
+    )
+  }, {
+    key: "getCurrentLocusSnapshot",
+    value: function getCurrentLocusSnapshot() {
+      var _this4 = this;
+      var locus = {};
+      LocusDtoTopLevelKeys.forEach(function (key) {
+        var value = _this4[key];
+        if (value !== undefined && value !== null) {
+          locus[key] = (0, _lodash.cloneDeep)(value);
+        }
+      });
+      if (!(0, _isArray.default)(locus.participants)) {
+        locus.participants = [];
+      }
+      return locus;
+    }
+
     /**
      * Handles HTTP response from Locus API call.
      * @param {Meeting} meeting meeting object
      * @param {LocusApiResponseBody} responseBody body of the http response from Locus API call
      * @returns {void}
      */
-    )
   }, {
     key: "handleLocusAPIResponse",
     value: function handleLocusAPIResponse(meeting, responseBody) {
@@ -674,29 +710,38 @@ var LocusInfo = exports.default = /*#__PURE__*/function (_EventsScope) {
       var isWrapped = 'locus' in responseBody;
       var locusUrl = isWrapped ? (_responseBody$locus = responseBody.locus) === null || _responseBody$locus === void 0 ? void 0 : _responseBody$locus.url : responseBody.url;
       var hashTreeParserEntry = locusUrl && this.hashTreeParsers.get(locusUrl);
-      if (hashTreeParserEntry) {
-        if (isWrapped) {
-          if (!responseBody.dataSets) {
-            this.sendClassicVsHashTreeMismatchMetric(meeting, "expected hash tree dataSets in API response but they are missing");
-            // continuing as we can still manage without responseBody.dataSets, but this is very suspicious
+      var locus = isWrapped ? responseBody.locus : responseBody;
+      if (this.hashTreeParsers.size > 0) {
+        // We are in hash tree mode. Check if we need to create/reactivate a parser for this locusUrl.
+        if (!hashTreeParserEntry || hashTreeParserEntry.parser.state === 'stopped') {
+          if (!locusUrl) {
+            _loggerProxy.default.logger.warn('Locus-info:index#handleLocusAPIResponse --> API response has no locusUrl, cannot handle hash tree parser switch');
+            return;
           }
-          _loggerProxy.default.logger.info('Locus-info:index#handleLocusAPIResponse --> passing Locus API response to HashTreeParser: ', responseBody);
+          this.handleHashTreeParserSwitchForAPIResponse(locusUrl, locus);
+          return;
+        }
+
+        // Active parser found - pass the API response to it
+        if (isWrapped) {
           // update the data in our hash trees
           hashTreeParserEntry.parser.handleLocusUpdate(responseBody);
         } else {
-          // LocusDTO without wrapper - pass it through as if it had no dataSets
+          // LocusDTO without wrapper - pass it through as if it had no dataSets nor metadata
           hashTreeParserEntry.parser.handleLocusUpdate({
             locus: responseBody
           });
         }
-      } else {
-        if (isWrapped && responseBody.dataSets) {
-          this.sendClassicVsHashTreeMismatchMetric(meeting, "unexpected hash tree dataSets in API response");
-        }
-        // classic Locus delta
-        var locus = isWrapped ? responseBody.locus : responseBody;
-        this.handleLocusDelta(locus, meeting);
+        return;
+      }
+
+      // No hash tree parsers - classic Locus mode
+      if (isWrapped && responseBody.dataSets) {
+        this.sendClassicVsHashTreeMismatchMetric(meeting, "unexpected hash tree dataSets in API response");
       }
+
+      // classic Locus delta
+      this.handleLocusDelta(locus, meeting);
     }
 
     /**
@@ -707,7 +752,7 @@ var LocusInfo = exports.default = /*#__PURE__*/function (_EventsScope) {
   }, {
     key: "updateLocusFromHashTreeObject",
     value: function updateLocusFromHashTreeObject(object, locus) {
-      var _this4 = this,
+      var _this5 = this,
         _locus$self;
       var type = object.htMeta.elementId.type.toLowerCase();
       var addParticipantObject = function addParticipantObject(obj) {
@@ -715,7 +760,7 @@ var LocusInfo = exports.default = /*#__PURE__*/function (_EventsScope) {
           locus.participants = [];
         }
         locus.participants.push(obj.data);
-        _this4.hashTreeObjectId2ParticipantId.set(obj.htMeta.elementId.id, obj.data.id);
+        _this5.hashTreeObjectId2ParticipantId.set(obj.htMeta.elementId.id, obj.data.id);
       };
       switch (type) {
         case _types.ObjectType.locus:
@@ -826,10 +871,14 @@ var LocusInfo = exports.default = /*#__PURE__*/function (_EventsScope) {
           if (!object.data) {
             // self without data is handled inside HashTreeParser and results in LocusInfoUpdateType.MEETING_ENDED, so we should never get here
             // all other types info, fullstate, etc - Locus should never send them without data
-            _loggerProxy.default.logger.warn("Locus-info:index#updateLocusFromHashTreeObject --> received ".concat(type, " object without data, this is not expected! version=").concat(object.htMeta.elementId.version));
+            // but we end up with this method being called without the data for them when the main dataset is removed from visible datasets list
+            _loggerProxy.default.logger.info("Locus-info:index#updateLocusFromHashTreeObject --> received ".concat(type, " object without data, version=").concat(object.htMeta.elementId.version));
           } else {
             var _locus$info, _object$data$controls, _object$data$controls2, _object$data$controls3;
             _loggerProxy.default.logger.info("Locus-info:index#updateLocusFromHashTreeObject --> ".concat(type, " object updated to version ").concat(object.htMeta.elementId.version));
+            if (type === _types.ObjectType.self) {
+              _loggerProxy.default.logger.info("Locus-info:index#updateLocusFromHashTreeObject --> self data: removed=".concat(object.data.removed, " state=").concat(object.data.state, " reason=").concat(object.data.reason));
+            }
             var locusDtoKey = _types.ObjectTypeToLocusKeyMap[type];
             locus[locusDtoKey] = object.data;
 
@@ -879,6 +928,81 @@ var LocusInfo = exports.default = /*#__PURE__*/function (_EventsScope) {
       }
     }
 
+    /**
+     * Helper that handles the common logic for reactivating a stopped HashTreeParser when
+     * a newer "replaces" is detected. Used by both the message and API response parser switch methods.
+     *
+     * @param {string} callerName - name of the calling method, used in log messages
+     * @param {string} locusUrl - the locus URL of the stopped parser
+     * @param {HashTreeParserEntry} stoppedEntry - the stopped parser entry
+     * @param {ReplacesInfo} replaces - replacement info extracted from self
+     * @param {Function} resumeCallback - callback to invoke after reactivation to resume the parser
+     * @returns {void}
+     */
+  }, {
+    key: "resumeStoppedParser",
+    value: function resumeStoppedParser(callerName, locusUrl, stoppedEntry, replaces, resumeCallback) {
+      // this check is just for typescript, it should never happen, replaces should always be defined
+      if (!replaces) {
+        _loggerProxy.default.logger.info("Locus-info:index#".concat(callerName, " --> received data for stopped HashTreeParser with locusUrl ").concat(locusUrl, ", but no replaces info provided, so not re-activating the parser"));
+        return;
+      }
+      if (replaces.replacedAt <= (stoppedEntry.replacedAt || '')) {
+        _loggerProxy.default.logger.info("Locus-info:index#".concat(callerName, " --> received data for stopped HashTreeParser with locusUrl ").concat(locusUrl, ", but replaces info provided is not newer, so not re-activating the parser"));
+        return;
+      }
+      _loggerProxy.default.logger.info("Locus-info:index#".concat(callerName, " --> reactivating HashTreeParser for locusUrl=").concat(locusUrl, ", which replaces ").concat(replaces.locusUrl));
+      var replacedEntry = this.hashTreeParsers.get(replaces.locusUrl);
+      if (replacedEntry) {
+        replacedEntry.replacedAt = replaces.replacedAt;
+        replacedEntry.parser.stop();
+      } else {
+        _loggerProxy.default.logger.warn("Locus-info:index#".concat(callerName, " --> the parser that is supposed to be replaced with the currently reactivated parser is not found, locusUrl=").concat(replaces.locusUrl));
+      }
+      stoppedEntry.initializedFromHashTree = false;
+      this.hashTreeObjectId2ParticipantId.clear();
+      resumeCallback();
+    }
+
+    /**
+     * Handles an API response whose locusUrl doesn't match any active HashTreeParser
+     * (either no entry exists, or the existing entry is stopped).
+     * Creates a new parser or reactivates a stopped one using initializeFromGetLociResponse.
+     *
+     * @param {string} locusUrl - the locus URL from the API response
+     * @param {LocusDTO} locus - the locus DTO from the API response
+     * @returns {void}
+     */
+  }, {
+    key: "handleHashTreeParserSwitchForAPIResponse",
+    value: function handleHashTreeParserSwitchForAPIResponse(locusUrl, locus) {
+      var entry = this.hashTreeParsers.get(locusUrl);
+      var replaces = getReplaceInfoFromSelf(locus.self,
+      // @ts-ignore
+      this.webex.internal.device.url);
+      if (!entry) {
+        _loggerProxy.default.logger.info("Locus-info:index#handleHashTreeParserSwitchForAPIResponse --> no parser for locusUrl ".concat(locusUrl, ", creating a new one"));
+        var parser = this.createHashTreeParser({
+          locusUrl: locusUrl,
+          initialLocus: {
+            locus: null,
+            dataSets: []
+          },
+          metadata: null,
+          replacedAt: replaces === null || replaces === void 0 ? void 0 : replaces.replacedAt
+        });
+        parser.initializeFromGetLociResponse(locus);
+        return;
+      }
+      if (entry.parser.state !== 'stopped') {
+        _loggerProxy.default.logger.warn("Locus-info:index#handleHashTreeParserSwitchForAPIResponse --> unexpected parser state \"".concat(entry.parser.state, "\" for locusUrl ").concat(locusUrl));
+        return;
+      }
+      this.resumeStoppedParser('handleHashTreeParserSwitchForAPIResponse', locusUrl, entry, replaces, function () {
+        return entry.parser.resumeFromApiResponse(locus);
+      });
+    }
+
     /**
      * Checks if the hash tree message should trigger a switch to a different HashTreeParser
      *
@@ -903,7 +1027,7 @@ var LocusInfo = exports.default = /*#__PURE__*/function (_EventsScope) {
         var metadata = (_message$locusStateEl5 = message.locusStateElements) === null || _message$locusStateEl5 === void 0 ? void 0 : _message$locusStateEl5.find(function (el) {
           return (0, _utils.isMetadata)(el);
         });
-        if ((metadata === null || metadata === void 0 ? void 0 : (_metadata$data = metadata.data) === null || _metadata$data === void 0 ? void 0 : (_metadata$data$visibl = _metadata$data.visibleDataSets) === null || _metadata$data$visibl === void 0 ? void 0 : _metadata$data$visibl.length) > 0) {
+        if (metadata && ((_metadata$data = metadata.data) === null || _metadata$data === void 0 ? void 0 : (_metadata$data$visibl = _metadata$data.visibleDataSets) === null || _metadata$data$visibl === void 0 ? void 0 : _metadata$data$visibl.length) > 0) {
           _loggerProxy.default.logger.info("Locus-info:index#handleHashTreeParserSwitch --> no hash tree parser found for locusUrl ".concat(message.locusUrl, ", creating a new one"));
           var parser = this.createHashTreeParser({
             locusUrl: message.locusUrl,
@@ -926,25 +1050,9 @@ var LocusInfo = exports.default = /*#__PURE__*/function (_EventsScope) {
       if (entry.parser.state === 'stopped') {
         // the message matches a stopped parser, we need to check if maybe this is a new "replacement" and we need to re-activate the parser
         // this happens when you move from breakout A -> breakout B -> back to breakout A
-        if (replaces) {
-          if (replaces.replacedAt > (entry.replacedAt || '')) {
-            _loggerProxy.default.logger.info("Locus-info:index#handleHashTreeParserSwitch --> resuming a HashTreeParser for locusUrl=".concat(message.locusUrl, ", which replaces ").concat(replaces.locusUrl));
-            var replacedEntry = this.hashTreeParsers.get(replaces.locusUrl);
-            if (replacedEntry) {
-              replacedEntry.replacedAt = replaces.replacedAt;
-              entry.initializedFromHashTree = false;
-              this.hashTreeObjectId2ParticipantId.clear();
-              replacedEntry.parser.stop();
-              entry.parser.resume(message);
-            } else {
-              _loggerProxy.default.logger.warn("Locus-info:index#handleHashTreeParserSwitch --> the parser that is supposed to be replaced with the currently resumed parser is not found, locusUrl=".concat(replaces.locusUrl));
-            }
-          } else {
-            _loggerProxy.default.logger.info("Locus-info:index#handleHashTreeParserSwitch --> received message for stopped HashTreeParser with locusUrl ".concat(message.locusUrl, ", but replaces info provided is not newer, so not re-activating the parser"));
-          }
-          return true;
-        }
-        _loggerProxy.default.logger.info("Locus-info:index#handleHashTreeParserSwitch --> received message for stopped HashTreeParser with locusUrl ".concat(message.locusUrl, ", but no replaces info provided, so not re-activating the parser"));
+        this.resumeStoppedParser('handleHashTreeParserSwitch', message.locusUrl, entry, replaces, function () {
+          return entry.parser.resumeFromMessage(message);
+        });
         return true;
       }
       return false;
@@ -970,23 +1078,90 @@ var LocusInfo = exports.default = /*#__PURE__*/function (_EventsScope) {
         return;
       }
       var entry = this.hashTreeParsers.get(message.locusUrl);
-      entry.parser.handleMessage(message);
+
+      // the check is just for typescript, the case of no entry in hashTreeParsers is handled in handleHashTreeParserSwitch() above
+      if (entry) {
+        entry.parser.handleMessage(message);
+      }
     }
 
+    /**
+     * Triggers a sync of all hash tree datasets for all hash tree parsers associated with this meeting.
+     * The syncs are executed sequentially within each parser.
+     *
+     * @param {Object} [options={}] - Options for syncing
+     * @param {boolean} [options.onlyLLM=false] - Whether to sync only LLM based data sets
+     * @returns {Promise<void>}
+     */
+  }, {
+    key: "syncAllHashTreeDatasets",
+    value: (function () {
+      var _syncAllHashTreeDatasets = (0, _asyncToGenerator2.default)(/*#__PURE__*/_regenerator.default.mark(function _callee2() {
+        var options,
+          _iterator3,
+          _step3,
+          _step3$value,
+          entry,
+          _args2 = arguments,
+          _t2;
+        return _regenerator.default.wrap(function (_context2) {
+          while (1) switch (_context2.prev = _context2.next) {
+            case 0:
+              options = _args2.length > 0 && _args2[0] !== undefined ? _args2[0] : {};
+              _iterator3 = _createForOfIteratorHelper(this.hashTreeParsers);
+              _context2.prev = 1;
+              _iterator3.s();
+            case 2:
+              if ((_step3 = _iterator3.n()).done) {
+                _context2.next = 4;
+                break;
+              }
+              _step3$value = (0, _slicedToArray2.default)(_step3.value, 2), entry = _step3$value[1];
+              if (!entry.parser) {
+                _context2.next = 3;
+                break;
+              }
+              _context2.next = 3;
+              return entry.parser.syncAllDatasets(options);
+            case 3:
+              _context2.next = 2;
+              break;
+            case 4:
+              _context2.next = 6;
+              break;
+            case 5:
+              _context2.prev = 5;
+              _t2 = _context2["catch"](1);
+              _iterator3.e(_t2);
+            case 6:
+              _context2.prev = 6;
+              _iterator3.f();
+              return _context2.finish(6);
+            case 7:
+            case "end":
+              return _context2.stop();
+          }
+        }, _callee2, this, [[1, 5, 6, 7]]);
+      }));
+      function syncAllHashTreeDatasets() {
+        return _syncAllHashTreeDatasets.apply(this, arguments);
+      }
+      return syncAllHashTreeDatasets;
+    }()
     /**
      * Callback registered with HashTreeParser to receive locus info updates.
      * Updates our locus info based on the data parsed by the hash tree parser.
      *
      * @param {string} locusUrl - the locus URL for which the update is received
-     * @param {LocusInfoUpdateType} updateType - The type of update received.
-     * @param {Object} [data] - Additional data for the update, if applicable.
+     * @param {LocusInfoUpdate} update - Details about the update.
      * @returns {void}
      */
+    )
   }, {
     key: "updateFromHashTree",
-    value: function updateFromHashTree(locusUrl, updateType, data) {
-      var _this5 = this;
-      switch (updateType) {
+    value: function updateFromHashTree(locusUrl, update) {
+      var _this6 = this;
+      switch (update.updateType) {
         case _hashTreeParser2.LocusInfoUpdateType.OBJECTS_UPDATED:
           {
             // initialize our new locus
@@ -1000,7 +1175,7 @@ var LocusInfo = exports.default = /*#__PURE__*/function (_EventsScope) {
 
             // first go over all the updates and check what happens with the main locus object
             var locusObjectStateAfterUpdates = LocusObjectStateAfterUpdates.unchanged;
-            data.updatedObjects.forEach(function (object) {
+            update.updatedObjects.forEach(function (object) {
               if (object.htMeta.elementId.type.toLowerCase() === _types.ObjectType.locus) {
                 if (locusObjectStateAfterUpdates === LocusObjectStateAfterUpdates.updated) {
                   var _object$data;
@@ -1009,7 +1184,7 @@ var LocusInfo = exports.default = /*#__PURE__*/function (_EventsScope) {
                   // but these should never happen
                   _loggerProxy.default.logger.warn("Locus-info:index#updateFromHashTree --> received multiple LOCUS objects in one update, this is unexpected!");
                   _metrics.default.sendBehavioralMetric(_constants2.default.LOCUS_HASH_TREE_UNSUPPORTED_OPERATION, {
-                    locusUrl: ((_object$data = object.data) === null || _object$data === void 0 ? void 0 : _object$data.url) || _this5.url,
+                    locusUrl: ((_object$data = object.data) === null || _object$data === void 0 ? void 0 : _object$data.url) || _this6.url,
                     message: object.data ? 'multiple LOCUS object updates' : 'LOCUS object update followed by removal'
                   });
                 }
@@ -1021,12 +1196,17 @@ var LocusInfo = exports.default = /*#__PURE__*/function (_EventsScope) {
               }
             });
             var hashTreeParserEntry = this.hashTreeParsers.get(locusUrl);
+            if (!hashTreeParserEntry) {
+              _loggerProxy.default.logger.warn("Locus-info:index#updateFromHashTree --> no HashTreeParser found for locusUrl ".concat(locusUrl, " when trying to apply updates from hash tree"));
+              return;
+            }
             if (!hashTreeParserEntry.initializedFromHashTree) {
               // this is the first time we're getting an update for this locusUrl,
               // so it's probably a move to/from breakout. We need to start from a clean state,
               // so empty locus and we rely on Locus giving us sufficient data in the updates to populate it.
               _loggerProxy.default.logger.info("Locus-info:index#updateFromHashTree --> first INITIAL update for locusUrl ".concat(locusUrl, ", starting from empty state"));
               hashTreeParserEntry.initializedFromHashTree = true;
+              // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
               locus.jsSdkMeta.forceReplaceMembers = true;
             } else if (
             // if Locus object is unchanged or removed, we need to keep using the existing locus
@@ -1038,7 +1218,7 @@ var LocusInfo = exports.default = /*#__PURE__*/function (_EventsScope) {
               // copy over all of existing locus except participants
               LocusDtoTopLevelKeys.forEach(function (key) {
                 if (key !== 'participants') {
-                  locus[key] = (0, _lodash.cloneDeep)(_this5[key]);
+                  locus[key] = (0, _lodash.cloneDeep)(_this6[key]);
                 }
               });
             } else {
@@ -1046,11 +1226,11 @@ var LocusInfo = exports.default = /*#__PURE__*/function (_EventsScope) {
               // (except participants, which need to stay empty - that means "no participant changes")
               (0, _values.default)(_types.ObjectTypeToLocusKeyMap).forEach(function (locusDtoKey) {
                 if (locusDtoKey !== 'participants') {
-                  locus[locusDtoKey] = (0, _lodash.cloneDeep)(_this5[locusDtoKey]);
+                  locus[locusDtoKey] = (0, _lodash.cloneDeep)(_this6[locusDtoKey]);
                 }
               });
             }
-            _loggerProxy.default.logger.info("Locus-info:index#updateFromHashTree --> LOCUS object is ".concat(locusObjectStateAfterUpdates, ", all updates: ").concat((0, _stringify.default)(data.updatedObjects.map(function (o) {
+            _loggerProxy.default.logger.info("Locus-info:index#updateFromHashTree --> LOCUS object is ".concat(locusObjectStateAfterUpdates, ", all updates: ").concat((0, _stringify.default)(update.updatedObjects.map(function (o) {
               return {
                 type: o.htMeta.elementId.type,
                 id: o.htMeta.elementId.id,
@@ -1058,8 +1238,8 @@ var LocusInfo = exports.default = /*#__PURE__*/function (_EventsScope) {
               };
             }))));
             // now apply all the updates from the hash tree onto the locus
-            data.updatedObjects.forEach(function (object) {
-              locus = _this5.updateLocusFromHashTreeObject(object, locus);
+            update.updatedObjects.forEach(function (object) {
+              locus = _this6.updateLocusFromHashTreeObject(object, locus);
             });
 
             // update our locus info with the new locus
@@ -1073,6 +1253,18 @@ var LocusInfo = exports.default = /*#__PURE__*/function (_EventsScope) {
               _loggerProxy.default.logger.info("Locus-info:index#updateFromHashTree --> received signal that meeting ended, destroying meeting ".concat(this.meetingId));
               this.webex.meetings.destroy(meeting, _constants.MEETING_REMOVED_REASON.SELF_REMOVED);
             }
+            break;
+          }
+        case _hashTreeParser2.LocusInfoUpdateType.LOCUS_NOT_FOUND:
+          {
+            _loggerProxy.default.logger.info("Locus-info:index#updateFromHashTree --> received LOCUS_NOT_FOUND for ".concat(locusUrl, ", triggering syncMeetings"));
+            this.webex.meetings.syncMeetings({
+              keepOnlyLocusMeetings: false,
+              skipHashTreeSync: true
+            }).catch(function (syncError) {
+              _loggerProxy.default.logger.error("Locus-info:index#updateFromHashTree --> syncMeetings failed after LOCUS_NOT_FOUND: ".concat(syncError));
+            });
+            break;
           }
       }
     }
@@ -1087,7 +1279,13 @@ var LocusInfo = exports.default = /*#__PURE__*/function (_EventsScope) {
     key: "parse",
     value: function parse(meeting, data) {
       if (this.hashTreeParsers.size > 0) {
-        this.handleHashTreeMessage(meeting, data.eventType, data.stateElementsMessage);
+        if (data.eventType === _constants.LOCUSEVENT.SDK_LOCUS_FROM_SYNC_MEETINGS) {
+          // sync meetings response follows the format of "not wrapped" locus API responses,
+          // so has no dataSets nor Metadata
+          this.handleLocusAPIResponse(meeting, _objectSpread({}, data.locus));
+        } else {
+          this.handleHashTreeMessage(meeting, data.eventType, data.stateElementsMessage);
+        }
       } else {
         var eventType = data.eventType;
         if (eventType === _constants.LOCUSEVENT.HASH_TREE_DATA_UPDATED) {
@@ -1148,13 +1346,13 @@ var LocusInfo = exports.default = /*#__PURE__*/function (_EventsScope) {
      * @param {string} debugText string explaining the trigger for this call, added to logs for debugging purposes
      * @param {object} locus locus object
      * @param {object} metadata locus hash trees metadata
-     * @param {string} eventType locus event
      * @param {DataSet[]} dataSets
+     * @param {string} eventType locus event
      * @returns {void}
      */
   }, {
     key: "onFullLocusWithHashTrees",
-    value: function onFullLocusWithHashTrees(debugText, locus, metadata, eventType, dataSets) {
+    value: function onFullLocusWithHashTrees(debugText, locus, metadata, dataSets, eventType) {
       if (!this.hashTreeParsers.has(locus.url)) {
         _loggerProxy.default.logger.info("Locus-info:index#onFullLocus (".concat(debugText, ") --> creating hash tree parser for locusUrl=").concat(locus.url));
         _loggerProxy.default.logger.info("Locus-info:index#onFullLocus (".concat(debugText, ") --> dataSets:"), dataSets, ' and locus:', locus, ' and metadata:', metadata);
@@ -1167,6 +1365,7 @@ var LocusInfo = exports.default = /*#__PURE__*/function (_EventsScope) {
           metadata: metadata
         });
         // we have a full locus to start with, so we consider Locus info to be "initialized"
+        // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
         this.hashTreeParsers.get(locus.url).initializedFromHashTree = true;
         this.onFullLocusCommon(locus, eventType);
       } else {
@@ -1221,7 +1420,7 @@ var LocusInfo = exports.default = /*#__PURE__*/function (_EventsScope) {
           throw new Error("Locus-info:index#onFullLocus (".concat(debugText, ") --> hash tree metadata is missing with full Locus"));
         }
         // this is the new hashmap Locus DTO format (only applicable to webinars for now)
-        this.onFullLocusWithHashTrees(debugText, locus, metadata, eventType, dataSets);
+        this.onFullLocusWithHashTrees(debugText, locus, metadata, dataSets, eventType);
       } else {
         this.onFullLocusClassic(debugText, locus, eventType);
       }
@@ -1237,7 +1436,7 @@ var LocusInfo = exports.default = /*#__PURE__*/function (_EventsScope) {
     key: "onFullLocusCommon",
     value: function onFullLocusCommon(locus, eventType) {
       var _this$participants,
-        _this6 = this,
+        _this7 = this,
         _locus$jsSdkMeta;
       this.scheduledMeeting = locus.meeting || null;
       this.participants = locus.participants;
@@ -1245,7 +1444,7 @@ var LocusInfo = exports.default = /*#__PURE__*/function (_EventsScope) {
         var _participant$htMeta;
         // participant.htMeta is set only for hash tree based locus
         if (typeof ((_participant$htMeta = participant.htMeta) === null || _participant$htMeta === void 0 ? void 0 : _participant$htMeta.elementId.id) === 'number') {
-          _this6.hashTreeObjectId2ParticipantId.set(participant.htMeta.elementId.id, participant.id);
+          _this7.hashTreeObjectId2ParticipantId.set(participant.htMeta.elementId.id, participant.id);
         }
       });
       var isReplaceMembers = _controlsUtils.default.isNeedReplaceMembers(this.controls, locus.controls);
@@ -1353,8 +1552,7 @@ var LocusInfo = exports.default = /*#__PURE__*/function (_EventsScope) {
   }, {
     key: "updateLocusInfo",
     value: function updateLocusInfo(locus) {
-      var _locus$self2, _locus$self3;
-      if (((_locus$self2 = locus.self) === null || _locus$self2 === void 0 ? void 0 : _locus$self2.reason) === 'MOVED' && ((_locus$self3 = locus.self) === null || _locus$self3 === void 0 ? void 0 : _locus$self3.state) === 'LEFT') {
+      if (_util.default.isSelfMovedOrBreakoutEnded(locus)) {
         // When moved to a breakout session locus sends a message for the previous locus
         // indicating that we have been moved. It isn't helpful to continue parsing this
         // as it gets interpreted as if we have left the call
@@ -1474,10 +1672,8 @@ var LocusInfo = exports.default = /*#__PURE__*/function (_EventsScope) {
           });
         }
       } else if (((_this$parsedLocus$ful6 = this.parsedLocus.fullState) === null || _this$parsedLocus$ful6 === void 0 ? void 0 : _this$parsedLocus$ful6.type) === _constants._MEETING_) {
-        if (this.fullState && (this.fullState.state === _constants.LOCUS.STATE.INACTIVE ||
-        // @ts-ignore
-        this.fullState.state === _constants.LOCUS.STATE.TERMINATING)) {
-          _loggerProxy.default.logger.warn('Locus-info:index#isMeetingActive --> Meeting is ending due to inactive or terminating');
+        if (this.fullState && _util.default.isWholeMeetingEnded(this.fullState)) {
+          _loggerProxy.default.logger.warn('Locus-info:index#isMeetingActive --> Meeting is ending due to inactive');
 
           // @ts-ignore
           this.webex.internal.newMetrics.submitClientEvent({
@@ -1579,11 +1775,11 @@ var LocusInfo = exports.default = /*#__PURE__*/function (_EventsScope) {
         isReplace: isReplace
       });
       if (participants && (0, _isArray.default)(participants) && participants.length > 0) {
-        var _iterator3 = _createForOfIteratorHelper(participants),
-          _step3;
+        var _iterator4 = _createForOfIteratorHelper(participants),
+          _step4;
         try {
-          for (_iterator3.s(); !(_step3 = _iterator3.n()).done;) {
-            var participant = _step3.value;
+          for (_iterator4.s(); !(_step4 = _iterator4.n()).done;) {
+            var participant = _step4.value;
             if (participant && (participant === null || participant === void 0 ? void 0 : participant.reason) === 'FAILURE') {
               var _participant$person;
               this.emitScoped({
@@ -1595,9 +1791,9 @@ var LocusInfo = exports.default = /*#__PURE__*/function (_EventsScope) {
             }
           }
         } catch (err) {
-          _iterator3.e(err);
+          _iterator4.e(err);
         } finally {
-          _iterator3.f();
+          _iterator4.f();
         }
       }
     }
@@ -1718,7 +1914,9 @@ var LocusInfo = exports.default = /*#__PURE__*/function (_EventsScope) {
           }, _constants.LOCUSINFO.EVENTS.CONTROLS_RECORDING_UPDATED, {
             state: state,
             modifiedBy: current.record.modifiedBy,
-            lastModified: current.record.lastModified
+            lastModified: current.record.lastModified,
+            modifiedByServiceAppName: current.record.modifiedByServiceAppName,
+            modifiedByServiceAppId: current.record.modifiedByServiceAppId
           });
         }
         if (hasMeetingContainerChanged) {
@@ -2243,12 +2441,14 @@ var LocusInfo = exports.default = /*#__PURE__*/function (_EventsScope) {
           });
         }
         if (parsedSelves.updates.isMutedByOthersChanged) {
+          var _parsedSelves$current2;
           this.emitScoped({
             file: 'locus-info',
             function: 'updateSelf'
           }, _constants.LOCUSINFO.EVENTS.SELF_REMOTE_MUTE_STATUS_UPDATED, {
             muted: parsedSelves.current.remoteMuted,
-            unmuteAllowed: parsedSelves.current.unmuteAllowed
+            unmuteAllowed: parsedSelves.current.unmuteAllowed,
+            modifiedBy: (_parsedSelves$current2 = parsedSelves.current.modifiedBy) !== null && _parsedSelves$current2 !== void 0 ? _parsedSelves$current2 : null
           });
         }
         if (parsedSelves.updates.localAudioUnmuteRequestedByServer) {
@@ -2278,14 +2478,14 @@ var LocusInfo = exports.default = /*#__PURE__*/function (_EventsScope) {
           _constants.LOCUSINFO.EVENTS.MEDIA_INACTIVITY, _selfUtils.default.getMediaStatus(self.mediaSessions));
         }
         if (parsedSelves.updates.audioStateChange || parsedSelves.updates.videoStateChange || parsedSelves.updates.shareStateChange) {
-          var _parsedSelves$current2, _parsedSelves$current3, _parsedSelves$current4;
+          var _parsedSelves$current3, _parsedSelves$current4, _parsedSelves$current5;
           this.emitScoped({
             file: 'locus-info',
             function: 'updateSelf'
           }, _constants.LOCUSINFO.EVENTS.MEDIA_STATUS_CHANGE, {
-            audioStatus: (_parsedSelves$current2 = parsedSelves.current.currentMediaStatus) === null || _parsedSelves$current2 === void 0 ? void 0 : _parsedSelves$current2.audio,
-            videoStatus: (_parsedSelves$current3 = parsedSelves.current.currentMediaStatus) === null || _parsedSelves$current3 === void 0 ? void 0 : _parsedSelves$current3.video,
-            shareStatus: (_parsedSelves$current4 = parsedSelves.current.currentMediaStatus) === null || _parsedSelves$current4 === void 0 ? void 0 : _parsedSelves$current4.share
+            audioStatus: (_parsedSelves$current3 = parsedSelves.current.currentMediaStatus) === null || _parsedSelves$current3 === void 0 ? void 0 : _parsedSelves$current3.audio,
+            videoStatus: (_parsedSelves$current4 = parsedSelves.current.currentMediaStatus) === null || _parsedSelves$current4 === void 0 ? void 0 : _parsedSelves$current4.video,
+            shareStatus: (_parsedSelves$current5 = parsedSelves.current.currentMediaStatus) === null || _parsedSelves$current5 === void 0 ? void 0 : _parsedSelves$current5.share
           });
         }
         if (parsedSelves.updates.isUserObserving) {
@@ -2467,7 +2667,7 @@ var LocusInfo = exports.default = /*#__PURE__*/function (_EventsScope) {
   }, {
     key: "updateMainSessionLocusCache",
     value: function updateMainSessionLocusCache(mainLocus) {
-      var _this7 = this;
+      var _this8 = this;
       if (!mainLocus) {
         return;
       }
@@ -2476,7 +2676,7 @@ var LocusInfo = exports.default = /*#__PURE__*/function (_EventsScope) {
         // shallow merge and do special merge for participants
         (0, _lodash.assignWith)(this.mainSessionLocusCache, locusClone, function (objValue, srcValue, key) {
           if (key === 'participants') {
-            return _this7.mergeParticipants(objValue, srcValue);
+            return _this8.mergeParticipants(objValue, srcValue);
           }
           return srcValue || objValue;
         });
@@ -2495,6 +2695,21 @@ var LocusInfo = exports.default = /*#__PURE__*/function (_EventsScope) {
     value: function clearMainSessionLocusCache() {
       this.mainSessionLocusCache = null;
     }
+
+    /**
+     * Cleans up all hash tree parsers and clears internal maps.
+     * @returns {void}
+     * @memberof LocusInfo
+     */
+  }, {
+    key: "cleanUp",
+    value: function cleanUp() {
+      this.hashTreeParsers.forEach(function (entry) {
+        entry.parser.cleanUp();
+      });
+      this.hashTreeParsers.clear();
+      this.hashTreeObjectId2ParticipantId.clear();
+    }
   }]);
 }(_eventsScope.default);
 //# sourceMappingURL=index.js.map