@livedigital/client 2.26.0-stop-streams.1 → 2.27.0

package/src/engine/wid/detectors/FramesEncodedSentIssueDetector.ts

@@ -1,69 +0,0 @@
-import {
-  IssueDetector,
-  IssueDetectorResult,
-  IssueReason,
-  IssueType,
-  WebRTCStatsParsed,
-} from '../types';
-
-class FramesEncodedSentIssueDetector implements IssueDetector {
-  #lastProcessedStats: { [connectionId: string]: WebRTCStatsParsed } = {};
-
-  #missedFramesTreshold = 0.15;
-
-  detect(data: WebRTCStatsParsed): IssueDetectorResult {
-    const issues = this.processData(data);
-    this.#lastProcessedStats[data.connection.id] = data;
-    return issues;
-  }
-
-  private processData(data: WebRTCStatsParsed): IssueDetectorResult {
-    const streamsWithEncodedFrames = data.video.outbound.filter((stats) => stats.framesEncoded > 0);
-    const issues: IssueDetectorResult = [];
-    const previousOutboundRTPVideoStreamsStats = this.#lastProcessedStats[data.connection.id]?.video.outbound;
-
-    if (!previousOutboundRTPVideoStreamsStats) {
-      return issues;
-    }
-
-    streamsWithEncodedFrames.forEach((streamStats) => {
-      const previousStreamStats = previousOutboundRTPVideoStreamsStats.find((item) => item.ssrc === streamStats.ssrc);
-
-      if (!previousStreamStats) {
-        return;
-      }
-
-      if (streamStats.framesEncoded === previousStreamStats.framesEncoded) {
-        // stream is paused
-        return;
-      }
-
-      const deltaFramesEncoded = streamStats.framesEncoded - previousStreamStats.framesEncoded;
-      const deltaFramesSent = streamStats.framesSent - previousStreamStats.framesSent;
-
-      if (deltaFramesEncoded === 0) {
-        // stream is paused
-        return;
-      }
-
-      if (deltaFramesEncoded === deltaFramesSent) {
-        // stream is ok
-        return;
-      }
-
-      const missedFrames = deltaFramesSent / deltaFramesEncoded;
-      if (missedFrames >= this.#missedFramesTreshold) {
-        issues.push({
-          type: IssueType.Network,
-          reason: IssueReason.OutboundNetworkThroughput,
-          ssrc: streamStats.ssrc,
-          debug: `missedFrames: ${Math.round(missedFrames * 100)}%`,
-        });
-      }
-    });
-
-    return issues;
-  }
-}
-
-export default FramesEncodedSentIssueDetector;

package/src/engine/wid/detectors/InboundNetworkIssueDetector.ts

