@observertc/observer-js 0.40.7-beta → 0.40.9-beta

package/lib/ObservedSfuTransport.js

@@ -67,11 +67,15 @@ class ObservedSfuTransport extends events_1.EventEmitter {
         this.emit('close');
     }
     update(sample, timestamp) {
+        const now = Date.now();
+        const elapsedTimeInMs = now - this._updated;
         const report = Object.assign(Object.assign({ serviceId: this.serviceId, mediaUnitId: this.mediaUnitId, sfuId: this.sfuId, callId: undefined, roomId: undefined }, sample), { timestamp, marker: this.marker });
         this.reports.addSfuTransportReport(report);
         this.stats = sample;
-        this._updated = Date.now();
-        this.emit('update');
+        this._updated = now;
+        this.emit('update', {
+            elapsedTimeInMs,
+        });
     }
     createSfuOutboundRtpPad(model) {
         if (this._closed)

package/lib/Observer.d.ts

@@ -5,6 +5,8 @@ import { EventEmitter } from 'events';
 import { PartialBy } from './common/utils';
 import { ObserverSinkContext } from './common/types';
 import { ObservedSfu, ObservedSfuModel } from './ObservedSfu';
+import { CallSummaryMonitor } from './monitors/CallSummaryMonitor';
+import { TurnUsageMonitor } from './monitors/TurnUsageMonitor';
 export type ObserverEvents = {
     'newcall': [ObservedCall];
     'newsfu': [ObservedSfu];
@@ -42,6 +44,7 @@ export declare class Observer extends EventEmitter {
     readonly reports: ReportsCollector;
     private readonly _observedCalls;
     private readonly _observedSfus;
+    private readonly _monitors;
     private _reportTimer?;
     private _closed;
     constructor(config: ObserverConfig);
@@ -50,6 +53,10 @@ export declare class Observer extends EventEmitter {
         started?: number;
     }): ObservedCall<T>;
     createObservedSfu<AppData extends Record<string, unknown> = Record<string, unknown>>(model: ObservedSfuModel, appData: AppData): ObservedSfu<AppData>;
+    createCallSummaryMonitor(options?: {
+        timeoutAfterCallClose?: number;
+    }): CallSummaryMonitor;
+    createTurnUsageMonitor(): TurnUsageMonitor;
     get observedCalls(): ReadonlyMap<string, ObservedCall>;
     get observedSfus(): ReadonlyMap<string, ObservedSfu>;
     get closed(): boolean;

package/lib/Observer.d.ts.map

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

package/lib/Observer.js

@@ -18,6 +18,8 @@ const ReportsCollector_1 = require("./ReportsCollector");
 const events_1 = require("events");
 const callEventReports_1 = require("./common/callEventReports");
 const ObservedSfu_1 = require("./ObservedSfu");
+const CallSummaryMonitor_1 = require("./monitors/CallSummaryMonitor");
+const TurnUsageMonitor_1 = require("./monitors/TurnUsageMonitor");
 const logger = (0, logger_1.createLogger)('Observer');
 class Observer extends events_1.EventEmitter {
     static create(providedConfig) {
@@ -39,6 +41,7 @@ class Observer extends events_1.EventEmitter {
         this.reports = new ReportsCollector_1.ReportsCollector();
         this._observedCalls = new Map();
         this._observedSfus = new Map();
+        this._monitors = new Map();
         this._closed = false;
         this.setMaxListeners(Infinity);
         logger.debug('Observer is created with config', this.config);
@@ -93,6 +96,73 @@ class Observer extends events_1.EventEmitter {
         this.emit('newsfu', sfu);
         return sfu;
     }
+    createCallSummaryMonitor(options) {
+        if (this._closed)
+            throw new Error('Cannot create a call summary monitor on a closed observer');
+        const existingMonitor = this._monitors.get(CallSummaryMonitor_1.CallSummaryMonitor.name);
+        if (existingMonitor)
+            return existingMonitor;
+        const monitor = new CallSummaryMonitor_1.CallSummaryMonitor();
+        const onNewCall = (call) => {
+            monitor.addCall(call);
+            call.once('close', () => {
+                var _a;
+                return setTimeout(() => {
+                    const summary = monitor.takeSummary(call.callId);
+                    summary && monitor.emit('summary', summary);
+                }, (_a = options === null || options === void 0 ? void 0 : options.timeoutAfterCallClose) !== null && _a !== void 0 ? _a : 1000);
+            });
+        };
+        monitor.once('close', () => {
+            this._monitors.delete(CallSummaryMonitor_1.CallSummaryMonitor.name);
+            this.off('newcall', onNewCall);
+        });
+        this._monitors.set(CallSummaryMonitor_1.CallSummaryMonitor.name, monitor);
+        this.on('newcall', onNewCall);
+        this.once('close', () => {
+            monitor.close();
+        });
+        return monitor;
+    }
+    createTurnUsageMonitor() {
+        if (this._closed)
+            throw new Error('Cannot create a turn usage monitor on a closed observer');
+        const existingMonitor = this._monitors.get(TurnUsageMonitor_1.TurnUsageMonitor.name);
+        if (existingMonitor)
+            return existingMonitor;
+        const monitor = new TurnUsageMonitor_1.TurnUsageMonitor();
+        const onNewCall = (call) => {
+            const onNewClient = (client) => {
+                const onNewPeerConnection = (pc) => {
+                    const onUsingTurnChanged = (usingTurn) => {
+                        if (usingTurn)
+                            monitor.addPeerConnection(pc);
+                        else
+                            monitor.removePeerConnection(pc);
+                    };
+                    pc.once('close', () => {
+                        pc.ICE.off('usingturnchanged', onUsingTurnChanged);
+                        monitor.removePeerConnection(pc);
+                    });
+                    pc.ICE.on('usingturnchanged', onUsingTurnChanged);
+                };
+                client.once('close', () => client.off('newpeerconnection', onNewPeerConnection));
+                client.on('newpeerconnection', onNewPeerConnection);
+            };
+            call.once('close', () => call.off('newclient', onNewClient));
+            call.on('newclient', onNewClient);
+        };
+        monitor.once('close', () => {
+            this._monitors.delete(CallSummaryMonitor_1.CallSummaryMonitor.name);
+            this.off('newcall', onNewCall);
+        });
+        this._monitors.set(CallSummaryMonitor_1.CallSummaryMonitor.name, monitor);
+        this.on('newcall', onNewCall);
+        this.once('close', () => {
+            monitor.close();
+        });
+        return monitor;
+    }
     get observedCalls() {
         return this._observedCalls;
     }

package/lib/{CallSummary.d.ts → monitors/CallSummary.d.ts}

@@ -1,8 +1,14 @@
 export interface ClientSummary {
     clientId: string;
-    userId: string;
+    mediaUnitId: string;
+    userId?: string;
     joined: number;
     durationInMs: number;
+    avgOutboundAudioBitrate: number;
+    avgOutboundVideoBitrate: number;
+    avgInboundAudioBitrate: number;
+    avgInboundVideoBitrate: number;
+    ewmaRttInMs: number;
 }
 export interface CallSummary {
     serviceId: string;

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

@@ -0,0 +1 @@
+{"version":3,"file":"CallSummary.d.ts","sourceRoot":"","sources":["../../src/monitors/CallSummary.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,aAAa;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,uBAAuB,EAAE,MAAM,CAAC;IAChC,uBAAuB,EAAE,MAAM,CAAC;IAChC,sBAAsB,EAAE,MAAM,CAAC;IAC/B,sBAAsB,EAAE,MAAM,CAAC;IAC/B,WAAW,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,WAAW;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,aAAa,EAAE,CAAC;CACzB"}

package/lib/monitors/CallSummaryMonitor.d.ts

@@ -0,0 +1,25 @@
+/// <reference types="node" />
+import { EventEmitter } from 'events';
+import { CallSummary } from './CallSummary';
+import { ObservedCall } from '../ObservedCall';
+export type CallSummaryMonitorEvents = {
+    close: [];
+    summary: [CallSummary];
+};
+export declare interface CallSummaryMonitor {
+    on<U extends keyof CallSummaryMonitorEvents>(event: U, listener: (...args: CallSummaryMonitorEvents[U]) => void): this;
+    off<U extends keyof CallSummaryMonitorEvents>(event: U, listener: (...args: CallSummaryMonitorEvents[U]) => void): this;
+    once<U extends keyof CallSummaryMonitorEvents>(event: U, listener: (...args: CallSummaryMonitorEvents[U]) => void): this;
+    emit<U extends keyof CallSummaryMonitorEvents>(event: U, ...args: CallSummaryMonitorEvents[U]): boolean;
+}
+export declare class CallSummaryMonitor extends EventEmitter {
+    private readonly _summaries;
+    private _closed;
+    constructor();
+    addCall(call: ObservedCall): void;
+    private _addClient;
+    takeSummary(callId: string): CallSummary | undefined;
+    get closed(): boolean;
+    close(): void;
+}
+//# sourceMappingURL=CallSummaryMonitor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"CallSummaryMonitor.d.ts","sourceRoot":"","sources":["../../src/monitors/CallSummaryMonitor.ts"],"names":[],"mappings":";AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAG/C,MAAM,MAAM,wBAAwB,GAAG;IACtC,KAAK,EAAE,EAAE,CAAC;IACV,OAAO,EAAE,CAAC,WAAW,CAAC,CAAC;CACvB,CAAA;AAED,MAAM,CAAC,OAAO,WAAW,kBAAkB;IAC1C,EAAE,CAAC,CAAC,SAAS,MAAM,wBAAwB,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,GAAG,IAAI,EAAE,wBAAwB,CAAC,CAAC,CAAC,KAAK,IAAI,GAAG,IAAI,CAAC;IACvH,GAAG,CAAC,CAAC,SAAS,MAAM,wBAAwB,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,GAAG,IAAI,EAAE,wBAAwB,CAAC,CAAC,CAAC,KAAK,IAAI,GAAG,IAAI,CAAC;IACxH,IAAI,CAAC,CAAC,SAAS,MAAM,wBAAwB,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,GAAG,IAAI,EAAE,wBAAwB,CAAC,CAAC,CAAC,KAAK,IAAI,GAAG,IAAI,CAAC;IACzH,IAAI,CAAC,CAAC,SAAS,MAAM,wBAAwB,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,IAAI,EAAE,wBAAwB,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC;CACxG;AAED,qBAAa,kBAAmB,SAAQ,YAAY;IACnD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAkC;IAE7D,OAAO,CAAC,OAAO,CAAS;;IAKjB,OAAO,CAAC,IAAI,EAAE,YAAY;IAyBjC,OAAO,CAAC,UAAU;IAoCX,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS;IAU3D,IAAW,MAAM,YAEhB;IAEM,KAAK;CAMZ"}

package/lib/monitors/CallSummaryMonitor.js

@@ -0,0 +1,82 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CallSummaryMonitor = void 0;
+const events_1 = require("events");
+class CallSummaryMonitor extends events_1.EventEmitter {
+    constructor() {
+        super();
+        this._summaries = new Map();
+        this._closed = false;
+    }
+    addCall(call) {
+        if (this.closed)
+            return;
+        let callSummary = this._summaries.get(call.callId);
+        if (!callSummary) {
+            callSummary = {
+                callId: call.callId,
+                roomId: call.roomId,
+                serviceId: call.serviceId,
+                clients: [],
+                durationInMs: 0,
+                started: call.created,
+            };
+            this._summaries.set(call.callId, callSummary);
+        }
+        const constCallSummary = callSummary;
+        const onNewClient = (client) => this._addClient(constCallSummary, client);
+        call.once('close', () => {
+            call.off('newclient', onNewClient);
+        });
+        call.on('newclient', onNewClient);
+    }
+    _addClient(callSummary, client) {
+        if (this.closed)
+            return;
+        const clientSummary = {
+            clientId: client.clientId,
+            mediaUnitId: client.mediaUnitId,
+            durationInMs: 0,
+            avgInboundAudioBitrate: 0,
+            avgInboundVideoBitrate: 0,
+            avgOutboundAudioBitrate: 0,
+            avgOutboundVideoBitrate: 0,
+            ewmaRttInMs: 0,
+            joined: client.created,
+            userId: client.userId,
+        };
+        callSummary.clients.push(clientSummary);
+        const updateClient = () => {
+            if (client.avgRttInMs) {
+                clientSummary.ewmaRttInMs = (clientSummary.ewmaRttInMs * 0.9) + (client.avgRttInMs * 0.1);
+            }
+        };
+        client.on('update', updateClient);
+        client.once('close', () => {
+            const elapsedTimeInS = (Date.now() - client.created) / 1000;
+            clientSummary.avgInboundAudioBitrate = (client.totalReceivedBytes * 8) / elapsedTimeInS;
+            clientSummary.avgInboundVideoBitrate = (client.totalReceivedBytes * 8) / elapsedTimeInS;
+            clientSummary.avgOutboundAudioBitrate = (client.totalSentBytes * 8) / elapsedTimeInS;
+            clientSummary.avgOutboundVideoBitrate = (client.totalSentBytes * 8) / elapsedTimeInS;
+            clientSummary.durationInMs = elapsedTimeInS * 1000;
+            client.off('update', updateClient);
+        });
+    }
+    takeSummary(callId) {
+        if (this.closed)
+            return;
+        const summary = this._summaries.get(callId);
+        this._summaries.delete(callId);
+        return summary;
+    }
+    get closed() {
+        return this._closed;
+    }
+    close() {
+        if (this._closed)
+            return;
+        this._closed = true;
+        this.emit('close');
+    }
+}
+exports.CallSummaryMonitor = CallSummaryMonitor;

package/lib/monitors/TurnUsageMonitor.d.ts

@@ -0,0 +1,32 @@
+/// <reference types="node" />
+import { EventEmitter } from 'events';
+import { ObservedPeerConnection } from '../ObservedPeerConnection';
+export type TurnUsageMonitorEvents = {
+    close: [];
+};
+export type TurnUsage = {
+    turnIp: string;
+    totalBytesSent: number;
+    totalBytesReceived: number;
+    totalPacketsSent: number;
+    totalPacketsReceived: number;
+};
+export declare interface TurnUsageMonitor {
+    on<U extends keyof TurnUsageMonitorEvents>(event: U, listener: (...args: TurnUsageMonitorEvents[U]) => void): this;
+    off<U extends keyof TurnUsageMonitorEvents>(event: U, listener: (...args: TurnUsageMonitorEvents[U]) => void): this;
+    once<U extends keyof TurnUsageMonitorEvents>(event: U, listener: (...args: TurnUsageMonitorEvents[U]) => void): this;
+}
+export declare class TurnUsageMonitor extends EventEmitter {
+    private readonly _connections;
+    private readonly _turnUsage;
+    private _closed;
+    constructor();
+    addPeerConnection(peerConnection: ObservedPeerConnection): void;
+    removePeerConnection(peerConnection: ObservedPeerConnection): void;
+    get turnIps(): string[];
+    get peerConnections(): ObservedPeerConnection[];
+    getUsage(turnIp: string): TurnUsage | undefined;
+    get closed(): boolean;
+    close(): void;
+}
+//# sourceMappingURL=TurnUsageMonitor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"TurnUsageMonitor.d.ts","sourceRoot":"","sources":["../../src/monitors/TurnUsageMonitor.ts"],"names":[],"mappings":";AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AAGnE,MAAM,MAAM,sBAAsB,GAAG;IACpC,KAAK,EAAE,EAAE,CAAC;CACV,CAAA;AAED,MAAM,MAAM,SAAS,GAAG;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,MAAM,CAAC;IACvB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,gBAAgB,EAAE,MAAM,CAAC;IACzB,oBAAoB,EAAE,MAAM,CAAC;CAC7B,CAAA;AAQD,MAAM,CAAC,OAAO,WAAW,gBAAgB;IACxC,EAAE,CAAC,CAAC,SAAS,MAAM,sBAAsB,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,GAAG,IAAI,EAAE,sBAAsB,CAAC,CAAC,CAAC,KAAK,IAAI,GAAG,IAAI,CAAC;IACnH,GAAG,CAAC,CAAC,SAAS,MAAM,sBAAsB,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,GAAG,IAAI,EAAE,sBAAsB,CAAC,CAAC,CAAC,KAAK,IAAI,GAAG,IAAI,CAAC;IACpH,IAAI,CAAC,CAAC,SAAS,MAAM,sBAAsB,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,GAAG,IAAI,EAAE,sBAAsB,CAAC,CAAC,CAAC,KAAK,IAAI,GAAG,IAAI,CAAC;CACrH;AAED,qBAAa,gBAAiB,SAAQ,YAAY;IACjD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAyC;IACtE,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAgC;IAE3D,OAAO,CAAC,OAAO,CAAS;;IAKjB,iBAAiB,CAAC,cAAc,EAAE,sBAAsB;IAqCxD,oBAAoB,CAAC,cAAc,EAAE,sBAAsB;IAWlE,IAAW,OAAO,aAEjB;IAED,IAAW,eAAe,6BAEzB;IAEM,QAAQ,CAAC,MAAM,EAAE,MAAM;IAI9B,IAAW,MAAM,YAEhB;IAEM,KAAK;CAMZ"}

package/lib/monitors/TurnUsageMonitor.js

@@ -0,0 +1,75 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TurnUsageMonitor = void 0;
+const events_1 = require("events");
+class TurnUsageMonitor extends events_1.EventEmitter {
+    constructor() {
+        super();
+        this._connections = new Map();
+        this._turnUsage = new Map();
+        this._closed = false;
+    }
+    addPeerConnection(peerConnection) {
+        if (this.closed)
+            return;
+        if (this._connections.has(peerConnection.peerConnectionId))
+            return;
+        const ice = peerConnection.ICE;
+        const onUpdate = () => {
+            var _a;
+            const turnIp = (_a = ice === null || ice === void 0 ? void 0 : ice.selectedRemoteCandidate) === null || _a === void 0 ? void 0 : _a.address;
+            if (!peerConnection.usingTURN || !turnIp)
+                return;
+            let usage = this._turnUsage.get(turnIp);
+            if (!usage) {
+                usage = {
+                    turnIp,
+                    totalBytesSent: 0,
+                    totalBytesReceived: 0,
+                    totalPacketsSent: 0,
+                    totalPacketsReceived: 0
+                };
+                this._turnUsage.set(turnIp, usage);
+            }
+            usage.totalBytesSent += ice.deltaBytesSent;
+            usage.totalBytesReceived += ice.deltaBytesReceived;
+            usage.totalPacketsSent += ice.deltaPacketsSent;
+            usage.totalPacketsReceived += ice.deltaPacketsReceived;
+        };
+        this._connections.set(peerConnection.peerConnectionId, {
+            peerConnection,
+            onUpdate
+        });
+        peerConnection.ICE.on('update', onUpdate);
+    }
+    removePeerConnection(peerConnection) {
+        var _a;
+        if (this.closed)
+            return;
+        if (!this._connections.has(peerConnection.peerConnectionId))
+            return;
+        const { onUpdate } = (_a = this._connections.get(peerConnection.peerConnectionId)) !== null && _a !== void 0 ? _a : {};
+        if (!onUpdate)
+            return;
+        peerConnection.ICE.off('update', onUpdate);
+    }
+    get turnIps() {
+        return Array.from(this._turnUsage.keys());
+    }
+    get peerConnections() {
+        return Array.from(this._connections.values()).map(({ peerConnection }) => peerConnection);
+    }
+    getUsage(turnIp) {
+        return this._turnUsage.get(turnIp);
+    }
+    get closed() {
+        return this._closed;
+    }
+    close() {
+        if (this._closed)
+            return;
+        this._closed = true;
+        this.emit('close');
+    }
+}
+exports.TurnUsageMonitor = TurnUsageMonitor;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@observertc/observer-js",
-  "version": "0.40.7-beta",
+  "version": "0.40.9-beta",
   "description": "Server Side NodeJS Library for processing ObserveRTC Samples",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",
@@ -18,9 +18,8 @@
   },
   "keywords": [
     "webrtc",
-    "getStats",
     "observertc",
-    "client",
+    "server",
     "integration"
   ],
   "author": "Balazs Kreith",
@@ -29,10 +28,6 @@
     "@bufbuild/protobuf": "1.1.1",
     "@observertc/report-schemas-js": "2.2.10",
     "@observertc/sample-schemas-js": "2.2.10",
-    "@types/events": "^3.0.0",
-    "@types/uuid": "^8.3.4",
-    "ipaddr.js": "^2.1.0",
-    "package-lock-only": "^0.0.4",
     "uuid": "^8.3.2"
   },
   "devDependencies": {
@@ -40,6 +35,8 @@
     "@types/node": "^20.9.0",
     "@typescript-eslint/eslint-plugin": "^5.38.0",
     "@typescript-eslint/parser": "^5.38.0",
+    "@types/events": "^3.0.0",
+    "@types/uuid": "^8.3.4",
     "bufferutil": "^4.0.6",
     "eslint": "^8.24.0",
     "jest": "^27.5.0",

package/src/ObservedClient.ts

@@ -24,7 +24,9 @@ export type ObservedClientModel= {
 };
 
 export type ObservedClientEvents = {
-	update: [],
+	update: [{
+		elapsedTimeInMs: number,
+	}],
 	close: [],
 	newpeerconnection: [ObservedPeerConnection],
 	iceconnectionstatechange: [{
@@ -713,6 +715,7 @@ export class ObservedClient<AppData extends Record<string, unknown> = Record<str
 		this.inboundAudioBitrate = 0;
 		this.inboundVideoBitrate = 0;
 		let sumRttInMs = 0;
+		let anyPeerConnectionUsingTurn = false;
 
 		for (const peerConnection of this._peerConnections.values()) {
 			if (peerConnection.closed) continue;
@@ -732,9 +735,13 @@ export class ObservedClient<AppData extends Record<string, unknown> = Record<str
 
 			sumRttInMs += peerConnection.avgRttInMs ?? 0;
 
-			if (peerConnection.usingTURN) this.usingTURN = true;
+			anyPeerConnectionUsingTurn ||= peerConnection.usingTURN;
 		}
 
+		this.usingTURN = anyPeerConnectionUsingTurn === true;
+		
+		if (wasUsingTURN !== this.usingTURN) this.emit('usingturn', this.usingTURN);
+
 		this.totalSentBytes += this.deltaSentAudioBytes + this.deltaSentVideoBytes;
 		this.totalReceivedBytes += this.deltaReceivedAudioBytes + this.deltaReceivedVideoBytes;
 		this.totalReceivedAudioBytes += this.deltaReceivedAudioBytes;
@@ -753,11 +760,11 @@ export class ObservedClient<AppData extends Record<string, unknown> = Record<str
 		this.inboundVideoBitrate = (this.deltaReceivedVideoBytes * 8) / (Math.max(elapsedTimeInMs, 1) / 1000);
 
 		this.avgRttInMs = this._peerConnections.size ? sumRttInMs / this._peerConnections.size : undefined;
-			
-		if (wasUsingTURN !== this.usingTURN) this.emit('usingturn', this.usingTURN);
-
+		
 		this._updated = now;
-		this.emit('update');
+		this.emit('update', {
+			elapsedTimeInMs,
+		});
 	}
 
 	private _createPeerConnection(peerConnectionId: string, label?: string): ObservedPeerConnection {

package/src/ObservedDataChannel.ts

@@ -10,7 +10,9 @@ export type ObservedDataChannelModel = {
 }
 
 export type ObservedDataChannelEvents = {
-	update: [],
+	update: [{
+		elapsedTimeInMs: number;
+	}],
 	close: [],
 };
 
@@ -184,6 +186,8 @@ export class ObservedDataChannel extends EventEmitter	{
 
 		this._stats = sample;
 		this._updated = timestamp;
-		this.emit('update');
+		this.emit('update', {
+			elapsedTimeInMs,
+		});
 	}
 }

package/src/ObservedICE.ts

@@ -5,13 +5,16 @@ import { IceCandidatePairReport } from '@observertc/report-schemas-js';
 import { CallMetaType, createCallMetaReport } from './common/callMetaReports';
 
 export type ObservedICEEvents = {
-	update: [],
+	update: [{
+		elapsedTimeInMs: number;
+	}],
 	'new-local-candidate': [IceLocalCandidate],
 	'new-remote-candidate': [IceRemoteCandidate],
 	'new-selected-candidate-pair': [{
 		localCandidate: IceLocalCandidate,
 		remoteCandidate: IceRemoteCandidate,
 	}],
+	usingturnchanged: [boolean],
 	close: [],
 };
 
@@ -32,6 +35,20 @@ export class ObservedICE extends EventEmitter {
 	private readonly _localCandidates = new Map<string, IceLocalCandidate>();
 	private readonly _remoteCandidates = new Map<string, IceLocalCandidate>();
 	
+	public usingTURN = false;
+
+	public deltaBytesReceived = 0;
+	public deltaBytesSent = 0;
+	public deltaPacketsReceived = 0;
+	public deltaPacketsSent = 0;
+
+	public totalBytesReceived = 0;
+	public totalBytesSent = 0;
+	public totalPacketsReceived = 0;
+	public totalPacketsSent = 0;
+
+	public currentRttInMs?: number;
+
 	private _selectedLocalCandidateId?: string;
 	private _selectedRemoteCandidateId?: string;
 	private _updated = Date.now();
@@ -131,8 +148,18 @@ export class ObservedICE extends EventEmitter {
 		}
 	}
 
-	public update(candidatePair: IceCandidatePair, timestamp: number) {
+	public resetMetrics() {
+		this.deltaBytesReceived = 0;
+		this.deltaBytesSent = 0;
+		this.deltaPacketsReceived = 0;
+		this.deltaPacketsSent = 0;
 
+		this.currentRttInMs = undefined;
+	}
+
+	public update(candidatePair: IceCandidatePair, timestamp: number) {
+		const now = Date.now();
+		const elapsedTimeInMs = now - this._updated;
 		const report: IceCandidatePairReport = {
 			serviceId: this.peerConnection.client.serviceId,
 			mediaUnitId: this.peerConnection.client.mediaUnitId,
@@ -149,6 +176,18 @@ export class ObservedICE extends EventEmitter {
 		this.reports.addIceCandidatePairReport(report);
 
 		if (!candidatePair.nominated) return;
+		
+		this.deltaBytesReceived = (candidatePair.bytesReceived ?? 0) - (this._stats?.bytesReceived ?? 0);
+		this.deltaBytesSent = (candidatePair.bytesSent ?? 0) - (this._stats?.bytesSent ?? 0);
+		this.deltaPacketsReceived = (candidatePair.packetsReceived ?? 0) - (this._stats?.packetsReceived ?? 0);
+		this.deltaPacketsSent = (candidatePair.packetsSent ?? 0) - (this._stats?.packetsSent ?? 0);
+		
+		this.totalBytesReceived += this.deltaBytesReceived;
+		this.totalBytesSent += this.deltaBytesSent;
+		this.totalPacketsReceived += this.deltaPacketsReceived;
+		this.totalPacketsSent += this.deltaPacketsSent;
+		
+		this.currentRttInMs = candidatePair.currentRoundTripTime ? candidatePair.currentRoundTripTime * 1000 : undefined;
 
 		this._stats = candidatePair;
 
@@ -167,14 +206,24 @@ export class ObservedICE extends EventEmitter {
 			const remoteCandidate = this._remoteCandidates.get(candidatePair.remoteCandidateId);
 
 			if (localCandidate && remoteCandidate) {
+				const wasUsingTURN = this.usingTURN;
+
+				this.usingTURN = remoteCandidate.candidateType?.toLocaleLowerCase() === 'relay';
+
 				this.emit('new-selected-candidate-pair', {
 					localCandidate,
 					remoteCandidate,
 				});
+
+				if (wasUsingTURN !== this.usingTURN) {
+					this.emit('usingturnchanged', this.usingTURN);
+				}
 			}
 		}
 
-		this._updated = timestamp;
-		this.emit('update');
+		this._updated = now;
+		this.emit('update', {
+			elapsedTimeInMs,
+		});
 	}
 }

package/src/ObservedInboundTrack.ts

@@ -13,7 +13,9 @@ export type ObservedInboundTrackModel<K extends MediaKind> = {
 }
 
 export type ObservedInboundTrackEvents<K extends MediaKind> = {
-	update: [],
+	update: [{
+		elapsedTimeInMs: number;
+	}],
 	close: [],
 	remoteoutboundtrack: [ObservedOutboundTrack<K>],
 };
@@ -272,7 +274,9 @@ export class ObservedInboundTrack<Kind extends MediaKind> extends EventEmitter	{
 		this._stats.set(sample.ssrc, stats);
 
 		this._updated = now;
-		this.emit('update');
+		this.emit('update', {
+			elapsedTimeInMs,
+		});
 	}
 
 	public updateMetrics() {

package/src/ObservedOutboundTrack.ts

@@ -12,7 +12,9 @@ export type ObservedOutboundTrackModel<K extends MediaKind> = {
 }
 
 export type ObservedOutboundTrackEvents = {
-	update: [],
+	update: [{
+		elapsedTimeInMs: number;
+	}],
 	close: [],
 };
 
@@ -242,7 +244,9 @@ export class ObservedOutboundTrack<Kind extends MediaKind> extends EventEmitter
 		}
 
 		this._updated = now;
-		this.emit('update');
+		this.emit('update', {
+			elapsedTimeInMs,
+		});
 	}
 
 	public connectInboundTrack(track: ObservedInboundTrack<Kind>) {