@observertc/observer-js 0.41.7 → 0.42.0

package/lib/index.d.ts

@@ -9,8 +9,10 @@ export type { ClientIssueMonitorConfig, ClientIssueMonitorEmittedIssueEvent, Cli
 export type { ObservedCall, ObservedCallModel } from './ObservedCall';
 export type { ObservedClient, ObservedClientModel } from './ObservedClient';
 export type { ObservedPeerConnection, ObservedPeerConnectionModel, ObservedPeerConnectionEvents } from './ObservedPeerConnection';
-export type { ObservedInboundTrack, ObservedInboundTrackModel, ObservedInboundTrackEvents } from './ObservedInboundTrack';
-export type { ObservedOutboundTrack, ObservedOutboundTrackModel, ObservedOutboundTrackEvents } from './ObservedOutboundTrack';
+export type { ObservedInboundAudioTrack, ObservedInboundAudioTrackModel, ObservedInboundAudioTrackEvents } from './ObservedInboundAudioTrack';
+export type { ObservedOutboundAudioTrack, ObservedOutboundAudioTrackModel, ObservedOutboundAudioTrackEvents } from './ObservedOutboundAudioTrack';
+export type { ObservedInboundVideoTrack, ObservedInboundVideoTrackModel, ObservedInboundVideoTrackEvents } from './ObservedInboundVideoTrack';
+export type { ObservedOutboundVideoTrack, ObservedOutboundVideoTrackModel, ObservedOutboundVideoTrackEvents } from './ObservedOutboundVideoTrack';
 export type { CallSummary, ClientSummary, ClientIssue } from './monitors/CallSummary';
 export type { ObserverSinkContext } from './common/types';
 export type { SfuServerMonitorMetricsRecord } from './monitors/SfuServerMonitor';

package/lib/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjE,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtC,OAAO,KAAK,YAAY,MAAM,+BAA+B,CAAC;AAC9D,OAAO,KAAK,YAAY,MAAM,+BAA+B,CAAC;AAE9D,YAAY,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAExD,YAAY,EACX,OAAO,EACP,YAAY,EACZ,SAAS,EACT,aAAa,EACb,uBAAuB,EACvB,gBAAgB,EAChB,eAAe,EACf,eAAe,EACf,iBAAiB,EACjB,iBAAiB,EACjB,kBAAkB,EAClB,kBAAkB,EAClB,iBAAiB,EACjB,kBAAkB,EAClB,eAAe,EACf,YAAY,EACZ,gBAAgB,EAChB,iBAAiB,EACjB,cAAc,EACd,iBAAiB,EACjB,WAAW,GACX,MAAM,+BAA+B,CAAC;AAEvC,YAAY,EACX,eAAe,EACf,cAAc,EACd,uBAAuB,EACvB,qBAAqB,EACrB,sBAAsB,EACtB,uBAAuB,EACvB,uBAAuB,EACvB,mBAAmB,EACnB,wBAAwB,EACxB,wBAAwB,EACxB,6BAA6B,EAC7B,cAAc,EACd,kBAAkB,EAClB,sBAAsB,EACtB,aAAa,EACb,uBAAuB,EACvB,mBAAmB,EACnB,kBAAkB,GAClB,MAAM,+BAA+B,CAAC;AACvC,YAAY,EACX,wBAAwB,EACxB,mCAAmC,EACnC,kBAAkB,EAClB,MAAM,+BAA+B,CAAC;AACvC,YAAY,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACtE,YAAY,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAC5E,YAAY,EAAE,sBAAsB,EAAE,2BAA2B,EAAE,4BAA4B,EAAE,MAAM,0BAA0B,CAAC;AAClI,YAAY,EAAE,oBAAoB,EAAE,yBAAyB,EAAE,0BAA0B,EAAE,MAAM,wBAAwB,CAAC;AAC1H,YAAY,EAAE,qBAAqB,EAAE,0BAA0B,EAAE,2BAA2B,EAAE,MAAM,yBAAyB,CAAC;AAC9H,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACtF,YAAY,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAC1D,YAAY,EAAE,6BAA6B,EAAE,MAAM,6BAA6B,CAAC;AACjF,YAAY,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AAClH,OAAO,EACN,aAAa,EACb,mBAAmB,EACnB,yBAAyB,EACzB,mCAAmC,EACnC,kCAAkC,EAClC,oCAAoC,GACpC,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAEpG,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACtD,wBAAgB,cAAc,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,YAE9D;AAED,OAAO,EAAE,QAAQ,EAAE,MAAM,EAA8B,MAAM,iBAAiB,CAAC;AAC/E,wBAAgB,SAAS,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,QAG3D"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjE,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtC,OAAO,KAAK,YAAY,MAAM,+BAA+B,CAAC;AAC9D,OAAO,KAAK,YAAY,MAAM,+BAA+B,CAAC;AAE9D,YAAY,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAExD,YAAY,EACX,OAAO,EACP,YAAY,EACZ,SAAS,EACT,aAAa,EACb,uBAAuB,EACvB,gBAAgB,EAChB,eAAe,EACf,eAAe,EACf,iBAAiB,EACjB,iBAAiB,EACjB,kBAAkB,EAClB,kBAAkB,EAClB,iBAAiB,EACjB,kBAAkB,EAClB,eAAe,EACf,YAAY,EACZ,gBAAgB,EAChB,iBAAiB,EACjB,cAAc,EACd,iBAAiB,EACjB,WAAW,GACX,MAAM,+BAA+B,CAAC;AAEvC,YAAY,EACX,eAAe,EACf,cAAc,EACd,uBAAuB,EACvB,qBAAqB,EACrB,sBAAsB,EACtB,uBAAuB,EACvB,uBAAuB,EACvB,mBAAmB,EACnB,wBAAwB,EACxB,wBAAwB,EACxB,6BAA6B,EAC7B,cAAc,EACd,kBAAkB,EAClB,sBAAsB,EACtB,aAAa,EACb,uBAAuB,EACvB,mBAAmB,EACnB,kBAAkB,GAClB,MAAM,+BAA+B,CAAC;AACvC,YAAY,EACX,wBAAwB,EACxB,mCAAmC,EACnC,kBAAkB,EAClB,MAAM,+BAA+B,CAAC;AACvC,YAAY,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACtE,YAAY,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAC5E,YAAY,EAAE,sBAAsB,EAAE,2BAA2B,EAAE,4BAA4B,EAAE,MAAM,0BAA0B,CAAC;AAClI,YAAY,EAAE,yBAAyB,EAAE,8BAA8B,EAAE,+BAA+B,EAAE,MAAM,6BAA6B,CAAC;AAC9I,YAAY,EAAE,0BAA0B,EAAE,+BAA+B,EAAE,gCAAgC,EAAE,MAAM,8BAA8B,CAAC;AAClJ,YAAY,EAAE,yBAAyB,EAAE,8BAA8B,EAAE,+BAA+B,EAAE,MAAM,6BAA6B,CAAC;AAC9I,YAAY,EAAE,0BAA0B,EAAE,+BAA+B,EAAE,gCAAgC,EAAE,MAAM,8BAA8B,CAAC;AAClJ,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACtF,YAAY,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAC1D,YAAY,EAAE,6BAA6B,EAAE,MAAM,6BAA6B,CAAC;AACjF,YAAY,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AAClH,OAAO,EACN,aAAa,EACb,mBAAmB,EACnB,yBAAyB,EACzB,mCAAmC,EACnC,kCAAkC,EAClC,oCAAoC,GACpC,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAEpG,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACtD,wBAAgB,cAAc,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,YAE9D;AAED,OAAO,EAAE,QAAQ,EAAE,MAAM,EAA8B,MAAM,iBAAiB,CAAC;AAC/E,wBAAgB,SAAS,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,QAG3D"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@observertc/observer-js",
-  "version": "0.41.7",
+  "version": "0.42.0",
   "description": "Server Side NodeJS Library for processing ObserveRTC Samples",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",

package/src/ObservedCall.ts

@@ -1,13 +1,15 @@
 import { EventEmitter } from 'events';
 import { ObservedClient, ObservedClientEvents, ObservedClientModel } from './ObservedClient';
-import { ObservedOutboundTrack } from './ObservedOutboundTrack';
 import { Observer } from './Observer';
 import { createClientJoinedEventReport } from './common/callEventReports';
-import { PartialBy } from './common/utils';
+import { getMedian, PartialBy } from './common/utils';
 import { CallEventReport } from '@observertc/report-schemas-js';
 import { createProcessor } from './common/Middleware';
 import { ClientSample } from '@observertc/sample-schemas-js';
 import { ClientIssue } from './monitors/CallSummary';
+import { ObservedOutboundAudioTrack } from './ObservedOutboundAudioTrack';
+import { ObservedOutboundVideoTrack } from './ObservedOutboundVideoTrack';
+import { CalculatedScore } from './common/CalculatedScore';
 
 type ClientIssueDetectionConfig = Pick<ClientIssue, 'severity'>;
 
@@ -38,8 +40,13 @@ export class ObservedCall<AppData extends Record<string, unknown> = Record<strin
 
 	private readonly _clients = new Map<string, ObservedClient>();
 	
-	public readonly sfuStreamIdToOutboundAudioTrack = new Map<string | number, ObservedOutboundTrack<'audio'>>();
-	public readonly sfuStreamIdToOutboundVideoTrack = new Map<string | number, ObservedOutboundTrack<'video'>>();
+	public _scoreData?: {
+		score: CalculatedScore,
+		calculated: number,
+	};
+
+	public readonly sfuStreamIdToOutboundAudioTrack = new Map<string | number, ObservedOutboundAudioTrack>();
+	public readonly sfuStreamIdToOutboundVideoTrack = new Map<string | number, ObservedOutboundVideoTrack>();
 	private _closed = false;
 	private _updated = Date.now();
 	private _ended?: number;
@@ -84,6 +91,35 @@ export class ObservedCall<AppData extends Record<string, unknown> = Record<strin
 		return this._clients;
 	}
 