@@ -1,120 +0,0 @@
-import {
-  IssueDetector,
-  IssueDetectorResult,
-  IssueReason,
-  IssueType,
-  WebRTCStatsParsed,
-} from '../types';
-
-class InboundNetworkIssueDetector implements IssueDetector {
-  #lastProcessedStats: { [connectionId: string]: WebRTCStatsParsed } = {};
-
-  detect(data: WebRTCStatsParsed): IssueDetectorResult {
-    const issues = this.processData(data);
-    this.#lastProcessedStats[data.connection.id] = data;
-    return issues;
-  }
-
-  private processData(data: WebRTCStatsParsed): IssueDetectorResult {
-    const issues: IssueDetectorResult = [];
-    const inboundRTPStreamsStats = [...data.audio?.inbound, ...data.video?.inbound];
-    if (!inboundRTPStreamsStats.length) {
-      return issues;
-    }
-
-    const previousStats = this.#lastProcessedStats[data.connection.id];
-    if (!previousStats) {
-      return issues;
-    }
-
-    const previousInboundStreamStats = [...previousStats.video?.inbound, ...previousStats.audio?.inbound];
-    const { packetsReceived } = data.connection;
-    const lastPacketsReceived = previousStats.connection.packetsReceived;
-
-    const rtpNetworkStats = inboundRTPStreamsStats.reduce((stats, currentStreamStats) => {
-      const previousStreamStats = previousInboundStreamStats.find((stream) => stream.ssrc === currentStreamStats.ssrc);
-
-      const lastJitterBufferDelay = previousStreamStats?.jitterBufferDelay || 0;
-      const lastJitterBufferEmittedCount = previousStreamStats?.jitterBufferEmittedCount || 0;
-      const delay = currentStreamStats.jitterBufferDelay - lastJitterBufferDelay;
-      const emitted = currentStreamStats.jitterBufferEmittedCount - lastJitterBufferEmittedCount;
-      const jitterBufferDelayMs = delay && emitted ? (1e3 * delay) / emitted : 0;
-
-      return {
-        sumJitter: stats.sumJitter + currentStreamStats.jitter,
-        sumJitterBufferDelayMs: stats.sumJitterBufferDelayMs + jitterBufferDelayMs,
-        packetsLost: stats.packetsLost + currentStreamStats.packetsLost,
-        lastPacketsLost: stats.lastPacketsLost + (previousStreamStats?.packetsLost || 0),
-      };
-    }, {
-      sumJitter: 0,
-      sumJitterBufferDelayMs: 0,
-      packetsLost: 0,
-      lastPacketsLost: 0,
-    });
-
-    const rtt = (1e3 * data.connection.currentRoundTripTime) || 0;
-    const { sumJitter, sumJitterBufferDelayMs } = rtpNetworkStats;
-    const avgJitter = sumJitter / inboundRTPStreamsStats.length;
-    const avgJitterBufferDelay = sumJitterBufferDelayMs / inboundRTPStreamsStats.length;
-
-    const deltaPacketReceived = packetsReceived - lastPacketsReceived;
-    const deltaPacketLost = rtpNetworkStats.packetsLost - rtpNetworkStats.lastPacketsLost;
-
-    const packetsLoss = deltaPacketReceived && deltaPacketLost
-      ? Math.round((deltaPacketLost * 100) / (deltaPacketReceived + deltaPacketLost))
-      : 0;
-
-    const isHighPacketsLoss = packetsLoss > 5;
-    const isHighJitter = avgJitter >= 200;
-    const isHighRTT = rtt >= 250;
-    const isHighJitterBufferDelay = avgJitterBufferDelay > 500;
-    const isNetworkIssue = (!isHighPacketsLoss && isHighJitter) || isHighJitter || isHighPacketsLoss;
-    const isServerIssue = isHighRTT && !isHighJitter && !isHighPacketsLoss;
-    const isNetworkMediaLatencyIssue = isHighPacketsLoss && isHighJitter;
-    const isNetworkMediaSyncIssue = isHighJitter && isHighJitterBufferDelay;
-
-    const debug = `packetLoss: ${packetsLoss}%, jitter: ${avgJitter}, rtt: ${rtt},`
-      + ` jitterBuffer: ${avgJitterBufferDelay}ms`;
-
-    if (isNetworkIssue) {
-      issues.push({
-        type: IssueType.Network,
-        reason: IssueReason.InboundNetworkQuality,
-        iceCandidate: data.connection.local.id,
-        debug,
-      });
-    }
-
-    if (isServerIssue) {
-      issues.push({
-        type: IssueType.Server,
-        reason: IssueReason.ServerIssue,
-        iceCandidate: data.connection.remote.id,
-        debug,
-      });
-    }
-
-    if (isNetworkMediaLatencyIssue) {
-      issues.push({
-        type: IssueType.Network,
-        reason: IssueReason.InboundNetworkMediaLatency,
-        iceCandidate: data.connection.local.id,
-        debug,
-      });
-    }
-
-    if (isNetworkMediaSyncIssue) {
-      issues.push({
-        type: IssueType.Network,
-        reason: IssueReason.NetworkMediaSyncFailure,
-        iceCandidate: data.connection.local.id,
-        debug,
-      });
-    }
-
-    return issues;
-  }
-}
-
-export default InboundNetworkIssueDetector;

