@webex/plugin-meetings 3.9.0-webinar5k.1 → 3.10.0

package/src/locus-info/index.ts

@@ -1,4 +1,3 @@
-/* eslint-disable class-methods-use-this */
 import {isEqual, assignWith, cloneDeep, isEmpty, forEach} from 'lodash';
 
 import LoggerProxy from '../common/logs/logger-proxy';
@@ -31,21 +30,6 @@ import MediaSharesUtils from './mediaSharesUtils';
 import LocusDeltaParser from './parser';
 import Metrics from '../metrics';
 import BEHAVIORAL_METRICS from '../metrics/constants';
-import HashTreeParser, {
-  DataSet,
-  HashTreeMessage,
-  HashTreeObject,
-  HtMeta,
-  LocusInfoUpdateType,
-  ObjectType,
-} from '../hashTree/hashTreeParser';
-
-export type LocusLLMEvent = {
-  data: {
-    eventType: 'locus.state_message';
-    stateElementsMessage: HashTreeMessage;
-  };
-};
 
 export type LocusDTO = {
   controls?: any;
@@ -67,11 +51,7 @@ export type LocusDTO = {
     name: string;
     orgId: string;
   };
-  htMeta?: HtMeta;
   info?: any;
-  jsSdkMeta?: {
-    removedParticipantIds: string[]; // list of ids of participants that are removed in the last update
-  };
   links?: any;
   mediaShares?: any[];
   meetings?: any[];
@@ -93,26 +73,9 @@ export type LocusDTO = {
 };
 
 export type LocusApiResponseBody = {
-  dataSets?: DataSet[];
   locus: LocusDTO; // this LocusDTO here might not be the full one (for example it won't have all the participants, but it should have self)
 };
 
-const LocusDtoTopLevelKeys = [
-  'controls',
-  'fullState',
-  'host',
-  'info',
-  'links',
-  'mediaShares',
-  'meetings',
-  'participants',
-  'replaces',
-  'self',
-  'sequence',
-  'syncUrl',
-  'url',
-];
-
 /**
  * @description LocusInfo extends ChildEmitter to convert locusInfo info a private emitter to parent object
  * @export
@@ -130,7 +93,6 @@ export default class LocusInfo extends EventsScope {
   aclUrl: any;
   baseSequence: any;
   created: any;
-  deltaParticipants: any;
   identities: any;
   membership: any;
   participants: any;
@@ -152,9 +114,6 @@ export default class LocusInfo extends EventsScope {
   resources: any;
   mainSessionLocusCache: any;
   self: any;
-  hashTreeParser?: HashTreeParser;
-  hashTreeObjectId2ParticipantId: Map<number, string>; // mapping of hash tree object ids to participant ids
-
   /**
    * Constructor
    * @param {function} updateMeeting callback to update the meeting object from an object
@@ -173,26 +132,32 @@ export default class LocusInfo extends EventsScope {
     this.meetingId = meetingId;
     this.updateMeeting = updateMeeting;
     this.locusParser = new LocusDeltaParser();
-    this.hashTreeObjectId2ParticipantId = new Map();
   }
 
   /**
    * Does a Locus sync. It tries to get the latest delta DTO or if it can't, it falls back to getting the full Locus DTO.
    *
    * @param {Meeting} meeting
+   * @param {boolean} isLocusUrlChanged
+   * @param {Locus} locus
    * @returns {undefined}
    */
-  private doLocusSync(meeting: any) {
-    let isDelta;
+  private doLocusSync(meeting: any, isLocusUrlChanged: boolean, locus: any) {
     let url;
+    let isDelta = false;
     let meetingDestroyed = false;
 
-    if (this.locusParser.workingCopy.syncUrl) {
+    if (isLocusUrlChanged) {
+      // for the locus url changed case from breakout to main session, we should always do a full sync, in this case, the url from locus is always on main session,
+      // so use the main session locus url to get the full locus(full participants list in the response).
+      // for the locus url changed case from main session to breakout, we don't need to care about it here,
+      // because it is a USE_INCOMING case, it will not be executed here.
+      url = locus.url;
+    } else if (this.locusParser.workingCopy?.syncUrl) {
       url = this.locusParser.workingCopy.syncUrl;
       isDelta = true;
     } else {
       url = meeting.locusUrl;
-      isDelta = false;
     }
 
     LoggerProxy.logger.info(
@@ -261,7 +226,7 @@ export default class LocusInfo extends EventsScope {
 
         if (isDelta) {
           if (res.body.baseSequence) {
-            meeting.locusInfo.handleLocusDelta(res.body, meeting); // todo: check if this is safe, is isDelta=true always only for non-hash tree locus
+            meeting.locusInfo.handleLocusDelta(res.body, meeting);
 
             return;
           }
@@ -304,6 +269,7 @@ export default class LocusInfo extends EventsScope {
    */
   applyLocusDeltaData(action: string, locus: any, meeting: any) {
     const {DESYNC, USE_CURRENT, USE_INCOMING, WAIT, LOCUS_URL_CHANGED} = LocusDeltaParser.loci;
+    const isLocusUrlChanged = action === LOCUS_URL_CHANGED;
 
     switch (action) {
       case USE_INCOMING:
@@ -315,7 +281,7 @@ export default class LocusInfo extends EventsScope {
         break;
       case DESYNC:
       case LOCUS_URL_CHANGED:
-        this.doLocusSync(meeting);
+        this.doLocusSync(meeting, isLocusUrlChanged, locus);
         break;
       default:
         LoggerProxy.logger.info(
@@ -370,17 +336,6 @@ export default class LocusInfo extends EventsScope {
      * @property {Object} person - Contains person data.
      */
 
-    /**
-     * Stored participant changes between the last event and the current event.
-     * All previously stored events are overwritten between events.
-     *
-     * @instance
-     * @type {Array<DeltaParticipant>}
-     * @private
-     * @member LocusInfo
-     */
-    this.deltaParticipants = [];
-
     this.updateLocusCache(locus);
     // above section only updates the locusInfo object
     // The below section makes sure it updates the locusInfo as well as updates the meeting object
@@ -388,7 +343,7 @@ export default class LocusInfo extends EventsScope {
     // For 1:1 space meeting the conversation Url does not exist in locus.conversation
     this.updateConversationUrl(locus.conversationUrl, locus.info);
     this.updateControls(locus.controls, locus.self);
-    this.updateLocusUrl(locus.url);
+    this.updateLocusUrl(locus.url, ControlsUtils.isMainSessionDTO(locus));
     this.updateFullState(locus.fullState);
     this.updateMeetingInfo(locus.info);
     this.updateEmbeddedApps(locus.embeddedApps);
@@ -402,188 +357,25 @@ export default class LocusInfo extends EventsScope {
 
   /**
    * @param {Object} locus
-   * @param {DataSet[]} [dataSets=[]] - Array of data sets
    * @returns {undefined}
    * @memberof LocusInfo
    */
-  initialSetup(locus: object, dataSets: DataSet[] = []) {
+  initialSetup(locus: object) {
     this.updateLocusCache(locus);
-    this.onFullLocus(locus, undefined, dataSets);
+    this.onFullLocus(locus);
 
     // Change it to true after it receives it first locus object
     this.emitChange = true;
   }
 
   /**
-   *
-   * @param {HashTreeObject} object data set object
-   * @param {any} locus
-   * @returns {void}
-   */
-  updateHashTreeObjectInLocus(object: HashTreeObject, locus: LocusDTO): LocusDTO {
-    const type = object.htMeta.elementId.type.toLowerCase();
-
-    switch (type) {
-      case ObjectType.locus: {
-        if (!object.data) {
-          LoggerProxy.logger.warn(
-            `Locus-info:index#updateHashTreeObjectInLocus --> received LOCUS object without data, this is not supported!`
-          );
-
-          return locus;
-        }
-        // replace the main locus
-
-        // The Locus object from MAIN dataset has empty participants, so removing them to avoid it overriding the ones in our current locus object
-        // Also, it doesn't have "self". That's OK as it won't override existing locus.self and also existing SDK code can handle that missing self in Locus updates
-        const locusObjectFromData = object.data;
-        delete locusObjectFromData.participants;
-
-        locus = {...locus, ...locusObjectFromData};
-        locus.htMeta = object.htMeta;
-        break;
-      }
-      case ObjectType.participant:
-        LoggerProxy.logger.info(
-          `Locus-info:index#updateHashTreeObjectInLocus --> participant id=${
-            object.htMeta.elementId.id
-          } ${object.data ? 'updated' : 'removed'}`
-        );
-        console.log(
-          'marcin: hashTreeObjectId2ParticipantId=',
-          cloneDeep(this.hashTreeObjectId2ParticipantId)
-        );
-        if (object.data) {
-          if (!locus.participants) {
-            locus.participants = [];
-          }
-          const participantObject = object.data;
-          participantObject.htMeta = object.htMeta;
-          locus.participants.push(participantObject);
-          this.hashTreeObjectId2ParticipantId.set(object.htMeta.elementId.id, participantObject.id);
-        } else {
-          const participantId = this.hashTreeObjectId2ParticipantId.get(object.htMeta.elementId.id);
-
-          if (!locus.jsSdkMeta) {
-            locus.jsSdkMeta = {removedParticipantIds: []};
-          }
-          locus.jsSdkMeta.removedParticipantIds.push(participantId);
-          this.hashTreeObjectId2ParticipantId.delete(object.htMeta.elementId.id);
-        }
-        break;
-      case ObjectType.self:
-        if (!object.data) {
-          LoggerProxy.logger.warn(
-            `Locus-info:index#updateHashTreeObjectInLocus --> received SELF object without data, this is not supported!`
-          );
-
-          return locus;
-        }
-        locus.self = object.data;
-        break;
-    }
-
-    return locus;
-  }
-
-  /**
-   * Handles HTTP response from Locus API call when hash tree update.
+   * Handles HTTP response from Locus API call.
    * @param {Meeting} meeting meeting object
-   * @param {LocusApiResponseBody} responseBody body of the http reponse from Locus API call
+   * @param {LocusApiResponseBody} responseBody body of the http response from Locus API call
    * @returns {void}
    */
   handleLocusAPIResponse(meeting, responseBody: LocusApiResponseBody): void {
-    console.log('marcin: locus response from API call:', responseBody);
-    if (responseBody.dataSets) {
-      if (!this.hashTreeParser) {
-        LoggerProxy.logger.warn(
-          `Locus-info:index#handleLocusAPIResponse --> received response with hash tree info from Locus API, but we don't have the hashTreeParser created`
-        );
-
-        return;
-      }
-      // Locus is using the new hash tree mechanism
-      // so update our data in the hash tree parser
-      this.hashTreeParser.handleLocusUpdate(responseBody);
-
-      // but the Locus object we receive in this case looks same like classic delta, so we can use existing delta method to process it
-      this.onDeltaLocus(responseBody.locus);
-    } else {
-      // classic Locus delta
-      this.handleLocusDelta(responseBody.locus, meeting);
-    }
-  }
-
-  /**
-   * Handles a hash tree message received from Locus.
-   *
-   * @param {Meeting} meeting - The meeting object
-   * @param {HashTreeMessage} message incoming hash tree message
-   * @returns {void}
-   */
-  private handleHashTreeMessage(meeting: any, message: HashTreeMessage) {
-    if (!this.hashTreeParser) {
-      LoggerProxy.logger.warn(
-        `Locus-info:index#handleHashTreeMessage --> received hash tree message, but we don't have the hashTreeParser`
-      );
-
-      return;
-    }
-    if (message.locusStateElements === undefined) {
-      // todo: need to see in practice how exactly the heartbeat messages look like
-      this.hashTreeParser.handleRootHashHeartBeatMessage(message);
-    } else {
-      this.hashTreeParser.handleMessage(message);
-    }
-  }
-
-  /**
-   * Updates our locus info based on the data parsed by the hash tree parser.
-   *
-   * @param {LocusInfoUpdateType} updateType - The type of update received.
-   * @param {Object} [data] - Additional data for the update, if applicable.
-   * @returns {void}
-   */
-  private updateFromHashTree(
-    updateType: LocusInfoUpdateType,
-    data?: {updatedObjects: HashTreeObject[]}
-  ) {
-    switch (updateType) {
-      case LocusInfoUpdateType.OBJECTS_UPDATED: {
-        // initialize the main locus with what we currently have
-        // but with empty participants array
-        let locus: LocusDTO = {
-          participants: [],
-          jsSdkMeta: {removedParticipantIds: []},
-        };
-
-        LocusDtoTopLevelKeys.forEach((key) => {
-          if (key === 'participants') {
-            locus[key] = [];
-          } else {
-            locus[key] = cloneDeep(this[key]);
-          }
-        });
-
-        // apply the updates from the hash tree onto the locus
-        data.updatedObjects.forEach((object) => {
-          locus = this.updateHashTreeObjectInLocus(object, locus);
-        });
-
-        // update our locus info with the new locus
-        this.onDeltaLocus(locus);
-
-        break;
-      }
-
-      case LocusInfoUpdateType.MEETING_ENDED: {
-        LoggerProxy.logger.info(
-          `Locus-info:index#updateFromHashTree --> received signal that meeting ended, destroying meeting ${this.meetingId}`
-        );
-        const meeting = this.webex.meetings.meetingCollection.get(this.meetingId);
-        this.webex.meetings.destroy(meeting, MEETING_REMOVED_REASON.LOCUS_DTO_SYNC_FAILED);
-      }
-    }
+    this.handleLocusDelta(responseBody.locus, meeting);
   }
 
   /**
@@ -593,43 +385,38 @@ export default class LocusInfo extends EventsScope {
    * @memberof LocusInfo
    */
   parse(meeting: any, data: any) {
-    if (data.eventType === 'locus.state_message') {
-      // this is the new hashmap Locus message format (only applicable to webinars for now)
-      this.handleHashTreeMessage(meeting, data.stateElementsMessage as HashTreeMessage);
-    } else {
-      // eslint-disable-next-line @typescript-eslint/no-shadow
-      const {eventType} = data;
-      const locus = this.getTheLocusToUpdate(data.locus);
-      LoggerProxy.logger.info(`Locus-info:index#parse --> received locus data: ${eventType}`);
-
-      locus.jsSdkMeta = {removedParticipantIds: []};
-
-      switch (eventType) {
-        case LOCUSEVENT.PARTICIPANT_JOIN:
-        case LOCUSEVENT.PARTICIPANT_LEFT:
-        case LOCUSEVENT.CONTROLS_UPDATED:
-        case LOCUSEVENT.PARTICIPANT_AUDIO_MUTED:
-        case LOCUSEVENT.PARTICIPANT_AUDIO_UNMUTED:
-        case LOCUSEVENT.PARTICIPANT_VIDEO_MUTED:
-        case LOCUSEVENT.PARTICIPANT_VIDEO_UNMUTED:
-        case LOCUSEVENT.SELF_CHANGED:
-        case LOCUSEVENT.PARTICIPANT_UPDATED:
-        case LOCUSEVENT.PARTICIPANT_CONTROLS_UPDATED:
-        case LOCUSEVENT.PARTICIPANT_ROLES_UPDATED:
-        case LOCUSEVENT.PARTICIPANT_DECLINED:
-        case LOCUSEVENT.FLOOR_GRANTED:
-        case LOCUSEVENT.FLOOR_RELEASED:
-          this.onFullLocus(locus, eventType);
-          break;
-        case LOCUSEVENT.DIFFERENCE:
-          this.handleLocusDelta(locus, meeting);
-          break;
-
-        default:
-          // Why will there be a event with no eventType ????
-          // we may not need this, we can get full locus
-          this.handleLocusDelta(locus, meeting);
-      }
+    // eslint-disable-next-line @typescript-eslint/no-shadow
+    const {eventType} = data;
+    const locus = this.getTheLocusToUpdate(data.locus);
+    LoggerProxy.logger.info(`Locus-info:index#parse --> received locus data: ${eventType}`);
+
+    locus.jsSdkMeta = {removedParticipantIds: []};
+
+    switch (eventType) {
+      case LOCUSEVENT.PARTICIPANT_JOIN:
+      case LOCUSEVENT.PARTICIPANT_LEFT:
+      case LOCUSEVENT.CONTROLS_UPDATED:
+      case LOCUSEVENT.PARTICIPANT_AUDIO_MUTED:
+      case LOCUSEVENT.PARTICIPANT_AUDIO_UNMUTED:
+      case LOCUSEVENT.PARTICIPANT_VIDEO_MUTED:
+      case LOCUSEVENT.PARTICIPANT_VIDEO_UNMUTED:
+      case LOCUSEVENT.SELF_CHANGED:
+      case LOCUSEVENT.PARTICIPANT_UPDATED:
+      case LOCUSEVENT.PARTICIPANT_CONTROLS_UPDATED:
+      case LOCUSEVENT.PARTICIPANT_ROLES_UPDATED:
+      case LOCUSEVENT.PARTICIPANT_DECLINED:
+      case LOCUSEVENT.FLOOR_GRANTED:
+      case LOCUSEVENT.FLOOR_RELEASED:
+        this.onFullLocus(locus, eventType);
+        break;
+      case LOCUSEVENT.DIFFERENCE:
+        this.handleLocusDelta(locus, meeting);
+        break;
+
+      default:
+        // Why will there be a event with no eventType ????
+        // we may not need this, we can get full locus
+        this.handleLocusDelta(locus, meeting);
     }
   }
 
@@ -648,46 +435,17 @@ export default class LocusInfo extends EventsScope {
    * updates the locus with full locus object
    * @param {object} locus locus object
    * @param {string} eventType particulat locus event
-   * @param {DataSet[]} dataSets
    * @returns {object} null
    * @memberof LocusInfo
    */
-  onFullLocus(locus: any, eventType?: string, dataSets?: Array<DataSet>) {
+  onFullLocus(locus: any, eventType?: string) {
     if (!locus) {
       LoggerProxy.logger.error(
         'Locus-info:index#onFullLocus --> object passed as argument was invalid, continuing.'
       );
     }
 
-    if (dataSets) {
-      // this is the new hashmap Locus DTO format (only applicable to webinars for now)
-      if (!this.hashTreeParser) {
-        LoggerProxy.logger.info(`Locus-info:index#onFullLocus --> creating hash tree parser`);
-        LoggerProxy.logger.info(
-          'Locus-info:index#onFullLocus --> dataSets:',
-          dataSets,
-          ' and locus:',
-          locus
-        );
-        this.hashTreeParser = new HashTreeParser({
-          initialLocus: {locus, dataSets},
-          webexRequest: this.webex.request.bind(this.webex),
-          locusInfoUpdateCallback: this.updateFromHashTree.bind(this),
-          debugId: `HT-${this.meetingId.substring(0, 4)}`,
-        });
-      } else {
-        // in this case the Locus we're getting is not necessarily the full one
-        // so treat it like if we just got it in a message
-        console.log('marcin: !!!!!!!! full DTO - this is not fully implemented/tested yet');
-
-        LoggerProxy.logger.warn(
-          'Locus-info:index#onFullLocus --> full DTO - this is not fully implemented/tested yet!!!!!!!!'
-        );
-        this.handleLocusAPIResponse(undefined, {dataSets, locus});
-
-        return;
-      }
-    } else if (!this.locusParser.isNewFullLocus(locus)) {
+    if (!this.locusParser.isNewFullLocus(locus)) {
       LoggerProxy.logger.info(
         `Locus-info:index#onFullLocus --> ignoring old full locus DTO, eventType=${eventType}`
       );
@@ -695,12 +453,8 @@ export default class LocusInfo extends EventsScope {
       return;
     }
 
-    this.updateParticipantDeltas(locus.participants);
     this.scheduledMeeting = locus.meeting || null;
     this.participants = locus.participants;
-    this.participants?.forEach((participant) => {
-      this.hashTreeObjectId2ParticipantId.set(participant.htMeta.elementId.id, participant.id);
-    });
     const isReplaceMembers = ControlsUtils.isNeedReplaceMembers(this.controls, locus.controls);
     this.updateLocusInfo(locus);
     this.updateParticipants(
@@ -795,7 +549,7 @@ export default class LocusInfo extends EventsScope {
     this.updateCreated(locus.created);
     this.updateFullState(locus.fullState);
     this.updateHostInfo(locus.host);
-    this.updateLocusUrl(locus.url);
+    this.updateLocusUrl(locus.url, ControlsUtils.isMainSessionDTO(locus));
     this.updateMeetingInfo(locus.info, locus.self);
     this.updateMediaShares(locus.mediaShares);
     this.updateParticipantsUrl(locus.participantsUrl);
@@ -1061,55 +815,6 @@ export default class LocusInfo extends EventsScope {
     }
   }
 
-  /**
-   * Update the deltaParticipants property of this object based on a list of
-   * provided participants.
-   *
-   * @param {Array} [participants] - The participants to update against.
-   * @returns {void}
-   */
-  updateParticipantDeltas(participants: Array<any> = []) {
-    // Used to find a participant within a participants collection.
-    const findParticipant = (participant, collection) =>
-      collection.find((item) => item.person.id === participant.person.id);
-
-    // Generates an object that indicates which state properties have changed.
-    const generateDelta = (prevState: any = {}, newState: any = {}) => {
-      // Setup deltas.
-      const deltas = {
-        audioStatus: prevState.audioStatus !== newState.audioStatus,
-        videoSlidesStatus: prevState.videoSlidesStatus !== newState.videoSlidesStatus,
-        videoStatus: prevState.videoStatus !== newState.videoStatus,
-      };
-
-      // Clean the object
-      Object.keys(deltas).forEach((key) => {
-        if (deltas[key] !== true) {
-          delete deltas[key];
-        }
-      });
-
-      return deltas;
-    };
-
-    this.deltaParticipants = participants.reduce((collection, participant) => {
-      const existingParticipant = findParticipant(participant, this.participants || []) || {};
-
-      const delta = generateDelta(existingParticipant.status, participant.status);
-
-      const changed = Object.keys(delta).length > 0;
-
-      if (changed) {
-        collection.push({
-          person: participant.person,
-          delta,
-        });
-      }
-
-      return collection;
-    }, []);
-  }
-
   /**
    * update meeting's members
    * @param {Object} participants new participants object
@@ -1118,7 +823,7 @@ export default class LocusInfo extends EventsScope {
    * @returns {Array} updatedParticipants
    * @memberof LocusInfo
    */
-  updateParticipants(participants: object, removedParticipantIds: string[], isReplace?: boolean) {
+  updateParticipants(participants: object, removedParticipantIds?: string[], isReplace?: boolean) {
     this.emitScoped(
       {
         file: 'locus-info',
@@ -1190,6 +895,7 @@ export default class LocusInfo extends EventsScope {
           hasAnnotationControlChanged,
           hasRemoteDesktopControlChanged,
           hasPollingQAControlChanged,
+          hasAutoEndMeetingChanged,
         },
         current,
       } = ControlsUtils.getControls(this.controls, controls);
@@ -1464,6 +1170,14 @@ export default class LocusInfo extends EventsScope {
         );
       }
 
+      if (hasAutoEndMeetingChanged) {
+        this.emitScoped(
+          {file: 'locus-info', function: 'updateControls'},
+          LOCUSINFO.EVENTS.CONTROLS_AUTO_END_MEETING_WARNING_CHANGED,
+          {state: current.autoEndMeetingWarning}
+        );
+      }
+
       this.controls = controls;
     }
   }
@@ -1624,10 +1338,7 @@ export default class LocusInfo extends EventsScope {
    */
   updateMeetingInfo(info: object, self?: object) {
     const roles = self ? SelfUtils.getRoles(self) : this.parsedLocus.self?.roles || [];
-    if (
-      (info && !isEqual(this.info, info)) ||
-      (roles.length && !isEqual(this.roles, roles) && info)
-    ) {
+    if ((info && !isEqual(this.info, info)) || (!isEqual(this.roles, roles) && info)) {
       const isJoined = SelfUtils.isJoined(self || this.parsedLocus.self);
       const parsedInfo = InfoUtils.getInfos(this.parsedLocus.info, info, roles, isJoined);
 
@@ -2030,10 +1741,11 @@ export default class LocusInfo extends EventsScope {
   /**
    * handles when the locus.url is updated
    * @param {String} url
+   * @param {Boolean} isMainLocus
    * @returns {undefined}
    * emits internal event locus_info_update_url
    */
-  updateLocusUrl(url: string) {
+  updateLocusUrl(url: string, isMainLocus = true) {
     if (url && this.url !== url) {
       this.url = url;
       this.updateMeeting({locusUrl: url});
@@ -2043,7 +1755,7 @@ export default class LocusInfo extends EventsScope {
           function: 'updateLocusUrl',
         },
         EVENTS.LOCUS_INFO_UPDATE_URL,
-        url
+        {url, isMainLocus}
       );
     }
   }

package/src/locus-info/parser.ts

@@ -728,13 +728,17 @@ export default class Parser {
         break;
 
       case USE_INCOMING:
-      case LOCUS_URL_CHANGED:
         // update working copy for future comparisons.
         // Note: The working copy of parser gets updated in .onFullLocus()
         // and here when USE_INCOMING or LOCUS_URL_CHANGED locus.
         this.workingCopy = newLoci;
         break;
 
+      case LOCUS_URL_CHANGED:
+        // clear the working copy completely, do a full locus sync
+        this.workingCopy = null;
+        break;
+
       case WAIT:
         // we've taken newLoci from the front of the queue, so put it back there as we have to wait
         // for the one that should be in front of it, before we can process it