+	public get score(): CalculatedScore | undefined {
+		const now = Date.now();
+
+		if (now - 15000 < (this._scoreData?.calculated ?? 0)) {
+			return this._scoreData?.score;
+		} else if (this.clients.size < 1) {
+			return {
+				remarks: [ {
+					severity: 'none',
+					text: 'No clients',
+				} ],
+				score: 5.0,
+				timestamp: now,
+			};
+		}
+		const scores = [ ...this.clients.values() ].map((client) => client.score?.score ?? 5.0);
+
+		this._scoreData = {
+			score: {
+				remarks: [],
+				score: getMedian(scores),
+				timestamp: now,
+			},
+			calculated: now,
+		};
+
+		return this._scoreData.score;
+	}
+
 	public get closed() {
 		return this._closed;
 	}

package/src/ObservedClient.ts

@@ -11,6 +11,7 @@ import { CallEventType } from './common/CallEventType';
 import { ObservedSfu } from './ObservedSfu';
 import { ClientIssue } from './monitors/CallSummary';
 import { CallEventReport } from '@observertc/report-schemas-js';
+import { CalculatedScore } from './common/CalculatedScore';
 
 const logger = createLogger('ObservedClient');
 
@@ -59,6 +60,7 @@ export type ObservedClientEvents = {
 	rejoined: [{
 		lastJoined: number,
 	}],
+	score: [CalculatedScore],
 };
 
 export declare interface ObservedClient<AppData extends Record<string, unknown> = Record<string, unknown>> {
@@ -84,6 +86,7 @@ export class ObservedClient<AppData extends Record<string, unknown> = Record<str
 	private _timeZoneOffsetInHours?: number;
 	private _left?: number;
 	
+	public score?: CalculatedScore;
 	public usingTURN = false;
 	public availableOutgoingBitrate = 0;
 	public availableIncomingBitrate = 0;
@@ -238,7 +241,6 @@ export class ObservedClient<AppData extends Record<string, unknown> = Record<str
 		if (!this._left) {
 			this._addClientLeftReport();
 		}
-
 		Array.from(this._peerConnections.values()).forEach((peerConnection) => peerConnection.close());
 
 		this.emit('close');
@@ -302,8 +304,7 @@ export class ObservedClient<AppData extends Record<string, unknown> = Record<str
 			logger.warn(`Error adding client issue: ${(err as Error)?.message}`);
 		}
 