package/src/engine/wid/detectors/NetworkMediaSyncIssueDetector.ts

@@ -1,60 +0,0 @@
-import {
-  IssueDetector,
-  IssueDetectorResult,
-  IssueReason,
-  IssueType,
-  WebRTCStatsParsed,
-} from '../types';
-
-class NetworkMediaSyncIssueDetector implements IssueDetector {
-  #lastProcessedStats: { [connectionId: string]: WebRTCStatsParsed } = {};
-
-  detect(data: WebRTCStatsParsed): IssueDetectorResult {
-    const issues = this.processData(data);
-    this.#lastProcessedStats[data.connection.id] = data;
-    return issues;
-  }
-
-  private processData(data: WebRTCStatsParsed): IssueDetectorResult {
-    const inboundRTPAudioStreamsStats = data.audio.inbound;
-    const issues: IssueDetectorResult = [];
-    const previousInboundRTPAudioStreamsStats = this.#lastProcessedStats[data.connection.id]?.audio.inbound;
-
-    if (!previousInboundRTPAudioStreamsStats) {
-      return issues;
-    }
-
-    inboundRTPAudioStreamsStats.forEach((stats) => {
-      const previousStreamStats = previousInboundRTPAudioStreamsStats.find((item) => item.ssrc === stats.ssrc);
-      if (!previousStreamStats) {
-        return;
-      }
-
-      const nowCorrectedSamples = stats.track.insertedSamplesForDeceleration
-        + stats.track.removedSamplesForAcceleration;
-      const lastCorrectedSamples = previousStreamStats.track.insertedSamplesForDeceleration
-        + previousStreamStats.track.removedSamplesForAcceleration;
-
-      if (nowCorrectedSamples === lastCorrectedSamples) {
-        return;
-      }
-
-      const deltaSamplesReceived = stats.track.totalSamplesReceived - previousStreamStats.track.totalSamplesReceived;
-      const deltaCorrectedSamples = nowCorrectedSamples - lastCorrectedSamples;
-      const correctedSamplesPercentage = Math.round((deltaCorrectedSamples * 100) / deltaSamplesReceived);
-
-      if (correctedSamplesPercentage > 5) {
-        issues.push({
-          type: IssueType.Network,
-          reason: IssueReason.NetworkMediaSyncFailure,
-          ssrc: stats.ssrc,
-          debug: `correctedSamplesPercentage: ${correctedSamplesPercentage}%`,
-        });
-      }
-    });
-
-    return issues;
-  }
-}
-
-export default NetworkMediaSyncIssueDetector;

package/src/engine/wid/detectors/OutboundNetworkIssueDetector.ts

