livekit-client 0.14.0 → 0.15.0

package/dist/room/track/options.d.ts

@@ -17,12 +17,12 @@ export interface TrackPublishDefaults {
      */
     audioBitrate?: number;
     /**
-     * dtx (Discontinuous Tranmission of audio), defaults to true
+     * dtx (Discontinuous Transmission of audio), defaults to true
      */
     dtx?: boolean;
     /**
-     * use simulcast, defaults to false.
-     * When using simulcast, LiveKit will publish up to three version of the stream
+     * use simulcast, defaults to true.
+     * When using simulcast, LiveKit will publish up to three versions of the stream
      * at various resolutions.
      */
     simulcast?: boolean;
@@ -36,40 +36,6 @@ export interface TrackPublishDefaults {
      */
     stopMicTrackOnMute?: boolean;
 }
-export interface TrackCaptureDefaults {
-    /**
-     * default device to use for microphone capture
-     */
-    audioDeviceId?: string;
-    /**
-     * specifies whether automatic gain control is preferred, defaults to true
-     */
-    autoGainControl?: boolean;
-    /**
-     * the channel count or range of channel counts which are acceptable and/or required
-     */
-    channelCount?: number;
-    /**
-     * whether or not echo cancellation is preferred, defaults to true
-     */
-    echoCancellation?: boolean;
-    /**
-     * whether noise suppression is preferred, defaults to true
-     */
-    noiseSuppression?: boolean;
-    /**
-     * set if a particular video facing mode is preferred
-     */
-    videoFacingMode?: 'user' | 'environment' | 'left' | 'right';
-    /**
-     * default device to use for camera capture
-     */
-    videoDeviceId?: string;
-    /**
-     * default video capture resolution
-     */
-    videoResolution?: VideoResolution;
-}
 /**
  * Options when publishing tracks
  */
@@ -88,33 +54,26 @@ export interface CreateLocalTracksOptions {
      * audio track options, true to create with defaults. false if audio shouldn't be created
      * default true
      */
-    audio?: boolean | CreateAudioTrackOptions;
+    audio?: boolean | AudioCaptureOptions;
     /**
      * video track options, true to create with defaults. false if video shouldn't be created
      * default true
      */
-    video?: boolean | CreateVideoTrackOptions;
+    video?: boolean | VideoCaptureOptions;
 }
-export interface CreateLocalTrackOptions {
-    /** name of track */
-    name?: string;
+export interface VideoCaptureOptions {
     /**
      * A ConstrainDOMString object specifying a device ID or an array of device
      * IDs which are acceptable and/or required.
      */
     deviceId?: ConstrainDOMString;
-}
-export interface CreateVideoTrackOptions extends CreateLocalTrackOptions {
     /**
      * a facing or an array of facings which are acceptable and/or required.
-     * [valid options](https://developer.mozilla.org/en-US/docs/Web/API/MediaTrackConstraints/facingMode)
      */
-    facingMode?: ConstrainDOMString;
+    facingMode?: 'user' | 'environment' | 'left' | 'right';
     resolution?: VideoResolution;
 }
-export interface CreateScreenTrackOptions {
-    /** name of track, defaults to "screen" */
-    name?: string;
+export interface ScreenShareCaptureOptions {
     /**
      * true to capture audio shared. browser support for audio capturing in
      * screenshare is limited: https://developer.mozilla.org/en-US/docs/Web/API/MediaDevices/getDisplayMedia#browser_compatibility
@@ -123,7 +82,7 @@ export interface CreateScreenTrackOptions {
     /** capture resolution, defaults to full HD */
     resolution?: VideoResolution;
 }
-export interface CreateAudioTrackOptions extends CreateLocalTrackOptions {
+export interface AudioCaptureOptions {
     /**
      * specifies whether automatic gain control is preferred and/or required
      */
@@ -132,6 +91,11 @@ export interface CreateAudioTrackOptions extends CreateLocalTrackOptions {
      * the channel count or range of channel counts which are acceptable and/or required
      */
     channelCount?: ConstrainULong;
+    /**
+     * A ConstrainDOMString object specifying a device ID or an array of device
+     * IDs which are acceptable and/or required.
+     */
+    deviceId?: ConstrainDOMString;
     /**
      * whether or not echo cancellation is preferred and/or required
      */
@@ -153,20 +117,6 @@ export interface CreateAudioTrackOptions extends CreateLocalTrackOptions {
      */
     sampleSize?: ConstrainULong;
 }
-/**
- * example
- *
- * ```typescript
- * {
- *   width: 960,
- *   height: 540,
- *   frameRate: {
- *     ideal: 30,
- *     max: 60,
- *   },
- * }
- * ```
- */
 export interface VideoResolution {
     width: number;
     height: number;
@@ -181,7 +131,7 @@ export declare class VideoPreset {
     encoding: VideoEncoding;
     width: number;
     height: number;
-    constructor(width: number, height: number, maxBitrate: number, maxFramerate: number);
+    constructor(width: number, height: number, maxBitrate: number, maxFramerate?: number);
     get resolution(): VideoResolution;
 }
 export interface AudioPreset {

package/dist/room/track/options.js

@@ -15,6 +15,7 @@ class VideoPreset {
             width: this.width,
             height: this.height,
             frameRate: this.encoding.maxFramerate,
+            aspectRatio: this.width / this.height,
         };
     }
 }
@@ -35,27 +36,27 @@ var AudioPresets;
  * Sane presets for video resolution/encoding
  */
 exports.VideoPresets = {
-    qvga: new VideoPreset(320, 180, 125000, 15),
-    vga: new VideoPreset(640, 360, 400000, 30),
-    qhd: new VideoPreset(960, 540, 800000, 30),
-    hd: new VideoPreset(1280, 720, 2500000, 30),
-    fhd: new VideoPreset(1920, 1080, 4000000, 30),
+    qvga: new VideoPreset(320, 180, 120000, 10),
+    vga: new VideoPreset(640, 360, 300000, 20),
+    qhd: new VideoPreset(960, 540, 600000, 25),
+    hd: new VideoPreset(1280, 720, 2000000, 30),
+    fhd: new VideoPreset(1920, 1080, 3000000, 30),
 };
 /**
  * Four by three presets
  */
 exports.VideoPresets43 = {
-    qvga: new VideoPreset(240, 180, 100000, 15),
-    vga: new VideoPreset(480, 360, 320000, 30),
-    qhd: new VideoPreset(720, 540, 640000, 30),
-    hd: new VideoPreset(960, 720, 2000000, 30),
-    fhd: new VideoPreset(1440, 1080, 3200000, 30),
+    qvga: new VideoPreset(240, 180, 90000, 10),
+    vga: new VideoPreset(480, 360, 225000, 20),
+    qhd: new VideoPreset(720, 540, 450000, 25),
+    hd: new VideoPreset(960, 720, 1500000, 30),
+    fhd: new VideoPreset(1440, 1080, 2800000, 30),
 };
 exports.ScreenSharePresets = {
     vga: new VideoPreset(640, 360, 200000, 3),
     hd_8: new VideoPreset(1280, 720, 400000, 5),
-    hd_15: new VideoPreset(1280, 720, 1250000, 15),
-    fhd_15: new VideoPreset(1920, 1080, 2000000, 15),
-    fhd_30: new VideoPreset(1920, 1080, 4000000, 30),
+    hd_15: new VideoPreset(1280, 720, 1000000, 15),
+    fhd_15: new VideoPreset(1920, 1080, 1500000, 15),
+    fhd_30: new VideoPreset(1920, 1080, 3000000, 30),
 };
 //# sourceMappingURL=options.js.map

package/dist/room/track/options.js.map

@@ -1 +1 @@
-{"version":3,"file":"options.js","sourceRoot":"","sources":["../../../src/room/track/options.ts"],"names":[],"mappings":";;;AAwNA,MAAa,WAAW;IAOtB,YAAY,KAAa,EAAE,MAAc,EAAE,UAAkB,EAAE,YAAoB;QACjF,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,QAAQ,GAAG;YACd,UAAU;YACV,YAAY;SACb,CAAC;IACJ,CAAC;IAED,IAAI,UAAU;QACZ,OAAO;YACL,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,SAAS,EAAE,IAAI,CAAC,QAAQ,CAAC,YAAY;SACtC,CAAC;IACJ,CAAC;CACF;AAvBD,kCAuBC;AAQD,IAAiB,YAAY,CAU5B;AAVD,WAAiB,YAAY;IACd,sBAAS,GAAgB;QACpC,UAAU,EAAE,KAAM;KACnB,CAAC;IACW,mBAAM,GAAgB;QACjC,UAAU,EAAE,KAAM;KACnB,CAAC;IACW,kBAAK,GAAgB;QAChC,UAAU,EAAE,KAAM;KACnB,CAAC;AACJ,CAAC,EAVgB,YAAY,GAAZ,oBAAY,KAAZ,oBAAY,QAU5B;AAED;;GAEG;AACU,QAAA,YAAY,GAAG;IAC1B,IAAI,EAAE,IAAI,WAAW,CAAC,GAAG,EAAE,GAAG,EAAE,MAAO,EAAE,EAAE,CAAC;IAC5C,GAAG,EAAE,IAAI,WAAW,CAAC,GAAG,EAAE,GAAG,EAAE,MAAO,EAAE,EAAE,CAAC;IAC3C,GAAG,EAAE,IAAI,WAAW,CAAC,GAAG,EAAE,GAAG,EAAE,MAAO,EAAE,EAAE,CAAC;IAC3C,EAAE,EAAE,IAAI,WAAW,CAAC,IAAI,EAAE,GAAG,EAAE,OAAS,EAAE,EAAE,CAAC;IAC7C,GAAG,EAAE,IAAI,WAAW,CAAC,IAAI,EAAE,IAAI,EAAE,OAAS,EAAE,EAAE,CAAC;CAChD,CAAC;AAEF;;GAEG;AACU,QAAA,cAAc,GAAG;IAC5B,IAAI,EAAE,IAAI,WAAW,CAAC,GAAG,EAAE,GAAG,EAAE,MAAO,EAAE,EAAE,CAAC;IAC5C,GAAG,EAAE,IAAI,WAAW,CAAC,GAAG,EAAE,GAAG,EAAE,MAAO,EAAE,EAAE,CAAC;IAC3C,GAAG,EAAE,IAAI,WAAW,CAAC,GAAG,EAAE,GAAG,EAAE,MAAO,EAAE,EAAE,CAAC;IAC3C,EAAE,EAAE,IAAI,WAAW,CAAC,GAAG,EAAE,GAAG,EAAE,OAAS,EAAE,EAAE,CAAC;IAC5C,GAAG,EAAE,IAAI,WAAW,CAAC,IAAI,EAAE,IAAI,EAAE,OAAS,EAAE,EAAE,CAAC;CAChD,CAAC;AAEW,QAAA,kBAAkB,GAAG;IAChC,GAAG,EAAE,IAAI,WAAW,CAAC,GAAG,EAAE,GAAG,EAAE,MAAO,EAAE,CAAC,CAAC;IAC1C,IAAI,EAAE,IAAI,WAAW,CAAC,IAAI,EAAE,GAAG,EAAE,MAAO,EAAE,CAAC,CAAC;IAC5C,KAAK,EAAE,IAAI,WAAW,CAAC,IAAI,EAAE,GAAG,EAAE,OAAS,EAAE,EAAE,CAAC;IAChD,MAAM,EAAE,IAAI,WAAW,CAAC,IAAI,EAAE,IAAI,EAAE,OAAS,EAAE,EAAE,CAAC;IAClD,MAAM,EAAE,IAAI,WAAW,CAAC,IAAI,EAAE,IAAI,EAAE,OAAS,EAAE,EAAE,CAAC;CACnD,CAAC"}
+{"version":3,"file":"options.js","sourceRoot":"","sources":["../../../src/room/track/options.ts"],"names":[],"mappings":";;;AA4JA,MAAa,WAAW;IAOtB,YAAY,KAAa,EAAE,MAAc,EAAE,UAAkB,EAAE,YAAqB;QAClF,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,QAAQ,GAAG;YACd,UAAU;YACV,YAAY;SACb,CAAC;IACJ,CAAC;IAED,IAAI,UAAU;QACZ,OAAO;YACL,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,SAAS,EAAE,IAAI,CAAC,QAAQ,CAAC,YAAY;YACrC,WAAW,EAAE,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,MAAM;SACtC,CAAC;IACJ,CAAC;CACF;AAxBD,kCAwBC;AAQD,IAAiB,YAAY,CAU5B;AAVD,WAAiB,YAAY;IACd,sBAAS,GAAgB;QACpC,UAAU,EAAE,KAAM;KACnB,CAAC;IACW,mBAAM,GAAgB;QACjC,UAAU,EAAE,KAAM;KACnB,CAAC;IACW,kBAAK,GAAgB;QAChC,UAAU,EAAE,KAAM;KACnB,CAAC;AACJ,CAAC,EAVgB,YAAY,GAAZ,oBAAY,KAAZ,oBAAY,QAU5B;AAED;;GAEG;AACU,QAAA,YAAY,GAAG;IAC1B,IAAI,EAAE,IAAI,WAAW,CAAC,GAAG,EAAE,GAAG,EAAE,MAAO,EAAE,EAAE,CAAC;IAC5C,GAAG,EAAE,IAAI,WAAW,CAAC,GAAG,EAAE,GAAG,EAAE,MAAO,EAAE,EAAE,CAAC;IAC3C,GAAG,EAAE,IAAI,WAAW,CAAC,GAAG,EAAE,GAAG,EAAE,MAAO,EAAE,EAAE,CAAC;IAC3C,EAAE,EAAE,IAAI,WAAW,CAAC,IAAI,EAAE,GAAG,EAAE,OAAS,EAAE,EAAE,CAAC;IAC7C,GAAG,EAAE,IAAI,WAAW,CAAC,IAAI,EAAE,IAAI,EAAE,OAAS,EAAE,EAAE,CAAC;CAChD,CAAC;AAEF;;GAEG;AACU,QAAA,cAAc,GAAG;IAC5B,IAAI,EAAE,IAAI,WAAW,CAAC,GAAG,EAAE,GAAG,EAAE,KAAM,EAAE,EAAE,CAAC;IAC3C,GAAG,EAAE,IAAI,WAAW,CAAC,GAAG,EAAE,GAAG,EAAE,MAAO,EAAE,EAAE,CAAC;IAC3C,GAAG,EAAE,IAAI,WAAW,CAAC,GAAG,EAAE,GAAG,EAAE,MAAO,EAAE,EAAE,CAAC;IAC3C,EAAE,EAAE,IAAI,WAAW,CAAC,GAAG,EAAE,GAAG,EAAE,OAAS,EAAE,EAAE,CAAC;IAC5C,GAAG,EAAE,IAAI,WAAW,CAAC,IAAI,EAAE,IAAI,EAAE,OAAS,EAAE,EAAE,CAAC;CAChD,CAAC;AAEW,QAAA,kBAAkB,GAAG;IAChC,GAAG,EAAE,IAAI,WAAW,CAAC,GAAG,EAAE,GAAG,EAAE,MAAO,EAAE,CAAC,CAAC;IAC1C,IAAI,EAAE,IAAI,WAAW,CAAC,IAAI,EAAE,GAAG,EAAE,MAAO,EAAE,CAAC,CAAC;IAC5C,KAAK,EAAE,IAAI,WAAW,CAAC,IAAI,EAAE,GAAG,EAAE,OAAS,EAAE,EAAE,CAAC;IAChD,MAAM,EAAE,IAAI,WAAW,CAAC,IAAI,EAAE,IAAI,EAAE,OAAS,EAAE,EAAE,CAAC;IAClD,MAAM,EAAE,IAAI,WAAW,CAAC,IAAI,EAAE,IAAI,EAAE,OAAS,EAAE,EAAE,CAAC;CACnD,CAAC"}

package/dist/room/track/utils.d.ts

@@ -0,0 +1,3 @@
+import { AudioCaptureOptions, CreateLocalTracksOptions, VideoCaptureOptions } from './options';
+export declare function mergeDefaultOptions(options?: CreateLocalTracksOptions, audioDefaults?: AudioCaptureOptions, videoDefaults?: VideoCaptureOptions): CreateLocalTracksOptions;
+export declare function constraintsForOptions(options: CreateLocalTracksOptions): MediaStreamConstraints;

package/dist/room/track/utils.js

@@ -0,0 +1,68 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.constraintsForOptions = exports.mergeDefaultOptions = void 0;
+function mergeDefaultOptions(options, audioDefaults, videoDefaults) {
+    const opts = Object.assign({}, options);
+    if (opts.audio === true)
+        opts.audio = {};
+    if (opts.video === true)
+        opts.video = {};
+    // use defaults
+    if (opts.audio) {
+        mergeObjectWithoutOverwriting(opts.audio, audioDefaults);
+    }
+    if (opts.video) {
+        mergeObjectWithoutOverwriting(opts.video, videoDefaults);
+    }
+    return opts;
+}
+exports.mergeDefaultOptions = mergeDefaultOptions;
+function mergeObjectWithoutOverwriting(mainObject, objectToMerge) {
+    Object.keys(objectToMerge).forEach((key) => {
+        if (mainObject[key] === undefined)
+            mainObject[key] = objectToMerge[key];
+    });
+    return mainObject;
+}
+function constraintsForOptions(options) {
+    const constraints = {};
+    if (options.video) {
+        // default video options
+        if (typeof options.video === 'object') {
+            const videoOptions = {};
+            const target = videoOptions;
+            const source = options.video;
+            Object.keys(source).forEach((key) => {
+                switch (key) {
+                    case 'resolution':
+                        // flatten VideoResolution fields
+                        mergeObjectWithoutOverwriting(target, source.resolution);
+                        break;
+                    default:
+                        target[key] = source[key];
+                }
+            });
+            constraints.video = videoOptions;
+        }
+        else {
+            constraints.video = options.video;
+        }
+    }
+    else {
+        constraints.video = false;
+    }
+    if (options.audio) {
+        if (typeof options.audio === 'object') {
+            constraints.audio = options.audio;
+        }
+        else {
+            constraints.audio = true;
+        }
+    }
+    else {
+        constraints.audio = false;
+    }
+    return constraints;
+}
+exports.constraintsForOptions = constraintsForOptions;
+//# sourceMappingURL=utils.js.map

package/dist/room/track/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../src/room/track/utils.ts"],"names":[],"mappings":";;;AAKA,SAAgB,mBAAmB,CACjC,OAAkC,EAClC,aAAmC,EACnC,aAAmC;IAEnC,MAAM,IAAI,qBACL,OAAO,CACX,CAAC;IACF,IAAI,IAAI,CAAC,KAAK,KAAK,IAAI;QAAE,IAAI,CAAC,KAAK,GAAG,EAAE,CAAC;IACzC,IAAI,IAAI,CAAC,KAAK,KAAK,IAAI;QAAE,IAAI,CAAC,KAAK,GAAG,EAAE,CAAC;IAEzC,eAAe;IACf,IAAI,IAAI,CAAC,KAAK,EAAE;QACd,6BAA6B,CAAC,IAAI,CAAC,KAAgC,EACjE,aAAwC,CAAC,CAAC;KAC7C;IACD,IAAI,IAAI,CAAC,KAAK,EAAE;QACd,6BAA6B,CAAC,IAAI,CAAC,KAAgC,EACjE,aAAwC,CAAC,CAAC;KAC7C;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AArBD,kDAqBC;AAED,SAAS,6BAA6B,CACpC,UAAmC,EACnC,aAAsC;IAEtC,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE;QACzC,IAAI,UAAU,CAAC,GAAG,CAAC,KAAK,SAAS;YAAE,UAAU,CAAC,GAAG,CAAC,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC;IAC1E,CAAC,CAAC,CAAC;IACH,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,SAAgB,qBAAqB,CAAC,OAAiC;IACrE,MAAM,WAAW,GAA2B,EAAE,CAAC;IAE/C,IAAI,OAAO,CAAC,KAAK,EAAE;QACjB,wBAAwB;QACxB,IAAI,OAAO,OAAO,CAAC,KAAK,KAAK,QAAQ,EAAE;YACrC,MAAM,YAAY,GAA0B,EAAE,CAAC;YAC/C,MAAM,MAAM,GAAG,YAAuC,CAAC;YACvD,MAAM,MAAM,GAAG,OAAO,CAAC,KAAgC,CAAC;YACxD,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE;gBAClC,QAAQ,GAAG,EAAE;oBACX,KAAK,YAAY;wBACf,iCAAiC;wBACjC,6BAA6B,CAAC,MAAM,EAAE,MAAM,CAAC,UAAqC,CAAC,CAAC;wBACpF,MAAM;oBACR;wBACE,MAAM,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;iBAC7B;YACH,CAAC,CAAC,CAAC;YACH,WAAW,CAAC,KAAK,GAAG,YAAY,CAAC;SAClC;aAAM;YACL,WAAW,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;SACnC;KACF;SAAM;QACL,WAAW,CAAC,KAAK,GAAG,KAAK,CAAC;KAC3B;IAED,IAAI,OAAO,CAAC,KAAK,EAAE;QACjB,IAAI,OAAO,OAAO,CAAC,KAAK,KAAK,QAAQ,EAAE;YACrC,WAAW,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;SACnC;aAAM;YACL,WAAW,CAAC,KAAK,GAAG,IAAI,CAAC;SAC1B;KACF;SAAM;QACL,WAAW,CAAC,KAAK,GAAG,KAAK,CAAC;KAC3B;IACD,OAAO,WAAW,CAAC;AACrB,CAAC;AArCD,sDAqCC"}

package/dist/room/track/utils.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/room/track/utils.test.js

@@ -0,0 +1,85 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const options_1 = require("./options");
+const utils_1 = require("./utils");
+describe('mergeDefaultOptions', () => {
+    const audioDefaults = {
+        autoGainControl: true,
+        channelCount: 2,
+    };
+    const videoDefaults = {
+        deviceId: 'video123',
+        resolution: options_1.VideoPresets.fhd.resolution,
+    };
+    it('does not enable undefined options', () => {
+        const opts = utils_1.mergeDefaultOptions(undefined, audioDefaults, videoDefaults);
+        expect(opts.audio).toEqual(undefined);
+        expect(opts.video).toEqual(undefined);
+    });
+    it('does not enable explicitly disabled', () => {
+        const opts = utils_1.mergeDefaultOptions({
+            video: false,
+        });
+        expect(opts.audio).toEqual(undefined);
+        expect(opts.video).toEqual(false);
+    });
+    it('accepts true for options', () => {
+        const opts = utils_1.mergeDefaultOptions({
+            audio: true,
+        }, audioDefaults, videoDefaults);
+        expect(opts.audio).toEqual(audioDefaults);
+        expect(opts.video).toEqual(undefined);
+    });
+    it('enables overriding specific fields', () => {
+        const opts = utils_1.mergeDefaultOptions({
+            audio: { channelCount: 1 },
+        }, audioDefaults, videoDefaults);
+        const audioOpts = opts.audio;
+        expect(audioOpts.channelCount).toEqual(1);
+        expect(audioOpts.autoGainControl).toEqual(true);
+    });
+    it('does not override explicit false', () => {
+        const opts = utils_1.mergeDefaultOptions({
+            audio: { autoGainControl: false },
+        }, audioDefaults, videoDefaults);
+        const audioOpts = opts.audio;
+        expect(audioOpts.autoGainControl).toEqual(false);
+    });
+});
+describe('constraintsForOptions', () => {
+    it('correctly enables audio bool', () => {
+        const constraints = utils_1.constraintsForOptions({
+            audio: true,
+        });
+        expect(constraints.audio).toEqual(true);
+        expect(constraints.video).toEqual(false);
+    });
+    it('converts audio options correctly', () => {
+        const constraints = utils_1.constraintsForOptions({
+            audio: {
+                noiseSuppression: true,
+                echoCancellation: false,
+            },
+        });
+        const audioOpts = constraints.audio;
+        expect(Object.keys(audioOpts)).toEqual(['noiseSuppression', 'echoCancellation']);
+        expect(audioOpts.noiseSuppression).toEqual(true);
+        expect(audioOpts.echoCancellation).toEqual(false);
+    });
+    it('converts video options correctly', () => {
+        const constraints = utils_1.constraintsForOptions({
+            video: {
+                resolution: options_1.VideoPresets.hd.resolution,
+                facingMode: 'user',
+                deviceId: 'video123',
+            },
+        });
+        const videoOpts = constraints.video;
+        expect(Object.keys(videoOpts)).toEqual(['width', 'height', 'frameRate', 'aspectRatio', 'facingMode', 'deviceId']);
+        expect(videoOpts.width).toEqual(options_1.VideoPresets.hd.resolution.width);
+        expect(videoOpts.height).toEqual(options_1.VideoPresets.hd.resolution.height);
+        expect(videoOpts.frameRate).toEqual(options_1.VideoPresets.hd.resolution.frameRate);
+        expect(videoOpts.aspectRatio).toEqual(options_1.VideoPresets.hd.resolution.aspectRatio);
+    });
+});
+//# sourceMappingURL=utils.test.js.map

package/dist/room/track/utils.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.test.js","sourceRoot":"","sources":["../../../src/room/track/utils.test.ts"],"names":[],"mappings":";;AAAA,uCAEmB;AACnB,mCAAqE;AAErE,QAAQ,CAAC,qBAAqB,EAAE,GAAG,EAAE;IACnC,MAAM,aAAa,GAAwB;QACzC,eAAe,EAAE,IAAI;QACrB,YAAY,EAAE,CAAC;KAChB,CAAC;IACF,MAAM,aAAa,GAAwB;QACzC,QAAQ,EAAE,UAAU;QACpB,UAAU,EAAE,sBAAY,CAAC,GAAG,CAAC,UAAU;KACxC,CAAC;IAEF,EAAE,CAAC,mCAAmC,EAAE,GAAG,EAAE;QAC3C,MAAM,IAAI,GAAG,2BAAmB,CAAC,SAAS,EAAE,aAAa,EAAE,aAAa,CAAC,CAAC;QAC1E,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QACtC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IACxC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qCAAqC,EAAE,GAAG,EAAE;QAC7C,MAAM,IAAI,GAAG,2BAAmB,CAAC;YAC/B,KAAK,EAAE,KAAK;SACb,CAAC,CAAC;QACH,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QACtC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IACpC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0BAA0B,EAAE,GAAG,EAAE;QAClC,MAAM,IAAI,GAAG,2BAAmB,CAAC;YAC/B,KAAK,EAAE,IAAI;SACZ,EAAE,aAAa,EAAE,aAAa,CAAC,CAAC;QACjC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;QAC1C,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IACxC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oCAAoC,EAAE,GAAG,EAAE;QAC5C,MAAM,IAAI,GAAG,2BAAmB,CAAC;YAC/B,KAAK,EAAE,EAAE,YAAY,EAAE,CAAC,EAAE;SAC3B,EAAE,aAAa,EAAE,aAAa,CAAC,CAAC;QACjC,MAAM,SAAS,GAAG,IAAI,CAAC,KAA4B,CAAC;QACpD,MAAM,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;QAC1C,MAAM,CAAC,SAAS,CAAC,eAAe,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAClD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kCAAkC,EAAE,GAAG,EAAE;QAC1C,MAAM,IAAI,GAAG,2BAAmB,CAAC;YAC/B,KAAK,EAAE,EAAE,eAAe,EAAE,KAAK,EAAE;SAClC,EAAE,aAAa,EAAE,aAAa,CAAC,CAAC;QACjC,MAAM,SAAS,GAAG,IAAI,CAAC,KAA4B,CAAC;QACpD,MAAM,CAAC,SAAS,CAAC,eAAe,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IACnD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,uBAAuB,EAAE,GAAG,EAAE;IACrC,EAAE,CAAC,8BAA8B,EAAE,GAAG,EAAE;QACtC,MAAM,WAAW,GAAG,6BAAqB,CAAC;YACxC,KAAK,EAAE,IAAI;SACZ,CAAC,CAAC;QACH,MAAM,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACxC,MAAM,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IAC3C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kCAAkC,EAAE,GAAG,EAAE;QAC1C,MAAM,WAAW,GAAG,6BAAqB,CAAC;YACxC,KAAK,EAAE;gBACL,gBAAgB,EAAE,IAAI;gBACtB,gBAAgB,EAAE,KAAK;aACxB;SACF,CAAC,CAAC;QACH,MAAM,SAAS,GAAG,WAAW,CAAC,KAA8B,CAAC;QAC7D,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,kBAAkB,EAAE,kBAAkB,CAAC,CAAC,CAAC;QACjF,MAAM,CAAC,SAAS,CAAC,gBAAgB,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACjD,MAAM,CAAC,SAAS,CAAC,gBAAgB,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IACpD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kCAAkC,EAAE,GAAG,EAAE;QAC1C,MAAM,WAAW,GAAG,6BAAqB,CAAC;YACxC,KAAK,EAAE;gBACL,UAAU,EAAE,sBAAY,CAAC,EAAE,CAAC,UAAU;gBACtC,UAAU,EAAE,MAAM;gBAClB,QAAQ,EAAE,UAAU;aACrB;SACF,CAAC,CAAC;QACH,MAAM,SAAS,GAAG,WAAW,CAAC,KAA8B,CAAC;QAC7D,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,aAAa,EAAE,YAAY,EAAE,UAAU,CAAC,CAAC,CAAC;QAClH,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,sBAAY,CAAC,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;QAClE,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,sBAAY,CAAC,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;QACpE,MAAM,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,OAAO,CAAC,sBAAY,CAAC,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;QAC1E,MAAM,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC,OAAO,CAAC,sBAAY,CAAC,EAAE,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;IAChF,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/room/utils.d.ts

@@ -1,3 +1,9 @@
 export declare function unpackStreamId(packed: string): string[];
 export declare function useLegacyAPI(): boolean;
 export declare function sleep(duration: number): Promise<void>;
+export declare const getResizeObserver: () => ResizeObserver;
+export declare const getIntersectionObserver: () => IntersectionObserver;
+export interface ObservableMediaElement extends HTMLMediaElement {
+    handleResize: (entry: ResizeObserverEntry) => void;
+    handleVisibilityChanged: (entry: IntersectionObserverEntry) => void;
+}

package/dist/room/utils.js

@@ -9,7 +9,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
     });
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.sleep = exports.useLegacyAPI = exports.unpackStreamId = void 0;
+exports.getIntersectionObserver = exports.getResizeObserver = exports.sleep = exports.useLegacyAPI = exports.unpackStreamId = void 0;
 const separator = '|';
 function unpackStreamId(packed) {
     const parts = packed.split(separator);
@@ -30,4 +30,28 @@ function sleep(duration) {
     });
 }
 exports.sleep = sleep;
+function roDispatchCallback(entries) {
+    for (const entry of entries) {
+        entry.target.handleResize(entry);
+    }
+}
+function ioDispatchCallback(entries) {
+    for (const entry of entries) {
+        entry.target.handleVisibilityChanged(entry);
+    }
+}
+let resizeObserver = null;
+const getResizeObserver = () => {
+    if (!resizeObserver)
+        resizeObserver = new ResizeObserver(roDispatchCallback);
+    return resizeObserver;
+};
+exports.getResizeObserver = getResizeObserver;
+let intersectionObserver = null;
+const getIntersectionObserver = () => {
+    if (!intersectionObserver)
+        intersectionObserver = new IntersectionObserver(ioDispatchCallback);
+    return intersectionObserver;
+};
+exports.getIntersectionObserver = getIntersectionObserver;
 //# sourceMappingURL=utils.js.map

package/dist/room/utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/room/utils.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,MAAM,SAAS,GAAG,GAAG,CAAC;AAEtB,SAAgB,cAAc,CAAC,MAAc;IAC3C,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IACtC,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE;QACpB,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC;KACvD;IACD,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;AACtB,CAAC;AAND,wCAMC;AAED,SAAgB,YAAY;IAC1B,6CAA6C;IAC7C,OAAO,OAAO,SAAS,KAAK,WAAW,IAAI,SAAS,CAAC,OAAO,KAAK,aAAa,CAAC;AACjF,CAAC;AAHD,oCAGC;AAED,SAAsB,KAAK,CAAC,QAAgB;;QAC1C,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC;IACjE,CAAC;CAAA;AAFD,sBAEC"}
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/room/utils.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,MAAM,SAAS,GAAG,GAAG,CAAC;AAEtB,SAAgB,cAAc,CAAC,MAAc;IAC3C,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IACtC,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE;QACpB,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC;KACvD;IACD,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;AACtB,CAAC;AAND,wCAMC;AAED,SAAgB,YAAY;IAC1B,6CAA6C;IAC7C,OAAO,OAAO,SAAS,KAAK,WAAW,IAAI,SAAS,CAAC,OAAO,KAAK,aAAa,CAAC;AACjF,CAAC;AAHD,oCAGC;AAED,SAAsB,KAAK,CAAC,QAAgB;;QAC1C,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC;IACjE,CAAC;CAAA;AAFD,sBAEC;AAED,SAAS,kBAAkB,CAAC,OAA8B;IACxD,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE;QAC1B,KAAK,CAAC,MAAiC,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;KAC9D;AACH,CAAC;AAED,SAAS,kBAAkB,CAAC,OAAoC;IAC9D,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE;QAC1B,KAAK,CAAC,MAAiC,CAAC,uBAAuB,CAAC,KAAK,CAAC,CAAC;KACzE;AACH,CAAC;AAED,IAAI,cAAc,GAA0B,IAAI,CAAC;AAC1C,MAAM,iBAAiB,GAAG,GAAG,EAAE;IACpC,IAAI,CAAC,cAAc;QAAE,cAAc,GAAG,IAAI,cAAc,CAAC,kBAAkB,CAAC,CAAC;IAC7E,OAAO,cAAc,CAAC;AACxB,CAAC,CAAC;AAHW,QAAA,iBAAiB,qBAG5B;AAEF,IAAI,oBAAoB,GAAgC,IAAI,CAAC;AACtD,MAAM,uBAAuB,GAAG,GAAG,EAAE;IAC1C,IAAI,CAAC,oBAAoB;QAAE,oBAAoB,GAAG,IAAI,oBAAoB,CAAC,kBAAkB,CAAC,CAAC;IAC/F,OAAO,oBAAoB,CAAC;AAC9B,CAAC,CAAC;AAHW,QAAA,uBAAuB,2BAGlC"}

package/dist/version.d.ts

@@ -1,2 +1,2 @@
-export declare const version = "0.14.0";
+export declare const version = "0.15.0";
 export declare const protocolVersion = 5;

package/dist/version.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.protocolVersion = exports.version = void 0;
-exports.version = '0.14.0';
+exports.version = '0.15.0';
 exports.protocolVersion = 5;
 //# sourceMappingURL=version.js.map