@webex/plugin-meetings 3.1.0 → 3.3.0

package/src/meeting-info/utilv2.ts

@@ -30,169 +30,176 @@ import ParameterError from '../common/errors/parameter';
 import LoggerProxy from '../common/logs/logger-proxy';
 import {SpaceIDDeprecatedError} from '../common/errors/webex-errors';
 
-const MeetingInfoUtil: any = {};
-const meetingInfoError =
-  'MeetingInfo is fetched with the meeting link, SIP URI, phone number, Hydra people ID, or a conversation URL.';
+/**
+ * @class MeetingInfoUtil
+ */
+export default class MeetingInfoUtil {
+  static meetingInfoError =
+    'MeetingInfo is fetched with the meeting link, SIP URI, phone number, Hydra people ID, or a conversation URL.';
 
-MeetingInfoUtil.getParsedUrl = (link) => {
-  try {
-    let parsedUrl = url.parse(link);
+  static getParsedUrl(link) {
+    try {
+      let parsedUrl = url.parse(link);
 
-    if (!parsedUrl) {
-      return false;
-    }
-    // hack for links such as <company>.webex.com/meet/<user> without a protocol
-    if (!parsedUrl.protocol) {
-      parsedUrl = url.parse(`${HTTPS_PROTOCOL}${link}`);
+      if (!parsedUrl) {
+        return false;
+      }
+      // hack for links such as <company>.webex.com/meet/<user> without a protocol
+      if (!parsedUrl.protocol) {
+        parsedUrl = url.parse(`${HTTPS_PROTOCOL}${link}`);
+      }
+
+      return parsedUrl;
+    } catch (error) {
+      LoggerProxy.logger.warn(
+        `Meeting-info:util#getParsedUrl --> unable to parse the URL, error: ${error}`
+      );
+
+      return null;
     }
+  }
 
-    return parsedUrl;
-  } catch (error) {
-    LoggerProxy.logger.warn(
-      `Meeting-info:util#getParsedUrl --> unable to parse the URL, error: ${error}`
-    );
+  /**
+   * Helper function to check if a string matches a known meeting link pattern
+   * @param {String} value  string to parse and see if it matches a meeting link
+   * @returns {Boolean}
+   */
+  static isMeetingLink(value: string) {
+    let hostNameBool;
+    let pathNameBool;
+    const parsedUrl = this.getParsedUrl(value);
+    if (parsedUrl) {
+      hostNameBool = parsedUrl.hostname && parsedUrl.hostname.includes(WEBEX_DOT_COM);
+      pathNameBool =
+        parsedUrl.pathname &&
+        (parsedUrl.pathname.includes(`/${MEET}`) ||
+          parsedUrl.pathname.includes(`/${MEET_M}`) ||
+          parsedUrl.pathname.includes(`/${MEET_CISCO}`) ||
+          parsedUrl.pathname.includes(`/${MEET_CO}`) ||
+          parsedUrl.pathname.includes(`/${JOIN}`));
+    }
 
-    return null;
+    return hostNameBool && pathNameBool;
   }
-};
 
-/**
- * Helper function to check if a string matches a known meeting link pattern
- * @param {String} value  string to parse and see if it matches a meeting link
- * @returns {Boolean}
- */
-MeetingInfoUtil.isMeetingLink = (value: string) => {
-  const parsedUrl = MeetingInfoUtil.getParsedUrl(value);
-  const hostNameBool = parsedUrl.hostname && parsedUrl.hostname.includes(WEBEX_DOT_COM);
-  const pathNameBool =
-    parsedUrl.pathname &&
-    (parsedUrl.pathname.includes(`/${MEET}`) ||
-      parsedUrl.pathname.includes(`/${MEET_M}`) ||
-      parsedUrl.pathname.includes(`/${MEET_CISCO}`) ||
-      parsedUrl.pathname.includes(`/${MEET_CO}`) ||
-      parsedUrl.pathname.includes(`/${JOIN}`));
-
-  return hostNameBool && pathNameBool;
-};
-
-MeetingInfoUtil.isConversationUrl = (value, webex) => {
-  const clusterId = webex.internal.services.getClusterId(value);
-
-  if (clusterId) {
-    return clusterId.endsWith(CONVERSATION_SERVICE);
+  static isConversationUrl(value, webex) {
+    const clusterId = webex.internal.services.getClusterId(value);
+
+    if (clusterId) {
+      return clusterId.endsWith(CONVERSATION_SERVICE);
+    }
+
+    return false;
   }
 
-  return false;
-};
+  static isSipUri(sipString) {
+    // TODO: lets remove regex from this equation and user URI matchers and such
+    // have not found a great sip uri parser library as of now
+    const sipUri = DIALER_REGEX.SIP_ADDRESS.exec(sipString);
 
-MeetingInfoUtil.isSipUri = (sipString) => {
-  // TODO: lets remove regex from this equation and user URI matchers and such
-  // have not found a great sip uri parser library as of now
-  const sipUri = DIALER_REGEX.SIP_ADDRESS.exec(sipString);
+    return sipUri;
+  }
 
-  return sipUri;
-};
+  static isPhoneNumber(phoneNumber) {
+    const isValidNumber = DIALER_REGEX.PHONE_NUMBER.test(phoneNumber);
 
-MeetingInfoUtil.isPhoneNumber = (phoneNumber) => {
-  const isValidNumber = DIALER_REGEX.PHONE_NUMBER.test(phoneNumber);
+    return isValidNumber;
+  }
 
-  return isValidNumber;
-};
+  static getHydraId(destination) {
+    const {type, id, cluster} = deconstructHydraId(destination);
 
-MeetingInfoUtil.getHydraId = (destination) => {
-  const {type, id, cluster} = deconstructHydraId(destination);
+    if (id && UUID_REG.test(id)) {
+      if (type === _ROOM_) {
+        return {room: true, destination: id, cluster};
+      }
+      if (type === _PEOPLE_) {
+        return {people: true, destination: id, cluster};
+      }
 
-  if (id && UUID_REG.test(id)) {
-    if (type === _ROOM_) {
-      return {room: true, destination: id, cluster};
-    }
-    if (type === _PEOPLE_) {
-      return {people: true, destination: id, cluster};
+      return {};
     }
 
     return {};
   }
 
-  return {};
-};
+  static getSipUriFromHydraPersonId(destination, webex) {
+    return webex.people
+      .get(destination)
+      .then((res) => {
+        if (res.emails && res.emails.length) {
+          return res.emails[0];
+        }
+        throw new ParameterError('Hydra Id Lookup was an invalid hydra person id.');
+      })
+      .catch((err) => {
+        LoggerProxy.logger.error(
+          `Meeting-info:util#MeetingInfoUtil.getSipUriFromHydraPersonId --> getSipUriFromHydraPersonId ${err} `
+        );
+        throw err;
+      });
+  }
 
-MeetingInfoUtil.getSipUriFromHydraPersonId = (destination, webex) =>
-  webex.people
-    .get(destination)
-    .then((res) => {
-      if (res.emails && res.emails.length) {
-        return res.emails[0];
+  static async getDestinationType(from) {
+    const {type, webex} = from;
+    let {destination} = from;
+
+    if (type === _PERSONAL_ROOM_) {
+      // this case checks if your type is personal room
+      if (!destination) {
+        // if we are not getting anything in desination we fetch org and user ids from webex instance
+        destination = {
+          userId: webex.internal.device.userId,
+          orgId: webex.internal.device.orgId,
+        };
+      } else {
+        const options = VALID_EMAIL_ADDRESS.test(destination)
+          ? {email: destination}
+          : {id: destination}; // we are assuming userId as default
+        const res = await webex.people.list(options);
+
+        let {orgId, id: userId} = res.items[0];
+
+        userId = deconstructHydraId(userId).id;
+        orgId = deconstructHydraId(orgId).id;
+        destination = {userId, orgId};
       }
-      throw new ParameterError('Hydra Id Lookup was an invalid hydra person id.');
-    })
-    .catch((err) => {
-      LoggerProxy.logger.error(
-        `Meeting-info:util#MeetingInfoUtil.getSipUriFromHydraPersonId --> getSipUriFromHydraPersonId ${err} `
-      );
-      throw err;
-    });
-
-MeetingInfoUtil.getDestinationType = async (from) => {
-  const {type, webex} = from;
-  let {destination} = from;
-
-  if (type === _PERSONAL_ROOM_) {
-    // this case checks if your type is personal room
-    if (!destination) {
-      // if we are not getting anything in desination we fetch org and user ids from webex instance
-      destination = {
-        userId: webex.internal.device.userId,
-        orgId: webex.internal.device.orgId,
+    }
+    if (type) {
+      return {
+        destination,
+        type,
       };
-    } else {
-      const options = VALID_EMAIL_ADDRESS.test(destination)
-        ? {email: destination}
-        : {id: destination}; // we are assuming userId as default
-      const res = await webex.people.list(options);
-
-      let {orgId, id: userId} = res.items[0];
+    }
+    const options: any = {};
+    let hydraId;
 
-      userId = deconstructHydraId(userId).id;
-      orgId = deconstructHydraId(orgId).id;
-      destination = {userId, orgId};
+    if (webex && webex.config && webex.config.meetings && webex.config.meetings.disableHydraId) {
+      hydraId = null;
+    } else {
+      hydraId = this.getHydraId(destination);
     }
-  }
-  if (type) {
-    return {
-      destination,
-      type,
-    };
-  }
-  const options: any = {};
-  let hydraId;
 
-  if (webex && webex.config && webex.config.meetings && webex.config.meetings.disableHydraId) {
-    hydraId = null;
-  } else {
-    hydraId = MeetingInfoUtil.getHydraId(destination);
-  }
+    if (this.isMeetingLink(destination)) {
+      LoggerProxy.logger.warn(
+        'Meeting-info:util#generateOptions --> WARN, use of Meeting Link is deprecated, please use a SIP URI instead'
+      );
 
-  if (MeetingInfoUtil.isMeetingLink(destination)) {
-    LoggerProxy.logger.warn(
-      'Meeting-info:util#generateOptions --> WARN, use of Meeting Link is deprecated, please use a SIP URI instead'
-    );
-
-    options.type = _MEETING_LINK_;
-    options.destination = destination;
-  } else if (MeetingInfoUtil.isSipUri(destination)) {
-    options.type = _SIP_URI_;
-    options.destination = destination;
-  } else if (MeetingInfoUtil.isPhoneNumber(destination)) {
-    options.type = _SIP_URI_;
-    options.destination = destination;
-  } else if (MeetingInfoUtil.isConversationUrl(destination, webex)) {
-    options.type = _CONVERSATION_URL_;
-    options.destination = destination;
-  } else if (hydraId && hydraId.people) {
-    options.type = _SIP_URI_;
-
-    return MeetingInfoUtil.getSipUriFromHydraPersonId(hydraId && hydraId.destination, webex).then(
-      (res) => {
+      options.type = _MEETING_LINK_;
+      options.destination = destination;
+    } else if (this.isSipUri(destination)) {
+      options.type = _SIP_URI_;
+      options.destination = destination;
+    } else if (this.isPhoneNumber(destination)) {
+      options.type = _SIP_URI_;
+      options.destination = destination;
+    } else if (this.isConversationUrl(destination, webex)) {
+      options.type = _CONVERSATION_URL_;
+      options.destination = destination;
+    } else if (hydraId && hydraId.people) {
+      options.type = _SIP_URI_;
+
+      return this.getSipUriFromHydraPersonId(hydraId && hydraId.destination, webex).then((res) => {
         options.destination = res;
 
         // Since hydra person ids require a unique case in which they are
@@ -201,125 +208,124 @@ MeetingInfoUtil.getDestinationType = async (from) => {
         options.wasHydraPerson = true;
 
         return Promise.resolve(options);
-      }
-    );
-  } else if (hydraId.room) {
-    LoggerProxy.logger.error(
-      `Meeting-info:util#getDestinationType --> Using the space ID as a destination is no longer supported. Please refer to the [migration guide](https://github.com/webex/webex-js-sdk/wiki/Migration-to-Unified-Space-Meetings) to migrate to use the meeting ID or SIP address.`
-    );
-    // Error code 30105 added as Space ID deprecated as of beta, Please refer migration guide.
-    throw new SpaceIDDeprecatedError();
-  } else {
-    LoggerProxy.logger.warn(`Meeting-info:util#getDestinationType --> ${meetingInfoError}`);
-    throw new ParameterError(`${meetingInfoError}`);
+      });
+    } else if (hydraId.room) {
+      LoggerProxy.logger.error(
+        `Meeting-info:util#getDestinationType --> Using the space ID as a destination is no longer supported. Please refer to the [migration guide](https://github.com/webex/webex-js-sdk/wiki/Migration-to-Unified-Space-Meetings) to migrate to use the meeting ID or SIP address.`
+      );
+      // Error code 30105 added as Space ID deprecated as of beta, Please refer migration guide.
+      throw new SpaceIDDeprecatedError();
+    } else {
+      LoggerProxy.logger.warn(`Meeting-info:util#getDestinationType --> ${this.meetingInfoError}`);
+      throw new ParameterError(`${this.meetingInfoError}`);
+    }
+
+    return Promise.resolve(options);
   }
 
-  return Promise.resolve(options);
-};
+  /**
+   * Helper function to build up a correct locus url depending on the value passed
+   * @param {Object} options type and value to fetch meeting info
+   * @param {String} options.type One of [SIP_URI, PERSONAL_ROOM, MEETING_ID, CONVERSATION_URL, LOCUS_ID, MEETING_LINK]
+   * @param {String} options.installedOrgID org ID of user's machine
+   * @param {Object} options.destination ?? value.value
+   * @returns {Object} returns an object with {resource, method}
+   */
+  static getRequestBody(options: {type: string; destination: object} | any) {
+    const {type, destination, password, captchaInfo, installedOrgID, locusId, extraParams} =
+      options;
+    const body: any = {
+      ...DEFAULT_MEETING_INFO_REQUEST_BODY,
+      ...extraParams,
+    };
 
-/**
- * Helper function to build up a correct locus url depending on the value passed
- * @param {Object} options type and value to fetch meeting info
- * @param {String} options.type One of [SIP_URI, PERSONAL_ROOM, MEETING_ID, CONVERSATION_URL, LOCUS_ID, MEETING_LINK]
- * @param {String} options.installedOrgID org ID of user's machine
- * @param {Object} options.destination ?? value.value
- * @returns {Object} returns an object with {resource, method}
- */
-MeetingInfoUtil.getRequestBody = (options: {type: string; destination: object} | any) => {
-  const {type, destination, password, captchaInfo, installedOrgID, locusId, extraParams} = options;
-  const body: any = {
-    ...DEFAULT_MEETING_INFO_REQUEST_BODY,
-    ...extraParams,
-  };
-
-  switch (type) {
-    case _SIP_URI_:
-      body.sipUrl = destination;
-      break;
-    case _PERSONAL_ROOM_:
-      body.userId = destination.userId;
-      body.orgId = destination.orgId;
-      break;
-    case _MEETING_ID_:
-      body.meetingKey = destination;
-      break;
-    case _CONVERSATION_URL_:
-      body.conversationUrl = destination;
-      break;
-    case _LOCUS_ID_:
-      // use meetingID for the completer meeting info for the already started meeting
-      if (destination.info?.webExMeetingId) {
-        body.meetingKey = destination.info.webExMeetingId;
-      } else if (destination.info?.sipUri) {
-        body.sipUrl = destination.info.sipUri;
+    switch (type) {
+      case _SIP_URI_:
+        body.sipUrl = destination;
+        break;
+      case _PERSONAL_ROOM_:
+        body.userId = destination.userId;
+        body.orgId = destination.orgId;
+        break;
+      case _MEETING_ID_:
+        body.meetingKey = destination;
+        break;
+      case _CONVERSATION_URL_:
+        body.conversationUrl = destination;
+        break;
+      case _LOCUS_ID_:
+        // use meetingID for the completer meeting info for the already started meeting
+        if (destination.info?.webExMeetingId) {
+          body.meetingKey = destination.info.webExMeetingId;
+        } else if (destination.info?.sipUri) {
+          body.sipUrl = destination.info.sipUri;
+        }
+        break;
+      case _MEETING_LINK_:
+        body.meetingUrl = destination;
+        break;
+      case _MEETING_UUID_: {
+        body.meetingUUID = destination;
+        break;
       }
-      break;
-    case _MEETING_LINK_:
-      body.meetingUrl = destination;
-      break;
-    case _MEETING_UUID_: {
-      body.meetingUUID = destination;
-      break;
+      default:
     }
-    default:
-  }
-
-  if (password) {
-    body.password = password;
-  }
 
-  if (captchaInfo) {
-    body.captchaID = captchaInfo.id;
-    body.captchaVerifyCode = captchaInfo.code;
-  }
-
-  if (installedOrgID) {
-    body.installedOrgID = installedOrgID;
-  }
+    if (password) {
+      body.password = password;
+    }
 
-  if (locusId) {
-    body.locusId = locusId;
-  }
+    if (captchaInfo) {
+      body.captchaID = captchaInfo.id;
+      body.captchaVerifyCode = captchaInfo.code;
+    }
 
-  return body;
-};
+    if (installedOrgID) {
+      body.installedOrgID = installedOrgID;
+    }
 
-/**
- * Helper function to parse the webex site/host from a URI string.
- * @param {String} uri string (e.g. '10019857020@convergedats.webex.com')
- * @returns {String} the site/host part of the URI string (e.g. 'convergedats.webex.com')
- */
-MeetingInfoUtil.getWebexSite = (uri: string) => {
-  const exceptedDomains = ['meet.webex.com', 'meetup.webex.com', 'ciscospark.com'];
-  const site = uri?.match(/.+@([^.]+\.[^.]+\.[^.]+)$/)?.[1];
-  const isExceptedDomain = !!site && exceptedDomains.some((domain) => site.includes(domain));
+    if (locusId) {
+      body.locusId = locusId;
+    }
 
-  return isExceptedDomain ? null : site;
-};
+    return body;
+  }
 
-/**
- * Helper function to return the direct URI for fetching meeting info (to avoid a redirect).
- * @param {Object} options type and value to fetch meeting info
- * @param {String} options.type One of [SIP_URI, PERSONAL_ROOM, MEETING_ID, CONVERSATION_URL, LOCUS_ID, MEETING_LINK]
- * @param {Object} options.destination ?? value.value
- * @returns {String} returns a URI string or null of there is no direct URI
- */
-MeetingInfoUtil.getDirectMeetingInfoURI = (options: {type: string; destination: any}) => {
-  const {type, destination} = options;
-
-  let preferredWebexSite = null;
-
-  switch (type) {
-    case _SIP_URI_:
-      preferredWebexSite = MeetingInfoUtil.getWebexSite(destination);
-      break;
-    case _LOCUS_ID_:
-      preferredWebexSite = destination.info?.webExSite;
-      break;
-    default:
+  /**
+   * Helper function to parse the webex site/host from a URI string.
+   * @param {String} uri string (e.g. '10019857020@convergedats.webex.com')
+   * @returns {String} the site/host part of the URI string (e.g. 'convergedats.webex.com')
+   */
+  static getWebexSite(uri: string) {
+    const exceptedDomains = ['meet.webex.com', 'meetup.webex.com', 'ciscospark.com'];
+    const site = uri?.match(/.+@([^.]+\.[^.]+\.[^.]+)$/)?.[1];
+    const isExceptedDomain = !!site && exceptedDomains.some((domain) => site.includes(domain));
+
+    return isExceptedDomain ? null : site;
   }
 
-  return preferredWebexSite ? `https://${preferredWebexSite}/wbxappapi/v1/meetingInfo` : null;
-};
+  /**
+   * Helper function to return the direct URI for fetching meeting info (to avoid a redirect).
+   * @param {Object} options type and value to fetch meeting info
+   * @param {String} options.type One of [SIP_URI, PERSONAL_ROOM, MEETING_ID, CONVERSATION_URL, LOCUS_ID, MEETING_LINK]
+   * @param {Object} options.destination ?? value.value
+   * @returns {String} returns a URI string or null of there is no direct URI
+   */
+  static getDirectMeetingInfoURI(options: {type: string; destination: any}) {
+    const {type, destination} = options;
+
+    let preferredWebexSite = null;
+
+    switch (type) {
+      case _SIP_URI_:
+        preferredWebexSite = this.getWebexSite(destination);
+        break;
+      case _LOCUS_ID_:
+        preferredWebexSite = destination.info?.webExSite;
+        break;
+      default:
+    }
 
-export default MeetingInfoUtil;
+    return preferredWebexSite ? `https://${preferredWebexSite}/wbxappapi/v1/meetingInfo` : null;
+  }
+}

package/src/meetings/index.ts

@@ -45,6 +45,8 @@ import {
   MEETINGNUMBER,
   _JOINED_,
   _MOVED_,
+  _ON_HOLD_LOBBY_,
+  _WAIT_,
 } from '../constants';
 import BEHAVIORAL_METRICS from '../metrics/constants';
 import MeetingInfo from '../meeting-info';
@@ -340,6 +342,9 @@ export default class Meetings extends WebexPlugin {
     if (newLocus) {
       const isNewLocusAsBreakout = MeetingsUtil.isBreakoutLocusDTO(newLocus);
       const isSelfMoved = newLocus?.self?.state === _LEFT_ && newLocus?.self?.reason === _MOVED_;
+      const isSelfMovedToLobby =
+        newLocus?.self?.devices[0]?.intent?.reason === _ON_HOLD_LOBBY_ &&
+        newLocus?.self?.devices[0]?.intent?.type === _WAIT_;
       if (!meeting) {
         if (isNewLocusAsBreakout) {
           LoggerProxy.logger.log(
@@ -352,7 +357,7 @@ export default class Meetings extends WebexPlugin {
         return this.isNeedHandleMainLocus(meeting, newLocus);
       }
       if (!isNewLocusAsBreakout) {
-        return this.isNeedHandleMainLocus(meeting, newLocus);
+        return isSelfMovedToLobby || this.isNeedHandleMainLocus(meeting, newLocus);
       }
 
       return !isSelfMoved;
@@ -1383,22 +1388,12 @@ export default class Meetings extends WebexPlugin {
 
   /**
    * Get all meetings.
-   * @param {object} options
-   * @param {object} options.startDate - get meetings after this start date
-   * @param {object} options.endDate - get meetings before this end date
    * @returns {Object} All currently active meetings.
    * @public
    * @memberof Meetings
    */
-  public getAllMeetings(
-    options: {
-      startDate: object;
-      endDate: object;
-    } = {} as any
-  ) {
-    // Options may include other parameters to filter this collection
-    // of meetings.
-    return this.meetingCollection.getAll(options);
+  public getAllMeetings() {
+    return this.meetingCollection.getAll();
   }
 
   /**
@@ -1524,18 +1519,6 @@ export default class Meetings extends WebexPlugin {
     this.breakoutLocusForHandleLater.splice(existIndex, 1);
   }
 
-  /**
-   * Get all scheduled meetings.
-   * @param {object} options
-   * @param {object} options.startDate - get meetings after this start date
-   * @param {object} options.endDate - get meetings before this end date
-   * @returns {Object} All scheduled meetings.
-   * @memberof Meetings
-   */
-  getScheduledMeetings() {
-    return this.meetingCollection.getAll({scheduled: true});
-  }
-
   /**
    * Get the logger instance for plugin-meetings
    * @returns {Logger}

package/src/reachability/index.ts

@@ -314,6 +314,9 @@ export default class Reachability {
       if (result.tcp.result === 'unreachable') {
         unreachableList.push({name: key, protocol: 'tcp'});
       }
+      if (result.xtls.result === 'unreachable') {
+        unreachableList.push({name: key, protocol: 'xtls'});
+      }
     });
 
     return unreachableList;