@webex/plugin-meetings 2.60.0-next.9 → 2.60.1

package/src/breakouts/request.ts

@@ -1,55 +0,0 @@
-import {StatelessWebexPlugin} from '@webex/webex-core';
-import LoggerProxy from '../common/logs/logger-proxy';
-import {getBroadcastRoles} from './utils';
-import {HTTP_VERBS} from '../constants';
-
-/**
- * @class BreakoutRequest
- */
-export default class BreakoutRequest extends StatelessWebexPlugin {
-  /**
-   * Broadcast message to all breakout session's participants
-   * @param {String} url
-   * @param {String} message
-   * @param {Object} options
-   * @param {string} groupId
-   * @param {string} sessionId
-   * @returns {Promise}
-   */
-  broadcast({
-    url,
-    message,
-    options,
-    groupId,
-    sessionId,
-  }: {
-    url: string;
-    message: string;
-    options?: object;
-    groupId: string;
-    sessionId?: string;
-  }) {
-    const roles = getBroadcastRoles(options);
-    const params = {
-      id: groupId,
-      recipientRoles: roles.length ? roles : undefined,
-      sessions: sessionId ? [{id: sessionId}] : undefined,
-    };
-
-    // @ts-ignore
-    return this.request({
-      method: HTTP_VERBS.POST,
-      uri: `${url}/message`,
-      body: {
-        message,
-        groups: [params],
-      },
-    }).catch((error) => {
-      if (error.body && error.body.errorCode === 201409036 && error.statusCode === 409) {
-        LoggerProxy.logger.info(`Breakouts#broadcast --> no joined participants`);
-      } else {
-        throw error;
-      }
-    });
-  }
-}

package/src/breakouts/utils.ts

@@ -1,57 +0,0 @@
-// eslint-disable-next-line import/prefer-default-export
-import LoggerProxy from '../common/logs/logger-proxy';
-import BreakoutEditLockedError from './edit-lock-error';
-import {BREAKOUTS} from '../constants';
-
-export const getBroadcastRoles = (options): string[] => {
-  const recipientRoles = [];
-  if (!options || (!options.cohosts && !options.presenters)) {
-    return recipientRoles;
-  }
-  if (options.cohosts) {
-    recipientRoles.push('COHOST');
-  }
-  if (options.presenters) {
-    recipientRoles.push('PRESENTER');
-  }
-
-  return recipientRoles;
-};
-
-/**
- * Deals with all kinds of errors of breakout service
- * @param {object} error // one of the breakout service error
- * @param {string} position // position of the error occur
- * @returns {object}
- */
-export const boServiceErrorHandler = (error: any, position: string): any => {
-  const errorCode = error?.body?.errorCode;
-  const {EDIT_LOCK_TOKEN_MISMATCH, EDIT_NOT_AUTHORIZED} = BREAKOUTS.ERROR_CODE;
-  let throwError;
-  switch (errorCode) {
-    case EDIT_LOCK_TOKEN_MISMATCH:
-      throwError = new BreakoutEditLockedError('Edit lock token mismatch', error);
-      break;
-    case EDIT_NOT_AUTHORIZED:
-      throwError = new BreakoutEditLockedError('Not authorized to interact with edit lock', error);
-      break;
-    default:
-      throwError = error;
-  }
-  LoggerProxy.logger.info(`${position} --> ${throwError?.message}`);
-
-  return throwError;
-};
-
-/**
- *
- * @param {object} breakout
- * @param {string} newSessionType
- * @returns {boolean}
- */
-export const isSessionTypeChangedFromSessionToMain = (breakout, newSessionType) => {
-  return (
-    breakout.previous('sessionType') === BREAKOUTS.SESSION_TYPES.BREAKOUT &&
-    newSessionType === BREAKOUTS.SESSION_TYPES.MAIN
-  );
-};

package/src/common/errors/no-meeting-info.ts

@@ -1,24 +0,0 @@
-import {ERROR_DICTIONARY} from '../../constants';
-
-/**
- * Extended Error object for general parameter errors
- */
-export default class NoMeetingInfoError extends Error {
-  code: any;
-  error: any;
-  sdkMessage: any;
-
-  /**
-   * @constructor
-   * @param {String} [message]
-   * @param {Object} [error]
-   */
-  constructor(message: string = ERROR_DICTIONARY.NO_MEETING_INFO.MESSAGE, error: any = null) {
-    super(message);
-    this.name = ERROR_DICTIONARY.NO_MEETING_INFO.NAME;
-    this.sdkMessage = ERROR_DICTIONARY.NO_MEETING_INFO.MESSAGE;
-    this.error = error;
-    this.stack = error ? error.stack : new Error().stack;
-    this.code = ERROR_DICTIONARY.NO_MEETING_INFO.CODE;
-  }
-}

