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

package/lib/ObservedClient.js

@@ -4,10 +4,11 @@ exports.ObservedClient = void 0;
 const events_1 = require("events");
 const ObservedPeerConnection_1 = require("./ObservedPeerConnection");
 const logger_1 = require("./common/logger");
-const eventTypes_1 = require("./schema/eventTypes");
-const metaTypes_1 = require("./schema/metaTypes");
+const ClientEventTypes_1 = require("./schema/ClientEventTypes");
+const ClientMetaTypes_1 = require("./schema/ClientMetaTypes");
 const utils_1 = require("./common/utils");
 const Detectors_1 = require("./detectors/Detectors");
+const ObservedClientEventMonitor_1 = require("./ObservedClientEventMonitor");
 const logger = (0, logger_1.createLogger)('ObservedClient');
 class ObservedClient extends events_1.EventEmitter {
     call;
@@ -25,6 +26,7 @@ class ObservedClient extends events_1.EventEmitter {
     closed = false;
     joinedAt;
     leftAt;
+    closedAt;
     // the timestamp of the CLIENT_JOINED event
     operationSystem;
     engine;
@@ -32,43 +34,73 @@ class ObservedClient extends events_1.EventEmitter {
     browser;
     mediaConstraints = [];
     usingTURN = false;
+    usingTCP = false;
     availableOutgoingBitrate = 0;
     availableIncomingBitrate = 0;
-    // public totalInboundPacketsLost = 0;
-    // public totalInboundPacketsReceived = 0;
-    // public totalOutboundPacketsSent = 0;
-    // public totalDataChannelBytesSent = 0;
-    // public totalDataChannelBytesReceived = 0;
-    // public totalSentBytes = 0;
-    // public totalReceivedBytes = 0;
-    // public totalReceivedAudioBytes = 0;
-    // public totalReceivedVideoBytes = 0;
-    // public totalSentAudioBytes = 0;
-    // public totalSentVideoBytes = 0;
-    // public deltaReceivedAudioBytes = 0;
-    // public deltaReceivedVideoBytes = 0;
-    // public deltaSentAudioBytes = 0;
-    // public deltaSentVideoBytes = 0;
-    // public deltaDataChannelBytesSent = 0;
-    // public deltaDataChannelBytesReceived = 0;
-    // public deltaInboundPacketsLost = 0;
-    // public deltaInboundPacketsReceived = 0;
-    // public deltaOutboundPacketsSent = 0;
-    avgRttInMs;
-    outboundAudioBitrate;
-    outboundVideoBitrate;
-    inboundAudioBitrate;
-    inboundVideoBitrate;
+    totalInboundPacketsLost = 0;
+    totalInboundPacketsReceived = 0;
+    totalOutboundPacketsSent = 0;
+    totalDataChannelBytesSent = 0;
+    totalDataChannelBytesReceived = 0;
+    totalDataChannelMessagesSent = 0;
+    totalDataChannelMessagesReceived = 0;
+    totalReceivedAudioBytes = 0;
+    totalReceivedVideoBytes = 0;
+    totalSentAudioBytes = 0;
+    totalSentVideoBytes = 0;
+    totalSentBytes = 0;
+    totalReceivedBytes = 0;
+    deltaReceivedAudioBytes = 0;
+    deltaReceivedVideoBytes = 0;
+    deltaSentAudioBytes = 0;
+    deltaSentVideoBytes = 0;
+    deltaDataChannelBytesSent = 0;
+    deltaDataChannelBytesReceived = 0;
+    deltaDataChannelMessagesSent = 0;
+    deltaDataChannelMessagesReceived = 0;
+    deltaInboundPacketsLost = 0;
+    deltaInboundPacketsReceived = 0;
+    deltaOutboundPacketsSent = 0;
+    deltaTransportSentBytes = 0;
+    deltaTransportReceivedBytes = 0;
+    deltaRttLt50Measurements = 0;
+    deltaRttLt150Measurements = 0;
+    deltaRttLt300Measurements = 0;
+    deltaRttGtOrEq300Measurements = 0;
+    currentMaxRttInMs;
+    currentMinRttInMs;
+    currentAvgRttInMs;
+    sendingAudioBitrate = 0;
+    sendingVideoBitrate = 0;
+    receivingAudioBitrate = 0;
+    receivingVideoBitrate = 0;
+    numberOfInboundRtpStreams = 0;
+    numberOfInbundTracks = 0;
+    numberOfOutboundRtpStreams = 0;
+    numberOfOutboundTracks = 0;
+    numberOfDataChannels = 0;
+    totalRttLt50Measurements = 0;
+    totalRttLt150Measurements = 0;
+    totalRttLt300Measurements = 0;
+    totalRttGtOrEq300Measurements = 0;
+    deltaNumberOfIssues = 0;
+    totalScoreSum = 0;
+    numberOfScoreMeasurements = 0;
+    totalNumberOfIssues = 0;
     mediaDevices = [];
     issues = [];
+    _injections = {};
     constructor(settings, call) {
         super();
         this.call = call;
         this.setMaxListeners(Infinity);
         this.clientId = settings.clientId;
-        this.appData = settings.appData;
+        this.appData = settings.appData ?? {};
         this.detectors = new Detectors_1.Detectors();
     }
+    get numberOfPeerConnections() {
+        return this.observedPeerConnections.size;
+    }
     get score() {
         return this.calculatedScore.value;
     }
@@ -77,19 +109,144 @@ class ObservedClient extends events_1.EventEmitter {
             return;
         this.closed = true;
         Array.from(this.observedPeerConnections.values()).forEach((peerConnection) => peerConnection.close());
+        this.closedAt = Date.now();
         this.emit('close');
     }
     accept(sample) {
         if (this.closed)
             throw new Error(`Client ${this.clientId} is closed`);
         const now = Date.now();
-        sample.clientEvents?.forEach(this._processClientEvent.bind(this));
-        sample.clientMetaItems?.forEach(this.processMetadata.bind(this));
-        sample.clientIssues?.forEach(this.processIssue.bind(this));
-        sample.peerConnections?.forEach(this._updatePeerConnection.bind(this));
-        sample.extensionStats?.forEach(this.processExtensionStats.bind(this));
+        const elapsedInMs = now - this.updated;
+        const elapsedInSeconds = elapsedInMs / 1000;
+        let sumOfRtts = 0;
+        let numberOfRttMeasurements = 0;
+        ++this.acceptedSamples;
+        this.availableIncomingBitrate = 0;
+        this.availableOutgoingBitrate = 0;
+        this.deltaDataChannelBytesReceived = 0;
+        this.deltaDataChannelBytesSent = 0;
+        this.deltaDataChannelMessagesReceived = 0;
+        this.deltaDataChannelMessagesSent = 0;
+        this.deltaInboundPacketsLost = 0;
+        this.deltaInboundPacketsReceived = 0;
+        this.deltaOutboundPacketsSent = 0;
+        this.deltaReceivedAudioBytes = 0;
+        this.deltaReceivedVideoBytes = 0;
+        this.deltaSentAudioBytes = 0;
+        this.deltaSentVideoBytes = 0;
+        this.deltaTransportReceivedBytes = 0;
+        this.deltaTransportSentBytes = 0;
+        this.deltaRttLt50Measurements = 0;
+        this.deltaRttLt150Measurements = 0;
+        this.deltaRttLt300Measurements = 0;
+        this.deltaRttGtOrEq300Measurements = 0;
+        this.deltaNumberOfIssues = 0;
+        this.numberOfDataChannels = 0;
+        this.numberOfInboundRtpStreams = 0;
+        this.numberOfInbundTracks = 0;
+        this.numberOfOutboundRtpStreams = 0;
+        this.numberOfOutboundTracks = 0;
+        this.usingTURN = false;
+        this.usingTCP = false;
+        this.currentMinRttInMs = undefined;
+        this.currentMaxRttInMs = undefined;
+        this._mergeInjections(sample);
+        const clientEventsPostBuffer = [];
+        for (const clientEvent of sample.clientEvents ?? []) {
+            this._processClientEvent(clientEvent, clientEventsPostBuffer);
+            this.call.observer.emit('client-event', this, clientEvent);
+        }
+        for (const metaData of sample.clientMetaItems ?? []) {
+            this.addMetadata(metaData);
+        }
+        for (const issue of sample.clientIssues ?? []) {
+            this.addIssue(issue);
+            ++this.deltaNumberOfIssues;
+        }
+        for (const extensionStat of sample.extensionStats ?? []) {
+            this.addExtensionStats(extensionStat);
+        }
+        for (const pcSample of sample.peerConnections ?? []) {
+            const observedPeerConnection = this._updatePeerConnection(pcSample);
+            if (!observedPeerConnection)
+                continue;
+            this.deltaDataChannelBytesReceived += observedPeerConnection.deltaDataChannelBytesReceived;
+            this.deltaDataChannelBytesSent += observedPeerConnection.deltaDataChannelBytesSent;
+            this.deltaDataChannelMessagesReceived += observedPeerConnection.deltaDataChannelMessagesReceived;
+            this.deltaDataChannelMessagesSent += observedPeerConnection.deltaDataChannelMessagesSent;
+            this.deltaInboundPacketsLost += observedPeerConnection.deltaInboundPacketsLost;
+            this.deltaInboundPacketsReceived += observedPeerConnection.deltaInboundPacketsReceived;
+            this.deltaOutboundPacketsSent += observedPeerConnection.deltaOutboundPacketsSent;
+            this.deltaReceivedAudioBytes += observedPeerConnection.deltaReceivedAudioBytes;
+            this.deltaReceivedVideoBytes += observedPeerConnection.deltaReceivedVideoBytes;
+            this.deltaSentAudioBytes += observedPeerConnection.deltaSentAudioBytes;
+            this.deltaSentVideoBytes += observedPeerConnection.deltaSentVideoBytes;
+            this.deltaTransportReceivedBytes += observedPeerConnection.deltaTransportReceivedBytes;
+            this.deltaTransportSentBytes += observedPeerConnection.deltaTransportSentBytes;
+            this.availableIncomingBitrate += observedPeerConnection.availableIncomingBitrate;
+            this.availableOutgoingBitrate += observedPeerConnection.availableOutgoingBitrate;
+            this.numberOfDataChannels += observedPeerConnection.observedDataChannels.size;
+            this.numberOfInbundTracks += observedPeerConnection.observedInboundTracks.size;
+            this.numberOfOutboundRtpStreams += observedPeerConnection.observedOutboundRtps.size;
+            this.numberOfOutboundTracks += observedPeerConnection.observedOutboundTracks.size;
+            this.numberOfInboundRtpStreams += observedPeerConnection.observedInboundRtps.size;
+            if (observedPeerConnection.usingTURN) {
+                this.usingTURN = true;
+            }
+            if (observedPeerConnection.usingTCP) {
+                this.usingTCP = true;
+            }
+            if (observedPeerConnection.currentRttInMs) {
+                if (this.currentMinRttInMs === undefined || observedPeerConnection.currentRttInMs < this.currentMinRttInMs) {
+                    this.currentMinRttInMs = observedPeerConnection.currentRttInMs;
+                }
+                if (this.currentMaxRttInMs === undefined || observedPeerConnection.currentRttInMs > this.currentMaxRttInMs) {
+                    this.currentMaxRttInMs = observedPeerConnection.currentRttInMs;
+                }
+                if (observedPeerConnection.currentRttInMs < 50) {
+                    this.deltaRttLt50Measurements += 1;
+                }
+                else if (observedPeerConnection.currentRttInMs < 150) {
+                    this.deltaRttLt150Measurements += 1;
+                }
+                else if (observedPeerConnection.currentRttInMs < 300) {
+                    this.deltaRttLt300Measurements += 1;
+                }
+                else if (300 <= observedPeerConnection.currentRttInMs) {
+                    this.deltaRttGtOrEq300Measurements += 1;
+                }
+                sumOfRtts += observedPeerConnection.currentRttInMs;
+                ++numberOfRttMeasurements;
+            }
+        }
+        for (const clientEvent of clientEventsPostBuffer) {
+            this._processClientEvent(clientEvent);
+        }
         // emit new attachments?
         this.attachments = sample.attachments;
+        this.totalDataChannelBytesReceived += this.deltaDataChannelBytesReceived;
+        this.totalDataChannelBytesSent += this.deltaDataChannelBytesSent;
+        this.totalDataChannelMessagesReceived += this.deltaDataChannelMessagesReceived;
+        this.totalDataChannelMessagesSent += this.deltaDataChannelMessagesSent;
+        this.totalInboundPacketsLost += this.deltaInboundPacketsLost;
+        this.totalInboundPacketsReceived += this.deltaInboundPacketsReceived;
+        this.totalOutboundPacketsSent += this.deltaOutboundPacketsSent;
+        this.totalReceivedAudioBytes += this.deltaReceivedAudioBytes;
+        this.totalReceivedVideoBytes += this.deltaReceivedVideoBytes;
+        this.totalSentAudioBytes += this.deltaSentAudioBytes;
+        this.totalSentVideoBytes += this.deltaSentVideoBytes;
+        this.totalReceivedBytes += this.deltaTransportReceivedBytes;
+        this.totalSentBytes += this.deltaTransportSentBytes;
+        this.totalRttLt50Measurements += this.deltaRttLt50Measurements;
+        this.totalRttLt150Measurements += this.deltaRttLt150Measurements;
+        this.totalRttLt300Measurements += this.deltaRttLt300Measurements;
+        this.totalRttGtOrEq300Measurements += this.deltaRttGtOrEq300Measurements;
+        this.totalNumberOfIssues += this.deltaNumberOfIssues;
+        this.receivingAudioBitrate = (this.deltaReceivedAudioBytes * 8) / (elapsedInSeconds);
+        this.receivingVideoBitrate = (this.totalReceivedVideoBytes * 8) / (elapsedInSeconds);
+        this.sendingAudioBitrate = (this.deltaSentAudioBytes * 8) / (elapsedInSeconds);
+        this.sendingVideoBitrate = (this.deltaSentVideoBytes * 8) / (elapsedInSeconds);
+        this.currentAvgRttInMs = 0 < numberOfRttMeasurements ? sumOfRtts / numberOfRttMeasurements : undefined;
         this.calculatedScore.value = sample.score;
         this.detectors.update();
         // emit update
@@ -98,18 +255,17 @@ class ObservedClient extends events_1.EventEmitter {
             elapsedTimeInMs: now - this.updated,
         });
         this.updated = now;
+        // if result changed after update
+        if (this.calculatedScore.value) {
+            this.totalScoreSum += this.calculatedScore.value;
+            ++this.numberOfScoreMeasurements;
+        }
     }
-    _processClientEvent(event) {
+    _processClientEvent(event, postBuffer) {
+        // eslint-disable-next-line no-console
+        // console.warn('ClientEvent', event);
         switch (event.type) {
-            case eventTypes_1.ClientEventType.CALL_STARTED: {
-                // update call timestamp if it's the first time
-                break;
-            }
-            case eventTypes_1.ClientEventType.CALL_ENDED: {
-                // update call timestamp if it's the first time
-                break;
-            }
-            case eventTypes_1.ClientEventType.CLIENT_JOINED: {
+            case ClientEventTypes_1.ClientEventTypes.CLIENT_JOINED: {
                 if (event.timestamp) {
                     if (!this.joinedAt) {
                         this.joinedAt = event.timestamp;
@@ -125,74 +281,240 @@ class ObservedClient extends events_1.EventEmitter {
                 }
                 break;
             }
-            case eventTypes_1.ClientEventType.CLIENT_LEFT: {
+            case ClientEventTypes_1.ClientEventTypes.CLIENT_LEFT: {
                 if (event.timestamp) {
                     if (!this.leftAt) {
                         this.leftAt = event.timestamp;
                         this.emit('left');
                     }
+                    else {
+                        logger.warn(`Client ${this.clientId} leftAt timestamp was already set`);
+                    }
+                }
+                break;
+            }
+            case ClientEventTypes_1.ClientEventTypes.PEER_CONNECTION_OPENED: {
+                const payload = (0, utils_1.parseJsonAs)(event.payload);
+                if (payload?.peerConnectionId && typeof payload.peerConnectionId === 'string') {
+                    const observedPeerConnection = this.observedPeerConnections.get(payload.peerConnectionId);
+                    if (observedPeerConnection) {
+                        observedPeerConnection.openedAt = event.timestamp;
+                    }
+                    else if (postBuffer) {
+                        postBuffer.push(event);
+                    }
+                    else {
+                        logger.warn('Received PEER_CONNECTION_OPENED event without a corresponding observedPeerConnection', event);
+                    }
+                }
+                break;
+            }
+            case ClientEventTypes_1.ClientEventTypes.PEER_CONNECTION_CLOSED: {
+                const payload = (0, utils_1.parseJsonAs)(event.payload);
+                if (payload?.peerConnectionId && typeof payload.peerConnectionId === 'string') {
+                    const observedPeerConnection = this.observedPeerConnections.get(payload.peerConnectionId);
+                    if (observedPeerConnection) {
+                        observedPeerConnection.closedAt = event.timestamp;
+                    }
+                    else if (postBuffer) {
+                        postBuffer.push(event);
+                    }
+                    else {
+                        logger.warn('Received PEER_CONNECTION_CLOSED event without a corresponding observedPeerConnection', event);
+                    }
+                }
+                break;
+            }
+            case ClientEventTypes_1.ClientEventTypes.MEDIA_TRACK_ADDED: {
+                const payload = (0, utils_1.parseJsonAs)(event.payload);
+                if (payload?.peerConnectionId && typeof payload.peerConnectionId === 'string' && payload?.trackId && typeof payload.trackId === 'string') {
+                    const observedPeerConnection = this.observedPeerConnections.get(payload.peerConnectionId);
+                    const observedTrack = observedPeerConnection?.observedInboundTracks.get(payload.trackId) ?? observedPeerConnection?.observedOutboundTracks.get(payload.trackId);
+                    if (observedTrack) {
+                        observedTrack.addedAt = event.timestamp;
+                    }
+                    else if (postBuffer) {
+                        postBuffer.push(event);
+                    }
+                    else {
+                        logger.warn('Received MEDIA_TRACK_ADDED event without a corresponding observedPeerConnection or observedTrack', event);
+                    }
+                }
+                break;
+            }
+            case ClientEventTypes_1.ClientEventTypes.MEDIA_TRACK_REMOVED: {
+                const payload = (0, utils_1.parseJsonAs)(event.payload);
+                if (payload?.peerConnectionId && typeof payload.peerConnectionId === 'string' && payload?.trackId && typeof payload.trackId === 'string') {
+                    const observedPeerConnection = this.observedPeerConnections.get(payload.peerConnectionId);
+                    const observedTrack = observedPeerConnection?.observedInboundTracks.get(payload.trackId) ?? observedPeerConnection?.observedOutboundTracks.get(payload.trackId);
+                    if (observedTrack) {
+                        observedTrack.removedAt = event.timestamp;
+                    }
+                    else if (postBuffer) {
+                        postBuffer.push(event);
+                    }
+                    else {
+                        logger.warn('Received MEDIA_TRACK_REMOVED event without a corresponding observedPeerConnection or observedTrack', event);
+                    }
+                }
+                break;
+            }
+            case ClientEventTypes_1.ClientEventTypes.DATA_CHANNEL_OPEN: {
+                const payload = (0, utils_1.parseJsonAs)(event.payload);
+                if (payload?.peerConnectionId && typeof payload.peerConnectionId === 'string' && payload?.dataChannelId && typeof payload.dataChannelId === 'string') {
+                    const observedPeerConnection = this.observedPeerConnections.get(payload.peerConnectionId);
+                    const observedDataChannel = observedPeerConnection?.observedDataChannels.get(payload.dataChannelId);
+                    if (observedDataChannel) {
+                        observedDataChannel.addedAt = event.timestamp;
+                    }
+                    else if (postBuffer) {
+                        postBuffer.push(event);
+                    }
+                    else {
+                        logger.warn('Received DATA_CHANNEL_OPENED event without a corresponding observedPeerConnection or observedDataChannel', event);
+                    }
+                }
+                break;
+            }
+            case ClientEventTypes_1.ClientEventTypes.DATA_CHANNEL_CLOSED: {
+                const payload = (0, utils_1.parseJsonAs)(event.payload);
+                if (payload?.peerConnectionId && typeof payload.peerConnectionId === 'string' && payload?.dataChannelId && typeof payload.dataChannelId === 'string') {
+                    const observedPeerConnection = this.observedPeerConnections.get(payload.peerConnectionId);
+                    const observedDataChannel = observedPeerConnection?.observedDataChannels.get(payload.dataChannelId);
+                    if (observedDataChannel) {
+                        observedDataChannel.removedAt = event.timestamp;
+                    }
+                    else if (postBuffer) {
+                        postBuffer.push(event);
+                    }
+                    else {
+                        logger.warn('Received DATA_CHANNEL_CLOSE event without a corresponding observedPeerConnection or observedDataChannel', event);
+                    }
                 }
                 break;
             }
         }
-        this.call.observer.processors.events.process({
-            call: this.call,
-            client: this,
-            data: event,
-        });
     }
-    processMetadata(metadata) {
+    injectMetaData(metaData) {
+        if (this.closed)
+            return;
+        if (!this._injections.clientMetaItems)
+            this._injections.clientMetaItems = [];
+        this._injections.clientMetaItems.push(metaData);
+    }
+    injectEvent(event) {
+        if (this.closed)
+            return;
+        if (!this._injections.clientEvents)
+            this._injections.clientEvents = [];
+        this._injections.clientEvents.push(event);
+    }
+    injectIssue(issue) {
+        if (this.closed)
+            return;
+        if (!this._injections.clientIssues)
+            this._injections.clientIssues = [];
+        this._injections.clientIssues.push(issue);
+    }
+    injectExtensionStat(stat) {
+        if (this.closed)
+            return;
+        if (!this._injections.extensionStats)
+            this._injections.extensionStats = [];
+        this._injections.extensionStats.push(stat);
+    }
+    injectAttachment(key, value) {
+        if (this.closed)
+            return;
+        if (!this._injections.attachments)
+            this._injections.attachments = {};
+        this._injections.attachments[key] = value;
+    }
+    addMetadata(metadata) {
+        if (this.closed)
+            return;
         switch (metadata.type) {
-            case metaTypes_1.ClientMetaType.BROWSER: {
+            case ClientMetaTypes_1.ClientMetaTypes.BROWSER: {
                 this.browser = (0, utils_1.parseJsonAs)(metadata.payload);
                 break;
             }
-            case metaTypes_1.ClientMetaType.ENGINE: {
+            case ClientMetaTypes_1.ClientMetaTypes.ENGINE: {
                 this.engine = (0, utils_1.parseJsonAs)(metadata.payload);
                 break;
             }
-            case metaTypes_1.ClientMetaType.PLATFORM: {
+            case ClientMetaTypes_1.ClientMetaTypes.PLATFORM: {
                 this.platform = (0, utils_1.parseJsonAs)(metadata.payload);
                 break;
             }
-            case metaTypes_1.ClientMetaType.OPERATION_SYSTEM: {
+            case ClientMetaTypes_1.ClientMetaTypes.OPERATION_SYSTEM: {
                 this.operationSystem = (0, utils_1.parseJsonAs)(metadata.payload);
                 break;
             }
         }
-        this.call.observer.processors.metaData.process({
-            call: this.call,
-            client: this,
-            data: metadata,
-        });
+        this.call.observer.emit('client-metadata', this, metadata);
     }
-    processIssue(issue) {
-        this.call.observer.processors.issues.process({
-            call: this.call,
-            client: this,
-            data: issue,
-        });
+    addIssue(issue) {
+        if (this.closed)
+            return;
+        this.emit('issue', issue);
+        this.call.observer.emit('client-issue', this, issue);
     }
-    processExtensionStats(stats) {
-        this.call.observer.processors.extensionStats.process({
-            call: this.call,
-            client: this,
-            data: stats,
-        });
+    addExtensionStats(stats) {
+        this.call.observer.emit('client-extension-stats', this, stats);
     }
     _updatePeerConnection(sample) {
         let observedPeerConnection = this.observedPeerConnections.get(sample.peerConnectionId);
         if (!observedPeerConnection) {
             if (!sample.peerConnectionId) {
-                return logger.warn(`ObservedClient received an invalid PeerConnectionSample (missing peerConnectionId field). ClientId: ${this.clientId}, CallId: ${this.call.callId}`, sample);
+                return (logger.warn(`ObservedClient received an invalid PeerConnectionSample (missing peerConnectionId field). ClientId: ${this.clientId}, CallId: ${this.call.callId}`, sample), void 0);
             }
             observedPeerConnection = new ObservedPeerConnection_1.ObservedPeerConnection(sample.peerConnectionId, this);
             observedPeerConnection.once('close', () => {
                 this.observedPeerConnections.delete(sample.peerConnectionId);
             });
             this.observedPeerConnections.set(sample.peerConnectionId, observedPeerConnection);
+            this.emit('newpeerconnection', observedPeerConnection);
         }
         observedPeerConnection.accept(sample);
+        return observedPeerConnection;
+    }
+    createEventMonitor(ctx) {
+        return new ObservedClientEventMonitor_1.ObservedClientEventMonitor(this, ctx ?? {});
+    }
+    _mergeInjections(sample) {
+        if (this.closed)
+            return sample;
+        if (this._injections.clientEvents) {
+            if (!sample.clientEvents)
+                sample.clientEvents = [];
+            sample.clientEvents.push(...this._injections.clientEvents);
+            this._injections.clientEvents = undefined;
+        }
+        if (this._injections.clientIssues) {
+            if (!sample.clientIssues)
+                sample.clientIssues = [];
+            sample.clientIssues.push(...this._injections.clientIssues);
+            this._injections.clientIssues = undefined;
+        }
+        if (this._injections.extensionStats) {
+            if (!sample.extensionStats)
+                sample.extensionStats = [];
+            sample.extensionStats.push(...this._injections.extensionStats);
+            this._injections.extensionStats = undefined;
+        }
+        if (this._injections.attachments) {
+            if (!sample.attachments)
+                sample.attachments = {};
+            Object.assign(sample.attachments, this._injections.attachments);
+            this._injections.attachments = undefined;
+        }
+        if (this._injections.clientMetaItems) {
+            if (!sample.clientMetaItems)
+                sample.clientMetaItems = [];
+            sample.clientMetaItems.push(...this._injections.clientMetaItems);
+            this._injections.clientMetaItems = undefined;
+        }
+        return sample;
     }
 }
 exports.ObservedClient = ObservedClient;

package/lib/ObservedClientEventMonitor.d.ts

@@ -0,0 +1,89 @@
+import { ObservedCertificate } from './ObservedCertificate';
+import { ObservedClient } from './ObservedClient';
+import { ObservedCodec } from './ObservedCodec';
+import { ObservedDataChannel } from './ObservedDataChannel';
+import { ObservedIceCandidate } from './ObservedIceCandidate';
+import { ObservedIceCandidatePair } from './ObservedIceCandidatePair';
+import { ObservedIceTransport } from './ObservedIceTransport';
+import { ObservedInboundRtp } from './ObservedInboundRtp';
+import { ObservedInboundTrack } from './ObservedInboundTrack';
+import { ObservedMediaPlayout } from './ObservedMediaPlayout';
+import { ObservedMediaSource } from './ObservedMediaSource';
+import { ObservedOutboundRtp } from './ObservedOutboundRtp';
+import { ObservedOutboundTrack } from './ObservedOutboundTrack';
+import { ObservedPeerConnection } from './ObservedPeerConnection';
+import { ClientIssue, ClientMetaData, ExtensionStat } from './schema/ClientSample';
+export declare class ObservedClientEventMonitor<Context> {
+    readonly observedClient: ObservedClient;
+    readonly context: Context;
+    constructor(observedClient: ObservedClient, context: Context);
+    onClientClosed?: (client: ObservedClient, ctx: Context) => void;
+    private _onClientClosed;
+    onPeerConnectionAdded?: (peerConnection: ObservedPeerConnection, ctx: Context) => void;
+    private _onPeerConnconnectionAdded;
+    onPeerConnectionRemoved?: (peerConnection: ObservedPeerConnection, ctx: Context) => void;
+    private _onPeerConnectionRemoved;
+    onCertificateAdded?: (certificate: ObservedCertificate, ctx: Context) => void;
+    private _onCertificateAdded;
+    onCertificateRemoved?: (certificate: ObservedCertificate, ctx: Context) => void;
+    private _onCertificateRemoved;
+    onInboundTrackAdded?: (inboundTrack: ObservedInboundTrack, ctx: Context) => void;
+    private _onInboundTrackAdded;
+    onInboundTrackRemoved?: (inboundTrack: ObservedInboundTrack, ctx: Context) => void;
+    private _onInboundTrackRemoved;
+    onOutboundTrackAdded?: (outboundTrack: ObservedOutboundTrack, ctx: Context) => void;
+    private _onOutboundTrackAdded;
+    onOutboundTrackRemoved?: (outboundTrack: ObservedOutboundTrack, ctx: Context) => void;
+    private _onOutboundTrackRemoved;
+    onInboundRtpAdded?: (inboundRtp: ObservedInboundRtp, ctx: Context) => void;
+    private _onInboundRtpAdded;
+    onInboundRtpRemoved?: (inboundRtp: ObservedInboundRtp, ctx: Context) => void;
+    private _onInboundRtpRemoved;
+    onOutboundRtpAdded?: (outboundRtp: ObservedOutboundRtp, ctx: Context) => void;
+    private _onOutboundRtpAdded;
+    onOutboundRtpRemoved?: (outboundRtp: ObservedOutboundRtp, ctx: Context) => void;
+    private _onOutboundRtpRemoved;
+    onDataChannelAdded?: (dataChannel: ObservedDataChannel, ctx: Context) => void;
+    private _onDataChannelAdded;
+    onDataChannelRemoved?: (dataChannel: ObservedDataChannel, ctx: Context) => void;
+    private _onDataChannelRemoved;
+    onAddedIceTransport?: (iceTransport: ObservedIceTransport, ctx: Context) => void;
+    private _onAddedIceTransport;
+    onRemovedIceTransport?: (iceTransport: ObservedIceTransport, ctx: Context) => void;
+    private _onRemovedIceTransport;
+    onIceCandidateAdded?: (iceCandidate: ObservedIceCandidate, ctx: Context) => void;
+    private _onIceCandidateAdded;
+    onIceCandidateRemoved?: (iceCandidate: ObservedIceCandidate, ctx: Context) => void;
+    private _onIceCandidateRemoved;
+    onAddedIceCandidatePair?: (candidatePair: ObservedIceCandidatePair, ctx: Context) => void;
+    private _onAddedIceCandidatePair;
+    onRemovedIceCandidatePair?: (candidatePair: ObservedIceCandidatePair, ctx: Context) => void;
+    private _onRemovedIceCandidatePair;
+    onAddedMediaCodec?: (codec: ObservedCodec, ctx: Context) => void;
+    private _onAddedMediaCodec;
+    onRemovedMediaCodec?: (codec: ObservedCodec, ctx: Context) => void;
+    private _onRemovedMediaCodec;
+    onAddedMediaPlayout?: (mediaPlayout: ObservedMediaPlayout, ctx: Context) => void;
+    private _onAddedMediaPlayout;
+    onRemovedMediaPlayout?: (mediaPlayout: ObservedMediaPlayout, ctx: Context) => void;
+    private _onRemovedMediaPlayout;
+    onMediaSourceAdded?: (mediaSource: ObservedMediaSource, ctx: Context) => void;
+    private _onMediaSourceAdded;
+    onMediaSourceRemoved?: (mediaSource: ObservedMediaSource, ctx: Context) => void;
+    private _onMediaSourceRemoved;
+    onClientIssue?: (issue: ClientIssue, ctx: Context) => void;
+    private _onClientIssue;
+    onClientMetadata?: (metadata: ClientMetaData, ctx: Context) => void;
+    private _onClientMetadata;
+    onClientExtensionStats?: (extensionStats: ExtensionStat, ctx: Context) => void;
+    private _onClientExtensionStats;
+    onClientJoined?: (client: ObservedClient, ctx: Context) => void;
+    private _onClientJoined;
+    onClientLeft?: (client: ObservedClient, ctx: Context) => void;
+    private _onClientLeft;
+    onUserMediaError?: (error: string, observedClient: ObservedClient, ctx: Context) => void;
+    private _onUserMediaError;
+    onUsingTurn?: (client: ObservedClient, ctx: Context) => void;
+    private _onUsingTurn;
+}
+//# sourceMappingURL=ObservedClientEventMonitor.d.ts.map

package/lib/ObservedClientEventMonitor.d.ts.map

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