@webex/plugin-meetings 3.0.0-beta.1 → 3.0.0-beta.11

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

@@ -1,117 +0,0 @@
-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/roap/collection.js

@@ -1,63 +0,0 @@
-import RoapStateMachine from '../roap/state';
-
-/* eslint-disable */
-const RoapCollection = {
-  sessions: {},
-
-  getSession(id) {
-    if (!this.sessions[id]) {
-      this.sessions[id] = {
-        activeSequences: 0,
-      };
-    }
-    return this.sessions[id];
-  },
-
-  deleteSession(id) {
-    if (this.getSession(id)) {
-      delete this.sessions[id];
-    }
-  },
-
-  getSessionSequence(id, seqId) {
-    const session = this.getSession(id);
-    if (!session[seqId]) {
-      session[seqId] = {
-        state: RoapStateMachine.createState(),
-        finished: false,
-      };
-      session.activeSequences += 1;
-
-    }
-    return session[seqId];
-  },
-
-  deleteSessionSequence(id, seqId) {
-    const seq = this.getSessionSequence(id, seqId);
-    if (seq) {
-      if (!seq.finished) {
-        session.activeSequences -= 1;
-      }
-      delete this.sessions[id][seqId];
-    }
-  },
-
-  isBusy(id) {
-    const session = this.getSession(id);
-    if (!session) return false;
-
-    return session.activeSequences > 0;
-  },
-
-  onSessionSequenceFinish(id, seqId) {
-    const session = this.getSession(id);
-    const seq = session[seqId];
-    if (seq && !seq.finished) {
-      seq.finished = true;
-      session.activeSequences -= 1;
-    }
-  }
-
-};
-
-export default RoapCollection;

package/src/roap/handler.js

