@observertc/observer-js 1.0.1-c3edea3.0 → 1.0.1-ec27289.0

package/lib/ObservedCall.d.ts

@@ -6,12 +6,13 @@ import { ScoreCalculator } from './scores/ScoreCalculator';
 import { CalculatedScore } from './scores/CalculatedScore';
 import { Detectors } from './detectors/Detectors';
 import { RemoteTrackResolver } from './utils/RemoteTrackResolver';
-import { CallUpdater } from './utils/CallUpdater';
+import { Updater } from './updaters/Updater';
 export type ObservedCallSettings<AppData extends Record<string, unknown> = Record<string, unknown>> = {
     callId: string;
     appData?: AppData;
     remoteTrackResolvePolicy?: 'p2p' | 'mediasoup-sfu';
-    callUpdaterPolicy?: 'onAnyClientUpdate' | 'onAllClientsUpdate';
+    updatePolicy?: 'update-on-any-client-updated' | 'update-when-all-client-updated' | 'update-on-interval';
+    updateIntervalInMs?: number;
 };
 export type ObservedCallEvents = {
     update: [];
@@ -29,21 +30,54 @@ export declare interface ObservedCall {
 export declare class ObservedCall<AppData extends Record<string, unknown> = Record<string, unknown>> extends EventEmitter {
     readonly observer: Observer;
     readonly detectors: Detectors;
+    updater?: Updater;
+    scoreCalculator: ScoreCalculator;
     readonly callId: string;
     readonly observedClients: Map<string, ObservedClient<Record<string, unknown>>>;
+    readonly clientsUsedTurn: Set<string>;
     readonly calculatedScore: CalculatedScore;
     remoteTrackResolver?: RemoteTrackResolver;
-    callUpdater?: CallUpdater;
-    appData?: AppData;
+    totalAddedClients: number;
+    totalRemovedClients: number;
+    totalClientsReceivedAudioBytes: number;
+    totalClientsReceivedVideoBytes: number;
+    totalClientsReceivedDataChannelBytes: number;
+    totalClientsReceivedBytes: number;
+    totalClientsSentAudioBytes: number;
+    totalClientsSentDataChannelBytes: number;
+    totalClientsSentVideoBytes: number;
+    totalClientsSentBytes: number;
+    totalRttLt50Measurements: number;
+    totalRttLt150Measurements: number;
+    totalRttLt300Measurements: number;
+    totalRttGtOrEq300Measurements: number;
+    numberOfIssues: number;
+    numberOfPeerConnections: number;
+    numberOfInboundRtpStreams: number;
+    numberOfOutboundRtpStreams: number;
+    numberOfDataChannels: number;
+    maxNumberOfClients: number;
+    deltaNumberOfIssues: number;
+    deltaRttLt50Measurements: number;
+    deltaRttLt150Measurements: number;
+    deltaRttLt300Measurements: number;
+    deltaRttGtOrEq300Measurements: number;
+    appData: AppData;
     closed: boolean;
-    started?: number;
-    ended?: number;
-    scoreCalculator: ScoreCalculator;
+    startedAt?: number;
+    endedAt?: number;
+    closedAt?: number;
+    private _callStartedEvent;
+    private _callEndedEvent;
     constructor(settings: ObservedCallSettings<AppData>, observer: Observer);
+    get numberOfClients(): number;
     get score(): number | undefined;
     close(): void;
     getObservedClient<ClientAppData extends Record<string, unknown> = Record<string, unknown>>(clientId: string): ObservedClient<ClientAppData> | undefined;
     createObservedClient<ClientAppData extends Record<string, unknown> = Record<string, unknown>>(settings: ObservedClientSettings<ClientAppData>): ObservedClient<ClientAppData>;
     update(): void;
+    private _onClientUpdate;
+    private _clientJoined;
+    private _clientLeft;
 }
 //# sourceMappingURL=ObservedCall.d.ts.map

package/lib/ObservedCall.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ObservedCall.d.ts","sourceRoot":"","sources":["../src/ObservedCall.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"ObservedCall.d.ts","sourceRoot":"","sources":["../src/ObservedCall.ts"],"names":[],"mappings":"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"}

package/lib/ObservedCall.js

@@ -5,44 +5,94 @@ const events_1 = require("events");
 const ObservedClient_1 = require("./ObservedClient");
 const DefaultCallScoreCalculator_1 = require("./scores/DefaultCallScoreCalculator");
 const Detectors_1 = require("./detectors/Detectors");
-const OnAllClientCallUpdater_1 = require("./utils/OnAllClientCallUpdater");
-const onAnyClientCallUpdater_1 = require("./utils/onAnyClientCallUpdater");
+const OnAllClientCallUpdater_1 = require("./updaters/OnAllClientCallUpdater");
+const OnIntervalUpdater_1 = require("./updaters/OnIntervalUpdater");
+const OnAnyClientCallUpdater_1 = require("./updaters/OnAnyClientCallUpdater");
 class ObservedCall extends events_1.EventEmitter {
     observer;
     detectors;
+    updater;
+    scoreCalculator;
     callId;
     observedClients = new Map();
+    clientsUsedTurn = new Set();
     calculatedScore = {
         weight: 1,
         value: undefined,
     };
     remoteTrackResolver;
-    callUpdater;
+    totalAddedClients = 0;
+    totalRemovedClients = 0;
+    totalClientsReceivedAudioBytes = 0;
+    totalClientsReceivedVideoBytes = 0;
+    totalClientsReceivedDataChannelBytes = 0;
+    totalClientsReceivedBytes = 0;
+    totalClientsSentAudioBytes = 0;
+    totalClientsSentDataChannelBytes = 0;
+    totalClientsSentVideoBytes = 0;
+    totalClientsSentBytes = 0;
+    totalRttLt50Measurements = 0;
+    totalRttLt150Measurements = 0;
+    totalRttLt300Measurements = 0;
+    totalRttGtOrEq300Measurements = 0;
+    numberOfIssues = 0;
+    numberOfPeerConnections = 0;
+    numberOfInboundRtpStreams = 0;
+    numberOfOutboundRtpStreams = 0;
+    numberOfDataChannels = 0;
+    maxNumberOfClients = 0;
+    deltaNumberOfIssues = 0;
+    deltaRttLt50Measurements = 0;
+    deltaRttLt150Measurements = 0;
+    deltaRttLt300Measurements = 0;
+    deltaRttGtOrEq300Measurements = 0;
     appData;
     closed = false;
-    started;
-    ended;
-    scoreCalculator;
+    startedAt;
+    endedAt;
+    closedAt;
+    _callStartedEvent;
+    _callEndedEvent;
     constructor(settings, observer) {
         super();
         this.observer = observer;
         this.setMaxListeners(Infinity);
         this.callId = settings.callId;
-        this.appData = settings.appData;
+        this.appData = settings.appData ?? {};
         this.scoreCalculator = new DefaultCallScoreCalculator_1.DefaultCallScoreCalculator(this);
         this.detectors = new Detectors_1.Detectors();
-        switch (settings.callUpdaterPolicy) {
-            case 'onAllClientsUpdate':
-                this.callUpdater = new OnAllClientCallUpdater_1.OnAllClientCallUpdater(this);
+        if (settings.updateIntervalInMs) {
+            if (settings.updatePolicy !== 'update-on-interval') {
+                throw new Error('updatePolicy must be update-on-interval if updateIntervalInMs is set in config');
+            }
+        }
+        switch (settings.updatePolicy) {
+            case 'update-on-any-client-updated':
+                this.updater = new OnAllClientCallUpdater_1.OnAllClientCallUpdater(this);
                 break;
-            case 'onAnyClientUpdate':
-                this.callUpdater = new onAnyClientCallUpdater_1.OnAnyClientCallUpdater(this);
+            case 'update-when-all-client-updated':
+                this.updater = new OnAnyClientCallUpdater_1.OnAnyClientCallUpdater(this);
+                break;
+            case 'update-on-interval':
+                if (!settings.updateIntervalInMs) {
+                    throw new Error('updateIntervalInMs setting in config must be set if updatePolicy is update-on-interval');
+                }
+                this.updater = new OnIntervalUpdater_1.OnIntervalUpdater(settings.updateIntervalInMs, this.update.bind(this));
                 break;
         }
         switch (settings.remoteTrackResolvePolicy) {
             case 'mediasoup-sfu':
                 break;
         }
+        this._callStartedEvent = {
+            emitted: false,
+        };
+        this._callEndedEvent = {
+            emitted: false,
+        };
+    }
+    get numberOfClients() {
+        return this.observedClients.size;
     }
     get score() {
         return this.calculatedScore.value;
@@ -50,8 +100,11 @@ class ObservedCall extends events_1.EventEmitter {
     close() {
         if (this.closed)
             return;
+        this.update(); // last update before closing
         this.closed = true;
+        this.updater?.close();
         [...this.observedClients.values()].forEach((client) => client.close());
+        this.closedAt = Date.now();
         this.emit('close');
     }
     getObservedClient(clientId) {
@@ -66,16 +119,25 @@ class ObservedCall extends events_1.EventEmitter {
             throw new Error(`Client with id ${settings.clientId} already exists`);
         const result = new ObservedClient_1.ObservedClient(settings, this);
         const wasEmpty = this.observedClients.size === 0;
-        const onUpdate = () => this.callUpdater?.onClientUpdate(result);
+        const onUpdate = () => this._onClientUpdate(result);
+        const joined = () => this._clientJoined(result);
+        const left = () => this._clientLeft(result);
         result.once('close', () => {
             result.off('update', onUpdate);
+            result.off('joined', joined);
+            result.off('left', left);
             this.observedClients.delete(settings.clientId);
             if (this.observedClients.size === 0) {
                 this.emit('empty');
             }
+            ++this.totalRemovedClients;
         });
         result.on('update', onUpdate);
+        result.on('joined', joined);
+        result.on('left', left);
+        ++this.totalAddedClients;
         this.observedClients.set(settings.clientId, result);
+        this.maxNumberOfClients = Math.max(this.maxNumberOfClients, this.observedClients.size);
         this.emit('newclient', result);
         if (wasEmpty) {
             this.emit('not-empty');
@@ -83,9 +145,59 @@ class ObservedCall extends events_1.EventEmitter {
         return result;
     }
     update() {
+        if (this.closed)
+            return;
+        this.numberOfInboundRtpStreams = 0;
+        this.numberOfOutboundRtpStreams = 0;
+        this.numberOfPeerConnections = 0;
+        this.numberOfDataChannels = 0;
+        for (const client of this.observedClients.values()) {
+            this.numberOfInboundRtpStreams += client.numberOfInboundRtpStreams;
+            this.numberOfOutboundRtpStreams += client.numberOfOutboundRtpStreams;
+            this.numberOfPeerConnections += client.numberOfPeerConnections;
+            this.numberOfDataChannels += client.numberOfDataChannels;
+        }
         this.detectors.update();
         this.scoreCalculator.update();
         this.emit('update');
+        this.deltaNumberOfIssues = 0;
+        this.deltaRttLt50Measurements = 0;
+        this.deltaRttLt150Measurements = 0;
+        this.deltaRttLt300Measurements = 0;
+        this.deltaRttGtOrEq300Measurements = 0;
+    }
+    _onClientUpdate(client) {
+        this.totalClientsReceivedAudioBytes += client.deltaReceivedAudioBytes;
+        this.totalClientsReceivedVideoBytes += client.deltaReceivedVideoBytes;
+        this.totalClientsReceivedDataChannelBytes += client.deltaDataChannelBytesReceived;
+        this.totalClientsReceivedBytes += client.deltaTransportReceivedBytes;
+        this.totalClientsSentAudioBytes += client.deltaSentAudioBytes;
+        this.totalClientsSentVideoBytes += client.deltaSentVideoBytes;
+        this.totalClientsSentDataChannelBytes += client.deltaDataChannelBytesSent;
+        this.totalClientsSentBytes += client.deltaTransportSentBytes;
+        this.deltaRttLt50Measurements += client.deltaRttLt50Measurements;
+        this.deltaRttLt150Measurements += client.deltaRttLt150Measurements;
+        this.deltaRttLt300Measurements += client.deltaRttLt300Measurements;
+        this.deltaRttGtOrEq300Measurements += client.deltaRttGtOrEq300Measurements;
+        this.totalRttLt50Measurements += client.deltaRttLt50Measurements;
+        this.totalRttLt150Measurements += client.deltaRttLt150Measurements;
+        this.totalRttLt300Measurements += client.deltaRttLt300Measurements;
+        this.totalRttGtOrEq300Measurements += client.deltaRttGtOrEq300Measurements;
+        this.deltaNumberOfIssues += client.deltaNumberOfIssues;
+        this.numberOfIssues += client.deltaNumberOfIssues;
+        if (client.usingTURN) {
+            this.clientsUsedTurn.add(client.clientId);
+        }
+    }
+    _clientJoined(client) {
+        if (!client.joinedAt)
+            return;
+        this.startedAt = Math.min(this.startedAt ?? client.joinedAt, client.joinedAt);
+    }
+    _clientLeft(client) {
+        if (!client.leftAt)
+            return;
+        this.endedAt = Math.max(this.endedAt ?? client.leftAt, client.leftAt);
     }
 }
 exports.ObservedCall = ObservedCall;

package/lib/ObservedCallSummary.d.ts

@@ -0,0 +1,18 @@
+export type ObservedCallSummary = {
+    currentActiveClients: number;
+    totalAddedClients: number;
+    totalRemovedClients: number;
+    totalClientsSentBytes: number;
+    totalClientsReceivedBytes: number;
+    totalClientsReceivedAudioBytes: number;
+    totalClientsReceivedVideoBytes: number;
+    totalClientsSentAudioBytes: number;
+    totalClientsSentVideoBytes: number;
+    totalRttLt50Measurements: number;
+    totalRttLt150Measurements: number;
+    totalRttLt300Measurements: number;
+    totalRttGtOrEq300Measurements: number;
+    numberOfIssues: number;
+    numberOfClientsUsedTurn: number;
+};
+//# sourceMappingURL=ObservedCallSummary.d.ts.map

package/lib/ObservedCallSummary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ObservedCallSummary.d.ts","sourceRoot":"","sources":["../src/ObservedCallSummary.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,mBAAmB,GAAG;IACjC,oBAAoB,EAAE,MAAM,CAAC;IAE7B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,mBAAmB,EAAE,MAAM,CAAC;IAE5B,qBAAqB,EAAE,MAAM,CAAC;IAC9B,yBAAyB,EAAE,MAAM,CAAC;IAClC,8BAA8B,EAAE,MAAM,CAAC;IACvC,8BAA8B,EAAE,MAAM,CAAC;IACvC,0BAA0B,EAAE,MAAM,CAAC;IACnC,0BAA0B,EAAE,MAAM,CAAC;IAEnC,wBAAwB,EAAE,MAAM,CAAC;IACjC,yBAAyB,EAAE,MAAM,CAAC;IAClC,yBAAyB,EAAE,MAAM,CAAC;IAClC,6BAA6B,EAAE,MAAM,CAAC;IAEtC,cAAc,EAAE,MAAM,CAAC;IAEvB,uBAAuB,EAAE,MAAM,CAAC;CAChC,CAAA"}

package/lib/ObservedClient.d.ts

@@ -1,11 +1,12 @@
 /// <reference types="node" />
 import { EventEmitter } from 'events';
 import { ObservedPeerConnection } from './ObservedPeerConnection';
-import { ClientMetaData, ClientSample, ClientIssue, ExtensionStat } from './schema/ClientSample';
-import * as MetaData from './schema/metaTypes';
+import { ClientEvent, ClientMetaData, ClientSample, ClientIssue, ExtensionStat } from './schema/ClientSample';
+import * as MetaData from './schema/ClientMetaTypes';
 import { ObservedCall } from './ObservedCall';
 import { CalculatedScore } from './scores/CalculatedScore';
 import { Detectors } from './detectors/Detectors';
+import { ObservedClientEventMonitor } from './ObservedClientEventMonitor';
 export type ObservedClientSettings<AppData extends Record<string, unknown> = Record<string, unknown>> = {
     clientId: string;
     appData?: AppData;
@@ -19,6 +20,8 @@ export type ObservedClientEvents = {
     ];
     close: [];
     joined: [];
+    issue: [ClientIssue];
+    metaData: [ClientMetaData];
     rejoined: [timestamp: number];
     left: [];
     usingturn: [boolean];
@@ -37,36 +40,92 @@ export declare class ObservedClient<AppData extends Record<string, unknown> = Re
     readonly clientId: string;
     readonly observedPeerConnections: Map<string, ObservedPeerConnection>;
     readonly calculatedScore: CalculatedScore;
-    appData?: AppData;
+    appData: AppData;
     attachments?: Record<string, unknown>;
     updated: number;
     acceptedSamples: number;
     closed: boolean;
     joinedAt?: number;
     leftAt?: number;
+    closedAt?: number;
     operationSystem?: MetaData.OperationSystem;
     engine?: MetaData.Engine;
     platform?: MetaData.Platform;
     browser?: MetaData.Browser;
     mediaConstraints: string[];
     usingTURN: boolean;
+    usingTCP: boolean;
     availableOutgoingBitrate: number;
     availableIncomingBitrate: number;
-    avgRttInMs?: number;
-    outboundAudioBitrate?: number;
-    outboundVideoBitrate?: number;
-    inboundAudioBitrate?: number;
-    inboundVideoBitrate?: number;
+    totalInboundPacketsLost: number;
+    totalInboundPacketsReceived: number;
+    totalOutboundPacketsSent: number;
+    totalDataChannelBytesSent: number;
+    totalDataChannelBytesReceived: number;
+    totalDataChannelMessagesSent: number;
+    totalDataChannelMessagesReceived: number;
+    totalReceivedAudioBytes: number;
+    totalReceivedVideoBytes: number;
+    totalSentAudioBytes: number;
+    totalSentVideoBytes: number;
+    totalSentBytes: number;
+    totalReceivedBytes: number;
+    deltaReceivedAudioBytes: number;
+    deltaReceivedVideoBytes: number;
+    deltaSentAudioBytes: number;
+    deltaSentVideoBytes: number;
+    deltaDataChannelBytesSent: number;
+    deltaDataChannelBytesReceived: number;
+    deltaDataChannelMessagesSent: number;
+    deltaDataChannelMessagesReceived: number;
+    deltaInboundPacketsLost: number;
+    deltaInboundPacketsReceived: number;
+    deltaOutboundPacketsSent: number;
+    deltaTransportSentBytes: number;
+    deltaTransportReceivedBytes: number;
+    deltaRttLt50Measurements: number;
+    deltaRttLt150Measurements: number;
+    deltaRttLt300Measurements: number;
+    deltaRttGtOrEq300Measurements: number;
+    currentMaxRttInMs?: number;
+    currentMinRttInMs?: number;
+    currentAvgRttInMs?: number;
+    sendingAudioBitrate: number;
+    sendingVideoBitrate: number;
+    receivingAudioBitrate: number;
+    receivingVideoBitrate: number;
+    numberOfInboundRtpStreams: number;
+    numberOfInbundTracks: number;
+    numberOfOutboundRtpStreams: number;
+    numberOfOutboundTracks: number;
+    numberOfDataChannels: number;
+    totalRttLt50Measurements: number;
+    totalRttLt150Measurements: number;
+    totalRttLt300Measurements: number;
+    totalRttGtOrEq300Measurements: number;
+    deltaNumberOfIssues: number;
+    totalScoreSum: number;
+    numberOfScoreMeasurements: number;
+    totalNumberOfIssues: number;
     readonly mediaDevices: MetaData.MediaDeviceInfo[];
     issues: ClientIssue[];
+    private _injections;
     constructor(settings: ObservedClientSettings<AppData>, call: ObservedCall);
+    get numberOfPeerConnections(): number;
     get score(): number | undefined;
     close(): void;
     accept(sample: ClientSample): void;
     private _processClientEvent;
-    processMetadata(metadata: ClientMetaData): void;
-    processIssue(issue: ClientIssue): void;
-    processExtensionStats(stats: ExtensionStat): void;
+    injectMetaData(metaData: ClientMetaData): void;
+    injectEvent(event: ClientEvent): void;
+    injectIssue(issue: ClientIssue): void;
+    injectExtensionStat(stat: ExtensionStat): void;
+    injectAttachment(key: string, value: unknown): void;
+    addMetadata(metadata: ClientMetaData): void;
+    addIssue(issue: ClientIssue): void;
+    addExtensionStats(stats: ExtensionStat): void;
     private _updatePeerConnection;
+    createEventMonitor<CTX = unknown>(ctx?: CTX): ObservedClientEventMonitor<CTX>;
+    private _mergeInjections;
 }
 //# sourceMappingURL=ObservedClient.d.ts.map

package/lib/ObservedClient.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ObservedClient.d.ts","sourceRoot":"","sources":["../src/ObservedClient.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"ObservedClient.d.ts","sourceRoot":"","sources":["../src/ObservedClient.ts"],"names":[],"mappings":"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"}