@webex/plugin-meetings 3.0.0-beta.2 → 3.0.0-beta.21

package/src/breakouts/index.ts

@@ -0,0 +1,225 @@
+/*!
+ * Copyright (c) 2015-2023 Cisco Systems, Inc. See LICENSE file.
+ */
+import {WebexPlugin} from '@webex/webex-core';
+import {debounce, forEach} from 'lodash';
+import LoggerProxy from '../common/logs/logger-proxy';
+
+import {BREAKOUTS, MEETINGS} from '../constants';
+
+import Breakout from './breakout';
+import BreakoutCollection from './collection';
+
+/**
+ * @class Breakouts
+ */
+const Breakouts = WebexPlugin.extend({
+  namespace: MEETINGS,
+
+  collections: {
+    breakouts: BreakoutCollection,
+  },
+
+  props: {
+    allowBackToMain: 'boolean', // only present when in a breakout session
+    delayCloseTime: 'number', // appears once breakouts start
+    enableBreakoutSession: 'boolean', // appears from the moment you enable breakouts
+    groupId: 'string', // appears from the moment you enable breakouts
+    name: 'string', // only present when in a breakout session
+    sessionId: 'string', // appears from the moment you enable breakouts
+    sessionType: 'string', // appears from the moment you enable breakouts
+    startTime: 'string', // appears once breakouts start
+    status: 'string', // only present when in a breakout session
+    url: 'string', // appears from the moment you enable breakouts
+    locusUrl: 'string', // the current locus url
+  },
+
+  children: {
+    currentBreakoutSession: Breakout,
+  },
+
+  derived: {
+    isInMainSession: {
+      deps: ['sessionType'],
+      /**
+       * Returns true if the user is in the main session
+       * @returns {boolean}
+       */
+      fn() {
+        return this.sessionType === BREAKOUTS.SESSION_TYPES.MAIN;
+      },
+    },
+  },
+
+  /**
+   * initialize for the breakouts
+   * @returns {void}
+   */
+  initialize() {
+    this.listenTo(this, 'change:status', () => {
+      if (this.status === BREAKOUTS.STATUS.CLOSING) {
+        this.trigger(BREAKOUTS.EVENTS.BREAKOUTS_CLOSING);
+      }
+    });
+    this.debouncedQueryRosters = debounce(this.queryRosters, 10, {
+      leading: true,
+      trailing: false,
+    });
+    this.listenTo(this.breakouts, 'add', () => {
+      this.debouncedQueryRosters();
+    });
+    this.listenToBroadcastMessages();
+    this.listenToBreakoutRosters();
+  },
+
+  /**
+   * 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);
+  },
+
+  /**
+   * The initial roster lists need to be queried because you don't
+   * get a breakout.roster event when you join the meeting
+   * @returns {void}
+   */
+  queryRosters() {
+    this.webex
+      .request({uri: `${this.url}/roster`, qs: {locusUrl: btoa(this.locusUrl)}})
+      .then((result) => {
+        const {
+          body: {rosters},
+        } = result;
+
+        rosters.forEach(({locus}) => {
+          this.handleRosterUpdate(locus);
+        });
+
+        this.trigger(BREAKOUTS.EVENTS.MEMBERS_UPDATE);
+      })
+      .catch((error) => {
+        LoggerProxy.logger.error('Meeting:breakouts#queryRosters failed', error);
+      });
+  },
+
+  /**
+   *
+   * @param {Object} locus // locus object
+   * @returns {void}
+   */
+  handleRosterUpdate(locus) {
+    const sessionId = locus.controls?.breakout?.sessionId;
+
+    const session = this.breakouts.get(sessionId);
+
+    if (!session) {
+      return;
+    }
+
+    session.parseRoster(locus);
+  },
+
+  /**
+   * Sets up listener for broadcast messages sent to the breakout session
+   * @returns {void}
+   */
+  listenToBroadcastMessages() {
+    this.listenTo(this.webex.internal.llm, 'event:breakout.message', (event) => {
+      const {
+        data: {senderUserId, sentTime, message},
+      } = event;
+
+      this.trigger(BREAKOUTS.EVENTS.MESSAGE, {
+        senderUserId,
+        sentTime,
+        message,
+        // FIXME: This is only the current sessionId
+        // We'd need to check that the dataChannelUrl is still the same
+        // to guarantee that this message was sent to this session
+        sessionId: this.currentBreakoutSession.sessionId,
+      });
+    });
+  },
+
+  /**
+   * Sets up a listener for roster messags from mecury
+   * @returns {void}
+   */
+  listenToBreakoutRosters() {
+    this.listenTo(this.webex.internal.mercury, 'event:breakout.roster', (event) => {
+      this.handleRosterUpdate(event.data.locus);
+      this.trigger(BREAKOUTS.EVENTS.MEMBERS_UPDATE);
+    });
+  },
+
+  /**
+   * Updates the information about the current breakout
+   * @param {Object} params
+   * @returns {void}
+   */
+  updateBreakout(params) {
+    this.set(params);
+
+    this.set('currentBreakoutSession', {
+      sessionId: params.sessionId,
+      groupId: params.groupId,
+      name: params.name,
+      current: true,
+      sessionType: params.sessionType,
+      url: params.url,
+      [BREAKOUTS.SESSION_STATES.ACTIVE]: false,
+      [BREAKOUTS.SESSION_STATES.ALLOWED]: false,
+      [BREAKOUTS.SESSION_STATES.ALLOWED]: false,
+      [BREAKOUTS.SESSION_STATES.ASSIGNED_CURRENT]: false,
+      [BREAKOUTS.SESSION_STATES.REQUESTED]: false,
+    });
+  },
+
+  /**
+   * Updates the information about available breakouts
+   * @param {Object} payload
+   * @returns {void}
+   */
+  updateBreakoutSessions(payload) {
+    const breakouts = {};
+
+    if (payload.breakoutSessions) {
+      forEach(BREAKOUTS.SESSION_STATES, (state) => {
+        forEach(payload.breakoutSessions[state], (breakout) => {
+          const {sessionId} = breakout;
+
+          if (!breakouts[sessionId]) {
+            breakouts[sessionId] = breakout;
+            breakouts[sessionId][BREAKOUTS.SESSION_STATES.ACTIVE] = false;
+            breakouts[sessionId][BREAKOUTS.SESSION_STATES.ASSIGNED] = false;
+            breakouts[sessionId][BREAKOUTS.SESSION_STATES.ALLOWED] = false;
+            breakouts[sessionId][BREAKOUTS.SESSION_STATES.ASSIGNED_CURRENT] = false;
+            breakouts[sessionId][BREAKOUTS.SESSION_STATES.REQUESTED] = false;
+          }
+
+          breakouts[sessionId][state] = true;
+        });
+      });
+    }
+
+    forEach(breakouts, (breakout: typeof Breakout) => {
+      // eslint-disable-next-line no-param-reassign
+      breakout.url = this.url;
+    });
+
+    this.breakouts.set(Object.values(breakouts));
+  },
+});
+
+export default Breakouts;

