@textrp/briij-js-sdk 41.0.0 → 42.0.0

package/src/webrtc/stats/media/mediaTrackHandler.ts

@@ -1,70 +1,70 @@
-/*
-Copyright 2023 The Matrix.org Foundation C.I.C.
-
-Licensed under the Apache License, Version 2.0 (the "License");
-you may not use this file except in compliance with the License.
-You may obtain a copy of the License at
-
-    http://www.apache.org/licenses/LICENSE-2.0
-
-Unless required by applicable law or agreed to in writing, software
-distributed under the License is distributed on an "AS IS" BASIS,
-WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-See the License for the specific language governing permissions and
-limitations under the License.
-*/
-
-export type TrackId = string;
-
-export class MediaTrackHandler {
-    public constructor(private readonly pc: RTCPeerConnection) {}
-
-    public getLocalTracks(kind: "audio" | "video"): MediaStreamTrack[] {
-        const isNotNullAndKind = (track: MediaStreamTrack | null): boolean => {
-            return track !== null && track.kind === kind;
-        };
-        return this.pc
-            .getTransceivers()
-            .filter((t) => t.currentDirection === "sendonly" || t.currentDirection === "sendrecv")
-            .filter((t) => t.sender !== null)
-            .map((t) => t.sender)
-            .map((s) => s.track)
-            .filter(isNotNullAndKind) as MediaStreamTrack[];
-    }
-
-    public getTackById(trackId: string): MediaStreamTrack | undefined {
-        return this.pc
-            .getTransceivers()
-            .map((t) => {
-                if (t?.sender.track !== null && t.sender.track.id === trackId) {
-                    return t.sender.track;
-                }
-                if (t?.receiver.track !== null && t.receiver.track.id === trackId) {
-                    return t.receiver.track;
-                }
-                return undefined;
-            })
-            .find((t) => t !== undefined);
-    }
-
-    public getLocalTrackIdByMid(mid: string): string | undefined {
-        const transceiver = this.pc.getTransceivers().find((t) => t.mid === mid);
-        return transceiver?.sender?.track?.id;
-    }
-
-    public getRemoteTrackIdByMid(mid: string): string | undefined {
-        const transceiver = this.pc.getTransceivers().find((t) => t.mid === mid);
-        return transceiver?.receiver?.track?.id;
-    }
-
-    public getActiveSimulcastStreams(): number {
-        //@TODO implement this right.. Check how many layer configured
-        return 3;
-    }
-
-    public getTransceiverByTrackId(trackId: TrackId): RTCRtpTransceiver | undefined {
-        return this.pc.getTransceivers().find((t) => {
-            return t.receiver.track.id === trackId || (t.sender.track !== null && t.sender.track.id === trackId);
-        });
-    }
-}
+/*
+Copyright 2023 The Matrix.org Foundation C.I.C.
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+*/
+
+export type TrackId = string;
+
+export class MediaTrackHandler {
+    public constructor(private readonly pc: RTCPeerConnection) {}
+
+    public getLocalTracks(kind: "audio" | "video"): MediaStreamTrack[] {
+        const isNotNullAndKind = (track: MediaStreamTrack | null): boolean => {
+            return track !== null && track.kind === kind;
+        };
+        return this.pc
+            .getTransceivers()
+            .filter((t) => t.currentDirection === "sendonly" || t.currentDirection === "sendrecv")
+            .filter((t) => t.sender !== null)
+            .map((t) => t.sender)
+            .map((s) => s.track)
+            .filter(isNotNullAndKind) as MediaStreamTrack[];
+    }
+
+    public getTackById(trackId: string): MediaStreamTrack | undefined {
+        return this.pc
+            .getTransceivers()
+            .map((t) => {
+                if (t?.sender.track !== null && t.sender.track.id === trackId) {
+                    return t.sender.track;
+                }
+                if (t?.receiver.track !== null && t.receiver.track.id === trackId) {
+                    return t.receiver.track;
+                }
+                return undefined;
+            })
+            .find((t) => t !== undefined);
+    }
+
+    public getLocalTrackIdByMid(mid: string): string | undefined {
+        const transceiver = this.pc.getTransceivers().find((t) => t.mid === mid);
+        return transceiver?.sender?.track?.id;
+    }
+
+    public getRemoteTrackIdByMid(mid: string): string | undefined {
+        const transceiver = this.pc.getTransceivers().find((t) => t.mid === mid);
+        return transceiver?.receiver?.track?.id;
+    }
+
+    public getActiveSimulcastStreams(): number {
+        //@TODO implement this right.. Check how many layer configured
+        return 3;
+    }
+
+    public getTransceiverByTrackId(trackId: TrackId): RTCRtpTransceiver | undefined {
+        return this.pc.getTransceivers().find((t) => {
+            return t.receiver.track.id === trackId || (t.sender.track !== null && t.sender.track.id === trackId);
+        });
+    }
+}

