@pexip/media-control 19.1.0 → 20.0.0

package/CHANGELOG.md

@@ -1,5 +1,33 @@
 # Changelog
 
+## 20.0.0
+
+### Major Changes
+
+- 2bfd9e1: Adds esm entry points.
+
+### Minor Changes
+
+- 3555d9d: Adds `build:sourcemap` script.
+- 7d94f5c: Take unauthorized device into account
+- ed53b05: Upgrade Typescript
+
+### Patch Changes
+
+- b0d8af9: Enable recommended lint rules
+- e76a15e: Migrate to biome linter
+- Updated dependencies [2bfd9e1]
+- Updated dependencies [4fe77de]
+- Updated dependencies [2bbff64]
+- Updated dependencies [4ea0492]
+- Updated dependencies [3555d9d]
+- Updated dependencies [1601985]
+- Updated dependencies [84956b8]
+- Updated dependencies [ed53b05]
+- Updated dependencies [d681fd3]
+- Updated dependencies [e76a15e]
+  - @pexip/utils@17.0.0
+
 ## 19.1.0
 
 ## 19.0.0

package/dist/baseLogger.d.ts

@@ -9,7 +9,7 @@ export declare enum LogLevels {
     warn = 40,
     error = 50,
     fatal = 60,
-    silent
+    silent = 9007199254740991
 }
 export type LogLevelsString = keyof typeof LogLevels;
 export type LogMethods = {
@@ -21,14 +21,23 @@ export type LogMethods = {
  */
 export interface Logger extends LogMethods {
     /**
-     * Adds a value to the redaction set, which makes it replaced by [REDACTED] when logged to file.
+     * Add a pattern to the redactor and an optional mask for the redaction.
      *
-     * @remarks
-     * The redaction set is applied globally, and only applies to the log file, not console logs.
+     * @see {@link Redactor}
      *
-     * @param value - the string to redact
+     * @param value - The pattern to add.
+     * @param replaceTo - The mask to use for redaction.
      */
-    redact(value: string): void;
+    addRedactPattern(value: string, redactTo?: string): void;
+    /**
+     * Redact the provided string by replacing all occurrences of the patterns
+     * and return a new string with redacted values.
+     *
+     * @see {@link Redactor}
+     *
+     * @param text - The string to redact.
+     */
+    redact(text: string): string;
 }
 /**
  * Create a logger with console API, and map fatal to error, skipping trace

package/dist/baseLogger.js

@@ -6,8 +6,7 @@ export var LogLevels;
     LogLevels[LogLevels["warn"] = 40] = "warn";
     LogLevels[LogLevels["error"] = 50] = "error";
     LogLevels[LogLevels["fatal"] = 60] = "fatal";
-    // eslint-disable-next-line @typescript-eslint/prefer-literal-enum-member -- needs infinity
-    LogLevels[LogLevels["silent"] = Number.MAX_SAFE_INTEGER] = "silent";
+    LogLevels[LogLevels["silent"] = 9007199254740991] = "silent";
 })(LogLevels || (LogLevels = {}));
 /**
  * Create a logger with console API, and map fatal to error, skipping trace
@@ -15,15 +14,22 @@ export var LogLevels;
  */
 export function createConsoleLogger() {
     return Object.freeze({
-        /* eslint-disable no-console -- set logger to console */
         fatal: (meta, message) => console.error(message, meta),
         error: (meta, message) => console.error(message, meta),
         warn: (meta, message) => console.warn(message, meta),
         info: (meta, message) => console.info(message, meta),
         debug: (meta, message) => console.debug(message, meta),
-        trace() { }, // Noop
-        silent() { }, // Noop
-        redact() { }, // Noop
-        /* eslint-enable no-console -- set logger to console */
+        trace() {
+            // Noop
+        },
+        silent() {
+            // Noop
+        },
+        redact(text) {
+            return text;
+        },
+        addRedactPattern() {
+            // Noop
+        },
     });
 }

package/dist/constraints.d.ts

@@ -19,7 +19,7 @@ export declare const mergeConstraints: (baseConstraints: InputConstraintSet | bo
  *
  * Check test cases for the details
  */
-export declare const normalizeDevice: (device: InputConstraintSet['device']) => MediaDeviceInfo[] | undefined;
+export declare const normalizeDevice: (device: InputConstraintSet["device"]) => MediaDeviceInfo[] | undefined;
 /**
  * Normalize Device Constraint
  * Convert Device Constraints into a form of `ConstraintDeviceParameters`
@@ -32,12 +32,12 @@ export declare const normalizeDevice: (device: InputConstraintSet['device']) =>
  * `undefined` if nothing is meaningful for the constraint, otherwise,
  * a normalized form of `ConstraintDeviceParameters`
  */
-export declare const normalizeDeviceConstraint: (constraints: InputConstraintSet['device']) => NormalizedConstraintDeviceParameters | undefined;
+export declare const normalizeDeviceConstraint: (constraints: InputConstraintSet["device"]) => NormalizedConstraintDeviceParameters | undefined;
 /**
  * Convert `InputConstraintSet['device']` into
  * `MediaTrackConstraintSet['deviceId']` in a normalized form
  */
-export declare const toDeviceIdConstraintSet: (constraint: InputConstraintSet['device']) => MediaTrackConstraints['deviceId'];
+export declare const toDeviceIdConstraintSet: (constraint: InputConstraintSet["device"]) => MediaTrackConstraints["deviceId"];
 export declare const toArray: <T>(t: T | T[]) => T[];
 export type ConstrainNoneTuple = [undefined, 'ideal'];
 export declare const NONE: ConstrainNoneTuple;
@@ -104,8 +104,8 @@ export declare const getMediaConstraints: ({ audio, video, defaultConstraints, }
  */
 export declare const applyConstraints: (tracks: MediaStreamTrack[] | undefined, constraints: MediaDeviceRequest) => Promise<void>;
 export declare const findDeviceFrom: (devicesToFind: MediaDeviceInfoLike[], devices: IndexedDevices) => MediaDeviceInfoLike[];
-export declare const findDeviceFromDeviceConstraints: (device: InputConstraintSet['device'], devices: IndexedDevices) => MediaDeviceInfoLike[] | undefined;
-export declare const relaxDevice: (device: InputConstraintSet['device'], devices: IndexedDevices) => MediaDeviceInfoLike[] | undefined;
+export declare const findDeviceFromDeviceConstraints: (device: InputConstraintSet["device"], devices: IndexedDevices) => MediaDeviceInfoLike[] | undefined;
+export declare const relaxDevice: (device: InputConstraintSet["device"], devices: IndexedDevices) => MediaDeviceInfoLike[] | undefined;
 export declare const resolveOnlyDevice: (devices: IndexedDevices) => true | MediaDeviceInfoLike | undefined;
 type ConstrainNumberKeys = ConstrainULongKeys | ConstrainDoubleKeys | ExtendedConstrainDoubleKeys | ExtendedConstrainULongKeys;
 type ConstrainTuples = ConstrainDeviceTuple | ConstrainNumberTuple | ConstrainStringTuple | ConstrainBooleanTuple | ConstrainNoneTuple;
@@ -143,7 +143,7 @@ export type Constraints = ConstrainStrings & ConstrainNumbers & ConstrainBoolean
  * expect(noiseSuppressionParam).toEqual('ideal');
  * ```
  */
-export declare const extractConstraintsWithKeys: <T extends "deviceId" | "groupId" | "device" | "videoSegmentation" | "videoSegmentationModel" | "denoise" | "vad" | "asd" | "mixWithAdditionalMedia" | "backgroundImageUrl" | "resizeMode" | "pan" | "tilt" | "zoom" | "contentHint" | "facingMode" | "echoCancellation" | "autoGainControl" | "noiseSuppression" | ConstrainNumberKeys>(keys: readonly T[]) => (constraints: InputDeviceConstraint | undefined) => Pick<Constraints, T>;
+export declare const extractConstraintsWithKeys: <T extends keyof Constraints>(keys: readonly T[]) => (constraints: InputDeviceConstraint | undefined) => Pick<Constraints, T>;
 /**
  * Extract deviceId from constraints
  */
@@ -167,7 +167,7 @@ export declare const findDeviceFromConstraints: (constraints: InputDeviceConstra
  * @param input - The input constraints to be relaxed
  * @param devices - The current device list
  */
-export declare const relaxInputConstraint: (kind: 'audioinput' | 'videoinput', input: InputDeviceConstraint | undefined, devices: IndexedDevices) => InputDeviceConstraint | undefined;
+export declare const relaxInputConstraint: (kind: "audioinput" | "videoinput", input: InputDeviceConstraint | undefined, devices: IndexedDevices) => InputDeviceConstraint | undefined;
 export declare const getConstraintsHandlers: () => {
     getDefaultConstraints: () => MediaStreamConstraints;
     setDefaultConstraints: (newConstraints: MediaStreamConstraints) => void;

package/dist/constraints.js

@@ -18,10 +18,13 @@ const getConstraintsSetFilter = (supportedConstraints) => (trackConstraints) =>
     if (!isMediaTrackConstraints(trackConstraints)) {
         return trackConstraints;
     }
-    const constraints = Object.entries(trackConstraints).reduce((acc, [key, val]) => key === 'advanced' ||
-        supportedConstraints.has(key)
-        ? { ...acc, [key]: val }
-        : acc, {});
+    const constraints = {};
+    for (const [key, value] of Object.entries(trackConstraints)) {
+        if (key === 'advanced' ||
+            supportedConstraints.has(key)) {
+            constraints[key] = value;
+        }
+    }
     // If we don't have any valid constraints it seems sensible to fallback to a boolean constraint -ea
     if (Object.keys(constraints).length === 0) {
         return true;
@@ -29,7 +32,13 @@ const getConstraintsSetFilter = (supportedConstraints) => (trackConstraints) =>
     return constraints;
 };
 const getDefinedOnly = (obj) => {
-    return Object.entries(obj).reduce((acc, [key, val]) => typeof val === 'undefined' ? acc : { ...acc, [key]: val }, {});
+    const result = {};
+    for (const [key, value] of Object.entries(obj)) {
+        if (typeof value !== 'undefined') {
+            result[key] = value;
+        }
+    }
+    return result;
 };
 /**
  * Use navigator.mediaDevices.getSupportedConstraints to remove constraints not supported by agent.
@@ -41,11 +50,7 @@ export const removeUnsupportedConstraints = (constraints) => {
     }
     const supportedConstraints = Object.entries(navigator.mediaDevices.getSupportedConstraints());
     logger.debug({ supportedConstraints }, 'Supported constraints');
-    const constraintsSetFilter = getConstraintsSetFilter(supportedConstraints.reduce((set, [key, value]) => 
-    // FIXME: Cast inserted to unblock typescript upgrade, will have to be verified and properly fixed.
-    value && isMediaTrackConstraintSetKey(key)
-        ? set.add(key)
-        : set, new Set()));
+    const constraintsSetFilter = getConstraintsSetFilter(supportedConstraints.reduce((set, [key, value]) => value && isMediaTrackConstraintSetKey(key) ? set.add(key) : set, new Set()));
     return getDefinedOnly({
         audio: constraintsSetFilter(constraints.audio),
         peerIdentity: constraints.peerIdentity,
@@ -73,9 +78,9 @@ export const mergeConstraints = (baseConstraints) => (constraints) => {
             ...baseConstraints,
             device: constraints,
         };
-        delete result.facingMode;
-        delete result.deviceId;
-        return result;
+        result.facingMode = undefined;
+        result.deviceId = undefined;
+        return getDefinedOnly(result);
     }
     if (isInputConstraintSet(constraints)) {
         const combined = { ...baseConstraints, ...constraints };
@@ -87,13 +92,13 @@ export const mergeConstraints = (baseConstraints) => (constraints) => {
             const result = {
                 ...combined,
             };
-            delete result.facingMode;
-            delete result.deviceId;
-            return result;
+            result.facingMode = undefined;
+            result.deviceId = undefined;
+            return getDefinedOnly(result);
         }
         if (hasDevice || hasDeviceId) {
-            delete combined.facingMode;
-            return combined;
+            combined.facingMode = undefined;
+            return getDefinedOnly(combined);
         }
         return combined;
     }
@@ -271,7 +276,7 @@ export const extractConstrainDevice = (constraints, initialParam = 'ideal') => {
  * @param numDigits - The number of digits to check after the decimal point @defaultValue 5 digits
  */
 export const closedTo = (a, b, numDigits = 5) => {
-    const multiplier = Math.pow(10, numDigits);
+    const multiplier = 10 ** numDigits;
     return Math.round(a * multiplier) === Math.round(b * multiplier);
 };
 /**
@@ -374,12 +379,12 @@ export const resolveMediaDeviceConstraints = (constraints, base) => {
             return merge(Object.keys(constraints).reduce((cs, k) => {
                 const key = k;
                 if (key === 'device') {
-                    return {
-                        ...cs,
-                        deviceId: toDeviceIdConstraintSet(constraints.device),
-                    };
+                    cs.deviceId = toDeviceIdConstraintSet(constraints.device);
+                    return cs;
                 }
-                return { ...cs, [key]: constraints[key] };
+                // @ts-expect-error --- for performance
+                cs[key] = constraints[key];
+                return cs;
             }, {}));
         }
         return merge(constraints);
@@ -532,38 +537,14 @@ export function extractConstraints(key) {
  * expect(noiseSuppressionParam).toEqual('ideal');
  * ```
  */
-export const extractConstraintsWithKeys = (keys) => (constraints) => keys.reduce((result, key) => {
-    if (key === 'device') {
-        return {
-            ...result,
-            [key]: extractConstraints(key)(constraints),
-        };
-    }
-    if (isConstrainULongKeys(key) ||
-        isConstrainDoubleKeys(key) ||
-        isExtendedConstrainULongKeys(key) ||
-        isExtendedConstrainDoubleKeys(key)) {
-        return {
-            ...result,
-            [key]: extractConstraints(key)(constraints),
-        };
-    }
-    if (isConstrainStringKeys(key) ||
-        isExtendedConstrainStringKeys(key)) {
-        return {
-            ...result,
-            [key]: extractConstraints(key)(constraints),
-        };
+export const extractConstraintsWithKeys = (keys) => (constraints) => {
+    const extracted = {};
+    for (const key of keys) {
+        // @ts-expect-error --- subpress ts error for performance
+        extracted[key] = extractConstraints(key)(constraints);
     }
-    if (isConstrainBooleanKeys(key) ||
-        isExtendedConstrainBooleanKeys(key)) {
-        return {
-            ...result,
-            [key]: extractConstraints(key)(constraints),
-        };
-    }
-    return result;
-}, {});
+    return extracted;
+};
 /**
  * Extract deviceId from constraints
  */

package/dist/devices.d.ts

@@ -4,17 +4,11 @@ import type { FacingMode, IndexedDevices, InputConstraintSet, InputDeviceConstra
  *
  * ```
  * devices (raw)
- * |--- authorized
- * |        |--- found
- * |        |--- lost
- * |--- unauthorized
  * ```
  *
  * @beta
  */
 export type DeviceChangedChanges = {
-    authorized: MediaDeviceInfoLike[];
-    unauthorized: MediaDeviceInfoLike[];
     found: MediaDeviceInfoLike[];
     lost: MediaDeviceInfoLike[];
     devices: MediaDeviceInfoLike[];
@@ -30,7 +24,7 @@ interface ToKeyOptions {
  * @beta
  */
 export declare const toKey: ({ id, kind, label }: ToKeyOptions) => string;
-export declare const toMediaDeviceInputKind: (track: Pick<MediaStreamTrack, 'kind'>) => 'audioinput' | 'videoinput';
+export declare const toMediaDeviceInputKind: (track: Pick<MediaStreamTrack, "kind">) => "audioinput" | "videoinput";
 /**
  * Future proofing: in case we want to alter the values or type returned
  * by {@link https://developer.mozilla.org/en-US/docs/Web/API/MediaDevices/enumerateDevices | enumerateDevices}
@@ -52,10 +46,7 @@ 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 toDevicesMap: (devices: MediaDeviceInfoLike[]) => Map<string, MediaDeviceInfoLike>;
-export declare const toUniqueDevices: (devices: MediaDeviceInfoLike[]) => MediaDeviceInfoLike[];
 export declare const createTrackDevicesChanges: (prevDevices?: MediaDeviceInfoLike[]) => (devices: MediaDeviceInfoLike[]) => {
-    unauthorized: MediaDeviceInfoLike[];
-    authorized: MediaDeviceInfoLike[];
     found: MediaDeviceInfoLike[];
     lost: MediaDeviceInfoLike[];
     devices: MediaDeviceInfoLike[];
@@ -90,7 +81,7 @@ export declare const toMediaDeviceInfoLike: (track: MediaStreamTrack) => MediaDe
  *
  * @beta
  */
-export declare const compareMediaDeviceToMediaTrack: (track: Pick<MediaStreamTrack, 'kind' | 'getSettings' | 'label'>) => (device: MediaDeviceInfoLike) => boolean;
+export declare const compareMediaDeviceToMediaTrack: (track: Pick<MediaStreamTrack, "kind" | "getSettings" | "label">) => (device: MediaDeviceInfoLike) => boolean;
 export declare const toMediaDeviceInfo: (info: MediaDeviceInfoLike) => {
     deviceId: string;
     groupId: string;
@@ -121,7 +112,7 @@ export declare const findMediaInputFromMediaStreamTrack: (devices: IndexedDevice
  * @beta
  */
 export declare const findMediaInputFromStream: (devices: IndexedDevices) => (stream: MediaStream | undefined) => MediaInput;
-export declare const compareDeviceConstraintAndTrackDevice: (device: MediaDeviceInfoLike | undefined) => (constraint: InputConstraintSet['device']) => boolean;
+export declare const compareDeviceConstraintAndTrackDevice: (device: MediaDeviceInfoLike | undefined) => (constraint: InputConstraintSet["device"]) => boolean;
 export declare const isRequestedResolution: (request: InputDeviceConstraint | undefined, response: MediaTrackSettings | undefined) => boolean;
 export declare const isRequestedInputDevice: (request: InputDeviceConstraint | undefined, response: MediaDeviceInfoLike | MediaDeviceTrackInfo | undefined) => boolean;
 /**
@@ -204,8 +195,8 @@ export declare const findPermissionGrantedDevices: (devices: MediaDeviceInfoLike
  * guess the state more accurately
  */
 export declare const toPermissionState: (anyGrantedDevice: boolean, anyLiveTrack?: boolean) => PermissionState;
-export declare const queryPermissionFallback: (name: 'camera' | 'microphone', everActiveTrack?: boolean, getDevices?: () => Promise<MediaDeviceInfo[]>) => Promise<PermissionState>;
-export declare const queryPermission: (name: 'camera' | 'microphone', everActiveTrack?: boolean, getDevices?: () => Promise<MediaDeviceInfo[]>) => Promise<PermissionState>;
+export declare const queryPermissionFallback: (name: "camera" | "microphone", everActiveTrack?: boolean, getDevices?: () => Promise<MediaDeviceInfo[]>) => Promise<PermissionState>;
+export declare const queryPermission: (name: "camera" | "microphone", everActiveTrack?: boolean, getDevices?: () => Promise<MediaDeviceInfo[]>) => Promise<PermissionState>;
 /**
  * A wrapper for `navigator.permissions.query` with fallback to use
  * `navigator.mediaDevices.enumerateDevices` to guess the `PermissionState`
@@ -313,7 +304,7 @@ export declare const findAudioOutputDevices: (devices: MediaDeviceInfoLike[]) =>
  *
  * @beta
  */
-export declare const muteStreamTrack: (stream?: MediaStream) => (mute: boolean, mediaType?: 'audio' | 'video' | 'all') => void;
+export declare const muteStreamTrack: (stream?: MediaStream) => (mute: boolean, mediaType?: "audio" | "video" | "all") => void;
 /**
  * Stops all tracks in the given stream
  *
@@ -324,7 +315,7 @@ export declare const muteStreamTrack: (stream?: MediaStream) => (mute: boolean,
  * @param stream - `MediaStream` which we mutate
  * @param onStopped - callback to be called when the track is stopped
  */
-export declare const stopMediaStream: (stream: MediaStream | undefined, onStopped?: ((track: MediaStreamTrack) => void) | undefined) => void;
+export declare const stopMediaStream: (stream: MediaStream | undefined, onStopped?: (track: MediaStreamTrack) => void) => void;
 /**
  * Checks that tracks with a given type are enabled in the stream
  *
@@ -335,7 +326,7 @@ export declare const stopMediaStream: (stream: MediaStream | undefined, onStoppe
  *
  * @beta
  */
-export declare const areTracksEnabled: (stream: MediaStream | undefined, type: 'audio' | 'video') => boolean;
+export declare const areTracksEnabled: (stream: MediaStream | undefined, type: "audio" | "video") => boolean;
 /**
  * Check if list contains media inputs
  *

package/dist/devices.js

@@ -49,39 +49,29 @@ export const getDevices = async () => {
 export const toDeviceKey = (device) => toKey({ id: device.deviceId, kind: device.kind, label: device.label });
 export const toDeviceTuple = (device) => [toDeviceKey(device), device];
 export const toDevicesMap = (devices) => {
-    return new Map(devices.map(toDeviceTuple));
-};
-export const toUniqueDevices = (devices) => {
-    const map = toDevicesMap(devices);
-    return Array.from(map.values());
+    const map = new Map();
+    for (const device of devices) {
+        const key = toDeviceKey(device);
+        if (!map.has(key)) {
+            map.set(key, device);
+        }
+    }
+    return map;
 };
 export const createTrackDevicesChanges = (prevDevices = []) => {
     let seen = toDevicesMap(prevDevices);
     return (devices) => {
         const found = [];
-        const lost = [];
         // Remove duplicated
-        const uniqueDevices = toUniqueDevices(devices);
-        const { authorized, unauthorized } = uniqueDevices.reduce((ds, d) => {
-            // Use label to differentiate un/authorized
-            if (d.label) {
-                ds.authorized.push(d);
-            }
-            else {
-                ds.unauthorized.push(d);
-            }
-            return ds;
-        }, { authorized: [], unauthorized: [] });
-        for (const device of authorized) {
-            if (!seen.delete(toDeviceKey(device))) {
+        const nextDeviceMap = toDevicesMap(devices);
+        for (const [key, device] of nextDeviceMap) {
+            if (!seen.delete(key)) {
                 found.push(device);
             }
         }
-        for (const device of seen.values()) {
-            lost.push(device);
-        }
-        seen = new Map(authorized.map(toDeviceTuple));
-        return { unauthorized, authorized, found, lost, devices: uniqueDevices };
+        const lost = Array.from(seen.values());
+        seen = nextDeviceMap;
+        return { found, lost, devices: Array.from(nextDeviceMap.values()) };
     };
 };
 /**
@@ -103,9 +93,9 @@ export const deviceChanged = (fn) => {
     //
     // Ref. https://caniuse.com/#search=ondevicechange
     if (navigator.mediaDevices && 'ondevicechange' in navigator.mediaDevices) {
-        navigator.mediaDevices.ondevicechange = odc;
+        navigator.mediaDevices.addEventListener('devicechange', odc);
         return () => {
-            navigator.mediaDevices.ondevicechange = null;
+            navigator.mediaDevices.removeEventListener('devicechange', odc);
         };
     }
     const it = window.setInterval(() => void odc(), 5000);
@@ -348,7 +338,6 @@ export const shouldRequestDevice = ({ kind, permission, request, tracks, current
     }
     switch (permission) {
         case 'prompt':
-            return true;
         case 'granted': {
             if (currentDevices.size(kind) === 0) {
                 return false;
@@ -473,10 +462,13 @@ export const queryPermission = async (name, everActiveTrack = false, getDevices
  * guess the state more accurately
  * @param getDevices - A function to get the list of devices, e.g. navigator.mediaDevices.enumerateDevices
  */
-export const getInputDevicePermissionState = async (anyActiveAudioTrack = false, anyActiveVideoTrack = false, getDevices = () => navigator.mediaDevices.enumerateDevices()) => ({
-    audio: await queryPermission('microphone', anyActiveAudioTrack, getDevices),
-    video: await queryPermission('camera', anyActiveVideoTrack, getDevices),
-});
+export const getInputDevicePermissionState = async (anyActiveAudioTrack = false, anyActiveVideoTrack = false, getDevices = () => navigator.mediaDevices.enumerateDevices()) => {
+    const [audio, video] = await Promise.all([
+        queryPermission('microphone', anyActiveAudioTrack, getDevices),
+        queryPermission('camera', anyActiveVideoTrack, getDevices),
+    ]);
+    return { audio, video };
+};
 /**
  * Find current audio output id to be used to set as sinkId
  *
@@ -572,6 +564,11 @@ export const findVideoInputDevices = findDevicesByKind(MediaDeviceKinds.VIDEOINP
  * @beta
  */
 export const findAudioOutputDevices = findDevicesByKind(MediaDeviceKinds.AUDIOOUTPUT);
+const muteTrack = (tracks, muted) => {
+    for (const track of tracks) {
+        track.enabled = !muted;
+    }
+};
 /**
  * Set `MediaStreamTrack['enabled']` according to `mute` param for the provided `stream`
  *
@@ -586,21 +583,18 @@ export const findAudioOutputDevices = findDevicesByKind(MediaDeviceKinds.AUDIOOU
  * @beta
  */
 export const muteStreamTrack = (stream) => (mute, mediaType = 'all') => {
+    if (!stream) {
+        return;
+    }
     switch (mediaType) {
         case 'audio':
-            stream?.getAudioTracks().forEach(track => {
-                track.enabled = !mute;
-            });
+            muteTrack(stream?.getAudioTracks(), mute);
             break;
         case 'video':
-            stream?.getVideoTracks().forEach(track => {
-                track.enabled = !mute;
-            });
+            muteTrack(stream.getVideoTracks(), mute);
             break;
         default:
-            stream?.getTracks().forEach(track => {
-                track.enabled = !mute;
-            });
+            muteTrack(stream.getTracks(), mute);
             break;
     }
 };
@@ -618,10 +612,10 @@ export const stopMediaStream = (stream, onStopped) => {
     if (!stream) {
         return;
     }
-    stream.getTracks().forEach(track => {
+    for (const track of stream.getTracks()) {
         track.stop();
         onStopped?.(track);
-    });
+    }
 };
 /**
  * Checks that tracks with a given type are enabled in the stream

package/dist/errors.d.ts

@@ -8,6 +8,6 @@ export interface InputNotFoundErrorParams {
 export declare const isInputNotFoundError: ({ input, kind, devices }: InputNotFoundErrorParams) => (error: string) => boolean;
 export declare const normalizeGetUserMediaError: (browserError: Error, constraints: MediaStreamConstraints, devices: MediaDeviceInfoLike[]) => MediaDeviceFailure | string;
 export declare const normalizeDeviceError: ({ audio, video, streamingAudioInput, streamingVideoInput, }: {
-    streamingAudioInput?: boolean | undefined;
-    streamingVideoInput?: boolean | undefined;
+    streamingAudioInput?: boolean;
+    streamingVideoInput?: boolean;
 } & MediaDeviceRequest) => false | MediaDeviceFailure;

package/dist/eventEmitter.d.ts

@@ -44,10 +44,6 @@ export declare enum MediaEventType {
      * Lost device from authorized device list
      */
     DeviceLost = "device:lost",
-    /**
-     * Unauthorized devices
-     */
-    DevicesUnauthorized = "devices:unauthorized",
     /**
      * No Input Devices, and no further device events will be emitted
      */
@@ -80,18 +76,12 @@ export type Events = {
     type: MediaEventType.DevicesChanged;
 } | {
     devices: MediaDeviceInfoLike[];
-    authorizedDevices: MediaDeviceInfoLike[];
-    unauthorizedDevices: MediaDeviceInfoLike[];
+    devicesFound: MediaDeviceInfoLike[];
     type: MediaEventType.DevicesFound;
 } | {
     devices: MediaDeviceInfoLike[];
-    authorizedDevices: MediaDeviceInfoLike[];
-    unauthorizedDevices: MediaDeviceInfoLike[];
+    devicesLost: MediaDeviceInfoLike[];
     type: MediaEventType.DevicesLost;
-} | {
-    devices: MediaDeviceInfoLike[];
-    authorizedDevices: MediaDeviceInfoLike[];
-    type: MediaEventType.DevicesUnauthorized;
 } | {
     devices: MediaDeviceInfoLike[];
     type: MediaEventType.NoInputDevices;

package/dist/eventEmitter.js

@@ -44,10 +44,6 @@ export var MediaEventType;
      * Lost device from authorized device list
      */
     MediaEventType["DeviceLost"] = "device:lost";
-    /**
-     * Unauthorized devices
-     */
-    MediaEventType["DevicesUnauthorized"] = "devices:unauthorized";
     /**
      * No Input Devices, and no further device events will be emitted
      */

package/dist/index.js

@@ -43,29 +43,20 @@ const state = () => {
                     devices: event.devices,
                 });
             }
-            if (event.unauthorized.length) {
-                dispatch({
-                    type: MediaEventType.DevicesUnauthorized,
-                    devices: event.unauthorized,
-                    authorizedDevices: event.authorized,
-                });
-            }
             if (event.found.length) {
                 // Can be used to trigger user notification of a potentially better device being available
                 dispatch({
                     type: MediaEventType.DevicesFound,
-                    authorizedDevices: event.authorized,
-                    unauthorizedDevices: event.unauthorized,
-                    devices: event.found,
+                    devicesFound: event.found,
+                    devices: event.devices,
                 });
             }
             if (event.lost.length) {
                 // Can be used to trigger user notification of no longer seen devices
                 dispatch({
                     type: MediaEventType.DevicesLost,
-                    authorizedDevices: event.authorized,
-                    unauthorizedDevices: event.unauthorized,
-                    devices: event.lost,
+                    devicesLost: event.lost,
+                    devices: event.devices,
                 });
                 for (const device of event.lost) {
                     if (streamTrackMap.has(device)) {

package/dist/streamTrackMap.js

@@ -52,9 +52,9 @@ export const createStreamTrackMap = (tracks) => {
      * Stop all tracks and empty `streamTrackMap`
      */
     const clear = () => {
-        streamTrackMap.forEach(track => {
+        for (const track of streamTrackMap.values()) {
             track.stop();
-        });
+        }
         streamTrackMap.clear();
     };
     /**

package/dist/streams.js

@@ -94,6 +94,8 @@ export const createStreamTrackEventSubscriptions = (track, handlers) => {
         return [];
     });
     return () => {
-        trackSubscriptions.forEach(unsubscribeEvent => unsubscribeEvent());
+        for (const unsubscribe of trackSubscriptions) {
+            unsubscribe();
+        }
     };
 };

package/dist/tsconfig.build.tsbuildinfo

@@ -0,0 +1 @@
+{"root":["../src/baseLogger.ts","../src/constants.ts","../src/constraints.ts","../src/devices.ts","../src/displayMedia.ts","../src/errors.ts","../src/eventEmitter.ts","../src/getMediaStream.ts","../src/index.ts","../src/logger.ts","../src/streamTrackMap.ts","../src/streams.ts","../src/typeGuards.ts","../src/types.ts","../src/utils.ts","../../../@types/globals.d.ts"],"version":"5.7.3"}

package/dist/typeGuards.d.ts

@@ -1,4 +1,4 @@
-import type { ConstraintDeviceParameters, DeviceConstraint, IndexedDevices, InputConstraintSet, MediaDeviceTrackInfo } from './types';
+import type { ConstraintDeviceParameters, DeviceConstraint, FacingMode, IndexedDevices, InputConstraintSet, MediaDeviceTrackInfo } from './types';
 export declare const isBoolean: (t: unknown) => t is boolean;
 export declare const isUndefined: (t: unknown) => t is undefined;
 /**
@@ -40,14 +40,14 @@ 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 isConstrainStringKeys: (t: unknown) => t is "deviceId" | "groupId" | "resizeMode" | "facingMode";
-export declare const isExtendedConstrainStringKeys: (t: unknown) => t is "videoSegmentation" | "videoSegmentationModel" | "backgroundImageUrl" | "contentHint";
-export declare const isConstrainULongKeys: (t: unknown) => t is "width" | "height" | "sampleRate" | "sampleSize" | "channelCount";
-export declare const isExtendedConstrainULongKeys: (t: unknown) => t is "backgroundBlurAmount" | "edgeBlurAmount";
-export declare const isConstrainDoubleKeys: (t: unknown) => t is "aspectRatio" | "frameRate" | "latency";
-export declare const isExtendedConstrainDoubleKeys: (t: unknown) => t is "foregroundThreshold" | "maskCombineRatio";
-export declare const isConstrainBooleanKeys: (t: unknown) => t is "pan" | "tilt" | "zoom" | "echoCancellation" | "autoGainControl" | "noiseSuppression";
-export declare const isExtendedConstrainBooleanKeys: (t: unknown) => t is "denoise" | "vad" | "asd" | "mixWithAdditionalMedia";
+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;
+export declare const isExtendedConstrainULongKeys: (t: unknown) => t is ExtendedConstrainULongKeys;
+export declare const isConstrainDoubleKeys: (t: unknown) => t is ConstrainDoubleKeys;
+export declare const isExtendedConstrainDoubleKeys: (t: unknown) => t is ExtendedConstrainDoubleKeys;
+export declare const isConstrainBooleanKeys: (t: unknown) => t is ConstrainBooleanKeys;
+export declare const isExtendedConstrainBooleanKeys: (t: unknown) => t is ExtendedConstrainBooleanKeys;
 export declare const isMediaTrackConstraintSetKey: (t: string) => t is keyof MediaTrackConstraintSet;
 export declare const isMediaTrackConstraintsKey: (t: string) => t is keyof MediaTrackConstraints;
 export declare const isMediaTrackConstraints: (t: unknown) => t is MediaTrackConstraints;
@@ -75,7 +75,7 @@ export declare const isConstrainRange: (t: unknown) => t is ConstrainDoubleRange
 export declare const isConstrainDoubleRange: (t: unknown) => t is ConstrainDoubleRange;
 export declare const isConstrainULongRange: (t: unknown) => t is ConstrainULongRange;
 export declare const isConstraintDeviceParameters: (t: unknown) => t is ConstraintDeviceParameters;
-export declare const isConstraintSetDevice: (t: unknown) => t is DeviceConstraint | ConstraintDeviceParameters | undefined;
+export declare const isConstraintSetDevice: (t: unknown) => t is InputConstraintSet["device"];
 type ExtendedConstraintSet = Pick<InputConstraintSet, ExtendedConstrainULongKeys | ExtendedConstrainDoubleKeys | ExtendedConstrainStringKeys | ExtendedConstrainBooleanKeys | 'device'>;
 export declare const isExtendedConstraint: (t: unknown) => t is ExtendedConstraintSet;
 export declare const isInputConstraintSet: (t: unknown) => t is InputConstraintSet;
@@ -85,7 +85,7 @@ export declare const isInputConstraintSet: (t: unknown) => t is InputConstraintS
  * @beta
  */
 export declare const isMediaStreamTrack: (m: unknown) => m is MediaStreamTrack;
-export declare const isFacingMode: (s: unknown) => s is "user" | "environment" | "left" | "right";
+export declare const isFacingMode: (s: unknown) => s is FacingMode;
 export declare const isIndexedDevices: (t: unknown) => t is IndexedDevices;
 export declare const isMediaDeviceTrackInfo: (t: unknown) => t is MediaDeviceTrackInfo;
 export {};

package/dist/types.d.ts

@@ -21,15 +21,29 @@ export interface IndexedDevices {
     /**
      * Get devices by kind and device id or label
      * When both `deviceId` and `label` are provided, it will use `deviceId` to
-     * to find the device, and when it's not found, it will use `label` to find
+     * find the device, and when it's not found, it will use `label` to find
+     *
+     * When device is not provided, it returns all devices.
      *
      * @param device - the device to find
      * @returns found devices otherwise empty array
      */
     get(device?: Pick<Partial<MediaDeviceInfoLike>, 'deviceId' | 'groupId' | 'label' | 'kind'>): MediaDeviceInfoLike[];
+    /**
+     * Size of particular kind of devices. When kind is not specified, it
+     * returns the total size.
+     */
     size(kind?: MediaDeviceKind): number;
+    /**
+     * First device of the kind
+     */
     first(kind: MediaDeviceInfo['kind']): MediaDeviceInfoLike | undefined;
     toJSON(): Record<MediaDeviceKind, MediaDeviceInfoLike[]>;
+    /**
+     * `true` when there is any authorized device of the kind. When kind is not
+     * provided, it checks for any audio or video input device.
+     */
+    anyAuthorizedDevice(kind?: MediaDeviceKind): boolean;
 }
 export type DeviceConstraint = MediaDeviceInfoLike | MediaDeviceInfoLike[];
 export interface NormalizedConstraintDeviceParameters {

package/dist/utils.d.ts

@@ -16,12 +16,12 @@ export declare const isDeviceGranted: (device: MediaDeviceInfoLike) => boolean;
 export declare const not: <T = void>(fn: (arg: T) => boolean) => (arg: T) => boolean;
 /**
  * Create a device ID from provided `device`.
- * The device ID here is in the format of `groupId:deviceId:kind`, be default.
+ * The device ID here is in the format of `deviceId:kind`, be default.
  *
  * @param device - The device to create the ID from
  * @param separator - The separator to use to join the device ID
  */
-export declare const getDeviceId: (device: Pick<MediaDeviceInfoLike, 'groupId' | 'deviceId' | 'kind'>, separator?: string) => string;
+export declare const getDeviceId: (device: Pick<MediaDeviceInfoLike, "deviceId" | "kind">, separator?: string) => string;
 /**
  * Reverse the device ID to its original form i.e. `MediaDeviceInfo`
  * The device ID here is in the format of `groupId:deviceId:kind`, be default.
@@ -31,7 +31,6 @@ export declare const getDeviceId: (device: Pick<MediaDeviceInfoLike, 'groupId' |
  */
 export declare const reverseDeviceId: (id: string, separator?: string) => {
     deviceId: string;
-    groupId: string;
     kind: MediaDeviceKind;
 };
 /**
@@ -45,7 +44,7 @@ export declare const createIndexedDevices: (devices: MediaDeviceInfoLike[]) => I
  *
  * @beta
  */
-export declare const compareDevices: (deviceInfo: MediaDeviceInfoLike, key?: Exclude<keyof MediaDeviceInfoLike, 'kind' | 'settings'>) => (anotherDeviceInfo: MediaDeviceInfoLike) => boolean;
+export declare const compareDevices: (deviceInfo: MediaDeviceInfoLike, key?: Exclude<keyof MediaDeviceInfoLike, "kind" | "settings">) => (anotherDeviceInfo: MediaDeviceInfoLike) => boolean;
 /**
  * Lookup the `device` from `devices` list
  *

package/dist/utils.js

@@ -17,12 +17,12 @@ export const isDeviceGranted = (device) => Boolean(device.label);
 export const not = (fn) => (arg) => !fn(arg);
 /**
  * Create a device ID from provided `device`.
- * The device ID here is in the format of `groupId:deviceId:kind`, be default.
+ * The device ID here is in the format of `deviceId:kind`, be default.
  *
  * @param device - The device to create the ID from
  * @param separator - The separator to use to join the device ID
  */
-export const getDeviceId = (device, separator = DEVICE_ID_SEPARATOR) => [device.groupId, device.deviceId, device.kind].join(separator);
+export const getDeviceId = (device, separator = DEVICE_ID_SEPARATOR) => [device.deviceId, device.kind].join(separator);
 /**
  * Reverse the device ID to its original form i.e. `MediaDeviceInfo`
  * The device ID here is in the format of `groupId:deviceId:kind`, be default.
@@ -31,20 +31,35 @@ export const getDeviceId = (device, separator = DEVICE_ID_SEPARATOR) => [device.
  * @param separator - The separator used to split the device ID
  */
 export const reverseDeviceId = (id, separator = DEVICE_ID_SEPARATOR) => {
-    const [groupId, deviceId, kind] = id.split(separator);
-    assert(groupId !== undefined, `Invalid id[${id}] format: groupId`);
+    const [deviceId, kind] = id.split(separator);
     assert(deviceId !== undefined, `Invalid id[${id}] format: deviceId`);
     assert(kind === 'audioinput' ||
         kind === 'videoinput' ||
-        kind === 'audiooutput', `Invalid id[${id}] format: kind`);
-    return { deviceId, groupId, kind: kind };
+        kind === 'audiooutput', `Invalid id[${id}] format: kind[${kind}]`);
+    return { deviceId, kind: kind };
 };
+const EMPTY = [];
 /**
  * Create an `IndexedDevices` construct from provided `devices` which index the
  * device by device ID or kind.
  */
 export const createIndexedDevices = (devices) => {
+    const anyAuthorizedDevice = {
+        audioinput: false,
+        videoinput: false,
+        audiooutput: false,
+    };
+    const deviceIdCache = new Map();
+    const kindCache = new Map();
     const emptyIndex = {
+        anyAuthorizedDevice(kind) {
+            if (kind) {
+                return anyAuthorizedDevice[kind];
+            }
+            // This is a handy check to input device
+            return (anyAuthorizedDevice['audioinput'] ||
+                anyAuthorizedDevice['videoinput']);
+        },
         audioinput: {
             deviceId: new Map(),
             label: new Map(),
@@ -92,19 +107,32 @@ export const createIndexedDevices = (devices) => {
             const deviceIdMap = this[kind].deviceId;
             const findSimilarDevices = (label) => {
                 const foundSimilar = this[kind].label.get(label);
-                return foundSimilar ? foundSimilar : [];
+                return foundSimilar ?? EMPTY;
             };
             if (deviceId !== undefined) {
+                const cacheId = getDeviceId({ deviceId, kind });
+                const cachedDevice = deviceIdCache.get(cacheId);
+                if (cachedDevice) {
+                    return cachedDevice;
+                }
                 const foundExact = deviceIdMap.get(deviceId);
                 if (!foundExact && label) {
                     return findSimilarDevices(label);
                 }
-                return foundExact ? [foundExact] : [];
+                const devicesFound = foundExact ? [foundExact] : EMPTY;
+                deviceIdCache.set(cacheId, devicesFound);
+                return devicesFound;
             }
             if (label) {
                 return findSimilarDevices(label);
             }
-            return [...deviceIdMap.values()];
+            const cachedDevices = kindCache.get(kind);
+            if (cachedDevices) {
+                return cachedDevices;
+            }
+            const devices = Array.from(deviceIdMap.values());
+            kindCache.set(kind, devices);
+            return devices;
         },
         first(kind) {
             if (!kind) {
@@ -124,14 +152,16 @@ export const createIndexedDevices = (devices) => {
     };
     return devices.reduce((acc, device) => {
         // We don't want to index devices that are not granted
-        if (device.label && device.deviceId !== undefined) {
+        if (device.deviceId !== undefined) {
             acc[device.kind].deviceId.set(device.deviceId, device);
         }
-        if (device.label) {
-            const labelDevices = acc[device.kind].label.get(device.label) ?? [];
-            labelDevices.push(device);
-            acc[device.kind].label.set(device.label, labelDevices);
+        if (anyAuthorizedDevice[device.kind] === false &&
+            isDeviceGranted(device)) {
+            anyAuthorizedDevice[device.kind] = true;
         }
+        const labelDevices = acc[device.kind].label.get(device.label) ?? [];
+        labelDevices.push(device);
+        acc[device.kind].label.set(device.label, labelDevices);
         return acc;
     }, emptyIndex);
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pexip/media-control",
-  "version": "19.1.0",
+  "version": "20.0.0",
   "homepage": "https://gitlab.com/pexip/zoo",
   "bugs": "https://gitlab.com/pexip/zoo/issues",
   "repository": {
@@ -13,34 +13,49 @@
   "author": "Pexip <pexip@pexip.com>",
   "module": "dist/index.js",
   "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./*": {
+      "types": "./dist/*.d.ts",
+      "import": "./dist/*.js"
+    },
+    "./*.js": {
+      "types": "./dist/*.d.ts",
+      "import": "./dist/*.js"
+    }
+  },
   "files": [
     "dist"
   ],
   "scripts": {
     "build": "pexip-bundler build",
+    "build:sourcemap": "pexip-bundler build --sourcemap",
     "clean": "rm -rf dist",
     "dev": "pexip-bundler dev",
-    "prepack": "yarn clean && yarn build --no-sourcemap",
+    "prepack": "yarn clean && yarn build",
     "test": "jest",
     "check-format": "prettier --ignore-path=../../.prettierignore --check .",
     "format": "prettier --ignore-path=../../.prettierignore --write .",
-    "lint": "yarn run -T eslint --ext .js,.ts,.tsx --report-unused-disable-directives .",
+    "lint": "yarn run -T biome lint",
     "typecheck": "yarn tsc --noEmit -p tsconfig.build.json"
   },
   "dependencies": {
-    "@pexip/utils": "16.13.0"
+    "@pexip/utils": "17.0.0"
   },
   "devDependencies": {
     "@jest/globals": "^29.7.0",
-    "@pexip/bundler": "17.1.0",
-    "@swc/core": "^1.4.6",
-    "@swc/jest": "^0.2.36",
+    "@pexip/bundler": "18.0.0",
+    "@swc/core": "^1.10.12",
+    "@swc/jest": "^0.2.37",
     "@types/uuid": "^8.3.0",
     "@types/webrtc": "^0.0.31",
     "jest": "^29.5.12",
     "jest-junit": "^16.0.0",
     "prettier": "^3.2.5",
-    "typescript": "~5.3.0",
+    "typescript": "~5.7.3",
     "uuid": "^11.0.0"
   },
   "publishConfig": {