package/src/common/{browser-detection.js → browser-detection.ts}

@@ -1,3 +1,5 @@
+/* eslint-disable @typescript-eslint/no-var-requires */
+
 import bowser from 'bowser';
 import {memoize} from 'lodash';
 import window from 'global/window';
@@ -9,7 +11,7 @@ const mockDetectionObject = {
   /* eslint-enable global-require */
   getBrowserName: () => '',
   getBrowserVersion: () => '',
-  isBrowser: () => false
+  isBrowser: () => false,
 };
 
 const createDetectionObject = (results) => {
@@ -26,11 +28,12 @@ const createDetectionObject = (results) => {
     getOSVersion,
     getBrowserName,
     getBrowserVersion,
-    isBrowser
+    isBrowser,
   };
 };
 
-export default memoize((agent) => (agent || window.navigator?.userAgent ?
-  createDetectionObject(bowser.getParser(agent || window.navigator.userAgent)) :
-  mockDetectionObject
-));
+export default memoize((agent?: any) =>
+  agent || window.navigator?.userAgent
+    ? createDetectionObject(bowser.getParser(agent || window.navigator.userAgent))
+    : mockDetectionObject
+);

package/src/common/collection.ts

@@ -13,7 +13,7 @@ export default class Collection {
    * @param {String} property
    * @memberof Collection
    */
-  constructor(property) {
+  constructor(property: string) {
     if (!property || !isString(property)) {
       throw new ParameterError('Collection expects a string to use as a property name.');
     }
@@ -41,8 +41,10 @@ export default class Collection {
    * @public
    * @memberof Collection
    */
-  get(id) {
-    return this[this.propertyName] && this[this.propertyName][id] ? this[this.propertyName][id] : null;
+  public get(id: string) {
+    return this[this.propertyName] && this[this.propertyName][id]
+      ? this[this.propertyName][id]
+      : null;
   }
 
   /**
@@ -52,7 +54,7 @@ export default class Collection {
    * @public
    * @memberof Collection
    */
-  set(id, value) {
+  public set(id: string, value: any) {
     this[this.propertyName][id] = value;
 
     return this.get(id);
@@ -65,7 +67,7 @@ export default class Collection {
    * @public
    * @memberof Collection
    */
-  delete(id) {
+  public delete(id: string) {
     delete this[this.propertyName][id];
   }
 
@@ -74,7 +76,7 @@ export default class Collection {
    * @public
    * @memberof Collection
    */
-  getAll() {
+  public getAll() {
     return this[this.propertyName];
   }
 
@@ -84,7 +86,7 @@ export default class Collection {
    * @public
    * @memberof Collection
    */
-  setAll(set) {
+  public setAll(set: object) {
     this[this.propertyName] = set;
 
     return this.getAll();

package/src/common/{config.js → config.ts}

@@ -1,4 +1,4 @@
-const StaticConfig = {};
+const StaticConfig: any = {};
 
 StaticConfig.set = (options) => {
   const values = {};

package/src/common/errors/{captcha-error.js → captcha-error.ts}

@@ -4,18 +4,22 @@ import {ERROR_DICTIONARY} from '../../constants';
  * Extended Error object to signify captcha related errors
  */
 export default class CaptchaError extends Error {
+  code: any;
+  error: any;
+  sdkMessage: any;
+
   /**
-  *
-  * @constructor
-  * @param {String} [message]
-  * @param {Object} [error]
-  */
-  constructor(message = ERROR_DICTIONARY.CAPTCHA.MESSAGE, error = null) {
+   *
+   * @constructor
+   * @param {String} [message]
+   * @param {Object} [error]
+   */
+  constructor(message: string = ERROR_DICTIONARY.CAPTCHA.MESSAGE, error: any = null) {
     super(message);
     this.name = ERROR_DICTIONARY.CAPTCHA.NAME;
     this.sdkMessage = ERROR_DICTIONARY.CAPTCHA.MESSAGE;
     this.error = error;
-    this.stack = error ? error.stack : (new Error()).stack;
+    this.stack = error ? error.stack : new Error().stack;
     this.code = ERROR_DICTIONARY.CAPTCHA.CODE;
   }
 }

package/src/common/errors/{intent-to-join.js → intent-to-join.ts}

@@ -4,18 +4,23 @@ import {ERROR_DICTIONARY} from '../../constants';
  * Extended Error object to signify the intent to join for unclaimed PMR scenarios
  */
 export default class IntentToJoinError extends Error {
+  code: any;
+  error: any;
+  joinIntentRequired: any;
+  sdkMessage: any;
+
   /**
-  *
-  * @constructor
-  * @param {String} [message]
-  * @param {Object} [error]
-  */
-  constructor(message = ERROR_DICTIONARY.INTENT_TO_JOIN.MESSAGE, error = null) {
+   *
+   * @constructor
+   * @param {String} [message]
+   * @param {Object} [error]
+   */
+  constructor(message: string = ERROR_DICTIONARY.INTENT_TO_JOIN.MESSAGE, error: any = null) {
     super(message);
     this.name = ERROR_DICTIONARY.INTENT_TO_JOIN.NAME;
     this.sdkMessage = ERROR_DICTIONARY.INTENT_TO_JOIN.MESSAGE;
     this.error = error;
-    this.stack = error ? error.stack : (new Error()).stack;
+    this.stack = error ? error.stack : new Error().stack;
     this.joinIntentRequired = true;
     this.code = ERROR_DICTIONARY.INTENT_TO_JOIN.CODE;
   }

package/src/common/errors/{join-meeting.js → join-meeting.ts}

@@ -4,19 +4,28 @@ import {ERROR_DICTIONARY} from '../../constants';
  * Extended Error object to signify a join meeting error
  */
 export default class JoinMeetingError extends Error {
+  code: any;
+  error: any;
+  joinOptions: any;
+  sdkMessage: any;
+
   /**
-  *
-  * @constructor
-  * @param {Object} [options]
-  * @param {String} [message]
-  * @param {Object} [error]
-  */
-  constructor(options = {}, message = ERROR_DICTIONARY.JOIN_MEETING.MESSAGE, error = null) {
+   *
+   * @constructor
+   * @param {Object} [options]
+   * @param {String} [message]
+   * @param {Object} [error]
+   */
+  constructor(
+    options: object = {},
+    message: string = ERROR_DICTIONARY.JOIN_MEETING.MESSAGE,
+    error: any = null
+  ) {
     super(message);
     this.name = ERROR_DICTIONARY.JOIN_MEETING.NAME;
     this.sdkMessage = ERROR_DICTIONARY.JOIN_MEETING.MESSAGE;
     this.error = error;
-    this.stack = error ? error.stack : (new Error()).stack;
+    this.stack = error ? error.stack : new Error().stack;
     this.joinOptions = options;
     this.code = ERROR_DICTIONARY.JOIN_MEETING.CODE;
   }

package/src/common/errors/{media.js → media.ts}

@@ -4,18 +4,22 @@ import {ERROR_DICTIONARY} from '../../constants';
  * Extended Error object for media errors
  */
 export default class MediaError extends Error {
+  code: any;
+  error: any;
+  sdkMessage: any;
+
   /**
-  *
-  * @constructor
-  * @param {String} [message]
-  * @param {Object} [error]
-  */
-  constructor(message = ERROR_DICTIONARY.MEDIA.MESSAGE, error = null) {
+   *
+   * @constructor
+   * @param {String} [message]
+   * @param {Object} [error]
+   */
+  constructor(message: string = ERROR_DICTIONARY.MEDIA.MESSAGE, error: any = null) {
     super(message);
     this.name = ERROR_DICTIONARY.RECONNECTION.NAME;
     this.sdkMessage = ERROR_DICTIONARY.MEDIA.MESSAGE;
     this.error = error;
-    this.stack = error ? error.stack : (new Error()).stack;
+    this.stack = error ? error.stack : new Error().stack;
     this.code = ERROR_DICTIONARY.RECONNECTION.CODE;
   }
 }

package/src/common/errors/parameter.ts

@@ -1,4 +1,4 @@
-import * as MEETINGCONSTANTS  from '../../constants';
+import * as MEETINGCONSTANTS from '../../constants';
 
 /**
  * Extended Error object for general parameter errors
@@ -7,13 +7,17 @@ export default class ParameterError extends Error {
   sdkMessage: string;
   error: null;
   code: number;
+
   /**
-  *
-  * @constructor
-  * @param {String} [message]
-  * @param {Object} [error]
-  */
-  constructor(message = MEETINGCONSTANTS.ERROR_DICTIONARY.PARAMETER.MESSAGE, error = null) {
+   *
+   * @constructor
+   * @param {String} [message]
+   * @param {Object} [error]
+   */
+  constructor(
+    message: string = MEETINGCONSTANTS.ERROR_DICTIONARY.PARAMETER.MESSAGE,
+    error: any = null
+  ) {
     super(message);
 
     if (Error.captureStackTrace) {

package/src/common/errors/{password-error.js → password-error.ts}

@@ -4,18 +4,22 @@ import {ERROR_DICTIONARY} from '../../constants';
  * Extended Error object to signify password related errors
  */
 export default class PasswordError extends Error {
+  code: any;
+  error: any;
+  sdkMessage: any;
+
   /**
-  *
-  * @constructor
-  * @param {String} [message]
-  * @param {Object} [error]
-  */
-  constructor(message = ERROR_DICTIONARY.PASSWORD.MESSAGE, error = null) {
+   *
+   * @constructor
+   * @param {String} [message]
+   * @param {Object} [error]
+   */
+  constructor(message: string = ERROR_DICTIONARY.PASSWORD.MESSAGE, error: any = null) {
     super(message);
     this.name = ERROR_DICTIONARY.PASSWORD.NAME;
     this.sdkMessage = ERROR_DICTIONARY.PASSWORD.MESSAGE;
     this.error = error;
-    this.stack = error ? error.stack : (new Error()).stack;
+    this.stack = error ? error.stack : new Error().stack;
     this.code = ERROR_DICTIONARY.PASSWORD.CODE;
   }
 }

package/src/common/errors/{permission.js → permission.ts}

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

package/src/common/errors/{reconnection.js → reconnection.ts}

@@ -4,18 +4,22 @@ import {ERROR_DICTIONARY} from '../../constants';
  * Extended Error object to signify the intent to join for unclaimed PMR scenarios
  */
 export default class ReconnectionError extends Error {
+  code: any;
+  error: any;
+  sdkMessage: any;
+
   /**
-  *
-  * @constructor
-  * @param {String} [message]
-  * @param {Object} [error]
-  */
-  constructor(message = ERROR_DICTIONARY.RECONNECTION.MESSAGE, error = null) {
+   *
+   * @constructor
+   * @param {String} [message]
+   * @param {Object} [error]
+   */
+  constructor(message: string = ERROR_DICTIONARY.RECONNECTION.MESSAGE, error: any = null) {
     super(message);
     this.name = ERROR_DICTIONARY.RECONNECTION.NAME;
     this.sdkMessage = ERROR_DICTIONARY.RECONNECTION.MESSAGE;
     this.error = error;
-    this.stack = error ? error.stack : (new Error()).stack;
+    this.stack = error ? error.stack : new Error().stack;
     this.code = ERROR_DICTIONARY.RECONNECTION.CODE;
   }
 }

package/src/common/errors/{stats.js → stats.ts}

@@ -4,18 +4,22 @@ import {ERROR_DICTIONARY} from '../../constants';
  * Extended Error object for Stats Errors
  */
 export default class StatsError extends Error {
+  code: any;
+  error: any;
+  sdkMessage: any;
+
   /**
-  *
-  * @constructor
-  * @param {String} [message]
-  * @param {Object} [error]
-  */
-  constructor(message = ERROR_DICTIONARY.STATS.MESSAGE, error = null) {
+   *
+   * @constructor
+   * @param {String} [message]
+   * @param {Object} [error]
+   */
+  constructor(message: string = ERROR_DICTIONARY.STATS.MESSAGE, error: any = null) {
     super(message);
     this.name = ERROR_DICTIONARY.STATS.NAME;
     this.sdkMessage = ERROR_DICTIONARY.STATS.MESSAGE;
     this.error = error;
-    this.stack = error ? error.stack : (new Error()).stack;
+    this.stack = error ? error.stack : new Error().stack;
     this.code = ERROR_DICTIONARY.STATS.CODE;
   }
 }

package/src/common/errors/{webex-errors.js → webex-errors.ts}

@@ -5,7 +5,6 @@
 // 3) Any errors we generate from the SDK can be split into various categories
 // Parameter validation, user action, connection, media specific(They can have different range)
 
-
 // TODO: all the errors from the server need to be captured
 
 // add a way to log and send metrics if needed
@@ -20,11 +19,13 @@ const WebExMeetingsErrors = {};
  * @param {string} [message] - Error message
  * @returns {WebexMeetingsError}
  */
-export function createMeetingsError(code, message) {
+export function createMeetingsError(code?: number, message?: string) {
   code = typeof code === 'number' ? code : 0;
   message = typeof message === 'string' && message ? message : 'Unknown error';
 
-  return WebExMeetingsErrors[code] ? new WebExMeetingsErrors[code]() : new WebexMeetingsError(code, message);
+  return WebExMeetingsErrors[code]
+    ? new WebExMeetingsErrors[code]()
+    : new WebexMeetingsError(code, message);
 }
 
 /**
@@ -56,14 +57,16 @@ class UserNotJoinedError extends WebexMeetingsError {
   static CODE = 30102;
 
   constructor() {
-    super(UserNotJoinedError.CODE, 'User currently not in meeting. Please join a meeting before adding media.');
+    super(
+      UserNotJoinedError.CODE,
+      'User currently not in meeting. Please join a meeting before adding media.'
+    );
   }
 }
 
 export {UserNotJoinedError};
 WebExMeetingsErrors[UserNotJoinedError.CODE] = UserNotJoinedError;
 
-
 /**
  * @class NoMediaEstablishedYetError
  * @classdesc Raised whenever the user has not established media yet.
@@ -82,7 +85,6 @@ class NoMediaEstablishedYetError extends WebexMeetingsError {
 export {NoMediaEstablishedYetError};
 WebExMeetingsErrors[NoMediaEstablishedYetError.CODE] = NoMediaEstablishedYetError;
 
-
 /**
  * @class UserInLobbyError
  * @classdesc Raised whenever the user is in lobby and not joined yet.
@@ -101,7 +103,6 @@ class UserInLobbyError extends WebexMeetingsError {
 export {UserInLobbyError};
 WebExMeetingsErrors[UserInLobbyError.CODE] = UserInLobbyError;
 
-
 /**
  * @class IceGatheringFailed
  * @classdesc Raised whenever ice gathering fails.