package/src/webrtc/stats/media/mediaTrackStats.ts

@@ -1,176 +1,176 @@
-/*
-Copyright 2023 The Matrix.org Foundation C.I.C.
-
-Licensed under the Apache License, Version 2.0 (the "License");
-you may not use this file except in compliance with the License.
-You may obtain a copy of the License at
-
-    http://www.apache.org/licenses/LICENSE-2.0
-
-Unless required by applicable law or agreed to in writing, software
-distributed under the License is distributed on an "AS IS" BASIS,
-WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-See the License for the specific language governing permissions and
-limitations under the License.
-*/
-
-import { type AudioConcealment } from "../statsReport.ts";
-import { type TrackId } from "./mediaTrackHandler.ts";
-
-export interface PacketLoss {
-    packetsTotal: number;
-    packetsLost: number;
-    isDownloadStream: boolean;
-}
-
-export interface Bitrate {
-    /**
-     * bytes per second
-     */
-    download: number;
-    /**
-     * bytes per second
-     */
-    upload: number;
-}
-export interface ConcealedAudio {
-    /**
-     * duration in ms
-     */
-    duration: number;
-
-    ratio: number;
-}
-export interface Resolution {
-    width: number;
-    height: number;
-}
-
-export type TrackStatsType = "local" | "remote";
-
-export class MediaTrackStats {
-    private loss: PacketLoss = { packetsTotal: 0, packetsLost: 0, isDownloadStream: false };
-    private bitrate: Bitrate = { download: 0, upload: 0 };
-    private resolution: Resolution = { width: -1, height: -1 };
-    private audioConcealment: AudioConcealment = { concealedAudio: 0, totalAudioDuration: 0 };
-    private framerate = 0;
-    private jitter = 0;
-    private codec = "";
-    private isAlive = true;
-    private isMuted = false;
-    private isEnabled = true;
-
-    public constructor(
-        public readonly trackId: TrackId,
-        public readonly type: TrackStatsType,
-        public readonly kind: "audio" | "video",
-    ) {}
-
-    public getType(): TrackStatsType {
-        return this.type;
-    }
-
-    public setLoss(loss: PacketLoss): void {
-        this.loss = loss;
-    }
-
-    public getLoss(): PacketLoss {
-        return this.loss;
-    }
-
-    public setResolution(resolution: Resolution): void {
-        this.resolution = resolution;
-    }
-
-    public getResolution(): Resolution {
-        return this.resolution;
-    }
-
-    public setFramerate(framerate: number): void {
-        this.framerate = framerate;
-    }
-
-    public getFramerate(): number {
-        return this.framerate;
-    }
-
-    public setBitrate(bitrate: Bitrate): void {
-        this.bitrate = bitrate;
-    }
-
-    public getBitrate(): Bitrate {
-        return this.bitrate;
-    }
-
-    public setCodec(codecShortType: string): boolean {
-        this.codec = codecShortType;
-        return true;
-    }
-
-    public getCodec(): string {
-        return this.codec;
-    }
-
-    public resetBitrate(): void {
-        this.bitrate = { download: 0, upload: 0 };
-    }
-
-    public set alive(isAlive: boolean) {
-        this.isAlive = isAlive;
-    }
-
-    /**
-     * A MediaTrackState is alive if the corresponding MediaStreamTrack track bound to a transceiver and the
-     * MediaStreamTrack is in state MediaStreamTrack.readyState === live
-     */
-    public get alive(): boolean {
-        return this.isAlive;
-    }
-
-    public set muted(isMuted: boolean) {
-        this.isMuted = isMuted;
-    }
-
-    /**
-     * A MediaTrackState.isMuted corresponding to MediaStreamTrack.muted.
-     * But these values only match if MediaTrackState.isAlive.
-     */
-    public get muted(): boolean {
-        return this.isMuted;
-    }
-
-    public set enabled(isEnabled: boolean) {
-        this.isEnabled = isEnabled;
-    }
-
-    /**
-     * A MediaTrackState.isEnabled corresponding to MediaStreamTrack.enabled.
-     * But these values only match if MediaTrackState.isAlive.
-     */
-    public get enabled(): boolean {
-        return this.isEnabled;
-    }
-
-    public setJitter(jitter: number): void {
-        this.jitter = jitter;
-    }
-
-    /**
-     * Jitter in milliseconds
-     */
-    public getJitter(): number {
-        return this.jitter;
-    }
-
-    /**
-     * Audio concealment ration (conceled duration / total duration)
-     */
-    public setAudioConcealment(concealedAudioDuration: number, totalAudioDuration: number): void {
-        this.audioConcealment.concealedAudio = concealedAudioDuration;
-        this.audioConcealment.totalAudioDuration = totalAudioDuration;
-    }
-
-    public getAudioConcealment(): AudioConcealment {
-        return this.audioConcealment;
-    }
-}
+/*
+Copyright 2023 The Matrix.org Foundation C.I.C.
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+*/
+
+import { type AudioConcealment } from "../statsReport.ts";
+import { type TrackId } from "./mediaTrackHandler.ts";
+
+export interface PacketLoss {
+    packetsTotal: number;
+    packetsLost: number;
+    isDownloadStream: boolean;
+}
+
+export interface Bitrate {
+    /**
+     * bytes per second
+     */
+    download: number;
+    /**
+     * bytes per second
+     */
+    upload: number;
+}
+export interface ConcealedAudio {
+    /**
+     * duration in ms
+     */
+    duration: number;
+
+    ratio: number;
+}
+export interface Resolution {
+    width: number;
+    height: number;
+}
+
+export type TrackStatsType = "local" | "remote";
+
+export class MediaTrackStats {
+    private loss: PacketLoss = { packetsTotal: 0, packetsLost: 0, isDownloadStream: false };
+    private bitrate: Bitrate = { download: 0, upload: 0 };
+    private resolution: Resolution = { width: -1, height: -1 };
+    private audioConcealment: AudioConcealment = { concealedAudio: 0, totalAudioDuration: 0 };
+    private framerate = 0;
+    private jitter = 0;
+    private codec = "";
+    private isAlive = true;
+    private isMuted = false;
+    private isEnabled = true;
+
+    public constructor(
+        public readonly trackId: TrackId,
+        public readonly type: TrackStatsType,
+        public readonly kind: "audio" | "video",
+    ) {}
+
+    public getType(): TrackStatsType {
+        return this.type;
+    }
+
+    public setLoss(loss: PacketLoss): void {
+        this.loss = loss;
+    }
+
+    public getLoss(): PacketLoss {
+        return this.loss;
+    }
+
+    public setResolution(resolution: Resolution): void {
+        this.resolution = resolution;
+    }
+
+    public getResolution(): Resolution {
+        return this.resolution;
+    }
+
+    public setFramerate(framerate: number): void {
+        this.framerate = framerate;
+    }
+
+    public getFramerate(): number {
+        return this.framerate;
+    }
+
+    public setBitrate(bitrate: Bitrate): void {
+        this.bitrate = bitrate;
+    }
+
+    public getBitrate(): Bitrate {
+        return this.bitrate;
+    }
+
+    public setCodec(codecShortType: string): boolean {
+        this.codec = codecShortType;
+        return true;
+    }
+
+    public getCodec(): string {
+        return this.codec;
+    }
+
+    public resetBitrate(): void {
+        this.bitrate = { download: 0, upload: 0 };
+    }
+
+    public set alive(isAlive: boolean) {
+        this.isAlive = isAlive;
+    }
+
+    /**
+     * A MediaTrackState is alive if the corresponding MediaStreamTrack track bound to a transceiver and the
+     * MediaStreamTrack is in state MediaStreamTrack.readyState === live
+     */
+    public get alive(): boolean {
+        return this.isAlive;
+    }
+
+    public set muted(isMuted: boolean) {
+        this.isMuted = isMuted;
+    }
+
+    /**
+     * A MediaTrackState.isMuted corresponding to MediaStreamTrack.muted.
+     * But these values only match if MediaTrackState.isAlive.
+     */
+    public get muted(): boolean {
+        return this.isMuted;
+    }
+
+    public set enabled(isEnabled: boolean) {
+        this.isEnabled = isEnabled;
+    }
+
+    /**
+     * A MediaTrackState.isEnabled corresponding to MediaStreamTrack.enabled.
+     * But these values only match if MediaTrackState.isAlive.
+     */
+    public get enabled(): boolean {
+        return this.isEnabled;
+    }
+
+    public setJitter(jitter: number): void {
+        this.jitter = jitter;
+    }
+
+    /**
+     * Jitter in milliseconds
+     */
+    public getJitter(): number {
+        return this.jitter;
+    }
+
+    /**
+     * Audio concealment ration (conceled duration / total duration)
+     */
+    public setAudioConcealment(concealedAudioDuration: number, totalAudioDuration: number): void {
+        this.audioConcealment.concealedAudio = concealedAudioDuration;
+        this.audioConcealment.totalAudioDuration = totalAudioDuration;
+    }
+
+    public getAudioConcealment(): AudioConcealment {
+        return this.audioConcealment;
+    }
+}