-		this.issues.push(issue);
-		this.emit('issue', issue);
+		this._addAndEmitIssue(issue);
 	}
 
 	public accept(sample: ClientSample): void {
@@ -515,9 +516,8 @@ export class ObservedClient<AppData extends Record<string, unknown> = Record<str
 							trackId: callEvent.mediaTrackId,
 							attachments: callEvent.attachments ? JSON.parse(callEvent.attachments) : undefined,
 						};
-	
-						this.issues.push(issue);
-						this.emit('issue', issue);
+
+						this._addAndEmitIssue(issue);
 					} catch (err) {
 						logger.warn(`Error parsing client issue: ${(err as Error)?.message}`);
 					}
@@ -619,7 +619,7 @@ export class ObservedClient<AppData extends Record<string, unknown> = Record<str
 					type: CallMetaType.MEDIA_DEVICE,
 					payload: mediaDevice,
 				}, this.userId);
-
+				
 			this.reports.addCallMetaReport(callMetaReport);
 			mediaDevice.label && this.mediaDevices.push(mediaDevice.label);
 		}
@@ -634,7 +634,7 @@ export class ObservedClient<AppData extends Record<string, unknown> = Record<str
 					type: CallMetaType.MEDIA_SOURCE,
 					payload: mediaSource,
 				}, this.userId);
