@textrp/briij-js-sdk 41.0.1 → 42.0.0

package/src/webrtc/stats/connectionStatsReportBuilder.ts

@@ -1,140 +1,140 @@
-/*
-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,
-    type CodecMap,
-    type ConnectionStatsReport,
-    type FramerateMap,
-    type ResolutionMap,
-    type TrackID,
-} from "./statsReport.ts";
-import { type MediaTrackStats, type Resolution } from "./media/mediaTrackStats.ts";
-
-export class ConnectionStatsReportBuilder {
-    public static build(stats: Map<TrackID, MediaTrackStats>): ConnectionStatsReport {
-        const report = {} as ConnectionStatsReport;
-
-        // process stats
-        const totalPackets = {
-            download: 0,
-            upload: 0,
-        };
-        const lostPackets = {
-            download: 0,
-            upload: 0,
-        };
-        let bitrateDownload = 0;
-        let bitrateUpload = 0;
-        const resolutions: ResolutionMap = {
-            local: new Map<TrackID, Resolution>(),
-            remote: new Map<TrackID, Resolution>(),
-        };
-        const framerates: FramerateMap = { local: new Map<TrackID, number>(), remote: new Map<TrackID, number>() };
-        const codecs: CodecMap = { local: new Map<TrackID, string>(), remote: new Map<TrackID, string>() };
-        const jitter = new Map<TrackID, number>();
-        const audioConcealment = new Map<TrackID, AudioConcealment>();
-
-        let audioBitrateDownload = 0;
-        let audioBitrateUpload = 0;
-        let videoBitrateDownload = 0;
-        let videoBitrateUpload = 0;
-
-        let totalConcealedAudio = 0;
-        let totalAudioDuration = 0;
-
-        for (const [trackId, trackStats] of stats) {
-            // process packet loss stats
-            const loss = trackStats.getLoss();
-            const type = loss.isDownloadStream ? "download" : "upload";
-
-            totalPackets[type] += loss.packetsTotal;
-            lostPackets[type] += loss.packetsLost;
-
-            // process bitrate stats
-            bitrateDownload += trackStats.getBitrate().download;
-            bitrateUpload += trackStats.getBitrate().upload;
-
-            // collect resolutions and framerates
-            if (trackStats.kind === "audio") {
-                // process audio quality stats
-                const audioConcealmentForTrack = trackStats.getAudioConcealment();
-                totalConcealedAudio += audioConcealmentForTrack.concealedAudio;
-                totalAudioDuration += audioConcealmentForTrack.totalAudioDuration;
-
-                audioBitrateDownload += trackStats.getBitrate().download;
-                audioBitrateUpload += trackStats.getBitrate().upload;
-            } else {
-                videoBitrateDownload += trackStats.getBitrate().download;
-                videoBitrateUpload += trackStats.getBitrate().upload;
-            }
-
-            resolutions[trackStats.getType()].set(trackId, trackStats.getResolution());
-            framerates[trackStats.getType()].set(trackId, trackStats.getFramerate());
-            codecs[trackStats.getType()].set(trackId, trackStats.getCodec());
-            if (trackStats.getType() === "remote") {
-                jitter.set(trackId, trackStats.getJitter());
-                if (trackStats.kind === "audio") {
-                    audioConcealment.set(trackId, trackStats.getAudioConcealment());
-                }
-            }
-
-            trackStats.resetBitrate();
-        }
-
-        report.bitrate = {
-            upload: bitrateUpload,
-            download: bitrateDownload,
-        };
-
-        report.bitrate.audio = {
-            upload: audioBitrateUpload,
-            download: audioBitrateDownload,
-        };
-
-        report.bitrate.video = {
-            upload: videoBitrateUpload,
-            download: videoBitrateDownload,
-        };
-
-        report.packetLoss = {
-            total: ConnectionStatsReportBuilder.calculatePacketLoss(
-                lostPackets.download + lostPackets.upload,
-                totalPackets.download + totalPackets.upload,
-            ),
-            download: ConnectionStatsReportBuilder.calculatePacketLoss(lostPackets.download, totalPackets.download),
-            upload: ConnectionStatsReportBuilder.calculatePacketLoss(lostPackets.upload, totalPackets.upload),
-        };
-        report.audioConcealment = audioConcealment;
-        report.totalAudioConcealment = {
-            concealedAudio: totalConcealedAudio,
-            totalAudioDuration,
-        };
-
-        report.framerate = framerates;
-        report.resolution = resolutions;
-        report.codec = codecs;
-        report.jitter = jitter;
-        return report;
-    }
-
-    private static calculatePacketLoss(lostPackets: number, totalPackets: number): number {
-        if (!totalPackets || totalPackets <= 0 || !lostPackets || lostPackets <= 0) {
-            return 0;
-        }
-
-        return Math.round((lostPackets / totalPackets) * 100);
-    }
-}
+/*
+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,
+    type CodecMap,
+    type ConnectionStatsReport,
+    type FramerateMap,
+    type ResolutionMap,
+    type TrackID,
+} from "./statsReport.ts";
+import { type MediaTrackStats, type Resolution } from "./media/mediaTrackStats.ts";
+
+export class ConnectionStatsReportBuilder {
+    public static build(stats: Map<TrackID, MediaTrackStats>): ConnectionStatsReport {
+        const report = {} as ConnectionStatsReport;
+
+        // process stats
+        const totalPackets = {
+            download: 0,
+            upload: 0,
+        };
+        const lostPackets = {
+            download: 0,
+            upload: 0,
+        };
+        let bitrateDownload = 0;
+        let bitrateUpload = 0;
+        const resolutions: ResolutionMap = {
+            local: new Map<TrackID, Resolution>(),
+            remote: new Map<TrackID, Resolution>(),
+        };
+        const framerates: FramerateMap = { local: new Map<TrackID, number>(), remote: new Map<TrackID, number>() };
+        const codecs: CodecMap = { local: new Map<TrackID, string>(), remote: new Map<TrackID, string>() };
+        const jitter = new Map<TrackID, number>();
+        const audioConcealment = new Map<TrackID, AudioConcealment>();
+
+        let audioBitrateDownload = 0;
+        let audioBitrateUpload = 0;
+        let videoBitrateDownload = 0;
+        let videoBitrateUpload = 0;
+
+        let totalConcealedAudio = 0;
+        let totalAudioDuration = 0;
+
+        for (const [trackId, trackStats] of stats) {
+            // process packet loss stats
+            const loss = trackStats.getLoss();
+            const type = loss.isDownloadStream ? "download" : "upload";
+
+            totalPackets[type] += loss.packetsTotal;
+            lostPackets[type] += loss.packetsLost;
+
+            // process bitrate stats
+            bitrateDownload += trackStats.getBitrate().download;
+            bitrateUpload += trackStats.getBitrate().upload;
+
+            // collect resolutions and framerates
+            if (trackStats.kind === "audio") {
+                // process audio quality stats
+                const audioConcealmentForTrack = trackStats.getAudioConcealment();
+                totalConcealedAudio += audioConcealmentForTrack.concealedAudio;
+                totalAudioDuration += audioConcealmentForTrack.totalAudioDuration;
+
+                audioBitrateDownload += trackStats.getBitrate().download;
+                audioBitrateUpload += trackStats.getBitrate().upload;
+            } else {
+                videoBitrateDownload += trackStats.getBitrate().download;
+                videoBitrateUpload += trackStats.getBitrate().upload;
+            }
+
+            resolutions[trackStats.getType()].set(trackId, trackStats.getResolution());
+            framerates[trackStats.getType()].set(trackId, trackStats.getFramerate());
+            codecs[trackStats.getType()].set(trackId, trackStats.getCodec());
+            if (trackStats.getType() === "remote") {
+                jitter.set(trackId, trackStats.getJitter());
+                if (trackStats.kind === "audio") {
+                    audioConcealment.set(trackId, trackStats.getAudioConcealment());
+                }
+            }
+
+            trackStats.resetBitrate();
+        }
+
+        report.bitrate = {
+            upload: bitrateUpload,
+            download: bitrateDownload,
+        };
+
+        report.bitrate.audio = {
+            upload: audioBitrateUpload,
+            download: audioBitrateDownload,
+        };
+
+        report.bitrate.video = {
+            upload: videoBitrateUpload,
+            download: videoBitrateDownload,
+        };
+
+        report.packetLoss = {
+            total: ConnectionStatsReportBuilder.calculatePacketLoss(
+                lostPackets.download + lostPackets.upload,
+                totalPackets.download + totalPackets.upload,
+            ),
+            download: ConnectionStatsReportBuilder.calculatePacketLoss(lostPackets.download, totalPackets.download),
+            upload: ConnectionStatsReportBuilder.calculatePacketLoss(lostPackets.upload, totalPackets.upload),
+        };
+        report.audioConcealment = audioConcealment;
+        report.totalAudioConcealment = {
+            concealedAudio: totalConcealedAudio,
+            totalAudioDuration,
+        };
+
+        report.framerate = framerates;
+        report.resolution = resolutions;
+        report.codec = codecs;
+        report.jitter = jitter;
+        return report;
+    }
+
+    private static calculatePacketLoss(lostPackets: number, totalPackets: number): number {
+        if (!totalPackets || totalPackets <= 0 || !lostPackets || lostPackets <= 0) {
+            return 0;
+        }
+
+        return Math.round((lostPackets / totalPackets) * 100);
+    }
+}

package/src/webrtc/stats/groupCallStats.ts

@@ -1,93 +1,93 @@
-/*
-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 { CallStatsReportGatherer } from "./callStatsReportGatherer.ts";
-import { StatsReportEmitter } from "./statsReportEmitter.ts";
-import { type CallStatsReportSummary } from "./callStatsReportSummary.ts";
-import { SummaryStatsReportGatherer } from "./summaryStatsReportGatherer.ts";
-import { logger } from "../../logger.ts";
-
-export class GroupCallStats {
-    private timer: undefined | ReturnType<typeof setTimeout>;
-    private readonly gatherers: Map<string, CallStatsReportGatherer> = new Map<string, CallStatsReportGatherer>();
-    public readonly reports = new StatsReportEmitter();
-    private readonly summaryStatsReportGatherer = new SummaryStatsReportGatherer(this.reports);
-
-    public constructor(
-        private groupCallId: string,
-        private userId: string,
-        private interval: number = 10000,
-    ) {}
-
-    public start(): void {
-        if (this.timer === undefined && this.interval > 0) {
-            this.timer = setInterval(() => {
-                this.processStats();
-            }, this.interval);
-        }
-    }
-
-    public stop(): void {
-        if (this.timer !== undefined) {
-            clearInterval(this.timer);
-            this.gatherers.forEach((c) => c.stopProcessingStats());
-        }
-    }
-
-    public hasStatsReportGatherer(callId: string): boolean {
-        return this.gatherers.has(callId);
-    }
-
-    public addStatsReportGatherer(
-        callId: string,
-        opponentMemberId: string,
-        peerConnection: RTCPeerConnection,
-    ): boolean {
-        if (this.hasStatsReportGatherer(callId)) {
-            return false;
-        }
-        this.gatherers.set(callId, new CallStatsReportGatherer(callId, opponentMemberId, peerConnection, this.reports));
-        return true;
-    }
-
-    public removeStatsReportGatherer(callId: string): boolean {
-        return this.gatherers.delete(callId);
-    }
-
-    public getStatsReportGatherer(callId: string): CallStatsReportGatherer | undefined {
-        return this.hasStatsReportGatherer(callId) ? this.gatherers.get(callId) : undefined;
-    }
-
-    public updateOpponentMember(callId: string, opponentMember: string): void {
-        this.getStatsReportGatherer(callId)?.setOpponentMemberId(opponentMember);
-    }
-
-    private processStats(): void {
-        const summary: Promise<CallStatsReportSummary>[] = [];
-        this.gatherers.forEach((c) => {
-            summary.push(c.processStats(this.groupCallId, this.userId));
-        });
-
-        Promise.all(summary)
-            .then((s: Awaited<CallStatsReportSummary>[]) => this.summaryStatsReportGatherer.build(s))
-            .catch((err) => {
-                logger.error("Could not build summary stats report", err);
-            });
-    }
-
-    public setInterval(interval: number): void {
-        this.interval = interval;
-    }
-}
+/*
+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 { CallStatsReportGatherer } from "./callStatsReportGatherer.ts";
+import { StatsReportEmitter } from "./statsReportEmitter.ts";
+import { type CallStatsReportSummary } from "./callStatsReportSummary.ts";
+import { SummaryStatsReportGatherer } from "./summaryStatsReportGatherer.ts";
+import { logger } from "../../logger.ts";
+
+export class GroupCallStats {
+    private timer: undefined | ReturnType<typeof setTimeout>;
+    private readonly gatherers: Map<string, CallStatsReportGatherer> = new Map<string, CallStatsReportGatherer>();
+    public readonly reports = new StatsReportEmitter();
+    private readonly summaryStatsReportGatherer = new SummaryStatsReportGatherer(this.reports);
+
+    public constructor(
+        private groupCallId: string,
+        private userId: string,
+        private interval: number = 10000,
+    ) {}
+
+    public start(): void {
+        if (this.timer === undefined && this.interval > 0) {
+            this.timer = setInterval(() => {
+                this.processStats();
+            }, this.interval);
+        }
+    }
+
+    public stop(): void {
+        if (this.timer !== undefined) {
+            clearInterval(this.timer);
+            this.gatherers.forEach((c) => c.stopProcessingStats());
+        }
+    }
+
+    public hasStatsReportGatherer(callId: string): boolean {
+        return this.gatherers.has(callId);
+    }
+
+    public addStatsReportGatherer(
+        callId: string,
+        opponentMemberId: string,
+        peerConnection: RTCPeerConnection,
+    ): boolean {
+        if (this.hasStatsReportGatherer(callId)) {
+            return false;
+        }
+        this.gatherers.set(callId, new CallStatsReportGatherer(callId, opponentMemberId, peerConnection, this.reports));
+        return true;
+    }
+
+    public removeStatsReportGatherer(callId: string): boolean {
+        return this.gatherers.delete(callId);
+    }
+
+    public getStatsReportGatherer(callId: string): CallStatsReportGatherer | undefined {
+        return this.hasStatsReportGatherer(callId) ? this.gatherers.get(callId) : undefined;
+    }
+
+    public updateOpponentMember(callId: string, opponentMember: string): void {
+        this.getStatsReportGatherer(callId)?.setOpponentMemberId(opponentMember);
+    }
+
+    private processStats(): void {
+        const summary: Promise<CallStatsReportSummary>[] = [];
+        this.gatherers.forEach((c) => {
+            summary.push(c.processStats(this.groupCallId, this.userId));
+        });
+
+        Promise.all(summary)
+            .then((s: Awaited<CallStatsReportSummary>[]) => this.summaryStatsReportGatherer.build(s))
+            .catch((err) => {
+                logger.error("Could not build summary stats report", err);
+            });
+    }
+
+    public setInterval(interval: number): void {
+        this.interval = interval;
+    }
+}

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

@@ -1,57 +1,57 @@
-/*
-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 { parse as parseSdp } from "sdp-transform";
-
-export type Mid = string;
-export type Ssrc = string;
-export type MapType = "local" | "remote";
-
-export class MediaSsrcHandler {
-    private readonly ssrcToMid = { local: new Map<Mid, Ssrc[]>(), remote: new Map<Mid, Ssrc[]>() };
-
-    public findMidBySsrc(ssrc: Ssrc, type: "local" | "remote"): Mid | undefined {
-        let mid: Mid | undefined;
-        this.ssrcToMid[type].forEach((ssrcs, m) => {
-            if (ssrcs.find((s) => s == ssrc)) {
-                mid = m;
-                return;
-            }
-        });
-        return mid;
-    }
-
-    public parse(description: string, type: MapType): void {
-        const sdp = parseSdp(description);
-        const ssrcToMid = new Map<Mid, Ssrc[]>();
-        sdp.media.forEach((m) => {
-            if ((!!m.mid && m.type === "video") || m.type === "audio") {
-                const ssrcs: Ssrc[] = [];
-                m.ssrcs?.forEach((ssrc) => {
-                    if (ssrc.attribute === "cname") {
-                        ssrcs.push(`${ssrc.id}`);
-                    }
-                });
-                ssrcToMid.set(`${m.mid}`, ssrcs);
-            }
-        });
-        this.ssrcToMid[type] = ssrcToMid;
-    }
-
-    public getSsrcToMidMap(type: MapType): Map<Mid, Ssrc[]> {
-        return this.ssrcToMid[type];
-    }
-}
+/*
+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 { parse as parseSdp } from "sdp-transform";
+
+export type Mid = string;
+export type Ssrc = string;
+export type MapType = "local" | "remote";
+
+export class MediaSsrcHandler {
+    private readonly ssrcToMid = { local: new Map<Mid, Ssrc[]>(), remote: new Map<Mid, Ssrc[]>() };
+
+    public findMidBySsrc(ssrc: Ssrc, type: "local" | "remote"): Mid | undefined {
+        let mid: Mid | undefined;
+        this.ssrcToMid[type].forEach((ssrcs, m) => {
+            if (ssrcs.find((s) => s == ssrc)) {
+                mid = m;
+                return;
+            }
+        });
+        return mid;
+    }
+
+    public parse(description: string, type: MapType): void {
+        const sdp = parseSdp(description);
+        const ssrcToMid = new Map<Mid, Ssrc[]>();
+        sdp.media.forEach((m) => {
+            if ((!!m.mid && m.type === "video") || m.type === "audio") {
+                const ssrcs: Ssrc[] = [];
+                m.ssrcs?.forEach((ssrc) => {
+                    if (ssrc.attribute === "cname") {
+                        ssrcs.push(`${ssrc.id}`);
+                    }
+                });
+                ssrcToMid.set(`${m.mid}`, ssrcs);
+            }
+        });
+        this.ssrcToMid[type] = ssrcToMid;
+    }
+
+    public getSsrcToMidMap(type: MapType): Map<Mid, Ssrc[]> {
+        return this.ssrcToMid[type];
+    }
+}