@webex/internal-media-core 1.35.4 → 1.35.6

package/dist/cjs/index.js

@@ -1983,7 +1983,7 @@ class Track extends EventEmitter$4 {
 
 var eventEmitter = new EventEmitter$4();
 var deviceList = [];
-var getDevices = /*#__PURE__*/function () {
+var getDevices$1 = /*#__PURE__*/function () {
   var _ref = _asyncToGenerator__default["default"](function* () {
     var _navigator$mediaDevic;
     logger$5.debug({
@@ -2013,7 +2013,7 @@ var getCameras = /*#__PURE__*/function () {
       action: 'getCameras()',
       description: 'Called'
     });
-    var devices = yield getDevices();
+    var devices = yield getDevices$1();
     logger$5.info({
       mediaType: DEVICE,
       action: 'getCameras()',
@@ -2045,7 +2045,7 @@ var getMicrophones = /*#__PURE__*/function () {
       action: 'getMicrophones()',
       description: 'Called'
     });
-    var devices = yield getDevices();
+    var devices = yield getDevices$1();
     logger$5.info({
       mediaType: DEVICE,
       action: 'getMicrophones()',
@@ -2077,7 +2077,7 @@ var getSpeakers = /*#__PURE__*/function () {
       action: 'getSpeakers()',
       description: 'Called'
     });
-    var devices = yield getDevices();
+    var devices = yield getDevices$1();
     logger$5.info({
       mediaType: DEVICE,
       action: 'getSpeakers()',
@@ -2389,7 +2389,7 @@ function _on() {
     });
     eventEmitter.on(eventName, listener);
     if (eventName === 'device:changed') {
-      var thisDeviceList = yield getDevices();
+      var thisDeviceList = yield getDevices$1();
       deviceList.push(...thisDeviceList);
       navigator.mediaDevices.addEventListener('devicechange', deviceChangePublisher);
     }
@@ -4540,6 +4540,277 @@ var DeviceKind;
   DeviceKind["AudioOutput"] = "audiooutput";
   DeviceKind["VideoInput"] = "videoinput";
 })(DeviceKind || (DeviceKind = {}));
+/**
+ * Prompts the user for permission to use a media input which produces a MediaStream with tracks
+ * containing the requested types of media.
+ *
+ * @param constraints - A MediaStreamConstraints object specifying the types of media to request,
+ *     along with any requirements for each type.
+ * @returns A Promise whose fulfillment handler receives a MediaStream object when the requested
+ *     media has successfully been obtained.
+ */
+function getUserMedia(constraints) {
+  return __awaiter$1(this, void 0, void 0, function* () {
+    return navigator.mediaDevices.getUserMedia(constraints);
+  });
+}
+/**
+ * Prompts the user for permission to use a user's display media and audio. If a video track is
+ * absent from the constraints argument, one will still be provided.
+ *
+ * @param constraints - A MediaStreamConstraints object specifying the types of media to request,
+ *     along with any requirements for each type.
+ * @returns A Promise whose fulfillment handler receives a MediaStream object when the requested
+ *     media has successfully been obtained.
+ */
+function getDisplayMedia(constraints) {
+  return navigator.mediaDevices.getDisplayMedia(constraints);
+}
+/**
+ * Requests a list of the available media input and output devices, such as microphones, cameras,
+ * headsets, and so forth.
+ *
+ * @returns A Promise that receives an array of MediaDeviceInfo objects when the promise is
+ *     fulfilled.
+ */
+function enumerateDevices() {
+  return __awaiter$1(this, void 0, void 0, function* () {
+    return navigator.mediaDevices.enumerateDevices();
+  });
+}
+/**
+ * Adds the callback handler to be notified of a media device change (for example, a headset is
+ * unplugged from the user's computer).
+ *
+ * @param handler - The callback function to execute.
+ */
+function setOnDeviceChangeHandler$1(handler) {
+  navigator.mediaDevices.ondevicechange = handler;
+}
+/**
+ * Checks permissions using the navigator's permissions api.
+ *
+ * @param deviceKinds - Array of DeviceKind items.
+ * @throws An error if camera or microphone aren't available options for query() (Firefox), or if
+ *    navigator.permissions is undefined (Safari and others).
+ * @returns Array of Permission Status objects.
+ */
+function checkNavigatorPermissions(deviceKinds) {
+  return __awaiter$1(this, void 0, void 0, function* () {
+    var permissionRequests = [];
+    if (deviceKinds.includes(DeviceKind.VideoInput)) {
+      permissionRequests.push(navigator.permissions.query({
+        name: 'camera'
+      }));
+    }
+    if (deviceKinds.includes(DeviceKind.AudioInput)) {
+      permissionRequests.push(navigator.permissions.query({
+        name: 'microphone'
+      }));
+    }
+    return Promise.all(permissionRequests);
+  });
+}
+/**
+ * Check to see if the user has granted the application permission to use their devices.
+ *
+ * @param deviceKinds - Array of DeviceKind items.
+ * @returns True if device permissions exist, false if otherwise.
+ */
+function checkDevicePermissions(deviceKinds) {
+  return __awaiter$1(this, void 0, void 0, function* () {
+    try {
+      var permissions = yield checkNavigatorPermissions(deviceKinds);
+      if (permissions.every(permission => permission.state === 'granted')) {
+        return true;
+      }
+      // eslint-disable-next-line no-empty
+    } catch (e) {}
+    try {
+      var devices = yield enumerateDevices();
+      // If permissions are granted, the MediaDeviceInfo objects will have labels.
+      return devices.filter(device => deviceKinds.includes(device.kind)).every(device => device.label);
+      // eslint-disable-next-line no-empty
+    } catch (e) {}
+    return false;
+  });
+}
+/**
+ * Ensures that the user has granted permissions to the microphone and camera.
+ *
+ * @param deviceKinds - Array of DeviceKind items.
+ * @param callback - Function that will be executed while device permissions are granted. After this
+ *    returns, permissions (for example device labels in Firefox) may not be available anymore.
+ * @returns The callback's response.
+ */
+function ensureDevicePermissions(deviceKinds, callback) {
+  return __awaiter$1(this, void 0, void 0, function* () {
+    try {
+      var hasDevicePermissions = yield checkDevicePermissions(deviceKinds);
+      if (!hasDevicePermissions) {
+        var stream = yield getUserMedia({
+          audio: deviceKinds.includes(DeviceKind.AudioInput),
+          video: deviceKinds.includes(DeviceKind.VideoInput)
+        });
+        // Callback is here to call a function while an active capture exists, so that the browser
+        // (Firefox) will allow the user to access device information.
+        var callbackRes = yield callback();
+        // Stop tracks in the stream so the browser (Safari) will know that there is not an active
+        // stream running.
+        stream.getTracks().forEach(track => track.stop());
+        return callbackRes;
+      }
+      return callback();
+    } catch (e) {
+      logger$3.error(e);
+      throw new Error('Failed to ensure device permissions.');
+    }
+  });
+}
+var media = /*#__PURE__*/Object.freeze({
+  __proto__: null,
+  get DeviceKind() {
+    return DeviceKind;
+  },
+  getUserMedia: getUserMedia,
+  getDisplayMedia: getDisplayMedia,
+  enumerateDevices: enumerateDevices,
+  setOnDeviceChangeHandler: setOnDeviceChangeHandler$1,
+  checkDevicePermissions: checkDevicePermissions,
+  ensureDevicePermissions: ensureDevicePermissions
+});
+var ErrorTypes;
+(function (ErrorTypes) {
+  ErrorTypes["DEVICE_PERMISSION_DENIED"] = "DEVICE_PERMISSION_DENIED";
+  ErrorTypes["CREATE_CAMERA_TRACK_FAILED"] = "CREATE_CAMERA_TRACK_FAILED";
+  ErrorTypes["CREATE_MICROPHONE_TRACK_FAILED"] = "CREATE_MICROPHONE_TRACK_FAILED";
+})(ErrorTypes || (ErrorTypes = {}));
+/**
+ * Represents a WCME error, which contains error type and error message.
+ */
+class WcmeError {
+  /**
+   * Creates new error.
+   *
+   * @param type - Error type.
+   * @param message - Error message.
+   */
+  constructor(type) {
+    var message = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : '';
+    this.type = type;
+    this.message = message;
+  }
+}
+/**
+ * Creates a camera video track. Please note that the constraint params in second getUserMedia call would NOT take effect when:
+ *
+ * 1. Previous captured video track from the same device is not stopped .
+ * 2. Previous createCameraTrack() call for the same device is in progress.
+ *
+ * @param constructor - Constructor for the local camera track.
+ * @param constraints - Video device constraints.
+ * @returns A LocalTrack object or an error.
+ */
+function createCameraTrack(constructor, constraints) {
+  return __awaiter$1(this, void 0, void 0, function* () {
+    var stream;
+    try {
+      stream = yield getUserMedia({
+        video: Object.assign({}, constraints)
+      });
+    } catch (error) {
+      throw new WcmeError(ErrorTypes.CREATE_CAMERA_TRACK_FAILED, "Failed to create camera track ".concat(error));
+    }
+    return new constructor(stream);
+  });
+}
+/**
+ * Creates a microphone audio track.
+ *
+ * @param constructor - Constructor for the local microphone track.
+ * @param constraints - Audio device constraints.
+ * @returns A LocalTrack object or an error.
+ */
+function createMicrophoneTrack(constructor, constraints) {
+  return __awaiter$1(this, void 0, void 0, function* () {
+    var stream;
+    try {
+      stream = yield getUserMedia({
+        audio: Object.assign({}, constraints)
+      });
+    } catch (error) {
+      throw new WcmeError(ErrorTypes.CREATE_MICROPHONE_TRACK_FAILED, "Failed to create microphone track ".concat(error));
+    }
+    return new constructor(stream);
+  });
+}
+/**
+ * Creates a display video track.
+ *
+ * @param constructor - Constructor for the local display track.
+ * @returns A Promise that resolves to a LocalDisplayTrack.
+ */
+function createDisplayTrack(constructor) {
+  return __awaiter$1(this, void 0, void 0, function* () {
+    var stream = yield getDisplayMedia({
+      video: true
+    });
+    return new constructor(stream);
+  });
+}
+/**
+ * Enumerates the media input and output devices available.
+ *
+ * @param deviceKind - Optional filter to return a specific device kind.
+ * @returns List of media devices in an array of MediaDeviceInfo objects.
+ */
+function getDevices(deviceKind) {
+  return __awaiter$1(this, void 0, void 0, function* () {
+    var devices;
+    try {
+      devices = yield ensureDevicePermissions([DeviceKind.AudioInput, DeviceKind.VideoInput], enumerateDevices);
+    } catch (error) {
+      throw new WcmeError(ErrorTypes.DEVICE_PERMISSION_DENIED, 'Failed to ensure device permissions');
+    }
+    return devices.filter(v => deviceKind ? v.kind === deviceKind : true);
+  });
+}
+/**
+ * Helper function to get a list of microphone devices.
+ *
+ * @returns List of microphone devices in an array of MediaDeviceInfo objects.
+ */
+function getAudioInputDevices() {
+  return __awaiter$1(this, void 0, void 0, function* () {
+    return getDevices(DeviceKind.AudioInput);
+  });
+}
+/**
+ * Helper function to get a list of speaker devices.
+ *
+ * @returns List of speaker devices in an array of MediaDeviceInfo objects.
+ */
+function getAudioOutputDevices() {
+  return __awaiter$1(this, void 0, void 0, function* () {
+    return getDevices(DeviceKind.AudioOutput);
+  });
+}
+/**
+ * Helper function to get a list of camera devices.
+ *
+ * @returns List of camera devices in an array of MediaDeviceInfo objects.
+ */
+function getVideoInputDevices() {
+  return __awaiter$1(this, void 0, void 0, function* () {
+    return getDevices(DeviceKind.VideoInput);
+  });
+}
+/**
+ * Export the setOnDeviceChangeHandler method directly from the core lib.
+ */
+var {
+  setOnDeviceChangeHandler
+} = media;
 var events$1 = {
   exports: {}
 };
@@ -5218,12 +5489,6 @@ class LocalDisplayTrack extends LocalTrack {}
  * Represents a local track for a microphone source.
  */
 class LocalMicrophoneTrack extends LocalTrack {}
-var ErrorTypes;
-(function (ErrorTypes) {
-  ErrorTypes["DEVICE_PERMISSION_DENIED"] = "DEVICE_PERMISSION_DENIED";
-  ErrorTypes["CREATE_CAMERA_TRACK_FAILED"] = "CREATE_CAMERA_TRACK_FAILED";
-  ErrorTypes["CREATE_MICROPHONE_TRACK_FAILED"] = "CREATE_MICROPHONE_TRACK_FAILED";
-})(ErrorTypes || (ErrorTypes = {}));
 
 // Overall connection state (based on the ICE and DTLS connection states)
 exports.ConnectionState = void 0;
@@ -8396,11 +8661,11 @@ function createRTCPeerConnection(configuration) {
 /**
  * A type-safe form of the DOMString used in the MediaStreamTrack.kind field.
  */
-var MediaStreamTrackKind;
+exports.MediaStreamTrackKind = void 0;
 (function (MediaStreamTrackKind) {
   MediaStreamTrackKind["Audio"] = "audio";
   MediaStreamTrackKind["Video"] = "video";
-})(MediaStreamTrackKind || (MediaStreamTrackKind = {}));
+})(exports.MediaStreamTrackKind || (exports.MediaStreamTrackKind = {}));
 var PeerConnectionEvents;
 (function (PeerConnectionEvents) {
   PeerConnectionEvents["IceGatheringStateChange"] = "icegatheringstatechange";
@@ -14241,10 +14506,10 @@ function setLogHandler(logHandler) {
   Logger$1.setHandler(logHandler);
 }
 function toMediaStreamTrackKind(mediaType) {
-  return [MediaType.VideoMain, MediaType.VideoSlides].includes(mediaType) ? MediaStreamTrackKind.Video : MediaStreamTrackKind.Audio;
+  return [MediaType.VideoMain, MediaType.VideoSlides].includes(mediaType) ? exports.MediaStreamTrackKind.Video : exports.MediaStreamTrackKind.Audio;
 }
 function toMediaFamily(kind) {
-  if (kind === MediaStreamTrackKind.Video) {
+  if (kind === exports.MediaStreamTrackKind.Video) {
     return MediaFamily.Video;
   }
   return MediaFamily.Audio;
@@ -14438,7 +14703,7 @@ class MultistreamConnection extends EventEmitter {
               state: 'invalid source',
               csi: sendTransceiver.csi
             });
-          } else if (signaler.getEncodingIndexForStreamId(id) > activeSimulcastLayerNumber) {
+          } else if (signaler.getEncodingIndexForStreamId(id) >= activeSimulcastLayerNumber) {
             sourceWarnings.push({
               id,
               state: 'no source',
@@ -14921,7 +15186,7 @@ class MultistreamConnection extends EventEmitter {
   }
   renewPeerConnection(userOptions) {
     if (userOptions) {
-      this.options = Object.assign(Object.assign({}, defaultMultistreamConnectionOptions), userOptions);
+      this.options = Object.assign(Object.assign({}, this.options), userOptions);
     }
     logger$4.info("Renewing multistream connection with options ".concat(JSON.stringify(this.options)));
     this.clearMids();
@@ -24205,11 +24470,21 @@ exports.LocalTrack = LocalTrack;
 exports.Media = Media;
 exports.MediaRequest = MediaRequest;
 exports.MultistreamRoapMediaConnection = MultistreamRoapMediaConnection;
+exports.PeerConnection = PeerConnection;
 exports.ReceiveSlot = ReceiveSlot;
 exports.ReceiverSelectedInfo = ReceiverSelectedInfo;
 exports.RoapMediaConnection = RoapMediaConnection;
+exports.WcmeError = WcmeError;
+exports.createCameraTrack = createCameraTrack;
+exports.createDisplayTrack = createDisplayTrack;
+exports.createMicrophoneTrack = createMicrophoneTrack;
+exports.getAudioInputDevices = getAudioInputDevices;
+exports.getAudioOutputDevices = getAudioOutputDevices;
+exports.getDevices = getDevices;
 exports.getErrorDescription = getErrorDescription;
 exports.getLogger = getLogger;
 exports.getMediaFamily = getMediaFamily;
+exports.getVideoInputDevices = getVideoInputDevices;
 exports.isBrowserSupported = isBrowserSupported;
 exports.setLogger = setLogger;
+exports.setOnDeviceChangeHandler = setOnDeviceChangeHandler;

package/dist/esm/index.js

@@ -1972,7 +1972,7 @@ class Track extends EventEmitter$4 {
 
 var eventEmitter = new EventEmitter$4();
 var deviceList = [];
-var getDevices = /*#__PURE__*/function () {
+var getDevices$1 = /*#__PURE__*/function () {
   var _ref = _asyncToGenerator(function* () {
     var _navigator$mediaDevic;
     logger$5.debug({
@@ -2002,7 +2002,7 @@ var getCameras = /*#__PURE__*/function () {
       action: 'getCameras()',
       description: 'Called'
     });
-    var devices = yield getDevices();
+    var devices = yield getDevices$1();
     logger$5.info({
       mediaType: DEVICE,
       action: 'getCameras()',
@@ -2034,7 +2034,7 @@ var getMicrophones = /*#__PURE__*/function () {
       action: 'getMicrophones()',
       description: 'Called'
     });
-    var devices = yield getDevices();
+    var devices = yield getDevices$1();
     logger$5.info({
       mediaType: DEVICE,
       action: 'getMicrophones()',
@@ -2066,7 +2066,7 @@ var getSpeakers = /*#__PURE__*/function () {
       action: 'getSpeakers()',
       description: 'Called'
     });
-    var devices = yield getDevices();
+    var devices = yield getDevices$1();
     logger$5.info({
       mediaType: DEVICE,
       action: 'getSpeakers()',
@@ -2378,7 +2378,7 @@ function _on() {
     });
     eventEmitter.on(eventName, listener);
     if (eventName === 'device:changed') {
-      var thisDeviceList = yield getDevices();
+      var thisDeviceList = yield getDevices$1();
       deviceList.push(...thisDeviceList);
       navigator.mediaDevices.addEventListener('devicechange', deviceChangePublisher);
     }
@@ -4529,6 +4529,277 @@ var DeviceKind;
   DeviceKind["AudioOutput"] = "audiooutput";
   DeviceKind["VideoInput"] = "videoinput";
 })(DeviceKind || (DeviceKind = {}));
+/**
+ * Prompts the user for permission to use a media input which produces a MediaStream with tracks
+ * containing the requested types of media.
+ *
+ * @param constraints - A MediaStreamConstraints object specifying the types of media to request,
+ *     along with any requirements for each type.
+ * @returns A Promise whose fulfillment handler receives a MediaStream object when the requested
+ *     media has successfully been obtained.
+ */
+function getUserMedia(constraints) {
+  return __awaiter$1(this, void 0, void 0, function* () {
+    return navigator.mediaDevices.getUserMedia(constraints);
+  });
+}
+/**
+ * Prompts the user for permission to use a user's display media and audio. If a video track is
+ * absent from the constraints argument, one will still be provided.
+ *
+ * @param constraints - A MediaStreamConstraints object specifying the types of media to request,
+ *     along with any requirements for each type.
+ * @returns A Promise whose fulfillment handler receives a MediaStream object when the requested
+ *     media has successfully been obtained.
+ */
+function getDisplayMedia(constraints) {
+  return navigator.mediaDevices.getDisplayMedia(constraints);
+}
+/**
+ * Requests a list of the available media input and output devices, such as microphones, cameras,
+ * headsets, and so forth.
+ *
+ * @returns A Promise that receives an array of MediaDeviceInfo objects when the promise is
+ *     fulfilled.
+ */
+function enumerateDevices() {
+  return __awaiter$1(this, void 0, void 0, function* () {
+    return navigator.mediaDevices.enumerateDevices();
+  });
+}
+/**
+ * Adds the callback handler to be notified of a media device change (for example, a headset is
+ * unplugged from the user's computer).
+ *
+ * @param handler - The callback function to execute.
+ */
+function setOnDeviceChangeHandler$1(handler) {
+  navigator.mediaDevices.ondevicechange = handler;
+}
+/**
+ * Checks permissions using the navigator's permissions api.
+ *
+ * @param deviceKinds - Array of DeviceKind items.
+ * @throws An error if camera or microphone aren't available options for query() (Firefox), or if
+ *    navigator.permissions is undefined (Safari and others).
+ * @returns Array of Permission Status objects.
+ */
+function checkNavigatorPermissions(deviceKinds) {
+  return __awaiter$1(this, void 0, void 0, function* () {
+    var permissionRequests = [];
+    if (deviceKinds.includes(DeviceKind.VideoInput)) {
+      permissionRequests.push(navigator.permissions.query({
+        name: 'camera'
+      }));
+    }
+    if (deviceKinds.includes(DeviceKind.AudioInput)) {
+      permissionRequests.push(navigator.permissions.query({
+        name: 'microphone'
+      }));
+    }
+    return Promise.all(permissionRequests);
+  });
+}
+/**
+ * Check to see if the user has granted the application permission to use their devices.
+ *
+ * @param deviceKinds - Array of DeviceKind items.
+ * @returns True if device permissions exist, false if otherwise.
+ */
+function checkDevicePermissions(deviceKinds) {
+  return __awaiter$1(this, void 0, void 0, function* () {
+    try {
+      var permissions = yield checkNavigatorPermissions(deviceKinds);
+      if (permissions.every(permission => permission.state === 'granted')) {
+        return true;
+      }
+      // eslint-disable-next-line no-empty
+    } catch (e) {}
+    try {
+      var devices = yield enumerateDevices();
+      // If permissions are granted, the MediaDeviceInfo objects will have labels.
+      return devices.filter(device => deviceKinds.includes(device.kind)).every(device => device.label);
+      // eslint-disable-next-line no-empty
+    } catch (e) {}
+    return false;
+  });
+}
+/**
+ * Ensures that the user has granted permissions to the microphone and camera.
+ *
+ * @param deviceKinds - Array of DeviceKind items.
+ * @param callback - Function that will be executed while device permissions are granted. After this
+ *    returns, permissions (for example device labels in Firefox) may not be available anymore.
+ * @returns The callback's response.
+ */
+function ensureDevicePermissions(deviceKinds, callback) {
+  return __awaiter$1(this, void 0, void 0, function* () {
+    try {
+      var hasDevicePermissions = yield checkDevicePermissions(deviceKinds);
+      if (!hasDevicePermissions) {
+        var stream = yield getUserMedia({
+          audio: deviceKinds.includes(DeviceKind.AudioInput),
+          video: deviceKinds.includes(DeviceKind.VideoInput)
+        });
+        // Callback is here to call a function while an active capture exists, so that the browser
+        // (Firefox) will allow the user to access device information.
+        var callbackRes = yield callback();
+        // Stop tracks in the stream so the browser (Safari) will know that there is not an active
+        // stream running.
+        stream.getTracks().forEach(track => track.stop());
+        return callbackRes;
+      }
+      return callback();
+    } catch (e) {
+      logger$3.error(e);
+      throw new Error('Failed to ensure device permissions.');
+    }
+  });
+}
+var media = /*#__PURE__*/Object.freeze({
+  __proto__: null,
+  get DeviceKind() {
+    return DeviceKind;
+  },
+  getUserMedia: getUserMedia,
+  getDisplayMedia: getDisplayMedia,
+  enumerateDevices: enumerateDevices,
+  setOnDeviceChangeHandler: setOnDeviceChangeHandler$1,
+  checkDevicePermissions: checkDevicePermissions,
+  ensureDevicePermissions: ensureDevicePermissions
+});
+var ErrorTypes;
+(function (ErrorTypes) {
+  ErrorTypes["DEVICE_PERMISSION_DENIED"] = "DEVICE_PERMISSION_DENIED";
+  ErrorTypes["CREATE_CAMERA_TRACK_FAILED"] = "CREATE_CAMERA_TRACK_FAILED";
+  ErrorTypes["CREATE_MICROPHONE_TRACK_FAILED"] = "CREATE_MICROPHONE_TRACK_FAILED";
+})(ErrorTypes || (ErrorTypes = {}));
+/**
+ * Represents a WCME error, which contains error type and error message.
+ */
+class WcmeError {
+  /**
+   * Creates new error.
+   *
+   * @param type - Error type.
+   * @param message - Error message.
+   */
+  constructor(type) {
+    var message = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : '';
+    this.type = type;
+    this.message = message;
+  }
+}
+/**
+ * Creates a camera video track. Please note that the constraint params in second getUserMedia call would NOT take effect when:
+ *
+ * 1. Previous captured video track from the same device is not stopped .
+ * 2. Previous createCameraTrack() call for the same device is in progress.
+ *
+ * @param constructor - Constructor for the local camera track.
+ * @param constraints - Video device constraints.
+ * @returns A LocalTrack object or an error.
+ */
+function createCameraTrack(constructor, constraints) {
+  return __awaiter$1(this, void 0, void 0, function* () {
+    var stream;
+    try {
+      stream = yield getUserMedia({
+        video: Object.assign({}, constraints)
+      });
+    } catch (error) {
+      throw new WcmeError(ErrorTypes.CREATE_CAMERA_TRACK_FAILED, "Failed to create camera track ".concat(error));
+    }
+    return new constructor(stream);
+  });
+}
+/**
+ * Creates a microphone audio track.
+ *
+ * @param constructor - Constructor for the local microphone track.
+ * @param constraints - Audio device constraints.
+ * @returns A LocalTrack object or an error.
+ */
+function createMicrophoneTrack(constructor, constraints) {
+  return __awaiter$1(this, void 0, void 0, function* () {
+    var stream;
+    try {
+      stream = yield getUserMedia({
+        audio: Object.assign({}, constraints)
+      });
+    } catch (error) {
+      throw new WcmeError(ErrorTypes.CREATE_MICROPHONE_TRACK_FAILED, "Failed to create microphone track ".concat(error));
+    }
+    return new constructor(stream);
+  });
+}
+/**
+ * Creates a display video track.
+ *
+ * @param constructor - Constructor for the local display track.
+ * @returns A Promise that resolves to a LocalDisplayTrack.
+ */
+function createDisplayTrack(constructor) {
+  return __awaiter$1(this, void 0, void 0, function* () {
+    var stream = yield getDisplayMedia({
+      video: true
+    });
+    return new constructor(stream);
+  });
+}
+/**
+ * Enumerates the media input and output devices available.
+ *
+ * @param deviceKind - Optional filter to return a specific device kind.
+ * @returns List of media devices in an array of MediaDeviceInfo objects.
+ */
+function getDevices(deviceKind) {
+  return __awaiter$1(this, void 0, void 0, function* () {
+    var devices;
+    try {
+      devices = yield ensureDevicePermissions([DeviceKind.AudioInput, DeviceKind.VideoInput], enumerateDevices);
+    } catch (error) {
+      throw new WcmeError(ErrorTypes.DEVICE_PERMISSION_DENIED, 'Failed to ensure device permissions');
+    }
+    return devices.filter(v => deviceKind ? v.kind === deviceKind : true);
+  });
+}
+/**
+ * Helper function to get a list of microphone devices.
+ *
+ * @returns List of microphone devices in an array of MediaDeviceInfo objects.
+ */
+function getAudioInputDevices() {
+  return __awaiter$1(this, void 0, void 0, function* () {
+    return getDevices(DeviceKind.AudioInput);
+  });
+}
+/**
+ * Helper function to get a list of speaker devices.
+ *
+ * @returns List of speaker devices in an array of MediaDeviceInfo objects.
+ */
+function getAudioOutputDevices() {
+  return __awaiter$1(this, void 0, void 0, function* () {
+    return getDevices(DeviceKind.AudioOutput);
+  });
+}
+/**
+ * Helper function to get a list of camera devices.
+ *
+ * @returns List of camera devices in an array of MediaDeviceInfo objects.
+ */
+function getVideoInputDevices() {
+  return __awaiter$1(this, void 0, void 0, function* () {
+    return getDevices(DeviceKind.VideoInput);
+  });
+}
+/**
+ * Export the setOnDeviceChangeHandler method directly from the core lib.
+ */
+var {
+  setOnDeviceChangeHandler
+} = media;
 var events$1 = {
   exports: {}
 };
@@ -5207,12 +5478,6 @@ class LocalDisplayTrack extends LocalTrack {}
  * Represents a local track for a microphone source.
  */
 class LocalMicrophoneTrack extends LocalTrack {}
-var ErrorTypes;
-(function (ErrorTypes) {
-  ErrorTypes["DEVICE_PERMISSION_DENIED"] = "DEVICE_PERMISSION_DENIED";
-  ErrorTypes["CREATE_CAMERA_TRACK_FAILED"] = "CREATE_CAMERA_TRACK_FAILED";
-  ErrorTypes["CREATE_MICROPHONE_TRACK_FAILED"] = "CREATE_MICROPHONE_TRACK_FAILED";
-})(ErrorTypes || (ErrorTypes = {}));
 
 // Overall connection state (based on the ICE and DTLS connection states)
 var ConnectionState;
@@ -14427,7 +14692,7 @@ class MultistreamConnection extends EventEmitter {
               state: 'invalid source',
               csi: sendTransceiver.csi
             });
-          } else if (signaler.getEncodingIndexForStreamId(id) > activeSimulcastLayerNumber) {
+          } else if (signaler.getEncodingIndexForStreamId(id) >= activeSimulcastLayerNumber) {
             sourceWarnings.push({
               id,
               state: 'no source',
@@ -14910,7 +15175,7 @@ class MultistreamConnection extends EventEmitter {
   }
   renewPeerConnection(userOptions) {
     if (userOptions) {
-      this.options = Object.assign(Object.assign({}, defaultMultistreamConnectionOptions), userOptions);
+      this.options = Object.assign(Object.assign({}, this.options), userOptions);
     }
     logger$4.info("Renewing multistream connection with options ".concat(JSON.stringify(this.options)));
     this.clearMids();
@@ -24183,4 +24448,4 @@ var Media = {
   isBrowserSupported
 };
 
-export { ActiveSpeakerInfo, CodecInfo, ConnectionState, ErrorType, Errors, Event$1 as Event, H264Codec, LocalCameraTrack, LocalDisplayTrack, LocalMicrophoneTrack, LocalTrack, LocalTrackEvents, Media, MediaFamily, MediaRequest, MediaType, MultistreamRoapMediaConnection, Policy, ReceiveSlot, ReceiveSlotEvents, ReceiverSelectedInfo, RemoteTrackType, RoapMediaConnection, getErrorDescription, getLogger, getMediaFamily, isBrowserSupported, setLogger };
+export { ActiveSpeakerInfo, CodecInfo, ConnectionState, ErrorType, Errors, Event$1 as Event, H264Codec, LocalCameraTrack, LocalDisplayTrack, LocalMicrophoneTrack, LocalTrack, LocalTrackEvents, Media, MediaFamily, MediaRequest, MediaStreamTrackKind, MediaType, MultistreamRoapMediaConnection, PeerConnection, Policy, ReceiveSlot, ReceiveSlotEvents, ReceiverSelectedInfo, RemoteTrackType, RoapMediaConnection, WcmeError, createCameraTrack, createDisplayTrack, createMicrophoneTrack, getAudioInputDevices, getAudioOutputDevices, getDevices, getErrorDescription, getLogger, getMediaFamily, getVideoInputDevices, isBrowserSupported, setLogger, setOnDeviceChangeHandler };

package/dist/types/MediaConnection/MultistreamRoapMediaConnection.d.ts

@@ -4,7 +4,7 @@ import { LocalTrack, MediaRequest, ReceiveSlot, TransceiverStats } from '@webex/
 import { MediaType } from '@webex/json-multistream';
 import { ConnectionState, RoapMessage } from './eventTypes';
 import { MultistreamConnectionConfig } from './config';
-export { LocalCameraTrack, LocalDisplayTrack, LocalMicrophoneTrack, LocalTrack, LocalTrackEvents, MediaRequest, ReceiveSlot, ReceiveSlotEvents, } from '@webex/web-client-media-engine';
+export { MediaRequest, ReceiveSlot, ReceiveSlotEvents, getAudioOutputDevices, getVideoInputDevices, setOnDeviceChangeHandler, WcmeError, AudioDeviceConstraints, VideoDeviceConstraints, LocalTrackEvents, TrackPublishEvent, TrackMuteEvent, TrackEndEvent, LocalCameraTrack, LocalDisplayTrack, LocalMicrophoneTrack, LocalTrack, MediaStreamTrackKind, PeerConnection, createCameraTrack, createDisplayTrack, createMicrophoneTrack, getDevices, getAudioInputDevices, } from '@webex/web-client-media-engine';
 export { ActiveSpeakerInfo, CodecInfo, getMediaFamily, H264Codec, MediaFamily, MediaType, SourceState, Policy, PolicySpecificInfo, ReceiverSelectedInfo, } from '@webex/json-multistream';
 export declare class MultistreamRoapMediaConnection extends EventEmitter {
     private id?;

package/dist/types/MediaConnection/MultistreamRoapMediaConnection.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MultistreamRoapMediaConnection.d.ts","sourceRoot":"","sources":["../../../src/MediaConnection/MultistreamRoapMediaConnection.ts"],"names":[],"mappings":";AAAA,OAAO,YAAY,MAAM,QAAQ,CAAC;AAElC,OAAO,EAEL,UAAU,EACV,YAAY,EAGZ,WAAW,EACX,gBAAgB,EACjB,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAA6C,SAAS,EAAC,MAAM,yBAAyB,CAAC;AAG9F,OAAO,EAAQ,eAAe,EAAE,WAAW,EAAmB,MAAM,cAAc,CAAC;AAKnF,OAAO,EAAC,2BAA2B,EAAC,MAAM,UAAU,CAAC;AAGrD,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,oBAAoB,EACpB,UAAU,EACV,gBAAgB,EAChB,YAAY,EACZ,WAAW,EACX,iBAAiB,GAClB,MAAM,gCAAgC,CAAC;AAExC,OAAO,EACL,iBAAiB,EACjB,SAAS,EACT,cAAc,EACd,SAAS,EACT,WAAW,EACX,SAAS,EACT,WAAW,EACX,MAAM,EACN,kBAAkB,EAClB,oBAAoB,GACrB,MAAM,yBAAyB,CAAC;AAGjC,qBAAa,8BAA+B,SAAQ,YAAY;IAC9D,OAAO,CAAC,EAAE,CAAC,CAAS;IAEpB,OAAO,CAAC,OAAO,CAAC,CAAS;IAEzB,OAAO,CAAC,qBAAqB,CAAwB;IAErD,OAAO,CAAC,IAAI,CAAO;IAEnB,OAAO,CAAC,qBAAqB,CAAS;gBAS1B,qBAAqB,EAAE,2BAA2B,EAAE,OAAO,CAAC,EAAE,MAAM;IAehF,OAAO,CAAC,mBAAmB;IAqC3B,OAAO,CAAC,GAAG;IAIX,OAAO,CAAC,KAAK;IAIb,OAAO,CAAC,2BAA2B;IAyCnC,OAAO,CAAC,UAAU;IA4BX,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;IAiB9B,KAAK,IAAI,IAAI;IAOpB,OAAO,CAAC,oBAAoB;IAK5B,OAAO,CAAC,eAAe;IAiBhB,SAAS,CAAC,UAAU,EAAE,YAAY,EAAE,EAAE,aAAa,UAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IA2B1E,kBAAkB,IAAI,eAAe;IAWrC,QAAQ,IAAI,OAAO,CAAC,cAAc,CAAC;IAOnC,mBAAmB,IAAI,OAAO,CAAC,gBAAgB,CAAC;IAShD,mBAAmB,CAAC,WAAW,EAAE,WAAW,GAAG,IAAI;IAanD,sBAAsB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAYvD,YAAY,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAM9C,cAAc,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAMhD,iBAAiB,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,WAAW,CAAC;IAM7D,YAAY,CAAC,SAAS,EAAE,SAAS,EAAE,aAAa,EAAE,YAAY,EAAE,GAAG,IAAI;IAM9E,OAAO,CAAC,gBAAgB;IAkBxB,OAAO,CAAC,iBAAiB;IAKzB,OAAO,CAAC,kBAAkB;CAkB3B"}
+{"version":3,"file":"MultistreamRoapMediaConnection.d.ts","sourceRoot":"","sources":["../../../src/MediaConnection/MultistreamRoapMediaConnection.ts"],"names":[],"mappings":";AAAA,OAAO,YAAY,MAAM,QAAQ,CAAC;AAElC,OAAO,EAEL,UAAU,EACV,YAAY,EAGZ,WAAW,EACX,gBAAgB,EACjB,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAA6C,SAAS,EAAC,MAAM,yBAAyB,CAAC;AAG9F,OAAO,EAAQ,eAAe,EAAE,WAAW,EAAmB,MAAM,cAAc,CAAC;AAKnF,OAAO,EAAC,2BAA2B,EAAC,MAAM,UAAU,CAAC;AAGrD,OAAO,EAEL,YAAY,EACZ,WAAW,EACX,iBAAiB,EAEjB,qBAAqB,EACrB,oBAAoB,EACpB,wBAAwB,EACxB,SAAS,EACT,sBAAsB,EACtB,sBAAsB,EACtB,gBAAgB,EAChB,iBAAiB,EACjB,cAAc,EACd,aAAa,EACb,gBAAgB,EAChB,iBAAiB,EACjB,oBAAoB,EACpB,UAAU,EACV,oBAAoB,EACpB,cAAc,EACd,iBAAiB,EACjB,kBAAkB,EAClB,qBAAqB,EACrB,UAAU,EACV,oBAAoB,GACrB,MAAM,gCAAgC,CAAC;AAExC,OAAO,EACL,iBAAiB,EACjB,SAAS,EACT,cAAc,EACd,SAAS,EACT,WAAW,EACX,SAAS,EACT,WAAW,EACX,MAAM,EACN,kBAAkB,EAClB,oBAAoB,GACrB,MAAM,yBAAyB,CAAC;AAGjC,qBAAa,8BAA+B,SAAQ,YAAY;IAC9D,OAAO,CAAC,EAAE,CAAC,CAAS;IAEpB,OAAO,CAAC,OAAO,CAAC,CAAS;IAEzB,OAAO,CAAC,qBAAqB,CAAwB;IAErD,OAAO,CAAC,IAAI,CAAO;IAEnB,OAAO,CAAC,qBAAqB,CAAS;gBAS1B,qBAAqB,EAAE,2BAA2B,EAAE,OAAO,CAAC,EAAE,MAAM;IAehF,OAAO,CAAC,mBAAmB;IAqC3B,OAAO,CAAC,GAAG;IAIX,OAAO,CAAC,KAAK;IAIb,OAAO,CAAC,2BAA2B;IAyCnC,OAAO,CAAC,UAAU;IA4BX,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;IAiB9B,KAAK,IAAI,IAAI;IAOpB,OAAO,CAAC,oBAAoB;IAK5B,OAAO,CAAC,eAAe;IAiBhB,SAAS,CAAC,UAAU,EAAE,YAAY,EAAE,EAAE,aAAa,UAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IA2B1E,kBAAkB,IAAI,eAAe;IAWrC,QAAQ,IAAI,OAAO,CAAC,cAAc,CAAC;IAOnC,mBAAmB,IAAI,OAAO,CAAC,gBAAgB,CAAC;IAShD,mBAAmB,CAAC,WAAW,EAAE,WAAW,GAAG,IAAI;IAanD,sBAAsB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAYvD,YAAY,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAM9C,cAAc,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAMhD,iBAAiB,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,WAAW,CAAC;IAM7D,YAAY,CAAC,SAAS,EAAE,SAAS,EAAE,aAAa,EAAE,YAAY,EAAE,GAAG,IAAI;IAM9E,OAAO,CAAC,gBAAgB;IAkBxB,OAAO,CAAC,iBAAiB;IAKzB,OAAO,CAAC,kBAAkB;CAkB3B"}

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

@@ -22,5 +22,6 @@ export interface MultistreamConnectionConfig {
     iceServers: Array<RTCIceServer>;
     enableMainAudio: boolean;
     enableMainVideo: boolean;
+    bundlePolicy?: 'max-bundle' | 'max-compat';
 }
 //# sourceMappingURL=config.d.ts.map

package/dist/types/MediaConnection/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/MediaConnection/config.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,gBAAgB;IAC/B,eAAe,CAAC,EAAE,OAAO,CAAoE;IAC7F,gBAAgB,CAAC,EAAE,OAAO,CAAuE;IACjG,kBAAkB,CAAC,EAAE,OAAO,CAAoE;IAChG,eAAe,CAAC,EAAE;QAChB,KAAK,EAAE,MAAM,CAA6E;QAC1F,KAAK,EAAE,MAAM,CAA6E;KAC3F,CAAC;IACF,YAAY,CAAC,EAAE,MAAM,CACmE;IACxF,iBAAiB,CAAC,EAAE,MAAM,CAAqE;IAC/F,aAAa,CAAC,EAAE,OAAO,CACkC;IACzD,UAAU,CAAC,EAAE,OAAO,CAC4C;IAChE,SAAS,CAAC,EAAE,MAAM,CAEkD;CACrE;AAED,MAAM,WAAW,qBAAqB;IAEpC,UAAU,EAAE,KAAK,CAAC,YAAY,CAAC,CAAC;IAChC,wBAAwB,EAAE,OAAO,CAmBM;IACvC,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,UAAU,EAAE,gBAAgB,CAAC;CAC9B;AAED,MAAM,WAAW,2BAA2B;IAC1C,UAAU,EAAE,KAAK,CAAC,YAAY,CAAC,CAAC;IAChC,eAAe,EAAE,OAAO,CAAC;IACzB,eAAe,EAAE,OAAO,CAAC;CAC1B"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/MediaConnection/config.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,gBAAgB;IAC/B,eAAe,CAAC,EAAE,OAAO,CAAoE;IAC7F,gBAAgB,CAAC,EAAE,OAAO,CAAuE;IACjG,kBAAkB,CAAC,EAAE,OAAO,CAAoE;IAChG,eAAe,CAAC,EAAE;QAChB,KAAK,EAAE,MAAM,CAA6E;QAC1F,KAAK,EAAE,MAAM,CAA6E;KAC3F,CAAC;IACF,YAAY,CAAC,EAAE,MAAM,CACmE;IACxF,iBAAiB,CAAC,EAAE,MAAM,CAAqE;IAC/F,aAAa,CAAC,EAAE,OAAO,CACkC;IACzD,UAAU,CAAC,EAAE,OAAO,CAC4C;IAChE,SAAS,CAAC,EAAE,MAAM,CAEkD;CACrE;AAED,MAAM,WAAW,qBAAqB;IAEpC,UAAU,EAAE,KAAK,CAAC,YAAY,CAAC,CAAC;IAChC,wBAAwB,EAAE,OAAO,CAmBM;IACvC,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,UAAU,EAAE,gBAAgB,CAAC;CAC9B;AAED,MAAM,WAAW,2BAA2B;IAC1C,UAAU,EAAE,KAAK,CAAC,YAAY,CAAC,CAAC;IAChC,eAAe,EAAE,OAAO,CAAC;IACzB,eAAe,EAAE,OAAO,CAAC;IACzB,YAAY,CAAC,EAAE,YAAY,GAAG,YAAY,CAAC;CAC5C"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@webex/internal-media-core",
-  "version": "1.35.4",
+  "version": "1.35.6",
   "files": [
     "dist/cjs",
     "dist/esm",
@@ -47,7 +47,7 @@
     "@babel/runtime": "^7.18.9",
     "@webex/json-multistream": "1.20.2",
     "@webex/ts-sdp": "1.3.2",
-    "@webex/web-client-media-engine": "1.40.2",
+    "@webex/web-client-media-engine": "1.40.4",
     "detectrtc": "^1.4.1",
     "events": "^3.3.0",
     "typed-emitter": "^2.1.0",