-
+				
 			this.reports.addCallMetaReport(callMetaReport);
 		}
 
@@ -670,10 +670,17 @@ export class ObservedClient<AppData extends Record<string, unknown> = Record<str
 	
 				inboundAudioTrack.update(track, sample.timestamp);
 	
-				const remoteOutboundTrack = this.call.sfuStreamIdToOutboundAudioTrack.get(track.sfuStreamId ?? '');
-	
-				if (remoteOutboundTrack && inboundAudioTrack.sfuStreamId && !remoteOutboundTrack.remoteInboundTracks.has(inboundAudioTrack.sfuStreamId)) {
-					remoteOutboundTrack.connectInboundTrack(inboundAudioTrack);
+				if (!inboundAudioTrack.remoteOutboundTrack) {
+					const remoteOutboundTrack = this.call.sfuStreamIdToOutboundAudioTrack.get(inboundAudioTrack.sfuStreamId ?? '');
+
+					if (remoteOutboundTrack) {
+						inboundAudioTrack.remoteOutboundTrack = remoteOutboundTrack;
+						
+						inboundAudioTrack.once('close', () => {
+							remoteOutboundTrack?.remoteInboundTracks.delete(inboundAudioTrack.trackId ?? '');
+						});
+						remoteOutboundTrack.remoteInboundTracks.set(inboundAudioTrack.trackId ?? '', inboundAudioTrack);
+					}
 				}
 			} catch (err) {
 				logger.error(`Error creating inbound audio track: ${(err as Error)?.message}`);
@@ -705,11 +712,18 @@ export class ObservedClient<AppData extends Record<string, unknown> = Record<str
 				});
 	
 				inboundVideoTrack.update(track, sample.timestamp);
-					
-				const remoteOutboundTrack = this.call.sfuStreamIdToOutboundVideoTrack.get(inboundVideoTrack.sfuStreamId ?? '');
-	
-				if (remoteOutboundTrack && inboundVideoTrack.sfuStreamId && !remoteOutboundTrack.remoteInboundTracks.has(inboundVideoTrack.sfuStreamId)) {
-					remoteOutboundTrack.connectInboundTrack(inboundVideoTrack);
+
+				if (!inboundVideoTrack.remoteOutboundTrack) {
+					const remoteOutboundTrack = this.call.sfuStreamIdToOutboundVideoTrack.get(inboundVideoTrack.sfuStreamId ?? '');
+
+					if (remoteOutboundTrack) {
+						inboundVideoTrack.remoteOutboundTrack = remoteOutboundTrack;
+						
+						inboundVideoTrack.once('close', () => {
+							remoteOutboundTrack?.remoteInboundTracks.delete(inboundVideoTrack.trackId ?? '');
+						});
+						remoteOutboundTrack.remoteInboundTracks.set(inboundVideoTrack.trackId ?? '', inboundVideoTrack);
+					}
 				}
 			} catch (err) {
 				logger.error(`Error creating inbound video track: ${(err as Error)?.message}`);
@@ -734,6 +748,11 @@ export class ObservedClient<AppData extends Record<string, unknown> = Record<str
 				});
 
 				outboundAudioTrack.update(track, sample.timestamp);
