medea-jason 0.14.2

//! [MediaStreamConstraints][1] wrapper.
//!
//! [1]: https://w3.org/TR/mediacapture-streams#dom-mediastreamconstraints

#![expect( // intentional
    clippy::new_without_default,
    reason = "makes no sense for `wasm_bindgen`"
)]

use derive_more::with_trait::{From, Into};
use wasm_bindgen::prelude::*;

use crate::{api::FacingMode, media, media::constraints::ConstrainBoolean};

/// [MediaStreamConstraints][1] wrapper.
///
/// [1]: https://w3.org/TR/mediacapture-streams#dom-mediastreamconstraints
#[wasm_bindgen]
#[derive(Clone, Debug, From, Into)]
pub struct MediaStreamSettings(media::MediaStreamSettings);

#[wasm_bindgen]
impl MediaStreamSettings {
    /// Creates new [`MediaStreamSettings`] with none constraints configured.
    #[must_use]
    #[wasm_bindgen(constructor)]
    pub fn new() -> Self {
        media::MediaStreamSettings::new().into()
    }

    /// Specifies the nature and settings of a device audio
    /// [MediaStreamTrack][1].
    ///
    /// [1]: https://w3.org/TR/mediacapture-streams#mediastreamtrack
    pub fn device_audio(&mut self, constraints: DeviceAudioTrackConstraints) {
        self.0.device_audio(constraints.into());
    }

    /// Specifies the nature and settings of a display audio
    /// [MediaStreamTrack][1].
    ///
    /// Behaviour is platform dependent and there is no propper feature check.
    /// It's known to only work in Chrome and Chrome-based browsers. It must
    /// always be coupled with [`DisplayVideoTrackConstraints`], meaning that
    /// system audio capture prompt is a part of the screen-sharing prompt, so
    /// if you try to request `display_audio` without `display_video` the UA
    /// will ask user for screen capture track anyway.
    ///
    /// It is also OS-dependent:
    /// 1. Only `Chrome-tab` audio can be captured on macOS and Linux.
    /// 2. Both `Chrome-tab` and `Entire screen` audio can be captured on
    ///    Windows.
    ///
    /// [1]: https://w3.org/TR/mediacapture-streams#mediastreamtrack
    pub fn display_audio(&mut self, constraints: DisplayAudioTrackConstraints) {
        self.0.display_audio(constraints.into());
    }

    /// Set constraints that will be used to obtain a local video sourced from
    /// a media device.
    pub fn device_video(&mut self, constraints: DeviceVideoTrackConstraints) {
        self.0.device_video(constraints.into());
    }

    /// Set constraints that will be used to capture a local video from a user's
    /// display.
    pub fn display_video(&mut self, constraints: DisplayVideoTrackConstraints) {
        self.0.display_video(constraints.into());
    }
}

/// Constraints applicable to device audio tracks (microphone).
#[wasm_bindgen]
#[derive(Debug, From, Into)]
pub struct DeviceAudioTrackConstraints(media::DeviceAudioTrackConstraints);

#[expect( // `wasm_bindgen` doesn't support `const fn`
    clippy::missing_const_for_fn,
    reason = "`wasm_bindgen` doesn't support `const fn`"
)]
#[wasm_bindgen]
impl DeviceAudioTrackConstraints {
    /// Creates new [`DeviceAudioTrackConstraints`] with none constraints
    /// configured.
    #[must_use]
    #[wasm_bindgen(constructor)]
    pub fn new() -> Self {
        media::DeviceAudioTrackConstraints::new().into()
    }

    /// Sets an exact [deviceId][1] constraint.
    ///
    /// [1]: https://w3.org/TR/mediacapture-streams#def-constraint-deviceId
    pub fn device_id(&mut self, device_id: String) {
        self.0.device_id(device_id);
    }

    /// Sets an exact [autoGainControl][1] constraint.
    ///
    /// [1]: https://w3.org/TR/mediacapture-streams#dfn-autogaincontrol
    pub fn exact_auto_gain_control(&mut self, agc: bool) {
        self.0.auto_gain_control = Some(ConstrainBoolean::Exact(agc));
    }

