@webex/plugin-meetings 3.0.0-beta.115 → 3.0.0-beta.117

package/src/meeting/util.ts

@@ -1,10 +1,9 @@
-import {isEmpty} from 'lodash';
 import {LocalCameraTrack, LocalMicrophoneTrack} from '@webex/media-helpers';
 
+import {cloneDeep} from 'lodash';
 import {MeetingNotActiveError, UserNotJoinedError} from '../common/errors/webex-errors';
 import Metrics from '../metrics';
 import {eventType, trigger} from '../metrics/config';
-import Media from '../media';
 import LoggerProxy from '../common/logs/logger-proxy';
 import {
   INTENT_TO_JOIN,
@@ -22,499 +21,536 @@ import PermissionError from '../common/errors/permission';
 import PasswordError from '../common/errors/password-error';
 import CaptchaError from '../common/errors/captcha-error';
 
-const MeetingUtil: any = {};
+const MeetingUtil = {
+  parseLocusJoin: (response) => {
+    const parsed: any = {};
+
+    // First todo: add check for existance
+    parsed.locus = response.body.locus;
+    parsed.mediaConnections = response.body.mediaConnections;
+    parsed.locusUrl = parsed.locus.url;
+    parsed.locusId = parsed.locus.url.split('/').pop();
+    parsed.selfId = parsed.locus.self.id;
+
+    // we need mediaId before making roap calls
+    parsed.mediaConnections.forEach((mediaConnection) => {
+      if (mediaConnection.mediaId) {
+        parsed.mediaId = mediaConnection.mediaId;
+      }
+    });
 
-MeetingUtil.parseLocusJoin = (response) => {
-  const parsed: any = {};
+    return parsed;
+  },
 
-  // First todo: add check for existance
-  parsed.locus = response.body.locus;
-  parsed.mediaConnections = response.body.mediaConnections;
-  parsed.locusUrl = parsed.locus.url;
-  parsed.locusId = parsed.locus.url.split('/').pop();
-  parsed.selfId = parsed.locus.self.id;
+  remoteUpdateAudioVideo: (meeting, audioMuted?: boolean, videoMuted?: boolean) => {
+    if (!meeting) {
+      return Promise.reject(new ParameterError('You need a meeting object.'));
+    }
 
-  // we need mediaId before making roap calls
-  parsed.mediaConnections.forEach((mediaConnection) => {
-    if (mediaConnection.mediaId) {
-      parsed.mediaId = mediaConnection.mediaId;
+    if (!meeting.locusMediaRequest) {
+      return Promise.reject(
+        new ParameterError(
+          'You need a meeting with a media connection, call Meeting.addMedia() first.'
+        )
+      );
     }
-  });
 
-  return parsed;
-};
+    Metrics.postEvent({event: eventType.MEDIA_REQUEST, meeting});
+
+    return meeting.locusMediaRequest
+      .send({
+        type: 'LocalMute',
+        selfUrl: meeting.selfUrl,
+        mediaId: meeting.mediaId,
+        sequence: meeting.locusInfo.sequence,
+        muteOptions: {
+          audioMuted,
+          videoMuted,
+        },
+      })
+      .then((response) => {
+        Metrics.postEvent({event: eventType.MEDIA_RESPONSE, meeting});
 
-MeetingUtil.remoteUpdateAudioVideo = (meeting, audioMuted?: boolean, videoMuted?: boolean) => {
-  if (!meeting) {
-    return Promise.reject(new ParameterError('You need a meeting object.'));
-  }
-
-  if (!meeting.locusMediaRequest) {
-    return Promise.reject(
-      new ParameterError(
-        'You need a meeting with a media connection, call Meeting.addMedia() first.'
-      )
-    );
-  }
-
-  Metrics.postEvent({event: eventType.MEDIA_REQUEST, meeting});
-
-  return meeting.locusMediaRequest
-    .send({
-      type: 'LocalMute',
-      selfUrl: meeting.selfUrl,
-      mediaId: meeting.mediaId,
-      muteOptions: {
-        audioMuted,
-        videoMuted,
-      },
-    })
-    .then((response) => {
-      Metrics.postEvent({event: eventType.MEDIA_RESPONSE, meeting});
-
-      return response?.body?.locus;
-    });
-};
+        return response?.body?.locus;
+      });
+  },
 
-MeetingUtil.hasOwner = (info) => info && info.owner;
+  hasOwner: (info) => info && info.owner,
 
-MeetingUtil.isOwnerSelf = (owner, selfId) => owner === selfId;
+  isOwnerSelf: (owner, selfId) => owner === selfId,
 
-MeetingUtil.isPinOrGuest = (err) =>
-  err?.body?.errorCode && INTENT_TO_JOIN.includes(err.body.errorCode);
+  isPinOrGuest: (err) => err?.body?.errorCode && INTENT_TO_JOIN.includes(err.body.errorCode),
 
-MeetingUtil.joinMeeting = (meeting, options) => {
-  if (!meeting) {
-    return Promise.reject(new ParameterError('You need a meeting object.'));
-  }
+  joinMeeting: (meeting, options) => {
+    if (!meeting) {
+      return Promise.reject(new ParameterError('You need a meeting object.'));
+    }
 
-  Metrics.postEvent({event: eventType.LOCUS_JOIN_REQUEST, meeting});
+    Metrics.postEvent({event: eventType.LOCUS_JOIN_REQUEST, meeting});
+
+    // eslint-disable-next-line no-warning-comments
+    // TODO: check if the meeting is in JOINING state
+    // if Joining state termintate the request as user might click multiple times
+    return meeting.meetingRequest
+      .joinMeeting({
+        inviteeAddress: meeting.meetingJoinUrl || meeting.sipUri,
+        meetingNumber: meeting.meetingNumber,
+        deviceUrl: meeting.deviceUrl,
+        locusUrl: meeting.locusUrl,
+        correlationId: meeting.correlationId,
+        roapMessage: options.roapMessage,
+        permissionToken: meeting.permissionToken,
+        resourceId: options.resourceId || null,
+        moderator: options.moderator,
+        pin: options.pin,
+        moveToResource: options.moveToResource,
+        preferTranscoding: !meeting.isMultistream,
+        asResourceOccupant: options.asResourceOccupant,
+        breakoutsSupported: options.breakoutsSupported,
+        locale: options.locale,
+        deviceCapabilities: options.deviceCapabilities,
+      })
+      .then((res) => {
+        Metrics.postEvent({
+          event: eventType.LOCUS_JOIN_RESPONSE,
+          meeting,
+          data: {
+            trigger: trigger.LOCI_UPDATE,
+            locus: res.body.locus,
+            mediaConnections: res.body.mediaConnections,
+            trackingId: res.headers.trackingid,
+          },
+        });
 
-  // eslint-disable-next-line no-warning-comments
-  // TODO: check if the meeting is in JOINING state
-  // if Joining state termintate the request as user might click multiple times
-  return meeting.meetingRequest
-    .joinMeeting({
-      inviteeAddress: meeting.meetingJoinUrl || meeting.sipUri,
-      meetingNumber: meeting.meetingNumber,
-      deviceUrl: meeting.deviceUrl,
-      locusUrl: meeting.locusUrl,
-      correlationId: meeting.correlationId,
-      roapMessage: options.roapMessage,
-      permissionToken: meeting.permissionToken,
-      resourceId: options.resourceId || null,
-      moderator: options.moderator,
-      pin: options.pin,
-      moveToResource: options.moveToResource,
-      preferTranscoding: !meeting.isMultistream,
-      asResourceOccupant: options.asResourceOccupant,
-      breakoutsSupported: options.breakoutsSupported,
-      locale: options.locale,
-      deviceCapabilities: options.deviceCapabilities,
-    })
-    .then((res) => {
-      Metrics.postEvent({
-        event: eventType.LOCUS_JOIN_RESPONSE,
-        meeting,
-        data: {
-          trigger: trigger.LOCI_UPDATE,
-          locus: res.body.locus,
-          mediaConnections: res.body.mediaConnections,
-          trackingId: res.headers.trackingid,
-        },
+        return MeetingUtil.parseLocusJoin(res);
       });
+  },
+
+  cleanUp: (meeting) => {
+    meeting.breakouts.cleanUp();
+
+    // make sure we send last metrics before we close the peerconnection
+    const stopStatsAnalyzer = meeting.statsAnalyzer
+      ? meeting.statsAnalyzer.stopAnalyzer()
+      : Promise.resolve();
+
+    return stopStatsAnalyzer
+      .then(() => meeting.closeLocalStream())
+      .then(() => meeting.closeLocalShare())
+      .then(() => meeting.closeRemoteTracks())
+      .then(() => meeting.closePeerConnections())
+      .then(() => {
+        meeting.unsetLocalVideoTrack();
+        meeting.unsetLocalShareTrack();
+        meeting.unsetRemoteTracks();
+        meeting.unsetPeerConnections();
+        meeting.reconnectionManager.cleanUp();
+      })
+      .then(() => meeting.stopKeepAlive())
+      .then(() => meeting.updateLLMConnection());
+  },
+
+  disconnectPhoneAudio: (meeting, phoneUrl) => {
+    if (meeting.meetingState === FULL_STATE.INACTIVE) {
+      return Promise.reject(new MeetingNotActiveError());
+    }
 
-      return MeetingUtil.parseLocusJoin(res);
-    });
-};
-
-MeetingUtil.cleanUp = (meeting) => {
-  meeting.breakouts.cleanUp();
-
-  // make sure we send last metrics before we close the peerconnection
-  const stopStatsAnalyzer = meeting.statsAnalyzer
-    ? meeting.statsAnalyzer.stopAnalyzer()
-    : Promise.resolve();
-
-  return stopStatsAnalyzer
-    .then(() => meeting.closeLocalStream())
-    .then(() => meeting.closeLocalShare())
-    .then(() => meeting.closeRemoteTracks())
-    .then(() => meeting.closePeerConnections())
-    .then(() => {
-      meeting.unsetLocalVideoTrack();
-      meeting.unsetLocalShareTrack();
-      meeting.unsetRemoteTracks();
-      meeting.unsetPeerConnections();
-      meeting.reconnectionManager.cleanUp();
-    })
-    .then(() => meeting.stopKeepAlive())
-    .then(() => meeting.updateLLMConnection());
-};
+    const options = {
+      locusUrl: meeting.locusUrl,
+      selfId: meeting.selfId,
+      correlationId: meeting.correlationId,
+      phoneUrl,
+    };
 
-MeetingUtil.disconnectPhoneAudio = (meeting, phoneUrl) => {
-  if (meeting.meetingState === FULL_STATE.INACTIVE) {
-    return Promise.reject(new MeetingNotActiveError());
-  }
-
-  const options = {
-    locusUrl: meeting.locusUrl,
-    selfId: meeting.selfId,
-    correlationId: meeting.correlationId,
-    phoneUrl,
-  };
-
-  return meeting.meetingRequest
-    .disconnectPhoneAudio(options)
-    .then((response) => {
-      if (response?.body?.locus) {
-        meeting.locusInfo.onFullLocus(response.body.locus);
-      }
-    })
-    .catch((err) => {
+    return meeting.meetingRequest.disconnectPhoneAudio(options).catch((err) => {
       LoggerProxy.logger.error(
         `Meeting:util#disconnectPhoneAudio --> An error occured while disconnecting phone audio in meeting ${meeting.id}, error: ${err}`
       );
 
       return Promise.reject(err);
     });
-};
+  },
+
+  // by default will leave on meeting's resourceId
+  // if you explicity want it not to leave on resource id, pass
+  // {resourceId: null}
+  // TODO: chris, you can modify this however you want
+  leaveMeeting: (meeting, options: any = {}) => {
+    if (meeting.meetingState === FULL_STATE.INACTIVE) {
+      // TODO: clean up if the meeting is already inactive
+      return Promise.reject(new MeetingNotActiveError());
+    }
 
-// by default will leave on meeting's resourceId
-// if you explicity want it not to leave on resource id, pass
-// {resourceId: null}
-// TODO: chris, you can modify this however you want
-MeetingUtil.leaveMeeting = (meeting, options: any = {}) => {
-  if (meeting.meetingState === FULL_STATE.INACTIVE) {
-    // TODO: clean up if the meeting is already inactive
-    return Promise.reject(new MeetingNotActiveError());
-  }
-
-  if (MeetingUtil.isUserInLeftState(meeting.locusInfo)) {
-    return Promise.reject(new UserNotJoinedError());
-  }
-
-  const defaultOptions = {
-    locusUrl: meeting.locusUrl,
-    selfId: meeting.selfId,
-    correlationId: meeting.correlationId,
-    resourceId: meeting.resourceId,
-    deviceUrl: meeting.deviceUrl,
-  };
-
-  const leaveOptions = {...defaultOptions, ...options};
-
-  return meeting.meetingRequest
-    .leaveMeeting(leaveOptions)
-    .then((response) => {
-      if (response && response.body && response.body.locus) {
-        // && !options.moveMeeting) {
-        meeting.locusInfo.onFullLocus(response.body.locus);
-      }
+    if (MeetingUtil.isUserInLeftState(meeting.locusInfo)) {
+      return Promise.reject(new UserNotJoinedError());
+    }
 
-      return Promise.resolve();
-    })
-    .then(() => {
-      if (options.moveMeeting) {
-        return Promise.resolve();
-      }
+    const defaultOptions = {
+      locusUrl: meeting.locusUrl,
+      selfId: meeting.selfId,
+      correlationId: meeting.correlationId,
+      resourceId: meeting.resourceId,
+      deviceUrl: meeting.deviceUrl,
+    };
+
+    const leaveOptions = {...defaultOptions, ...options};
+
+    return meeting.meetingRequest
+      .leaveMeeting(leaveOptions)
+      .then(() => {
+        if (options.moveMeeting) {
+          return Promise.resolve();
+        }
+
+        return MeetingUtil.cleanUp(meeting);
+      })
+      .catch((err) => {
+        // TODO: If the meeting state comes as LEFT or INACTIVE as response then
+        // 1)  on leave clean up the meeting or simply do a sync on the meeting
+        // 2) If the error says meeting is inactive then destroy the meeting object
+        LoggerProxy.logger.error(
+          `Meeting:util#leaveMeeting --> An error occured while trying to leave meeting with an id of ${meeting.id}, error: ${err}`
+        );
+
+        return Promise.reject(err);
+      });
+  },
+  declineMeeting: (meeting, reason) =>
+    meeting.meetingRequest.declineMeeting({
+      locusUrl: meeting.locusUrl,
+      deviceUrl: meeting.deviceUrl,
+      reason,
+    }),
 
-      return MeetingUtil.cleanUp(meeting);
-    })
-    .catch((err) => {
-      // TODO: If the meeting state comes as LEFT or INACTIVE as response then
-      // 1)  on leave clean up the meeting or simply do a sync on the meeting
-      // 2) If the error says meeting is inactive then destroy the meeting object
-      LoggerProxy.logger.error(
-        `Meeting:util#leaveMeeting --> An error occured while trying to leave meeting with an id of ${meeting.id}, error: ${err}`
-      );
+  isUserInLeftState: (locusInfo) => locusInfo.parsedLocus?.self?.state === _LEFT_,
 
-      return Promise.reject(err);
-    });
-};
-MeetingUtil.declineMeeting = (meeting, reason) =>
-  meeting.meetingRequest.declineMeeting({
-    locusUrl: meeting.locusUrl,
-    deviceUrl: meeting.deviceUrl,
-    reason,
-  });
+  isUserInIdleState: (locusInfo) => locusInfo.parsedLocus?.self?.state === _IDLE_,
 
-MeetingUtil.isUserInLeftState = (locusInfo) => locusInfo.parsedLocus?.self?.state === _LEFT_;
+  isUserInJoinedState: (locusInfo) => locusInfo.parsedLocus?.self?.state === _JOINED_,
 
-MeetingUtil.isUserInIdleState = (locusInfo) => locusInfo.parsedLocus?.self?.state === _IDLE_;
+  isMediaEstablished: (currentMediaStatus) =>
+    currentMediaStatus &&
+    (currentMediaStatus.audio || currentMediaStatus.video || currentMediaStatus.share),
 
-MeetingUtil.isUserInJoinedState = (locusInfo) => locusInfo.parsedLocus?.self?.state === _JOINED_;
+  joinMeetingOptions: (meeting, options: any = {}) => {
+    meeting.resourceId = meeting.resourceId || options.resourceId;
 
-MeetingUtil.isMediaEstablished = (currentMediaStatus) =>
-  currentMediaStatus &&
-  (currentMediaStatus.audio || currentMediaStatus.video || currentMediaStatus.share);
+    if (meeting.requiredCaptcha) {
+      return Promise.reject(new CaptchaError());
+    }
+    if (meeting.passwordStatus === PASSWORD_STATUS.REQUIRED) {
+      return Promise.reject(new PasswordError());
+    }
 
-MeetingUtil.joinMeetingOptions = (meeting, options: any = {}) => {
-  meeting.resourceId = meeting.resourceId || options.resourceId;
+    if (options.pin) {
+      Metrics.postEvent({
+        event: eventType.PIN_COLLECTED,
+        meeting,
+      });
+    }
 
-  if (meeting.requiredCaptcha) {
-    return Promise.reject(new CaptchaError());
-  }
-  if (meeting.passwordStatus === PASSWORD_STATUS.REQUIRED) {
-    return Promise.reject(new PasswordError());
-  }
+    // normal join meeting, scenario A, D
+    return MeetingUtil.joinMeeting(meeting, options)
+      .then((response) => {
+        meeting.setLocus(response);
+
+        return Promise.resolve(response);
+      })
+      .catch((err) => {
+        // joining a claimed PMR that is not my own, scenario B
+        if (MeetingUtil.isPinOrGuest(err)) {
+          Metrics.postEvent({
+            event: eventType.PIN_PROMPT,
+            meeting,
+          });
+
+          // request host pin or non host for unclaimed PMR, start of Scenario C
+          // see https://sqbu-github.cisco.com/WebExSquared/locus/wiki/Locus-Lobby-and--IVR-Feature
+          return Promise.reject(new IntentToJoinError('Error Joining Meeting', err));
+        }
+        LoggerProxy.logger.error(
+          'Meeting:util#joinMeetingOptions --> Error joining the call, ',
+          err
+        );
+
+        return Promise.reject(new JoinMeetingError(options, 'Error Joining Meeting', err));
+      });
+  },
 
-  if (options.pin) {
-    Metrics.postEvent({
-      event: eventType.PIN_COLLECTED,
-      meeting,
-    });
-  }
-
-  // normal join meeting, scenario A, D
-  return MeetingUtil.joinMeeting(meeting, options)
-    .then((response) => {
-      meeting.setLocus(response);
-
-      return Promise.resolve(response);
-    })
-    .catch((err) => {
-      // joining a claimed PMR that is not my own, scenario B
-      if (MeetingUtil.isPinOrGuest(err)) {
-        Metrics.postEvent({
-          event: eventType.PIN_PROMPT,
-          meeting,
-        });
+  validateOptions: (options) => {
+    const {sendVideo, sendAudio, sendShare, localStream, localShare} = options;
 
-        // request host pin or non host for unclaimed PMR, start of Scenario C
-        // see https://sqbu-github.cisco.com/WebExSquared/locus/wiki/Locus-Lobby-and--IVR-Feature
-        return Promise.reject(new IntentToJoinError('Error Joining Meeting', err));
-      }
-      LoggerProxy.logger.error('Meeting:util#joinMeetingOptions --> Error joining the call, ', err);
+    if (sendVideo && !MeetingUtil.getTrack(localStream).videoTrack) {
+      return Promise.reject(new ParameterError('please pass valid video streams'));
+    }
 
-      return Promise.reject(new JoinMeetingError(options, 'Error Joining Meeting', err));
-    });
-};
+    if (sendAudio && !MeetingUtil.getTrack(localStream).audioTrack) {
+      return Promise.reject(new ParameterError('please pass valid audio streams'));
+    }
 
-MeetingUtil.validateOptions = (options) => {
-  const {sendVideo, sendAudio, sendShare, localStream, localShare} = options;
+    if (sendShare && !MeetingUtil.getTrack(localShare).videoTrack) {
+      return Promise.reject(new ParameterError('please pass valid share streams'));
+    }
 
-  if (sendVideo && !MeetingUtil.getTrack(localStream).videoTrack) {
-    return Promise.reject(new ParameterError('please pass valid video streams'));
-  }
+    return Promise.resolve();
+  },
 
-  if (sendAudio && !MeetingUtil.getTrack(localStream).audioTrack) {
-    return Promise.reject(new ParameterError('please pass valid audio streams'));
-  }
+  getTrack: (stream) => {
+    let audioTrack = null;
+    let videoTrack = null;
+    let audioTracks = null;
+    let videoTracks = null;
 
-  if (sendShare && !MeetingUtil.getTrack(localShare).videoTrack) {
-    return Promise.reject(new ParameterError('please pass valid share streams'));
-  }
+    if (!stream) {
+      return {audioTrack: null, videoTrack: null};
+    }
+    if (stream.getAudioTracks) {
+      audioTracks = stream.getAudioTracks();
+    }
+    if (stream.getVideoTracks) {
+      videoTracks = stream.getVideoTracks();
+    }
 
-  return Promise.resolve();
-};
+    if (audioTracks && audioTracks.length > 0) {
+      [audioTrack] = audioTracks;
+    }
 
-MeetingUtil.getTrack = (stream) => {
-  let audioTrack = null;
-  let videoTrack = null;
-  let audioTracks = null;
-  let videoTracks = null;
-
-  if (!stream) {
-    return {audioTrack: null, videoTrack: null};
-  }
-  if (stream.getAudioTracks) {
-    audioTracks = stream.getAudioTracks();
-  }
-  if (stream.getVideoTracks) {
-    videoTracks = stream.getVideoTracks();
-  }
-
-  if (audioTracks && audioTracks.length > 0) {
-    [audioTrack] = audioTracks;
-  }
-
-  if (videoTracks && videoTracks.length > 0) {
-    [videoTrack] = videoTracks;
-  }
-
-  return {audioTrack, videoTrack};
-};
+    if (videoTracks && videoTracks.length > 0) {
+      [videoTrack] = videoTracks;
+    }
 
-MeetingUtil.getModeratorFromLocusInfo = (locusInfo) =>
-  locusInfo &&
-  locusInfo.parsedLocus &&
-  locusInfo.parsedLocus.info &&
-  locusInfo.parsedLocus.info &&
-  locusInfo.parsedLocus.info.moderator;
+    return {audioTrack, videoTrack};
+  },
 
-MeetingUtil.getPolicyFromLocusInfo = (locusInfo) =>
-  locusInfo &&
-  locusInfo.parsedLocus &&
-  locusInfo.parsedLocus.info &&
-  locusInfo.parsedLocus.info &&
-  locusInfo.parsedLocus.info.policy;
+  getModeratorFromLocusInfo: (locusInfo) =>
+    locusInfo &&
+    locusInfo.parsedLocus &&
+    locusInfo.parsedLocus.info &&
+    locusInfo.parsedLocus.info &&
+    locusInfo.parsedLocus.info.moderator,
 
-MeetingUtil.getUserDisplayHintsFromLocusInfo = (locusInfo) =>
-  locusInfo?.parsedLocus?.info?.userDisplayHints || [];
+  getPolicyFromLocusInfo: (locusInfo) =>
+    locusInfo &&
+    locusInfo.parsedLocus &&
+    locusInfo.parsedLocus.info &&
+    locusInfo.parsedLocus.info &&
+    locusInfo.parsedLocus.info.policy,
 
-MeetingUtil.canInviteNewParticipants = (displayHints) =>
-  displayHints.includes(DISPLAY_HINTS.ADD_GUEST);
+  getUserDisplayHintsFromLocusInfo: (locusInfo) =>
+    locusInfo?.parsedLocus?.info?.userDisplayHints || [],
 
-MeetingUtil.canAdmitParticipant = (displayHints) =>
-  displayHints.includes(DISPLAY_HINTS.ROSTER_WAITING_TO_JOIN);
+  canInviteNewParticipants: (displayHints) => displayHints.includes(DISPLAY_HINTS.ADD_GUEST),
 
-MeetingUtil.canUserLock = (displayHints) =>
-  displayHints.includes(DISPLAY_HINTS.LOCK_CONTROL_LOCK) &&
-  displayHints.includes(DISPLAY_HINTS.LOCK_STATUS_UNLOCKED);
+  canAdmitParticipant: (displayHints) =>
+    displayHints.includes(DISPLAY_HINTS.ROSTER_WAITING_TO_JOIN),
 
-MeetingUtil.canUserUnlock = (displayHints) =>
-  displayHints.includes(DISPLAY_HINTS.LOCK_CONTROL_UNLOCK) &&
-  displayHints.includes(DISPLAY_HINTS.LOCK_STATUS_LOCKED);
+  canUserLock: (displayHints) =>
+    displayHints.includes(DISPLAY_HINTS.LOCK_CONTROL_LOCK) &&
+    displayHints.includes(DISPLAY_HINTS.LOCK_STATUS_UNLOCKED),
 
-MeetingUtil.canUserRaiseHand = (displayHints) => displayHints.includes(DISPLAY_HINTS.RAISE_HAND);
+  canUserUnlock: (displayHints) =>
+    displayHints.includes(DISPLAY_HINTS.LOCK_CONTROL_UNLOCK) &&
+    displayHints.includes(DISPLAY_HINTS.LOCK_STATUS_LOCKED),
 
-MeetingUtil.canUserLowerAllHands = (displayHints) =>
-  displayHints.includes(DISPLAY_HINTS.LOWER_ALL_HANDS);
+  canUserRaiseHand: (displayHints) => displayHints.includes(DISPLAY_HINTS.RAISE_HAND),
 
-MeetingUtil.canUserLowerSomeoneElsesHand = (displayHints) =>
-  displayHints.includes(DISPLAY_HINTS.LOWER_SOMEONE_ELSES_HAND);
+  canUserLowerAllHands: (displayHints) => displayHints.includes(DISPLAY_HINTS.LOWER_ALL_HANDS),
 
-MeetingUtil.bothLeaveAndEndMeetingAvailable = (displayHints) =>
-  displayHints.includes(DISPLAY_HINTS.LEAVE_TRANSFER_HOST_END_MEETING) ||
-  displayHints.includes(DISPLAY_HINTS.LEAVE_END_MEETING);
+  canUserLowerSomeoneElsesHand: (displayHints) =>
+    displayHints.includes(DISPLAY_HINTS.LOWER_SOMEONE_ELSES_HAND),
 
-MeetingUtil.canManageBreakout = (displayHints) =>
-  displayHints.includes(DISPLAY_HINTS.BREAKOUT_MANAGEMENT);
+  bothLeaveAndEndMeetingAvailable: (displayHints) =>
+    displayHints.includes(DISPLAY_HINTS.LEAVE_TRANSFER_HOST_END_MEETING) ||
+    displayHints.includes(DISPLAY_HINTS.LEAVE_END_MEETING),
 
-MeetingUtil.isSuppressBreakoutSupport = (displayHints) =>
-  displayHints.includes(DISPLAY_HINTS.UCF_SUPPRESS_BREAKOUTS_SUPPORT);
+  canManageBreakout: (displayHints) => displayHints.includes(DISPLAY_HINTS.BREAKOUT_MANAGEMENT),
 
-MeetingUtil.canAdmitLobbyToBreakout = (displayHints) =>
-  !displayHints.includes(DISPLAY_HINTS.DISABLE_LOBBY_TO_BREAKOUT);
+  isSuppressBreakoutSupport: (displayHints) =>
+    displayHints.includes(DISPLAY_HINTS.UCF_SUPPRESS_BREAKOUTS_SUPPORT),
 
-MeetingUtil.isBreakoutPreassignmentsEnabled = (displayHints) =>
-  !displayHints.includes(DISPLAY_HINTS.DISABLE_BREAKOUT_PREASSIGNMENTS);
+  canAdmitLobbyToBreakout: (displayHints) =>
+    !displayHints.includes(DISPLAY_HINTS.DISABLE_LOBBY_TO_BREAKOUT),
 
-MeetingUtil.canUserAskForHelp = (displayHints) =>
-  !displayHints.includes(DISPLAY_HINTS.DISABLE_ASK_FOR_HELP);
+  isBreakoutPreassignmentsEnabled: (displayHints) =>
+    !displayHints.includes(DISPLAY_HINTS.DISABLE_BREAKOUT_PREASSIGNMENTS),
 
-MeetingUtil.lockMeeting = (actions, request, locusUrl) => {
-  if (actions && actions.canLock) {
-    return request.lockMeeting({locusUrl, lock: true});
-  }
+  canUserAskForHelp: (displayHints) => !displayHints.includes(DISPLAY_HINTS.DISABLE_ASK_FOR_HELP),
 
-  return Promise.reject(new PermissionError('Lock not allowed, due to joined property.'));
-};
+  lockMeeting: (actions, request, locusUrl) => {
+    if (actions && actions.canLock) {
+      return request.lockMeeting({locusUrl, lock: true});
+    }
 
-MeetingUtil.unlockMeeting = (actions, request, locusUrl) => {
-  if (actions && actions.canUnlock) {
-    return request.lockMeeting({locusUrl, lock: false});
-  }
+    return Promise.reject(new PermissionError('Lock not allowed, due to joined property.'));
+  },
 
-  return Promise.reject(new PermissionError('Unlock not allowed, due to joined property.'));
-};
+  unlockMeeting: (actions, request, locusUrl) => {
+    if (actions && actions.canUnlock) {
+      return request.lockMeeting({locusUrl, lock: false});
+    }
 
-MeetingUtil.handleAudioLogging = (audioTrack: LocalMicrophoneTrack | null) => {
-  const LOG_HEADER = 'MeetingUtil#handleAudioLogging -->';
+    return Promise.reject(new PermissionError('Unlock not allowed, due to joined property.'));
+  },
 
-  if (audioTrack) {
-    const settings = audioTrack.underlyingTrack.getSettings();
-    const {deviceId} = settings;
+  handleAudioLogging: (audioTrack: LocalMicrophoneTrack | null) => {
+    const LOG_HEADER = 'MeetingUtil#handleAudioLogging -->';
 
-    LoggerProxy.logger.log(LOG_HEADER, `deviceId = ${deviceId}`);
-    LoggerProxy.logger.log(LOG_HEADER, 'settings =', JSON.stringify(settings));
-  }
-};
+    if (audioTrack) {
+      const settings = audioTrack.underlyingTrack.getSettings();
+      const {deviceId} = settings;
 
-MeetingUtil.handleVideoLogging = (videoTrack: LocalCameraTrack | null) => {
-  const LOG_HEADER = 'MeetingUtil#handleVideoLogging -->';
+      LoggerProxy.logger.log(LOG_HEADER, `deviceId = ${deviceId}`);
+      LoggerProxy.logger.log(LOG_HEADER, 'settings =', JSON.stringify(settings));
+    }
+  },
 
-  if (videoTrack) {
-    const settings = videoTrack.underlyingTrack.getSettings();
-    const {deviceId} = settings;
+  handleVideoLogging: (videoTrack: LocalCameraTrack | null) => {
+    const LOG_HEADER = 'MeetingUtil#handleVideoLogging -->';
 
-    LoggerProxy.logger.log(LOG_HEADER, `deviceId = ${deviceId}`);
-    LoggerProxy.logger.log(LOG_HEADER, 'settings =', JSON.stringify(settings));
-  }
-};
+    if (videoTrack) {
+      const settings = videoTrack.underlyingTrack.getSettings();
+      const {deviceId} = settings;
 
-MeetingUtil.handleDeviceLogging = (devices = []) => {
-  const LOG_HEADER = 'MeetingUtil#handleDeviceLogging -->';
+      LoggerProxy.logger.log(LOG_HEADER, `deviceId = ${deviceId}`);
+      LoggerProxy.logger.log(LOG_HEADER, 'settings =', JSON.stringify(settings));
+    }
+  },
 
-  devices.forEach((device) => {
-    LoggerProxy.logger.log(LOG_HEADER, `deviceId = ${device.deviceId}`);
-    LoggerProxy.logger.log(LOG_HEADER, 'settings', JSON.stringify(device));
-  });
-};
+  handleDeviceLogging: (devices = []) => {
+    const LOG_HEADER = 'MeetingUtil#handleDeviceLogging -->';
 
-MeetingUtil.endMeetingForAll = (meeting) => {
-  if (meeting.meetingState === FULL_STATE.INACTIVE) {
-    return Promise.reject(new MeetingNotActiveError());
-  }
+    devices.forEach((device) => {
+      LoggerProxy.logger.log(LOG_HEADER, `deviceId = ${device.deviceId}`);
+      LoggerProxy.logger.log(LOG_HEADER, 'settings', JSON.stringify(device));
+    });
+  },
 
-  const endOptions = {
-    locusUrl: meeting.locusUrl,
-  };
+  endMeetingForAll: (meeting) => {
+    if (meeting.meetingState === FULL_STATE.INACTIVE) {
+      return Promise.reject(new MeetingNotActiveError());
+    }
 
-  return meeting.meetingRequest
-    .endMeetingForAll(endOptions)
-    .then((response) => {
-      if (response && response.body && response.body.locus) {
-        meeting.locusInfo.onFullLocus(response.body.locus);
-      }
+    const endOptions = {
+      locusUrl: meeting.locusUrl,
+    };
 
-      return Promise.resolve();
-    })
-    .then(() => MeetingUtil.cleanUp(meeting))
-    .catch((err) => {
-      LoggerProxy.logger.error(
-        `Meeting:util#endMeetingForAll An error occured while trying to end meeting for all with an id of ${meeting.id}, error: ${err}`
-      );
+    return meeting.meetingRequest
+      .endMeetingForAll(endOptions)
+      .then(() => MeetingUtil.cleanUp(meeting))
+      .catch((err) => {
+        LoggerProxy.logger.error(
+          `Meeting:util#endMeetingForAll An error occured while trying to end meeting for all with an id of ${meeting.id}, error: ${err}`
+        );
 
-      return Promise.reject(err);
-    });
-};
+        return Promise.reject(err);
+      });
+  },
 
-MeetingUtil.canEnableClosedCaption = (displayHints) =>
-  displayHints.includes(DISPLAY_HINTS.CAPTION_START);
+  canEnableClosedCaption: (displayHints) => displayHints.includes(DISPLAY_HINTS.CAPTION_START),
 
-MeetingUtil.isSaveTranscriptsEnabled = (displayHints) =>
-  displayHints.includes(DISPLAY_HINTS.SAVE_TRANSCRIPTS_ENABLED);
+  isSaveTranscriptsEnabled: (displayHints) =>
+    displayHints.includes(DISPLAY_HINTS.SAVE_TRANSCRIPTS_ENABLED),
 
-MeetingUtil.canStartTranscribing = (displayHints) =>
-  displayHints.includes(DISPLAY_HINTS.TRANSCRIPTION_CONTROL_START);
+  canStartTranscribing: (displayHints) =>
+    displayHints.includes(DISPLAY_HINTS.TRANSCRIPTION_CONTROL_START),
 
-MeetingUtil.canStopTranscribing = (displayHints) =>
-  displayHints.includes(DISPLAY_HINTS.TRANSCRIPTION_CONTROL_STOP);
+  canStopTranscribing: (displayHints) =>
+    displayHints.includes(DISPLAY_HINTS.TRANSCRIPTION_CONTROL_STOP),
 
-MeetingUtil.isClosedCaptionActive = (displayHints) =>
-  displayHints.includes(DISPLAY_HINTS.CAPTION_STATUS_ACTIVE);
+  isClosedCaptionActive: (displayHints) =>
+    displayHints.includes(DISPLAY_HINTS.CAPTION_STATUS_ACTIVE),
 
-MeetingUtil.isWebexAssistantActive = (displayHints) =>
-  displayHints.includes(DISPLAY_HINTS.WEBEX_ASSISTANT_STATUS_ACTIVE);
+  isWebexAssistantActive: (displayHints) =>
+    displayHints.includes(DISPLAY_HINTS.WEBEX_ASSISTANT_STATUS_ACTIVE),
 
-MeetingUtil.canViewCaptionPanel = (displayHints) =>
-  displayHints.includes(DISPLAY_HINTS.ENABLE_CAPTION_PANEL);
+  canViewCaptionPanel: (displayHints) => displayHints.includes(DISPLAY_HINTS.ENABLE_CAPTION_PANEL),
 
-MeetingUtil.isRealTimeTranslationEnabled = (displayHints) =>
-  displayHints.includes(DISPLAY_HINTS.DISPLAY_REAL_TIME_TRANSLATION);
+  isRealTimeTranslationEnabled: (displayHints) =>
+    displayHints.includes(DISPLAY_HINTS.DISPLAY_REAL_TIME_TRANSLATION),
 
-MeetingUtil.canSelectSpokenLanguages = (displayHints) =>
-  displayHints.includes(DISPLAY_HINTS.DISPLAY_NON_ENGLISH_ASR);
+  canSelectSpokenLanguages: (displayHints) =>
+    displayHints.includes(DISPLAY_HINTS.DISPLAY_NON_ENGLISH_ASR),
 
-MeetingUtil.waitingForOthersToJoin = (displayHints) =>
-  displayHints.includes(DISPLAY_HINTS.WAITING_FOR_OTHERS);
+  waitingForOthersToJoin: (displayHints) => displayHints.includes(DISPLAY_HINTS.WAITING_FOR_OTHERS),
 
-MeetingUtil.canSendReactions = (originalValue, displayHints) => {
-  if (displayHints.includes(DISPLAY_HINTS.REACTIONS_ACTIVE)) {
-    return true;
-  }
-  if (displayHints.includes(DISPLAY_HINTS.REACTIONS_INACTIVE)) {
-    return false;
-  }
+  canSendReactions: (originalValue, displayHints) => {
+    if (displayHints.includes(DISPLAY_HINTS.REACTIONS_ACTIVE)) {
+      return true;
+    }
+    if (displayHints.includes(DISPLAY_HINTS.REACTIONS_INACTIVE)) {
+      return false;
+    }
 
-  return originalValue;
-};
-MeetingUtil.canUserRenameSelfAndObserved = (displayHints) =>
-  displayHints.includes(DISPLAY_HINTS.CAN_RENAME_SELF_AND_OBSERVED);
+    return originalValue;
+  },
+  canUserRenameSelfAndObserved: (displayHints) =>
+    displayHints.includes(DISPLAY_HINTS.CAN_RENAME_SELF_AND_OBSERVED),
+
+  canUserRenameOthers: (displayHints) => displayHints.includes(DISPLAY_HINTS.CAN_RENAME_OTHERS),
 
-MeetingUtil.canUserRenameOthers = (displayHints) =>
-  displayHints.includes(DISPLAY_HINTS.CAN_RENAME_OTHERS);
+  /**
+   * Adds the current locus sequence information to a request body
+   * @param {Object} meeting The meeting object
+   * @param {Object} requestBody The body of a request to locus
+   * @returns {void}
+   */
+  addSequence: (meeting, requestBody) => {
+    const sequence = meeting?.locusInfo?.sequence;
+
+    if (!sequence) {
+      return;
+    }
+
+    requestBody.sequence = sequence;
+  },
+
+  /**
+   * Updates the locus info for the meeting with the delta locus
+   * returned from requests that include the sequence information
+   * Returns the original response object
+   * @param {Object} meeting The meeting object
+   * @param {Object} response The response of the http request
+   * @returns {Object}
+   */
+  updateLocusWithDelta: (meeting, response) => {
+    if (!meeting) {
+      return response;
+    }
+
+    const locus = response?.body?.locus;
+
+    if (locus) {
+      meeting.locusInfo.onDeltaLocus(locus);
+    }
+
+    return response;
+  },
+
+  generateLocusDeltaRequest: (originalMeeting) => {
+    const meetingRef = new WeakRef(originalMeeting);
+
+    const locusDeltaRequest = (originalOptions) => {
+      const meeting = meetingRef.deref();
+
+      if (!meeting) {
+        return Promise.resolve();
+      }
+
+      const options = cloneDeep(originalOptions);
+
+      if (!options.body) {
+        options.body = {};
+      }
+
+      MeetingUtil.addSequence(meeting, options.body);
+
+      return meeting
+        .request(options)
+        .then((response) => MeetingUtil.updateLocusWithDelta(meeting, response));
+    };
+
+    return locusDeltaRequest;
+  },
+};
 
 export default MeetingUtil;