@webex/plugin-meetings 3.0.0-beta.26 → 3.0.0-beta.261

package/src/members/util.ts

@@ -1,5 +1,4 @@
 import uuid from 'uuid';
-
 import {
   HTTP_VERBS,
   CONTROLS,
@@ -10,251 +9,331 @@ import {
   DIALER_REGEX,
   SEND_DTMF_ENDPOINT,
   _REMOVE_,
+  ALIAS,
 } from '../constants';
 
-const MembersUtil: any = {};
-
-/**
- * @param {Object} invitee with emailAddress, email or phoneNumber
- * @param {String} locusUrl
- * @param {Boolean} alertIfActive
- * @returns {Object} the format object
- */
-MembersUtil.generateAddMemberOptions = (
-  invitee: object,
-  locusUrl: string,
-  alertIfActive: boolean
-) => ({
-  invitee,
-  locusUrl,
-  alertIfActive,
-});
-
-/**
- * @param {Array} memberIds
- * @param {String} locusUrl
- * @returns {Object} the format object
- */
-MembersUtil.generateAdmitMemberOptions = (memberIds: Array<any>, locusUrl: string) => ({
-  locusUrl,
-  memberIds,
-});
-
-/**
- * @param {Object} options with {invitee: {emailAddress, email, phoneNumber}, alertIfActive}
- * @returns {Object} with {invitees: [{address}], alertIfActive}
- */
-MembersUtil.getAddMemberBody = (options: any) => ({
-  invitees: [
-    {
-      address: options.invitee.emailAddress || options.invitee.email || options.invitee.phoneNumber,
-    },
-  ],
-  alertIfActive: options.alertIfActive,
-});
-
-/**
- * @param {Object} options with {memberIds}
- * @returns {Object} admit with {memberIds}
- */
-MembersUtil.getAdmitMemberRequestBody = (options: any) => ({
-  admit: {participantIds: options.memberIds},
-});
-
-/**
- * @param {Object} format with {memberIds, locusUrl}
- * @returns {Object} the request parameters (method, uri, body) needed to make a admitMember request
- */
-MembersUtil.getAdmitMemberRequestParams = (format: any) => {
-  const body = MembersUtil.getAdmitMemberRequestBody(format);
-  const uri = `${format.locusUrl}/${CONTROLS}`;
-
-  return {
-    method: HTTP_VERBS.PUT,
-    uri,
-    body,
-  };
-};
-
-/**
- * @param {Object} format with {invitee {emailAddress, email, phoneNumber}, locusUrl, alertIfActive}
- * @returns {Object} the request parameters (method, uri, body) needed to make a addMember request
- */
-MembersUtil.getAddMemberRequestParams = (format: any) => {
-  const body = MembersUtil.getAddMemberBody(format);
-  const requestParams = {
-    method: HTTP_VERBS.PUT,
-    uri: format.locusUrl,
-    body,
-  };
-
-  return requestParams;
-};
-
-MembersUtil.isInvalidInvitee = (invitee) => {
-  if (!(invitee && (invitee.email || invitee.emailAddress || invitee.phoneNumber))) {
-    return true;
-  }
-
-  if (invitee.phoneNumber) {
-    return !DIALER_REGEX.E164_FORMAT.test(invitee.phoneNumber);
-  }
-
-  return !VALID_EMAIL_ADDRESS.test(invitee.email || invitee.emailAddress);
-};
-
-MembersUtil.getRemoveMemberRequestParams = (options) => {
-  const body = {
-    reason: options.reason,
-  };
-  const uri = `${options.locusUrl}/${PARTICIPANT}/${options.memberId}/${LEAVE}`;
-
-  return {
-    method: HTTP_VERBS.PUT,
-    uri,
-    body,
-  };
-};
-
-MembersUtil.generateTransferHostMemberOptions = (transfer, moderator, locusUrl) => ({
-  moderator,
-  locusUrl,
-  memberId: transfer,
-});
-
-MembersUtil.generateRemoveMemberOptions = (removal, locusUrl) => ({
-  reason: _FORCED_,
-  memberId: removal,
-  locusUrl,
-});
-
-MembersUtil.generateMuteMemberOptions = (memberId, status, locusUrl) => ({
-  memberId,
-  muted: status,
-  locusUrl,
-});
-
-MembersUtil.generateRaiseHandMemberOptions = (memberId, status, locusUrl) => ({
-  memberId,
-  raised: status,
-  locusUrl,
-});
-
-MembersUtil.generateLowerAllHandsMemberOptions = (requestingParticipantId, locusUrl) => ({
-  requestingParticipantId,
-  locusUrl,
-});
-
-MembersUtil.getMuteMemberRequestParams = (options) => {
-  const body = {
-    audio: {
-      muted: options.muted,
-    },
-  };
-  const uri = `${options.locusUrl}/${PARTICIPANT}/${options.memberId}/${CONTROLS}`;
-
-  return {
-    method: HTTP_VERBS.PATCH,
-    uri,
-    body,
-  };
-};
-
-MembersUtil.getRaiseHandMemberRequestParams = (options) => {
-  const body = {
-    hand: {
-      raised: options.raised,
-    },
-  };
-  const uri = `${options.locusUrl}/${PARTICIPANT}/${options.memberId}/${CONTROLS}`;
-
-  return {
-    method: HTTP_VERBS.PATCH,
-    uri,
-    body,
-  };
-};
-
-MembersUtil.getLowerAllHandsMemberRequestParams = (options) => {
-  const body = {
-    hand: {
-      raised: false,
-    },
-    requestingParticipantId: options.requestingParticipantId,
-  };
-  const uri = `${options.locusUrl}/${CONTROLS}`;
-
-  return {
-    method: HTTP_VERBS.PATCH,
-    uri,
-    body,
-  };
-};
-
-MembersUtil.getTransferHostToMemberRequestParams = (options) => {
-  const body = {
-    role: {
-      moderator: options.moderator,
-    },
-  };
-  const uri = `${options.locusUrl}/${PARTICIPANT}/${options.memberId}/${CONTROLS}`;
-
-  return {
-    method: HTTP_VERBS.PATCH,
-    uri,
-    body,
-  };
-};
-
-MembersUtil.genderateSendDTMFOptions = (url, tones, memberId, locusUrl) => ({
-  url,
-  tones,
-  memberId,
-  locusUrl,
-});
-
-MembersUtil.generateSendDTMFRequestParams = ({url, tones, memberId, locusUrl}) => {
-  const body = {
-    device: {
-      url,
-    },
-    memberId,
-    dtmf: {
-      correlationId: uuid.v4(),
-      tones,
-      direction: 'transmit',
-    },
-  };
-  const uri = `${locusUrl}/${PARTICIPANT}/${memberId}/${SEND_DTMF_ENDPOINT}`;
-
-  return {
-    method: HTTP_VERBS.POST,
-    uri,
-    body,
-  };
-};
-
-MembersUtil.cancelPhoneInviteOptions = (invitee, locusUrl) => ({
-  invitee,
-  locusUrl,
-});
-
-MembersUtil.generateCancelInviteRequestParams = (options) => {
-  const body = {
-    actionType: _REMOVE_,
+import {RoleAssignmentOptions, RoleAssignmentRequest, ServerRoleShape} from './types';
+
+const MembersUtil = {
+  /**
+   * @param {Object} invitee with emailAddress, email or phoneNumber
+   * @param {String} locusUrl
+   * @param {Boolean} alertIfActive
+   * @returns {Object} the format object
+   */
+  generateAddMemberOptions: (invitee: object, locusUrl: string, alertIfActive: boolean) => ({
+    invitee,
+    locusUrl,
+    alertIfActive,
+  }),
+
+  /**
+   * @param {Array} memberIds
+   * @param {String} locusUrl
+   * @returns {Object} the format object
+   */
+  generateAdmitMemberOptions: (memberIds: Array<any>, locusUrl: string) => ({
+    locusUrl,
+    memberIds,
+  }),
+
+  /**
+   * @param {Object} options with {invitee: {emailAddress, email, phoneNumber}, alertIfActive}
+   * @returns {Object} with {invitees: [{address}], alertIfActive}
+   */
+  getAddMemberBody: (options: any) => ({
     invitees: [
       {
-        address: options.invitee.phoneNumber,
+        address:
+          options.invitee.emailAddress || options.invitee.email || options.invitee.phoneNumber,
       },
     ],
-  };
-  const requestParams = {
-    method: HTTP_VERBS.PUT,
-    uri: options.locusUrl,
-    body,
-  };
-
-  return requestParams;
+    alertIfActive: options.alertIfActive,
+  }),
+
+  /**
+   * @param {Object} options with {memberIds, authorizingLocusUrl}
+   * @returns {Object} admit with {memberIds}
+   */
+  getAdmitMemberRequestBody: (options: any) => {
+    const {memberIds, sessionLocusUrls} = options;
+    const body: any = {admit: {participantIds: memberIds}};
+    if (sessionLocusUrls) {
+      const {authorizingLocusUrl} = sessionLocusUrls;
+
+      return {authorizingLocusUrl, ...body};
+    }
+
+    return body;
+  },
+
+  /**
+   * @param {Object} format with {memberIds, locusUrl, sessionLocusUrls}
+   * @returns {Object} the request parameters (method, uri, body) needed to make a admitMember request
+   * if a host/cohost is in a breakout session, the locus url should be the main session locus url
+   */
+  getAdmitMemberRequestParams: (format: any) => {
+    const body = MembersUtil.getAdmitMemberRequestBody(format);
+    const {locusUrl, sessionLocusUrls} = format;
+    const baseUrl = sessionLocusUrls?.mainLocusUrl || locusUrl;
+    const uri = `${baseUrl}/${CONTROLS}`;
+
+    return {
+      method: HTTP_VERBS.PUT,
+      uri,
+      body,
+    };
+  },
+
+  /**
+   * @param {Object} format with {invitee {emailAddress, email, phoneNumber}, locusUrl, alertIfActive}
+   * @returns {Object} the request parameters (method, uri, body) needed to make a addMember request
+   */
+  getAddMemberRequestParams: (format: any) => {
+    const body = MembersUtil.getAddMemberBody(format);
+    const requestParams = {
+      method: HTTP_VERBS.PUT,
+      uri: format.locusUrl,
+      body,
+    };
+
+    return requestParams;
+  },
+
+  isInvalidInvitee: (invitee) => {
+    if (!(invitee && (invitee.email || invitee.emailAddress || invitee.phoneNumber))) {
+      return true;
+    }
+
+    if (invitee.phoneNumber) {
+      return !DIALER_REGEX.E164_FORMAT.test(invitee.phoneNumber);
+    }
+
+    return !VALID_EMAIL_ADDRESS.test(invitee.email || invitee.emailAddress);
+  },
+
+  getRemoveMemberRequestParams: (options) => {
+    const body = {
+      reason: options.reason,
+    };
+    const uri = `${options.locusUrl}/${PARTICIPANT}/${options.memberId}/${LEAVE}`;
+
+    return {
+      method: HTTP_VERBS.PUT,
+      uri,
+      body,
+    };
+  },
+
+  generateTransferHostMemberOptions: (transfer, moderator, locusUrl) => ({
+    moderator,
+    locusUrl,
+    memberId: transfer,
+  }),
+
+  generateRemoveMemberOptions: (removal, locusUrl) => ({
+    reason: _FORCED_,
+    memberId: removal,
+    locusUrl,
+  }),
+
+  generateMuteMemberOptions: (memberId, status, locusUrl, isAudio) => ({
+    memberId,
+    muted: status,
+    locusUrl,
+    isAudio,
+  }),
+
+  generateRaiseHandMemberOptions: (memberId, status, locusUrl) => ({
+    memberId,
+    raised: status,
+    locusUrl,
+  }),
+
+  /**
+   * @param {String} memberId
+   * @param {[ServerRoleShape]} roles
+   * @param {String} locusUrl
+   * @returns {RoleAssignmentOptions}
+   */
+  generateRoleAssignmentMemberOptions: (
+    memberId: string,
+    roles: Array<ServerRoleShape>,
+    locusUrl: string
+  ): RoleAssignmentOptions => ({
+    memberId,
+    roles,
+    locusUrl,
+  }),
+
+  generateLowerAllHandsMemberOptions: (requestingParticipantId, locusUrl) => ({
+    requestingParticipantId,
+    locusUrl,
+  }),
+
+  /**
+   * @param {String} memberId id of the participant who is receiving request
+   * @param {String} requestingParticipantId id of the participant who is sending request (optional)
+   * @param {String} alias alias name
+   * @param {String} locusUrl url
+   * @returns {Object} consists of {memberID: string, requestingParticipantId: string, alias: string, locusUrl: string}
+   */
+  generateEditDisplayNameMemberOptions: (memberId, requestingParticipantId, alias, locusUrl) => ({
+    memberId,
+    requestingParticipantId,
+    alias,
+    locusUrl,
+  }),
+
+  getMuteMemberRequestParams: (options) => {
+    const property = options.isAudio === false ? 'video' : 'audio';
+    const body = {
+      [property]: {
+        muted: options.muted,
+      },
+    };
+    const uri = `${options.locusUrl}/${PARTICIPANT}/${options.memberId}/${CONTROLS}`;
+
+    return {
+      method: HTTP_VERBS.PATCH,
+      uri,
+      body,
+    };
+  },
+
+  /**
+   * @param {RoleAssignmentOptions} options
+   * @returns {RoleAssignmentRequest} the request parameters (method, uri, body) needed to make a addMember request
+   */
+  getRoleAssignmentMemberRequestParams: (options: RoleAssignmentOptions): RoleAssignmentRequest => {
+    const body = {role: {roles: []}};
+    options.roles.forEach((role) => {
+      body.role.roles.push({type: role.type, hasRole: role.hasRole});
+    });
+
+    const uri = `${options.locusUrl}/${PARTICIPANT}/${options.memberId}/${CONTROLS}`;
+
+    return {
+      method: HTTP_VERBS.PATCH,
+      uri,
+      body,
+    };
+  },
+
+  getRaiseHandMemberRequestParams: (options) => {
+    const body = {
+      hand: {
+        raised: options.raised,
+      },
+    };
+    const uri = `${options.locusUrl}/${PARTICIPANT}/${options.memberId}/${CONTROLS}`;
+
+    return {
+      method: HTTP_VERBS.PATCH,
+      uri,
+      body,
+    };
+  },
+
+  getLowerAllHandsMemberRequestParams: (options) => {
+    const body = {
+      hand: {
+        raised: false,
+      },
+      requestingParticipantId: options.requestingParticipantId,
+    };
+    const uri = `${options.locusUrl}/${CONTROLS}`;
+
+    return {
+      method: HTTP_VERBS.PATCH,
+      uri,
+      body,
+    };
+  },
+
+  /**
+   * @param {Object} options with format of {locusUrl: string, requestingParticipantId: string}
+   * @returns {Object} request parameters (method, uri, body) needed to make a editDisplayName request
+   */
+  editDisplayNameMemberRequestParams: (options) => {
+    const body = {
+      aliasValue: options.alias,
+      requestingParticipantId: options.requestingParticipantId,
+    };
+    const uri = `${options.locusUrl}/${PARTICIPANT}/${options.memberId}/${ALIAS}`;
+
+    return {
+      method: HTTP_VERBS.POST,
+      uri,
+      body,
+    };
+  },
+
+  getTransferHostToMemberRequestParams: (options) => {
+    const body = {
+      role: {
+        moderator: options.moderator,
+      },
+    };
+    const uri = `${options.locusUrl}/${PARTICIPANT}/${options.memberId}/${CONTROLS}`;
+
+    return {
+      method: HTTP_VERBS.PATCH,
+      uri,
+      body,
+    };
+  },
+
+  genderateSendDTMFOptions: (url, tones, memberId, locusUrl) => ({
+    url,
+    tones,
+    memberId,
+    locusUrl,
+  }),
+
+  generateSendDTMFRequestParams: ({url, tones, memberId, locusUrl}) => {
+    const body = {
+      device: {
+        url,
+      },
+      memberId,
+      dtmf: {
+        correlationId: uuid.v4(),
+        tones,
+        direction: 'transmit',
+      },
+    };
+    const uri = `${locusUrl}/${PARTICIPANT}/${memberId}/${SEND_DTMF_ENDPOINT}`;
+
+    return {
+      method: HTTP_VERBS.POST,
+      uri,
+      body,
+    };
+  },
+
+  cancelPhoneInviteOptions: (invitee, locusUrl) => ({
+    invitee,
+    locusUrl,
+  }),
+
+  generateCancelInviteRequestParams: (options) => {
+    const body = {
+      actionType: _REMOVE_,
+      invitees: [
+        {
+          address: options.invitee.phoneNumber,
+        },
+      ],
+    };
+    const requestParams = {
+      method: HTTP_VERBS.PUT,
+      uri: options.locusUrl,
+      body,
+    };
+
+    return requestParams;
+  },
 };
 
 export default MembersUtil;

package/src/metrics/constants.ts

@@ -9,6 +9,7 @@ const BEHAVIORAL_METRICS = {
   JOIN_FAILURE: 'js_sdk_join_failures',
   ADD_MEDIA_SUCCESS: 'js_sdk_add_media_success',
   ADD_MEDIA_FAILURE: 'js_sdk_add_media_failures',
+  ROAP_MERCURY_EVENT_RECEIVED: 'js_sdk_roap_mercury_received',
   CONNECTION_SUCCESS: 'js_sdk_connection_success',
   CONNECTION_FAILURE: 'js_sdk_connection_failures',
   MEETING_LEAVE_FAILURE: 'js_sdk_meeting_leave_failure',
@@ -17,6 +18,8 @@ const BEHAVIORAL_METRICS = {
   GET_USER_MEDIA_FAILURE: 'js_sdk_get_user_media_failures',
   GET_DISPLAY_MEDIA_FAILURE: 'js_sdk_get_display_media_failures',
   JOIN_WITH_MEDIA_FAILURE: 'js_sdk_join_with_media_failures',
+  LLM_CONNECTION_AFTER_JOIN_FAILURE: 'js_sdk_llm_connection_after_join_failure',
+  RECEIVE_TRANSCRIPTION_AFTER_JOIN_FAILURE: 'js_sdk_receive_transcription_after_join_failure',
 
   DISCONNECT_DUE_TO_INACTIVITY: 'js_sdk_disconnect_due_to_inactivity',
   MEETING_MEDIA_INACTIVE: 'js_sdk_meeting_media_inactive',
@@ -39,11 +42,8 @@ const BEHAVIORAL_METRICS = {
   PEERCONNECTION_FAILURE: 'js_sdk_peerConnection_failures',
   INVALID_ICE_CANDIDATE: 'js_sdk_invalid_ice_candidate',
   UPLOAD_LOGS_FAILURE: 'js_sdk_upload_logs_failure',
+  UPLOAD_LOGS_SUCCESS: 'js_sdk_upload_logs_success',
   RECEIVE_TRANSCRIPTION_FAILURE: 'js_sdk_receive_transcription_failure',
-  ENABLE_BNR_SUCCESS: 'js_sdk_enable_bnr_success',
-  ENABLE_BNR_FAILURE: 'js_sdk_enable_bnr_failure',
-  DISABLE_BNR_SUCCESS: 'js_sdk_disable_bnr_success',
-  DISABLE_BNR_FAILURE: 'js_sdk_disable_bnr_failure',
   FETCH_MEETING_INFO_V1_SUCCESS: 'js_sdk_fetch_meeting_info_v1_success',
   FETCH_MEETING_INFO_V1_FAILURE: 'js_sdk_fetch_meeting_info_v1_failure',
   ADHOC_MEETING_SUCCESS: 'js_sdk_adhoc_meeting_success',
@@ -56,6 +56,11 @@ const BEHAVIORAL_METRICS = {
   MOVE_FROM_SUCCESS: 'js_sdk_move_from_success',
   MOVE_FROM_FAILURE: 'js_sdk_move_from_failure',
   TURN_DISCOVERY_FAILURE: 'js_sdk_turn_discovery_failure',
+  MEETING_INFO_POLICY_ERROR: 'js_sdk_meeting_info_policy_error',
+  LOCUS_DELTA_SYNC_FAILED: 'js_sdk_locus_delta_sync_failed',
+  LOCUS_DELTA_OUT_OF_ORDER: 'js_sdk_locus_delta_ooo',
+  PERMISSION_TOKEN_REFRESH: 'js_sdk_permission_token_refresh',
+  PERMISSION_TOKEN_REFRESH_ERROR: 'js_sdk_permission_token_refresh_error',
 };
 
 export {BEHAVIORAL_METRICS as default};