    /// Sets an ideal [autoGainControl][1] constraint.
    ///
    /// [1]: https://w3.org/TR/mediacapture-streams#dfn-autogaincontrol
    pub fn ideal_auto_gain_control(&mut self, agc: bool) {
        self.0.auto_gain_control = Some(ConstrainBoolean::Ideal(agc));
    }

    /// Sets an exact [noiseSuppression][1] constraint.
    ///
    /// [1]: https://w3.org/TR/mediacapture-streams#dfn-noisesuppression
    pub fn exact_noise_suppression(&mut self, ns: bool) {
        self.0.noise_suppression = Some(ConstrainBoolean::Exact(ns));
    }

    /// Sets an ideal [noiseSuppression][1] constraint.
    ///
    /// [1]: https://w3.org/TR/mediacapture-streams#dfn-noisesuppression
    pub fn ideal_noise_suppression(&mut self, ns: bool) {
        self.0.noise_suppression = Some(ConstrainBoolean::Ideal(ns));
    }

    /// Sets an exact [echoCancellation][1] constraint.
    ///
    /// [1]: https://w3.org/TR/mediacapture-streams#dfn-echocancellation
    pub fn exact_echo_cancellation(&mut self, aec: bool) {
        self.0.echo_cancellation = Some(ConstrainBoolean::Exact(aec));
    }

    /// Sets an ideal [echoCancellation][1] constraint.
    ///
    /// [1]: https://w3.org/TR/mediacapture-streams#dfn-echocancellation
    pub fn ideal_echo_cancellation(&mut self, aec: bool) {
        self.0.echo_cancellation = Some(ConstrainBoolean::Ideal(aec));
    }
}

/// Constraints applicable to display audio tracks (system audio capture).
#[wasm_bindgen]
#[derive(Copy, Clone, Debug, From, Into)]
pub struct DisplayAudioTrackConstraints(media::DisplayAudioTrackConstraints);

#[wasm_bindgen]
impl DisplayAudioTrackConstraints {
    /// Creates new [`DisplayAudioTrackConstraints`] with none constraints
    /// configured.
    #[must_use]
    #[wasm_bindgen(constructor)]
    pub fn new() -> Self {
        media::DisplayAudioTrackConstraints::new().into()
    }
}

/// Constraints applicable to audio tracks, sourced from a system audio
/// recording device (usually a microphone).
#[wasm_bindgen]
#[derive(Debug, From, Into)]
pub struct DeviceVideoTrackConstraints(media::DeviceVideoTrackConstraints);

/// Constraints applicable to video tracks that are sourced from a screen
/// capturing.
#[expect( // `wasm_bindgen` doesn't support `const fn`
    clippy::missing_const_for_fn,
    reason = "`wasm_bindgen` doesn't support `const fn`"
)]
#[wasm_bindgen]
impl DeviceVideoTrackConstraints {
    /// Creates new [`DeviceVideoTrackConstraints`] with none constraints
    /// configured.
    #[must_use]
    #[wasm_bindgen(constructor)]
    pub fn new() -> Self {
        media::DeviceVideoTrackConstraints::new().into()
    }

    /// Sets an exact [deviceId][1] constraint.
    ///
    /// [1]: https://w3.org/TR/mediacapture-streams#def-constraint-deviceId
    pub fn device_id(&mut self, device_id: String) {
        self.0.device_id(device_id);
    }

    /// Sets an exact [facingMode][1] constraint.
    ///
    /// [1]: https://w3.org/TR/mediacapture-streams#dom-constraindomstring
    pub fn exact_facing_mode(&mut self, facing_mode: FacingMode) {
        self.0.exact_facing_mode(facing_mode.into());
    }