@@ -1,96 +0,0 @@
-import {
-  IssueDetector,
-  IssueDetectorResult,
-  IssueReason,
-  IssueType,
-  WebRTCStatsParsed,
-} from '../types';
-
-class OutboundNetworkIssueDetector implements IssueDetector {
-  #lastProcessedStats: { [connectionId: string]: WebRTCStatsParsed } = {};
-
-  detect(data: WebRTCStatsParsed): IssueDetectorResult {
-    const issues = this.processData(data);
-    this.#lastProcessedStats[data.connection.id] = data;
-    return issues;
-  }
-
-  private processData(data: WebRTCStatsParsed): IssueDetectorResult {
-    const issues: IssueDetectorResult = [];
-    const remoteInboundRTPStreamsStats = [
-      ...data.remote?.audio.inbound || [],
-      ...data.remote?.video.inbound || [],
-    ];
-
-    if (!remoteInboundRTPStreamsStats.length) {
-      return issues;
-    }
-
-    const previousStats = this.#lastProcessedStats[data.connection.id];
-    if (!previousStats) {
-      return issues;
-    }
-
-    const previousRemoteInboundRTPStreamsStats = [
-      ...previousStats.remote?.audio.inbound || [],
-      ...previousStats.remote?.video.inbound || [],
-    ];
-
-    const { packetsSent } = data.connection;
-    const lastPacketsSent = previousStats.connection.packetsSent;
-
-    const rtpNetworkStats = remoteInboundRTPStreamsStats.reduce((stats, currentStreamStats) => {
-      const previousStreamStats = previousRemoteInboundRTPStreamsStats
-        .find((stream) => stream.ssrc === currentStreamStats.ssrc);
-
-      return {
-        sumJitter: stats.sumJitter + currentStreamStats.jitter,
-        packetsLost: stats.packetsLost + currentStreamStats.packetsLost,
-        lastPacketsLost: stats.lastPacketsLost + (previousStreamStats?.packetsLost || 0),
-      };
-    }, {
-      sumJitter: 0,
-      packetsLost: 0,
-      lastPacketsLost: 0,
-    });
-
-    const rtt = (1e3 * data.connection.currentRoundTripTime) || 0;
-    const { sumJitter } = rtpNetworkStats;
-    const avgJitter = sumJitter / remoteInboundRTPStreamsStats.length;
-
-    const deltaPacketSent = packetsSent - lastPacketsSent;
-    const deltaPacketLost = rtpNetworkStats.packetsLost - rtpNetworkStats.lastPacketsLost;
-
-    const packetsLoss = deltaPacketSent && deltaPacketLost
-      ? Math.round((deltaPacketLost * 100) / (deltaPacketSent + deltaPacketLost))
-      : 0;
-
-    const isHighPacketsLoss = packetsLoss > 5;
-    const isHighJitter = avgJitter >= 200;
-    const isNetworkMediaLatencyIssue = isHighPacketsLoss && isHighJitter;
-    const isNetworkIssue = (!isHighPacketsLoss && isHighJitter) || isHighJitter || isHighPacketsLoss;
-    const debug = `packetLoss: ${packetsLoss}%, jitter: ${avgJitter}, rtt: ${rtt}`;
-
-    if (isNetworkMediaLatencyIssue) {
-      issues.push({
-        type: IssueType.Network,
-        reason: IssueReason.OutboundNetworkMediaLatency,
-        iceCandidate: data.connection.local.id,
-        debug,
-      });
-    }
-
-    if (isNetworkIssue) {
-      issues.push({
-        type: IssueType.Network,
-        reason: IssueReason.OutboundNetworkQuality,
-        iceCandidate: data.connection.local.id,
-        debug,
-      });
-    }
-
-    return issues;
-  }
-}
-
-export default OutboundNetworkIssueDetector;

package/src/engine/wid/detectors/QualityLimitationsIssueDetector.ts

@@ -1,63 +0,0 @@
-import {
-  IssueDetector,
-  IssueDetectorResult,
-  IssueReason,
-  IssueType,
-  WebRTCStatsParsed,
-} from '../types';
-
-class QualityLimitationsIssueDetector implements IssueDetector {
-  #lastProcessedStats: { [connectionId: string]: WebRTCStatsParsed } = {};
-
-  detect(data: WebRTCStatsParsed): IssueDetectorResult {
-    const issues = this.processData(data);
-    this.#lastProcessedStats[data.connection.id] = data;
-    return issues;
-  }
-
-  private processData(data: WebRTCStatsParsed): IssueDetectorResult {
-    const streamsWithLimitation = data.video.outbound.filter((stats) => stats.qualityLimitationReason !== 'none');
-    const issues: IssueDetectorResult = [];
-    const previousOutboundRTPVideoStreamsStats = this.#lastProcessedStats[data.connection.id]?.video.outbound;
-
-    if (!previousOutboundRTPVideoStreamsStats) {
-      return issues;
-    }
-
-    streamsWithLimitation.forEach((streamStats) => {
-      const previousStreamStats = previousOutboundRTPVideoStreamsStats.find((item) => item.ssrc === streamStats.ssrc);
-
-      if (!previousStreamStats) {
-        // can not determine current status of the stream
-        return;
-      }
-
-      if (streamStats.framesSent > previousStreamStats.framesSent) {
-        // stream is still sending
-        return;
-      }
-
-      if (streamStats.qualityLimitationReason === 'cpu') {
-        issues.push({
-          type: IssueType.CPU,
-          reason: IssueReason.EncoderCPUThrottling,
-          ssrc: streamStats.ssrc,
-          debug: 'qualityLimitationReason: cpu',
-        });
-      }
-
-      if (streamStats.qualityLimitationReason === 'bandwidth') {
-        issues.push({
-          type: IssueType.Network,
-          reason: IssueReason.OutboundNetworkThroughput,
-          ssrc: streamStats.ssrc,
-          debug: 'qualityLimitationReason: bandwidth',
-        });
-      }
-    });
-
-    return issues;
-  }
-}
-
-export default QualityLimitationsIssueDetector;

