@webex/plugin-meetings 2.59.1 → 2.59.3-next.1

package/src/peer-connection-manager/util.ts

@@ -1,119 +1,119 @@
-import {parse} from '@webex/ts-sdp';
-
-interface IPeerConnectionUtils {
-  convertCLineToIpv4: (sdp: string) => string;
-  adjustH264Profile: (sdp: string, maxFsValue: number) => string;
-}
-
-const PeerConnectionUtils = {} as IPeerConnectionUtils;
-
-// max-fs values for all H264 profile levels
-const maxFsForProfileLevel = {
-  10: 99,
-  11: 396,
-  12: 396,
-  13: 396,
-  20: 396,
-  21: 792,
-  22: 1620,
-  30: 1620,
-  31: 3600,
-  32: 5120,
-  40: 8192,
-  41: 8192,
-  42: 8704,
-  50: 22080,
-  51: 36864,
-  52: 36864,
-  60: 139264,
-  61: 139264,
-  62: 139264,
-};
-
-const framesPerSecond = 30;
-
-/**
- * Convert C line to IPv4
- * @param {string} sdp
- * @returns {string}
- */
-PeerConnectionUtils.convertCLineToIpv4 = (sdp: string) => {
-  let replaceSdp = sdp;
-
-  // TODO: remove this once linus supports Ipv6 c line.currently linus rejects SDP with c line having ipv6 candidates we are
-  // mocking ipv6 to ipv4 candidates
-  // https://jira-eng-gpk2.cisco.com/jira/browse/SPARK-299232
-  replaceSdp = replaceSdp.replace(/c=IN IP6 .*/gi, 'c=IN IP4 0.0.0.0');
-
-  return replaceSdp;
-};
-
-/**
- * estimate profile levels for max-fs & max-mbps values
- * @param {string} sdp
- * @param {number} maxFsValue
- * @returns {string}
- */
-PeerConnectionUtils.adjustH264Profile = (sdp: string, maxFsValue: number) => {
-  // converting with ts-sdp parser, no munging
-  const parsedSdp = parse(sdp);
-
-  parsedSdp.avMedia.forEach((media) => {
-    if (media.type === 'video') {
-      media.codecs.forEach((codec) => {
-        if (codec.name?.toUpperCase() === 'H264') {
-          // there should really be just 1 fmtp line, but just in case, we process all of them
-          codec.fmtParams = codec.fmtParams.map((fmtp) => {
-            const parsedRegex = fmtp.match(/(.*)profile-level-id=(\w{4})(\w{2})(.*)/);
-
-            if (parsedRegex && parsedRegex.length === 5) {
-              const stuffBeforeProfileLevelId = parsedRegex[1];
-              const profile = parsedRegex[2].toLowerCase();
-              const levelId = parseInt(parsedRegex[3], 16);
-              const stuffAfterProfileLevelId = parsedRegex[4];
-
-              if (!maxFsForProfileLevel[levelId]) {
-                throw new Error(
-                  `found unsupported h264 profile level id value in the SDP: ${levelId}`
-                );
-              }
-
-              if (maxFsForProfileLevel[levelId] === maxFsValue) {
-                // profile level already matches our desired max-fs value, so we don't need to do anything
-                return fmtp;
-              }
-              if (maxFsForProfileLevel[levelId] < maxFsValue) {
-                // profile level has too low max-fs, so we need to override it (this is upgrading)
-                return `${fmtp};max-fs=${maxFsValue};max-mbps=${maxFsValue * framesPerSecond}`;
-              }
-
-              // profile level has too high max-fs value, so we need to use a lower level
-
-              // find highest level that has the matching maxFs
-              const newLevelId = Object.keys(maxFsForProfileLevel)
-                .reverse()
-                .find((key) => maxFsForProfileLevel[key] === maxFsValue);
-
-              if (newLevelId) {
-                // Object.keys returns keys as strings, so we need to parse it to an int again and then convert to hex
-                const newLevelIdHex = parseInt(newLevelId, 10).toString(16);
-
-                return `${stuffBeforeProfileLevelId}profile-level-id=${profile}${newLevelIdHex};max-mbps=${
-                  maxFsValue * framesPerSecond
-                }${stuffAfterProfileLevelId}`;
-              }
-
-              throw new Error(`unsupported maxFsValue: ${maxFsValue}`);
-            }
-
-            return fmtp;
-          });
-        }
-      });
-    }
-  });
-
-  return parsedSdp.toString();
-};
-
-export default PeerConnectionUtils;
+import {parse} from '@webex/ts-sdp';
+
+interface IPeerConnectionUtils {
+  convertCLineToIpv4: (sdp: string) => string;
+  adjustH264Profile: (sdp: string, maxFsValue: number) => string;
+}
+
+const PeerConnectionUtils = {} as IPeerConnectionUtils;
+
+// max-fs values for all H264 profile levels
+const maxFsForProfileLevel = {
+  10: 99,
+  11: 396,
+  12: 396,
+  13: 396,
+  20: 396,
+  21: 792,
+  22: 1620,
+  30: 1620,
+  31: 3600,
+  32: 5120,
+  40: 8192,
+  41: 8192,
+  42: 8704,
+  50: 22080,
+  51: 36864,
+  52: 36864,
+  60: 139264,
+  61: 139264,
+  62: 139264,
+};
+
+const framesPerSecond = 30;
+
+/**
+ * Convert C line to IPv4
+ * @param {string} sdp
+ * @returns {string}
+ */
+PeerConnectionUtils.convertCLineToIpv4 = (sdp: string) => {
+  let replaceSdp = sdp;
+
+  // TODO: remove this once linus supports Ipv6 c line.currently linus rejects SDP with c line having ipv6 candidates we are
+  // mocking ipv6 to ipv4 candidates
+  // https://jira-eng-gpk2.cisco.com/jira/browse/SPARK-299232
+  replaceSdp = replaceSdp.replace(/c=IN IP6 .*/gi, 'c=IN IP4 0.0.0.0');
+
+  return replaceSdp;
+};
+
+/**
+ * estimate profile levels for max-fs & max-mbps values
+ * @param {string} sdp
+ * @param {number} maxFsValue
+ * @returns {string}
+ */
+PeerConnectionUtils.adjustH264Profile = (sdp: string, maxFsValue: number) => {
+  // converting with ts-sdp parser, no munging
+  const parsedSdp = parse(sdp);
+
+  parsedSdp.avMedia.forEach((media) => {
+    if (media.type === 'video') {
+      media.codecs.forEach((codec) => {
+        if (codec.name?.toUpperCase() === 'H264') {
+          // there should really be just 1 fmtp line, but just in case, we process all of them
+          codec.fmtParams = codec.fmtParams.map((fmtp) => {
+            const parsedRegex = fmtp.match(/(.*)profile-level-id=(\w{4})(\w{2})(.*)/);
+
+            if (parsedRegex && parsedRegex.length === 5) {
+              const stuffBeforeProfileLevelId = parsedRegex[1];
+              const profile = parsedRegex[2].toLowerCase();
+              const levelId = parseInt(parsedRegex[3], 16);
+              const stuffAfterProfileLevelId = parsedRegex[4];
+
+              if (!maxFsForProfileLevel[levelId]) {
+                throw new Error(
+                  `found unsupported h264 profile level id value in the SDP: ${levelId}`
+                );
+              }
+
+              if (maxFsForProfileLevel[levelId] === maxFsValue) {
+                // profile level already matches our desired max-fs value, so we don't need to do anything
+                return fmtp;
+              }
+              if (maxFsForProfileLevel[levelId] < maxFsValue) {
+                // profile level has too low max-fs, so we need to override it (this is upgrading)
+                return `${fmtp};max-fs=${maxFsValue};max-mbps=${maxFsValue * framesPerSecond}`;
+              }
+
+              // profile level has too high max-fs value, so we need to use a lower level
+
+              // find highest level that has the matching maxFs
+              const newLevelId = Object.keys(maxFsForProfileLevel)
+                .reverse()
+                .find((key) => maxFsForProfileLevel[key] === maxFsValue);
+
+              if (newLevelId) {
+                // Object.keys returns keys as strings, so we need to parse it to an int again and then convert to hex
+                const newLevelIdHex = parseInt(newLevelId, 10).toString(16);
+
+                return `${stuffBeforeProfileLevelId}profile-level-id=${profile}${newLevelIdHex};max-mbps=${
+                  maxFsValue * framesPerSecond
+                }${stuffAfterProfileLevelId}`;
+              }
+
+              throw new Error(`unsupported maxFsValue: ${maxFsValue}`);
+            }
+
+            return fmtp;
+          });
+        }
+      });
+    }
+  });
+
+  return parsedSdp.toString();
+};
+
+export default PeerConnectionUtils;

