@pexip/media-control 21.0.0 → 22.1.0

package/CHANGELOG.md

@@ -1,5 +1,30 @@
 # Changelog
 
+## 22.1.0
+
+### Patch Changes
+
+- a9456de: Increase performance when tracking tracks and device changes.
+- Updated dependencies [44ad859]
+- Updated dependencies [514c523]
+  - @pexip/utils@17.4.0
+
+## 22.0.0
+
+### Major Changes
+
+- 498ff3b: - **`extractConstraints` newly exported**
+  - **`videoSegmentationModel`** removed from `EXTENDED_CONSTRAIN_STRING_KEYS`
+    and `InputConstraintSet`.
+
+### Patch Changes
+
+- fb41d4d: Changes related to Typescript V6 Upgrade
+- Updated dependencies [498ff3b]
+- Updated dependencies [fb41d4d]
+- Updated dependencies [b99c070]
+  - @pexip/utils@17.3.0
+
 ## 21.0.0
 
 ### Minor Changes

package/api-docs/README.mdx

@@ -319,6 +319,7 @@ which devices are delivered, fail, or exist.
 | [getFacingModeFromConstraintString](functions/getFacingModeFromConstraintString.mdx) | - |
 | [resolveMediaDeviceConstraints](functions/resolveMediaDeviceConstraints.mdx) | Resolve *constraints* and mediaTrackConstraints by checking the type and try to return the best possible from mediaTrackConstraints. |
 | [applyConstraints](functions/applyConstraints.mdx) | Call applyConstraints foreach track accordingly |
+| [extractConstraints](functions/extractConstraints.mdx) | - |
 | [extractConstraintsWithKeys](functions/extractConstraintsWithKeys.mdx) | Extract the constraints with provided keys |
 | [findDeviceFromConstraints](functions/findDeviceFromConstraints.mdx) | Find device from the device list with provided constraints |
 | [relaxInputConstraint](functions/relaxInputConstraint.mdx) | Relax input constraints to enable looking up the device by `deviceId` as well as `label` as a fallback as a best effort to get a similar device when possible. If the the device is found we will use the `exact` constraint otherwise we will use the `ideal`. |

package/api-docs/functions/applyConstraints.mdx

@@ -8,9 +8,9 @@ Call applyConstraints foreach track accordingly
 
 | Parameter | Type | Description |
 | ------ | ------ | ------ |
-| `tracks` | `MediaStreamTrack`[] \| `undefined` | Tracks to be applied |
+| `tracks` | `MediaStreamTrack[] \| undefined` | Tracks to be applied |
 | `constraints` | [`MediaDeviceRequest`](../interfaces/MediaDeviceRequest.mdx) | constraints to be applied |
 
 ## Returns
 
-`Promise`\<`void`\>
+`Promise<void>`

package/api-docs/functions/areMultipleFacingModeSupported.mdx

@@ -10,7 +10,7 @@ device label and the API `getSupportedConstraints`
 | Parameter | Type | Description |
 | ------ | ------ | ------ |
 | `currentDevices` | [`MediaDeviceInfoLike`](../type-aliases/MediaDeviceInfoLike.mdx)[] | Current list of devices available |
-| `getSupportedConstraints` | () => `MediaTrackSupportedConstraints` | A function to get supported constraints, i.e. `navigator.mediaDevices.getSupportedConstraints()` |
+| `getSupportedConstraints` | `() => MediaTrackSupportedConstraints` | A function to get supported constraints, i.e. `navigator.mediaDevices.getSupportedConstraints()` |
 
 ## Returns
 

package/api-docs/functions/areTracksEnabled.mdx

@@ -8,8 +8,8 @@ function areTracksEnabled(stream, type): boolean;
 
 | Parameter | Type |
 | ------ | ------ |
-| `stream` | `MediaStream` \| `undefined` |
-| `type` | `"audio"` \| `"video"` |
+| `stream` | `MediaStream \| undefined` |
+| `type` | `"audio" \| "video"` |
 
 ## Returns
 

package/api-docs/functions/compareDevices.mdx

@@ -9,7 +9,7 @@ function compareDevices(deviceInfo, key): (anotherDeviceInfo) => boolean;
 | Parameter | Type | Default value |
 | ------ | ------ | ------ |
 | `deviceInfo` | [`MediaDeviceInfoLike`](../type-aliases/MediaDeviceInfoLike.mdx) | `undefined` |
-| `key` | `"toJSON"` \| `"deviceId"` \| `"groupId"` \| `"label"` | `'deviceId'` |
+| `key` | `"toJSON" \| "deviceId" \| "groupId" \| "label"` | `'deviceId'` |
 
 ## Returns
 

package/api-docs/functions/createTrackDevicesChanges.mdx

@@ -6,7 +6,7 @@ function createTrackDevicesChanges(prevDevices): (devices) => object;
 
 | Parameter | Type | Default value |
 | ------ | ------ | ------ |
-| `prevDevices` | [`MediaDeviceInfoLike`](../type-aliases/MediaDeviceInfoLike.mdx)[] | `[]` |
+| `prevDevices` | [`MediaDeviceInfoLike`](../type-aliases/MediaDeviceInfoLike.mdx)[] | []`` |
 
 ## Returns
 

package/api-docs/functions/deviceChanged.mdx

@@ -8,7 +8,7 @@ function deviceChanged(fn): () => void;
 
 | Parameter | Type |
 | ------ | ------ |
-| `fn` | (`event`) => `void` |
+| `fn` | `(event) => void` |
 
 ## Returns
 

package/api-docs/functions/extractConstrainDevice.mdx

@@ -7,8 +7,10 @@ function extractConstrainDevice(constraints, initialParam): ConstrainNoneTuple |
 | Parameter | Type | Default value |
 | ------ | ------ | ------ |
 | `constraints` | \| [`InputDeviceConstraint`](../type-aliases/InputDeviceConstraint.mdx) \| `undefined` | `undefined` |
-| `initialParam` | `"exact"` \| `"ideal"` | `'ideal'` |
+| `initialParam` | `"exact" \| "ideal"` | `'ideal'` |
 
 ## Returns
 
-`ConstrainNoneTuple` \| `ConstrainDeviceTuple`
+```ts
+ConstrainNoneTuple | ConstrainDeviceTuple
+```

package/api-docs/functions/extractConstraints.mdx

@@ -0,0 +1,87 @@
+## Call Signature
+
+```ts
+function extractConstraints<T>(key): ExtractConstraintFn<ConstrainDeviceTuple>;
+```
+
+### Type Parameters
+
+| Type Parameter |
+| ------ |
+| `T extends "device"` |
+
+### Parameters
+
+| Parameter | Type |
+| ------ | ------ |
+| `key` | `T` |
+
+### Returns
+
+`ExtractConstraintFn<ConstrainDeviceTuple>`
+
+## Call Signature
+
+```ts
+function extractConstraints<T>(key): ExtractConstraintFn<ConstrainStringTuple>;
+```
+
+### Type Parameters
+
+| Type Parameter |
+| ------ |
+| `T extends \| "deviceId" \| "groupId" \| "videoSegmentation" \| "backgroundImageUrl" \| "resizeMode" \| "contentHint" \| "facingMode"` |
+
+### Parameters
+
+| Parameter | Type |
+| ------ | ------ |
+| `key` | `T` |
+
+### Returns
+
+`ExtractConstraintFn<ConstrainStringTuple>`
+
+## Call Signature
+
+```ts
+function extractConstraints<T>(key): ExtractConstraintFn<ConstrainNumberTuple>;
+```
+
+### Type Parameters
+
+| Type Parameter |
+| ------ |
+| `T extends ConstrainNumberKeys` |
+
+### Parameters
+
+| Parameter | Type |
+| ------ | ------ |
+| `key` | `T` |
+
+### Returns
+
+`ExtractConstraintFn<ConstrainNumberTuple>`
+
+## Call Signature
+
+```ts
+function extractConstraints<T>(key): ExtractConstraintFn<ConstrainBooleanTuple>;
+```
+
+### Type Parameters
+
+| Type Parameter |
+| ------ |
+| `T extends \| "denoise" \| "vad" \| "asd" \| "mixWithAdditionalMedia" \| "excludeBystanders" \| "pan" \| "tilt" \| "zoom" \| "echoCancellation" \| "autoGainControl" \| "noiseSuppression"` |
+
+### Parameters
+
+| Parameter | Type |
+| ------ | ------ |
+| `key` | `T` |
+
+### Returns
+
+`ExtractConstraintFn<ConstrainBooleanTuple>`

