@webex/media-helpers 3.0.0-next.1 → 3.0.0-next.11

package/README.md

@@ -31,20 +31,16 @@ Noise reduction (e.g., background noise removal)
 The virtual background effect provides a virtual background for video calling. The virtual background may be an image, an mp4 video, or the user's background with blur applied.
 
 **Applying the effect**
-1. Create a new camera track instance by using LocalCameraTrack() method.
+1. Create a new camera stream instance by using createCameraStream() method.
 2. Create a VirtualBackgroundEffect instance by passing appropriate constraints.
-3. Use addEffect() method on cameraTrack to apply effect on it.
-4. Enable the effect after adding it to cameraTrack using enable() method available on effect. Effect will be enabled on cameraTrack.
+3. Use addEffect() method on cameraStream to apply effect on it.
+4. Enable the effect after adding it to cameraStream using enable() method available on effect. Effect will be enabled on cameraStream.
 
 ```javascript
-import {LocalCameraTrack, VirtualBackgroundEffect} from '@webex/media-helpers';
+import {createCameraStream, VirtualBackgroundEffect} from '@webex/media-helpers';
 
-// Create a new video stream by a getting user's video media.
-const stream = await navigator.mediaDevices.getUserMedia({ video: { width, height } });
-
-const videoTrackFromLocalStream = stream.getVideoTracks()[0];
-
-const cameraTrack = new LocalCameraTrack(new MediaStream([videoTrackFromLocalStream]));
+// Create a new video stream.
+const cameraStream = createCameraStream(optionalVideoConstraints);
 
 // Create the effect.
 const effect = new VirtualBackgroundEffect({
@@ -54,10 +50,10 @@ const effect = new VirtualBackgroundEffect({
   quality: `LOW`,
 });
 
-// add the effect on the input camera track.
-await cameraTrack.addEffect("background-blur", effect);
+// add the effect on the input camera stream.
+await cameraStream.addEffect("background-blur", effect);
 
-//enable the effect once it is added to the track
+//enable the effect once it is added to the stream
 await effect.enable()
 ```
 
@@ -65,20 +61,16 @@ await effect.enable()
 The noise reduction effect removes background noise from an audio stream to provide clear audio for calling.
 
 **Applying the effect**
-1. Create a new microphone track instance by using LocalMicrophoneTrack() method.
+1. Create a new microphone stream instance by using createMicrophoneStream() method.
 2. Create a NoiseReductionEffect instance by passing appropriate constraints.