package/src/engine/wid/detectors/VideoCodecMismatchDetector.ts

@@ -1,78 +0,0 @@
-import {
-  IssueDetector,
-  IssueDetectorResult,
-  IssueReason,
-  IssueType,
-  WebRTCStatsParsed,
-} from '../types';
-
-class VideoCodecMismatchDetector implements IssueDetector {
-  readonly UNKNOWN_DECODER = 'unknown';
-
-  #lastProcessedStats: { [connectionId: string]: WebRTCStatsParsed | undefined } = {};
-
-  #lastDecoderWithIssue: {
-    [connectionId: string]: { [ssrc: string]: string | undefined } | undefined;
-  } = {};
-
-  detect(data: WebRTCStatsParsed): IssueDetectorResult {
-    const issues = this.processData(data);
-    this.#lastProcessedStats[data.connection.id] = data;
-    return issues;
-  }
-
-  private processData(data: WebRTCStatsParsed): IssueDetectorResult {
-    const issues: IssueDetectorResult = [];
-    const { id: connectionId } = data.connection;
-    const previousInboundRTPVideoStreamsStats = this.#lastProcessedStats[connectionId]?.video.inbound;
-
-    data.video.inbound.forEach((streamStats) => {
-      const { decoderImplementation: currentDecoder, ssrc } = streamStats;
-      const prevStats = previousInboundRTPVideoStreamsStats?.find((item) => item.ssrc === ssrc);
-
-      // skipping the first iteration on purpose
-      if (!prevStats) {
-        return;
-      }
-
-      if (currentDecoder !== this.UNKNOWN_DECODER) {
-        this.setLastDecoderWithIssue(connectionId, ssrc, undefined);
-        return;
-      }
-
-      if (!this.hadLastDecoderWithIssue(connectionId, ssrc)) {
-        this.setLastDecoderWithIssue(connectionId, ssrc, this.UNKNOWN_DECODER);
-
-        issues.push({
-          ssrc,
-          type: IssueType.Stream,
-          reason: IssueReason.VideoCodecMismatchIssue,
-          trackIdentifier: streamStats.track.trackIdentifier,
-          debug: `mimeType: ${streamStats.mimeType}, decoderImplementation: ${currentDecoder}`,
-        });
-      }
-    });
-
-    return issues;
-  }
-
-  private setLastDecoderWithIssue(connectionId: string, ssrc: number, decoder: string | undefined): void {
-    const issues = this.#lastDecoderWithIssue[connectionId] ?? {};
-
-    if (decoder === undefined) {
-      delete issues[ssrc];
-    } else {
-      issues[ssrc] = decoder;
-    }
-
-    this.#lastDecoderWithIssue[connectionId] = issues;
-  }
-
-  private hadLastDecoderWithIssue(connectionId: string, ssrc: number): boolean {
-    const issues = this.#lastDecoderWithIssue[connectionId];
-    const decoder = issues && issues[ssrc];
-    return decoder === this.UNKNOWN_DECODER;
-  }
-}
-
-export default VideoCodecMismatchDetector;

