@webex/plugin-meetings 3.0.0-beta.10 → 3.0.0-beta.104

package/src/meetings/request.ts

@@ -2,11 +2,7 @@
 import {StatelessWebexPlugin} from '@webex/webex-core';
 
 import LoggerProxy from '../common/logs/logger-proxy';
-import {
-  HTTP_VERBS,
-  API,
-  RESOURCE
-} from '../constants';
+import {HTTP_VERBS, API, RESOURCE} from '../constants';
 
 /**
  * @class MeetingRequest
@@ -15,16 +11,19 @@ export default class MeetingRequest extends StatelessWebexPlugin {
   /**
    *  get all the active meetings for the user
    * @returns {Array} return locus array
-  */
+   */
   getActiveMeetings() {
     // @ts-ignore
     return this.request({
       api: API.LOCUS,
-      resource: RESOURCE.LOCI
+      resource: RESOURCE.LOCI,
     })
       .then((res) => this.determineRedirections(res.body))
       .catch((error) => {
-        LoggerProxy.logger.error(`Meetings:request#getActiveMeetings --> failed to get locus details, ${error}`);
+        LoggerProxy.logger.error(
+          `Meetings:request#getActiveMeetings --> failed to get locus details, ${error}`
+        );
+        throw new Error(error);
       });
   }
 
