@textrp/briij-js-sdk 41.0.1 → 42.0.0

package/src/webrtc/stats/trackStatsBuilder.ts

@@ -1,207 +1,207 @@
-import { type MediaTrackStats } from "./media/mediaTrackStats.ts";
-import { ValueFormatter } from "./valueFormatter.ts";
-import { type TrackSummary } from "./callStatsReportSummary.ts";
-
-export class TrackStatsBuilder {
-    public static buildFramerateResolution(trackStats: MediaTrackStats, now: any): void {
-        const resolution = {
-            height: now.frameHeight,
-            width: now.frameWidth,
-        };
-        const frameRate = now.framesPerSecond;
-
-        if (resolution.height && resolution.width) {
-            trackStats.setResolution(resolution);
-        }
-        trackStats.setFramerate(Math.round(frameRate || 0));
-    }
-
-    public static calculateSimulcastFramerate(trackStats: MediaTrackStats, now: any, before: any, layer: number): void {
-        let frameRate = trackStats.getFramerate();
-        if (!frameRate) {
-            if (before) {
-                const timeMs = now.timestamp - before.timestamp;
-
-                if (timeMs > 0 && now.framesSent) {
-                    const numberOfFramesSinceBefore = now.framesSent - before.framesSent;
-
-                    frameRate = (numberOfFramesSinceBefore / timeMs) * 1000;
-                }
-            }
-
-            if (!frameRate) {
-                return;
-            }
-        }
-
-        // Reset frame rate to 0 when video is suspended as a result of endpoint falling out of last-n.
-        frameRate = layer ? Math.round(frameRate / layer) : 0;
-        trackStats.setFramerate(frameRate);
-    }
-
-    public static buildCodec(report: RTCStatsReport | undefined, trackStats: MediaTrackStats, now: any): void {
-        const codec = report?.get(now.codecId);
-
-        if (codec) {
-            /**
-             * The mime type has the following form: video/VP8 or audio/ISAC,
-             * so we what to keep just the type after the '/', audio and video
-             * keys will be added on the processing side.
-             */
-            const codecShortType = codec.mimeType.split("/")[1];
-
-            if (codecShortType) trackStats.setCodec(codecShortType);
-        }
-    }
-
-    public static buildBitrateReceived(trackStats: MediaTrackStats, now: any, before: any): void {
-        trackStats.setBitrate({
-            download: TrackStatsBuilder.calculateBitrate(
-                now.bytesReceived,
-                before.bytesReceived,
-                now.timestamp,
-                before.timestamp,
-            ),
-            upload: 0,
-        });
-    }
-
-    public static buildBitrateSend(trackStats: MediaTrackStats, now: any, before: any): void {
-        trackStats.setBitrate({
-            download: 0,
-            upload: this.calculateBitrate(now.bytesSent, before.bytesSent, now.timestamp, before.timestamp),
-        });
-    }
-
-    public static buildPacketsLost(trackStats: MediaTrackStats, now: any, before: any): void {
-        const key = now.type === "outbound-rtp" ? "packetsSent" : "packetsReceived";
-
-        let packetsNow = now[key];
-        if (!packetsNow || packetsNow < 0) {
-            packetsNow = 0;
-        }
-
-        const packetsBefore = ValueFormatter.getNonNegativeValue(before[key]);
-        const packetsDiff = Math.max(0, packetsNow - packetsBefore);
-
-        const packetsLostNow = ValueFormatter.getNonNegativeValue(now.packetsLost);
-        const packetsLostBefore = ValueFormatter.getNonNegativeValue(before.packetsLost);
-        const packetsLostDiff = Math.max(0, packetsLostNow - packetsLostBefore);
-
-        trackStats.setLoss({
-            packetsTotal: packetsDiff + packetsLostDiff,
-            packetsLost: packetsLostDiff,
-            isDownloadStream: now.type !== "outbound-rtp",
-        });
-    }
-
-    private static calculateBitrate(
-        bytesNowAny: any,
-        bytesBeforeAny: any,
-        nowTimestamp: number,
-        beforeTimestamp: number,
-    ): number {
-        const bytesNow = ValueFormatter.getNonNegativeValue(bytesNowAny);
-        const bytesBefore = ValueFormatter.getNonNegativeValue(bytesBeforeAny);
-        const bytesProcessed = Math.max(0, bytesNow - bytesBefore);
-
-        const timeMs = nowTimestamp - beforeTimestamp;
-        let bitrateKbps = 0;
-
-        if (timeMs > 0) {
-            bitrateKbps = Math.round((bytesProcessed * 8) / timeMs);
-        }
-
-        return bitrateKbps;
-    }
-
-    public static setTrackStatsState(trackStats: MediaTrackStats, transceiver: RTCRtpTransceiver | undefined): void {
-        if (transceiver === undefined) {
-            trackStats.alive = false;
-            return;
-        }
-
-        const track = trackStats.getType() === "remote" ? transceiver.receiver.track : transceiver?.sender?.track;
-        if (track === undefined || track === null) {
-            trackStats.alive = false;
-            return;
-        }
-
-        if (track.readyState === "ended") {
-            trackStats.alive = false;
-            return;
-        }
-        trackStats.muted = track.muted;
-        trackStats.enabled = track.enabled;
-        trackStats.alive = true;
-    }
-
-    public static buildTrackSummary(trackStatsList: MediaTrackStats[]): {
-        audioTrackSummary: TrackSummary;
-        videoTrackSummary: TrackSummary;
-    } {
-        const videoTrackSummary: TrackSummary = {
-            count: 0,
-            muted: 0,
-            maxJitter: 0,
-            maxPacketLoss: 0,
-            concealedAudio: 0,
-            totalAudio: 0,
-        };
-        const audioTrackSummary: TrackSummary = {
-            count: 0,
-            muted: 0,
-            maxJitter: 0,
-            maxPacketLoss: 0,
-            concealedAudio: 0,
-            totalAudio: 0,
-        };
-
-        const remoteTrackList = trackStatsList.filter((t) => t.getType() === "remote");
-        const audioTrackList = remoteTrackList.filter((t) => t.kind === "audio");
-
-        remoteTrackList.forEach((stats) => {
-            const trackSummary = stats.kind === "video" ? videoTrackSummary : audioTrackSummary;
-            trackSummary.count++;
-            if (stats.alive && stats.muted) {
-                trackSummary.muted++;
-            }
-            if (trackSummary.maxJitter < stats.getJitter()) {
-                trackSummary.maxJitter = stats.getJitter();
-            }
-            if (trackSummary.maxPacketLoss < stats.getLoss().packetsLost) {
-                trackSummary.maxPacketLoss = stats.getLoss().packetsLost;
-            }
-            if (audioTrackList.length > 0) {
-                trackSummary.concealedAudio += stats.getAudioConcealment()?.concealedAudio;
-                trackSummary.totalAudio += stats.getAudioConcealment()?.totalAudioDuration;
-            }
-        });
-
-        return { audioTrackSummary, videoTrackSummary };
-    }
-
-    public static buildJitter(trackStats: MediaTrackStats, statsReport: any): void {
-        if (statsReport.type !== "inbound-rtp") {
-            return;
-        }
-
-        const jitterStr = statsReport?.jitter;
-        if (jitterStr !== undefined) {
-            const jitter = ValueFormatter.getNonNegativeValue(jitterStr);
-            trackStats.setJitter(Math.round(jitter * 1000));
-        } else {
-            trackStats.setJitter(-1);
-        }
-    }
-
-    public static buildAudioConcealment(trackStats: MediaTrackStats, statsReport: any): void {
-        if (statsReport.type !== "inbound-rtp") {
-            return;
-        }
-        const msPerSample = (1000 * statsReport?.totalSamplesDuration) / statsReport?.totalSamplesReceived;
-        const concealedAudioDuration = msPerSample * statsReport?.concealedSamples;
-        const totalAudioDuration = 1000 * statsReport?.totalSamplesDuration;
-        trackStats.setAudioConcealment(concealedAudioDuration, totalAudioDuration);
-    }
-}
+import { type MediaTrackStats } from "./media/mediaTrackStats.ts";
+import { ValueFormatter } from "./valueFormatter.ts";
+import { type TrackSummary } from "./callStatsReportSummary.ts";
+
+export class TrackStatsBuilder {
+    public static buildFramerateResolution(trackStats: MediaTrackStats, now: any): void {
+        const resolution = {
+            height: now.frameHeight,
+            width: now.frameWidth,
+        };
+        const frameRate = now.framesPerSecond;
+
+        if (resolution.height && resolution.width) {
+            trackStats.setResolution(resolution);
+        }
+        trackStats.setFramerate(Math.round(frameRate || 0));
+    }
+
+    public static calculateSimulcastFramerate(trackStats: MediaTrackStats, now: any, before: any, layer: number): void {
+        let frameRate = trackStats.getFramerate();
+        if (!frameRate) {
+            if (before) {
+                const timeMs = now.timestamp - before.timestamp;
+
+                if (timeMs > 0 && now.framesSent) {
+                    const numberOfFramesSinceBefore = now.framesSent - before.framesSent;
+
+                    frameRate = (numberOfFramesSinceBefore / timeMs) * 1000;
+                }
+            }
+
+            if (!frameRate) {
+                return;
+            }
+        }
+
+        // Reset frame rate to 0 when video is suspended as a result of endpoint falling out of last-n.
+        frameRate = layer ? Math.round(frameRate / layer) : 0;
+        trackStats.setFramerate(frameRate);
+    }
+
+    public static buildCodec(report: RTCStatsReport | undefined, trackStats: MediaTrackStats, now: any): void {
+        const codec = report?.get(now.codecId);
+
+        if (codec) {
+            /**
+             * The mime type has the following form: video/VP8 or audio/ISAC,
+             * so we what to keep just the type after the '/', audio and video
+             * keys will be added on the processing side.
+             */
+            const codecShortType = codec.mimeType.split("/")[1];
+
+            if (codecShortType) trackStats.setCodec(codecShortType);
+        }
+    }
+
+    public static buildBitrateReceived(trackStats: MediaTrackStats, now: any, before: any): void {
+        trackStats.setBitrate({
+            download: TrackStatsBuilder.calculateBitrate(
+                now.bytesReceived,
+                before.bytesReceived,
+                now.timestamp,
+                before.timestamp,
+            ),
+            upload: 0,
+        });
+    }
+
+    public static buildBitrateSend(trackStats: MediaTrackStats, now: any, before: any): void {
+        trackStats.setBitrate({
+            download: 0,
+            upload: this.calculateBitrate(now.bytesSent, before.bytesSent, now.timestamp, before.timestamp),
+        });
+    }
+
+    public static buildPacketsLost(trackStats: MediaTrackStats, now: any, before: any): void {
+        const key = now.type === "outbound-rtp" ? "packetsSent" : "packetsReceived";
+
+        let packetsNow = now[key];
+        if (!packetsNow || packetsNow < 0) {
+            packetsNow = 0;
+        }
+
+        const packetsBefore = ValueFormatter.getNonNegativeValue(before[key]);
+        const packetsDiff = Math.max(0, packetsNow - packetsBefore);
+
+        const packetsLostNow = ValueFormatter.getNonNegativeValue(now.packetsLost);
+        const packetsLostBefore = ValueFormatter.getNonNegativeValue(before.packetsLost);
+        const packetsLostDiff = Math.max(0, packetsLostNow - packetsLostBefore);
+
+        trackStats.setLoss({
+            packetsTotal: packetsDiff + packetsLostDiff,
+            packetsLost: packetsLostDiff,
+            isDownloadStream: now.type !== "outbound-rtp",
+        });
+    }
+
+    private static calculateBitrate(
+        bytesNowAny: any,
+        bytesBeforeAny: any,
+        nowTimestamp: number,
+        beforeTimestamp: number,
+    ): number {
+        const bytesNow = ValueFormatter.getNonNegativeValue(bytesNowAny);
+        const bytesBefore = ValueFormatter.getNonNegativeValue(bytesBeforeAny);
+        const bytesProcessed = Math.max(0, bytesNow - bytesBefore);
+
+        const timeMs = nowTimestamp - beforeTimestamp;
+        let bitrateKbps = 0;
+
+        if (timeMs > 0) {
+            bitrateKbps = Math.round((bytesProcessed * 8) / timeMs);
+        }
+
+        return bitrateKbps;
+    }
+
+    public static setTrackStatsState(trackStats: MediaTrackStats, transceiver: RTCRtpTransceiver | undefined): void {
+        if (transceiver === undefined) {
+            trackStats.alive = false;
+            return;
+        }
+
+        const track = trackStats.getType() === "remote" ? transceiver.receiver.track : transceiver?.sender?.track;
+        if (track === undefined || track === null) {
+            trackStats.alive = false;
+            return;
+        }
+
+        if (track.readyState === "ended") {
+            trackStats.alive = false;
+            return;
+        }
+        trackStats.muted = track.muted;
+        trackStats.enabled = track.enabled;
+        trackStats.alive = true;
+    }
+
+    public static buildTrackSummary(trackStatsList: MediaTrackStats[]): {
+        audioTrackSummary: TrackSummary;
+        videoTrackSummary: TrackSummary;
+    } {
+        const videoTrackSummary: TrackSummary = {
+            count: 0,
+            muted: 0,
+            maxJitter: 0,
+            maxPacketLoss: 0,
+            concealedAudio: 0,
+            totalAudio: 0,
+        };
+        const audioTrackSummary: TrackSummary = {
+            count: 0,
+            muted: 0,
+            maxJitter: 0,
+            maxPacketLoss: 0,
+            concealedAudio: 0,
+            totalAudio: 0,
+        };
+
+        const remoteTrackList = trackStatsList.filter((t) => t.getType() === "remote");
+        const audioTrackList = remoteTrackList.filter((t) => t.kind === "audio");
+
+        remoteTrackList.forEach((stats) => {
+            const trackSummary = stats.kind === "video" ? videoTrackSummary : audioTrackSummary;
+            trackSummary.count++;
+            if (stats.alive && stats.muted) {
+                trackSummary.muted++;
+            }
+            if (trackSummary.maxJitter < stats.getJitter()) {
+                trackSummary.maxJitter = stats.getJitter();
+            }
+            if (trackSummary.maxPacketLoss < stats.getLoss().packetsLost) {
+                trackSummary.maxPacketLoss = stats.getLoss().packetsLost;
+            }
+            if (audioTrackList.length > 0) {
+                trackSummary.concealedAudio += stats.getAudioConcealment()?.concealedAudio;
+                trackSummary.totalAudio += stats.getAudioConcealment()?.totalAudioDuration;
+            }
+        });
+
+        return { audioTrackSummary, videoTrackSummary };
+    }
+
+    public static buildJitter(trackStats: MediaTrackStats, statsReport: any): void {
+        if (statsReport.type !== "inbound-rtp") {
+            return;
+        }
+
+        const jitterStr = statsReport?.jitter;
+        if (jitterStr !== undefined) {
+            const jitter = ValueFormatter.getNonNegativeValue(jitterStr);
+            trackStats.setJitter(Math.round(jitter * 1000));
+        } else {
+            trackStats.setJitter(-1);
+        }
+    }
+
+    public static buildAudioConcealment(trackStats: MediaTrackStats, statsReport: any): void {
+        if (statsReport.type !== "inbound-rtp") {
+            return;
+        }
+        const msPerSample = (1000 * statsReport?.totalSamplesDuration) / statsReport?.totalSamplesReceived;
+        const concealedAudioDuration = msPerSample * statsReport?.concealedSamples;
+        const totalAudioDuration = 1000 * statsReport?.totalSamplesDuration;
+        trackStats.setAudioConcealment(concealedAudioDuration, totalAudioDuration);
+    }
+}