package/src/engine/wid/lib/NetworkScoresCalculator.ts

@@ -1,126 +0,0 @@
-/* eslint-disable class-methods-use-this */
-import {
-  NetworkScore,
-  NetworkScores,
-  NetworkScoresCalculator as INetworkScoresCalculator,
-  WebRTCStatsParsed,
-} from '../types';
-
-class NetworkScoresCalculator implements INetworkScoresCalculator {
-  #lastProcessedStats: { [connectionId: string]: WebRTCStatsParsed } = {};
-
-  calculate(data: WebRTCStatsParsed): NetworkScores {
-    const outbound = this.calcucateOutboundScore(data);
-    const inbound = this.calculateInboundScore(data);
-    this.#lastProcessedStats[data.connection.id] = data;
-    return { outbound, inbound };
-  }
-
-  private calcucateOutboundScore(data: WebRTCStatsParsed): NetworkScore | undefined {
-    const remoteInboundRTPStreamsStats = [
-      ...data.remote?.audio.inbound || [],
-      ...data.remote?.video.inbound || [],
-    ];
-
-    if (!remoteInboundRTPStreamsStats.length) {
-      return undefined;
-    }
-
-    const previousStats = this.#lastProcessedStats[data.connection.id];
-    if (!previousStats) {
-      return undefined;
-    }
-
-    const previousRemoteInboundRTPStreamsStats = [
-      ...previousStats.remote?.audio.inbound || [],
-      ...previousStats.remote?.video.inbound || [],
-    ];
-
-    const { packetsSent } = data.connection;
-    const lastPacketsSent = previousStats.connection.packetsSent;
-
-    const rtpNetworkStats = remoteInboundRTPStreamsStats.reduce((stats, currentStreamStats) => {
-      const previousStreamStats = previousRemoteInboundRTPStreamsStats
-        .find((stream) => stream.ssrc === currentStreamStats.ssrc);
-
-      return {
-        sumJitter: stats.sumJitter + currentStreamStats.jitter,
-        packetsLost: stats.packetsLost + currentStreamStats.packetsLost,
-        lastPacketsLost: stats.lastPacketsLost + (previousStreamStats?.packetsLost || 0),
-      };
-    }, {
-      sumJitter: 0,
-      packetsLost: 0,
-      lastPacketsLost: 0,
-    });
-
-    const rtt = (1e3 * data.connection.currentRoundTripTime) || 0;
-    const { sumJitter } = rtpNetworkStats;
-    const avgJitter = sumJitter / remoteInboundRTPStreamsStats.length;
-
-    const deltaPacketSent = packetsSent - lastPacketsSent;
-    const deltaPacketLost = rtpNetworkStats.packetsLost - rtpNetworkStats.lastPacketsLost;
-
-    const packetsLoss = deltaPacketSent && deltaPacketLost
-      ? Math.round((deltaPacketLost * 100) / (deltaPacketSent + deltaPacketLost))
-      : 0;
-
-    return this.calculateMOS({ avgJitter, rtt, packetsLoss });
-  }
-
-  private calculateInboundScore(data: WebRTCStatsParsed): NetworkScore | undefined {
-    const inboundRTPStreamsStats = [...data.audio?.inbound, ...data.video?.inbound];
-    if (!inboundRTPStreamsStats.length) {
-      return undefined;
-    }
-
-    const previousStats = this.#lastProcessedStats[data.connection.id];
-    if (!previousStats) {
-      return undefined;
-    }
-
-    const previousInboundStreamStats = [...previousStats.video?.inbound, ...previousStats.audio?.inbound];
-    const { packetsReceived } = data.connection;
-    const lastPacketsReceived = previousStats.connection.packetsReceived;
-
-    const rtpNetworkStats = inboundRTPStreamsStats.reduce((stats, currentStreamStats) => {
-      const previousStreamStats = previousInboundStreamStats.find((stream) => stream.ssrc === currentStreamStats.ssrc);
-      return {
-        sumJitter: stats.sumJitter + currentStreamStats.jitter,
-        packetsLost: stats.packetsLost + currentStreamStats.packetsLost,
-        lastPacketsLost: stats.lastPacketsLost + (previousStreamStats?.packetsLost || 0),
-      };
-    }, {
-      sumJitter: 0,
-      packetsLost: 0,
-      lastPacketsLost: 0,
-    });
-
-    const rtt = (1e3 * data.connection.currentRoundTripTime) || 0;
-    const { sumJitter } = rtpNetworkStats;
-    const avgJitter = sumJitter / inboundRTPStreamsStats.length;
-
-    const deltaPacketReceived = packetsReceived - lastPacketsReceived;
-    const deltaPacketLost = rtpNetworkStats.packetsLost - rtpNetworkStats.lastPacketsLost;
-
-    const packetsLoss = deltaPacketReceived && deltaPacketLost
-      ? Math.round((deltaPacketLost * 100) / (deltaPacketReceived + deltaPacketLost))
-      : 0;
-
-    return this.calculateMOS({ avgJitter, rtt, packetsLoss });
-  }
-
-  private calculateMOS(
-    { avgJitter, rtt, packetsLoss }:
-    { avgJitter: number, rtt: number, packetsLoss: number },
-  ): number {
-    const effectiveLatency = rtt + (avgJitter * 2) + 10;
-    let rFactor = effectiveLatency < 160
-      ? 93.2 - (effectiveLatency / 40)
-      : 93.2 - (effectiveLatency / 120) - 10;
-    rFactor -= (packetsLoss * 2.5);
-    return 1 + (0.035) * rFactor + (0.000007) * rFactor * (rFactor - 60) * (100 - rFactor);
-  }
-}
-
-export default NetworkScoresCalculator;

