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

package/test/unit/spec/locus-info/selfUtils.js

@@ -33,6 +33,24 @@ describe('plugin-meetings', () => {
         assert.calledWith(getRolesSpy, self);
 
         assert.deepEqual(parsedSelf.roles, ['PRESENTER']);
+        assert.deepEqual(parsedSelf.breakoutSessions, {
+          active: [
+            {
+              name: 'Breakout session 2',
+              groupId: '0e73abb8-5584-49d8-be8d-806d2a8247ca',
+              sessionId: '1cf41ab1-2e57-4d95-b7e9-5613acddfb0f',
+              sessionType: 'BREAKOUT',
+            },
+          ],
+          allowed: [
+            {
+              name: 'Breakout session 2',
+              groupId: '0e73abb8-5584-49d8-be8d-806d2a8247ca',
+              sessionId: '1cf41ab1-2e57-4d95-b7e9-5613acddfb0f',
+              sessionType: 'BREAKOUT',
+            },
+          ],
+        });
       });
 
       it('calls getLayout and returns the resulting layout', () => {
@@ -58,9 +76,107 @@ describe('plugin-meetings', () => {
       });
     });
 
+    describe('getBreakoutSessions', () => {
+      it('should return breakout sessions', () => {
+        assert.deepEqual(
+          SelfUtils.getBreakoutSessions({controls: {breakout: {sessions: 'SESSIONS'}}}),
+          'SESSIONS'
+        );
+      });
+    });
+
+    describe('breakoutsChanged', () => {
+      it('should return true if breakouts have changed', () => {
+        const current = {
+          breakoutSessions: {
+            allowed: [
+              {
+                name: 'Breakout session 2',
+                groupId: '0e73abb8-5584-49d8-be8d-806d2a8247ca',
+                sessionId: '1cf41ab1-2e57-4d95-b7e9-5613acddfb0f',
+                sessionType: 'BREAKOUT',
+              },
+            ],
+          },
+          breakout: {},
+        };
+        const previous = {
+          breakoutSessions: {
+            active: [
+              {
+                name: 'Breakout session 2',
+                groupId: '0e73abb8-5584-49d8-be8d-806d2a8247ca',
+                sessionId: '1cf41ab1-2e57-4d95-b7e9-5613acddfb0f',
+                sessionType: 'BREAKOUT',
+              },
+            ],
+          },
+          breakout: {},
+        };
+
+        assert.isTrue(SelfUtils.breakoutsChanged(previous, current));
+      });
+
+      it('should return false if breakouts have not changed', () => {
+        const current = {
+          breakoutSessions: {
+            active: [
+              {
+                name: 'Breakout session 2',
+                groupId: '0e73abb8-5584-49d8-be8d-806d2a8247ca',
+                sessionId: '1cf41ab1-2e57-4d95-b7e9-5613acddfb0f',
+                sessionType: 'BREAKOUT',
+              },
+            ],
+          },
+          breakout: {},
+        };
+        const previous = {
+          breakoutSessions: {
+            active: [
+              {
+                name: 'Breakout session 2',
+                groupId: '0e73abb8-5584-49d8-be8d-806d2a8247ca',
+                sessionId: '1cf41ab1-2e57-4d95-b7e9-5613acddfb0f',
+                sessionType: 'BREAKOUT',
+              },
+            ],
+          },
+          breakout: {},
+        };
+
+        assert.isFalse(SelfUtils.breakoutsChanged(previous, current));
+      });
+
+      it('should return false if no breakouts in current', () => {
+        const current = {
+          breakoutSessions: {
+          },
+        };
+        const previous = {
+          breakoutSessions: {
+            active: [
+              {
+                name: 'Breakout session 2',
+                groupId: '0e73abb8-5584-49d8-be8d-806d2a8247ca',
+                sessionId: '1cf41ab1-2e57-4d95-b7e9-5613acddfb0f',
+                sessionType: 'BREAKOUT',
+              },
+            ],
+          },
+          breakout: {},
+        };
+
+        assert.isFalse(SelfUtils.breakoutsChanged(previous, current));
+      });
+    });
+
     describe('canNotViewTheParticipantList', () => {
       it('should return the correct value', () => {
-        assert.equal(SelfUtils.canNotViewTheParticipantList(self), self.canNotViewTheParticipantList);
+        assert.equal(
+          SelfUtils.canNotViewTheParticipantList(self),
+          self.canNotViewTheParticipantList
+        );
       });
 
       it('should return false if the new self does not have a value', () => {
@@ -90,17 +206,23 @@ describe('plugin-meetings', () => {
       it('get roles works', () => {
         assert.deepEqual(SelfUtils.getRoles(self), ['PRESENTER']);
 
-        assert.deepEqual(SelfUtils.getRoles({
-          controls: {
-            role: {roles: [{type: 'SOME_ARBITRARY_ROLE', hasRole: true}]}
-          }
-        }), ['SOME_ARBITRARY_ROLE']);
-
-        assert.deepEqual(SelfUtils.getRoles({
-          controls: {
-            role: {roles: [{type: 'SOME_ARBITRARY_ROLE', hasRole: false}]}
-          }
-        }), []);
+        assert.deepEqual(
+          SelfUtils.getRoles({
+            controls: {
+              role: {roles: [{type: 'SOME_ARBITRARY_ROLE', hasRole: true}]},
+            },
+          }),
+          ['SOME_ARBITRARY_ROLE']
+        );
+
+        assert.deepEqual(
+          SelfUtils.getRoles({
+            controls: {
+              role: {roles: [{type: 'SOME_ARBITRARY_ROLE', hasRole: false}]},
+            },
+          }),
+          []
+        );
 
         assert.deepEqual(SelfUtils.getRoles({}), []);
         assert.deepEqual(SelfUtils.getRoles(), []);
@@ -173,4 +295,106 @@ describe('plugin-meetings', () => {
       assert.deepEqual(SelfUtils.isJoined(customSelf), false);
     });
   });
+
+  describe('videoMutedByOthersChanged', () => {
+    it('returns true if changed', () => {
+      assert.equal(
+        SelfUtils.videoMutedByOthersChanged({remoteVideoMuted: true}, {remoteVideoMuted: false}),
+        true
+      );
+    });
+
+    it('returns true if changed from undefined', () => {
+      assert.equal(SelfUtils.videoMutedByOthersChanged({}, {remoteVideoMuted: false}), true);
+    });
+
+    it('returns false if not changed', () => {
+      assert.equal(
+        SelfUtils.videoMutedByOthersChanged({remoteVideoMuted: false}, {remoteVideoMuted: false}),
+        false
+      );
+    });
+  });
+
+  describe('isUpgradeToModeratorOrCohost', () => {
+    it('returns true if changed', () => {
+      assert.equal(
+        SelfUtils.isUpgradeToModeratorOrCohost({roles: ['ATTENDEE']}, {roles: ['ATTENDEE','MODERATOR']}),
+        true
+      );
+    });
+
+    it('returns true if changed', () => {
+      assert.equal(
+        SelfUtils.isUpgradeToModeratorOrCohost({roles: ['ATTENDEE']}, {roles: ['ATTENDEE','COHOST']}),
+        true
+      );
+    });
+
+    it('returns false if changed', () => {
+      assert.equal(
+        SelfUtils.isUpgradeToModeratorOrCohost({roles: ['ATTENDEE','MODERATOR']}, {roles: ['ATTENDEE']}),
+        false
+      );
+    });
+
+    it('returns false if changed', () => {
+      assert.equal(
+        SelfUtils.isUpgradeToModeratorOrCohost({roles: ['ATTENDEE','COHOST']}, {roles: ['ATTENDEE']}),
+        false
+      );
+    });
+
+    it('returns false if changed', () => {
+      assert.equal(
+        SelfUtils.isUpgradeToModeratorOrCohost({roles: ['ATTENDEE','HOST','MODERATOR']}, {roles: ['ATTENDEE']}),
+        false
+      );
+    });
+  });
+
+  describe('getReplacedBreakoutMoveId', () => {
+    const deviceId = 'https://wdm-a.wbx2.com/wdm/api/v1/devices/20eabde3-4254-48da-9a24';
+    const breakoutMoveId = 'e5caeb2c-ffcc-4e06-a08a-1122e7710398';
+    const clonedSelf = cloneDeep(self);
+
+    it('get breakoutMoveId works', () => {
+
+      assert.deepEqual(SelfUtils.getReplacedBreakoutMoveId(self, deviceId), breakoutMoveId);
+
+    });
+
+    it('replaces is empty', () => {
+
+      clonedSelf.devices[0].replaces = undefined;
+      assert.deepEqual(SelfUtils.getReplacedBreakoutMoveId(clonedSelf, deviceId), null);
+
+    });
+
+    it('no self or self.devices is not array', () => {
+
+      assert.deepEqual(SelfUtils.getReplacedBreakoutMoveId(undefined, deviceId), null);
+
+      clonedSelf.devices =     {
+        url: 'https://wdm-a.wbx2.com/wdm/api/v1/devices/20eabde3-4254-48da-9a24',
+        deviceType: 'WEB',
+        mediaSessionsExternal: false,
+        replaces: [
+          {
+            breakoutMoveId: 'e5caeb2c-ffcc-4e06-a08a-1122e7710398',
+            lastActive: '2023-05-04T07:14:32.068Z',
+            locusUrl: 'https://locus-alpha-apdx.prod.meetapi.webex.com/locus/api/v1/loci/495061ca-7b3c-3b77-85ff-4e1bd58600d1',
+            replacedAt: '2023-05-04T07:16:04.905Z',
+            sessionId: 'be3147d4-c318-86d8-7611-8d24beaaca8d',
+          }
+        ],
+        state: 'JOINED',
+      };
+      assert.deepEqual(SelfUtils.getReplacedBreakoutMoveId(clonedSelf, deviceId), null);
+
+    });
+
+
+  });
+
 });

package/test/unit/spec/media/index.ts

@@ -0,0 +1,303 @@
+import * as internalMediaModule from '@webex/internal-media-core';
+import Media from '@webex/plugin-meetings/src/media/index';
+import {assert} from '@webex/test-helper-chai';
+import sinon from 'sinon';
+import StaticConfig from '@webex/plugin-meetings/src/common/config';
+import { forEach } from 'lodash';
+
+describe('createMediaConnection', () => {
+  const fakeRoapMediaConnection = {
+    id: 'roap media connection',
+  };
+  const fakeAudioTrack = {
+    id: 'audio track',
+    underlyingTrack: 'underlying audio track',
+  };
+  const fakeVideoTrack = {
+    id: 'video track',
+    underlyingTrack: 'underlying video track',
+  };
+
+  afterEach(() => {
+    sinon.restore();
+  });
+
+  it('creates a RoapMediaConnection when multistream is disabled', () => {
+    const roapMediaConnectionConstructorStub = sinon
+      .stub(internalMediaModule, 'RoapMediaConnection')
+      .returns(fakeRoapMediaConnection);
+
+    StaticConfig.set({bandwidth: {audio: 123, video: 456, startBitrate: 999}});
+
+    const ENABLE_EXTMAP = false;
+    const ENABLE_RTX = true;
+
+    Media.createMediaConnection(false, 'some debug id', {
+      mediaProperties: {
+        mediaDirection: {
+          sendAudio: true,
+          sendVideo: true,
+          sendShare: false,
+          receiveAudio: true,
+          receiveVideo: true,
+          receiveShare: true,
+        },
+        audioTrack: fakeAudioTrack,
+        videoTrack: fakeVideoTrack,
+        shareTrack: null,
+      },
+      remoteQualityLevel: 'HIGH',
+      enableRtx: ENABLE_RTX,
+      enableExtmap: ENABLE_EXTMAP,
+      turnServerInfo: {
+        url: 'turn server url',
+        username: 'turn username',
+        password: 'turn password',
+      },
+    });
+    assert.calledOnce(roapMediaConnectionConstructorStub);
+    assert.calledWith(
+      roapMediaConnectionConstructorStub,
+      {
+        iceServers: [
+          {
+            urls: 'turn server url',
+            username: 'turn username',
+            credential: 'turn password',
+          },
+        ],
+        skipInactiveTransceivers: false,
+        requireH264: true,
+        sdpMunging: {
+          convertPort9to0: false,
+          addContentSlides: true,
+          bandwidthLimits: {
+            audio: 123,
+            video: 456,
+          },
+          startBitrate: 999,
+          periodicKeyframes: 20,
+          disableExtmap: !ENABLE_EXTMAP,
+          disableRtx: !ENABLE_RTX,
+        },
+      },
+      {
+        send: {
+          audio: fakeAudioTrack.underlyingTrack,
+          video: fakeVideoTrack.underlyingTrack,
+          screenShareVideo: undefined,
+        },
+        receive: {
+          audio: true,
+          video: true,
+          screenShareVideo: true,
+          remoteQualityLevel: 'HIGH',
+        },
+      },
+      'some debug id'
+    );
+  });
+
+  it('creates a MultistreamRoapMediaConnection when multistream is enabled', () => {
+    const multistreamRoapMediaConnectionConstructorStub = sinon
+      .stub(internalMediaModule, 'MultistreamRoapMediaConnection')
+      .returns(fakeRoapMediaConnection);
+
+    Media.createMediaConnection(true, 'some debug id', {
+      mediaProperties: {
+        mediaDirection: {
+          sendAudio: true,
+          sendVideo: true,
+          sendShare: false,
+          receiveAudio: true,
+          receiveVideo: true,
+          receiveShare: true,
+        }
+      },
+      turnServerInfo: {
+        url: 'turn server url',
+        username: 'turn username',
+        password: 'turn password',
+      },
+      bundlePolicy: 'max-bundle',
+    });
+    assert.calledOnce(multistreamRoapMediaConnectionConstructorStub);
+    assert.calledWith(
+      multistreamRoapMediaConnectionConstructorStub,
+      {
+        iceServers: [
+          {
+            urls: 'turn server url',
+            username: 'turn username',
+            credential: 'turn password',
+          },
+        ],
+        enableMainAudio: true,
+        enableMainVideo: true,
+        bundlePolicy: 'max-bundle',
+      },
+      'some debug id'
+    );
+  });
+
+  forEach([
+    {sendAudio: true, receiveAudio: true, sendVideo: true, receiveVideo: true, enableMainAudio: true, enableMainVideo: true,},
+    {sendAudio: true, receiveAudio: false, sendVideo: true, receiveVideo: false, enableMainAudio: true, enableMainVideo: true,},
+    {sendAudio: false, receiveAudio: true, sendVideo: false, receiveVideo: true, enableMainAudio: true, enableMainVideo: true,},
+    {sendAudio: false, receiveAudio: false, sendVideo: false, receiveVideo: false, enableMainAudio: false, enableMainVideo: false,},
+  ], ({sendAudio, sendVideo, receiveAudio, receiveVideo, enableMainAudio, enableMainVideo}) => {
+    it(`sets enableMainVideo to ${enableMainVideo} and enableMainAudio to ${enableMainAudio} when sendAudio: ${sendAudio} sendVideo: ${sendVideo} receiveAudio: ${receiveAudio} receiveVideo: ${receiveVideo}`, () => {
+      const multistreamRoapMediaConnectionConstructorStub = sinon
+        .stub(internalMediaModule, 'MultistreamRoapMediaConnection')
+        .returns(fakeRoapMediaConnection);
+
+      Media.createMediaConnection(true, 'some debug id', {
+        mediaProperties: {
+          mediaDirection: {
+            sendAudio,
+            sendVideo,
+            sendShare: false,
+            receiveAudio,
+            receiveVideo,
+            receiveShare: true,
+          },
+        },
+      });
+      assert.calledOnce(multistreamRoapMediaConnectionConstructorStub);
+      assert.calledWith(
+        multistreamRoapMediaConnectionConstructorStub,
+        {
+          iceServers: [],
+          enableMainAudio,
+          enableMainVideo,
+        },
+        'some debug id'
+      );
+    });
+  });
+
+  it('passes empty ICE servers array to MultistreamRoapMediaConnection if turnServerInfo is undefined (multistream enabled)', () => {
+    const multistreamRoapMediaConnectionConstructorStub = sinon
+      .stub(internalMediaModule, 'MultistreamRoapMediaConnection')
+      .returns(fakeRoapMediaConnection);
+
+    Media.createMediaConnection(true, 'debug string', {
+      mediaProperties: {
+        mediaDirection: {
+          sendAudio: true,
+          sendVideo: true,
+          sendShare: false,
+          receiveAudio: true,
+          receiveVideo: true,
+          receiveShare: true,
+        },
+      },
+    });
+    assert.calledOnce(multistreamRoapMediaConnectionConstructorStub);
+    assert.calledWith(
+      multistreamRoapMediaConnectionConstructorStub,
+      {
+        iceServers: [],
+        enableMainAudio: true,
+        enableMainVideo: true,
+      },
+      'debug string'
+    );
+
+    it('does not pass bundlePolicy to MultistreamRoapMediaConnection if bundlePolicy is undefined', () => {
+      const multistreamRoapMediaConnectionConstructorStub = sinon
+        .stub(internalMediaModule, 'MultistreamRoapMediaConnection')
+        .returns(fakeRoapMediaConnection);
+  
+      Media.createMediaConnection(true, 'debug string', {
+        mediaProperties: {
+          mediaDirection: {
+            sendAudio: true,
+            sendVideo: true,
+            sendShare: false,
+            receiveAudio: true,
+            receiveVideo: true,
+            receiveShare: true,
+          },
+        },
+        bundlePolicy: undefined
+      });
+      assert.calledOnce(multistreamRoapMediaConnectionConstructorStub);
+      assert.calledWith(
+        multistreamRoapMediaConnectionConstructorStub,
+        {
+          iceServers: [],
+          enableMainAudio: true,
+          enableMainVideo: true,
+        },
+        'debug string'
+      );
+    });
+  });
+
+  it('passes empty ICE servers array to RoapMediaConnection if turnServerInfo is undefined (multistream disabled)', () => {
+    const roapMediaConnectionConstructorStub = sinon
+      .stub(internalMediaModule, 'RoapMediaConnection')
+      .returns(fakeRoapMediaConnection);
+
+    StaticConfig.set({bandwidth: {audio: 123, video: 456, startBitrate: 999}});
+
+    const ENABLE_EXTMAP = false;
+    const ENABLE_RTX = true;
+
+    Media.createMediaConnection(false, 'some debug id', {
+      mediaProperties: {
+        mediaDirection: {
+          sendAudio: true,
+          sendVideo: true,
+          sendShare: true,
+          receiveAudio: true,
+          receiveVideo: true,
+          receiveShare: true,
+        },
+        audioTrack: fakeAudioTrack,
+        videoTrack: null,
+        shareTrack: fakeVideoTrack,
+      },
+      remoteQualityLevel: 'HIGH',
+      enableRtx: ENABLE_RTX,
+      enableExtmap: ENABLE_EXTMAP,
+      turnServerInfo: undefined,
+    });
+    assert.calledOnce(roapMediaConnectionConstructorStub);
+    assert.calledWith(
+      roapMediaConnectionConstructorStub,
+      {
+        iceServers: [],
+        skipInactiveTransceivers: false,
+        requireH264: true,
+        sdpMunging: {
+          convertPort9to0: false,
+          addContentSlides: true,
+          bandwidthLimits: {
+            audio: 123,
+            video: 456,
+          },
+          startBitrate: 999,
+          periodicKeyframes: 20,
+          disableExtmap: !ENABLE_EXTMAP,
+          disableRtx: !ENABLE_RTX,
+        },
+      },
+      {
+        send: {
+          audio: fakeAudioTrack.underlyingTrack,
+          video: undefined,
+          screenShareVideo: fakeVideoTrack.underlyingTrack,
+        },
+        receive: {
+          audio: true,
+          video: true,
+          screenShareVideo: true,
+          remoteQualityLevel: 'HIGH',
+        },
+      },
+      'some debug id'
+    );
+  });
+});