    /// Sets an ideal [facingMode][1] constraint.
    ///
    /// [1]: https://w3.org/TR/mediacapture-streams#dom-constraindomstring
    pub fn ideal_facing_mode(&mut self, facing_mode: FacingMode) {
        self.0.ideal_facing_mode(facing_mode.into());
    }

    /// Sets an exact [`height`][1] constraint.
    ///
    /// [1]: https://tinyurl.com/w3-streams#def-constraint-height
    pub fn exact_height(&mut self, height: u32) {
        self.0.exact_height(height);
    }

    /// Sets an ideal [`height`][1] constraint.
    ///
    /// [1]: https://tinyurl.com/w3-streams#def-constraint-height
    pub fn ideal_height(&mut self, height: u32) {
        self.0.ideal_height(height);
    }

    /// Sets a range of a [`height`][1] constraint.
    ///
    /// [1]: https://tinyurl.com/w3-streams#def-constraint-height
    pub fn height_in_range(&mut self, min: u32, max: u32) {
        self.0.height_in_range(min, max);
    }

    /// Sets an exact [`width`][1] constraint.
    ///
    /// [1]: https://tinyurl.com/w3-streams#def-constraint-width
    pub fn exact_width(&mut self, width: u32) {
        self.0.exact_width(width);
    }

    /// Sets an ideal [`width`][1] constraint.
    ///
    /// [1]: https://tinyurl.com/w3-streams#def-constraint-width
    pub fn ideal_width(&mut self, width: u32) {
        self.0.ideal_width(width);
    }

    /// Sets a range of a [`width`][1] constraint.
    ///
    /// [1]: https://tinyurl.com/w3-streams#def-constraint-width
    pub fn width_in_range(&mut self, min: u32, max: u32) {
        self.0.width_in_range(min, max);
    }
}

/// Constraints applicable to video tracks sourced from a screen capturing.
#[wasm_bindgen]
#[derive(Clone, Debug, From, Into)]
pub struct DisplayVideoTrackConstraints(media::DisplayVideoTrackConstraints);

#[expect( // `wasm_bindgen` doesn't support `const fn`
    clippy::missing_const_for_fn,
    reason = "`wasm_bindgen` doesn't support `const fn`"
)]
#[wasm_bindgen]
impl DisplayVideoTrackConstraints {
    /// Creates new [`DisplayVideoTrackConstraints`] with none constraints
    /// configured.
    #[must_use]
    #[wasm_bindgen(constructor)]
    pub fn new() -> Self {
        media::DisplayVideoTrackConstraints::new().into()
    }

    /// Sets an exact [height][1] constraint.
    ///
    /// [1]: https://tinyurl.com/w3-streams#def-constraint-height
    pub fn exact_height(&mut self, height: u32) {
        self.0.exact_height(height);
    }

    /// Sets an ideal [height][1] constraint.
    ///
    /// [1]: https://tinyurl.com/w3-streams#def-constraint-height
    pub fn ideal_height(&mut self, height: u32) {
        self.0.ideal_height(height);
    }

    /// Sets an exact [width][1] constraint.
    ///
    /// [1]: https://tinyurl.com/w3-streams#def-constraint-width
    pub fn exact_width(&mut self, width: u32) {
        self.0.exact_width(width);
    }

    /// Sets an ideal [width][1] constraint.
    ///
    /// [1]: https://tinyurl.com/w3-streams#def-constraint-width
    pub fn ideal_width(&mut self, width: u32) {
        self.0.ideal_width(width);
    }

    /// Sets an exact [frameRate][1] constraint.
    ///
    /// [1]: https://w3.org/TR/mediacapture-streams#dfn-framerate
    pub fn exact_frame_rate(&mut self, frame_rate: u32) {
        self.0.exact_frame_rate(frame_rate);
    }

    /// Sets an ideal [frameRate][1] constraint.
    ///
    /// [1]: https://w3.org/TR/mediacapture-streams#dfn-framerate
    pub fn ideal_frame_rate(&mut self, frame_rate: u32) {
        self.0.ideal_frame_rate(frame_rate);
    }
}