@@ -40,13 +39,12 @@ export default class MeetingRequest extends StatelessWebexPlugin {
   /**
    * get user meeting preference information
    * @returns {Promise<object>} getMeetingPreferences
-  */
+   */
   getMeetingPreferences() {
     // @ts-ignore
     return this.webex.internal.services.getMeetingPreferences();
   }
 
-
   // locus federation, determines and populate locus if the responseBody has remote URLs to fetch locus details
 
   /**
@@ -56,22 +54,28 @@ export default class MeetingRequest extends StatelessWebexPlugin {
    */
   determineRedirections(responseBody: any) {
     if (responseBody.remoteLocusClusterUrls && responseBody.remoteLocusClusterUrls.length) {
-      // @ts-ignore
-      return Promise.all(responseBody.remoteLocusClusterUrls.map((url) => this.request({
-        method: HTTP_VERBS.GET,
-        url,
-        runWhitelistedDomains: true // allows auth token for whitelisted domain
-      })
-        .then((res) => {
-          responseBody.loci = responseBody.loci.concat(res.body.loci);
-          responseBody.locusUrls = responseBody.locusUrls.concat(res.body.locusUrls);
+      return Promise.all(
+        responseBody.remoteLocusClusterUrls.map((url) =>
+          // @ts-ignore
+          this.request({
+            method: HTTP_VERBS.GET,
+            url,
+            runWhitelistedDomains: true, // allows auth token for whitelisted domain
+          })
+            .then((res) => {
+              responseBody.loci = responseBody.loci.concat(res.body.loci);
+              responseBody.locusUrls = responseBody.locusUrls.concat(res.body.locusUrls);
 
-          return Promise.resolve(responseBody);
-        })
-        .catch((error) => {
-          LoggerProxy.logger.error(`Meetings:request#determineRedirections --> failed to get locus details from url: ${url}, reason: ${error}`);
-        })))
-        .then(() => Promise.resolve(responseBody));
+              return Promise.resolve(responseBody);
+            })
+            .catch((error) => {
+              LoggerProxy.logger.error(
+                `Meetings:request#determineRedirections --> failed to get locus details from url: ${url}, reason: ${error}`
+              );
+              throw new Error(error);
+            })
+        )
+      ).then(() => Promise.resolve(responseBody));
     }
 
     return Promise.resolve(responseBody);

package/src/meetings/util.ts

@@ -1,34 +1,39 @@
 /* globals window */
 
 import {
-  _LOCUS_ID_,
-  _INCOMING_,
   _CREATED_,
-  LOCUSEVENT,
+  _INCOMING_,
+  _JOINED_,
+  _LEFT_,
+  _LOCUS_ID_,
+  _MOVED_,
+  BREAKOUTS,
   CORRELATION_ID,
   EVENT_TRIGGERS,
-  ROAP
+  LOCUS,
+  LOCUSEVENT,
+  ROAP,
 } from '../constants';
 import LoggerProxy from '../common/logs/logger-proxy';
 import Trigger from '../common/events/trigger-proxy';
 
 /**
-  * Meetings Media Codec Missing Event
-  * Emitted when H.264 codec is not
-  * found in the browser.
-  * @event media:codec:missing
-  * @instance
-  * @memberof MeetingsUtil
-  */
+ * Meetings Media Codec Missing Event
+ * Emitted when H.264 codec is not
+ * found in the browser.
+ * @event media:codec:missing
+ * @instance
+ * @memberof MeetingsUtil
+ */
 
 /**
-  * Meetings Media Codec Loaded Event
-  * Emitted when H.264 codec has been
-  * loaded in the browser.
-  * @event media:codec:loaded
-  * @instance
-  * @memberof MeetingsUtil
-  */
+ * Meetings Media Codec Loaded Event
+ * Emitted when H.264 codec has been
+ * loaded in the browser.
+ * @event media:codec:loaded
+ * @instance
+ * @memberof MeetingsUtil
+ */
 
 const MeetingsUtil: any = {};
 
@@ -42,31 +47,52 @@ MeetingsUtil.handleRoapMercury = (envelope, meetingCollection) => {
     const meeting = meetingCollection.getByKey(CORRELATION_ID, data.correlationId);
 
     if (meeting) {
-      const {
-        seq, messageType, tieBreaker, errorType, errorCause
-      } = data.message;
+      const {seq, messageType, tieBreaker, errorType, errorCause} = data.message;
 
       if (messageType === ROAP.ROAP_TYPES.TURN_DISCOVERY_RESPONSE) {
         // turn discovery is not part of normal roap protocol and so we are not handling it
         // through the usual roap state machine
         meeting.roap.turnDiscovery.handleTurnDiscoveryResponse(data.message);
-      }
-      else {
+      } else {
         const roapMessage = {
           seq,
           messageType,
           sdp: data.message.sdps?.length > 0 ? data.message.sdps[0] : undefined,
           tieBreaker,
           errorType,
-          errorCause
+          errorCause,
         };
 
+        const mediaServer = MeetingsUtil.getMediaServer(roapMessage.sdp);
+
         meeting.mediaProperties.webrtcMediaConnection.roapMessageReceived(roapMessage);
+
+        if (mediaServer) {
+          meeting.mediaProperties.webrtcMediaConnection.mediaServer = mediaServer;
+        }
       }
     }
   }
 };
 
+MeetingsUtil.getMediaServer = (sdp) => {
+  let mediaServer;
+
+  // Attempt to collect the media server from the roap message.
+  try {
+    mediaServer = sdp
+      .split('\r\n')
+      .find((line) => line.startsWith('o='))
+      .split(' ')
+      .shift()
+      .replace('o=', '');
+  } catch {
+    mediaServer = undefined;
+  }
+
+  return mediaServer;
+};
+
 MeetingsUtil.checkForCorrelationId = (deviceUrl, locus) => {
   let devices = [];
 
@@ -88,11 +114,13 @@ MeetingsUtil.checkForCorrelationId = (deviceUrl, locus) => {
 MeetingsUtil.parseDefaultSiteFromMeetingPreferences = (userPreferences) => {
   let result = '';
 
-  if (userPreferences && userPreferences.sites) {
+  if (userPreferences?.sites?.length) {
     const defaultSite = userPreferences.sites.find((site) => site.default);
 
     if (defaultSite) {
       result = defaultSite.siteUrl;
+    } else {
+      result = userPreferences.sites[0].siteUrl;
     }
   }
 
@@ -116,9 +144,10 @@ MeetingsUtil.hasH264Codec = async () => {
       hasCodec = true;
     }
     pc.close();
-  }
-  catch (error) {
-    LoggerProxy.logger.warn('Meetings:util#hasH264Codec --> Error creating peerConnection for H.264 test.');
+  } catch (error) {
+    LoggerProxy.logger.warn(
+      'Meetings:util#hasH264Codec --> Error creating peerConnection for H.264 test.'
+    );
   }
 
   return hasCodec;
@@ -143,8 +172,8 @@ MeetingsUtil.checkH264Support = async function checkH264Support(options: {
   const {firstChecked, disableNotifications} = options || {};
   const delay = 5e3; // ms
   const maxDuration = 3e5; // ms
-  const shouldTrigger = (firstChecked === undefined);
-  const shouldStopChecking = firstChecked && (Date.now() - firstChecked) >= maxDuration;
+  const shouldTrigger = firstChecked === undefined;
+  const shouldStopChecking = firstChecked && Date.now() - firstChecked >= maxDuration;
 
   // Disable notifications and start H.264 download only
   if (disableNotifications) {
@@ -159,7 +188,7 @@ MeetingsUtil.checkH264Support = async function checkH264Support(options: {
       this,
       {
         file: 'meetings/util',
-        function: 'checkH264Support'
+        function: 'checkH264Support',
       },
       EVENT_TRIGGERS.MEDIA_CODEC_LOADED
     );
@@ -170,7 +199,9 @@ MeetingsUtil.checkH264Support = async function checkH264Support(options: {
 
   // Stop checking if past the timelimit
   if (shouldStopChecking) {
-    LoggerProxy.logger.error('Meetings:util#checkH264Support --> Timed out waiting for H264 codec to load.');
+    LoggerProxy.logger.error(
+      'Meetings:util#checkH264Support --> Timed out waiting for H264 codec to load.'
+    );
 
     return;
   }
@@ -181,7 +212,7 @@ MeetingsUtil.checkH264Support = async function checkH264Support(options: {
       this,
       {
         file: 'meetings/util',
-        function: 'checkH264Support'
+        function: 'checkH264Support',
       },
       EVENT_TRIGGERS.MEDIA_CODEC_MISSING
     );
@@ -196,4 +227,62 @@ MeetingsUtil.checkH264Support = async function checkH264Support(options: {
   }, delay);
 };
 
+/**
+ * get device from locus data
+ * @param {Object} newLocus new locus data
+ * @param {String} deviceUrl current device url
+ * @returns {Object}
+ */
+MeetingsUtil.getThisDevice = (newLocus: any, deviceUrl: string) => {
+  if (newLocus?.self?.devices?.length > 0) {
+    return newLocus.self.devices.find((device) => device.url === deviceUrl);
+  }
+
+  return null;
+};
+
+/**
+ * get self device joined status from locus data
+ * @param {Object} meeting current meeting data
+ * @param {Object} newLocus new locus data
+ * @param {String} deviceUrl current device url
+ * @returns {Object}
+ */
+MeetingsUtil.joinedOnThisDevice = (meeting: any, newLocus: any, deviceUrl: string) => {
+  const thisDevice = MeetingsUtil.getThisDevice(newLocus, deviceUrl);
+  if (thisDevice) {
+    if (!thisDevice.correlationId || meeting?.correlationId === thisDevice.correlationId) {
+      return (
+        thisDevice.state === _JOINED_ ||
+        (thisDevice.state === _LEFT_ && thisDevice.reason === _MOVED_)
+      );
+    }
+  }
+
+  return false;
+};
+
+/**
+ * check the new locus is breakout session's one or not
+ * @param {Object} newLocus new locus data
+ * @returns {boolean}
+ * @private
+ */
+MeetingsUtil.isBreakoutLocusDTO = (newLocus: any) => {
+  return newLocus?.controls?.breakout?.sessionType === BREAKOUTS.SESSION_TYPES.BREAKOUT;
+};
+
+/**
+ * check the locus is valid breakout locus or not
+ * @param {Object} locus
+ * @returns {boolean}
+ * @private
+ */
+MeetingsUtil.isValidBreakoutLocus = (locus: any) => {
+  const inActiveStatus = locus?.fullState?.state === LOCUS.STATE.INACTIVE;
+  const isLocusAsBreakout = MeetingsUtil.isBreakoutLocusDTO(locus);
+  const selfJoined = locus.self?.state === _JOINED_;
+
+  return isLocusAsBreakout && !inActiveStatus && selfJoined;
+};
 export default MeetingsUtil;

package/src/member/index.ts

@@ -1,12 +1,8 @@
 /*!
  * Copyright (c) 2015-2020 Cisco Systems, Inc. See LICENSE file.
  */
-import {
-  MEETINGS,
-  _IN_LOBBY_,
-  _NOT_IN_MEETING_,
-  _IN_MEETING_
-} from '../constants';
+import {MEETINGS, _IN_LOBBY_, _NOT_IN_MEETING_, _IN_MEETING_} from '../constants';
+import {IExternalRoles, ParticipantWithRoles} from './types';
 
 import MemberUtil from './util';
 
@@ -33,9 +29,11 @@ export default class Member {
   isSelf: any;
   isUser: any;
   isVideoMuted: any;
+  roles: IExternalRoles;
   name: any;
   participant: any;
   status: any;
+  supportsBreakouts: boolean;
   type: any;
   namespace = MEETINGS;
 
@@ -51,20 +49,22 @@ export default class Member {
    */
   constructor(
     participant: object,
-    options: {
-      selfId: string;
-      hostId: string;
-      contentSharingId: string;
-      type: string;
-    } | any = {}
+    options:
+      | {
+          selfId: string;
+          hostId: string;
+          contentSharingId: string;
+          type: string;
+        }
+      | any = {}
   ) {
-   /**
+    /**
      * The server participant object
      * @instance
      * @type {Object}
      * @private
      * @memberof Member
-    */
+     */
     this.participant = null;
     /**
      * The member id
@@ -72,7 +72,7 @@ export default class Member {
      * @type {String}
      * @public
      * @memberof Member
-    */
+     */
     this.id = null;
     /**
      * The member name
@@ -80,34 +80,41 @@ export default class Member {
      * @type {String}
      * @public
      * @memberof Member
-    */
+     */
     this.name = null;
     /**
      * @instance
      * @type {Boolean}
      * @public
      * @memberof Member
-    */
+     */
     this.isAudioMuted = null;
     /**
      * @instance
      * @type {Boolean}
      * @public
      * @memberof Member
-    */
+     */
     this.isVideoMuted = null;
     /**
      * @instance
      * @type {Boolean}
      * @public
      * @memberof Member
-    */
+     */
     this.isHandRaised = null;
     /**
-      * @instance
-      * @type {Boolean}
-      * @public
-      * @memberof Member
+     * @instance
+     * @type {Boolean}
+     * @public
+     * @memberof Member
+     */
+    this.supportsBreakouts = null;
+    /**
+     * @instance
+     * @type {Boolean}
+     * @public
+     * @memberof Member
      */
     this.isSelf = null;
     /**
@@ -115,114 +122,122 @@ export default class Member {
      * @type {Boolean}
      * @public
      * @memberof Member
-    */
+     */
     this.isHost = null;
     /**
      * @instance
      * @type {Boolean}
      * @public
      * @memberof Member
-    */
+     */
     this.isGuest = null;
     /**
      * @instance
      * @type {Boolean}
      * @public
      * @memberof Member
-    */
+     */
     this.isInLobby = null;
     /**
      * @instance
      * @type {Boolean}
      * @public
      * @memberof Member
-    */
+     */
     this.isInMeeting = null;
     /**
      * @instance
      * @type {Boolean}
      * @public
      * @memberof Member
-    */
+     */
     this.isNotAdmitted = null;
     /**
      * @instance
      * @type {Boolean}
      * @public
      * @memberof Member
-    */
+     */
     this.isContentSharing = null;
     /**
      * @instance
      * @type {Boolean}
      * @public
      * @memberof Member
-    */
+     */
     this.status = null;
     /**
      * @instance
      * @type {Boolean}
      * @public
      * @memberof Member
-    */
+     */
     this.isDevice = null;
     /**
      * @instance
      * @type {Boolean}
      * @public
      * @memberof Member
-    */
+     */
     this.isUser = null;
     /**
-         * Is this member associated to another user by way of pairing (typical of devices)
+     * Is this member associated to another user by way of pairing (typical of devices)
      * @instance
      * @type {String}
      * @public
      * @memberof Member
-    */
+     */
     this.associatedUser = null;
     /**
      * @instance
      * @type {Boolean}
      * @public
      * @memberof Member
-    */
+     */
     this.isRecording = null;
     /**
      * @instance
      * @type {Boolean}
      * @public
      * @memberof Member
-    */
+     */
     this.isMutable = null;
     /**
      * @instance
      * @type {Boolean}
      * @public
      * @memberof Member
-    */
+     */
     this.isRemovable = null;
     /**
      * @instance
      * @type {String}
      * @private
      * @memberof Member
-    */
+     */
     this.type = null;
     /**
      * @instance
      * @type {Boolean}
      * @public
      * @memberof Member
-    */
+     */
     this.isModerator = null;
     /**
      * @instance
      * @type {Boolean}
      * @public
      * @memberof Member
-    */
+     */
     this.isModeratorAssignmentProhibited = null;
+
+    /**
+     * @instance
+     * @type {IExternalRoles}
+     * @public
+     * @memberof Member
+     */
+    this.roles = null;
     // TODO: more participant types
     // such as native client, web client, is a device, what type of phone, etc
     this.processParticipant(participant);
@@ -245,12 +260,15 @@ export default class Member {
       this.isAudioMuted = MemberUtil.isAudioMuted(participant);
       this.isVideoMuted = MemberUtil.isVideoMuted(participant);
       this.isHandRaised = MemberUtil.isHandRaised(participant);
+      this.supportsBreakouts = MemberUtil.isBreakoutsSupported(participant);
       this.isGuest = MemberUtil.isGuest(participant);
       this.isUser = MemberUtil.isUser(participant);
       this.isDevice = MemberUtil.isDevice(participant);
       this.isModerator = MemberUtil.isModerator(participant);
-      this.isModeratorAssignmentProhibited = MemberUtil.isModeratorAssignmentProhibited(participant);
+      this.isModeratorAssignmentProhibited =
+        MemberUtil.isModeratorAssignmentProhibited(participant);
       this.processStatus(participant);
+      this.processRoles(participant as ParticipantWithRoles);
       // must be done last
       this.isNotAdmitted = MemberUtil.isNotAdmitted(participant, this.isGuest, this.status);
     }
@@ -282,9 +300,20 @@ export default class Member {
    */
   private processMember() {
     // must occur after self, guest, meeting, and type properties are calculated
-    this.isRemovable = MemberUtil.isRemovable(this.isSelf, this.isGuest, this.isInMeeting, this.type);
+    this.isRemovable = MemberUtil.isRemovable(
+      this.isSelf,
+      this.isGuest,
+      this.isInMeeting,
+      this.type
+    );
     // must occur after self, device, meeting, mute status, and type properties are calculated
-    this.isMutable = MemberUtil.isMutable(this.isSelf, this.isDevice, this.isInMeeting, this.isAudioMuted, this.type);
+    this.isMutable = MemberUtil.isMutable(
+      this.isSelf,
+      this.isDevice,
+      this.isInMeeting,
+      this.isAudioMuted,
+      this.type
+    );
   }
 
   /**
@@ -359,8 +388,7 @@ export default class Member {
   public processIsContentSharing(participant: object, sharingId: string) {
     if (MemberUtil.isUser(participant)) {
       this.isContentSharing = MemberUtil.isSame(participant, sharingId);
-    }
-    else if (MemberUtil.isDevice(participant)) {
+    } else if (MemberUtil.isDevice(participant)) {
       this.isContentSharing = MemberUtil.isAssociatedSame(participant, sharingId);
     }
   }
@@ -388,8 +416,7 @@ export default class Member {
   private processIsSelf(participant: object, selfId: string) {
     if (MemberUtil.isUser(participant)) {
       this.isSelf = MemberUtil.isSame(participant, selfId);
-    }
-    else if (MemberUtil.isDevice(participant)) {
+    } else if (MemberUtil.isDevice(participant)) {
       this.isSelf = MemberUtil.isAssociatedSame(participant, selfId);
       this.associatedUser = selfId;
     }
@@ -406,12 +433,22 @@ export default class Member {
   private processIsHost(participant: object, hostId: string) {
     if (MemberUtil.isUser(participant)) {
       this.isHost = MemberUtil.isSame(participant, hostId);
-    }
-    else if (MemberUtil.isDevice(participant)) {
+    } else if (MemberUtil.isDevice(participant)) {
       this.isHost = MemberUtil.isAssociatedSame(participant, hostId);
     }
   }
 
+  /**
+   * process the roles that have been applied to this member
+   * @param {Object} participant
+   * @returns {undefined}
+   * @private
+   * @memberof Member
+   */
+  private processRoles(participant: ParticipantWithRoles) {
+    this.roles = MemberUtil.extractControlRoles(participant);
+  }
+
   /**
    * set the type for the member, could be MEETING or CALL
    * @param {String} type

package/src/member/types.ts

@@ -0,0 +1,24 @@
+export interface IExternalRoles {
+  cohost: boolean;
+  moderator: boolean;
+  presenter: boolean;
+}
+
+export enum ServerRoles {
+  Cohost = 'COHOST',
+  Moderator = 'MODERATOR',
+  Presenter = 'PRESENTER',
+}
+
+export type ServerRoleShape = {
+  type: ServerRoles;
+  hasRole: boolean;
+};
+
+export type ParticipantWithRoles = {
+  controls: {
+    role: {
+      roles: Array<ServerRoleShape>;
+    };
+  };
+};