+
+				if (outboundAudioTrack.sfuStreamId && !this.call.sfuStreamIdToOutboundAudioTrack.has(outboundAudioTrack.sfuStreamId)) {
+					this.call.sfuStreamIdToOutboundAudioTrack.set(outboundAudioTrack.sfuStreamId, outboundAudioTrack);
+				}
+
 			} catch (err) {
 				logger.error(`Error creating outbound audio track: ${(err as Error)?.message}`);
 			}
@@ -759,6 +778,10 @@ export class ObservedClient<AppData extends Record<string, unknown> = Record<str
 	
 				outboundVideoTrack.update(track, sample.timestamp);
 
+				if (outboundVideoTrack.sfuStreamId && !this.call.sfuStreamIdToOutboundVideoTrack.has(outboundVideoTrack.sfuStreamId)) {
+					this.call.sfuStreamIdToOutboundVideoTrack.set(outboundVideoTrack.sfuStreamId, outboundVideoTrack);
+				}
+
 			} catch (err) {
 				logger.error(`Error creating outbound video track: ${(err as Error)?.message}`);
 			}
@@ -897,6 +920,9 @@ export class ObservedClient<AppData extends Record<string, unknown> = Record<str
 		let sumRttInMs = 0;
 		let anyPeerConnectionUsingTurn = false;
 
+		let minPcScore = Number.MAX_SAFE_INTEGER;
+		let maxPcScore = Number.MIN_SAFE_INTEGER;
+
 		for (const peerConnection of this._peerConnections.values()) {
 			if (peerConnection.closed) continue;
 			peerConnection.updateMetrics();
@@ -916,8 +942,21 @@ export class ObservedClient<AppData extends Record<string, unknown> = Record<str
 			sumRttInMs += peerConnection.avgRttInMs ?? 0;
 
 			anyPeerConnectionUsingTurn ||= peerConnection.usingTURN;
+
+			minPcScore = Math.min(minPcScore, peerConnection.score?.score ?? Number.MAX_SAFE_INTEGER);
+			maxPcScore = Math.max(maxPcScore, peerConnection.score?.score ?? Number.MIN_SAFE_INTEGER);
 		}
 
+		this.score = {
+			score: minPcScore,
+			remarks: [ {
+				severity: 'none',
+				text: `Min and max score of all peer connections: ${minPcScore}, ${maxPcScore}`,
+			} ],
+			timestamp: sample.timestamp,
+		};
+		this.emit('score', this.score);
+
 		this.usingTURN = anyPeerConnectionUsingTurn === true;
 		
 		if (wasUsingTURN !== this.usingTURN) this.emit('usingturn', this.usingTURN);
@@ -951,6 +990,27 @@ export class ObservedClient<AppData extends Record<string, unknown> = Record<str
 		});
 	}
 
