@webex/plugin-meetings 3.0.0-beta.34 → 3.0.0-beta.341

package/dist/types/locus-info/index.d.ts

@@ -30,11 +30,27 @@ export default class LocusInfo extends EventsScope {
     fullState: any;
     host: any;
     info: any;
+    roles: any;
     mediaShares: any;
     replace: any;
     url: any;
     services: any;
+    mainSessionLocusCache: any;
+    /**
+     * Constructor
+     * @param {function} updateMeeting callback to update the meeting object from an object
+     * @param {object} webex
+     * @param {string} meetingId
+     * @returns {undefined}
+     */
     constructor(updateMeeting: any, webex: any, meetingId: any);
+    /**
+     * Does a Locus sync. It tries to get the latest delta DTO or if it can't, it falls back to getting the full Locus DTO.
+     *
+     * @param {Meeting} meeting
+     * @returns {undefined}
+     */
+    private doLocusSync;
     /**
      * Apply locus delta data to meeting
      * @param {string} action Locus delta action
@@ -139,19 +155,20 @@ export default class LocusInfo extends EventsScope {
      */
     updateParticipantDeltas(participants?: Array<any>): void;
     /**
-     *
+     * update meeting's members
      * @param {Object} participants new participants object
-     * @param {boolen} deltaParticpantFlag  delta event
+     * @param {Boolean} isReplace is replace the whole members
      * @returns {Array} updatedParticipants
      * @memberof LocusInfo
      */
-    updateParticipants(participants: object): void;
+    updateParticipants(participants: object, isReplace?: boolean): void;
     /**
      * @param {Object} controls
+     * @param {Object} self
      * @returns {undefined}
      * @memberof LocusInfo
      */
-    updateControls(controls: object): void;
+    updateControls(controls: object, self: object): void;
     /**
      * @param {String} conversationUrl
      * @param {Object} info
@@ -266,4 +283,40 @@ export default class LocusInfo extends EventsScope {
      * @memberof LocusInfo
      */
     updateIdentifiers(identities: Array<any>): void;
+    /**
+     * check the locus is main session's one or not, if is main session's, update main session cache
+     * @param {Object} locus
+     * @returns {undefined}
+     * @memberof LocusInfo
+     */
+    updateLocusCache(locus: any): void;
+    /**
+     * if return from breakout to main session, need to use cached main session DTO since locus won't send the full locus (participants)
+     * if join breakout from main session, need to query main locus url (if response with 403 means no privilege, need to clear the cache)
+     * @param {Object} newLocus
+     * @returns {Object}
+     * @memberof LocusInfo
+     */
+    getTheLocusToUpdate(newLocus: any): any;
+    /**
+     * merge participants by participant id
+     * @param {Array} participants
+     * @param {Array} sourceParticipants
+     * @returns {Array} merged participants
+     * @memberof LocusInfo
+     */
+    mergeParticipants(participants: any, sourceParticipants: any): any;
+    /**
+     * need cache main sessions' participants since locus will not send the full list when cohost/host leave breakout
+     * @param {Object} mainLocus
+     * @returns {undefined}
+     * @memberof LocusInfo
+     */
+    updateMainSessionLocusCache(mainLocus: any): void;
+    /**
+     * clear main session cache
+     * @returns {undefined}
+     * @memberof LocusInfo
+     */
+    clearMainSessionLocusCache(): void;
 }

package/dist/types/locus-info/parser.d.ts