package/src/engine/wid/lib/PeriodicWebRTCStatsReporter.ts

@@ -1,66 +0,0 @@
-import { EventEmitter } from 'events';
-import { CompositeStatsParser, StatsReportItem } from '../types';
-
-interface PeriodicWebRTCStatsReporterParams {
-  compositeStatsParser: CompositeStatsParser;
-  getStatsInterval?: number;
-}
-
-class PeriodicWebRTCStatsReporter extends EventEmitter {
-  static readonly STATS_REPORT_READY_EVENT = 'stats-report-ready';
-
-  private isStopped = false;
-
-  private reportTimer: NodeJS.Timer | undefined;
-
-  private readonly getStatsInterval: number;
-
-  private readonly compositeStatsParser: CompositeStatsParser;
-
-  constructor(params: PeriodicWebRTCStatsReporterParams) {
-    super();
-    this.compositeStatsParser = params.compositeStatsParser;
-    this.getStatsInterval = params.getStatsInterval ?? 10000;
-  }
-
-  get isRunning(): boolean {
-    return !!this.reportTimer && !this.isStopped;
-  }
-
-  startReporting(): void {
-    if (this.reportTimer) {
-      return;
-    }
-
-    const doExtract = () => setTimeout(() => {
-      if (this.isStopped) {
-        return;
-      }
-
-      this.parseReports()
-        .finally(() => doExtract());
-    }, this.getStatsInterval);
-
-    this.isStopped = false;
-    this.reportTimer = doExtract();
-  }
-
-  stopReporting(): void {
-    this.isStopped = true;
-
-    if (this.reportTimer) {
-      clearTimeout(this.reportTimer);
-      this.reportTimer = undefined;
-    }
-  }
-
-  private async parseReports() {
-    const reportItems = await this.compositeStatsParser.parse();
-
-    reportItems.forEach((item: StatsReportItem) => {
-      this.emit(PeriodicWebRTCStatsReporter.STATS_REPORT_READY_EVENT, item);
-    });
-  }
-}
-
-export default PeriodicWebRTCStatsReporter;