package/api-docs/functions/extractConstraintsWithKeys.mdx

@@ -8,13 +8,13 @@ Extract the constraints with provided keys
 
 | Type Parameter |
 | ------ |
-| `T` *extends* \| `"deviceId"` \| `"groupId"` \| `"device"` \| `"videoSegmentation"` \| `"videoSegmentationModel"` \| `"denoise"` \| `"vad"` \| `"asd"` \| `"mixWithAdditionalMedia"` \| `"backgroundImageUrl"` \| `"excludeBystanders"` \| `"resizeMode"` \| `"pan"` \| `"tilt"` \| `"zoom"` \| `"contentHint"` \| `"facingMode"` \| `"echoCancellation"` \| `"autoGainControl"` \| `"noiseSuppression"` \| `ConstrainNumberKeys` |
+| `T extends \| "deviceId" \| "groupId" \| "device" \| "videoSegmentation" \| "denoise" \| "vad" \| "asd" \| "mixWithAdditionalMedia" \| "backgroundImageUrl" \| "excludeBystanders" \| "resizeMode" \| "pan" \| "tilt" \| "zoom" \| "contentHint" \| "facingMode" \| "echoCancellation" \| "autoGainControl" \| "noiseSuppression" \| ConstrainNumberKeys` |
 
 ## Parameters
 
 | Parameter | Type | Description |
 | ------ | ------ | ------ |
-| `keys` | readonly `T`[] | The keys to be used for the extraction |
+| `keys` | readonly `T[]` | The keys to be used for the extraction |
 
 ## Returns
 
@@ -32,7 +32,7 @@ an object with the provided key and the value-param tuple
 
 ### Returns
 
-`Pick`\<`Constraints`, `T`\>
+`Pick<Constraints, T>`
 
 ## Example
 

package/api-docs/functions/findCurrentVideoInputDeviceIdFromStream.mdx

@@ -12,4 +12,6 @@ function findCurrentVideoInputDeviceIdFromStream(stream): string | undefined;
 
 ## Returns
 
-`string` \| `undefined`
+```ts
+string | undefined
+```

package/api-docs/functions/findDevice.mdx

@@ -29,5 +29,9 @@ function findDevice(deviceToFind, useFallback): (devices) =>
 
 ### Returns
 
-  \| [`MediaDeviceInfoLike`](../type-aliases/MediaDeviceInfoLike.mdx)
-  \| `undefined`
+```ts
+| MediaDeviceInfoLike
+```
+```ts
+| undefined
+```

package/api-docs/functions/findDeviceFromConstraints.mdx

@@ -16,9 +16,15 @@ Find device from the device list with provided constraints
 
 ## Returns
 
-  \| `boolean`
-  \| [`MediaDeviceInfoLike`](../type-aliases/MediaDeviceInfoLike.mdx)
-  \| `undefined`
+```ts
+| boolean
+```
+```ts
+| MediaDeviceInfoLike
+```
+```ts
+| undefined
+```
 
 `true` means it can be any devices, `undefined` means not found,
 otherwise, the matched device will be returned

package/api-docs/functions/findDeviceWithDeviceId.mdx

@@ -15,5 +15,9 @@ function findDeviceWithDeviceId(devices, deviceId):
 
 ## Returns
 
-  \| [`MediaDeviceInfoLike`](../type-aliases/MediaDeviceInfoLike.mdx)
-  \| `undefined`
+```ts
+| MediaDeviceInfoLike
+```
+```ts
+| undefined
+```

package/api-docs/functions/findMediaInputFromMediaStreamTrack.mdx

@@ -28,5 +28,9 @@ function findMediaInputFromMediaStreamTrack(devices): (track?) =>
 
 ### Returns
 
-  \| [`MediaDeviceInfoLike`](../type-aliases/MediaDeviceInfoLike.mdx)
-  \| `undefined`
+```ts
+| MediaDeviceInfoLike
+```
+```ts
+| undefined
+```

package/api-docs/functions/findMediaInputFromStream.mdx

@@ -20,7 +20,7 @@ function findMediaInputFromStream(devices): (stream) => MediaInput;
 
 | Parameter | Type |
 | ------ | ------ |
-| `stream` | `MediaStream` \| `undefined` |
+| `stream` | `MediaStream \| undefined` |
 
 ### Returns
 

package/api-docs/functions/getDevices.mdx

@@ -6,4 +6,6 @@ function getDevices(): Promise<MediaDeviceInfo[]>;
 
 ## Returns
 
-`Promise`\<`MediaDeviceInfo`[]\>
+```ts
+Promise<MediaDeviceInfo[]>
+```

package/api-docs/functions/getFacingModeFromConstraintString.mdx

@@ -10,4 +10,6 @@ function getFacingModeFromConstraintString(constraint): "user" | "environment" |
 
 ## Returns
 
-`"user"` \| `"environment"` \| `"left"` \| `"right"` \| `undefined`
+```ts
+"user" | "environment" | "left" | "right" | undefined
+```

package/api-docs/functions/getInputDevicePermissionState.mdx

@@ -14,8 +14,10 @@ A wrapper for `navigator.permissions.query` with fallback to use
 | ------ | ------ | ------ | ------ |
 | `anyActiveAudioTrack` | `boolean` | `false` | Has ever got an active audio to help the fallback to guess the state more accurately |
 | `anyActiveVideoTrack` | `boolean` | `false` | Has ever got an active video to help the fallback to guess the state more accurately |
-| `getDevices` | () => `Promise`\<`MediaDeviceInfo`[]\> | `...` | A function to get the list of devices, e.g. navigator.mediaDevices.enumerateDevices |
+| `getDevices` | `() => Promise<MediaDeviceInfo[]>` | `...` | A function to get the list of devices, e.g. navigator.mediaDevices.enumerateDevices |
 
 ## Returns
 
-`Promise`\<[`InputDevicePermission`](../interfaces/InputDevicePermission.mdx)\>
+```ts
+Promise<InputDevicePermission>
+```

package/api-docs/functions/hasAnyInputs.mdx

@@ -13,7 +13,9 @@ Check if provided devices have any video and audio inputs
 
 ## Returns
 
-\[`boolean`, `boolean`\]
+```ts
+[boolean, boolean]
+```
 
 A tuple of `[anyAudioInput, anyVideoInput]`, e.g. `[true, false]`
 means there is audio input but no video input

package/api-docs/functions/interpretCurrentFacingMode.mdx

@@ -10,8 +10,10 @@ is not supported from settings
 
 | Parameter | Type | Description |
 | ------ | ------ | ------ |
-| `currentTrack` | `MediaStreamTrack` \| `undefined` | The current video input track |
+| `currentTrack` | `MediaStreamTrack \| undefined` | The current video input track |
 
 ## Returns
 
-`"user"` \| `"environment"` \| `"left"` \| `"right"` \| `undefined`
+```ts
+"user" | "environment" | "left" | "right" | undefined
+```

package/api-docs/functions/isRequestedResolution.mdx

@@ -7,7 +7,7 @@ function isRequestedResolution(request, response): boolean;
 | Parameter | Type |
 | ------ | ------ |
 | `request` | \| [`InputDeviceConstraint`](../type-aliases/InputDeviceConstraint.mdx) \| `undefined` |