package/src/controls-options-manager/types.ts

@@ -1,59 +0,0 @@
-import {Control} from './enums';
-
-export interface ControlProperties {
-  /**
-   * A list of additional properties that apply to various specific settings.
-   *
-   * @remarks
-   * The values stored here, per the service, are fully ambiguous, an can vary
-   * depending on which control scope is being configured.
-   */
-  [key: string]: boolean;
-}
-
-export interface AudioProperties {
-  muted?: boolean;
-  disallowUnmute?: boolean;
-  muteOnEntry?: boolean;
-}
-
-export interface RaiseHandProperties {
-  enabled?: boolean;
-}
-
-export interface ReactionsProperties {
-  enabled?: boolean;
-  showDisplayNameWithReactions?: boolean;
-}
-
-export interface ShareControlProperties {
-  control?: 'ANYONE' | 'MODERATOR_PRESENTER';
-}
-
-export interface VideoProperties {
-  enabled?: boolean;
-}
-
-export interface ViewTheParticipantListProperties {
-  enabled?: boolean;
-}
-
-export type Properties =
-  | AudioProperties
-  | RaiseHandProperties
-  | ReactionsProperties
-  | ShareControlProperties
-  | VideoProperties
-  | ViewTheParticipantListProperties;
-
-export interface ControlConfig<Props = Properties> {
-  /**
-   * The scope of the control within this object.
-   */
-  scope: Control;
-
-  /**
-   * The properties to assign to this control.
-   */
-  properties: Props;
-}

package/src/index.ts

@@ -1,40 +0,0 @@
-/* eslint-env browser */
-import {registerPlugin} from '@webex/webex-core';
-
-import Meetings from './meetings';
-import config from './config';
-
-registerPlugin('meetings', Meetings, {
-  config,
-});
-
-export {
-  getDevices,
-  LocalStream,
-  LocalDisplayStream,
-  LocalSystemAudioStream,
-  LocalStreamEventNames,
-  StreamEventNames,
-  type ServerMuteReason,
-  LocalMicrophoneStreamEventNames,
-  LocalCameraStreamEventNames,
-  LocalMicrophoneStream,
-  LocalCameraStream,
-  createMicrophoneStream,
-  createCameraStream,
-  createDisplayStream,
-  createDisplayStreamWithAudio,
-  FacingMode,
-  DisplaySurface,
-  PresetCameraConstraints,
-  type VideoContentHint,
-} from '@webex/media-helpers';
-
-export default Meetings;
-
-export * as CONSTANTS from './constants';
-export * as REACTIONS from './reactions/reactions';
-
-export {RemoteMedia} from './multistream/remoteMedia';
-
-export {default as TriggerProxy} from './common/events/trigger-proxy';

package/src/interpretation/README.md

@@ -1,60 +0,0 @@
-# Simultaneous Interpretation
-
-Simultaneous Interpretation (SI) feature provides support for interpretation of in-meeting audio. The host will specify the target languages at schedule time and assign language pairs to the desired interpreters. Each interpreter will use their client to indicate the language spoken at any point in time. For example, Alice might be translating between English and French. When an English speaker is talking in the meeting, Alice will use her client to indicate she is speaking French. When a French speaker is talking, Alice will indicate that she is speaking English. The host’s client will display the status of each interpreter including the current interpretation direction.
-
-### Structure
-SI languages are available in the siLanguages collection. List the languages which current meeting support to do simultaneous interpretation. Can subscribe the language's voice channel which you want to listen from the list.
-
-```javascript
-interpretation.siLanguages;
-```
-### Attendee functionality
-```javascript
-//subscribe this si language's voice channel
-siLanguage.subscribe();
-
-//unsubscribe this si language's voice channel
-siLanguage.unsubscribe();
-```
-### Host functionality
-The following are methods available to the host of a meeting.
-
-```javascript
-//get the support list of interpretation languages. only host is allowed to call it
-interpretation.getSupportLanguages();
-
-//get the interpreters list of the meeting
-interpretation.getInterpreters();
-
-//update the interpreters list, input parameter is an array of interpreters
-interpretation.updateInterpreters([{
-  sourceLanguage : 'fr-FR',
-  targetLanguage : 'zh-ZH',
-  usingResource : {
-    id : 'a96747e2-1fc6-41d3-9ac7-512dd9478b6e'
-  },
-  order : 0
-},]);
-```
-
-### Interpreter functionality
-
-The following are methods available to the interpreters of a meeting.
-
-```javascript
-//Change direction of interpretation for an interpreter participant
-interpretation.changeDirection();
-
-//Handoff between interpreters, input paramerter participantId is the target to handoff
-interpretation.handoffInterpreter(participantId);
-
-//in-active interpreter request to handoff to self
-interpretation.requestHandoff();
-
-//accept the request of handoff, input paramter url is from last approval event which generate by server side
-interpretation.acceptRequest(url);
-
-//decline the request of handoff, input paramter url is from last approval event which generate by server side
-interpretation.declineRequest(url);
-
-```

