@pexip/media-control 22.0.0 → 22.1.0

package/CHANGELOG.md

@@ -1,5 +1,14 @@
 # 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

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

@@ -8,7 +8,7 @@ function extractConstraints<T>(key): ExtractConstraintFn<ConstrainDeviceTuple>;
 
 | Type Parameter |
 | ------ |
-| `T` *extends* `"device"` |
+| `T extends "device"` |
 
 ### Parameters
 
@@ -18,7 +18,7 @@ function extractConstraints<T>(key): ExtractConstraintFn<ConstrainDeviceTuple>;
 
 ### Returns
 
-`ExtractConstraintFn`\<`ConstrainDeviceTuple`\>
+`ExtractConstraintFn<ConstrainDeviceTuple>`
 
 ## Call Signature
 
@@ -30,7 +30,7 @@ function extractConstraints<T>(key): ExtractConstraintFn<ConstrainStringTuple>;
 
 | Type Parameter |
 | ------ |
-| `T` *extends* \| `"deviceId"` \| `"groupId"` \| `"videoSegmentation"` \| `"backgroundImageUrl"` \| `"resizeMode"` \| `"contentHint"` \| `"facingMode"` |
+| `T extends \| "deviceId" \| "groupId" \| "videoSegmentation" \| "backgroundImageUrl" \| "resizeMode" \| "contentHint" \| "facingMode"` |
 
 ### Parameters
 
@@ -40,7 +40,7 @@ function extractConstraints<T>(key): ExtractConstraintFn<ConstrainStringTuple>;
 
 ### Returns
 
-`ExtractConstraintFn`\<`ConstrainStringTuple`\>
+`ExtractConstraintFn<ConstrainStringTuple>`
 
 ## Call Signature
 
@@ -52,7 +52,7 @@ function extractConstraints<T>(key): ExtractConstraintFn<ConstrainNumberTuple>;
 
 | Type Parameter |
 | ------ |
-| `T` *extends* `ConstrainNumberKeys` |
+| `T extends ConstrainNumberKeys` |
 
 ### Parameters
 
@@ -62,7 +62,7 @@ function extractConstraints<T>(key): ExtractConstraintFn<ConstrainNumberTuple>;
 
 ### Returns
 
-`ExtractConstraintFn`\<`ConstrainNumberTuple`\>
+`ExtractConstraintFn<ConstrainNumberTuple>`
 
 ## Call Signature
 
@@ -74,7 +74,7 @@ function extractConstraints<T>(key): ExtractConstraintFn<ConstrainBooleanTuple>;
 
 | Type Parameter |
 | ------ |
-| `T` *extends* \| `"denoise"` \| `"vad"` \| `"asd"` \| `"mixWithAdditionalMedia"` \| `"excludeBystanders"` \| `"pan"` \| `"tilt"` \| `"zoom"` \| `"echoCancellation"` \| `"autoGainControl"` \| `"noiseSuppression"` |
+| `T extends \| "denoise" \| "vad" \| "asd" \| "mixWithAdditionalMedia" \| "excludeBystanders" \| "pan" \| "tilt" \| "zoom" \| "echoCancellation" \| "autoGainControl" \| "noiseSuppression"` |
 
 ### Parameters
 
@@ -84,4 +84,4 @@ function extractConstraints<T>(key): ExtractConstraintFn<ConstrainBooleanTuple>;
 
 ### Returns
 
-`ExtractConstraintFn`\<`ConstrainBooleanTuple`\>
+`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"` \| `"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,7 +6,7 @@
 
 | 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="denoise"></a> `denoise?` | `ConstrainBoolean` | Whether or not using our own noise suppression | - |
 | <a id="vad"></a> `vad?` | `ConstrainBoolean` | Voice Activity Detection | - |
@@ -17,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 | - |
@@ -52,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/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) => {

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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pexip/media-control",
-  "version": "22.0.0",
+  "version": "22.1.0",
   "homepage": "https://developer.pexip.com",
   "bugs": "https://gitlab.com/pexip/zoo/issues",
   "repository": {
@@ -48,12 +48,12 @@
     "docs": "typedoc"
   },
   "dependencies": {
-    "@pexip/utils": "17.3.0"
+    "@pexip/utils": "17.4.0"
   },
   "devDependencies": {
     "@jest/globals": "^29.5.12",
     "@pexip/bundler": "18.2.1",
-    "@swc/core": "^1.10.12",
+    "@swc/core": "^1.15.33",
     "@swc/jest": "^0.2.39",
     "@types/uuid": "^8.3.0",
     "@types/webrtc": "^0.0.31",
@@ -63,7 +63,7 @@
     "typedoc": "^0.28.18",
     "typedoc-plugin-markdown": "^4.11.0",
     "typescript": "~6.0.2",
-    "uuid": "^11.0.0"
+    "uuid": "^14.0.0"
   },
   "publishConfig": {
     "access": "public"