-| `response` | `MediaTrackSettings` \| `undefined` |
+| `response` | `MediaTrackSettings \| undefined` |
 
 ## Returns
 

package/api-docs/functions/isStreamingRequestedDevices.mdx

@@ -12,7 +12,7 @@ Check if provided request has already been fulfilled
 | Parameter | Type | Description |
 | ------ | ------ | ------ |
 | `request` | [`MediaDeviceRequest`](../interfaces/MediaDeviceRequest.mdx) | A media request constraints |
-| `stream` | `MediaStream` \| `undefined` | Current media stream |
+| `stream` | `MediaStream \| undefined` | Current media stream |
 | `devices` | [`IndexedDevices`](../interfaces/IndexedDevices.mdx) | - |
 
 ## Returns

package/api-docs/functions/isStreamingRequestedDevicesBase.mdx

@@ -10,9 +10,9 @@ function isStreamingRequestedDevicesBase(
 | Parameter | Type |
 | ------ | ------ |
 | `request` | [`MediaDeviceRequest`](../interfaces/MediaDeviceRequest.mdx) |
-| `tracksOrDevices` | \{ `audio?`: \| [`MediaDeviceInfoLike`](../type-aliases/MediaDeviceInfoLike.mdx) \| `MediaStreamTrack`[]; `video?`: \| [`MediaDeviceInfoLike`](../type-aliases/MediaDeviceInfoLike.mdx) \| `MediaStreamTrack`[]; \} |
-| `tracksOrDevices.audio?` | \| [`MediaDeviceInfoLike`](../type-aliases/MediaDeviceInfoLike.mdx) \| `MediaStreamTrack`[] |
-| `tracksOrDevices.video?` | \| [`MediaDeviceInfoLike`](../type-aliases/MediaDeviceInfoLike.mdx) \| `MediaStreamTrack`[] |
+| `tracksOrDevices` | \{ `audio?`: \| [`MediaDeviceInfoLike`](../type-aliases/MediaDeviceInfoLike.mdx) \| `MediaStreamTrack[]`; `video?`: \| [`MediaDeviceInfoLike`](../type-aliases/MediaDeviceInfoLike.mdx) \| `MediaStreamTrack[]`; \} |
+| `tracksOrDevices.audio?` | \| [`MediaDeviceInfoLike`](../type-aliases/MediaDeviceInfoLike.mdx) \| `MediaStreamTrack[]` |
+| `tracksOrDevices.video?` | \| [`MediaDeviceInfoLike`](../type-aliases/MediaDeviceInfoLike.mdx) \| `MediaStreamTrack[]` |
 | `devices` | [`IndexedDevices`](../interfaces/IndexedDevices.mdx) |
 
 ## Returns

package/api-docs/functions/isStreamingRequestingDevice.mdx

@@ -10,7 +10,7 @@ function isStreamingRequestingDevice(
 | Parameter | Type |
 | ------ | ------ |
 | `request` | \| [`InputDeviceConstraint`](../type-aliases/InputDeviceConstraint.mdx) \| `undefined` |
-| `trackOrDevice` | \| [`MediaDeviceInfoLike`](../type-aliases/MediaDeviceInfoLike.mdx) \| `MediaStreamTrack`[] \| `undefined` |
+| `trackOrDevice` | \| [`MediaDeviceInfoLike`](../type-aliases/MediaDeviceInfoLike.mdx) \| `MediaStreamTrack[]` \| `undefined` |
 | `devices` | [`IndexedDevices`](../interfaces/IndexedDevices.mdx) |
 
 ## Returns

package/api-docs/functions/mergeConstraints.mdx

@@ -30,6 +30,12 @@ Merge base constraints with provided base constraints and another constraints
 
 ### Returns
 
-  \| `boolean`
-  \| [`InputConstraintSet`](../interfaces/InputConstraintSet.mdx)
-  \| `undefined`
+```ts
+| boolean
+```
+```ts
+| InputConstraintSet
+```
+```ts
+| undefined
+```

package/api-docs/functions/muteStreamTrack.mdx

@@ -21,7 +21,7 @@ function muteStreamTrack(stream?): (mute, mediaType) => void;
 | Parameter | Type | Default value |
 | ------ | ------ | ------ |
 | `mute` | `boolean` | `undefined` |
-| `mediaType` | `"audio"` \| `"video"` \| `"all"` | `'all'` |
+| `mediaType` | `"audio" \| "video" \| "all"` | `'all'` |
 
 ### Returns
 

package/api-docs/functions/relaxInputConstraint.mdx

@@ -16,11 +16,15 @@ we will use the `ideal`.
 
 | Parameter | Type | Description |
 | ------ | ------ | ------ |
-| `kind` | `"audioinput"` \| `"videoinput"` | - |
+| `kind` | `"audioinput" \| "videoinput"` | - |
 | `input` | \| [`InputDeviceConstraint`](../type-aliases/InputDeviceConstraint.mdx) \| `undefined` | The input constraints to be relaxed |
 | `devices` | [`IndexedDevices`](../interfaces/IndexedDevices.mdx) | The current device list |
 
 ## Returns
 
-  \| [`InputDeviceConstraint`](../type-aliases/InputDeviceConstraint.mdx)
-  \| `undefined`
+```ts
+| InputDeviceConstraint
+```
+```ts
+| undefined
+```

package/api-docs/functions/resolveMediaDeviceConstraints.mdx

@@ -12,8 +12,10 @@ try to return the best possible from mediaTrackConstraints.
 | Parameter | Type |
 | ------ | ------ |
 | `constraints?` | [`InputDeviceConstraint`](../type-aliases/InputDeviceConstraint.mdx) |
-| `base?` | `boolean` \| `MediaTrackConstraints` |
+| `base?` | `boolean \| MediaTrackConstraints` |
 
 ## Returns
 
-`boolean` \| `MediaTrackConstraints` \| `undefined`
+```ts
+boolean | MediaTrackConstraints | undefined
+```

package/api-docs/functions/stopMediaStream.mdx

@@ -12,8 +12,8 @@ https://developer.mozilla.org/en-US/docs/Web/API/MediaStreamTrack/stop#descripti
 
 | Parameter | Type | Description |
 | ------ | ------ | ------ |
-| `stream` | `MediaStream` \| `undefined` | `MediaStream` which we mutate |
-| `onStopped?` | (`track`) => `void` | callback to be called when the track is stopped |
+| `stream` | `MediaStream \| undefined` | `MediaStream` which we mutate |
+| `onStopped?` | `(track) => void` | callback to be called when the track is stopped |
 
 ## Returns
 

package/api-docs/functions/toKey.mdx

@@ -1,8 +1,8 @@
 ```ts
-function toKey(__namedParameters): string;
+function toKey(__namedParameters): DeviceKey;
 ```
 
-**`Beta`**
+Convert provided info to key for Map
 
 ## Parameters
 
@@ -12,4 +12,4 @@ function toKey(__namedParameters): string;
 
 ## Returns
 
-`string`
+`DeviceKey`

package/api-docs/functions/toMediaDeviceInfoLike.mdx

@@ -14,5 +14,9 @@ function toMediaDeviceInfoLike(track):
 
 ## Returns
 
-  \| [`MediaDeviceInfoLike`](../type-aliases/MediaDeviceInfoLike.mdx)
-  \| `undefined`
+```ts
+| MediaDeviceInfoLike
+```
+```ts
+| undefined
+```

package/api-docs/functions/toMediaDeviceInputKind.mdx

@@ -6,8 +6,10 @@ function toMediaDeviceInputKind(track): "audioinput" | "videoinput";
 
 | Parameter | Type |
 | ------ | ------ |
-| `track` | `Pick`\<`MediaStreamTrack`, `"kind"`\> |
+| `track` | `Pick<MediaStreamTrack, "kind">` |
 
 ## Returns
 
-`"audioinput"` \| `"videoinput"`
+```ts
+"audioinput" | "videoinput"
+```

package/api-docs/interfaces/DisplayMediaOptions.mdx

@@ -14,8 +14,8 @@ returned by `getDisplayMedia`.
 
 | Property | Type | Overrides |
 | ------ | ------ | ------ |
-| <a id="audio"></a> `audio?` | `boolean` \| `DisplayAudioTrackConstraints` | `DisplayMediaStreamOptions.audio` |
-| <a id="video"></a> `video?` | `boolean` \| `DisplayVideoTrackConstraints` | `DisplayMediaStreamOptions.video` |
+| <a id="audio"></a> `audio?` | `boolean \| DisplayAudioTrackConstraints` | `DisplayMediaStreamOptions.audio` |
+| <a id="video"></a> `video?` | `boolean \| DisplayVideoTrackConstraints` | `DisplayMediaStreamOptions.video` |
 | <a id="selfbrowsersurface"></a> `selfBrowserSurface?` | `ConstrainDOMString` | - |
 | <a id="systemaudio"></a> `systemAudio?` | `ConstrainDOMString` | - |
 | <a id="surfaceswitching"></a> `surfaceSwitching?` | `ConstrainDOMString` | - |

package/api-docs/interfaces/IndexedDevices.mdx

@@ -65,8 +65,12 @@ First device of the kind
 
 #### Returns
 
-  \| [`MediaDeviceInfoLike`](../type-aliases/MediaDeviceInfoLike.mdx)
-  \| `undefined`
+```ts
+| MediaDeviceInfoLike
+```
+```ts
+| undefined
+```
 
 ***
 
@@ -78,7 +82,9 @@ toJSON(): Record<MediaDeviceKind, MediaDeviceInfoLike[]>;
 
 #### Returns
 
-`Record`\<`MediaDeviceKind`, [`MediaDeviceInfoLike`](../type-aliases/MediaDeviceInfoLike.mdx)[]\>
+```ts
+Record<MediaDeviceKind, MediaDeviceInfoLike[]>
+```
 
 ***
 

package/api-docs/interfaces/InputConstraintSet.mdx

@@ -6,9 +6,8 @@
 
 | Property | Type | Description | Inherited from |
 | ------ | ------ | ------ | ------ |
-| <a id="device"></a> `device?` | `DeviceConstraint` \| `ConstraintDeviceParameters` | Same purpose as `deviceId` but it gives more information about the device so that we can have extra tolerance on device selection | - |
+| <a id="device"></a> `device?` | `DeviceConstraint \| ConstraintDeviceParameters` | Same purpose as `deviceId` but it gives more information about the device so that we can have extra tolerance on device selection | - |
 | <a id="videosegmentation"></a> `videoSegmentation?` | `ConstrainDOMString` | Whether or not using video segmentation, e.g. background blur/replacement, to specify the effects, intended to be applied to the segment. Available effects are `none`, `blur`, `overlay` or `remove` | - |
-| <a id="videosegmentationmodel"></a> `videoSegmentationModel?` | `ConstrainDOMString` | Segmentation model to be used for video segmentation, currently only supports `mediapipeSelfie` and `personify` | - |
 | <a id="denoise"></a> `denoise?` | `ConstrainBoolean` | Whether or not using our own noise suppression | - |
 | <a id="vad"></a> `vad?` | `ConstrainBoolean` | Voice Activity Detection | - |
 | <a id="asd"></a> `asd?` | `ConstrainBoolean` | Audio Signal Detection for the purpose of checking if the audio input is hardware muted or unusable | - |
@@ -18,7 +17,7 @@
 | <a id="foregroundthreshold"></a> `foregroundThreshold?` | `ConstrainDouble` | Erode level for edge smoothing when using video segmentation | - |
 | <a id="backgroundimageurl"></a> `backgroundImageUrl?` | `ConstrainDOMString` | Image Url that is being used for video overlay effects | - |
 | <a id="maskcombineratio"></a> `maskCombineRatio?` | `ConstrainDouble` | The ratio to be used for smoothing segmentation mask. How much uncertainty enables temporal blend, [0,1]. Higher = more frame-to-frame blending, more stability but more trailing ghosts. Typical: 0.6–0.85. | - |
-| <a id="backgroundthreshold"></a> `backgroundThreshold?` | `ConstrainDouble` | [0,1] Lower mask confidence: all mask pixels <= this are considered definite background. Adjust to make mask edges tighter or more permissive for background inclusion. Example: 0.3 ("mask < 0.3 = sure background"). | - |
+| <a id="backgroundthreshold"></a> `backgroundThreshold?` | `ConstrainDouble` | [0,1] Lower mask confidence: all mask pixels \<= this are considered definite background. Adjust to make mask edges tighter or more permissive for background inclusion. Example: 0.3 ("mask \< 0.3 = sure background"). | - |
 | <a id="sigmaspace"></a> `sigmaSpace?` | `ConstrainDouble` | Bilateral filter: sigma in pixel space for mask edge snapping. Controls the neighborhood/pixel distance—higher is larger window (5–10 typical). | - |
 | <a id="sigmarangelo"></a> `sigmaRangeLo?` | `ConstrainDouble` | Bilateral filter: minimum sigma in color/luma (for mask interiors), [0,1]. Controls how little color difference is needed to cross-mask regions away from edge. Lower = sharper edge preservation in mask interiors. Example: 0.2 | - |
 | <a id="sigmarangehi"></a> `sigmaRangeHi?` | `ConstrainDouble` | Bilateral filter: maximum sigma in color/luma (for mask uncertain zones), [0,1]. Controls how much color similarity is required at uncertain/edge mask locations. Higher = more mask smoothing at edges. Example: 0.8 | - |
@@ -38,15 +37,13 @@
 | <a id="tilt"></a> `tilt?` | `boolean` | - | - |
 | <a id="zoom"></a> `zoom?` | `boolean` | - | - |
 | <a id="contenthint"></a> `contentHint?` | `ConstrainDOMString` | Content Hint for the track to apply | - |
-| <a id="volume"></a> `volume?` | `ConstrainNumber` | - | `MediaTrackConstraints.volume` |
-| <a id="latency"></a> `latency?` | `ConstrainNumber` | - | `MediaTrackConstraints.latency` |
 | <a id="aspectratio"></a> `aspectRatio?` | `ConstrainDouble` | - | `MediaTrackConstraints.aspectRatio` |
 | <a id="autogaincontrol"></a> `autoGainControl?` | `ConstrainBoolean` | - | `MediaTrackConstraints.autoGainControl` |
 | <a id="backgroundblur"></a> `backgroundBlur?` | `ConstrainBoolean` | - | `MediaTrackConstraints.backgroundBlur` |
 | <a id="channelcount"></a> `channelCount?` | `ConstrainULong` | - | `MediaTrackConstraints.channelCount` |
 | <a id="deviceid"></a> `deviceId?` | `ConstrainDOMString` | - | `MediaTrackConstraints.deviceId` |
 | <a id="displaysurface"></a> `displaySurface?` | `ConstrainDOMString` | - | `MediaTrackConstraints.displaySurface` |
-| <a id="echocancellation"></a> `echoCancellation?` | `ConstrainBoolean` | - | `MediaTrackConstraints.echoCancellation` |
+| <a id="echocancellation"></a> `echoCancellation?` | `ConstrainBooleanOrDOMString` | - | `MediaTrackConstraints.echoCancellation` |
 | <a id="facingmode"></a> `facingMode?` | `ConstrainDOMString` | - | `MediaTrackConstraints.facingMode` |
 | <a id="framerate"></a> `frameRate?` | `ConstrainDouble` | - | `MediaTrackConstraints.frameRate` |
 | <a id="groupid"></a> `groupId?` | `ConstrainDOMString` | - | `MediaTrackConstraints.groupId` |
@@ -55,4 +52,4 @@
 | <a id="samplerate"></a> `sampleRate?` | `ConstrainULong` | - | `MediaTrackConstraints.sampleRate` |
 | <a id="samplesize"></a> `sampleSize?` | `ConstrainULong` | - | `MediaTrackConstraints.sampleSize` |
 | <a id="width"></a> `width?` | `ConstrainULong` | - | `MediaTrackConstraints.width` |
-| <a id="advanced"></a> `advanced?` | `MediaTrackConstraintSet`[] | - | `MediaTrackConstraints.advanced` |
+| <a id="advanced"></a> `advanced?` | `MediaTrackConstraintSet[]` | - | `MediaTrackConstraints.advanced` |

package/api-docs/interfaces/MediaControl.mdx

@@ -6,9 +6,9 @@ MediaControl Interface
 
 | Property | Type | Description |
 | ------ | ------ | ------ |
-| <a id="devicechanged"></a> `deviceChanged` | (`fn`) => () => `void` | **`Beta`** Unified interface for subscribing [DeviceChangedChanges](../type-aliases/DeviceChangedChanges.mdx) Event |
-| <a id="getdevices"></a> `getDevices` | () => `Promise`\<`MediaDeviceInfo`[]\> | **`Beta`** Future proofing: in case we want to alter the values or type returned by [enumerateDevices](https://developer.mozilla.org/en-US/docs/Web/API/MediaDevices/enumerateDevices) |
+| <a id="devicechanged"></a> `deviceChanged` | `(fn) => () => void` | **`Beta`** Unified interface for subscribing [DeviceChangedChanges](../type-aliases/DeviceChangedChanges.mdx) Event |
+| <a id="getdevices"></a> `getDevices` | `() => Promise<MediaDeviceInfo[]>` | **`Beta`** Future proofing: in case we want to alter the values or type returned by [enumerateDevices](https://developer.mozilla.org/en-US/docs/Web/API/MediaDevices/enumerateDevices) |
 | <a id="mediaeventtype"></a> `MediaEventType` | *typeof* [`MediaEventType`](../enumerations/MediaEventType.mdx) | **`Beta`** MediaStreamTrack Events **Remarks** See MDN [Events](https://developer.mozilla.org/en-US/docs/Web/API/MediaStreamTrack#Events) |
-| <a id="getusermedia"></a> `getUserMedia` | (`__namedParameters`) => `Promise`\<`MediaStream`\> | **`Beta`** Get MediaStream with provided [input constraints](MediaDeviceRequest.mdx) |
-| <a id="setdefaultconstraints"></a> `setDefaultConstraints` | (`newConstraints`) => `void` | **`Beta`** Set default media stream constraints A [MediaStreamConstraints](https://developer.mozilla.org/en-US/docs/Web/API/MediaStreamConstraints) object specifying the types of media to request, along with any requirements for each type. |
-| <a id="subscribe"></a> `subscribe` | (`listener`) => () => `void` | **`Beta`** Subscribe media events |
+| <a id="getusermedia"></a> `getUserMedia` | `(__namedParameters) => Promise<MediaStream>` | **`Beta`** Get MediaStream with provided [input constraints](MediaDeviceRequest.mdx) |
+| <a id="setdefaultconstraints"></a> `setDefaultConstraints` | `(newConstraints) => void` | **`Beta`** Set default media stream constraints A [MediaStreamConstraints](https://developer.mozilla.org/en-US/docs/Web/API/MediaStreamConstraints) object specifying the types of media to request, along with any requirements for each type. |
+| <a id="subscribe"></a> `subscribe` | `(listener) => () => void` | **`Beta`** Subscribe media events |

package/api-docs/type-aliases/MediaDeviceInfoLike.mdx

@@ -10,4 +10,4 @@ A striped version of MediaDeviceInfo
 
 | Name | Type |
 | ------ | ------ |
-| `toJSON?` | `MediaDeviceInfo`\[`"toJSON"`\] |
+| `toJSON?` | `MediaDeviceInfo["toJSON"]` |

package/api-docs/variables/getUserMedia.mdx

@@ -16,6 +16,6 @@ Get MediaStream with MediaDeviceRequest
 
 ## Returns
 
-`Promise`\<`MediaStream`\>
+`Promise<MediaStream>`
 
 MediaStream

package/api-docs/variables/subscribe.mdx

@@ -12,7 +12,7 @@ Subscription media events
 
 | Parameter | Type |
 | ------ | ------ |
-| `listener` | (`event`) => `void` |
+| `listener` | `(event) => void` |
 
 ## Returns
 

package/dist/constraints.js

@@ -213,7 +213,6 @@ export const extractConstrainBoolean = (key) => (constraints) => {
     return NONE;
 };
 export const extractConstrainNumber = (key) => (constraints) => {
-    // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment -- @typescript-eslint and Typescript 5 issue.
     const constraint = constraints[key];
     if (constraint === undefined || constraint === null) {
         return NONE;

package/dist/devices.d.ts

@@ -18,12 +18,14 @@ interface ToKeyOptions {
     kind: string;
     label: string;
 }
+export type DeviceKey = string & {
+    __type: 'track-key';
+};
 /**
  * Convert provided info to key for Map
  *
- * @beta
  */
-export declare const toKey: ({ id, kind, label }: ToKeyOptions) => string;
+export declare const toKey: ({ id, kind, label }: ToKeyOptions) => DeviceKey;
 export declare const toMediaDeviceInputKind: (track: Pick<MediaStreamTrack, "kind">) => "audioinput" | "videoinput";
 /**
  * Future proofing: in case we want to alter the values or type returned
@@ -43,8 +45,8 @@ export declare const toMediaDeviceInputKind: (track: Pick<MediaStreamTrack, "kin
  * @beta
  */
 export declare const getDevices: () => Promise<MediaDeviceInfo[]>;
-export declare const toDeviceKey: (device: MediaDeviceInfoLike) => string;
-export declare const toDeviceTuple: (device: MediaDeviceInfoLike) => readonly [string, MediaDeviceInfoLike];
+export declare const toDeviceKey: (device: MediaDeviceInfoLike) => DeviceKey;
+export declare const toDeviceTuple: (device: MediaDeviceInfoLike) => readonly [DeviceKey, MediaDeviceInfoLike];
 export declare const toDevicesMap: (devices: MediaDeviceInfoLike[]) => Map<string, MediaDeviceInfoLike>;
 export declare const createTrackDevicesChanges: (prevDevices?: MediaDeviceInfoLike[]) => (devices: MediaDeviceInfoLike[]) => {
     found: MediaDeviceInfoLike[];

package/dist/devices.js

@@ -7,7 +7,6 @@ import { DEVICE_ID_SEPARATOR } from './constants';
 /**
  * Convert provided info to key for Map
  *
- * @beta
  */
 export const toKey = ({ id, kind, label }) => [kind, id, label].join(DEVICE_ID_SEPARATOR);
 export const toMediaDeviceInputKind = (track) => {
@@ -441,7 +440,6 @@ export const queryPermissionFallback = async (name, everActiveTrack = false, get
 };
 export const queryPermission = async (name, everActiveTrack = false, getDevices = () => navigator.mediaDevices.enumerateDevices()) => {
     try {
-        // @ts-expect-error -- Typings/dom.d.ts change blocks upgrade to typescript 4.4
         const { state } = await navigator.permissions.query({ name });
         // Firefox v133 added permission API but always returns granted but
         // based on the device label, it is actually not granted, so we need to

package/dist/index.d.ts

@@ -9,7 +9,7 @@
  */
 import { DeviceChangedChanges, areMultipleFacingModeSupported, areTracksEnabled, createTrackDevicesChanges, deviceChanged, findAudioInputDevices, findAudioOutputDevices, findCurrentAudioOutputId, findCurrentVideoInputDeviceIdFromStream, findDeviceWithDeviceId, findDevicesByKind, findMediaInputFromMediaStreamTrack, findMediaInputFromStream, findPermissionGrantedDevices, findVideoInputDevices, getDevices, getInputDevicePermissionState, hasAnyGrantedInput, hasAnyInputs, hasAudioInputs, hasAudioOrVideoInputs, hasChangedInput, hasRequestingDevice, hasVideoInputs, interpretCurrentFacingMode, isRequestedInputDevice, isRequestedInputTrack, isRequestedResolution, isStreamingRequestedDevices, isStreamingRequestedDevicesBase, isStreamingRequestingDevice, isTrackMutedOrEnded, muteStreamTrack, shouldRequestDevice, stopMediaStream, toKey, toMediaDeviceInfo, toMediaDeviceInfoLike, toMediaDeviceInputKind } from './devices';
 import { compareDevices, createIndexedDevices, findDevice, getDeviceId, isAudioInput, isAudioOutput, isDeviceGranted, isVideoInput, reverseDeviceId } from './utils';
-import { applyConstraints, extractConstrainDevice, extractConstraintsWithKeys, findDeviceFromConstraints, getFacingModeFromConstraintString, getValueFromConstrainNumber, isExactDeviceConstraint, mergeConstraints, relaxInputConstraint, resolveMediaDeviceConstraints } from './constraints';
+import { applyConstraints, extractConstrainDevice, extractConstraints, extractConstraintsWithKeys, findDeviceFromConstraints, getFacingModeFromConstraintString, getValueFromConstrainNumber, isExactDeviceConstraint, mergeConstraints, relaxInputConstraint, resolveMediaDeviceConstraints } from './constraints';
 import { MediaEvent, Events, MediaEventType } from './eventEmitter';
 import { createStreamTrackEventSubscriptions } from './streams';
 import { DisplayMediaOptions, FacingMode, IndexedDevices, InputConstraintSet, InputDeviceConstraint, MediaDeviceFailure, MediaDeviceInfoLike, MediaDeviceKinds, MediaDeviceRequest, MediaInput, MediaStreamTrackLike, StreamTrackEventHandlers, Unsubscribe } from './types';
@@ -33,7 +33,7 @@ setDefaultConstraints: (newConstraints: MediaStreamConstraints) => void,
  */
 subscribe: (listener: (event: MediaEvent) => void) => () => void;
 export { getUserMedia, setDefaultConstraints, subscribe };
-export { DeviceChangedChanges, DisplayMediaOptions, Events, FacingMode, IndexedDevices, InputConstraintSet, InputDeviceConstraint, MediaDeviceFailure, MediaDeviceInfoLike, MediaDeviceKinds, MediaDeviceRequest, MediaEvent, MediaEventType, MediaInput, MediaStreamTrackLike, StreamTrackEventHandlers, Unsubscribe, applyConstraints, areMultipleFacingModeSupported, areTracksEnabled, compareDevices, createIndexedDevices, createStreamTrackEventSubscriptions, createTrackDevicesChanges, deviceChanged, extractConstrainDevice, extractConstraintsWithKeys, findAudioInputDevices, findAudioOutputDevices, findCurrentAudioOutputId, findCurrentVideoInputDeviceIdFromStream, findDevice, findDeviceFromConstraints, findDeviceWithDeviceId, findDevicesByKind, findMediaInputFromMediaStreamTrack, findMediaInputFromStream, findPermissionGrantedDevices, findVideoInputDevices, getDeviceId, getDevices, getFacingModeFromConstraintString, getInputDevicePermissionState, getValueFromConstrainNumber, hasAnyGrantedInput, hasAnyInputs, hasAudioInputs, hasAudioOrVideoInputs, hasChangedInput, hasRequestingDevice, hasVideoInputs, interpretCurrentFacingMode, isAudioInput, isAudioOutput, isDeviceGranted, isExactDeviceConstraint, isFacingMode, isIndexedDevices, isInputConstraintSet, isMediaDeviceInfo, isMediaDeviceInfoArray, isMediaStreamTrack, isRequestedInputDevice, isRequestedInputTrack, isRequestedResolution, isStreamingRequestedDevices, isStreamingRequestedDevicesBase, isStreamingRequestingDevice, isTrackMutedOrEnded, isVideoInput, mergeConstraints, muteStreamTrack, relaxInputConstraint, resolveMediaDeviceConstraints, reverseDeviceId, shouldRequestDevice, stopMediaStream, toKey, toMediaDeviceInfo, toMediaDeviceInfoLike, toMediaDeviceInputKind, };
+export { DeviceChangedChanges, DisplayMediaOptions, Events, FacingMode, IndexedDevices, InputConstraintSet, InputDeviceConstraint, MediaDeviceFailure, MediaDeviceInfoLike, MediaDeviceKinds, MediaDeviceRequest, MediaEvent, MediaEventType, MediaInput, MediaStreamTrackLike, StreamTrackEventHandlers, Unsubscribe, applyConstraints, areMultipleFacingModeSupported, areTracksEnabled, compareDevices, createIndexedDevices, createStreamTrackEventSubscriptions, createTrackDevicesChanges, deviceChanged, extractConstrainDevice, extractConstraints, extractConstraintsWithKeys, findAudioInputDevices, findAudioOutputDevices, findCurrentAudioOutputId, findCurrentVideoInputDeviceIdFromStream, findDevice, findDeviceFromConstraints, findDeviceWithDeviceId, findDevicesByKind, findMediaInputFromMediaStreamTrack, findMediaInputFromStream, findPermissionGrantedDevices, findVideoInputDevices, getDeviceId, getDevices, getFacingModeFromConstraintString, getInputDevicePermissionState, getValueFromConstrainNumber, hasAnyGrantedInput, hasAnyInputs, hasAudioInputs, hasAudioOrVideoInputs, hasChangedInput, hasRequestingDevice, hasVideoInputs, interpretCurrentFacingMode, isAudioInput, isAudioOutput, isDeviceGranted, isExactDeviceConstraint, isFacingMode, isIndexedDevices, isInputConstraintSet, isMediaDeviceInfo, isMediaDeviceInfoArray, isMediaStreamTrack, isRequestedInputDevice, isRequestedInputTrack, isRequestedResolution, isStreamingRequestedDevices, isStreamingRequestedDevicesBase, isStreamingRequestingDevice, isTrackMutedOrEnded, isVideoInput, mergeConstraints, muteStreamTrack, relaxInputConstraint, resolveMediaDeviceConstraints, reverseDeviceId, shouldRequestDevice, stopMediaStream, toKey, toMediaDeviceInfo, toMediaDeviceInfoLike, toMediaDeviceInputKind, };
 export * from './constants';
 export * from './displayMedia';
 /**

package/dist/index.js

@@ -9,7 +9,7 @@
  */
 import { areMultipleFacingModeSupported, areTracksEnabled, createTrackDevicesChanges, deviceChanged, findAudioInputDevices, findAudioOutputDevices, findCurrentAudioOutputId, findCurrentVideoInputDeviceIdFromStream, findDeviceWithDeviceId, findDevicesByKind, findMediaInputFromMediaStreamTrack, findMediaInputFromStream, findPermissionGrantedDevices, findVideoInputDevices, getDevices, getInputDevicePermissionState, hasAnyGrantedInput, hasAnyInputs, hasAudioInputs, hasAudioOrVideoInputs, hasChangedInput, hasRequestingDevice, hasVideoInputs, interpretCurrentFacingMode, isRequestedInputDevice, isRequestedInputTrack, isRequestedResolution, isStreamingRequestedDevices, isStreamingRequestedDevicesBase, isStreamingRequestingDevice, isTrackMutedOrEnded, muteStreamTrack, shouldRequestDevice, stopMediaStream, toKey, toMediaDeviceInfo, toMediaDeviceInfoLike, toMediaDeviceInputKind, } from './devices';
 import { compareDevices, createIndexedDevices, findDevice, getDeviceId, isAudioInput, isAudioOutput, isDeviceGranted, isVideoInput, reverseDeviceId, } from './utils';
-import { applyConstraints, extractConstrainDevice, extractConstraintsWithKeys, findDeviceFromConstraints, getConstraintsHandlers, getFacingModeFromConstraintString, getValueFromConstrainNumber, isExactDeviceConstraint, mergeConstraints, relaxInputConstraint, resolveMediaDeviceConstraints, } from './constraints';
+import { applyConstraints, extractConstrainDevice, extractConstraints, extractConstraintsWithKeys, findDeviceFromConstraints, getConstraintsHandlers, getFacingModeFromConstraintString, getValueFromConstrainNumber, isExactDeviceConstraint, mergeConstraints, relaxInputConstraint, resolveMediaDeviceConstraints, } from './constraints';
 import { eventEmitter, MediaEventType } from './eventEmitter';
 import { handleMediaStream, createStreamTrackEventSubscriptions, } from './streams';
 import { MediaDeviceFailure, MediaDeviceKinds, } from './types';
@@ -91,6 +91,6 @@ setDefaultConstraints,
  */
 subscribe, } = state();
 export { getUserMedia, setDefaultConstraints, subscribe };
-export { MediaDeviceFailure, MediaDeviceKinds, MediaEventType, applyConstraints, areMultipleFacingModeSupported, areTracksEnabled, compareDevices, createIndexedDevices, createStreamTrackEventSubscriptions, createTrackDevicesChanges, deviceChanged, extractConstrainDevice, extractConstraintsWithKeys, findAudioInputDevices, findAudioOutputDevices, findCurrentAudioOutputId, findCurrentVideoInputDeviceIdFromStream, findDevice, findDeviceFromConstraints, findDeviceWithDeviceId, findDevicesByKind, findMediaInputFromMediaStreamTrack, findMediaInputFromStream, findPermissionGrantedDevices, findVideoInputDevices, getDeviceId, getDevices, getFacingModeFromConstraintString, getInputDevicePermissionState, getValueFromConstrainNumber, hasAnyGrantedInput, hasAnyInputs, hasAudioInputs, hasAudioOrVideoInputs, hasChangedInput, hasRequestingDevice, hasVideoInputs, interpretCurrentFacingMode, isAudioInput, isAudioOutput, isDeviceGranted, isExactDeviceConstraint, isFacingMode, isIndexedDevices, isInputConstraintSet, isMediaDeviceInfo, isMediaDeviceInfoArray, isMediaStreamTrack, isRequestedInputDevice, isRequestedInputTrack, isRequestedResolution, isStreamingRequestedDevices, isStreamingRequestedDevicesBase, isStreamingRequestingDevice, isTrackMutedOrEnded, isVideoInput, mergeConstraints, muteStreamTrack, relaxInputConstraint, resolveMediaDeviceConstraints, reverseDeviceId, shouldRequestDevice, stopMediaStream, toKey, toMediaDeviceInfo, toMediaDeviceInfoLike, toMediaDeviceInputKind, };
+export { MediaDeviceFailure, MediaDeviceKinds, MediaEventType, applyConstraints, areMultipleFacingModeSupported, areTracksEnabled, compareDevices, createIndexedDevices, createStreamTrackEventSubscriptions, createTrackDevicesChanges, deviceChanged, extractConstrainDevice, extractConstraints, extractConstraintsWithKeys, findAudioInputDevices, findAudioOutputDevices, findCurrentAudioOutputId, findCurrentVideoInputDeviceIdFromStream, findDevice, findDeviceFromConstraints, findDeviceWithDeviceId, findDevicesByKind, findMediaInputFromMediaStreamTrack, findMediaInputFromStream, findPermissionGrantedDevices, findVideoInputDevices, getDeviceId, getDevices, getFacingModeFromConstraintString, getInputDevicePermissionState, getValueFromConstrainNumber, hasAnyGrantedInput, hasAnyInputs, hasAudioInputs, hasAudioOrVideoInputs, hasChangedInput, hasRequestingDevice, hasVideoInputs, interpretCurrentFacingMode, isAudioInput, isAudioOutput, isDeviceGranted, isExactDeviceConstraint, isFacingMode, isIndexedDevices, isInputConstraintSet, isMediaDeviceInfo, isMediaDeviceInfoArray, isMediaStreamTrack, isRequestedInputDevice, isRequestedInputTrack, isRequestedResolution, isStreamingRequestedDevices, isStreamingRequestedDevicesBase, isStreamingRequestingDevice, isTrackMutedOrEnded, isVideoInput, mergeConstraints, muteStreamTrack, relaxInputConstraint, resolveMediaDeviceConstraints, reverseDeviceId, shouldRequestDevice, stopMediaStream, toKey, toMediaDeviceInfo, toMediaDeviceInfoLike, toMediaDeviceInputKind, };
 export * from './constants';
 export * from './displayMedia';

package/dist/streamTrackMap.d.ts

@@ -1,7 +1,8 @@
 import type { DeviceOrTrack, MediaStreamTrackLike } from './types';
+import { type DeviceKey } from './devices';
 export declare const createStreamTrackMap: (tracks?: MediaStreamTrackLike[]) => {
-    add: (track: MediaStreamTrackLike) => Map<string, MediaStreamTrackLike>;
-    has: (deviceOrTrack: DeviceOrTrack) => boolean | "";
+    add: (track: MediaStreamTrackLike) => Map<DeviceKey, MediaStreamTrackLike>;
+    has: (deviceOrTrack: DeviceOrTrack) => boolean;
     clear: () => void;
     remove: (track: MediaStreamTrackLike) => boolean;
     size: () => number;

package/dist/streamTrackMap.js

@@ -3,33 +3,81 @@ import { toKey } from './devices';
 import { isMediaStreamTrack } from './typeGuards';
 export const createStreamTrackMap = (tracks) => {
     const streamTrackMap = new Map(tracks?.map(track => [toKey(track), track]));
+    const toDeviceIndexKey = (track) => {
+        const { deviceId } = track.getSettings();
+        return deviceId
+            ? `${track.kind}:${deviceId}`
+            : undefined;
+    };
+    const toDeviceQueryKey = (device) => {
+        switch (device.kind) {
+            case 'audioinput':
+                return `audio:${device.deviceId}`;
+            case 'videoinput':
+                return `video:${device.deviceId}`;
+            default:
+                return undefined;
+        }
+    };
+    /**
+     * Secondary index: `${track.kind}:${deviceId}` → tracks for O(1) device lookups.
+     * Uses a Set per key so multiple tracks sharing a deviceId stay findable
+     * until every one of them is removed.
+     */
+    const deviceIndex = new Map();
+    const addToDeviceIndex = (track) => {
+        const indexKey = toDeviceIndexKey(track);
+        if (!indexKey) {
+            return;
+        }
+        const existing = deviceIndex.get(indexKey);
+        if (existing) {
+            existing.add(track);
+        }
+        else {
+            deviceIndex.set(indexKey, new Set([track]));
+        }
+    };
+    const removeFromDeviceIndex = (track) => {
+        const indexKey = toDeviceIndexKey(track);
+        if (!indexKey) {
+            return;
+        }
+        const existing = deviceIndex.get(indexKey);
+        if (!existing) {
+            return;
+        }
+        existing.delete(track);
+        if (existing.size === 0) {
+            deviceIndex.delete(indexKey);
+        }
+    };
+    for (const track of streamTrackMap.values()) {
+        addToDeviceIndex(track);
+    }
     /**
      * Find track from the list of track in use.
      */
     const findTrack = (device) => {
-        return [...streamTrackMap]
-            .map(([_, track]) => track)
-            .find(track => {
-            const { kind } = track;
-            const { deviceId } = track.getSettings();
-            if (!deviceId) {
-                return false;
-            }
-            return (device.kind.includes(kind) && device.deviceId === deviceId);
-        });
+        const queryKey = toDeviceQueryKey(device);
+        if (!queryKey) {
+            return undefined;
+        }
+        const tracks = deviceIndex.get(queryKey);
+        return tracks?.values().next().value;
     };
     /**
-     * Construct a `StreamTrackKey` from `DeviceOrTrack`
+     * Construct a `DeviceKey` from `DeviceOrTrack`
      */
     const toStreamTrackKey = (deviceOrTrack) => {
         // Unify interfaces
         const track = isMediaStreamTrack(deviceOrTrack)
             ? deviceOrTrack
             : findTrack(deviceOrTrack);
-        if (!track?.kind || !track.id) {
-            return '';
-        }
-        return toKey(track);
+        const kind = track?.kind || 'unknown-kind';
+        const id = track?.id || 'unknown-id';
+        const label = track?.label || 'unknown-label';
+        return toKey({ kind, id, label });
     };
     /**
      * Add the `MediaStreamTrack` to `streamTrackMap`
@@ -37,6 +85,7 @@ export const createStreamTrackMap = (tracks) => {
     const add = (track) => {
         const key = toStreamTrackKey(track);
         if (key) {
+            addToDeviceIndex(track);
             return streamTrackMap.set(key, track);
         }
         throw new Error(MediaDeviceFailure.StreamTrackNotFound);
@@ -56,12 +105,14 @@ export const createStreamTrackMap = (tracks) => {
             track.stop();
         }
         streamTrackMap.clear();
+        deviceIndex.clear();
     };
     /**
      * Stop the track and remove the track from `streamTrackMap`
      */
     const remove = (track) => {
         const key = toStreamTrackKey(track);
+        removeFromDeviceIndex(track);
         track.stop();
         return streamTrackMap.delete(key);
     };

package/dist/typeGuards.d.ts

@@ -17,14 +17,14 @@ export declare const isFloat: (t: unknown) => t is number;
  * Reference https://w3c.github.io/mediacapture-main/#dom-mediatrackconstraintset
  */
 export declare const CONSTRAIN_STRING_KEYS: readonly ["facingMode", "resizeMode", "deviceId", "groupId"];
-export declare const EXTENDED_CONSTRAIN_STRING_KEYS: readonly ["videoSegmentation", "videoSegmentationModel", "backgroundImageUrl", "contentHint"];
+export declare const EXTENDED_CONSTRAIN_STRING_KEYS: readonly ["videoSegmentation", "backgroundImageUrl", "contentHint"];
 export type ExtendedConstrainStringKeys = (typeof EXTENDED_CONSTRAIN_STRING_KEYS)[number];
 export type ConstrainStringKeys = (typeof CONSTRAIN_STRING_KEYS)[number];
 export declare const CONSTRAIN_U_LONG_KEYS: readonly ["width", "height", "sampleRate", "sampleSize", "channelCount"];
 export declare const EXTENDED_CONSTRAIN_U_LONG_KEYS: readonly ["backgroundBlurAmount", "edgeBlurAmount", "morphErodeRadiusPx", "morphPass", "morphDilateRadiusPx", "lightWrapBlurAmount", "downSampleFactor"];
 export type ExtendedConstrainULongKeys = (typeof EXTENDED_CONSTRAIN_U_LONG_KEYS)[number];
 export type ConstrainULongKeys = (typeof CONSTRAIN_U_LONG_KEYS)[number];
-export declare const CONSTRAIN_DOUBLE_KEYS: readonly ["aspectRatio", "frameRate", "latency"];
+export declare const CONSTRAIN_DOUBLE_KEYS: readonly ["aspectRatio", "frameRate"];
 export declare const EXTENDED_CONSTRAIN_DOUBLE_KEYS: readonly ["foregroundThreshold", "backgroundThreshold", "sigmaSpace", "sigmaRangeLo", "sigmaRangeHi", "maskCombineRatio", "personCenterX", "personCenterY", "lightWrapIntensity", "lightWrapTightness", "lightWrapEdgeBand"];
 export type ExtendedConstrainDoubleKeys = (typeof EXTENDED_CONSTRAIN_DOUBLE_KEYS)[number];
 export type ConstrainDoubleKeys = (typeof CONSTRAIN_DOUBLE_KEYS)[number];
@@ -39,7 +39,7 @@ export type ConstrainBooleanKeys = (typeof CONSTRAIN_BOOLEAN_KEYS)[number];
 /**
  * The keys from the `MediaTrackConstraintSet`
  */
-export declare const CONSTRAINT_SET_KEYS: readonly ["aspectRatio", "frameRate", "latency", "width", "height", "sampleRate", "sampleSize", "channelCount", "facingMode", "resizeMode", "deviceId", "groupId", "echoCancellation", "autoGainControl", "noiseSuppression", "pan", "tilt", "zoom"];
+export declare const CONSTRAINT_SET_KEYS: readonly ["aspectRatio", "frameRate", "width", "height", "sampleRate", "sampleSize", "channelCount", "facingMode", "resizeMode", "deviceId", "groupId", "echoCancellation", "autoGainControl", "noiseSuppression", "pan", "tilt", "zoom"];
 export declare const isConstrainStringKeys: (t: unknown) => t is ConstrainStringKeys;
 export declare const isExtendedConstrainStringKeys: (t: unknown) => t is ExtendedConstrainStringKeys;
 export declare const isConstrainULongKeys: (t: unknown) => t is ConstrainULongKeys;

package/dist/typeGuards.js

@@ -25,7 +25,6 @@ export const CONSTRAIN_STRING_KEYS = [
 ];
 export const EXTENDED_CONSTRAIN_STRING_KEYS = [
     'videoSegmentation',
-    'videoSegmentationModel',
     'backgroundImageUrl',
     'contentHint',
 ];
@@ -45,11 +44,7 @@ export const EXTENDED_CONSTRAIN_U_LONG_KEYS = [
     'lightWrapBlurAmount',
     'downSampleFactor',
 ];
-export const CONSTRAIN_DOUBLE_KEYS = [
-    'aspectRatio',
-    'frameRate',
-    'latency',
-];
+export const CONSTRAIN_DOUBLE_KEYS = ['aspectRatio', 'frameRate'];
 export const EXTENDED_CONSTRAIN_DOUBLE_KEYS = [
     'foregroundThreshold',
     'backgroundThreshold',

package/dist/types.d.ts

@@ -66,11 +66,6 @@ export interface InputConstraintSet extends MediaTrackConstraints {
      * segment. Available effects are `none`, `blur`, `overlay` or `remove`
      */
     videoSegmentation?: ConstrainDOMString;
-    /**
-     * Segmentation model to be used for video segmentation, currently only
-     * supports `mediapipeSelfie` and `personify`
-     */
-    videoSegmentationModel?: ConstrainDOMString;
     /**
      * Whether or not using our own noise suppression
      */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pexip/media-control",
-  "version": "21.0.0",
+  "version": "22.1.0",
   "homepage": "https://developer.pexip.com",
   "bugs": "https://gitlab.com/pexip/zoo/issues",
   "repository": {
@@ -48,22 +48,22 @@
     "docs": "typedoc"
   },
   "dependencies": {
-    "@pexip/utils": "17.2.0"
+    "@pexip/utils": "17.4.0"
   },
   "devDependencies": {
-    "@jest/globals": "^30.2.0",
-    "@pexip/bundler": "18.2.0",
-    "@swc/core": "^1.10.12",
+    "@jest/globals": "^29.5.12",
+    "@pexip/bundler": "18.2.1",
+    "@swc/core": "^1.15.33",
     "@swc/jest": "^0.2.39",
     "@types/uuid": "^8.3.0",
     "@types/webrtc": "^0.0.31",
     "jest": "^29.5.12",
     "jest-junit": "^16.0.0",
     "prettier": "^3.2.5",
-    "typedoc": "^0.28.15",
-    "typedoc-plugin-markdown": "^4.9.0",
-    "typescript": "~5.7.3",
-    "uuid": "^11.0.0"
+    "typedoc": "^0.28.18",
+    "typedoc-plugin-markdown": "^4.11.0",
+    "typescript": "~6.0.2",
+    "uuid": "^14.0.0"
   },
   "publishConfig": {
     "access": "public"