-3. Use addEffect() method on microphoneTrack to apply effect on it.
-4. Enable the effect after adding it to microphoneTrack using enable() method available on effect. Effect will be enabled on microphoneTrack.
+3. Use addEffect() method on microphoneStream to apply effect on it.
+4. Enable the effect after adding it to microphoneStream using enable() method available on effect. Effect will be enabled on microphoneStream.
 
 ```javascript
-import {LocalMicrophoneTrack, NoiseReductionEffect} from '@webex/media-helpers';
-
-// Create a new audio stream by getting a user's audio media.
-const stream = await navigator.mediaDevices.getUserMedia({ audio: true });
-
-const audioTrackFromLocalStream = stream.getAudioTracks()[0];
+import {createMicrophoneStream, NoiseReductionEffect} from '@webex/media-helpers';
 
-const microphoneTrack = new LocalMicrophoneTrack(new MediaStream([audioTrackFromLocalStream]));
+// Create a new audio stream.
+const microphoneStream = createMicrophoneStream(optionalAudioConstraints);
 
 // Create the effect.
 const effect = new NoiseReductionEffect({
@@ -86,8 +78,8 @@ const effect = new NoiseReductionEffect({
   mode: 'WORKLET', // or 'LEGACY'
 });
 
-// add the effect on microphone track.
-await microphoneTrack.addEffect("background-noise-removal", effect);
+// add the effect on microphone stream.
+await microphoneStream.addEffect("background-noise-removal", effect);
 
 //enable the effect once it is added to the track
 await effect.enable()

package/dist/constants.js

@@ -1,24 +1,21 @@
 "use strict";
 
-var _Object$defineProperty = require("@babel/runtime-corejs2/core-js/object/define-property");
-_Object$defineProperty(exports, "__esModule", {
+Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.PresetCameraConstraints = exports.FacingMode = exports.DisplaySurface = void 0;
-var FacingMode; // can be used later on when we add constraints in create display track
-exports.FacingMode = FacingMode;
-(function (FacingMode) {
+let FacingMode = exports.FacingMode = /*#__PURE__*/function (FacingMode) {
   FacingMode["user"] = "user";
   FacingMode["environment"] = "environment";
-})(FacingMode || (exports.FacingMode = FacingMode = {}));
-var DisplaySurface;
-exports.DisplaySurface = DisplaySurface;
-(function (DisplaySurface) {
+  return FacingMode;
+}({}); // can be used later on when we add constraints in create display track
+let DisplaySurface = exports.DisplaySurface = /*#__PURE__*/function (DisplaySurface) {
   DisplaySurface["browser"] = "browser";
   DisplaySurface["monitor"] = "monitor";
   DisplaySurface["window"] = "window";
-})(DisplaySurface || (exports.DisplaySurface = DisplaySurface = {}));
-var PresetCameraConstraints = {
+  return DisplaySurface;
+}({});
+const PresetCameraConstraints = exports.PresetCameraConstraints = {
   '1080p': {
     frameRate: 30,
     width: 1920,
@@ -55,5 +52,4 @@ var PresetCameraConstraints = {
     height: 120
   }
 };
-exports.PresetCameraConstraints = PresetCameraConstraints;
 //# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -1 +1 @@
-{"version":3,"names":["FacingMode","exports","DisplaySurface","PresetCameraConstraints","frameRate","width","height"],"sources":["constants.ts"],"sourcesContent":["import {VideoDeviceConstraints} from '@webex/internal-media-core';\n\nexport enum FacingMode {\n  user = 'user',\n  environment = 'environment',\n}\n\n// can be used later on when we add constraints in create display track\nexport enum DisplaySurface {\n  browser = 'browser',\n  monitor = 'monitor',\n  window = 'window',\n}\n\nexport const PresetCameraConstraints: {[key: string]: VideoDeviceConstraints} = {\n  '1080p': {frameRate: 30, width: 1920, height: 1080},\n\n  '720p': {frameRate: 30, width: 1280, height: 720},\n\n  '480p': {frameRate: 30, width: 640, height: 480},\n\n  '360p': {frameRate: 30, width: 640, height: 360},\n\n  '240p': {frameRate: 30, width: 320, height: 240},\n\n  '180p': {frameRate: 30, width: 320, height: 180},\n\n  '120p': {frameRate: 30, width: 160, height: 120},\n};\n"],"mappings":";;;;;;;IAEYA,UAAU,EAKtB;AAAAC,OAAA,CAAAD,UAAA,GAAAA,UAAA;AAAA,WALYA,UAAU;EAAVA,UAAU;EAAVA,UAAU;AAAA,GAAVA,UAAU,KAAAC,OAAA,CAAAD,UAAA,GAAVA,UAAU;AAAA,IAMVE,cAAc;AAAAD,OAAA,CAAAC,cAAA,GAAAA,cAAA;AAAA,WAAdA,cAAc;EAAdA,cAAc;EAAdA,cAAc;EAAdA,cAAc;AAAA,GAAdA,cAAc,KAAAD,OAAA,CAAAC,cAAA,GAAdA,cAAc;AAMnB,IAAMC,uBAAgE,GAAG;EAC9E,OAAO,EAAE;IAACC,SAAS,EAAE,EAAE;IAAEC,KAAK,EAAE,IAAI;IAAEC,MAAM,EAAE;EAAI,CAAC;EAEnD,MAAM,EAAE;IAACF,SAAS,EAAE,EAAE;IAAEC,KAAK,EAAE,IAAI;IAAEC,MAAM,EAAE;EAAG,CAAC;EAEjD,MAAM,EAAE;IAACF,SAAS,EAAE,EAAE;IAAEC,KAAK,EAAE,GAAG;IAAEC,MAAM,EAAE;EAAG,CAAC;EAEhD,MAAM,EAAE;IAACF,SAAS,EAAE,EAAE;IAAEC,KAAK,EAAE,GAAG;IAAEC,MAAM,EAAE;EAAG,CAAC;EAEhD,MAAM,EAAE;IAACF,SAAS,EAAE,EAAE;IAAEC,KAAK,EAAE,GAAG;IAAEC,MAAM,EAAE;EAAG,CAAC;EAEhD,MAAM,EAAE;IAACF,SAAS,EAAE,EAAE;IAAEC,KAAK,EAAE,GAAG;IAAEC,MAAM,EAAE;EAAG,CAAC;EAEhD,MAAM,EAAE;IAACF,SAAS,EAAE,EAAE;IAAEC,KAAK,EAAE,GAAG;IAAEC,MAAM,EAAE;EAAG;AACjD,CAAC;AAACL,OAAA,CAAAE,uBAAA,GAAAA,uBAAA"}
+null

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-export { getDevices, LocalStream, LocalDisplayStream, LocalSystemAudioStream, LocalStreamEventNames, StreamEventNames, type ServerMuteReason, LocalMicrophoneStreamEventNames, LocalCameraStreamEventNames, LocalMicrophoneStream, LocalCameraStream, createMicrophoneStream, createCameraStream, createDisplayStream, createDisplayStreamWithAudio, } from './webrtc-core';
+export { getDevices, LocalStream, LocalDisplayStream, LocalSystemAudioStream, LocalStreamEventNames, StreamEventNames, RemoteStream, type ServerMuteReason, LocalMicrophoneStreamEventNames, LocalCameraStreamEventNames, LocalMicrophoneStream, LocalCameraStream, createMicrophoneStream, createCameraStream, createDisplayStream, createDisplayStreamWithAudio, type VideoContentHint, } from './webrtc-core';
 export { NoiseReductionEffect, VirtualBackgroundEffect } from '@webex/web-media-effects';
 export type { NoiseReductionEffectOptions, VirtualBackgroundEffectOptions, } from '@webex/web-media-effects';
 export { FacingMode, DisplaySurface, PresetCameraConstraints } from './constants';

package/dist/index.js

@@ -1,120 +1,125 @@
 "use strict";
 
-var _Object$defineProperty = require("@babel/runtime-corejs2/core-js/object/define-property");
-_Object$defineProperty(exports, "__esModule", {
+Object.defineProperty(exports, "__esModule", {
   value: true
 });
-_Object$defineProperty(exports, "DisplaySurface", {
+Object.defineProperty(exports, "DisplaySurface", {
   enumerable: true,
-  get: function get() {
+  get: function () {
     return _constants.DisplaySurface;
   }
 });
-_Object$defineProperty(exports, "FacingMode", {
+Object.defineProperty(exports, "FacingMode", {
   enumerable: true,
-  get: function get() {
+  get: function () {
     return _constants.FacingMode;
   }
 });
-_Object$defineProperty(exports, "LocalCameraStream", {
+Object.defineProperty(exports, "LocalCameraStream", {
   enumerable: true,
-  get: function get() {
+  get: function () {
     return _webrtcCore.LocalCameraStream;
   }
 });
-_Object$defineProperty(exports, "LocalCameraStreamEventNames", {
+Object.defineProperty(exports, "LocalCameraStreamEventNames", {
   enumerable: true,
-  get: function get() {
+  get: function () {
     return _webrtcCore.LocalCameraStreamEventNames;
   }
 });
-_Object$defineProperty(exports, "LocalDisplayStream", {
+Object.defineProperty(exports, "LocalDisplayStream", {
   enumerable: true,
-  get: function get() {
+  get: function () {
     return _webrtcCore.LocalDisplayStream;
   }
 });
-_Object$defineProperty(exports, "LocalMicrophoneStream", {
+Object.defineProperty(exports, "LocalMicrophoneStream", {
   enumerable: true,
-  get: function get() {
+  get: function () {
     return _webrtcCore.LocalMicrophoneStream;
   }
 });
-_Object$defineProperty(exports, "LocalMicrophoneStreamEventNames", {
+Object.defineProperty(exports, "LocalMicrophoneStreamEventNames", {
   enumerable: true,
-  get: function get() {
+  get: function () {
     return _webrtcCore.LocalMicrophoneStreamEventNames;
   }
 });
-_Object$defineProperty(exports, "LocalStream", {
+Object.defineProperty(exports, "LocalStream", {
   enumerable: true,
-  get: function get() {
+  get: function () {
     return _webrtcCore.LocalStream;
   }
 });
-_Object$defineProperty(exports, "LocalStreamEventNames", {
+Object.defineProperty(exports, "LocalStreamEventNames", {
   enumerable: true,
-  get: function get() {
+  get: function () {
     return _webrtcCore.LocalStreamEventNames;
   }
 });
-_Object$defineProperty(exports, "LocalSystemAudioStream", {
+Object.defineProperty(exports, "LocalSystemAudioStream", {
   enumerable: true,
-  get: function get() {
+  get: function () {
     return _webrtcCore.LocalSystemAudioStream;
   }
 });
-_Object$defineProperty(exports, "NoiseReductionEffect", {
+Object.defineProperty(exports, "NoiseReductionEffect", {
   enumerable: true,
-  get: function get() {
+  get: function () {
     return _webMediaEffects.NoiseReductionEffect;
   }
 });
-_Object$defineProperty(exports, "PresetCameraConstraints", {
+Object.defineProperty(exports, "PresetCameraConstraints", {
   enumerable: true,
-  get: function get() {
+  get: function () {
     return _constants.PresetCameraConstraints;
   }
 });
-_Object$defineProperty(exports, "StreamEventNames", {
+Object.defineProperty(exports, "RemoteStream", {
   enumerable: true,
-  get: function get() {
+  get: function () {
+    return _webrtcCore.RemoteStream;
+  }
+});
+Object.defineProperty(exports, "StreamEventNames", {
+  enumerable: true,
+  get: function () {
     return _webrtcCore.StreamEventNames;
   }
 });
-_Object$defineProperty(exports, "VirtualBackgroundEffect", {
+Object.defineProperty(exports, "VirtualBackgroundEffect", {
   enumerable: true,
-  get: function get() {
+  get: function () {
     return _webMediaEffects.VirtualBackgroundEffect;
   }
 });
-_Object$defineProperty(exports, "createCameraStream", {
+Object.defineProperty(exports, "createCameraStream", {
   enumerable: true,
-  get: function get() {
+  get: function () {
     return _webrtcCore.createCameraStream;
   }
 });
-_Object$defineProperty(exports, "createDisplayStream", {
+Object.defineProperty(exports, "createDisplayStream", {
   enumerable: true,
-  get: function get() {
+  get: function () {
     return _webrtcCore.createDisplayStream;
   }
 });
-_Object$defineProperty(exports, "createDisplayStreamWithAudio", {
+Object.defineProperty(exports, "createDisplayStreamWithAudio", {
   enumerable: true,
-  get: function get() {
+  get: function () {
     return _webrtcCore.createDisplayStreamWithAudio;
   }
 });
-_Object$defineProperty(exports, "createMicrophoneStream", {
+Object.defineProperty(exports, "createMicrophoneStream", {
   enumerable: true,
-  get: function get() {
+  get: function () {
     return _webrtcCore.createMicrophoneStream;
   }
 });
-_Object$defineProperty(exports, "getDevices", {
+Object.defineProperty(exports, "getDevices", {
   enumerable: true,
-  get: function get() {
+  get: function () {
     return _webrtcCore.getDevices;
   }
 });

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"names":["_webrtcCore","require","_webMediaEffects","_constants"],"sources":["index.ts"],"sourcesContent":["export {\n  getDevices,\n  LocalStream,\n  LocalDisplayStream,\n  LocalSystemAudioStream,\n  LocalStreamEventNames,\n  StreamEventNames,\n  type ServerMuteReason,\n  LocalMicrophoneStreamEventNames,\n  LocalCameraStreamEventNames,\n  LocalMicrophoneStream,\n  LocalCameraStream,\n  createMicrophoneStream,\n  createCameraStream,\n  createDisplayStream,\n  createDisplayStreamWithAudio,\n} from './webrtc-core';\n\nexport {NoiseReductionEffect, VirtualBackgroundEffect} from '@webex/web-media-effects';\nexport type {\n  NoiseReductionEffectOptions,\n  VirtualBackgroundEffectOptions,\n} from '@webex/web-media-effects';\n\nexport {FacingMode, DisplaySurface, PresetCameraConstraints} from './constants';\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,IAAAA,WAAA,GAAAC,OAAA;AAkBA,IAAAC,gBAAA,GAAAD,OAAA;AAMA,IAAAE,UAAA,GAAAF,OAAA"}
+null

package/dist/webrtc-core.d.ts

@@ -1,6 +1,6 @@
 import { AudioDeviceConstraints, LocalDisplayStream, LocalSystemAudioStream, LocalMicrophoneStream as WcmeLocalMicrophoneStream, LocalCameraStream as WcmeLocalCameraStream, VideoDeviceConstraints } from '@webex/internal-media-core';
-import { TypedEvent } from '@webex/ts-events';
-export { getDevices, LocalStream, LocalDisplayStream, LocalSystemAudioStream, LocalStreamEventNames, StreamEventNames, RemoteStream, } from '@webex/internal-media-core';
+import { TypedEvent, WithEventsDummyType } from '@webex/ts-events';
+export { getDevices, LocalStream, LocalDisplayStream, LocalSystemAudioStream, LocalStreamEventNames, StreamEventNames, RemoteStream, type VideoContentHint, } from '@webex/internal-media-core';
 export type ServerMuteReason = 'remotelyMuted' | 'clientRequestFailed' | 'localUnmuteRequired';
 export declare enum LocalMicrophoneStreamEventNames {
     ServerMuted = "muted:byServer"
@@ -8,41 +8,65 @@ export declare enum LocalMicrophoneStreamEventNames {
 export declare enum LocalCameraStreamEventNames {
     ServerMuted = "muted:byServer"
 }
-export declare class LocalMicrophoneStream extends WcmeLocalMicrophoneStream {
+interface LocalMicrophoneStreamEvents {
+    [LocalMicrophoneStreamEventNames.ServerMuted]: TypedEvent<(muted: boolean, reason: ServerMuteReason) => void>;
+}
+interface LocalCameraStreamEvents {
+    [LocalMicrophoneStreamEventNames.ServerMuted]: TypedEvent<(muted: boolean, reason: ServerMuteReason) => void>;
+}
+declare class _LocalMicrophoneStream extends WcmeLocalMicrophoneStream {
     private unmuteAllowed;
     [LocalMicrophoneStreamEventNames.ServerMuted]: TypedEvent<(muted: boolean, reason: ServerMuteReason) => void>;
     /**
-     * @internal
-     */
-    setUnmuteAllowed(allowed: any): void;
-    /**
-     * @returns true if user is allowed to unmute the Stream, false otherwise
+     * @returns true if user is allowed to unmute the track, false otherwise
      */
     isUnmuteAllowed(): boolean;
     setMuted(muted: boolean): void;
-    /**
-     * @internal
-     */
-    setServerMuted(muted: boolean, reason: ServerMuteReason): void;
+    toJSON(): {
+        id: string;
+        enabled: boolean;
+        label: string;
+        readyState: string;
+        numEnabledEffects: number;
+    };
 }
-export declare class LocalCameraStream extends WcmeLocalCameraStream {
+declare class _LocalCameraStream extends WcmeLocalCameraStream {
     private unmuteAllowed;
     [LocalCameraStreamEventNames.ServerMuted]: TypedEvent<(muted: boolean, reason: ServerMuteReason) => void>;
     /**
-     * @internal
-     */
-    setUnmuteAllowed(allowed: any): void;
-    /**
-     * @returns true if user is allowed to unmute the Stream, false otherwise
+     * @returns true if user is allowed to unmute the track, false otherwise
      */
     isUnmuteAllowed(): boolean;
     setMuted(muted: boolean): void;
-    /**
-     * @internal
-     */
-    setServerMuted(muted: boolean, reason: ServerMuteReason): void;
+    toJSON(): {
+        id: string;
+        enabled: boolean;
+        label: string;
+        readyState: string;
+        numEnabledEffects: number;
+    };
 }
-export declare const createMicrophoneStream: (constraints?: AudioDeviceConstraints) => Promise<LocalMicrophoneStream>;
-export declare const createCameraStream: (constraints?: VideoDeviceConstraints) => Promise<LocalCameraStream>;
+export declare const createMicrophoneStream: (constraints?: AudioDeviceConstraints) => Promise<{
+    on<K extends LocalMicrophoneStreamEventNames.ServerMuted, E extends LocalMicrophoneStreamEvents[K] extends infer T ? T extends LocalMicrophoneStreamEvents[K] ? T extends TypedEvent<infer X extends (...args: any[]) => void> ? X : never : never : never>(eventName: K, handler: E): void;
+    once<K_1 extends LocalMicrophoneStreamEventNames.ServerMuted, E_1 extends LocalMicrophoneStreamEvents[K_1] extends infer T_1 ? T_1 extends LocalMicrophoneStreamEvents[K_1] ? T_1 extends TypedEvent<infer X extends (...args: any[]) => void> ? X : never : never : never>(eventName: K_1, handler: E_1): void;
+    off<K_2 extends LocalMicrophoneStreamEventNames.ServerMuted, E_2 extends LocalMicrophoneStreamEvents[K_2] extends infer T_2 ? T_2 extends LocalMicrophoneStreamEvents[K_2] ? T_2 extends TypedEvent<infer X extends (...args: any[]) => void> ? X : never : never : never>(eventName: K_2, handler: E_2): void;
+} & _LocalMicrophoneStream>;
+export declare const createCameraStream: (constraints?: VideoDeviceConstraints) => Promise<{
+    on<K extends LocalMicrophoneStreamEventNames.ServerMuted, E extends LocalCameraStreamEvents[K] extends infer T ? T extends LocalCameraStreamEvents[K] ? T extends TypedEvent<infer X extends (...args: any[]) => void> ? X : never : never : never>(eventName: K, handler: E): void;
+    once<K_1 extends LocalMicrophoneStreamEventNames.ServerMuted, E_1 extends LocalCameraStreamEvents[K_1] extends infer T_1 ? T_1 extends LocalCameraStreamEvents[K_1] ? T_1 extends TypedEvent<infer X extends (...args: any[]) => void> ? X : never : never : never>(eventName: K_1, handler: E_1): void;
+    off<K_2 extends LocalMicrophoneStreamEventNames.ServerMuted, E_2 extends LocalCameraStreamEvents[K_2] extends infer T_2 ? T_2 extends LocalCameraStreamEvents[K_2] ? T_2 extends TypedEvent<infer X extends (...args: any[]) => void> ? X : never : never : never>(eventName: K_2, handler: E_2): void;
+} & _LocalCameraStream>;
 export declare const createDisplayStream: () => Promise<LocalDisplayStream>;
 export declare const createDisplayStreamWithAudio: () => Promise<[LocalDisplayStream, LocalSystemAudioStream]>;
+export declare const LocalMicrophoneStream: (new (...args: any[]) => {
+    on<K extends LocalMicrophoneStreamEventNames.ServerMuted, E extends LocalMicrophoneStreamEvents[K] extends infer T ? T extends LocalMicrophoneStreamEvents[K] ? T extends TypedEvent<infer X extends (...args: any[]) => void> ? X : never : never : never>(eventName: K, handler: E): void;
+    once<K_1 extends LocalMicrophoneStreamEventNames.ServerMuted, E_1 extends LocalMicrophoneStreamEvents[K_1] extends infer T_1 ? T_1 extends LocalMicrophoneStreamEvents[K_1] ? T_1 extends TypedEvent<infer X extends (...args: any[]) => void> ? X : never : never : never>(eventName: K_1, handler: E_1): void;
+    off<K_2 extends LocalMicrophoneStreamEventNames.ServerMuted, E_2 extends LocalMicrophoneStreamEvents[K_2] extends infer T_2 ? T_2 extends LocalMicrophoneStreamEvents[K_2] ? T_2 extends TypedEvent<infer X extends (...args: any[]) => void> ? X : never : never : never>(eventName: K_2, handler: E_2): void;
+}) & typeof _LocalMicrophoneStream;
+export type LocalMicrophoneStream = _LocalMicrophoneStream & WithEventsDummyType<LocalMicrophoneStreamEvents>;
+export declare const LocalCameraStream: (new (...args: any[]) => {
+    on<K extends LocalMicrophoneStreamEventNames.ServerMuted, E extends LocalCameraStreamEvents[K] extends infer T ? T extends LocalCameraStreamEvents[K] ? T extends TypedEvent<infer X extends (...args: any[]) => void> ? X : never : never : never>(eventName: K, handler: E): void;
+    once<K_1 extends LocalMicrophoneStreamEventNames.ServerMuted, E_1 extends LocalCameraStreamEvents[K_1] extends infer T_1 ? T_1 extends LocalCameraStreamEvents[K_1] ? T_1 extends TypedEvent<infer X extends (...args: any[]) => void> ? X : never : never : never>(eventName: K_1, handler: E_1): void;
+    off<K_2 extends LocalMicrophoneStreamEventNames.ServerMuted, E_2 extends LocalCameraStreamEvents[K_2] extends infer T_2 ? T_2 extends LocalCameraStreamEvents[K_2] ? T_2 extends TypedEvent<infer X extends (...args: any[]) => void> ? X : never : never : never>(eventName: K_2, handler: E_2): void;
+}) & typeof _LocalCameraStream;
+export type LocalCameraStream = _LocalCameraStream & WithEventsDummyType<LocalCameraStreamEvents>;

package/dist/webrtc-core.js

@@ -1,213 +1,166 @@
 "use strict";
 
-var _Reflect$construct = require("@babel/runtime-corejs2/core-js/reflect/construct");
-var _Object$defineProperty = require("@babel/runtime-corejs2/core-js/object/define-property");
-var _interopRequireDefault = require("@babel/runtime-corejs2/helpers/interopRequireDefault");
-_Object$defineProperty(exports, "__esModule", {
+Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.LocalCameraStreamEventNames = exports.LocalCameraStream = void 0;
-_Object$defineProperty(exports, "LocalDisplayStream", {
+Object.defineProperty(exports, "LocalDisplayStream", {
   enumerable: true,
-  get: function get() {
+  get: function () {
     return _internalMediaCore.LocalDisplayStream;
   }
 });
 exports.LocalMicrophoneStreamEventNames = exports.LocalMicrophoneStream = void 0;
-_Object$defineProperty(exports, "LocalStream", {
+Object.defineProperty(exports, "LocalStream", {
   enumerable: true,
-  get: function get() {
+  get: function () {
     return _internalMediaCore.LocalStream;
   }
 });
-_Object$defineProperty(exports, "LocalStreamEventNames", {
+Object.defineProperty(exports, "LocalStreamEventNames", {
   enumerable: true,
-  get: function get() {
+  get: function () {
     return _internalMediaCore.LocalStreamEventNames;
   }
 });
-_Object$defineProperty(exports, "LocalSystemAudioStream", {
+Object.defineProperty(exports, "LocalSystemAudioStream", {
   enumerable: true,
-  get: function get() {
+  get: function () {
     return _internalMediaCore.LocalSystemAudioStream;
   }
 });
-_Object$defineProperty(exports, "RemoteStream", {
+Object.defineProperty(exports, "RemoteStream", {
   enumerable: true,
-  get: function get() {
+  get: function () {
     return _internalMediaCore.RemoteStream;
   }
 });
-_Object$defineProperty(exports, "StreamEventNames", {
+Object.defineProperty(exports, "StreamEventNames", {
   enumerable: true,
-  get: function get() {
+  get: function () {
     return _internalMediaCore.StreamEventNames;
   }
 });
 exports.createMicrophoneStream = exports.createDisplayStreamWithAudio = exports.createDisplayStream = exports.createCameraStream = void 0;
-_Object$defineProperty(exports, "getDevices", {
+Object.defineProperty(exports, "getDevices", {
   enumerable: true,
-  get: function get() {
+  get: function () {
     return _internalMediaCore.getDevices;
   }
 });
-var _classCallCheck2 = _interopRequireDefault(require("@babel/runtime-corejs2/helpers/classCallCheck"));
-var _createClass2 = _interopRequireDefault(require("@babel/runtime-corejs2/helpers/createClass"));
-var _assertThisInitialized2 = _interopRequireDefault(require("@babel/runtime-corejs2/helpers/assertThisInitialized"));
-var _get2 = _interopRequireDefault(require("@babel/runtime-corejs2/helpers/get"));
-var _inherits2 = _interopRequireDefault(require("@babel/runtime-corejs2/helpers/inherits"));
-var _possibleConstructorReturn2 = _interopRequireDefault(require("@babel/runtime-corejs2/helpers/possibleConstructorReturn"));
-var _getPrototypeOf2 = _interopRequireDefault(require("@babel/runtime-corejs2/helpers/getPrototypeOf"));
-var _defineProperty2 = _interopRequireDefault(require("@babel/runtime-corejs2/helpers/defineProperty"));
 var _internalMediaCore = require("@webex/internal-media-core");
 var _tsEvents = require("@webex/ts-events");
-var _LocalMicrophoneStrea, _LocalCameraStreamEve;
-function _createSuper(Derived) { var hasNativeReflectConstruct = _isNativeReflectConstruct(); return function _createSuperInternal() { var Super = (0, _getPrototypeOf2.default)(Derived), result; if (hasNativeReflectConstruct) { var NewTarget = (0, _getPrototypeOf2.default)(this).constructor; result = _Reflect$construct(Super, arguments, NewTarget); } else { result = Super.apply(this, arguments); } return (0, _possibleConstructorReturn2.default)(this, result); }; }
-function _isNativeReflectConstruct() { if (typeof Reflect === "undefined" || !_Reflect$construct) return false; if (_Reflect$construct.sham) return false; if (typeof Proxy === "function") return true; try { Boolean.prototype.valueOf.call(_Reflect$construct(Boolean, [], function () {})); return true; } catch (e) { return false; } }
+/* eslint-disable @typescript-eslint/no-misused-new */
+/* eslint-disable valid-jsdoc */
+/* eslint-disable require-jsdoc */
 // server forced the client to be unmuted
 // these events are in addition to WCME events. This will be properly typed once webrtc-core event types inheritance is fixed
-var LocalMicrophoneStreamEventNames; // these events are in addition to WCME events. This will be properly typed once webrtc-core event types inheritance is fixed
-exports.LocalMicrophoneStreamEventNames = LocalMicrophoneStreamEventNames;
-(function (LocalMicrophoneStreamEventNames) {
+let LocalMicrophoneStreamEventNames = exports.LocalMicrophoneStreamEventNames = /*#__PURE__*/function (LocalMicrophoneStreamEventNames) {
   LocalMicrophoneStreamEventNames["ServerMuted"] = "muted:byServer";
-})(LocalMicrophoneStreamEventNames || (exports.LocalMicrophoneStreamEventNames = LocalMicrophoneStreamEventNames = {}));
-var LocalCameraStreamEventNames;
-exports.LocalCameraStreamEventNames = LocalCameraStreamEventNames;
-(function (LocalCameraStreamEventNames) {
+  return LocalMicrophoneStreamEventNames;
+}({}); // these events are in addition to WCME events. This will be properly typed once webrtc-core event types inheritance is fixed
+let LocalCameraStreamEventNames = exports.LocalCameraStreamEventNames = /*#__PURE__*/function (LocalCameraStreamEventNames) {
   LocalCameraStreamEventNames["ServerMuted"] = "muted:byServer";
-})(LocalCameraStreamEventNames || (exports.LocalCameraStreamEventNames = LocalCameraStreamEventNames = {}));
-_LocalMicrophoneStrea = LocalMicrophoneStreamEventNames.ServerMuted;
-var LocalMicrophoneStream = /*#__PURE__*/function (_WcmeLocalMicrophoneS) {
-  (0, _inherits2.default)(LocalMicrophoneStream, _WcmeLocalMicrophoneS);
-  var _super = _createSuper(LocalMicrophoneStream);
-  function LocalMicrophoneStream() {
-    var _this;
-    (0, _classCallCheck2.default)(this, LocalMicrophoneStream);
-    for (var _len = arguments.length, args = new Array(_len), _key = 0; _key < _len; _key++) {
-      args[_key] = arguments[_key];
-    }
-    _this = _super.call.apply(_super, [this].concat(args));
-    (0, _defineProperty2.default)((0, _assertThisInitialized2.default)(_this), "unmuteAllowed", true);
-    (0, _defineProperty2.default)((0, _assertThisInitialized2.default)(_this), _LocalMicrophoneStrea, new _tsEvents.TypedEvent());
-    return _this;
-  }
-  (0, _createClass2.default)(LocalMicrophoneStream, [{
-    key: "setUnmuteAllowed",
-    value:
-    /**
-     * @internal
-     */
-    function setUnmuteAllowed(allowed) {
-      this.unmuteAllowed = allowed;
-    }
+  return LocalCameraStreamEventNames;
+}({});
+class _LocalMicrophoneStream extends _internalMediaCore.LocalMicrophoneStream {
+  unmuteAllowed = true;
+  [LocalMicrophoneStreamEventNames.ServerMuted] = new _tsEvents.TypedEvent();
 
-    /**
-     * @returns true if user is allowed to unmute the Stream, false otherwise
-     */
-  }, {
-    key: "isUnmuteAllowed",
-    value: function isUnmuteAllowed() {
-      return this.unmuteAllowed;
-    }
-  }, {
-    key: "setMuted",
-    value: function setMuted(muted) {
-      if (!muted) {
-        if (!this.isUnmuteAllowed()) {
-          throw new Error('Unmute is not allowed');
-        }
-      }
-      return (0, _get2.default)((0, _getPrototypeOf2.default)(LocalMicrophoneStream.prototype), "setMuted", this).call(this, muted);
-    }
+  /**
+   * @internal
+   */
+  setUnmuteAllowed(allowed) {
+    this.unmuteAllowed = allowed;
+  }
 
-    /**
-     * @internal
-     */
-  }, {
-    key: "setServerMuted",
-    value: function setServerMuted(muted, reason) {
-      if (muted !== this.muted) {
-        this.setMuted(muted);
-        this[LocalMicrophoneStreamEventNames.ServerMuted].emit(muted, reason);
+  /**
+   * @returns true if user is allowed to unmute the track, false otherwise
+   */
+  isUnmuteAllowed() {
+    return this.unmuteAllowed;
+  }
+  setMuted(muted) {
+    if (!muted) {
+      if (!this.isUnmuteAllowed()) {
+        throw new Error('Unmute is not allowed');
       }
     }
-  }]);
-  return LocalMicrophoneStream;
-}(_internalMediaCore.LocalMicrophoneStream);
-exports.LocalMicrophoneStream = LocalMicrophoneStream;
-_LocalCameraStreamEve = LocalCameraStreamEventNames.ServerMuted;
-var LocalCameraStream = /*#__PURE__*/function (_WcmeLocalCameraStrea) {
-  (0, _inherits2.default)(LocalCameraStream, _WcmeLocalCameraStrea);
-  var _super2 = _createSuper(LocalCameraStream);
-  function LocalCameraStream() {
-    var _this2;
-    (0, _classCallCheck2.default)(this, LocalCameraStream);
-    for (var _len2 = arguments.length, args = new Array(_len2), _key2 = 0; _key2 < _len2; _key2++) {
-      args[_key2] = arguments[_key2];
-    }
-    _this2 = _super2.call.apply(_super2, [this].concat(args));
-    (0, _defineProperty2.default)((0, _assertThisInitialized2.default)(_this2), "unmuteAllowed", true);
-    (0, _defineProperty2.default)((0, _assertThisInitialized2.default)(_this2), _LocalCameraStreamEve, new _tsEvents.TypedEvent());
-    return _this2;
-  }
-  (0, _createClass2.default)(LocalCameraStream, [{
-    key: "setUnmuteAllowed",
-    value:
-    /**
-     * @internal
-     */
-    function setUnmuteAllowed(allowed) {
-      this.unmuteAllowed = allowed;
-    }
+    return super.setMuted(muted);
+  }
 
-    /**
-     * @returns true if user is allowed to unmute the Stream, false otherwise
-     */
-  }, {
-    key: "isUnmuteAllowed",
-    value: function isUnmuteAllowed() {
-      return this.unmuteAllowed;
+  /**
+   * @internal
+   */
+  setServerMuted(muted, reason) {
+    if (muted !== this.muted) {
+      this.setMuted(muted);
+      this[LocalMicrophoneStreamEventNames.ServerMuted].emit(muted, reason);
     }
-  }, {
-    key: "setMuted",
-    value: function setMuted(muted) {
-      if (!muted) {
-        if (!this.isUnmuteAllowed()) {
-          throw new Error('Unmute is not allowed');
-        }
+  }
+  toJSON() {
+    return {
+      id: this.id,
+      enabled: this.inputTrack?.enabled,
+      label: this.label,
+      readyState: this.readyState,
+      numEnabledEffects: this.getAllEffects().filter(item => item.effect.isEnabled).length
+    };
+  }
+}
+class _LocalCameraStream extends _internalMediaCore.LocalCameraStream {
+  unmuteAllowed = true;
+  [LocalCameraStreamEventNames.ServerMuted] = new _tsEvents.TypedEvent();
+
+  /**
+   * @internal
+   */
+  setUnmuteAllowed(allowed) {
+    this.unmuteAllowed = allowed;
+  }
+
+  /**
+   * @returns true if user is allowed to unmute the track, false otherwise
+   */
+  isUnmuteAllowed() {
+    return this.unmuteAllowed;
+  }
+  setMuted(muted) {
+    if (!muted) {
+      if (!this.isUnmuteAllowed()) {
+        throw new Error('Unmute is not allowed');
       }
-      return (0, _get2.default)((0, _getPrototypeOf2.default)(LocalCameraStream.prototype), "setMuted", this).call(this, muted);
     }
+    return super.setMuted(muted);
+  }
 
-    /**
-     * @internal
-     */
-  }, {
-    key: "setServerMuted",
-    value: function setServerMuted(muted, reason) {
-      if (muted !== this.muted) {
-        this.setMuted(muted);
-        this[LocalCameraStreamEventNames.ServerMuted].emit(muted, reason);
-      }
+  /**
+   * @internal
+   */
+  setServerMuted(muted, reason) {
+    if (muted !== this.muted) {
+      this.setMuted(muted);
+      this[LocalCameraStreamEventNames.ServerMuted].emit(muted, reason);
     }
-  }]);
-  return LocalCameraStream;
-}(_internalMediaCore.LocalCameraStream);
-exports.LocalCameraStream = LocalCameraStream;
-var createMicrophoneStream = function createMicrophoneStream(constraints) {
-  return (0, _internalMediaCore.createMicrophoneStream)(LocalMicrophoneStream, constraints);
-};
+  }
+  toJSON() {
+    return {
+      id: this.id,
+      enabled: this.inputTrack?.enabled,
+      label: this.label,
+      readyState: this.readyState,
+      numEnabledEffects: this.getAllEffects().filter(item => item.effect.isEnabled).length
+    };
+  }
+}
+const createMicrophoneStream = constraints => (0, _internalMediaCore.createMicrophoneStream)(LocalMicrophoneStream, constraints);
 exports.createMicrophoneStream = createMicrophoneStream;
-var createCameraStream = function createCameraStream(constraints) {
-  return (0, _internalMediaCore.createCameraStream)(LocalCameraStream, constraints);
-};
+const createCameraStream = constraints => (0, _internalMediaCore.createCameraStream)(LocalCameraStream, constraints);
 exports.createCameraStream = createCameraStream;
-var createDisplayStream = function createDisplayStream() {
-  return (0, _internalMediaCore.createDisplayStream)(_internalMediaCore.LocalDisplayStream);
-};
+const createDisplayStream = () => (0, _internalMediaCore.createDisplayStream)(_internalMediaCore.LocalDisplayStream);
 exports.createDisplayStream = createDisplayStream;
-var createDisplayStreamWithAudio = function createDisplayStreamWithAudio() {
-  return (0, _internalMediaCore.createDisplayStreamWithAudio)(_internalMediaCore.LocalDisplayStream, _internalMediaCore.LocalSystemAudioStream);
-};
+const createDisplayStreamWithAudio = () => (0, _internalMediaCore.createDisplayStreamWithAudio)(_internalMediaCore.LocalDisplayStream, _internalMediaCore.LocalSystemAudioStream);
 exports.createDisplayStreamWithAudio = createDisplayStreamWithAudio;
+const LocalMicrophoneStream = exports.LocalMicrophoneStream = (0, _tsEvents.AddEvents)(_LocalMicrophoneStream);
+const LocalCameraStream = exports.LocalCameraStream = (0, _tsEvents.AddEvents)(_LocalCameraStream);
 //# sourceMappingURL=webrtc-core.js.map

package/dist/webrtc-core.js.map

@@ -1 +1 @@
-{"version":3,"names":["_internalMediaCore","require","_tsEvents","_LocalMicrophoneStrea","_LocalCameraStreamEve","_createSuper","Derived","hasNativeReflectConstruct","_isNativeReflectConstruct","_createSuperInternal","Super","_getPrototypeOf2","default","result","NewTarget","constructor","_Reflect$construct","arguments","apply","_possibleConstructorReturn2","Reflect","sham","Proxy","Boolean","prototype","valueOf","call","e","LocalMicrophoneStreamEventNames","exports","LocalCameraStreamEventNames","ServerMuted","LocalMicrophoneStream","_WcmeLocalMicrophoneS","_inherits2","_super","_this","_classCallCheck2","_len","length","args","Array","_key","concat","_defineProperty2","_assertThisInitialized2","TypedEvent","_createClass2","key","value","setUnmuteAllowed","allowed","unmuteAllowed","isUnmuteAllowed","setMuted","muted","Error","_get2","setServerMuted","reason","emit","WcmeLocalMicrophoneStream","LocalCameraStream","_WcmeLocalCameraStrea","_super2","_this2","_len2","_key2","WcmeLocalCameraStream","createMicrophoneStream","constraints","wcmeCreateMicrophoneStream","createCameraStream","wcmeCreateCameraStream","createDisplayStream","wcmeCreateDisplayStream","LocalDisplayStream","createDisplayStreamWithAudio","wcmeCreateDisplayStreamWithAudio","LocalSystemAudioStream"],"sources":["webrtc-core.ts"],"sourcesContent":["/* eslint-disable @typescript-eslint/no-misused-new */\n/* eslint-disable valid-jsdoc */\n/* eslint-disable require-jsdoc */\nimport {\n  AudioDeviceConstraints,\n  createCameraStream as wcmeCreateCameraStream,\n  createDisplayStream as wcmeCreateDisplayStream,\n  createDisplayStreamWithAudio as wcmeCreateDisplayStreamWithAudio,\n  createMicrophoneStream as wcmeCreateMicrophoneStream,\n  LocalDisplayStream,\n  LocalSystemAudioStream,\n  LocalMicrophoneStream as WcmeLocalMicrophoneStream,\n  LocalCameraStream as WcmeLocalCameraStream,\n  VideoDeviceConstraints,\n} from '@webex/internal-media-core';\nimport {TypedEvent} from '@webex/ts-events';\n\nexport {\n  getDevices,\n  LocalStream,\n  LocalDisplayStream,\n  LocalSystemAudioStream,\n  LocalStreamEventNames,\n  StreamEventNames,\n  RemoteStream,\n} from '@webex/internal-media-core';\n\nexport type ServerMuteReason =\n  | 'remotelyMuted' // other user has remotely muted us\n  | 'clientRequestFailed' // client called setMuted() but server request failed\n  | 'localUnmuteRequired'; // server forced the client to be unmuted\n\n// these events are in addition to WCME events. This will be properly typed once webrtc-core event types inheritance is fixed\nexport enum LocalMicrophoneStreamEventNames {\n  ServerMuted = 'muted:byServer',\n}\n\n// these events are in addition to WCME events. This will be properly typed once webrtc-core event types inheritance is fixed\nexport enum LocalCameraStreamEventNames {\n  ServerMuted = 'muted:byServer',\n}\n\nexport class LocalMicrophoneStream extends WcmeLocalMicrophoneStream {\n  private unmuteAllowed = true;\n\n  [LocalMicrophoneStreamEventNames.ServerMuted] = new TypedEvent<\n    (muted: boolean, reason: ServerMuteReason) => void\n  >();\n\n  /**\n   * @internal\n   */\n  setUnmuteAllowed(allowed) {\n    this.unmuteAllowed = allowed;\n  }\n\n  /**\n   * @returns true if user is allowed to unmute the Stream, false otherwise\n   */\n  isUnmuteAllowed() {\n    return this.unmuteAllowed;\n  }\n\n  setMuted(muted: boolean): void {\n    if (!muted) {\n      if (!this.isUnmuteAllowed()) {\n        throw new Error('Unmute is not allowed');\n      }\n    }\n\n    return super.setMuted(muted);\n  }\n\n  /**\n   * @internal\n   */\n  setServerMuted(muted: boolean, reason: ServerMuteReason) {\n    if (muted !== this.muted) {\n      this.setMuted(muted);\n      this[LocalMicrophoneStreamEventNames.ServerMuted].emit(muted, reason);\n    }\n  }\n}\n\nexport class LocalCameraStream extends WcmeLocalCameraStream {\n  private unmuteAllowed = true;\n\n  [LocalCameraStreamEventNames.ServerMuted] = new TypedEvent<\n    (muted: boolean, reason: ServerMuteReason) => void\n  >();\n\n  /**\n   * @internal\n   */\n  setUnmuteAllowed(allowed) {\n    this.unmuteAllowed = allowed;\n  }\n\n  /**\n   * @returns true if user is allowed to unmute the Stream, false otherwise\n   */\n  isUnmuteAllowed() {\n    return this.unmuteAllowed;\n  }\n\n  setMuted(muted: boolean): void {\n    if (!muted) {\n      if (!this.isUnmuteAllowed()) {\n        throw new Error('Unmute is not allowed');\n      }\n    }\n\n    return super.setMuted(muted);\n  }\n\n  /**\n   * @internal\n   */\n  setServerMuted(muted: boolean, reason: ServerMuteReason) {\n    if (muted !== this.muted) {\n      this.setMuted(muted);\n      this[LocalCameraStreamEventNames.ServerMuted].emit(muted, reason);\n    }\n  }\n}\n\nexport const createMicrophoneStream = (constraints?: AudioDeviceConstraints) =>\n  wcmeCreateMicrophoneStream(LocalMicrophoneStream, constraints);\n\nexport const createCameraStream = (constraints?: VideoDeviceConstraints) =>\n  wcmeCreateCameraStream(LocalCameraStream, constraints);\n\nexport const createDisplayStream = () => wcmeCreateDisplayStream(LocalDisplayStream);\n\nexport const createDisplayStreamWithAudio = () =>\n  wcmeCreateDisplayStreamWithAudio(LocalDisplayStream, LocalSystemAudioStream);\n"],"mappings":"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"}
+null

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@webex/media-helpers",
-  "description": "",
+  "description": "Package that provides helper functions for media related activities.",
   "license": "Cisco EULA (https://www.cisco.com/c/en/us/products/end-user-license-agreement.html)",
   "main": "dist/index.js",
   "devMain": "src/index.ts",
@@ -13,22 +13,19 @@
     "node": ">=16"
   },
   "scripts": {
-    "build:src": "yarn run -T tsc --declaration true --declarationDir ./dist",
+    "build": "yarn run -T tsc --declaration true --declarationDir ./dist",
+    "build:src": "webex-legacy-tools build -dest \"./dist\" -src \"./src\" -js -ts -maps && yarn run -T tsc --declaration true --declarationDir ./dist",
     "test:broken": "yarn test:style && yarn test:unit && yarn test:integration && yarn test:browser",
     "test:browser:broken": "webex-legacy-tools test --integration --unit --runner karma",
     "test:integration:broken": "webex-legacy-tools test --integration --runner mocha",
     "test:style": "eslint 'src/**/*.ts' --fix",
     "test:unit:broken": "webex-legacy-tools test --unit --runner mocha",
-    "deploy:npm": "npm publish"
+    "deploy:npm": "yarn npm publish"
   },
   "dependencies": {
-    "@webex/babel-config-legacy": "workspace:^",
-    "@webex/eslint-config-legacy": "workspace:^",
-    "@webex/internal-media-core": "^2.0.0",
-    "@webex/jest-config-legacy": "workspace:^",
-    "@webex/legacy-tools": "workspace:^",
+    "@webex/internal-media-core": "2.2.1",
     "@webex/ts-events": "^1.1.0",
-    "@webex/web-media-effects": "^2.12.0"
+    "@webex/web-media-effects": "^2.13.6"
   },
   "browserify": {
     "transform": [
@@ -38,10 +35,14 @@
   },
   "devDependencies": {
     "@babel/preset-typescript": "7.22.11",
-    "@webex/test-helper-chai": "workspace:^",
-    "@webex/test-helper-mock-webex": "workspace:^",
+    "@webex/babel-config-legacy": "^0.0.0",
+    "@webex/eslint-config-legacy": "^0.0.0",
+    "@webex/jest-config-legacy": "^0.0.0",
+    "@webex/legacy-tools": "^0.0.0",
+    "@webex/test-helper-chai": "^2.60.0-next.1",
+    "@webex/test-helper-mock-webex": "^2.60.0-next.1",
     "eslint": "^8.24.0",
     "sinon": "^9.2.4"
   },
-  "version": "3.0.0-next.1"
-}
+  "version": "3.0.0-next.11"
+}

package/src/index.ts

@@ -5,6 +5,7 @@ export {
   LocalSystemAudioStream,
   LocalStreamEventNames,
   StreamEventNames,
+  RemoteStream,
   type ServerMuteReason,
   LocalMicrophoneStreamEventNames,
   LocalCameraStreamEventNames,
@@ -14,6 +15,7 @@ export {
   createCameraStream,
   createDisplayStream,
   createDisplayStreamWithAudio,
+  type VideoContentHint,
 } from './webrtc-core';
 
 export {NoiseReductionEffect, VirtualBackgroundEffect} from '@webex/web-media-effects';

package/src/webrtc-core.ts

@@ -13,7 +13,7 @@ import {
   LocalCameraStream as WcmeLocalCameraStream,
   VideoDeviceConstraints,
 } from '@webex/internal-media-core';
-import {TypedEvent} from '@webex/ts-events';
+import {AddEvents, TypedEvent, WithEventsDummyType} from '@webex/ts-events';
 
 export {
   getDevices,
@@ -23,6 +23,7 @@ export {
   LocalStreamEventNames,
   StreamEventNames,
   RemoteStream,
+  type VideoContentHint,
 } from '@webex/internal-media-core';
 
 export type ServerMuteReason =
@@ -40,7 +41,19 @@ export enum LocalCameraStreamEventNames {
   ServerMuted = 'muted:byServer',
 }
 
-export class LocalMicrophoneStream extends WcmeLocalMicrophoneStream {
+interface LocalMicrophoneStreamEvents {
+  [LocalMicrophoneStreamEventNames.ServerMuted]: TypedEvent<
+    (muted: boolean, reason: ServerMuteReason) => void
+  >;
+}
+
+interface LocalCameraStreamEvents {
+  [LocalMicrophoneStreamEventNames.ServerMuted]: TypedEvent<
+    (muted: boolean, reason: ServerMuteReason) => void
+  >;
+}
+
+class _LocalMicrophoneStream extends WcmeLocalMicrophoneStream {
   private unmuteAllowed = true;
 
   [LocalMicrophoneStreamEventNames.ServerMuted] = new TypedEvent<
@@ -55,7 +68,7 @@ export class LocalMicrophoneStream extends WcmeLocalMicrophoneStream {
   }
 
   /**
-   * @returns true if user is allowed to unmute the Stream, false otherwise
+   * @returns true if user is allowed to unmute the track, false otherwise
    */
   isUnmuteAllowed() {
     return this.unmuteAllowed;
@@ -80,9 +93,19 @@ export class LocalMicrophoneStream extends WcmeLocalMicrophoneStream {
       this[LocalMicrophoneStreamEventNames.ServerMuted].emit(muted, reason);
     }
   }
+
+  toJSON() {
+    return {
+      id: this.id,
+      enabled: this.inputTrack?.enabled,
+      label: this.label,
+      readyState: this.readyState,
+      numEnabledEffects: this.getAllEffects().filter((item) => item.effect.isEnabled).length,
+    };
+  }
 }
 
-export class LocalCameraStream extends WcmeLocalCameraStream {
+class _LocalCameraStream extends WcmeLocalCameraStream {
   private unmuteAllowed = true;
 
   [LocalCameraStreamEventNames.ServerMuted] = new TypedEvent<
@@ -97,7 +120,7 @@ export class LocalCameraStream extends WcmeLocalCameraStream {
   }
 
   /**
-   * @returns true if user is allowed to unmute the Stream, false otherwise
+   * @returns true if user is allowed to unmute the track, false otherwise
    */
   isUnmuteAllowed() {
     return this.unmuteAllowed;
@@ -122,6 +145,16 @@ export class LocalCameraStream extends WcmeLocalCameraStream {
       this[LocalCameraStreamEventNames.ServerMuted].emit(muted, reason);
     }
   }
+
+  toJSON() {
+    return {
+      id: this.id,
+      enabled: this.inputTrack?.enabled,
+      label: this.label,
+      readyState: this.readyState,
+      numEnabledEffects: this.getAllEffects().filter((item) => item.effect.isEnabled).length,
+    };
+  }
 }
 
 export const createMicrophoneStream = (constraints?: AudioDeviceConstraints) =>
@@ -134,3 +167,17 @@ export const createDisplayStream = () => wcmeCreateDisplayStream(LocalDisplayStr
 
 export const createDisplayStreamWithAudio = () =>
   wcmeCreateDisplayStreamWithAudio(LocalDisplayStream, LocalSystemAudioStream);
+
+export const LocalMicrophoneStream = AddEvents<
+  typeof _LocalMicrophoneStream,
+  LocalMicrophoneStreamEvents
+>(_LocalMicrophoneStream);
+
+export type LocalMicrophoneStream = _LocalMicrophoneStream &
+  WithEventsDummyType<LocalMicrophoneStreamEvents>;
+
+export const LocalCameraStream = AddEvents<typeof _LocalCameraStream, LocalCameraStreamEvents>(
+  _LocalCameraStream
+);
+
+export type LocalCameraStream = _LocalCameraStream & WithEventsDummyType<LocalCameraStreamEvents>;

package/test/unit/spec/webrtc-core.js

@@ -12,7 +12,7 @@ import {
   createDisplayStream,
   createDisplayStreamWithAudio,
 } from '../../../src/webrtc-core';
-import * as wcmeStreams from '@webex/internal-media-core';
+import * as wcmestreams from '@webex/internal-media-core';
 
 describe('media-helpers', () => {
   describe('webrtc-core', () => {
@@ -36,11 +36,12 @@ describe('media-helpers', () => {
     classesToTest.forEach(({className, title, event, createFn, spyFn}) =>
       describe(title, () => {
         const fakeStream = {
-          getStreams: sinon.stub().returns([
+          getTracks: sinon.stub().returns([
             {
-              label: 'fake Stream',
-              id: 'fake Stream id',
+              label: 'fake track',
+              id: 'fake track id',
               enabled: true,
+              addEventListener: sinon.stub(),
             },
           ]),
         };
@@ -70,6 +71,10 @@ describe('media-helpers', () => {
           await stream.setMuted(false);
         });
 
+        it('returns a reasonable length string from JSON.stringify()', () => {
+          assert.isBelow(JSON.stringify(stream).length, 200);
+        })
+
         describe('#setServerMuted', () => {
           afterEach(() => {
             sinon.restore();
@@ -87,7 +92,7 @@ describe('media-helpers', () => {
 
             assert.equal(stream.muted, setMute);
             if (expectedCalled) {
-              assert.calledOnceWithExactly(handler, {muted: setMute, reason: 'remotelyMuted'});
+              assert.calledOnceWithExactly(handler, setMute, 'remotelyMuted');
             } else {
               assert.notCalled(handler);
             }
@@ -111,10 +116,10 @@ describe('media-helpers', () => {
         });
 
         describe('#wcmeCreateMicrophoneStream, #wcmeCreateCameraStream', () => {
-          it('checks creating Streams', async () => {
-            const constraints = {devideId: 'abc'};
+          it('checks creating tracks', async () => {
+            const constraints = {deviceId: 'abc'};
 
-            const spy = sinon.stub(wcmeStreams, spyFn).returns('something');
+            const spy = sinon.stub(wcmestreams, spyFn).returns('something');
             const result = createFn(constraints);
 
             assert.equal(result, 'something');
@@ -126,16 +131,16 @@ describe('media-helpers', () => {
 
     describe('createDisplayStream', () => {
       it('checks createDisplayStream', async () => {
-        const spy = sinon.stub(wcmeStreams, 'createDisplayStream').returns('something');
+        const spy = sinon.stub(wcmestreams, 'createDisplayStream').returns('something');
         const result = createDisplayStream();
         assert.equal(result, 'something');
         assert.calledOnceWithExactly(spy, LocalDisplayStream);
       });
     });
-
+    
     describe('createDisplayStreamWithAudio', () => {
       it('checks createDisplayStreamWithAudio', async () => {
-        const spy = sinon.stub(wcmeStreams, 'createDisplayStreamWithAudio').returns('something');
+        const spy = sinon.stub(wcmestreams, 'createDisplayStreamWithAudio').returns('something');
         const result = createDisplayStreamWithAudio();
         assert.equal(result, 'something');
         assert.calledOnceWithExactly(spy, LocalDisplayStream, LocalSystemAudioStream);