package/src/personal-meeting-room/index.ts

@@ -1,157 +1,157 @@
-// @ts-ignore
-import {StatelessWebexPlugin} from '@webex/webex-core';
-
-import {MEETINGS, _PERSONAL_ROOM_} from '../constants';
-import ParameterError from '../common/errors/parameter';
-
-import PersonalMeetingRoomRequest from './request';
-
-/**
- * @class PersonalMeetingRoom
- */
-export default class PersonalMeetingRoom extends StatelessWebexPlugin {
-  link: any;
-  meetingInfo: any;
-  name: any;
-  personalMeetingRoomRequest: any;
-  pmr: any;
-  sipUri: any;
-  userId: any;
-  meetingLink: any;
-  number: any;
-
-  namespace = MEETINGS;
-
-  /**
-   *
-   * @param {Object} attrs
-   * @param {Object} options
-   */
-  constructor(attrs: any, options: any) {
-    super({}, options);
-    /**
-     * The pmr server object
-     * @instance
-     * @type {Object}
-     * @public
-     * @memberof PersonalMeetingRoom
-     */
-    this.pmr = null;
-    /**
-     * The pmr sip Uri
-     * @instance
-     * @type {String}
-     * @public
-     * @memberof PersonalMeetingRoom
-     */
-    this.sipUri = null;
-    /**
-     * The pmr link
-     * @instance
-     * @type {String}
-     * @public
-     * @memberof PersonalMeetingRoom
-     */
-    this.link = null;
-    /**
-     * The pmr server object
-     * @instance
-     * @type {Object}
-     * @public
-     * @memberof PersonalMeetingRoom
-     */
-    this.userId = null;
-    /**
-     * The pmr name
-     * @instance
-     * @type {String}
-     * @public
-     * @memberof PersonalMeetingRoom
-     */
-    this.name = null;
-    /**
-     * The meeting info request server interface
-     * @instance
-     * @type {MeetingInfo}
-     * @private
-     * @memberof PersonalMeetingRoom
-     */
-    this.meetingInfo = attrs.meetingInfo;
-    /**
-     * The pmr server request interface
-     * @instance
-     * @type {Object}
-     * @private
-     * @memberof PersonalMeetingRoom
-     */
-    // @ts-ignore
-    this.personalMeetingRoomRequest = new PersonalMeetingRoomRequest({}, options);
-  }
-
-  /**
-   * claims a pmr and updates the cached PMR values
-   * @param {String} link
-   * @param {String} pin
-   * @param {Boolean} [preferred] defaults to true to set this claimed PMR as the preferred
-   * @returns {Promise}
-   * @public
-   * @memberof PersonalMeetingRoom
-   */
-  public claim(link: string, pin: string, preferred = true) {
-    const options = {
-      // @ts-ignore
-      userId: this.webex.internal.device.userId,
-      passcode: pin,
-      meetingAddress: link,
-      preferred,
-    };
-
-    return this.personalMeetingRoomRequest.claimPmr(options).then((pmr) => {
-      if (pmr && pmr.body) {
-        this.set(pmr.body);
-      } else {
-        return Promise.reject(new ParameterError('No PMR body provided. PMR values not updated.'));
-      }
-
-      return pmr.body;
-    });
-  }
-
-  /**
-   * @param {Object} body the response body from meeting info request
-   * @returns {undefined}
-   * @private
-   * @memberof PersonalMeetingRoom
-   */
-  private set(body: any) {
-    this.pmr = body;
-    this.sipUri = body.sipMeetingUri;
-    this.meetingLink = body.webExMeetingLink || body.meetingLink;
-    this.userId = body.owner;
-    this.name = body.meetingName;
-    this.number = body.meetingNumber;
-  }
-
-  /**
-   * TODO: implement TTL for syncing and caching so to not request again and again
-   * @param {Object} options
-   * @returns {Promise}
-   * @public
-   * @memberof PersonalMeetingRoom
-   */
-  public get() {
-    const options = {
-      type: _PERSONAL_ROOM_,
-    };
-
-    return this.meetingInfo.fetchMeetingInfo(options).then((pmr) => {
-      if (pmr && pmr.body && pmr.body.isPmr) {
-        this.set(pmr.body);
-      } else {
-        return Promise.reject(new TypeError('The PMR requested is NOT a PMR. PMR values not set.'));
-      }
-
-      return pmr.body;
-    });
-  }
-}
+// @ts-ignore
+import {StatelessWebexPlugin} from '@webex/webex-core';
+
+import {MEETINGS, _PERSONAL_ROOM_} from '../constants';
+import ParameterError from '../common/errors/parameter';
+
+import PersonalMeetingRoomRequest from './request';
+
+/**
+ * @class PersonalMeetingRoom
+ */
+export default class PersonalMeetingRoom extends StatelessWebexPlugin {
+  link: any;
+  meetingInfo: any;
+  name: any;
+  personalMeetingRoomRequest: any;
+  pmr: any;
+  sipUri: any;
+  userId: any;
+  meetingLink: any;
+  number: any;
+
+  namespace = MEETINGS;
+
+  /**
+   *
+   * @param {Object} attrs
+   * @param {Object} options
+   */
+  constructor(attrs: any, options: any) {
+    super({}, options);
+    /**
+     * The pmr server object
+     * @instance
+     * @type {Object}
+     * @public
+     * @memberof PersonalMeetingRoom
+     */
+    this.pmr = null;
+    /**
+     * The pmr sip Uri
+     * @instance
+     * @type {String}
+     * @public
+     * @memberof PersonalMeetingRoom
+     */
+    this.sipUri = null;
+    /**
+     * The pmr link
+     * @instance
+     * @type {String}
+     * @public
+     * @memberof PersonalMeetingRoom
+     */
+    this.link = null;
+    /**
+     * The pmr server object
+     * @instance
+     * @type {Object}
+     * @public
+     * @memberof PersonalMeetingRoom
+     */
+    this.userId = null;
+    /**
+     * The pmr name
+     * @instance
+     * @type {String}
+     * @public
+     * @memberof PersonalMeetingRoom
+     */
+    this.name = null;
+    /**
+     * The meeting info request server interface
+     * @instance
+     * @type {MeetingInfo}
+     * @private
+     * @memberof PersonalMeetingRoom
+     */
+    this.meetingInfo = attrs.meetingInfo;
+    /**
+     * The pmr server request interface
+     * @instance
+     * @type {Object}
+     * @private
+     * @memberof PersonalMeetingRoom
+     */
+    // @ts-ignore
+    this.personalMeetingRoomRequest = new PersonalMeetingRoomRequest({}, options);
+  }
+
+  /**
+   * claims a pmr and updates the cached PMR values
+   * @param {String} link
+   * @param {String} pin
+   * @param {Boolean} [preferred] defaults to true to set this claimed PMR as the preferred
+   * @returns {Promise}
+   * @public
+   * @memberof PersonalMeetingRoom
+   */
+  public claim(link: string, pin: string, preferred = true) {
+    const options = {
+      // @ts-ignore
+      userId: this.webex.internal.device.userId,
+      passcode: pin,
+      meetingAddress: link,
+      preferred,
+    };
+
+    return this.personalMeetingRoomRequest.claimPmr(options).then((pmr) => {
+      if (pmr && pmr.body) {
+        this.set(pmr.body);
+      } else {
+        return Promise.reject(new ParameterError('No PMR body provided. PMR values not updated.'));
+      }
+
+      return pmr.body;
+    });
+  }
+
+  /**
+   * @param {Object} body the response body from meeting info request
+   * @returns {undefined}
+   * @private
+   * @memberof PersonalMeetingRoom
+   */
+  private set(body: any) {
+    this.pmr = body;
+    this.sipUri = body.sipMeetingUri;
+    this.meetingLink = body.webExMeetingLink || body.meetingLink;
+    this.userId = body.owner;
+    this.name = body.meetingName;
+    this.number = body.meetingNumber;
+  }
+
+  /**
+   * TODO: implement TTL for syncing and caching so to not request again and again
+   * @param {Object} options
+   * @returns {Promise}
+   * @public
+   * @memberof PersonalMeetingRoom
+   */
+  public get() {
+    const options = {
+      type: _PERSONAL_ROOM_,
+    };
+
+    return this.meetingInfo.fetchMeetingInfo(options).then((pmr) => {
+      if (pmr && pmr.body && pmr.body.isPmr) {
+        this.set(pmr.body);
+      } else {
+        return Promise.reject(new TypeError('The PMR requested is NOT a PMR. PMR values not set.'));
+      }
+
+      return pmr.body;
+    });
+  }
+}