package/src/interpretation/collection.ts

@@ -1,19 +0,0 @@
-/*!
- * Copyright (c) 2015-2023 Cisco Systems, Inc. See LICENSE file.
- */
-
-import AmpCollection from 'ampersand-collection';
-
-import {MEETINGS} from '../constants';
-
-import SILanguage from './siLanguage';
-
-const SILanguageCollection = AmpCollection.extend({
-  model: SILanguage,
-
-  namespace: MEETINGS,
-
-  mainIndex: 'languageName',
-});
-
-export default SILanguageCollection;

package/src/interpretation/index.ts

@@ -1,332 +0,0 @@
-/*!
- * Copyright (c) 2015-2023 Cisco Systems, Inc. See LICENSE file.
- */
-import {WebexPlugin} from '@webex/webex-core';
-import LoggerProxy from '../common/logs/logger-proxy';
-import {HTTP_VERBS, INTERPRETATION, MEETINGS} from '../constants';
-
-import SILanguageCollection from './collection';
-
-/**
- * @class SimultaneousInterpretation
- */
-const SimultaneousInterpretation = WebexPlugin.extend({
-  namespace: MEETINGS,
-  collections: {
-    siLanguages: SILanguageCollection,
-  },
-
-  props: {
-    locusUrl: 'string', // appears current meeting's locus url
-    approvalUrl: 'string', // appears current meeting's approval url for handoff between interpreters
-    originalLanguage: 'string', // appears current meeting's original language
-    sourceLanguage: 'string', // appears self interpreter's source language
-    targetLanguage: 'string', // appears self interpreter's target language
-    receiveLanguage: 'string', // appears self's receive language
-    order: 'number', // appears the order of self as interpreter
-    isActive: 'boolean', // appears self is interpreter and is active
-    selfParticipantId: 'string', // appears the self participant id
-    canManageInterpreters: 'boolean', // appears the ability to manage interpreters
-    supportLanguages: 'array', // appears the support languages
-    meetingSIEnabled: 'boolean', // appears the meeting support SI feature
-    hostSIEnabled: 'boolean', // appears the meeting host/interpreter feature of SI enabled
-    selfIsInterpreter: 'boolean', // current user is interpreter or not
-  },
-  derived: {
-    shouldQuerySupportLanguages: {
-      cache: false,
-      deps: ['canManageInterpreters', 'hostSIEnabled'],
-      /**
-       * Returns should query support languages or not
-       * @returns {boolean}
-       */
-      fn() {
-        return !!(this.canManageInterpreters && this.hostSIEnabled);
-      },
-    },
-  },
-  /**
-   * initialize for interpretation
-   * @returns {void}
-   */
-  initialize() {
-    this.listenTo(this, 'change:shouldQuerySupportLanguages', () => {
-      if (this.canManageInterpreters && !this.supportLanguages) {
-        this.querySupportLanguages();
-      }
-    });
-    this.listenToHandoffRequests();
-  },
-
-  /**
-   * Calls this to clean up listeners
-   * @returns {void}
-   */
-  cleanUp() {
-    this.stopListening();
-  },
-  /**
-   * Update the current locus url of the meeting
-   * @param {string} locusUrl // locus url
-   * @returns {void}
-   */
-  locusUrlUpdate(locusUrl) {
-    this.set('locusUrl', locusUrl);
-  },
-  /**
-   * Update the approval url for handoff
-   * @param {string} approvalUrl // approval url
-   * @returns {void}
-   */
-  approvalUrlUpdate(approvalUrl) {
-    this.set('approvalUrl', approvalUrl);
-  },
-  /**
-   * Update whether self has capability to manage interpreters (only host can manage it)
-   * @param {boolean} canManageInterpreters
-   * @returns {void}
-   */
-  updateCanManageInterpreters(canManageInterpreters) {
-    this.set('canManageInterpreters', canManageInterpreters);
-  },
-  /**
-   * Update whether the meeting's host si is enabled or not
-   * @param {boolean} hostSIEnabled
-   * @returns {void}
-   */
-  updateHostSIEnabled(hostSIEnabled) {
-    this.set('hostSIEnabled', hostSIEnabled);
-  },
-
-  /**
-   * Update whether the meeting support SI feature or not from meeting info
-   * @param {boolean} meetingSIEnabled
-   * @param {boolean} selfIsInterpreter
-   * @returns {void}
-   */
-  updateMeetingSIEnabled(meetingSIEnabled: boolean, selfIsInterpreter): void {
-    this.set('meetingSIEnabled', meetingSIEnabled);
-    this.set('selfIsInterpreter', selfIsInterpreter);
-  },
-
-  /**
-   * Update the interpretation languages channels which user can choose to subscribe
-   * @param {Object} interpretation
-   * @returns {void}
-   */
-  updateInterpretation(interpretation) {
-    this.siLanguages.set(interpretation?.siLanguages || []);
-  },
-  /**
-   * Update self's interpretation information (self is interpreter)
-   * @param {Object} interpretation
-   * @param {String} selfParticipantId
-   * @returns {void}
-   */
-  updateSelfInterpretation({interpretation, selfParticipantId}) {
-    const {originalLanguage, sourceLanguage, order, isActive, targetLanguage, receiveLanguage} =
-      interpretation || {};
-    this.set({originalLanguage, sourceLanguage, order, isActive, targetLanguage, receiveLanguage});
-    this.set('selfParticipantId', selfParticipantId);
-  },
-  /**
-   * query interpretation languages
-   * @returns {Promise}
-   */
-  querySupportLanguages() {
-    return this.request({
-      method: HTTP_VERBS.GET,
-      uri: `${this.locusUrl}/languages/interpretation`,
-    })
-      .then((result) => {
-        this.set('supportLanguages', result.body?.siLanguages);
-        this.trigger(INTERPRETATION.EVENTS.SUPPORT_LANGUAGES_UPDATE);
-      })
-      .catch((error) => {
-        LoggerProxy.logger.error('Meeting:interpretation#querySupportLanguages failed', error);
-        throw error;
-      });
-  },
-  /**
-   * get interpreters of the meeting
-   * @returns {Promise}
-   */
-  getInterpreters() {
-    return this.request({
-      method: HTTP_VERBS.GET,
-      uri: `${this.locusUrl}/interpretation/interpreters`,
-    }).catch((error) => {
-      LoggerProxy.logger.error('Meeting:interpretation#getInterpreters failed', error);
-      throw error;
-    });
-  },
-  /**
-   * update interpreters of the meeting
-   * @param {Array} interpreters
-   * @returns {Promise}
-   */
-  updateInterpreters(interpreters) {
-    return this.request({
-      method: HTTP_VERBS.PATCH,
-      uri: `${this.locusUrl}/controls`,
-      body: {
-        interpretation: {
-          interpreters,
-        },
-      },
-    }).catch((error) => {
-      LoggerProxy.logger.error('Meeting:interpretation#updateInterpreters failed', error);
-      throw error;
-    });
-  },
-  /**
-   * Change direction of interpretation for an interpreter participant
-   * @returns {Promise}
-   */
-  changeDirection() {
-    if (!this.sourceLanguage || !this.targetLanguage) {
-      return Promise.reject(new Error('Missing sourceLanguage or targetLanguage'));
-    }
-
-    if (!this.selfParticipantId) {
-      return Promise.reject(new Error('Missing self participant id'));
-    }
-
-    return this.request({
-      method: HTTP_VERBS.PATCH,
-      uri: `${this.locusUrl}/participant/${this.selfParticipantId}/controls`,
-      body: {
-        interpretation: {
-          sourceLanguage: this.targetLanguage,
-          targetLanguage: this.sourceLanguage,
-          isActive: this.isActive,
-          order: this.order,
-        },
-      },
-    }).catch((error) => {
-      LoggerProxy.logger.error('Meeting:interpretation#changeDirection failed', error);
-      throw error;
-    });
-  },
-  /**
-   * Sets up a listener for handoff requests from mercury
-   * @returns {void}
-   */
-  listenToHandoffRequests() {
-    this.listenTo(this.webex.internal.mercury, 'event:locus.approval_request', (event) => {
-      if (event?.data?.approval?.resourceType === INTERPRETATION.RESOURCE_TYPE) {
-        const {receivers, initiator, actionType, url} = event.data.approval;
-        const receiverId = receivers?.[0]?.participantId;
-        const isReceiver = !!receiverId && receiverId === this.selfParticipantId;
-        const senderId = initiator?.participantId;
-        const isSender = !!senderId && senderId === this.selfParticipantId;
-        if (!isReceiver && !isSender) {
-          return;
-        }
-        this.trigger(INTERPRETATION.EVENTS.HANDOFF_REQUESTS_ARRIVED, {
-          actionType,
-          isReceiver,
-          isSender,
-          senderId,
-          receiverId,
-          url,
-        });
-      }
-    });
-  },
-  /**
-   * handoff the active interpreter role to another interpreter in same group, only the interpreter is allowed to call this api
-   * @param {string} participantId the participant id you want to hand off
-   * @returns {Promise}
-   */
-  handoffInterpreter(participantId) {
-    if (!participantId) {
-      return Promise.reject(new Error('Missing target participant id'));
-    }
-    if (!this.approvalUrl) {
-      return Promise.reject(new Error('Missing approval url'));
-    }
-
-    return this.request({
-      method: HTTP_VERBS.POST,
-      uri: this.approvalUrl,
-      body: {
-        actionType: INTERPRETATION.ACTION_TYPE.OFFERED,
-        resourceType: INTERPRETATION.RESOURCE_TYPE,
-        receivers: [
-          {
-            participantId,
-          },
-        ],
-      },
-    }).catch((error) => {
-      LoggerProxy.logger.error('Meeting:interpretation#handoffInterpreter failed', error);
-      throw error;
-    });
-  },
-  /**
-   * the in-active interpreter request to hand off the active role to self
-   * @returns {Promise}
-   */
-  requestHandoff() {
-    if (!this.approvalUrl) {
-      return Promise.reject(new Error('Missing approval url'));
-    }
-
-    return this.request({
-      method: HTTP_VERBS.POST,
-      uri: this.approvalUrl,
-      body: {
-        actionType: INTERPRETATION.ACTION_TYPE.REQUESTED,
-        resourceType: INTERPRETATION.RESOURCE_TYPE,
-      },
-    }).catch((error) => {
-      LoggerProxy.logger.error('Meeting:interpretation#requestHandoff failed', error);
-      throw error;
-    });
-  },
-  /**
-   * accept the request of handoff
-   * @param {String} url the url get from last approval event
-   * @returns {Promise}
-   */
-  acceptRequest(url) {
-    if (!url) {
-      return Promise.reject(new Error('Missing the url to accept'));
-    }
-
-    return this.request({
-      method: HTTP_VERBS.PUT,
-      uri: url,
-      body: {
-        actionType: INTERPRETATION.ACTION_TYPE.ACCEPTED,
-      },
-    }).catch((error) => {
-      LoggerProxy.logger.error('Meeting:interpretation#acceptRequest failed', error);
-      throw error;
-    });
-  },
-  /**
-   * decline the request of handoff
-   * @param {String} url the url get from last approval event
-   * @returns {Promise}
-   */
-  declineRequest(url) {
-    if (!url) {
-      return Promise.reject(new Error('Missing the url to decline'));
-    }
-
-    return this.request({
-      method: HTTP_VERBS.PUT,
-      uri: url,
-      body: {
-        actionType: INTERPRETATION.ACTION_TYPE.DECLINED,
-      },
-    }).catch((error) => {
-      LoggerProxy.logger.error('Meeting:interpretation#declineRequest failed', error);
-      throw error;
-    });
-  },
-});
-
-export default SimultaneousInterpretation;

package/src/interpretation/siLanguage.ts

@@ -1,18 +0,0 @@
-/*!
- * Copyright (c) 2015-2023 Cisco Systems, Inc. See LICENSE file.
- */
-
-import {WebexPlugin} from '@webex/webex-core';
-import {MEETINGS} from '../constants';
-
-const SILanguage = WebexPlugin.extend({
-  idAttribute: 'languageName',
-
-  namespace: MEETINGS,
-  props: {
-    languageCode: 'number',
-    languageName: 'string',
-  },
-});
-
-export default SILanguage;