package/src/webrtc/stats/transportStats.ts

@@ -1,26 +1,26 @@
-/*
-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 interface TransportStats {
-    ip: string;
-    type: string;
-    localIp: string;
-    isFocus: boolean;
-    localCandidateType: string;
-    remoteCandidateType: string;
-    networkType: string;
-    rtt: number;
-}
+/*
+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 interface TransportStats {
+    ip: string;
+    type: string;
+    localIp: string;
+    isFocus: boolean;
+    localCandidateType: string;
+    remoteCandidateType: string;
+    networkType: string;
+    rtt: number;
+}

package/src/webrtc/stats/transportStatsBuilder.ts

@@ -1,48 +1,48 @@
-import { type TransportStats } from "./transportStats.ts";
-
-export class TransportStatsBuilder {
-    public static buildReport(
-        report: RTCStatsReport | undefined,
-        now: RTCIceCandidatePairStats,
-        conferenceStatsTransport: TransportStats[],
-        isFocus: boolean,
-    ): TransportStats[] {
-        const localUsedCandidate = report?.get(now.localCandidateId);
-        const remoteUsedCandidate = report?.get(now.remoteCandidateId);
-
-        // RTCIceCandidateStats
-        // https://w3c.github.io/webrtc-stats/#icecandidate-dict*
-        if (remoteUsedCandidate && localUsedCandidate) {
-            const remoteIpAddress =
-                remoteUsedCandidate.ip !== undefined ? remoteUsedCandidate.ip : remoteUsedCandidate.address;
-            const remotePort = remoteUsedCandidate.port;
-            const ip = `${remoteIpAddress}:${remotePort}`;
-
-            const localIpAddress =
-                localUsedCandidate.ip !== undefined ? localUsedCandidate.ip : localUsedCandidate.address;
-            const localPort = localUsedCandidate.port;
-            const localIp = `${localIpAddress}:${localPort}`;
-
-            const type = remoteUsedCandidate.protocol;
-
-            // Save the address unless it has been saved already.
-            if (
-                !conferenceStatsTransport.some(
-                    (t: TransportStats) => t.ip === ip && t.type === type && t.localIp === localIp,
-                )
-            ) {
-                conferenceStatsTransport.push({
-                    ip,
-                    type,
-                    localIp,
-                    isFocus,
-                    localCandidateType: localUsedCandidate.candidateType,
-                    remoteCandidateType: remoteUsedCandidate.candidateType,
-                    networkType: localUsedCandidate.networkType,
-                    rtt: now.currentRoundTripTime ? now.currentRoundTripTime * 1000 : NaN,
-                } as TransportStats);
-            }
-        }
-        return conferenceStatsTransport;
-    }
-}
+import { type TransportStats } from "./transportStats.ts";
+
+export class TransportStatsBuilder {
+    public static buildReport(
+        report: RTCStatsReport | undefined,
+        now: RTCIceCandidatePairStats,
+        conferenceStatsTransport: TransportStats[],
+        isFocus: boolean,
+    ): TransportStats[] {
+        const localUsedCandidate = report?.get(now.localCandidateId);
+        const remoteUsedCandidate = report?.get(now.remoteCandidateId);
+
+        // RTCIceCandidateStats
+        // https://w3c.github.io/webrtc-stats/#icecandidate-dict*
+        if (remoteUsedCandidate && localUsedCandidate) {
+            const remoteIpAddress =
+                remoteUsedCandidate.ip !== undefined ? remoteUsedCandidate.ip : remoteUsedCandidate.address;
+            const remotePort = remoteUsedCandidate.port;
+            const ip = `${remoteIpAddress}:${remotePort}`;
+
+            const localIpAddress =
+                localUsedCandidate.ip !== undefined ? localUsedCandidate.ip : localUsedCandidate.address;
+            const localPort = localUsedCandidate.port;
+            const localIp = `${localIpAddress}:${localPort}`;
+
+            const type = remoteUsedCandidate.protocol;
+
+            // Save the address unless it has been saved already.
+            if (
+                !conferenceStatsTransport.some(
+                    (t: TransportStats) => t.ip === ip && t.type === type && t.localIp === localIp,
+                )
+            ) {
+                conferenceStatsTransport.push({
+                    ip,
+                    type,
+                    localIp,
+                    isFocus,
+                    localCandidateType: localUsedCandidate.candidateType,
+                    remoteCandidateType: remoteUsedCandidate.candidateType,
+                    networkType: localUsedCandidate.networkType,
+                    rtt: now.currentRoundTripTime ? now.currentRoundTripTime * 1000 : NaN,
+                } as TransportStats);
+            }
+        }
+        return conferenceStatsTransport;
+    }
+}

package/src/webrtc/stats/valueFormatter.ts

@@ -1,27 +1,27 @@
-/*
-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 class ValueFormatter {
-    public static getNonNegativeValue(imput: any): number {
-        let value = imput;
-
-        if (typeof value !== "number") {
-            value = Number(value);
-        }
-
-        if (isNaN(value)) {
-            return 0;
-        }
-
-        return Math.max(0, value);
-    }
-}
+/*
+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 class ValueFormatter {
+    public static getNonNegativeValue(imput: any): number {
+        let value = imput;
+
+        if (typeof value !== "number") {
+            value = Number(value);
+        }
+
+        if (isNaN(value)) {
+            return 0;
+        }
+
+        return Math.max(0, value);
+    }
+}