package/src/personal-meeting-room/request.ts

@@ -1,48 +1,48 @@
-// @ts-ignore
-import {StatelessWebexPlugin} from '@webex/webex-core';
-
-import {MEETINGS} from '../constants';
-import ParameterError from '../common/errors/parameter';
-
-import PersonalMeetingRoomUtil from './util';
-
-/**
- * @class MeetingInfoRequest
- */
-export default class PersonalMeetingRoomRequest extends StatelessWebexPlugin {
-  namespace = MEETINGS;
-
-  /**
-   *
-   * @param {Object} options with format of {userId, passcode, meetingAddress, preferred}
-   * @returns {Promise} returns a promise that resolves/rejects the result of the request
-   * @memberof PersonalMeetingRoomRequest
-   */
-  claimPmr(options: any) {
-    if (
-      !options ||
-      !options.userId ||
-      !options.passcode ||
-      !options.meetingAddress ||
-      !options.preferred
-    ) {
-      throw new ParameterError(
-        'Claiming a PMR should be done with userId, passcode, preferred, and meetingAddress in options.'
-      );
-    }
-    const validPin = PersonalMeetingRoomUtil.getClaimPmrPin(options.passcode);
-
-    if (!validPin) {
-      return Promise.reject(new ParameterError('The host pin provided was of an invalid format'));
-    }
-    const validLink = PersonalMeetingRoomUtil.getClaimPmrLink(options.meetingAddress);
-
-    if (!validLink) {
-      return Promise.reject(new ParameterError('The PMR link provided was of an invalid format'));
-    }
-    const request = PersonalMeetingRoomUtil.getClaimedRequestParams(validLink, validPin, options);
-
-    // @ts-ignore
-    return this.request(request);
-  }
-}
+// @ts-ignore
+import {StatelessWebexPlugin} from '@webex/webex-core';
+
+import {MEETINGS} from '../constants';
+import ParameterError from '../common/errors/parameter';
+
+import PersonalMeetingRoomUtil from './util';
+
+/**
+ * @class MeetingInfoRequest
+ */
+export default class PersonalMeetingRoomRequest extends StatelessWebexPlugin {
+  namespace = MEETINGS;
+
+  /**
+   *
+   * @param {Object} options with format of {userId, passcode, meetingAddress, preferred}
+   * @returns {Promise} returns a promise that resolves/rejects the result of the request
+   * @memberof PersonalMeetingRoomRequest
+   */
+  claimPmr(options: any) {
+    if (
+      !options ||
+      !options.userId ||
+      !options.passcode ||
+      !options.meetingAddress ||
+      !options.preferred
+    ) {
+      throw new ParameterError(
+        'Claiming a PMR should be done with userId, passcode, preferred, and meetingAddress in options.'
+      );
+    }
+    const validPin = PersonalMeetingRoomUtil.getClaimPmrPin(options.passcode);
+
+    if (!validPin) {
+      return Promise.reject(new ParameterError('The host pin provided was of an invalid format'));
+    }
+    const validLink = PersonalMeetingRoomUtil.getClaimPmrLink(options.meetingAddress);
+
+    if (!validLink) {
+      return Promise.reject(new ParameterError('The PMR link provided was of an invalid format'));
+    }
+    const request = PersonalMeetingRoomUtil.getClaimedRequestParams(validLink, validPin, options);
+
+    // @ts-ignore
+    return this.request(request);
+  }
+}