@webex/plugin-meetings 3.0.0-beta.15 → 3.0.0-beta.151

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/config.ts

@@ -51,6 +51,7 @@ const errorDescription = {
   SIP_CALLEE_NOT_FOUND: 'SIPCalleeNotFound',
   START_RECORDING_FAILED: 'StartRecordingFailed',
   RECORDING_IN_PROGRESS_FAILED: 'RecordingInProgressFailed',
+  MEETING_INFO_LOOKUP_ERROR: 'MeetingInfoLookupError',
 };
 
 const errorCategory = {
@@ -78,6 +79,8 @@ export const eventType = {
   REMOTE_SDP_RECEIVED: 'client.media-engine.remote-sdp-received',
   LOCUS_JOIN_REQUEST: 'client.locus.join.request',
   LOCUS_JOIN_RESPONSE: 'client.locus.join.response',
+  MEETING_INFO_REQUEST: 'client.meetinginfo.request',
+  MEETING_INFO_RESPONSE: 'client.meetinginfo.response',
   ALERT_DISPLAYED: 'client.alert.displayed',
   // when ICE negotiation starts
   ICE_START: 'client.ice.start',
@@ -140,6 +143,9 @@ export const eventType = {
   PSTN_AUDIO_ATTEMPT_START: 'client.pstnaudio.attempt.start',
   PSTN_AUDIO_ATTEMPT_FINISH: 'client.pstnaudio.attempt.finish',
   PSTN_AUDIO_ATTEMPT_SKIP: 'client.pstnaudio.attempt.skip',
+  BREAKOUT_MOVE_REQUEST: 'client.breakout-session.move.request',
+  BREAKOUT_MOVE_RESPONSE: 'client.breakout-session.move.response',
+  BREAKOUT_JOIN_RESPONSE: 'client.breakout-session.join.response',
 };
 
 export const error = {
@@ -411,9 +417,52 @@ export const error = {
       errorFailureType.EXPECTED_FAILURE,
       errorCategory.EXPECTED,
     ],
+    // Webex App API Error Codes
+    4100: [
+      errorDescription.MEETING_INFO_LOOKUP_ERROR,
+      errorFailureType.CALL_INITIATION_FAILURE,
+      errorCategory.SIGNALING,
+    ],
   },
 };
 
+// map from SERVER ERROR CODE (normally from error.body.code) -> to Client Error Code
+export const WebexAPIServiceErrorCodes = {
+  // Site not support the URL's domain
+  58400: 4100,
+  99002: 4100,
+  // Cannot find the data
+  99009: 4100,
+  // CMR Meeting Not Supported (meeting exists, but not CMR meeting)
+  403040: 4100,
+  // Requires Moderator Pin or Guest Pin
+  403041: 4005,
+  // Meeting is not allow to access since password or hostKey error
+  403038: 4005,
+  // Meeting is not allow to access since require password or hostKey
+  403036: 4005,
+  // Invalid panelist Pin
+  403043: 4100,
+  // Device not registered in org
+  403048: 4100,
+  // Not allowed to join external meetings
+  403049: 4100,
+  403100: 4100,
+  // Enforce sign in: need login before access when policy enforce sign in
+  403101: 4100,
+  // Enforce sign in: sign in with your email address that is approved by your organization
+  403102: 4100,
+  // Join internal Meeting: need login before access when policy enforce sign in
+  403103: 4100,
+  // Join internal Meeting: The host's organization policy doesn't allow your account to join this meeting. Try switching to another account
+  403104: 4100,
+  404001: 4100,
+  // Site data not found
+  404006: 4100,
+  // Too many requests access
+  429005: 4100,
+};
+
 export const trigger = {
   USER_INTERACTION: 'user-interaction',
   MERCURY_EVENT: 'mercury-event',
@@ -481,15 +530,5 @@ export const errorObjects = {
 
 export const UNKNOWN = 'unknown';
 
-export const OS_NAME = {
-  WINDOWS: 'windows',
-  MAC: 'mac',
-  IOS: 'ios',
-  ANDROID: 'android',
-  CHROME: 'chrome',
-  LINUX: 'linux',
-  OTHERS: 'other',
-};
-
 export const CLIENT_NAME = 'webex-js-sdk';
 export const PLATFORM = 'Web';

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',
@@ -40,10 +41,6 @@ const BEHAVIORAL_METRICS = {
   INVALID_ICE_CANDIDATE: 'js_sdk_invalid_ice_candidate',
   UPLOAD_LOGS_FAILURE: 'js_sdk_upload_logs_failure',
   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 +53,7 @@ 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',
 };
 
 export {BEHAVIORAL_METRICS as default};