+	private _addAndEmitIssue(issue: ClientIssue) {
+		this.issues.push(issue);
+
+		if (issue.peerConnectionId) {
+			const peerConnection = this._peerConnections.get(issue.peerConnectionId);
+
+			if (peerConnection) {
+				
+				if (issue.trackId) {
+					const track = peerConnection.inboundAudioTracks.get(issue.trackId) ?? peerConnection.inboundVideoTracks.get(issue.trackId);
+
+					if (track) track.ωpendingIssuesForScores.push(issue);
+				} else {
+					peerConnection.ωpendingIssuesForScores.push(issue);
+				}
+			}
+		}
+		
+		this.emit('issue', issue);
+	}
+
 	private _createPeerConnection(peerConnectionId: string, label?: string): ObservedPeerConnection {
 		const result = new ObservedPeerConnection({
 			peerConnectionId,

package/src/ObservedInboundAudioTrack.ts

@@ -0,0 +1,336 @@
+import { EventEmitter } from 'events';
+import { ObservedPeerConnection } from './ObservedPeerConnection';
+import { InboundAudioTrack } from '@observertc/sample-schemas-js';
+import { InboundAudioTrackReport, InboundVideoTrackReport } from '@observertc/report-schemas-js';
+import { calculateBaseAudioScore, CalculatedScore } from './common/CalculatedScore';
+import { ClientIssue } from './monitors/CallSummary';
+import { ObservedOutboundAudioTrack } from './ObservedOutboundAudioTrack';
+
+export type ObservedInboundAudioTrackModel = {
+	trackId: string;
+	sfuStreamId?: string;
+	sfuSinkId?: string;
+}
+
+export type ObservedInboundAudioTrackEvents = {
+	update: [{
+		elapsedTimeInMs: number;
+	}],
+	score: [CalculatedScore],
+	close: [],
+	remoteoutboundtrack: [ObservedOutboundAudioTrack | undefined],
+};
+
+export type ObservedInboundAudioTrackStats = InboundAudioTrack & {
+	ssrc: number;
+	bitrate: number;
+	fractionLost: number;
+	rttInMs?: number;
+	deltaReceivedBytes?: number;
+	deltaLostPackets?: number;
+	deltaReceivedPackets?: number;
+	deltaReceivedFrames?: number;
+	deltaDecodedFrames?: number;
+	deltaDroppedFrames?: number;
+	deltaReceivedSamples?: number;
+	deltaSilentConcealedSamples?: number;
+	fractionLoss?: number;
+	statsTimestamp: number;
+};
+
+// {
+// 	[Property in keyof ObservedInboundAudioTrackStats<K>]: ObservedInboundAudioTrackStats<K>[Property];
+// }
+
+export declare interface ObservedInboundAudioTrack {
+	on<U extends keyof ObservedInboundAudioTrackEvents>(event: U, listener: (...args: ObservedInboundAudioTrackEvents[U]) => void): this;
+	off<U extends keyof ObservedInboundAudioTrackEvents>(event: U, listener: (...args: ObservedInboundAudioTrackEvents[U]) => void): this;
+	once<U extends keyof ObservedInboundAudioTrackEvents>(event: U, listener: (...args: ObservedInboundAudioTrackEvents[U]) => void): this;
+	emit<U extends keyof ObservedInboundAudioTrackEvents>(event: U, ...args: ObservedInboundAudioTrackEvents[U]): boolean;
+	update(sample: InboundAudioTrack, timestamp: number): void;
+}
+
+export class ObservedInboundAudioTrack extends EventEmitter	{
+	public readonly created = Date.now();
+	public visited = false;
+
+	private readonly _stats = new Map<number, ObservedInboundAudioTrackStats>();
+	
+	private _closed = false;
+	private _updated = Date.now();
+	private _remoteOutboundTrack?: ObservedOutboundAudioTrack;
+	private _lastMaxStatsTimestamp = 0;
+
+	public bitrate = 0;
+	public rttInMs?: number;
+	public jitter?: number;
+	public fractionLoss = 0;
+	public marker?: string;
+
+	public totalLostPackets = 0;
+	public totalReceivedPackets = 0;
+	public totalBytesReceived = 0;
+	public totalReceivedSamples = 0;
+	public totalSilentConcealedSamples = 0;
+	
+	public deltaLostPackets = 0;
+	public deltaReceivedPackets = 0;
+	public deltaBytesReceived = 0;
+	public deltaReceivedSamples = 0;
+	public deltaSilentConcealedSamples = 0;
+	
+	public score?: CalculatedScore;
+	public ωpendingIssuesForScores: ClientIssue[] = [];
+
+	public constructor(
+		private readonly _model: ObservedInboundAudioTrackModel,
+		public readonly peerConnection: ObservedPeerConnection,
+	) {
+		super();
+		this.setMaxListeners(Infinity);
+	}
+
+	public get serviceId() {
+		return this.peerConnection.serviceId;
+	}
+
+	public get roomId() {
+		return this.peerConnection.roomId;
+	}
+
+	public get callId() {
+		return this.peerConnection.callId;
+	}
+
+	public get clientId() {
+		return this.peerConnection.clientId;
+	}
+
+	public get mediaUnitId() {
+		return this.peerConnection.mediaUnitId;
+	}
+
+	public get peerConnectionId() {
+		return this.peerConnection.peerConnectionId;
+	}
+
+	public get trackId() {
+		return this._model.trackId;
+	}
+
+	public get sfuStreamId() {
+		return this._model.sfuStreamId;
+	}
+
+	public get sfuSinkId() {
+		return this._model.sfuSinkId;
+	}
+
+	public get updated() {
+		return this._updated;
+	}
+
+	public get statsTimestamp() {
+		return this._lastMaxStatsTimestamp;
+	}
+
+	public get stats(): ReadonlyMap<number, ObservedInboundAudioTrackStats> {
+		return this._stats;
+	}
+
+	public get reports() {
+		return this.peerConnection.reports;
+	}
+
+	public set remoteOutboundTrack(track: ObservedOutboundAudioTrack | undefined) {
+		if (this._closed) return;
+		if (this._remoteOutboundTrack) return;
+		if (!track) return;
+
+		track.once('close', () => {
+			this._remoteOutboundTrack = undefined;
+			this.emit('remoteoutboundtrack', undefined);
+		});
+		this._remoteOutboundTrack = track;
+		this.emit('remoteoutboundtrack', track);
+	}
+
+	public get remoteOutboundTrack() {
+		return this._remoteOutboundTrack;
+	}
+
+	public get closed() {
+		return this._closed;
+	}
+
+	public close() {
+		if (this._closed) return;
+
+		this._closed = true;
+
+		this.emit('close');
+	}
+
+	public update(sample: InboundAudioTrack, statsTimestamp: number) {
+		if (this._closed) return;
+		
+		const now = Date.now();
+		const report: InboundAudioTrackReport | InboundVideoTrackReport = {
+			serviceId: this.peerConnection.client.call.serviceId,
+			roomId: this.peerConnection.client.call.roomId,
+			callId: this.peerConnection.client.call.callId,
+			clientId: this.peerConnection.client.clientId,
+			userId: this.peerConnection.client.userId,
+			mediaUnitId: this.peerConnection.client.mediaUnitId,
+			peerConnectionId: this.peerConnection.peerConnectionId,
+			...sample,
+			timestamp: statsTimestamp,
+			sampleSeq: -1,
+
+			remoteClientId: sample.remoteClientId ?? this.remoteOutboundTrack?.peerConnection.client.clientId,
+			remoteUserId: this.remoteOutboundTrack?.peerConnection.client.userId,
+			remoteTrackId: this.remoteOutboundTrack?.trackId,
+			remotePeerConnectionId: this.remoteOutboundTrack?.peerConnection.peerConnectionId,
+			marker: this.marker,
+		};
+
+		this.reports.addInboundAudioTrackReport(report);
+		
+		if (!this._model.sfuStreamId && sample.sfuStreamId) {
+			this._model.sfuStreamId = sample.sfuStreamId;
+		}
+
+		if (!this._model.sfuSinkId && sample.sfuSinkId) {
+			this._model.sfuSinkId = sample.sfuSinkId;
+		}
+
+		const elapsedTimeInMs = Math.max(1, now - this._updated);
+		const lastStat = this._stats.get(sample.ssrc);
+		const rttInMs = sample.roundTripTime ? sample.roundTripTime * 1000 : undefined;
+		let bitrate = 0;
+		let deltaReceivedBytes = 0;
+		let fractionLost = 0;
+		let deltaLostPackets = 0;
+		let deltaReceivedPackets = 0;
+		
+		if (lastStat?.bytesReceived && sample.bytesReceived && lastStat.bytesReceived < sample.bytesReceived) {
+			deltaReceivedBytes = sample.bytesReceived - lastStat.bytesReceived;
+			bitrate = deltaReceivedBytes / (elapsedTimeInMs / 1000);
+		}
+		if (lastStat?.packetsReceived && sample?.packetsReceived && lastStat.packetsReceived < sample.packetsReceived) {
+			deltaReceivedPackets = sample.packetsReceived - lastStat.packetsReceived;
+		}
+		if (lastStat?.packetsLost && sample.packetsLost && lastStat.packetsLost < sample.packetsLost) {
+			deltaLostPackets = sample.packetsLost - lastStat.packetsLost;
+			if (0 < deltaReceivedPackets) {
+				fractionLost = deltaLostPackets / (deltaReceivedPackets + deltaLostPackets);
+			}
+		}
+		
+		let deltaDecodedFrames: number | undefined;
+		let deltaDroppedFrames: number | undefined;
+		let deltaReceivedFrames: number | undefined;
+		let deltaSilentConcealedSamples: number | undefined;
+		const audioSample = sample as InboundAudioTrack;
+		const lastAudioStat = lastStat as InboundAudioTrack | undefined;
+			
+		if (audioSample.silentConcealedSamples && lastAudioStat?.silentConcealedSamples && lastAudioStat.silentConcealedSamples < audioSample.silentConcealedSamples) {
+			deltaSilentConcealedSamples = audioSample.silentConcealedSamples - lastAudioStat.silentConcealedSamples;
+		}
+
+		const stats: ObservedInboundAudioTrackStats = {
+			...sample,
+			fractionLost,
+			rttInMs,
+			bitrate,
+			ssrc: sample.ssrc,
+			deltaReceivedBytes,
+			deltaLostPackets,
+			deltaReceivedPackets,
+			deltaReceivedFrames,
+			deltaDecodedFrames,
+			deltaDroppedFrames,
+			deltaSilentConcealedSamples,
+			statsTimestamp,
+		};
+
+		this._stats.set(sample.ssrc, stats);
+
+		this.visited = true;
+		this._updated = now;
+		
+		this.emit('update', {
+			elapsedTimeInMs,
+		});
+	}
+
+	public updateMetrics() {
+		let maxStatsTimestamp = 0;
+		let rttInMsSum = 0;
+		let jitterSum = 0;
+		let size = 0;
+
+		this.bitrate = 0;
+		this.rttInMs = undefined;
+		this.deltaBytesReceived = 0;
+		this.deltaLostPackets = 0;
+		this.deltaReceivedSamples = 0;
+		this.deltaSilentConcealedSamples = 0;
+		this.fractionLoss = 0;
+
+		for (const [ , stats ] of this._stats) {
+			if (stats.statsTimestamp <= this._lastMaxStatsTimestamp) continue;
+
+			this.deltaBytesReceived += stats.deltaReceivedBytes ?? 0;
+			this.deltaLostPackets += stats.deltaLostPackets ?? 0;
+			this.deltaReceivedPackets += stats.deltaReceivedFrames ?? 0;
+			this.deltaReceivedSamples += stats.deltaReceivedSamples ?? 0;
+			this.deltaSilentConcealedSamples += stats.deltaSilentConcealedSamples ?? 0;
+			this.bitrate += stats.bitrate;
+
+			maxStatsTimestamp = Math.max(maxStatsTimestamp, stats.statsTimestamp);
+			
+			rttInMsSum += stats.rttInMs ?? 0;
+			jitterSum += stats.jitter ?? 0;
+			++size;
+		}
+
+		this.totalBytesReceived += this.deltaBytesReceived;
+		this.totalLostPackets += this.deltaLostPackets;
+		this.totalReceivedPackets += this.deltaReceivedPackets;
+		this.totalReceivedSamples += this.deltaReceivedSamples;
+		this.totalSilentConcealedSamples += this.deltaSilentConcealedSamples;
+
+		this.rttInMs = rttInMsSum / Math.max(size, 1);
+		this.jitter = jitterSum / Math.max(size, 1);
+		this.fractionLoss = 0 < this.deltaReceivedPackets && 0 < this.deltaLostPackets ? (this.deltaLostPackets / (this.deltaReceivedPackets + this.deltaLostPackets)) : 0;
+
+		this._lastMaxStatsTimestamp = maxStatsTimestamp;
+
+		this._updateQualityScore(maxStatsTimestamp);
+	}
+
+	private _updateQualityScore(timestamp: number) {
+		const newIssues = this.ωpendingIssuesForScores;
+		const score = calculateBaseAudioScore(this, newIssues);
+
+		if (0 < newIssues.length) {
+			this.ωpendingIssuesForScores = [];
+		}
+
+		if (!score) return (this.score = undefined);
+
+		if (0.05 < this.fractionLoss) {
+			score.score *= 0.5;
+			score.remarks.push({
+				severity: 'major',
+				text: 'Fraction loss is too high',
+			});
+		}
+
+		score.timestamp = timestamp;
+		this.score = score;
+
+		this.emit('score', this.score);
+	}
+}