@webex/plugin-meetings 3.6.0 → 3.7.0

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

@@ -177,7 +177,12 @@ export default class ControlsOptionsManager {
    * @memberof ControlsOptionsManager
    * @returns {Promise}
    */
-  private setControls(setting: {[key in Setting]?: boolean}): Promise<any> {
+  private setControls(setting: {
+    [Setting.muted]?: boolean;
+    [Setting.disallowUnmute]?: boolean;
+    [Setting.muteOnEntry]?: boolean;
+    [Setting.roles]?: Array<string>;
+  }): Promise<any> {
     LoggerProxy.logger.log(
       `ControlsOptionsManager:index#setControls --> ${JSON.stringify(setting)}`
     );
@@ -190,6 +195,7 @@ export default class ControlsOptionsManager {
     Object.entries(setting).forEach(([key, value]) => {
       if (
         !shouldSkipCheckToMergeBody &&
+        value !== undefined &&
         !Util?.[`${value ? CAN_SET : CAN_UNSET}${key}`](this.displayHints)
       ) {
         error = new PermissionError(`${key} [${value}] not allowed, due to moderator property.`);
@@ -219,6 +225,14 @@ export default class ControlsOptionsManager {
           }
           break;
 
+        case Setting.roles:
+          if (Array.isArray(value)) {
+            body.audio = body.audio
+              ? {...body.audio, [camelCase(key)]: value}
+              : {[camelCase(key)]: value};
+          }
+          break;
+
         default:
           error = new PermissionError(`${key} [${value}] not allowed, due to moderator property.`);
       }
@@ -261,18 +275,21 @@ export default class ControlsOptionsManager {
    * @param {boolean} mutedEnabled
    * @param {boolean} disallowUnmuteEnabled
    * @param {boolean} muteOnEntryEnabled
+   * @param {array} roles which should be muted
    * @memberof ControlsOptionsManager
    * @returns {Promise}
    */
   public setMuteAll(
     mutedEnabled: boolean,
     disallowUnmuteEnabled: boolean,
-    muteOnEntryEnabled: boolean
+    muteOnEntryEnabled: boolean,
+    roles: Array<string>
   ): Promise<any> {
     return this.setControls({
       [Setting.muted]: mutedEnabled,
       [Setting.disallowUnmute]: disallowUnmuteEnabled,
       [Setting.muteOnEntry]: muteOnEntryEnabled,
+      [Setting.roles]: roles,
     });
   }
 }

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

@@ -36,6 +36,8 @@ export interface VideoProperties {
 
 export interface ViewTheParticipantListProperties {
   enabled?: boolean;
+  panelistEnabled?: boolean;
+  attendeeCount?: boolean;
 }
 
 export type Properties =

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

@@ -217,6 +217,18 @@ class Utils {
     if (control.properties.enabled === false) {
       requiredHints.push(DISPLAY_HINTS.DISABLE_VIEW_THE_PARTICIPANT_LIST);
     }
+    if (control.properties.panelistEnabled === true) {
+      requiredHints.push(DISPLAY_HINTS.ENABLE_VIEW_THE_PARTICIPANT_LIST_PANELIST);
+    }
+    if (control.properties.panelistEnabled === false) {
+      requiredHints.push(DISPLAY_HINTS.DISABLE_VIEW_THE_PARTICIPANT_LIST_PANELIST);
+    }
+    if (control.properties.attendeeCount === true) {
+      requiredHints.push(DISPLAY_HINTS.ENABLE_SHOW_ATTENDEE_COUNT);
+    }
+    if (control.properties.attendeeCount === false) {
+      requiredHints.push(DISPLAY_HINTS.DISABLE_SHOW_ATTENDEE_COUNT);
+    }
 
     return Utils.hasHints({requiredHints, displayHints});
   }

package/src/index.ts

@@ -8,6 +8,7 @@ import CaptchaError from './common/errors/captcha-error';
 import IntentToJoinError from './common/errors/intent-to-join';
 import PasswordError from './common/errors/password-error';
 import PermissionError from './common/errors/permission';
+import WebinarRegistrationError from './common/errors/webinar-registration-error';
 import {
   ReclaimHostEmptyWrongKeyError,
   ReclaimHostIsHostAlreadyError,
@@ -68,6 +69,7 @@ export {
   ReclaimHostEmptyWrongKeyError,
   Meeting,
   MeetingInfoUtil,
+  WebinarRegistrationError,
 };
 
 export {RemoteMedia} from './multistream/remoteMedia';

package/src/locus-info/controlsUtils.ts

@@ -79,7 +79,11 @@ ControlsUtils.parse = (controls: any) => {
   }
 
   if (controls?.viewTheParticipantList) {
-    parsedControls.viewTheParticipantList = {enabled: controls.viewTheParticipantList.enabled};
+    parsedControls.viewTheParticipantList = {
+      enabled: controls.viewTheParticipantList?.enabled ?? false,
+      panelistEnabled: controls.viewTheParticipantList?.panelistEnabled ?? false,
+      attendeeCount: controls.viewTheParticipantList?.attendeeCount ?? 0,
+    };
   }
 
   if (controls?.raiseHand) {
@@ -90,6 +94,23 @@ ControlsUtils.parse = (controls: any) => {
     parsedControls.video = {enabled: controls.video.enabled};
   }
 
+  if (controls?.webcastControl) {
+    parsedControls.webcastControl = {streaming: controls.webcastControl.streaming};
+  }
+
+  if (controls?.meetingFull) {
+    parsedControls.meetingFull = {
+      meetingFull: controls.meetingFull?.meetingFull ?? false,
+      meetingPanelistFull: controls.meetingFull?.meetingPanelistFull ?? false,
+    };
+  }
+
+  if (controls?.practiceSession) {
+    parsedControls.practiceSession = {
+      enabled: controls.practiceSession.enabled,
+    };
+  }
+
   return parsedControls;
 };
 
@@ -121,7 +142,11 @@ ControlsUtils.getControls = (oldControls: any, newControls: any) => {
         previous?.reactions?.showDisplayNameWithReactions,
 
       hasViewTheParticipantListChanged:
-        current?.viewTheParticipantList?.enabled !== previous?.viewTheParticipantList?.enabled,
+        current?.viewTheParticipantList?.enabled !== previous?.viewTheParticipantList?.enabled ||
+        current?.viewTheParticipantList?.panelistEnabled !==
+          previous?.viewTheParticipantList?.panelistEnabled ||
+        current?.viewTheParticipantList?.attendeeCount !==
+          previous?.viewTheParticipantList?.attendeeCount,
 
       hasRaiseHandChanged: current?.raiseHand?.enabled !== previous?.raiseHand?.enabled,
 
@@ -167,6 +192,25 @@ ControlsUtils.getControls = (oldControls: any, newControls: any) => {
       hasVideoEnabledChanged:
         newControls.video?.enabled !== undefined &&
         !isEqual(previous?.videoEnabled, current?.videoEnabled),
+
+      hasWebcastChanged: !isEqual(
+        previous?.webcastControl?.streaming,
+        current?.webcastControl?.streaming
+      ),
+
+      hasMeetingFullChanged:
+        !isEqual(previous?.meetingFull?.meetingFull, current?.meetingFull?.meetingFull) ||
+        !isEqual(
+          previous?.meetingFull?.meetingPanelistFull,
+          current?.meetingFull?.meetingPanelistFull
+        ),
+
+      hasPracticeSessionEnabledChanged: !isEqual(
+        previous?.practiceSession?.enabled,
+        current?.practiceSession?.enabled
+      ),
+
+      hasStageViewChanged: !isEqual(previous?.videoLayout, current?.videoLayout),
     },
   };
 };

package/src/locus-info/fullState.ts

@@ -6,6 +6,7 @@ FullState.parse = (fullState) => ({
   type: fullState.type || FULL_STATE.UNKNOWN,
   meetingState: fullState.state,
   locked: fullState.locked,
+  attendeeCount: typeof fullState.attendeeCount === 'number' ? fullState.attendeeCount : 0,
 });
 
 FullState.getFullState = (oldFullState, newFullState) => {

package/src/locus-info/index.ts

@@ -64,6 +64,7 @@ export default class LocusInfo extends EventsScope {
   replace: any;
   url: any;
   services: any;
+  resources: any;
   mainSessionLocusCache: any;
   /**
    * Constructor
@@ -263,6 +264,7 @@ export default class LocusInfo extends EventsScope {
     this.updateHostInfo(locus.host);
     this.updateMediaShares(locus.mediaShares);
     this.updateServices(locus.links?.services);
+    this.updateResources(locus.links?.resources);
   }
 
   /**
@@ -452,6 +454,7 @@ export default class LocusInfo extends EventsScope {
     this.updateIdentifiers(locus.identities);
     this.updateEmbeddedApps(locus.embeddedApps);
     this.updateServices(locus.links?.services);
+    this.updateResources(locus.links?.resources);
     this.compareAndUpdate();
     // update which required to compare different objects from locus
   }
@@ -805,6 +808,10 @@ export default class LocusInfo extends EventsScope {
           hasRaiseHandChanged,
           hasVideoChanged,
           hasInterpretationChanged,
+          hasWebcastChanged,
+          hasMeetingFullChanged,
+          hasPracticeSessionEnabledChanged,
+          hasStageViewChanged,
         },
         current,
       } = ControlsUtils.getControls(this.controls, controls);
@@ -1008,6 +1015,38 @@ export default class LocusInfo extends EventsScope {
         );
       }
 
+      if (hasWebcastChanged) {
+        this.emitScoped(
+          {file: 'locus-info', function: 'updateControls'},
+          LOCUSINFO.EVENTS.CONTROLS_WEBCAST_CHANGED,
+          {state: current.webcastControl}
+        );
+      }
+
+      if (hasMeetingFullChanged) {
+        this.emitScoped(
+          {file: 'locus-info', function: 'updateControls'},
+          LOCUSINFO.EVENTS.CONTROLS_MEETING_FULL_CHANGED,
+          {state: current.meetingFull}
+        );
+      }
+
+      if (hasPracticeSessionEnabledChanged) {
+        this.emitScoped(
+          {file: 'locus-info', function: 'updateControls'},
+          LOCUSINFO.EVENTS.CONTROLS_PRACTICE_SESSION_STATUS_UPDATED,
+          {state: current.practiceSession}
+        );
+      }
+
+      if (hasStageViewChanged) {
+        this.emitScoped(
+          {file: 'locus-info', function: 'updateControls'},
+          LOCUSINFO.EVENTS.CONTROLS_STAGE_VIEW_UPDATED,
+          {state: current.videoLayout}
+        );
+      }
+
       this.controls = controls;
     }
   }
@@ -1064,6 +1103,27 @@ export default class LocusInfo extends EventsScope {
     }
   }
 
+  /**
+   * @param {Object} resources
+   * @returns {undefined}
+   * @memberof LocusInfo
+   */
+  updateResources(resources: Record<'webcastInstance', {url: string}>) {
+    if (resources && !isEqual(this.resources, resources)) {
+      this.resources = resources;
+      this.emitScoped(
+        {
+          file: 'locus-info',
+          function: 'updateResources',
+        },
+        LOCUSINFO.EVENTS.LINKS_RESOURCES,
+        {
+          resources,
+        }
+      );
+    }
+  }
+
   /**
    * @param {Object} fullState
    * @returns {undefined}

package/src/locus-info/parser.ts

@@ -771,7 +771,14 @@ export default class Parser {
         )}, Action: ${lociComparison}`
       );
 
-      this.onDeltaAction(lociComparison, newLoci);
+      try {
+        this.onDeltaAction(lociComparison, newLoci);
+      } catch (error) {
+        LoggerProxy.logger.error(
+          'Locus-info:parser#processDeltaEvent --> Error in onDeltaAction',
+          error
+        );
+      }
     }
 
     this.nextEvent();

package/src/meeting/in-meeting-actions.ts

@@ -3,6 +3,7 @@
  */
 
 import {MEETINGS} from '../constants';
+import ControlsOptionsUtil from '../controls-options-manager/util';
 
 /**
  * IInMeetingActions
@@ -64,6 +65,10 @@ interface IInMeetingActions {
   canUpdateShareControl?: boolean;
   canEnableViewTheParticipantsList?: boolean;
   canDisableViewTheParticipantsList?: boolean;
+  canEnableViewTheParticipantsListPanelist?: boolean;
+  canDisableViewTheParticipantsListPanelist?: boolean;
+  canEnableShowAttendeeCount?: boolean;
+  canDisableShowAttendeeCount?: boolean;
   canEnableRaiseHand?: boolean;
   canDisableRaiseHand?: boolean;
   canEnableVideo?: boolean;
@@ -83,6 +88,11 @@ interface IInMeetingActions {
   canShareWhiteBoard?: boolean;
   enforceVirtualBackground?: boolean;
   canPollingAndQA?: boolean;
+  canStartWebcast?: boolean;
+  canStopWebcast?: boolean;
+  canShowStageView?: boolean;
+  canEnableStageView?: boolean;
+  canDisableStageView?: boolean;
 }
 
 /**
@@ -201,6 +211,14 @@ export default class InMeetingActions implements IInMeetingActions {
 
   canDisableViewTheParticipantsList = null;
 
+  canEnableViewTheParticipantsListPanelist = null;
+
+  canDisableViewTheParticipantsListPanelist = null;
+
+  canEnableShowAttendeeCount = null;
+
+  canDisableShowAttendeeCount = null;
+
   canEnableRaiseHand = null;
 
   canDisableRaiseHand = null;
@@ -238,6 +256,16 @@ export default class InMeetingActions implements IInMeetingActions {
   canShareWhiteBoard = null;
 
   canPollingAndQA = null;
+
+  canStartWebcast = null;
+
+  canStopWebcast = null;
+
+  canShowStageView = null;
+
+  canEnableStageView = null;
+
+  canDisableStageView = null;
   /**
    * Returns all meeting action options
    * @returns {Object}
@@ -298,6 +326,10 @@ export default class InMeetingActions implements IInMeetingActions {
     canUpdateShareControl: this.canUpdateShareControl,
     canEnableViewTheParticipantsList: this.canEnableViewTheParticipantsList,
     canDisableViewTheParticipantsList: this.canDisableViewTheParticipantsList,
+    canEnableViewTheParticipantsListPanelist: this.canEnableViewTheParticipantsListPanelist,
+    canDisableViewTheParticipantsListPanelist: this.canDisableViewTheParticipantsListPanelist,
+    canEnableShowAttendeeCount: this.canEnableShowAttendeeCount,
+    canDisableShowAttendeeCount: this.canDisableShowAttendeeCount,
     canEnableRaiseHand: this.canEnableRaiseHand,
     canDisableRaiseHand: this.canDisableRaiseHand,
     canEnableVideo: this.canEnableVideo,
@@ -317,6 +349,11 @@ export default class InMeetingActions implements IInMeetingActions {
     supportHDV: this.supportHDV,
     canShareWhiteBoard: this.canShareWhiteBoard,
     canPollingAndQA: this.canPollingAndQA,
+    canStartWebcast: this.canStartWebcast,
+    canStopWebcast: this.canStopWebcast,
+    canShowStageView: this.canShowStageView,
+    canEnableStageView: this.canEnableStageView,
+    canDisableStageView: this.canDisableStageView,
   });
 
   /**