@@ -1,252 +0,0 @@
-/* no-param-reassign */
-import {StatelessWebexPlugin} from '@webex/webex-core';
-
-import LoggerProxy from '../common/logs/logger-proxy';
-import {ROAP, _OFFER_} from '../constants';
-import Metrics from '../metrics';
-import BEHAVIORAL_METRICS from '../metrics/constants';
-
-import RoapUtil from './util';
-import RoapCollection from './collection';
-
-
-const checkForAndHandleErrors = (action, meeting, correlationId) => {
-  if (action && action.type) {
-    if (action.msg && action.msg.messageType && action.msg.errorType) {
-      if (RoapUtil.findError(action.msg.messageType, action.msg.errorType, action.type)) {
-        RoapUtil.handleError(meeting.mediaProperties.peerConnection)
-          .then((res) => {
-            if (res) {
-              RoapCollection.deleteSessionSequence(correlationId, action.msg.seq);
-            }
-          })
-          .catch((err) => {
-            LoggerProxy.logger.warn(`Roap:handler#checkForAndHandleErrors --> Cannot reset the peer connection with error: ${err}`);
-          });
-
-        return true;
-      }
-    }
-    if (!RoapUtil.ensureMeeting(meeting, action.type)) {
-      return true;
-    }
-  }
-
-  return false;
-};
-
-const compareWithLastRoapMessage = (lastRoapMessage, currentRoapMessage) => lastRoapMessage?.msg?.seq === currentRoapMessage.msg.seq && lastRoapMessage?.msg?.messageType === currentRoapMessage.msg.messageType;
-
-const handleSessionStep = ({
-  roap, session, locusUrl, correlationId
-}) => {
-  const {seq: sequenceId, messageType} = roap.msg;
-
-  if (session.OFFER && messageType === _OFFER_) {
-    session.GLARE_OFFER = roap.msg;
-    session.GLARE_OFFER.remote = !!roap.remote;
-    const metricName = BEHAVIORAL_METRICS.ROAP_GLARE_CONDITION;
-    const data = {
-      correlation_id: correlationId,
-      locus_id: locusUrl.split('/').pop(),
-      sequence: sequenceId
-    };
-
-    Metrics.sendBehavioralMetric(metricName, data);
-
-    LoggerProxy.logger.warn(`Roap:handler#handleSessionStep --> Glare condition occurred with new mercury event, sequenceId: ${sequenceId}`);
-  }
-  else {
-    LoggerProxy.logger.info(`Roap:handler#handleSessionStep --> Save OFFER/ANSWER seq:${sequenceId} new mercury event ${messageType}local state: ${JSON.stringify(session.state.state, null, 2)}`);
-    session[messageType] = roap.msg;
-    session[messageType].remote = !!roap.remote;
-  }
-};
-
-/**
- * @class RoapHandler
- */
-export default class RoapHandler extends StatelessWebexPlugin {
-  constructor(attrs, options, roapOk, roapAnswer, roapFinished) {
-    super({}, options);
-    this.attrs = attrs;
-    this.options = options;
-    this.roapOk = roapOk;
-    this.roapFinished = roapFinished;
-    this.roapAnswer = roapAnswer;
-    this.lastRoapMessage = null;
-  }
-
-  /**
-   *
-   * @param {Object} session
-   * @param {Meeting} meeting
-   * @param {Object} action
-   * @returns {null}
-   */
-  perform(session, meeting, action) {
-    switch (session.state.state) {
-      case ROAP.ROAP_STATE.INIT:
-        this.roapFinished(meeting.correlationId, action.msg.seq);
-        break;
-
-        // TODO:  (important )handle roap state for sending offers as well
-      // case ROAP.ROAP_STATE.WAIT_RX_OFFER:
-      // case ROAP.ROAP_STATE.WAIT_RX_ANSWER:
-      // case ROAP.ROAP_STATE.WAIT_RX_OK:
-      case ROAP.ROAP_STATE.WAIT_TX_ANSWER:
-        // eslint-disable-next-line no-warning-comments
-        // TODO: sometime the you get an answer while you are creating an offer so SKIP
-        // Server will send the mercury event comes back
-        if (RoapUtil.shouldHandleMedia(meeting)) {
-          RoapUtil.updatePeerConnection(meeting, session)
-            .then((answerSdps) => {
-              this.roapAnswer({
-                mediaId: meeting.mediaId,
-                sdps: answerSdps,
-                seq: session.OFFER.seq,
-                correlationId: meeting.correlationId,
-                audioMuted: meeting.isAudioMuted(),
-                videoMuted: meeting.isVideoMuted()
-              });
-            })
-            .catch((error) => {
-              const metricName = BEHAVIORAL_METRICS.ROAP_ANSWER_FAILURE;
-              const data = {
-                correlation_id: meeting.correlationId,
-                locus_id: meeting.locusUrl.split('/').pop(),
-                reason: error.message,
-                stack: error.stack
-              };
-              const metadata = {
-                type: error.name
-              };
-
-              Metrics.sendBehavioralMetric(metricName, data, metadata);
-              LoggerProxy.logger.error(`Roap:handler#perform --> Error occured during wait receive answer, continuing, ${error}`);
-            });
-        }
-        break;
-      case ROAP.ROAP_STATE.WAIT_TX_OK:
-        if (!RoapUtil.shouldHandleMedia(meeting)) {
-          RoapUtil.setRemoteDescription(meeting, session).then((res) => {
-            this.roapOk(res);
-          });
-        }
-        break;
-      // case ROAP.ROAP_STATE.IDLE_LOCAL_OFFER:
-      case ROAP.ROAP_STATE.ERROR:
-        LoggerProxy.logger.error(`Roap:handler#perform --> Roap State ERROR for session: ${session}`);
-        break;
-      case ROAP.ROAP_STATE.GLARE:
-        session.GLARE_OFFER.tieBreaker = session.GLARE_OFFER.tieBreaker || 0;
-        session.OFFER.tieBreaker = session.OFFER.tieBreaker || 0;
-        LoggerProxy.logger.warn('Roap:handler#perform --> Roap State resolved the GLARE condition.');
-        if (session.GLARE_OFFER.tieBreaker < session.OFFER.tieBreaker) {
-          // 2
-          LoggerProxy.logger.log('Roap:handler#perform --> Roap State local offer won after GLARE.');
-        }
-        else {
-          LoggerProxy.logger.log('Roap:handler#perform --> Roap State remote offer won after GLARE.');
-        }
-        session.state.step(ROAP.ROAP_SIGNAL.GLARE_RESOLVED, meeting, action);
-        this.perform(session, meeting);
-        break;
-      default:
-        break;
-    }
-  }
-
-  /**
-   *
-   * @param {String} signal
-   * @param {Object} session
-   * @param {Object} action
-   * @param {Meeting} meeting
-   * @param {String} prefix
-   * @returns {null}
-   */
-  execute(signal, session, action, meeting, prefix) {
-    if (session && session.state) {
-      handleSessionStep({
-        roap: action,
-        locusUrl: meeting.locusUrl,
-        correlationId: meeting.correlationId,
-        session
-      });
-      signal = ROAP.ROAP_SIGNAL[`${prefix}${action.msg.messageType}`];
-      session.state.step(signal, meeting, action);
-      this.perform(session, meeting, action);
-    }
-  }
-
-  /**
-   *
-   * @param {Object} session
-   * @param {Object} action
-   * @param {Meeting} meeting
-   * @param {String} correlationId
-   * @returns {Boolean}
-   */
-  handleAction(session, action, meeting, correlationId) {
-    let signal;
-
-
-    switch (action.type) {
-      case ROAP.RECEIVE_ROAP_MSG:
-        LoggerProxy.logger.log(`Roap:handler#handleAction --> RECEIVE_ROAP_MSG event captured, reciving a roap message : ${JSON.stringify(action)}`);
-        if (compareWithLastRoapMessage(this.lastRoapMessage, action)) {
-          LoggerProxy.logger.warn(`Roap:handler#handleAction --> duplicate roap offer from server: ${action.msg.seq}`);
-        }
-        else {
-          this.lastRoapMessage = action;
-          action.remote = true;
-          this.execute(signal, session, action, meeting, ROAP.RX_);
-        }
-        break;
-      case ROAP.SEND_ROAP_MSG:
-        LoggerProxy.logger.log(`Roap:handler#handleAction --> SEND_ROAP_MSG event captured, sending roap message ${JSON.stringify(action)}`);
-
-        action.local = true;
-        this.execute(signal, session, action, meeting, ROAP.TX_);
-        break;
-      case ROAP.SEND_ROAP_MSG_SUCCESS:
-        // NOTE: When server send back an answer via mercury the
-        // remote SDP is already saved sent and ok message is sent back
-        // We dont have to indicate the roapHandler about the RX_ANSWER via SEND_ROAP_MSG_SUCCESS
-        break;
-      case ROAP.RECEIVE_CALL_LEAVE:
-        RoapCollection.deleteSession(correlationId);
-        LoggerProxy.logger.log(`Roap:handler#handleAction --> RECEIVE_CALL_LEAVE event captured, cleaning up the RoapHandler for correlationId: ${correlationId}`); break;
-      case ROAP.RESET_ROAP_STATE:
-        RoapCollection.deleteSessionSequence(correlationId, action.msg.seq);
-        LoggerProxy.logger.log(`Roap:handler#handleAction --> RESET_ROAP_STATE event captured, resetting the RoapHandler state based on sequenceId: ${action.msg.seq}`); break;
-      default:
-        return true;
-    }
-
-    return true;
-  }
-
-  /**
-   *
-   * @param {Object} action
-   * @returns {Boolean}
-   */
-  submit(action) {
-    const {correlationId} = action;
-    let {seq} = action;
-
-    if (!seq && action.msg) {
-      seq = action.msg.seq;
-    }
-    const session = RoapCollection.getSessionSequence(correlationId, seq);
-    const meeting = this.webex.meetings.meetingCollection.getByKey('correlationId', correlationId);
-
-    if (checkForAndHandleErrors(action, meeting, correlationId)) {
-      return true;
-    }
-
-    return this.handleAction(session, action, meeting, correlationId);
-  }
-}