@webex/plugin-meetings 3.0.0-beta.14 → 3.0.0-beta.140

package/src/meeting/effectsState.ts

@@ -1,211 +0,0 @@
-/* eslint-disable no-param-reassign */
-import {Media as WebRTCMedia} from '@webex/internal-media-core';
-
-import BEHAVIORAL_METRICS from '../metrics/constants';
-import Metrics from '../metrics';
-import MediaUtil from '../media/util';
-import LoggerProxy from '../common/logs/logger-proxy';
-import {BNR_STATUS} from '../constants';
-
-const createEffectsState = (type: any) => {
-  LoggerProxy.logger.info(`Meeting:effectState#createEffectsState --> creating effectsState for effect ${type}`);
-
-  return new EffectsState(type);
-};
-
-/* The purpose of this class is to manage the effects state(for eg., BNR).
-*/
-class EffectsState {
-  effectType: any;
-  pendingPromiseReject: any;
-  pendingPromiseResolve: any;
-  state: any;
-
-  constructor(type: any) {
-    this.effectType = type;
-    this.state = {
-      bnr: {
-        enabled: BNR_STATUS.NOT_ENABLED
-      },
-      callToWebrtcBNRInProgress: false
-    };
-    // these 2 hold the resolve, reject methods for the promise we returned to the client in last handleClientRequest() call
-    this.pendingPromiseResolve = null;
-    this.pendingPromiseReject = null;
-  }
-
-  /**
-   * @memberof EffectsState
-   * @param {Boolean} [isEnable] true for enableBNR, false for disableBNR request
-   * @param {Object} [meeting] the meeting object
-   * @returns {Promise}
-   */
-  async handleClientRequest(isEnable?: boolean, meeting?: object) {
-    return new Promise((resolve, reject) => {
-      if (this.pendingPromiseResolve) {
-        // resolve the last promise we returned to the client as the client has issued a new request that has superseded the previous one
-        this.pendingPromiseResolve();
-      }
-      this.pendingPromiseResolve = resolve;
-      this.pendingPromiseReject = reject;
-
-      if (isEnable) this.enableBNR(meeting);
-      else this.disableBNR(meeting);
-    });
-  }
-
-  /**
-   * Internal API to return status of BNR
-   * @memberof EffectsState
-   * @returns {Boolean}
-   * @public
-   * @memberof Meeting
-   */
-  public isBnrEnabled() {
-    return this.state.bnr.enabled === BNR_STATUS.ENABLED;
-  }
-
-  resolvePromise() {
-    if (this.pendingPromiseResolve) {
-      this.pendingPromiseResolve(true);
-    }
-    this.pendingPromiseResolve = null;
-    this.pendingPromiseReject = null;
-  }
-
-  rejectPromise(e) {
-    if (this.pendingPromiseReject) {
-      this.pendingPromiseReject(e);
-    }
-    this.pendingPromiseResolve = null;
-    this.pendingPromiseReject = null;
-  }
-
-  /**
-   * enableBNR API
-   * @param {Object} meeting the meeting object
-   * @returns {Promise<Boolean>}
-   * @public
-   * @memberof EffectsState
-   */
-  public async enableBNR(meeting: any) {
-    LoggerProxy.logger.info('Meeting:effectState#enableBNR. Enable BNR called');
-
-    if (this.isBnrEnabled()) {
-      LoggerProxy.logger.warn('Meeting:index#enableBNR. BNR is already enabled');
-
-      return this.resolvePromise();
-    }
-
-    if (this.state.callToWebrtcBNRInProgress) {
-      LoggerProxy.logger.warn('Meeting:effectState#enableBNR. Call to WebRTC in progress, we need to wait for it to complete');
-
-      return this.resolvePromise();
-    }
-
-    const {bnr} = this.state;
-
-    try {
-      bnr.enabled = BNR_STATUS.SHOULD_ENABLE;
-      this.state.callToWebrtcBNRInProgress = true;
-      const audioStream = MediaUtil.createMediaStream([meeting.mediaProperties.audioTrack]);
-
-      LoggerProxy.logger.info('Meeting:effectState#enableBNR. MediaStream created from meeting & sent to updateAudio');
-      await meeting.updateAudio({
-        sendAudio: true,
-        receiveAudio: meeting.mediaProperties.mediaDirection.receiveAudio,
-        stream: audioStream
-      });
-
-      LoggerProxy.logger.info('Meeting:effectState#enableBNR. Updated meeting audio with bnr enabled track');
-      bnr.enabled = BNR_STATUS.ENABLED;
-      this.state.callToWebrtcBNRInProgress = false;
-      Metrics.sendBehavioralMetric(
-        BEHAVIORAL_METRICS.ENABLE_BNR_SUCCESS,
-      );
-    }
-    catch (error) {
-      bnr.enabled = BNR_STATUS.NOT_ENABLED;
-      this.state.callToWebrtcBNRInProgress = false;
-      LoggerProxy.logger.error('Meeting:index#enableBNR.', error);
-
-      Metrics.sendBehavioralMetric(
-        BEHAVIORAL_METRICS.ENABLE_BNR_FAILURE,
-        {
-          reason: error.message,
-          stack: error.stack
-        }
-      );
-      this.rejectPromise(error);
-
-      throw error;
-    }
-
-    return this.resolvePromise();
-  }
-
-  /**
-   * disableBNR API
-   * @param {Object} meeting the meeting object
-   * @returns {Promise<Boolean>}
-   * @public
-   * @memberof EffectsState
-   */
-  public async disableBNR(meeting: any) {
-    LoggerProxy.logger.info('Meeting:effectState#disableBNR. Disable BNR called');
-
-    const {bnr} = this.state;
-
-    try {
-      if (this.state.callToWebrtcBNRInProgress) {
-        LoggerProxy.logger.info('Meeting:effectState#disableBNR. Call to WebRTC in progress, we need to wait for it to complete');
-
-        return this.resolvePromise();
-      }
-
-      bnr.enabled = BNR_STATUS.SHOULD_DISABLE;
-      this.state.callToWebrtcBNRInProgress = true;
-
-      // @ts-ignore - disableBNR does not expect an argument
-      const audioTrack = WebRTCMedia.Effects.BNR.disableBNR(meeting.mediaProperties.audioTrack);
-
-      const audioStream = MediaUtil.createMediaStream([audioTrack]);
-
-      LoggerProxy.logger.info('Meeting:effectState#disableBNR. Raw media track obtained from WebRTC & sent to updateAudio');
-
-      await meeting.updateAudio({
-        sendAudio: true,
-        receiveAudio: meeting.mediaProperties.mediaDirection.receiveAudio,
-        stream: audioStream
-      });
-
-      bnr.enabled = BNR_STATUS.NOT_ENABLED;
-
-      this.state.callToWebrtcBNRInProgress = false;
-
-      Metrics.sendBehavioralMetric(
-        BEHAVIORAL_METRICS.DISABLE_BNR_SUCCESS
-      );
-    }
-    catch (error) {
-      bnr.enabled = BNR_STATUS.ENABLED;
-      this.state.callToWebrtcBNRInProgress = false;
-      LoggerProxy.logger.error(`Meeting:index#disableBNR. ${error}`);
-
-      Metrics.sendBehavioralMetric(
-        BEHAVIORAL_METRICS.DISABLE_BNR_FAILURE,
-        {
-          reason: error.message,
-          stack: error.stack
-        }
-      );
-      this.rejectPromise(error);
-
-      throw error;
-    }
-
-    return this.resolvePromise();
-  }
-}
-
-export default createEffectsState;

