@webex/plugin-meetings 3.0.0-beta.3 → 3.0.0-beta.300

package/src/breakouts/request.ts

@@ -0,0 +1,55 @@
+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

@@ -0,0 +1,57 @@
+// 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/{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/no-meeting-info.ts

@@ -0,0 +1,24 @@
+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/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/reclaim-host-role-errors.ts

@@ -0,0 +1,134 @@
+import * as MEETINGCONSTANTS from '../../constants';
+
+/**
+ * Extended Error object for reclaim host role empty or wrong key
+ */
+export class ReclaimHostEmptyWrongKeyError extends Error {
+  sdkMessage: string;
+  error: null;
+  code: number;
+
+  /**
+   *
+   * @constructor
+   * @param {String} [message]
+   * @param {Object} [error]
+   */
+  constructor(
+    message: string = MEETINGCONSTANTS.ERROR_DICTIONARY.RECLAIM_HOST_ROLE_EMPTY_OR_WRONG_KEY
+      .MESSAGE,
+    error: any = null
+  ) {
+    super(message);
+
+    if (Error.captureStackTrace) {
+      Error.captureStackTrace(this, ReclaimHostEmptyWrongKeyError);
+    }
+
+    this.name = MEETINGCONSTANTS.ERROR_DICTIONARY.RECLAIM_HOST_ROLE_EMPTY_OR_WRONG_KEY.NAME;
+    this.sdkMessage =
+      message || MEETINGCONSTANTS.ERROR_DICTIONARY.RECLAIM_HOST_ROLE_EMPTY_OR_WRONG_KEY.MESSAGE;
+    this.error = error;
+
+    this.code = MEETINGCONSTANTS.ERROR_DICTIONARY.RECLAIM_HOST_ROLE_EMPTY_OR_WRONG_KEY.CODE;
+  }
+}
+
+/**
+ * Extended Error object for reclaim host role not supported
+ */
+export class ReclaimHostNotSupportedError extends Error {
+  sdkMessage: string;
+  error: null;
+  code: number;
+
+  /**
+   *
+   * @constructor
+   * @param {String} [message]
+   * @param {Object} [error]
+   */
+  constructor(
+    message: string = MEETINGCONSTANTS.ERROR_DICTIONARY.RECLAIM_HOST_ROLE_NOT_SUPPORTED.MESSAGE,
+    error: any = null
+  ) {
+    super(message);
+
+    if (Error.captureStackTrace) {
+      Error.captureStackTrace(this, ReclaimHostNotSupportedError);
+    }
+
+    this.name = MEETINGCONSTANTS.ERROR_DICTIONARY.RECLAIM_HOST_ROLE_NOT_SUPPORTED.NAME;
+    this.sdkMessage =
+      message || MEETINGCONSTANTS.ERROR_DICTIONARY.RECLAIM_HOST_ROLE_NOT_SUPPORTED.MESSAGE;
+    this.error = error;
+
+    this.code = MEETINGCONSTANTS.ERROR_DICTIONARY.RECLAIM_HOST_ROLE_NOT_SUPPORTED.CODE;
+  }
+}
+
+/**
+ * Extended Error object for reclaim host role not allowed for other participants
+ */
+export class ReclaimHostNotAllowedError extends Error {
+  sdkMessage: string;
+  error: null;
+  code: number;
+
+  /**
+   *
+   * @constructor
+   * @param {String} [message]
+   * @param {Object} [error]
+   */
+  constructor(
+    message: string = MEETINGCONSTANTS.ERROR_DICTIONARY.RECLAIM_HOST_ROLE_NOT_ALLOWED.MESSAGE,
+    error: any = null
+  ) {
+    super(message);
+
+    if (Error.captureStackTrace) {
+      Error.captureStackTrace(this, ReclaimHostNotAllowedError);
+    }
+
+    this.name = MEETINGCONSTANTS.ERROR_DICTIONARY.RECLAIM_HOST_ROLE_NOT_ALLOWED.NAME;
+    this.sdkMessage =
+      message || MEETINGCONSTANTS.ERROR_DICTIONARY.RECLAIM_HOST_ROLE_NOT_ALLOWED.MESSAGE;
+    this.error = error;
+
+    this.code = MEETINGCONSTANTS.ERROR_DICTIONARY.RECLAIM_HOST_ROLE_NOT_ALLOWED.CODE;
+  }
+}
+
+/**
+ * Extended Error object for reclaim host role when user is host already
+ */
+export class ReclaimHostIsHostAlreadyError extends Error {
+  sdkMessage: string;
+  error: null;
+  code: number;
+
+  /**
+   *
+   * @constructor
+   * @param {String} [message]
+   * @param {Object} [error]
+   */
+  constructor(
+    message: string = MEETINGCONSTANTS.ERROR_DICTIONARY.RECLAIM_HOST_ROLE_IS_ALREADY_HOST.MESSAGE,
+    error: any = null
+  ) {
+    super(message);
+
+    if (Error.captureStackTrace) {
+      Error.captureStackTrace(this, ReclaimHostIsHostAlreadyError);
+    }
+
+    this.name = MEETINGCONSTANTS.ERROR_DICTIONARY.RECLAIM_HOST_ROLE_IS_ALREADY_HOST.NAME;
+    this.sdkMessage =
+      message || MEETINGCONSTANTS.ERROR_DICTIONARY.RECLAIM_HOST_ROLE_IS_ALREADY_HOST.MESSAGE;
+    this.error = error;
+
+    this.code = MEETINGCONSTANTS.ERROR_DICTIONARY.RECLAIM_HOST_ROLE_IS_ALREADY_HOST.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;
   }
 }