package/src/webrtc/stats/media/mediaTrackStatsHandler.ts

@@ -1,90 +1,90 @@
-/*
-Copyright 2023 The Matrix.org Foundation C.I.C.
-
-Licensed under the Apache License, Version 2.0 (the "License");
-you may not use this file except in compliance with the License.
-You may obtain a copy of the License at
-
-    http://www.apache.org/licenses/LICENSE-2.0
-
-Unless required by applicable law or agreed to in writing, software
-distributed under the License is distributed on an "AS IS" BASIS,
-WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-See the License for the specific language governing permissions and
-limitations under the License.
-*/
-import { type TrackID } from "../statsReport.ts";
-import { MediaTrackStats } from "./mediaTrackStats.ts";
-import { type MediaTrackHandler, type TrackId } from "./mediaTrackHandler.ts";
-import { type MediaSsrcHandler } from "./mediaSsrcHandler.ts";
-
-export class MediaTrackStatsHandler {
-    private readonly track2stats = new Map<TrackID, MediaTrackStats>();
-
-    public constructor(
-        public readonly mediaSsrcHandler: MediaSsrcHandler,
-        public readonly mediaTrackHandler: MediaTrackHandler,
-    ) {}
-
-    /**
-     * Find tracks by rtc stats
-     * Argument report is any because the stats api is not consistent:
-     * For example `trackIdentifier`, `mid` not existing in every implementations
-     * https://www.w3.org/TR/webrtc-stats/#dom-rtcinboundrtpstreamstats
-     * https://developer.mozilla.org/en-US/docs/Web/API/RTCInboundRtpStreamStats
-     */
-    public findTrack2Stats(report: any, type: "remote" | "local"): MediaTrackStats | undefined {
-        let trackID;
-        if (report.trackIdentifier) {
-            trackID = report.trackIdentifier;
-        } else if (report.mid) {
-            trackID =
-                type === "remote"
-                    ? this.mediaTrackHandler.getRemoteTrackIdByMid(report.mid)
-                    : this.mediaTrackHandler.getLocalTrackIdByMid(report.mid);
-        } else if (report.ssrc) {
-            const mid = this.mediaSsrcHandler.findMidBySsrc(report.ssrc, type);
-            if (!mid) {
-                return undefined;
-            }
-            trackID =
-                type === "remote"
-                    ? this.mediaTrackHandler.getRemoteTrackIdByMid(report.mid)
-                    : this.mediaTrackHandler.getLocalTrackIdByMid(report.mid);
-        }
-
-        if (!trackID) {
-            return undefined;
-        }
-
-        let trackStats = this.track2stats.get(trackID);
-
-        if (!trackStats) {
-            const track = this.mediaTrackHandler.getTackById(trackID);
-            if (track !== undefined) {
-                const kind: "audio" | "video" = track.kind === "audio" ? track.kind : "video";
-                trackStats = new MediaTrackStats(trackID, type, kind);
-                this.track2stats.set(trackID, trackStats);
-            } else {
-                return undefined;
-            }
-        }
-        return trackStats;
-    }
-
-    public findLocalVideoTrackStats(report: any): MediaTrackStats | undefined {
-        const localVideoTracks = this.mediaTrackHandler.getLocalTracks("video");
-        if (localVideoTracks.length === 0) {
-            return undefined;
-        }
-        return this.findTrack2Stats(report, "local");
-    }
-
-    public getTrack2stats(): Map<TrackID, MediaTrackStats> {
-        return this.track2stats;
-    }
-
-    public findTransceiverByTrackId(trackID: TrackId): undefined | RTCRtpTransceiver {
-        return this.mediaTrackHandler.getTransceiverByTrackId(trackID);
-    }
-}
+/*
+Copyright 2023 The Matrix.org Foundation C.I.C.
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+*/
+import { type TrackID } from "../statsReport.ts";
+import { MediaTrackStats } from "./mediaTrackStats.ts";
+import { type MediaTrackHandler, type TrackId } from "./mediaTrackHandler.ts";
+import { type MediaSsrcHandler } from "./mediaSsrcHandler.ts";
+
+export class MediaTrackStatsHandler {
+    private readonly track2stats = new Map<TrackID, MediaTrackStats>();
+
+    public constructor(
+        public readonly mediaSsrcHandler: MediaSsrcHandler,
+        public readonly mediaTrackHandler: MediaTrackHandler,
+    ) {}
+
+    /**
+     * Find tracks by rtc stats
+     * Argument report is any because the stats api is not consistent:
+     * For example `trackIdentifier`, `mid` not existing in every implementations
+     * https://www.w3.org/TR/webrtc-stats/#dom-rtcinboundrtpstreamstats
+     * https://developer.mozilla.org/en-US/docs/Web/API/RTCInboundRtpStreamStats
+     */
+    public findTrack2Stats(report: any, type: "remote" | "local"): MediaTrackStats | undefined {
+        let trackID;
+        if (report.trackIdentifier) {
+            trackID = report.trackIdentifier;
+        } else if (report.mid) {
+            trackID =
+                type === "remote"
+                    ? this.mediaTrackHandler.getRemoteTrackIdByMid(report.mid)
+                    : this.mediaTrackHandler.getLocalTrackIdByMid(report.mid);
+        } else if (report.ssrc) {
+            const mid = this.mediaSsrcHandler.findMidBySsrc(report.ssrc, type);
+            if (!mid) {
+                return undefined;
+            }
+            trackID =
+                type === "remote"
+                    ? this.mediaTrackHandler.getRemoteTrackIdByMid(report.mid)
+                    : this.mediaTrackHandler.getLocalTrackIdByMid(report.mid);
+        }
+
+        if (!trackID) {
+            return undefined;
+        }
+
+        let trackStats = this.track2stats.get(trackID);
+
+        if (!trackStats) {
+            const track = this.mediaTrackHandler.getTackById(trackID);
+            if (track !== undefined) {
+                const kind: "audio" | "video" = track.kind === "audio" ? track.kind : "video";
+                trackStats = new MediaTrackStats(trackID, type, kind);
+                this.track2stats.set(trackID, trackStats);
+            } else {
+                return undefined;
+            }
+        }
+        return trackStats;
+    }
+
+    public findLocalVideoTrackStats(report: any): MediaTrackStats | undefined {
+        const localVideoTracks = this.mediaTrackHandler.getLocalTracks("video");
+        if (localVideoTracks.length === 0) {
+            return undefined;
+        }
+        return this.findTrack2Stats(report, "local");
+    }
+
+    public getTrack2stats(): Map<TrackID, MediaTrackStats> {
+        return this.track2stats;
+    }
+
+    public findTransceiverByTrackId(trackID: TrackId): undefined | RTCRtpTransceiver {
+        return this.mediaTrackHandler.getTransceiverByTrackId(trackID);
+    }
+}