package/src/multistream/multistreamMedia.ts

@@ -1,92 +0,0 @@
-/* eslint-disable import/prefer-default-export */
-
-import {AUDIO, VIDEO} from '../constants';
-import createMuteState from '../meeting/muteState';
-import Meeting from '../meeting';
-
-/**
- * Class wrapping all the multistream specific APIs that need to be exposed at meeting level.
- *
- */
-export class MultistreamMedia {
-  private meeting: Meeting;
-
-  /**
-   * Constructor
-   * @param {Meeting} meeting
-   */
-  constructor(meeting: Meeting) {
-    this.meeting = meeting;
-  }
-
-  /**
-   * throws if we don't have a media connection created
-   */
-  private checkMediaConnection() {
-    if (this.meeting?.mediaProperties?.webrtcMediaConnection) {
-      return;
-    }
-    throw new Error('Webrtc media connection is missing');
-  }
-
-  /**
-   * Publishes a local track in the meeting
-   *
-   * @param {MediaStreamTrack} track
-   * @returns {Promise}
-   */
-  publishTrack(track: MediaStreamTrack): Promise<void> {
-    this.checkMediaConnection();
-
-    /* todo: for now we don't support screen share (waiting for server to support bundling, see SPARK-377812)
-       for sharing:
-          we have to call meeting.stopFloorRequest() before unpublishing a track
-          we have to call meeting.share() after publishing a track
-    */
-
-    // todo: depending on how muting is done with Local tracks, this code here might need to change...
-
-    if (track.kind === 'audio') {
-      this.meeting.setLocalAudioTrack(track);
-      this.meeting.mediaProperties.mediaDirection.sendAudio = true;
-
-      // audio state could be undefined if you have not sent audio before
-      this.meeting.audio =
-        this.meeting.audio ||
-        createMuteState(AUDIO, this.meeting, this.meeting.mediaProperties.mediaDirection);
-    } else if (track.kind === 'video') {
-      this.meeting.setLocalVideoTrack(track);
-      this.meeting.mediaProperties.mediaDirection.sendVideo = true;
-
-      // video state could be undefined if you have not sent video before
-      this.meeting.video =
-        this.meeting.video ||
-        createMuteState(VIDEO, this.meeting, this.meeting.mediaProperties.mediaDirection);
-    }
-
-    return this.meeting.mediaProperties.webrtcMediaConnection.publishTrack(track);
-  }
-
-  /**
-   * Unpublishes a local track in the meeting
-   *
-   * @param {MediaStreamTrack} track
-   * @returns {Promise}
-   */
-  unpublishTrack(track: MediaStreamTrack): Promise<void> {
-    // todo: see todos in publishTrack() - they all apply here too:
-    // screen sharing - SPARK-377812
-    // muting etc
-
-    if (track.kind === 'audio') {
-      this.meeting.setLocalVideoTrack(null);
-      this.meeting.mediaProperties.mediaDirection.sendAudio = false;
-    } else if (track.kind === 'video') {
-      this.meeting.setLocalAudioTrack(null);
-      this.meeting.mediaProperties.mediaDirection.sendVideo = false;
-    }
-    this.checkMediaConnection();
-
-    return this.meeting.mediaProperties.webrtcMediaConnection.unpublishTrack(track);
-  }
-}