@@ -1,14 +1,25 @@
+import SortedQueue from '../common/queue';
+type LocusDeltaDto = {
+    url: string;
+    baseSequence: {
+        rangeStart: number;
+        rangeEnd: number;
+        entries: number[];
+    };
+    sequence: {
+        rangeStart: number;
+        rangeEnd: number;
+        entries: number[];
+    };
+    syncUrl: string;
+};
 /**
  * Locus Delta Parser
  * @private
  * https://sqbu-github.cisco.com/WebExSquared/cloud-apps/wiki/Locus-Delta-Events
  */
 export default class Parser {
-    static status: {
-        IDLE: string;
-        PAUSED: string;
-        WORKING: string;
-    };
+    status: 'IDLE' | 'PAUSED' | 'WORKING' | 'BLOCKED';
     static loci: {
         EQ: string;
         GT: string;
@@ -16,14 +27,24 @@ export default class Parser {
         DESYNC: string;
         USE_INCOMING: string;
         USE_CURRENT: string;
+        WAIT: string;
         ERROR: string;
+        LOCUS_URL_CHANGED: string;
     };
-    queue: any;
+    queue: SortedQueue<LocusDeltaDto>;
     workingCopy: any;
+    syncTimer?: ReturnType<typeof setTimeout>;
     /**
      * @constructs Parser
      */
     constructor();
+    /**
+     * Returns a debug string representing a locus delta - useful for logging
+     *
+     * @param {LocusDeltaDto} locus Locus delta
+     * @returns {string}
+     */
+    static locus2string(locus: LocusDeltaDto): string;
     /**
      * Checks if two sequences overlap in time,
      * the sequence with the higher minimum value is greater.
@@ -80,6 +101,21 @@ export default class Parser {
      * @returns {string} loci comparison state
      */
     private static compareDelta;
+    /**
+     * Compares Locus sequences - it should be called only for full Locus DTOs, not deltas
+     *
+     * @param {Types~Locus} current Current working copy
+     * @param {Types~Locus} incomingFullDto New Full Locus DTO
+     * @returns {string} either Parser.loci.USE_INCOMING or Parser.loci.USE_CURRENT
+     */
+    static compareFullDtoSequence(current: any, incomingFullDto: any): string;
+    /**
+     * Returns true if the incoming full locus DTO is newer than the current working copy
+     *
+     * @param {Types~Locus} incomingFullDto New Full Locus DTO
+     * @returns {string} either Parser.loci.USE_INCOMING or Parser.loci.USE_CURRENT
+     */
+    isNewFullLocus(incomingFullDto: any): boolean;
     /**
      * Compares Locus sequences
      * @param {Types~Locus} current Current working copy
@@ -190,6 +226,29 @@ export default class Parser {
      * @returns {undefined}
      */
     pause(): void;
+    /**
+     * Triggers a sync with Locus
+     *
+     * @param {string} reason used just for logging
+     * @returns {undefined}
+     */
+    private triggerSync;
+    /**
+     * Starts a timer with a random delay. When that timer expires we will do a sync.
+     *
+     * The main purpose of this timer is to handle a case when we get some out-of-order deltas,
+     * so we start waiting to receive the missing delta. If that delta never arrives, this timer
+     * will trigger a sync with Locus.
+     *
+     * @returns {undefined}
+     */
+    private startSyncTimer;
+    /**
+     * Stops the timer for triggering a sync
+     *
+     * @returns {undefined}
+     */
+    private stopSyncTimer;
     /**
      * Processes next locus delta in the queue,
      * continues until the queue is empty
@@ -210,3 +269,4 @@ export default class Parser {
      */
     static getDebugMessage(debugCode: string, comparison: string): any;
 }
+export {};

package/dist/types/media/index.d.ts

@@ -1,6 +1,8 @@
 /*!
  * Copyright (c) 2015-2020 Cisco Systems, Inc. See LICENSE file.
  */
+import { type MultistreamConnectionConfig } from '@webex/internal-media-core';
+export type BundlePolicy = MultistreamConnectionConfig['bundlePolicy'];
 /**
  * MediaDirection
  * @typedef {Object} MediaDirection

package/dist/types/media/properties.d.ts

@@ -1,25 +1,34 @@
+import { LocalCameraStream, LocalMicrophoneStream, LocalDisplayStream, LocalSystemAudioStream, RemoteStream } from '@webex/media-helpers';
+export type MediaDirection = {
+    sendAudio: boolean;
+    sendVideo: boolean;
+    sendShare: boolean;
+    receiveAudio: boolean;
+    receiveVideo: boolean;
+    receiveShare: boolean;
+};
 /**
  * @class MediaProperties
  */
 export default class MediaProperties {
-    audioTrack: any;
-    localQualityLevel: any;
-    mediaDirection: any;
+    audioStream?: LocalMicrophoneStream;
+    mediaDirection: MediaDirection;
     mediaSettings: any;
     webrtcMediaConnection: any;
-    remoteAudioTrack: any;
+    remoteAudioStream: RemoteStream;
     remoteQualityLevel: any;
-    remoteShare: any;
-    remoteVideoTrack: any;
-    shareTrack: any;
+    remoteShareStream: RemoteStream;
+    remoteVideoStream: RemoteStream;
+    shareVideoStream?: LocalDisplayStream;
+    shareAudioStream?: LocalSystemAudioStream;
     videoDeviceId: any;
-    videoTrack: any;
+    videoStream?: LocalCameraStream;
     namespace: string;
     /**
      * @param {Object} [options] -- to auto construct
      * @returns {MediaProperties}
      */
-    constructor(options?: any);
+    constructor();
     /**
      * Retrieves the preferred video input device
      * @returns {Object|null}
@@ -28,24 +37,24 @@ export default class MediaProperties {
     setMediaDirection(mediaDirection: any): void;
     setMediaSettings(type: any, values: any): void;
     setMediaPeerConnection(mediaPeerConnection: any): void;
-    setLocalVideoTrack(videoTrack: any): void;
-    setLocalAudioTrack(audioTrack: any): void;
-    setLocalQualityLevel(localQualityLevel: any): void;
-    setLocalShareTrack(shareTrack: any): void;
+    setLocalVideoStream(videoStream?: LocalCameraStream): void;
+    setLocalAudioStream(audioStream?: LocalMicrophoneStream): void;
+    setLocalShareVideoStream(shareVideoStream?: LocalDisplayStream): void;
+    setLocalShareAudioStream(shareAudioStream?: LocalSystemAudioStream): void;
     setRemoteQualityLevel(remoteQualityLevel: any): void;
-    setRemoteShare(remoteShare: any): void;
+    setRemoteShareStream(remoteShareStream: RemoteStream): void;
     /**
-     * Sets the remote audio track
-     * @param {MediaTrack} remoteAudioTrack MediaTrack to save
+     * Sets the remote audio stream
+     * @param {RemoteStream} remoteAudioStream RemoteStream to save
      * @returns {void}
      */
-    setRemoteAudioTrack(remoteAudioTrack: any): void;
+    setRemoteAudioStream(remoteAudioStream: RemoteStream): void;
     /**
-     * Sets the remote video track
-     * @param {MediaTrack} remoteVideoTrack MediaTrack to save
+     * Sets the remote video stream
+     * @param {RemoteStream} remoteVideoStream RemoteStream to save
      * @returns {void}
      */
-    setRemoteVideoTrack(remoteVideoTrack: any): void;
+    setRemoteVideoStream(remoteVideoStream: RemoteStream): void;
     /**
      * Stores the preferred video input device
      * @param {string} deviceId Preferred video input device
@@ -53,45 +62,22 @@ export default class MediaProperties {
      */
     setVideoDeviceId(deviceId: string): void;
     unsetPeerConnection(): void;
-    unsetLocalVideoTrack(): void;
-    unsetLocalShareTrack(): void;
-    unsetLocalAudioTrack(): void;
-    /**
-     * Removes remote stream from class instance
-     * @deprecated after v1.89.3
-     * @returns {void}
-     */
-    unsetRemoteStream(): void;
     /**
      * Removes both remote audio and video from class instance
      * @returns {void}
      */
     unsetRemoteMedia(): void;
-    unsetRemoteShare(): void;
-    unsetLocalVideoTracks(): void;
+    unsetRemoteShareStream(): void;
     /**
-     * Removes remote stream and remote share from class instance
-     * @deprecated after v1.89.3
+     * Unsets all remote streams
      * @returns {void}
      */
     unsetRemoteStreams(): void;
     /**
-     * Unsets all remote tracks
-     * @returns {void}
-     */
-    unsetRemoteTracks(): void;
-    unsetShareStreams(): void;
-    /**
-     * Removes both local and remote video stream from class instance
-     * @deprecated after v1.89.3
-     * @returns {void}
-     */
-    unsetMediaStreams(): void;
-    /**
-     * Removes both local and remote video stream from class instance
-     * @returns {void}
+     * Returns if we have at least one local share stream or not.
+     * @returns {Boolean}
      */
-    unsetMediaTracks(): void;
+    hasLocalShareStream(): boolean;
     /**
      * Waits for the webrtc media connection to be connected.
      *

package/dist/types/mediaQualityMetrics/config.d.ts

@@ -235,131 +235,3 @@ export declare const emptyVideoTransmit: {
         transmittedWidth: number;
     }[];
 };
-export declare const emptyVideoShareReceive: {
-    common: {
-        common: {
-            direction: string;
-            isMain: boolean;
-            mariFecEnabled: boolean;
-            mariQosEnabled: boolean;
-            multistreamEnabled: boolean;
-        };
-        dtlsBitrate: number;
-        dtlsPackets: number;
-        fecBitrate: number;
-        fecPackets: number;
-        maxBitrate: number;
-        mediaHopByHopLost: number;
-        rtcpBitrate: number;
-        rtcpPackets: number;
-        rtpBitrate: number;
-        rtpHopByHopLost: number;
-        rtpPackets: number;
-        rtpRecovered: number;
-        rtxBitrate: number;
-        rtxPackets: number;
-        srtcpUnprotectErrors: number;
-        srtpUnprotectErrors: number;
-        stunBitrate: number;
-        stunPackets: number;
-        transportType: string;
-    };
-    streams: {
-        common: {
-            codec: string;
-            concealedFrames: number;
-            csi: any[];
-            maxConcealRunLength: number;
-            optimalBitrate: number;
-            optimalFrameRate: number;
-            receivedBitrate: number;
-            receivedFrameRate: number;
-            renderedFrameRate: number;
-            requestedBitrate: number;
-            requestedFrameRate: number;
-            rtpEndToEndLost: number;
-            rtpJitter: number;
-            rtpPackets: number;
-            ssci: number;
-        };
-        h264CodecProfile: string;
-        isActiveSpeaker: boolean;
-        optimalFrameSize: number;
-        receivedFrameSize: number;
-        receivedHeight: number;
-        receivedKeyFrames: number;
-        receivedKeyFramesForRequest: number;
-        receivedKeyFramesSourceChange: number;
-        receivedKeyFramesUnknown: number;
-        receivedWidth: number;
-        requestedFrameSize: number;
-        requestedKeyFrames: number;
-    }[];
-};
-export declare const emptyVideoShareTransmit: {
-    common: {
-        availableBitrate: number;
-        common: {
-            direction: string;
-            isMain: boolean;
-            mariFecEnabled: boolean;
-            mariQosEnabled: boolean;
-            multistreamEnabled: boolean;
-        };
-        dtlsBitrate: number;
-        dtlsPackets: number;
-        fecBitrate: number;
-        fecPackets: number;
-        maxBitrate: number;
-        queueDelay: number;
-        remoteJitter: number;
-        remoteLossRate: number;
-        remoteReceiveRate: number;
-        roundTripTime: number;
-        rtcpBitrate: number;
-        rtcpPackets: number;
-        rtpBitrate: number;
-        rtpPackets: number;
-        rtxBitrate: number;
-        rtxPackets: number;
-        stunBitrate: number;
-        stunPackets: number;
-        transportType: string;
-    };
-    streams: {
-        common: {
-            codec: string;
-            csi: any[];
-            duplicateSsci: number;
-            requestedBitrate: number;
-            requestedFrames: number;
-            rtpPackets: number;
-            ssci: number;
-            transmittedBitrate: number;
-            transmittedFrameRate: number;
-        };
-        h264CodecProfile: string;
-        isAvatar: boolean;
-        isHardwareEncoded: boolean;
-        localConfigurationChanges: number;
-        maxFrameQp: number;
-        maxNoiseLevel: number;
-        minRegionQp: number;
-        remoteConfigurationChanges: number;
-        requestedFrameSize: number;
-        requestedKeyFrames: number;
-        transmittedFrameSize: number;
-        transmittedHeight: number;
-        transmittedKeyFrames: number;
-        transmittedKeyFramesClient: number;
-        transmittedKeyFramesConfigurationChange: number;
-        transmittedKeyFramesFeedback: number;
-        transmittedKeyFramesLocalDrop: number;
-        transmittedKeyFramesOtherLayer: number;
-        transmittedKeyFramesPeriodic: number;
-        transmittedKeyFramesSceneChange: number;
-        transmittedKeyFramesStartup: number;
-        transmittedKeyFramesUnknown: number;
-        transmittedWidth: number;
-    }[];
-};

package/dist/types/meeting/in-meeting-actions.d.ts

@@ -14,7 +14,11 @@ interface IInMeetingActions {
     canUnsetMuteOnEntry?: boolean;
     canSetDisallowUnmute?: boolean;
     canUnsetDisallowUnmute?: boolean;
+    canSetMuted?: boolean;
+    canUnsetMuted?: boolean;
     canAssignHost?: boolean;
+    canSetPresenter?: boolean;
+    canUnsetPresenter?: boolean;
     canStartRecording?: boolean;
     canPauseRecording?: boolean;
     canResumeRecording?: boolean;
@@ -27,13 +31,51 @@ interface IInMeetingActions {
     canStartTranscribing?: boolean;
     canStopTranscribing?: boolean;
     isClosedCaptionActive?: boolean;
+    isSaveTranscriptsEnabled?: boolean;
     isWebexAssistantActive?: boolean;
     canViewCaptionPanel?: boolean;
     isRealTimeTranslationEnabled?: boolean;
     canSelectSpokenLanguages?: boolean;
     waitingForOthersToJoin?: boolean;
-    canEnableReactions?: boolean;
     canSendReactions?: boolean;
+    canManageBreakout?: boolean;
+    canBroadcastMessageToBreakout?: boolean;
+    canAdmitLobbyToBreakout?: boolean;
+    isBreakoutPreassignmentsEnabled?: boolean;
+    canUserAskForHelp?: boolean;
+    canUserRenameSelfAndObserved?: boolean;
+    canUserRenameOthers?: boolean;
+    canMuteAll?: boolean;
+    canUnmuteAll?: boolean;
+    canEnableHardMute?: boolean;
+    canDisableHardMute?: boolean;
+    canEnableMuteOnEntry?: boolean;
+    canDisableMuteOnEntry?: boolean;
+    canEnableReactions?: boolean;
+    canDisableReactions?: boolean;
+    canEnableReactionDisplayNames?: boolean;
+    canDisableReactionDisplayNames?: boolean;
+    canUpdateShareControl?: boolean;
+    canEnableViewTheParticipantsList?: boolean;
+    canDisableViewTheParticipantsList?: boolean;
+    canEnableRaiseHand?: boolean;
+    canDisableRaiseHand?: boolean;
+    canEnableVideo?: boolean;
+    canDisableVideo?: boolean;
+    canShareFile?: boolean;
+    canShareApplication?: boolean;
+    canShareCamera?: boolean;
+    canShareDesktop?: boolean;
+    canShareContent?: boolean;
+    canTransferFile?: boolean;
+    canChat?: boolean;
+    canDoVideo?: boolean;
+    canAnnotate?: boolean;
+    canUseVoip?: boolean;
+    supportHQV?: boolean;
+    supportHDV?: boolean;
+    canShareWhiteBoard?: boolean;
+    enforceVirtualBackground?: boolean;
 }
 /**
  * @class InMeetingActions
@@ -50,9 +92,13 @@ export default class InMeetingActions implements IInMeetingActions {
     canResumeRecording: any;
     canStopRecording: any;
     canSetMuteOnEntry: any;
+    canSetPresenter: any;
+    canUnsetPresenter: any;
     canUnsetMuteOnEntry: any;
     canSetDisallowUnmute: any;
     canUnsetDisallowUnmute: any;
+    canSetMuted: any;
+    canUnsetMuted: any;
     canRaiseHand: any;
     canLowerAllHands: any;
     canLowerSomeoneElsesHand: any;
@@ -61,13 +107,51 @@ export default class InMeetingActions implements IInMeetingActions {
     canStartTranscribing: any;
     canStopTranscribing: any;
     isClosedCaptionActive: any;
+    isSaveTranscriptsEnabled: any;
     isWebexAssistantActive: any;
     canViewCaptionPanel: any;
     isRealTimeTranslationEnabled: any;
     canSelectSpokenLanguages: any;
     waitingForOthersToJoin: any;
-    canEnableReactions: any;
     canSendReactions: any;
+    canManageBreakout: any;
+    canBroadcastMessageToBreakout: any;
+    canAdmitLobbyToBreakout: any;
+    isBreakoutPreassignmentsEnabled: any;
+    canUserAskForHelp: any;
+    canUserRenameSelfAndObserved: any;
+    canUserRenameOthers: any;
+    canMuteAll: any;
+    canUnmuteAll: any;
+    canEnableHardMute: any;
+    canDisableHardMute: any;
+    canEnableMuteOnEntry: any;
+    canDisableMuteOnEntry: any;
+    canEnableReactions: any;
+    canDisableReactions: any;
+    canEnableReactionDisplayNames: any;
+    canDisableReactionDisplayNames: any;
+    canUpdateShareControl: any;
+    canEnableViewTheParticipantsList: any;
+    canDisableViewTheParticipantsList: any;
+    canEnableRaiseHand: any;
+    canDisableRaiseHand: any;
+    canEnableVideo: any;
+    canDisableVideo: any;
+    canShareFile: any;
+    canShareApplication: any;
+    canShareCamera: any;
+    canShareDesktop: any;
+    canShareContent: any;
+    canTransferFile: any;
+    canChat: any;
+    canDoVideo: any;
+    canAnnotate: any;
+    canUseVoip: any;
+    supportHQV: any;
+    enforceVirtualBackground: any;
+    supportHDV: any;
+    canShareWhiteBoard: any;
     /**
      * Returns all meeting action options
      * @returns {Object}