@observertc/observer-js 0.42.1 → 0.42.3

package/src/ObservedInboundVideoTrack.ts

@@ -5,6 +5,7 @@ import { InboundAudioTrackReport, InboundVideoTrackReport } from '@observertc/re
 import { CalculatedScore, calculateBaseVideoScore } from './common/CalculatedScore';
 import { ClientIssue } from './monitors/CallSummary';
 import { ObservedOutboundVideoTrack } from './ObservedOutboundVideoTrack';
+import { SupportedVideoCodecType } from './common/types';
 
 export type ObservedInboundVideoTrackModel = {
 	trackId: string;
@@ -54,8 +55,13 @@ export class ObservedInboundVideoTrack extends EventEmitter	{
 	public readonly created = Date.now();
 	public visited = false;
 
+	// timestamp of the MEDIA_TRACK_ADDED event
+	public added?: number;
+	// timestamp of the MEDIA_TRACK_REMOVED event
+	public removed?: number;
+
 	public contentType: 'lowmotion' | 'standard' | 'highmotion' = 'standard';
-	public codec: 'vp8' | 'vp9' | 'h264' = 'vp8';
+	public codec?: SupportedVideoCodecType;
 
 	private readonly _stats = new Map<number, ObservedInboundVideoTrackStats>();
 	
@@ -267,6 +273,9 @@ export class ObservedInboundVideoTrack extends EventEmitter	{
 		this._stats.set(sample.ssrc, stats);
 
 		this.visited = true;
+		// a peer connection is active if it has at least one active track
+		this.peerConnection.visited = true;
+		
 		this._updated = now;
 		this.emit('update', {
 			elapsedTimeInMs,

package/src/ObservedOutboundAudioTrack.ts

@@ -50,6 +50,11 @@ export class ObservedOutboundAudioTrack extends EventEmitter	{
 	public readonly created = Date.now();
 	public visited = false;
 
+	// timestamp of the MEDIA_TRACK_ADDED event
+	public added?: number;
+	// timestamp of the MEDIA_TRACK_REMOVED event
+	public removed?: number;
+
 	public bitrate = 0;
 	public rttInMs?: number;
 	public jitter?: number;
@@ -222,23 +227,10 @@ export class ObservedOutboundAudioTrack extends EventEmitter	{
 
 		this._stats.set(sample.ssrc, stats);
 
-		// this.bitrate = [ ...this._stats.values() ].reduce((acc, stat) => acc + stat.bitrate, 0);
-		// this.rttInMs = [ ...this._stats.values() ].reduce((acc, stat) => acc + (stat.rttInMs ?? 0), 0) / (this._stats.size || 1);
-
-		// this.totalLostPackets = [ ...this._stats.values() ].reduce((acc, stat) => acc + (stat.packetsLost ?? 0), 0);
-		// this.totalSentPackets = [ ...this._stats.values() ].reduce((acc, stat) => acc + (stat.packetsSent ?? 0), 0);
-		// this.totalSentBytes = [ ...this._stats.values() ].reduce((acc, stat) => acc + (stat.bytesSent ?? 0), 0);
-		// this.totalSentFrames = [ ...this._stats.values() ].reduce((acc, stat) => acc + (stat.deltaSentPackets ?? 0), 0);
-
-		// this.deltaEncodedFrames = [ ...this._stats.values() ].reduce((acc, stat) => acc + (stat.deltaEncodedFrames ?? 0), 0);
-		// this.deltaSentFrames = [ ...this._stats.values() ].reduce((acc, stat) => acc + (stat.deltaSentFrames ?? 0), 0);
-		// this.deltaLostPackets = [ ...this._stats.values() ].reduce((acc, stat) => acc + stat.deltaLostPackets, 0);
-		// this.deltaSentPackets = [ ...this._stats.values() ].reduce((acc, stat) => acc + stat.deltaSentPackets, 0);
-		// this.deltaSentBytes = [ ...this._stats.values() ].reduce((acc, stat) => acc + stat.deltaSentBytes, 0);
-
-		// setting up sfu connection as it is not always available at the first sample
-
 		this.visited = true;
+		// a peer connection is active if it has at least one active track
+		this.peerConnection.visited = true;
+		
 		this._updated = now;
 		this.emit('update', {
 			elapsedTimeInMs,

package/src/ObservedOutboundVideoTrack.ts

@@ -5,6 +5,7 @@ import { OutboundAudioTrackReport, OutboundVideoTrackReport } from '@observertc/
 import { ObservedInboundVideoTrack } from './ObservedInboundVideoTrack';
 import { calculateBaseVideoScore, CalculatedScore } from './common/CalculatedScore';
 import { ClientIssue } from './monitors/CallSummary';
+import { SupportedVideoCodecType } from './common/types';
 
 export type ObservedOutboundVideoTrackModel = {
 	trackId: string;
@@ -50,8 +51,13 @@ export class ObservedOutboundVideoTrack extends EventEmitter	{
 	public readonly created = Date.now();
 	public visited = false;
 
+	// timestamp of the MEDIA_TRACK_ADDED event
+	public added?: number;
+	// timestamp of the MEDIA_TRACK_REMOVED event
+	public removed?: number;
+
 	public contentType: 'lowmotion' | 'standard' | 'highmotion' = 'standard';
-	public codec: 'vp8' | 'vp9' | 'h264' = 'vp8';
+	public codec?: SupportedVideoCodecType;
 	public highestLayer?: ObservedOutboundVideoTrackStats;
 
 	public bitrate = 0;
@@ -241,6 +247,9 @@ export class ObservedOutboundVideoTrack extends EventEmitter	{
 		// setting up sfu connection as it is not always available at the first sample
 
 		this.visited = true;
+		// a peer connection is active if it has at least one active track
+		this.peerConnection.visited = true;
+
 		this._updated = now;
 		this.emit('update', {
 			elapsedTimeInMs,

package/src/ObservedPeerConnection.ts

@@ -42,7 +42,12 @@ export declare interface ObservedPeerConnection {
 export class ObservedPeerConnection extends EventEmitter {
 	public readonly created = Date.now();
 	public visited = true;
-	
+
+	// timestamp of the PEER_CONNECTION_OPENED event
+	public opened?: number;
+	// timestamp of the PEER_CONNECTION_CLOSED event
+	public closedTimestamp?: number;
+
 	private _elapsedTimeSinceLastUpdate?: number;
 	private _statsTimestamp?: number;
 	

package/src/Observer.ts

@@ -104,7 +104,7 @@ export class Observer extends EventEmitter {
 	}
 
 	public createObservedCall<T extends Record<string, unknown> = Record<string, unknown>>(
-		config: PartialBy<ObservedCallModel, 'serviceId'> & { appData: T, started?: number, reportCallStarted?: boolean, reportCallEnded?: boolean, ended?: number }
+		config: PartialBy<ObservedCallModel, 'serviceId'> & { appData: T, reportCallStarted?: boolean, reportCallEnded?: boolean }
 	): ObservedCall<T> {
 		if (this._closed) {
 			throw new Error('Attempted to create a call source on a closed observer');
@@ -112,8 +112,6 @@ export class Observer extends EventEmitter {
 
 		const { 
 			appData, 
-			started = Date.now(), 
-			ended,
 			reportCallEnded = true,
 			reportCallStarted = true,
 			...model 
@@ -132,7 +130,7 @@ export class Observer extends EventEmitter {
 				call.serviceId,
 				call.roomId,
 				call.callId,
-				ended ?? Date.now(),
+				call.ended ?? Date.now(),
 			));
 		});
 
@@ -141,7 +139,7 @@ export class Observer extends EventEmitter {
 			call.serviceId,
 			call.roomId,
 			call.callId,
-			started,
+			call.started ?? Date.now(),
 		));
 
 		this.emit('newcall', call);

package/src/common/CalculatedScore.ts

@@ -82,7 +82,7 @@ export function calculateBaseVideoScore(track: ObservedInboundVideoTrack | Obser
 	
 	const bpp = bitrate / (frameHeight * frameWidth * framesPerSecond);
 	// let's assume vp8 for now
-	const bppRange = BPP_RANGES[track.contentType][track.codec];
+	const bppRange = BPP_RANGES[track.contentType][track.codec ?? 'vp8'];
 
 	if (bpp / 2 < bppRange.low) {
 		score.score = 1.0;

package/src/common/types.ts

@@ -20,6 +20,7 @@ import {
 } from '@observertc/report-schemas-js';
 
 export type MediaKind = 'audio' | 'video';
+export type SupportedVideoCodecType = 'vp8' | 'vp9' | 'h264' | 'h265';
 
 // export type EvaluatorMiddleware = Middleware<EvaluatorContext>;
 

package/src/index.ts

@@ -29,6 +29,7 @@ export type {
 	SfuSctpChannel,
 	SfuExtensionStats,
 	DataChannel,
+	MediaDevice,
 } from '@observertc/sample-schemas-js';
 
 export type {

package/lib/monitors/ClientQualityMonitor.d.ts

@@ -1 +0,0 @@
-//# sourceMappingURL=ClientQualityMonitor.d.ts.map

package/lib/monitors/ClientQualityMonitor.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"ClientQualityMonitor.d.ts","sourceRoot":"","sources":["../../src/monitors/ClientQualityMonitor.ts"],"names":[],"mappings":""}

package/lib/monitors/ClientQualityMonitor.js

@@ -1 +0,0 @@
-"use strict";