package/test/unit/spec/meeting/effectsState.js

@@ -1,291 +0,0 @@
-/* eslint-disable camelcase */
-import {assert} from '@webex/test-helper-chai';
-import sinon from 'sinon';
-import MockWebex from '@webex/test-helper-mock-webex';
-import {BNR_STATUS} from '@webex/plugin-meetings/src/constants';
-import BEHAVIORAL_METRICS from '@webex/plugin-meetings/src/metrics/constants';
-import Meeting from '@webex/plugin-meetings/src/meeting';
-import Meetings from '@webex/plugin-meetings';
-import Metrics from '@webex/plugin-meetings/src/metrics';
-import MediaUtil from '@webex/plugin-meetings/src/media/util';
-import MeetingUtil from '@webex/plugin-meetings/src/meeting/util';
-import createEffectsState from '@webex/plugin-meetings/src/meeting/effectsState';
-import LoggerProxy from '@webex/plugin-meetings/src/common/logs/logger-proxy';
-import LoggerConfig from '@webex/plugin-meetings/src/common/logs/logger-config';
-
-describe('plugin-meetings', () => {
-  const logger = {
-    info: () => {},
-    log: () => {},
-    error: () => {},
-    warn: () => {},
-    trace: () => {},
-    debug: () => {}
-  };
-
-  beforeEach(() => {
-    sinon.stub(Metrics, 'sendBehavioralMetric');
-  });
-  afterEach(() => {
-    sinon.restore();
-  });
-
-  Object.defineProperty(global.window.navigator, 'mediaDevices', {
-    writable: true,
-    value: {
-      getSupportedConstraints: sinon.stub().returns({
-        sampleRate: true
-      })
-    },
-  });
-  LoggerConfig.set({verboseEvents: true, enable: false});
-  LoggerProxy.set(logger);
-
-  let webex;
-  let meeting;
-  let uuid1;
-
-  const fakeMediaTrack = () => ({
-    id: Date.now().toString(),
-    stop: () => {},
-    readyState: 'live',
-    enabled: true,
-    getSettings: () => ({
-      sampleRate: 48000
-    })
-  });
-
-  class FakeMediaStream {
-    constructor(tracks) {
-      this.active = false;
-      this.id = '5146425f-c240-48cc-b86b-27d422988fb7';
-      this.tracks = tracks;
-    }
-
-    addTrack = () => undefined;
-
-    getAudioTracks = () => this.tracks;
-  }
-
-  class FakeAudioContext {
-    constructor() {
-      this.state = 'running';
-      this.baseLatency = 0.005333333333333333;
-      this.currentTime = 2.7946666666666666;
-      this.sampleRate = 48000;
-      this.audioWorklet = {
-        addModule: async () => undefined,
-      };
-    }
-
-    onstatechange = null;
-
-    createMediaStreamSource() {
-      return {
-        connect: () => undefined,
-        mediaStream: {
-          getAudioTracks() {
-          // eslint-disable-next-line no-undef
-            return [new MediaStreamTrack()];
-          },
-        },
-      };
-    }
-
-    createMediaStreamDestination() {
-      return {
-        stream: {
-          getAudioTracks() {
-          // eslint-disable-next-line no-undef
-            return [new MediaStreamTrack()];
-          },
-        },
-      };
-    }
-  }
-
-  class FakeAudioWorkletNode {
-    constructor() {
-      this.port = {
-        postMessage: () => undefined,
-      };
-    }
-
-    connect() {
-    /* placeholder method */
-    }
-  }
-
-  class FakeMediaStreamTrack {
-    constructor() {
-      this.kind = 'audio';
-      this.enabled = true;
-      this.label = 'Default - MacBook Pro Microphone (Built-in)';
-      this.muted = false;
-      this.readyState = 'live';
-      this.contentHint = '';
-    }
-
-    getSettings() {
-      return {
-        sampleRate: 48000
-      };
-    }
-  }
-  Object.defineProperty(global, 'MediaStream', {
-    writable: true,
-    value: FakeMediaStream,
-  });
-
-  Object.defineProperty(global, 'AudioContext', {
-    writable: true,
-    value: FakeAudioContext,
-  });
-
-  Object.defineProperty(global, 'AudioWorkletNode', {
-    writable: true,
-    value: FakeAudioWorkletNode,
-  });
-
-  Object.defineProperty(global, 'MediaStreamTrack', {
-    writable: true,
-    value: FakeMediaStreamTrack,
-  });
-
-  let effects;
-
-  beforeEach(() => {
-    webex = new MockWebex({
-      children: {
-        meetings: Meetings
-      }
-    });
-    meeting = new Meeting(
-      {
-        userId: uuid1
-      },
-      {
-        parent: webex
-      }
-    );
-
-    effects = createEffectsState('BNR');
-    meeting.canUpdateMedia = sinon.stub().returns(true);
-    MeetingUtil.validateOptions = sinon.stub().returns(Promise.resolve());
-
-    meeting.addMedia = sinon.stub().returns(Promise.resolve());
-    meeting.getMediaStreams = sinon.stub().returns(Promise.resolve());
-    sinon.stub(meeting, 'effects').value(effects);
-    sinon.replace(meeting, 'addMedia', () => {
-      sinon.stub(meeting.mediaProperties, 'audioTrack').value(fakeMediaTrack());
-      sinon.stub(meeting.mediaProperties, 'mediaDirection').value({
-        receiveAudio: true
-      });
-      sinon.stub(meeting.mediaProperties, 'webrtcMediaConnection').value({updateSendReceiveOptions: sinon.stub()});
-    });
-  });
-
-  describe('bnr effect library', () => {
-    beforeEach(async () => {
-      await meeting.getMediaStreams();
-      await meeting.addMedia();
-    });
-    describe('#enableBNR', () => {
-      it('should have #enableBnr', () => {
-        assert.exists(effects.enableBNR);
-      });
-
-      it('does bnr effect enable on audio track', async () => {
-        assert.isTrue(await effects.handleClientRequest(true, meeting));
-        assert.equal(effects.state.bnr.enabled, BNR_STATUS.ENABLED);
-
-        assert(Metrics.sendBehavioralMetric.calledOnce);
-        assert.calledWith(
-          Metrics.sendBehavioralMetric,
-          BEHAVIORAL_METRICS.ENABLE_BNR_SUCCESS,
-        );
-      });
-
-      it('does resolve request if bnr is already enabled', async () => {
-        effects.state.bnr.enabled = BNR_STATUS.ENABLED;
-        assert.isTrue(await effects.handleClientRequest(true, meeting));
-        assert.equal(effects.state.bnr.enabled, BNR_STATUS.ENABLED);
-      });
-
-      it('if called twice, does bnr effect enable on audio track for the first request and resolves second', async () => {
-        Promise.all([effects.handleClientRequest(true, meeting), effects.handleClientRequest(true, meeting)])
-          .then((resolveFirst, resolveSecond) => {
-            assert.isTrue(resolveFirst);
-            assert.isTrue(resolveSecond);
-            assert.calledOnce(MediaUtil.createMediaStream);
-          });
-      });
-
-      it('should throw error for inappropriate sample rate and send error metrics', async () => {
-        const fakeMediaTrack1 = () => ({
-          id: Date.now().toString(),
-          stop: () => {},
-          readyState: 'live',
-          getSettings: () => ({
-            sampleRate: 49000
-          })
-        });
-
-        sinon.stub(meeting.mediaProperties, 'audioTrack').value(fakeMediaTrack1());
-
-        // eslint-disable-next-line no-undef
-        MediaUtil.createMediaStream = sinon.stub().returns(new MediaStream([fakeMediaTrack1()]));
-        try {
-          await effects.handleClientRequest(true, meeting);
-        }
-        catch (err) {
-          assert(Metrics.sendBehavioralMetric.calledOnce);
-          assert.calledWith(
-            Metrics.sendBehavioralMetric,
-            BEHAVIORAL_METRICS.ENABLE_BNR_FAILURE, {
-              reason: err.message,
-              stack: err.stack
-            }
-          );
-          assert.equal(err.message, 'Sample rate of 49000 is not supported.');
-        }
-      });
-    });
-
-    describe('#disableBNR', () => {
-      beforeEach(() => {
-        effects.state.bnr.enabled = BNR_STATUS.ENABLED;
-      });
-      it('should have #disableBnr', () => {
-        assert.exists(effects.disableBNR);
-      });
-
-      it('does bnr disable on audio track', async () => {
-        assert.isTrue(await effects.handleClientRequest(false, meeting));
-        assert.equal(effects.state.bnr.enabled, BNR_STATUS.NOT_ENABLED);
-
-        assert(Metrics.sendBehavioralMetric.calledOnce);
-        assert.calledWith(
-          Metrics.sendBehavioralMetric,
-          BEHAVIORAL_METRICS.DISABLE_BNR_SUCCESS,
-        );
-      });
-
-      it('reject request for disable bnr if not enabled', async () => {
-        try {
-          await effects.handleClientRequest(false, meeting);
-        }
-        catch (e) {
-          assert.equal(e.message, 'Can not disable as BNR is not enabled');
-          assert.equal(effects.state.bnr.enabled, BNR_STATUS.ENABLED);
-
-          assert(Metrics.sendBehavioralMetric.calledOnce);
-          assert.calledWith(
-            Metrics.sendBehavioralMetric,
-            BEHAVIORAL_METRICS.DISABLE_BNR_FAILURE,
-          );
-        }
-      });
-    });
-  });
-});