@observertc/observer-js 1.0.0-beta.4 → 1.0.0-beta.6

package/dist/index.mjs

@@ -330,8 +330,7 @@ var ObservedOutboundRtp = class {
     return this._peerConnection.observedMediaSources.get(this.mediaSourceId ?? "");
   }
   getTrack() {
-    var _a;
-    return (_a = this.getMediaSource()) == null ? void 0 : _a.getTrack();
+    return this.getMediaSource()?.getTrack();
   }
   update(stats) {
     this._visited = true;
@@ -1064,20 +1063,6 @@ var ObservedInboundTrack = class {
     this._peerConnection = _peerConnection;
     this._inboundRtp = _inboundRtp;
     this._mediaPlayout = _mediaPlayout;
-    this.report = {
-      trackId: this.id,
-      kind: this.kind,
-      fractionLostDistribution: {
-        gtOrEq050: 0,
-        lt001: 0,
-        lt005: 0,
-        lt010: 0,
-        lt020: 0,
-        lt050: 0,
-        count: 0,
-        sum: 0
-      }
-    };
   }
   timestamp;
   id;
@@ -1090,7 +1075,7 @@ var ObservedInboundTrack = class {
     value: void 0
   };
   appData;
-  report;
+  remoteOutboundTrack;
   _visited = false;
   addedAt;
   removedAt;
@@ -1113,27 +1098,11 @@ var ObservedInboundTrack = class {
   getMediaPlayout() {
     return this._mediaPlayout;
   }
-  getRemoteOutboundTrack() {
-    var _a;
-    return (_a = this._peerConnection.client.call.remoteTrackResolver) == null ? void 0 : _a.resolveRemoteOutboundTrack(this);
-  }
   update(stats) {
-    var _a;
     this._visited = true;
     this.timestamp = stats.timestamp;
     this.calculatedScore.value = stats.score;
     this.attachments = stats.attachments;
-    const fl = (_a = this._inboundRtp) == null ? void 0 : _a.fractionLost;
-    if (fl !== void 0) {
-      if (fl < 0.01) this.report.fractionLostDistribution.lt001 += 1;
-      else if (fl < 0.05) this.report.fractionLostDistribution.lt005 += 1;
-      else if (fl < 0.1) this.report.fractionLostDistribution.lt010 += 1;
-      else if (fl < 0.2) this.report.fractionLostDistribution.lt020 += 1;
-      else if (fl < 0.5) this.report.fractionLostDistribution.lt050 += 1;
-      else this.report.fractionLostDistribution.gtOrEq050 += 1;
-      this.report.fractionLostDistribution.count += 1;
-      this.report.fractionLostDistribution.sum += fl;
-    }
   }
 };
 
@@ -1146,10 +1115,6 @@ var ObservedOutboundTrack = class {
     this._peerConnection = _peerConnection;
     this._outboundRtps = _outboundRtps;
     this._mediaSource = _mediaSource;
-    this.report = {
-      trackId: this.id,
-      kind: this.kind
-    };
   }
   timestamp;
   id;
@@ -1159,7 +1124,7 @@ var ObservedOutboundTrack = class {
   _mediaSource;
   _visited = false;
   appData;
-  report;
+  remoteInboundTracks = /* @__PURE__ */ new Set();
   calculatedScore = {
     weight: 1,
     value: void 0
@@ -1185,10 +1150,6 @@ var ObservedOutboundTrack = class {
   getMediaSource() {
     return this._mediaSource;
   }
-  getRemoteInboundTracks() {
-    var _a;
-    return (_a = this._peerConnection.client.call.remoteTrackResolver) == null ? void 0 : _a.resolveRemoteInboundTracks(this);
-  }
   update(stats) {
     this._visited = true;
     this.timestamp = stats.timestamp;
@@ -1364,10 +1325,7 @@ var ObservedPeerConnection = class extends EventEmitter {
   }
   get selectedIceCandiadtePairForTurn() {
     return this.selectedIceCandidatePairs.filter(
-      (pair) => {
-        var _a, _b, _c;
-        return ((_a = pair.getLocalCandidate()) == null ? void 0 : _a.candidateType) === "relay" && ((_c = (_b = pair.getRemoteCandidate()) == null ? void 0 : _b.url) == null ? void 0 : _c.startsWith("turn:"));
-      }
+      (pair) => pair.getLocalCandidate()?.candidateType === "relay" && pair.getRemoteCandidate()?.url?.startsWith("turn:")
     );
   }
   close() {
@@ -1415,7 +1373,6 @@ var ObservedPeerConnection = class extends EventEmitter {
     this._notify("peer-connection-closed", { ...this.eventScope });
   }
   accept(sample, context) {
-    var _a, _b, _c, _d, _e;
     if (this.closed) return;
     this._visited = true;
     if (context) this.appData = { ...this.appData, ...context };
@@ -1641,10 +1598,10 @@ var ObservedPeerConnection = class extends EventEmitter {
     this.usingTCP = false;
     this.usingTURN = false;
     for (const selectedCandidatePair of selectedIceCandidatePairs) {
-      if (((_a = selectedCandidatePair.getLocalCandidate()) == null ? void 0 : _a.protocol) === "tcp") {
+      if (selectedCandidatePair.getLocalCandidate()?.protocol === "tcp") {
         this.usingTCP = true;
       }
-      if (((_b = selectedCandidatePair.getLocalCandidate()) == null ? void 0 : _b.candidateType) === "relay" && ((_d = (_c = selectedCandidatePair.getRemoteCandidate()) == null ? void 0 : _c.url) == null ? void 0 : _d.startsWith("turn:"))) {
+      if (selectedCandidatePair.getLocalCandidate()?.candidateType === "relay" && selectedCandidatePair.getRemoteCandidate()?.url?.startsWith("turn:")) {
         selectedCandidatePairForTurn.push(selectedCandidatePair);
         this.usingTURN = true;
       }
@@ -1655,7 +1612,7 @@ var ObservedPeerConnection = class extends EventEmitter {
       if (!this.observedTurnServer) {
         this.observedTurnServer = this.client.call.observer.observedTURN.addPeerConnection(this);
       }
-      (_e = this.observedTurnServer) == null ? void 0 : _e.updateTurnUsage(...selectedCandidatePairForTurn);
+      this.observedTurnServer?.updateTurnUsage(...selectedCandidatePairForTurn);
     } else if (wasUsingTURN) {
       if (!this.usingTURN) {
         this.client.call.observer.observedTURN.removePeerConnection(this);
@@ -1995,7 +1952,7 @@ var ObservedPeerConnection = class extends EventEmitter {
         );
       }
       const observedMediaSource = [...this.observedMediaSources.values()].find((mediaSource) => mediaSource.trackIdentifier === stats.id);
-      const outboundRtps = observedMediaSource ? [...this.observedOutboundRtps.values()].filter((outboundRtp) => outboundRtp.mediaSourceId === (observedMediaSource == null ? void 0 : observedMediaSource.id)) : void 0;
+      const outboundRtps = observedMediaSource ? [...this.observedOutboundRtps.values()].filter((outboundRtp) => outboundRtp.mediaSourceId === observedMediaSource?.id) : void 0;
       observedOutboundTrack = new ObservedOutboundTrack(
         stats.timestamp,
         stats.id,
@@ -2142,60 +2099,19 @@ var ClientMetaTypes = /* @__PURE__ */ ((ClientMetaTypes2) => {
 var logger2 = createLogger("ObservedClient");
 var ObservedClient = class extends EventEmitter2 {
   constructor(settings, call) {
-    var _a, _b;
     super();
     this.call = call;
     this.setMaxListeners(Infinity);
     this.eventScope = { observer: call.observer, observedCall: call, observedClient: this };
-    this.sink = (_b = (_a = call.observer.config).createClientSink) == null ? void 0 : _b.call(_a, { clientId: settings.clientId, observedCall: call });
+    this.sink = call.observer.config.createClientSink?.({ clientId: settings.clientId, observedCall: call });
     this.clientId = settings.clientId;
     this.appData = settings.appData ?? {};
     this.settings = {
       closeClientIfIdleForMs: settings.closeClientIfIdleForMs
     };
-    this.report = {
-      callId: this.call.callId,
-      clientId: this.clientId,
-      rttDistribution: {
-        gtOrEq300ms: 0,
-        lt50ms: 0,
-        lt150ms: 0,
-        lt300ms: 0,
-        count: 0,
-        sum: 0
-      },
-      scoreDistribution: {
-        "0": 0,
-        "1": 0,
-        "2": 0,
-        "3": 0,
-        "4": 0,
-        "5": 0,
-        count: 0,
-        sum: 0
-      },
-      issues: {},
-      totalAudioBytesReceived: 0,
-      totalVideoBytesReceived: 0,
-      totalAudioBytesSent: 0,
-      totalVideoBytesSent: 0,
-      totalDataChannelBytesReceived: 0,
-      totalDataChannelBytesSent: 0,
-      totalDataChannelMessagesReceived: 0,
-      totalDataChannelMessagesSent: 0,
-      totalInboundRtpBytesReceived: 0,
-      totalInboundRtpPacketsLost: 0,
-      totalInboundRtpPacketsReceived: 0,
-      totalOutboundRtpBytesSent: 0,
-      totalOutboundRtpPacketsSent: 0,
-      totalNumberOfIssues: 0
-    };
     if (this.sink) {
       const onError = (err) => logger2.warn("ClientSampleSink error for client %s: %o", this.clientId, err);
-      this.sink.once("close", () => {
-        var _a2;
-        return (_a2 = this.sink) == null ? void 0 : _a2.off("error", onError);
-      });
+      this.sink.once("close", () => this.sink?.off("error", onError));
       this.sink.on("error", onError);
     }
   }
@@ -2263,7 +2179,6 @@ var ObservedClient = class extends EventEmitter2 {
   totalScoreSum = 0;
   numberOfScoreMeasurements = 0;
   // public totalNumberOfIssues = 0;
-  report;
   mediaDevices = [];
   issues = [];
   _injections = {};
@@ -2275,13 +2190,12 @@ var ObservedClient = class extends EventEmitter2 {
     return this.calculatedScore.value;
   }
   close() {
-    var _a, _b, _c, _d, _e;
     if (this.closed) return;
     this.closed = true;
-    (_a = this._injections.clientEvents) == null ? void 0 : _a.forEach((clientEvent) => this._processClientEvent(clientEvent));
-    (_b = this._injections.clientIssues) == null ? void 0 : _b.forEach((clientIssue) => this.addIssue(clientIssue));
-    (_c = this._injections.extensionStats) == null ? void 0 : _c.forEach((extensionStat) => this.addExtensionStats(extensionStat));
-    (_d = this._injections.clientMetaItems) == null ? void 0 : _d.forEach((clientMetaItem) => this.addMetadata(clientMetaItem));
+    this._injections.clientEvents?.forEach((clientEvent) => this._processClientEvent(clientEvent));
+    this._injections.clientIssues?.forEach((clientIssue) => this.addIssue(clientIssue));
+    this._injections.extensionStats?.forEach((extensionStat) => this.addExtensionStats(extensionStat));
+    this._injections.clientMetaItems?.forEach((clientMetaItem) => this.addMetadata(clientMetaItem));
     Array.from(this.observedPeerConnections.values()).forEach((peerConnection) => peerConnection.close());
     if (!this.leftAt) {
       this.leftAt = this.lastSampleTimestamp;
@@ -2294,18 +2208,17 @@ var ObservedClient = class extends EventEmitter2 {
     this.emit("close");
     this._notify("client-closed", { ...this.eventScope });
     try {
-      (_e = this.sink) == null ? void 0 : _e.end();
+      this.sink?.end();
     } catch (err) {
       logger2.warn("ClientSampleSink.end failed for client %s: %o", this.clientId, err);
     }
   }
   accept(sample, context) {
-    var _a;
     if (this.closed) {
       logger2.warn("Attempted to accept a sample on a closed client %s", this.clientId);
       return;
     }
-    (_a = this.sink) == null ? void 0 : _a.write(sample);
+    this.sink?.write(sample);
     if (this.closeTimer) {
       clearTimeout(this.closeTimer);
       this.closeTimer = void 0;
@@ -2398,19 +2311,13 @@ var ObservedClient = class extends EventEmitter2 {
         }
         if (observedPeerConnection.currentRttInMs < 50) {
           this.deltaRttLt50Measurements += 1;
-          this.report.rttDistribution.lt50ms += 1;
         } else if (observedPeerConnection.currentRttInMs < 150) {
           this.deltaRttLt150Measurements += 1;
-          this.report.rttDistribution.lt150ms += 1;
         } else if (observedPeerConnection.currentRttInMs < 300) {
           this.deltaRttLt300Measurements += 1;
-          this.report.rttDistribution.lt300ms += 1;
         } else if (300 <= observedPeerConnection.currentRttInMs) {
           this.deltaRttGtOrEq300Measurements += 1;
-          this.report.rttDistribution.gtOrEq300ms += 1;
         }
-        this.report.rttDistribution.count += 1;
-        this.report.rttDistribution.sum += observedPeerConnection.currentRttInMs;
         sumOfRtts += observedPeerConnection.currentRttInMs;
         ++numberOfRttMeasurements;
       }
@@ -2419,32 +2326,12 @@ var ObservedClient = class extends EventEmitter2 {
       this._processClientEvent(clientEvent);
     }
     this.attachments = sample.attachments;
-    this.report.totalDataChannelBytesReceived += this.deltaDataChannelBytesReceived;
-    this.report.totalDataChannelBytesSent += this.deltaDataChannelBytesSent;
-    this.report.totalDataChannelMessagesReceived += this.deltaDataChannelMessagesReceived;
-    this.report.totalDataChannelMessagesSent += this.deltaDataChannelMessagesSent;
-    this.report.totalInboundRtpPacketsLost += this.deltaInboundPacketsLost;
-    this.report.totalInboundRtpPacketsReceived += this.deltaInboundPacketsReceived;
-    this.report.totalOutboundRtpPacketsSent += this.deltaOutboundPacketsSent;
-    this.report.totalAudioBytesReceived += this.deltaReceivedAudioBytes;
-    this.report.totalVideoBytesReceived += this.deltaReceivedVideoBytes;
-    this.report.totalAudioBytesSent += this.deltaSentAudioBytes;
-    this.report.totalVideoBytesSent += this.deltaSentVideoBytes;
-    this.report.totalInboundRtpBytesReceived += this.deltaTransportReceivedBytes;
-    this.report.totalOutboundRtpBytesSent += this.deltaTransportSentBytes;
-    this.report.totalNumberOfIssues += this.deltaNumberOfIssues;
     this.receivingAudioBitrate = this.deltaReceivedAudioBytes * 8 / elapsedInSeconds;
     this.receivingVideoBitrate = this.deltaReceivedVideoBytes * 8 / elapsedInSeconds;
     this.sendingAudioBitrate = this.deltaSentAudioBytes * 8 / elapsedInSeconds;
     this.sendingVideoBitrate = this.deltaSentVideoBytes * 8 / elapsedInSeconds;
     this.currentAvgRttInMs = 0 < numberOfRttMeasurements ? sumOfRtts / numberOfRttMeasurements : void 0;
     this.calculatedScore.value = sample.score;
-    if (sample.score !== void 0) {
-      const bucket = Math.floor(sample.score).toString();
-      this.report.scoreDistribution[bucket] = (this.report.scoreDistribution[bucket] ?? 0) + 1;
-      this.report.scoreDistribution.count += 1;
-      this.report.scoreDistribution.sum += sample.score;
-    }
     this.lastSampleTimestamp = sample.timestamp;
     const elapsedTimeInMs = now - this.updated;
     this.emit("update", sample, elapsedTimeInMs, context);
@@ -2509,7 +2396,6 @@ var ObservedClient = class extends EventEmitter2 {
   }
   addIssue(issue) {
     if (this.closed) return;
-    this.report.issues[issue.type] = (this.report.issues[issue.type] ?? 0) + 1;
     this._notify("client-issue", { ...this.eventScope, issue });
   }
   addExtensionStats(stats) {
@@ -2548,7 +2434,7 @@ var ObservedClient = class extends EventEmitter2 {
       }
       case "PEER_CONNECTION_OPENED" /* PEER_CONNECTION_OPENED */: {
         const payload = parseJsonAs(event.payload);
-        if ((payload == null ? void 0 : payload.peerConnectionId) && typeof payload.peerConnectionId === "string") {
+        if (payload?.peerConnectionId && typeof payload.peerConnectionId === "string") {
           const observedPeerConnection = this.observedPeerConnections.get(payload.peerConnectionId);
           if (observedPeerConnection) {
             observedPeerConnection.openedAt = event.timestamp;
@@ -2562,7 +2448,7 @@ var ObservedClient = class extends EventEmitter2 {
       }
       case "PEER_CONNECTION_CLOSED" /* PEER_CONNECTION_CLOSED */: {
         const payload = parseJsonAs(event.payload);
-        if ((payload == null ? void 0 : payload.peerConnectionId) && typeof payload.peerConnectionId === "string") {
+        if (payload?.peerConnectionId && typeof payload.peerConnectionId === "string") {
           const observedPeerConnection = this.observedPeerConnections.get(payload.peerConnectionId);
           if (observedPeerConnection) {
             observedPeerConnection.closedAt = event.timestamp;
@@ -2576,9 +2462,9 @@ var ObservedClient = class extends EventEmitter2 {
       }
       case "MEDIA_TRACK_ADDED" /* MEDIA_TRACK_ADDED */: {
         const payload = parseJsonAs(event.payload);
-        if ((payload == null ? void 0 : payload.peerConnectionId) && typeof payload.peerConnectionId === "string" && (payload == null ? void 0 : payload.trackId) && typeof payload.trackId === "string") {
+        if (payload?.peerConnectionId && typeof payload.peerConnectionId === "string" && payload?.trackId && typeof payload.trackId === "string") {
           const observedPeerConnection = this.observedPeerConnections.get(payload.peerConnectionId);
-          const observedTrack = (observedPeerConnection == null ? void 0 : observedPeerConnection.observedInboundTracks.get(payload.trackId)) ?? (observedPeerConnection == null ? void 0 : observedPeerConnection.observedOutboundTracks.get(payload.trackId));
+          const observedTrack = observedPeerConnection?.observedInboundTracks.get(payload.trackId) ?? observedPeerConnection?.observedOutboundTracks.get(payload.trackId);
           if (observedTrack) {
             observedTrack.addedAt = event.timestamp;
           } else if (postBuffer) {
@@ -2591,9 +2477,9 @@ var ObservedClient = class extends EventEmitter2 {
       }
       case "MEDIA_TRACK_REMOVED" /* MEDIA_TRACK_REMOVED */: {
         const payload = parseJsonAs(event.payload);
-        if ((payload == null ? void 0 : payload.peerConnectionId) && typeof payload.peerConnectionId === "string" && (payload == null ? void 0 : payload.trackId) && typeof payload.trackId === "string") {
+        if (payload?.peerConnectionId && typeof payload.peerConnectionId === "string" && payload?.trackId && typeof payload.trackId === "string") {
           const observedPeerConnection = this.observedPeerConnections.get(payload.peerConnectionId);
-          const observedTrack = (observedPeerConnection == null ? void 0 : observedPeerConnection.observedInboundTracks.get(payload.trackId)) ?? (observedPeerConnection == null ? void 0 : observedPeerConnection.observedOutboundTracks.get(payload.trackId));
+          const observedTrack = observedPeerConnection?.observedInboundTracks.get(payload.trackId) ?? observedPeerConnection?.observedOutboundTracks.get(payload.trackId);
           if (observedTrack) {
             observedTrack.removedAt = event.timestamp;
           } else if (postBuffer) {
@@ -2606,9 +2492,9 @@ var ObservedClient = class extends EventEmitter2 {
       }
       case "DATA_CHANNEL_OPEN" /* DATA_CHANNEL_OPEN */: {
         const payload = parseJsonAs(event.payload);
-        if ((payload == null ? void 0 : payload.peerConnectionId) && typeof payload.peerConnectionId === "string" && (payload == null ? void 0 : payload.dataChannelId) && typeof payload.dataChannelId === "string") {
+        if (payload?.peerConnectionId && typeof payload.peerConnectionId === "string" && payload?.dataChannelId && typeof payload.dataChannelId === "string") {
           const observedPeerConnection = this.observedPeerConnections.get(payload.peerConnectionId);
-          const observedDataChannel = observedPeerConnection == null ? void 0 : observedPeerConnection.observedDataChannels.get(payload.dataChannelId);
+          const observedDataChannel = observedPeerConnection?.observedDataChannels.get(payload.dataChannelId);
           if (observedDataChannel) {
             observedDataChannel.addedAt = event.timestamp;
           } else if (postBuffer) {
@@ -2621,9 +2507,9 @@ var ObservedClient = class extends EventEmitter2 {
       }
       case "DATA_CHANNEL_CLOSED" /* DATA_CHANNEL_CLOSED */: {
         const payload = parseJsonAs(event.payload);
-        if ((payload == null ? void 0 : payload.peerConnectionId) && typeof payload.peerConnectionId === "string" && (payload == null ? void 0 : payload.dataChannelId) && typeof payload.dataChannelId === "string") {
+        if (payload?.peerConnectionId && typeof payload.peerConnectionId === "string" && payload?.dataChannelId && typeof payload.dataChannelId === "string") {
           const observedPeerConnection = this.observedPeerConnections.get(payload.peerConnectionId);
-          const observedDataChannel = observedPeerConnection == null ? void 0 : observedPeerConnection.observedDataChannels.get(payload.dataChannelId);
+          const observedDataChannel = observedPeerConnection?.observedDataChannels.get(payload.dataChannelId);
           if (observedDataChannel) {
             observedDataChannel.removedAt = event.timestamp;
           } else if (postBuffer) {
@@ -2636,10 +2522,10 @@ var ObservedClient = class extends EventEmitter2 {
       }
       case "MEDIA_TRACK_MUTED" /* MEDIA_TRACK_MUTED */: {
         const payload = parseJsonAs(event.payload);
-        if ((payload == null ? void 0 : payload.peerConnectionId) && typeof payload.peerConnectionId === "string" && (payload == null ? void 0 : payload.trackId) && typeof payload.trackId === "string") {
+        if (payload?.peerConnectionId && typeof payload.peerConnectionId === "string" && payload?.trackId && typeof payload.trackId === "string") {
           const observedPeerConnection = this.observedPeerConnections.get(payload.peerConnectionId);
-          const observedInboundTrack = observedPeerConnection == null ? void 0 : observedPeerConnection.observedInboundTracks.get(payload.trackId);
-          const observedOutboundTrack = observedPeerConnection == null ? void 0 : observedPeerConnection.observedOutboundTracks.get(payload.trackId);
+          const observedInboundTrack = observedPeerConnection?.observedInboundTracks.get(payload.trackId);
+          const observedOutboundTrack = observedPeerConnection?.observedOutboundTracks.get(payload.trackId);
           if (observedPeerConnection) {
             if (observedInboundTrack) {
               observedInboundTrack.muted = true;
@@ -2658,10 +2544,10 @@ var ObservedClient = class extends EventEmitter2 {
       }
       case "MEDIA_TRACK_UNMUTED" /* MEDIA_TRACK_UNMUTED */: {
         const payload = parseJsonAs(event.payload);
-        if ((payload == null ? void 0 : payload.peerConnectionId) && typeof payload.peerConnectionId === "string" && (payload == null ? void 0 : payload.trackId) && typeof payload.trackId === "string") {
+        if (payload?.peerConnectionId && typeof payload.peerConnectionId === "string" && payload?.trackId && typeof payload.trackId === "string") {
           const observedPeerConnection = this.observedPeerConnections.get(payload.peerConnectionId);
-          const observedInboundTrack = observedPeerConnection == null ? void 0 : observedPeerConnection.observedInboundTracks.get(payload.trackId);
-          const observedOutboundTrack = observedPeerConnection == null ? void 0 : observedPeerConnection.observedOutboundTracks.get(payload.trackId);
+          const observedInboundTrack = observedPeerConnection?.observedInboundTracks.get(payload.trackId);
+          const observedOutboundTrack = observedPeerConnection?.observedOutboundTracks.get(payload.trackId);
           if (observedPeerConnection) {
             if (observedInboundTrack) {
               observedInboundTrack.muted = false;
@@ -2680,7 +2566,7 @@ var ObservedClient = class extends EventEmitter2 {
       }
       case "ICE_CONNECTION_STATE_CHANGED" /* ICE_CONNECTION_STATE_CHANGED */: {
         const payload = parseJsonAs(event.payload);
-        if ((payload == null ? void 0 : payload.peerConnectionId) && typeof payload.peerConnectionId === "string" && (payload == null ? void 0 : payload.iceConnectionState) && typeof payload.iceConnectionState === "string") {
+        if (payload?.peerConnectionId && typeof payload.peerConnectionId === "string" && payload?.iceConnectionState && typeof payload.iceConnectionState === "string") {
           const observedPeerConnection = this.observedPeerConnections.get(payload.peerConnectionId);
           if (observedPeerConnection) {
             observedPeerConnection.iceConnectionState = payload.iceConnectionState;
@@ -2695,7 +2581,7 @@ var ObservedClient = class extends EventEmitter2 {
       }
       case "ICE_GATHERING_STATE_CHANGED" /* ICE_GATHERING_STATE_CHANGED */: {
         const payload = parseJsonAs(event.payload);
-        if ((payload == null ? void 0 : payload.peerConnectionId) && typeof payload.peerConnectionId === "string" && (payload == null ? void 0 : payload.iceGatheringState) && typeof payload.iceGatheringState === "string") {
+        if (payload?.peerConnectionId && typeof payload.peerConnectionId === "string" && payload?.iceGatheringState && typeof payload.iceGatheringState === "string") {
           const observedPeerConnection = this.observedPeerConnections.get(payload.peerConnectionId);
           if (observedPeerConnection) {
             observedPeerConnection.iceGatheringState = payload.iceGatheringState;
@@ -2710,7 +2596,7 @@ var ObservedClient = class extends EventEmitter2 {
       }
       case "PEER_CONNECTION_STATE_CHANGED" /* PEER_CONNECTION_STATE_CHANGED */: {
         const payload = parseJsonAs(event.payload);
-        if ((payload == null ? void 0 : payload.peerConnectionId) && typeof payload.peerConnectionId === "string" && (payload == null ? void 0 : payload.peerConnectionState) && typeof payload.peerConnectionState === "string") {
+        if (payload?.peerConnectionId && typeof payload.peerConnectionId === "string" && payload?.peerConnectionState && typeof payload.peerConnectionState === "string") {
           const observedPeerConnection = this.observedPeerConnections.get(payload.peerConnectionId);
           if (observedPeerConnection) {
             observedPeerConnection.connectionState = payload.peerConnectionState;
@@ -2736,31 +2622,9 @@ var ObservedClient = class extends EventEmitter2 {
         ), void 0;
       }
       const newObservedPeerConnection = new ObservedPeerConnection(sample.peerConnectionId, this);
-      const onInboundTrackRemoved = (track) => {
-        this._notify("client-track-report", {
-          ...this.eventScope,
-          report: {
-            direction: "inbound",
-            ...track.report
-          }
-        });
-      };
-      const onOutboundTrackRemoved = (track) => {
-        this._notify("client-track-report", {
-          ...this.eventScope,
-          report: {
-            direction: "outbound",
-            ...track.report
-          }
-        });
-      };
       newObservedPeerConnection.once("close", () => {
-        newObservedPeerConnection == null ? void 0 : newObservedPeerConnection.off("removed-inbound-track", onInboundTrackRemoved);
-        newObservedPeerConnection == null ? void 0 : newObservedPeerConnection.off("removed-outbound-track", onOutboundTrackRemoved);
         this.observedPeerConnections.delete(sample.peerConnectionId);
       });
-      newObservedPeerConnection.on("removed-inbound-track", onInboundTrackRemoved);
-      newObservedPeerConnection.on("removed-outbound-track", onOutboundTrackRemoved);
       this.observedPeerConnections.set(sample.peerConnectionId, newObservedPeerConnection);
       this._notify("peer-connection-added", { ...this.eventScope, observedPeerConnection: newObservedPeerConnection });
       observedPeerConnection = newObservedPeerConnection;
@@ -2867,21 +2731,6 @@ var OnAllClientCallUpdater = class {
   }
 };
 
-// src/updaters/OnIntervalUpdater.ts
-var OnIntervalUpdater = class {
-  constructor(intervalInMs, _update) {
-    this._update = _update;
-    this.timer = setInterval(() => this._update(), intervalInMs);
-  }
-  _update;
-  name = "OnIntervalUpdater";
-  description = "Call the update() method given in the constructor once the interval elapsed";
-  timer;
-  close() {
-    clearInterval(this.timer);
-  }
-};
-
 // src/updaters/OnAnyClientCallUpdater.ts
 var OnAnyClientCallUpdater = class {
   constructor(_observedCall) {
@@ -2934,7 +2783,7 @@ var Detectors = class {
       try {
         detector.update();
       } catch (err) {
-        logger3.warn(`Error updating detector ${detector == null ? void 0 : detector.name}`, err);
+        logger3.warn(`Error updating detector ${detector?.name}`, err);
       }
     }
   }
@@ -2955,9 +2804,6 @@ var ObservedCall = class extends EventEmitter3 {
     this.appData = settings.appData ?? {};
     this.scoreCalculator = new DefaultCallScoreCalculator(this);
     this.detectors = new Detectors();
-    if (settings.updateIntervalInMs && settings.updatePolicy !== "update-on-interval") {
-      logger4.warn('updateIntervalInMs is ignored unless updatePolicy is "update-on-interval" (callId: %s)', settings.callId);
-    }
     switch (settings.updatePolicy) {
       case "update-on-any-client-updated":
         this.updater = new OnAnyClientCallUpdater(this);
@@ -2965,17 +2811,6 @@ var ObservedCall = class extends EventEmitter3 {
       case "update-when-all-client-updated":
         this.updater = new OnAllClientCallUpdater(this);
         break;
-      case "update-on-interval":
-        if (!settings.updateIntervalInMs) {
-          logger4.warn('updateIntervalInMs must be set when updatePolicy is "update-on-interval"; falling back to "update-when-all-client-updated" (callId: %s)', settings.callId);
-          this.updater = new OnAllClientCallUpdater(this);
-        } else {
-          this.updater = new OnIntervalUpdater(
-            settings.updateIntervalInMs,
-            this.update.bind(this)
-          );
-        }
-        break;
     }
     this.settings = {
       closeCallIfEmptyForMs: settings.closeCallIfEmptyForMs
@@ -3027,11 +2862,10 @@ var ObservedCall = class extends EventEmitter3 {
     this._notify("call-issue", { ...this.eventScope, issue });
   }
   close() {
-    var _a;
     if (this.closed) return;
     this.update();
     this.closed = true;
-    (_a = this.updater) == null ? void 0 : _a.close();
+    this.updater?.close();
     let minSampleTimestamps;
     let maxSampleTimestamps;
     for (const client of this.observedClients.values()) {
@@ -3050,7 +2884,6 @@ var ObservedCall = class extends EventEmitter3 {
     return this.observedClients.get(clientId);
   }
   createObservedClient(settings) {
-    var _a, _b;
     if (this.closed) {
       logger4.warn("Attempted to create a client (clientId: %s) on a closed call %s", settings.clientId, this.callId);
       return void 0;
@@ -3063,7 +2896,7 @@ var ObservedCall = class extends EventEmitter3 {
       settings.closeClientIfIdleForMs = this.observer.config.closeClientIfIdleForMs;
     }
     if (settings.appData === void 0) {
-      settings.appData = (_b = (_a = this.observer.config).createClientAppData) == null ? void 0 : _b.call(_a, { clientId: settings.clientId, observedCall: this });
+      settings.appData = this.observer.config.createClientAppData?.({ clientId: settings.clientId, observedCall: this });
     }
     const result = new ObservedClient(settings, this);
     const wasEmpty = this.observedClients.size === 0;
@@ -3241,16 +3074,12 @@ var ObservedTURN = class extends EventEmitter4 {
     this.numberOfClients = clientIds.size;
   }
   addPeerConnection(peerConnection) {
-    var _a;
-    const turnPairs = peerConnection.selectedIceCandidatePairs.filter((pair) => {
-      var _a2, _b, _c;
-      return ((_a2 = pair.getLocalCandidate()) == null ? void 0 : _a2.candidateType) === "relay" && ((_c = (_b = pair.getRemoteCandidate()) == null ? void 0 : _b.url) == null ? void 0 : _c.startsWith("turn:"));
-    });
+    const turnPairs = peerConnection.selectedIceCandidatePairs.filter((pair) => pair.getLocalCandidate()?.candidateType === "relay" && pair.getRemoteCandidate()?.url?.startsWith("turn:"));
     if (turnPairs.length !== 1) {
       return logger5.warn(`Expected exactly one TURN pair, but found for peerconnection ${peerConnection.peerConnectionId}`, turnPairs.length), void 0;
     }
     const candidatePair = turnPairs[0];
-    const rawUrl = (_a = candidatePair.getRemoteCandidate()) == null ? void 0 : _a.url;
+    const rawUrl = candidatePair.getRemoteCandidate()?.url;
     if (!rawUrl) {
       return logger5.warn(`No remote candidate URL found for peerconnection ${peerConnection.peerConnectionId}`), void 0;
     }
@@ -3343,122 +3172,60 @@ var OnAnyCallObserverUpdater = class {
   }
 };
 
-// src/utils/MediasoupRemoteTrackResolver.ts
-var MediasoupRemoteTrackResolver = class {
-  constructor(observedCall) {
-    this.observedCall = observedCall;
-    const observer = observedCall.observer;
-    const onInboundAdded = (p) => {
-      if (p.observedCall === this.observedCall) this._addInboundTrack(p.observedInboundTrack);
-    };
-    const onInboundRemoved = (p) => {
-      if (p.observedCall === this.observedCall) this._removeInboundTrack(p.observedInboundTrack);
-    };
-    const onOutboundAdded = (p) => {
-      if (p.observedCall === this.observedCall) this._addOutboundTrack(p.observedOutboundTrack);
-    };
-    const onOutboundRemoved = (p) => {
-      if (p.observedCall === this.observedCall) this._removeOutboundTrack(p.observedOutboundTrack);
-    };
-    observer.on("inbound-track-added", onInboundAdded);
-    observer.on("inbound-track-removed", onInboundRemoved);
-    observer.on("outbound-track-added", onOutboundAdded);
-    observer.on("outbound-track-removed", onOutboundRemoved);
-    observedCall.once("close", () => {
-      observer.off("inbound-track-added", onInboundAdded);
-      observer.off("inbound-track-removed", onInboundRemoved);
-      observer.off("outbound-track-added", onOutboundAdded);
-      observer.off("outbound-track-removed", onOutboundRemoved);
-    });
-  }
-  observedCall;
-  _consumerIdToProducerId = /* @__PURE__ */ new Map();
-  _producerIdToOutboundTrack = /* @__PURE__ */ new Map();
-  _consumerIdToInboundTrack = /* @__PURE__ */ new Map();
-  // private _producerIdToOutboundTrack = new Map<string, ObservedOutboundTrack>();
-  _inboundTrackToConsumerId = /* @__PURE__ */ new Map();
-  _producerIdToConsumerIds = /* @__PURE__ */ new Map();
-  _outboundTrackToProducerId = /* @__PURE__ */ new Map();
-  resolveRemoteOutboundTrack(inboundTrack) {
-    const consumerId = this._inboundTrackToConsumerId.get(inboundTrack.id);
-    if (!consumerId) return;
-    const producerId = this._consumerIdToProducerId.get(consumerId);
-    if (!producerId) return;
-    return this._producerIdToOutboundTrack.get(producerId);
-  }
-  resolveRemoteInboundTracks(outboundTrack) {
-    const producerId = this._outboundTrackToProducerId.get(outboundTrack.id);
-    if (!producerId) return;
-    const consumerIds = this._producerIdToConsumerIds.get(producerId);
-    if (!consumerIds) return;
-    return consumerIds.map((consumerId) => this._consumerIdToInboundTrack.get(consumerId)).filter((inboundTrack) => Boolean(inboundTrack));
+// src/common/Middleware.ts
+var Executor = class {
+  constructor(stack, finalCallback) {
+    this.stack = stack;
+    this.finalCallback = finalCallback;
+  }
+  stack;
+  finalCallback;
+  done = false;
+  index = 0;
+  prevIndex = -1;
+  // Executes the middleware stack
+  execute(input) {
+    if (this.index <= this.prevIndex) {
+      throw new Error("Middleware must call next() only once!");
+    } else if (this.done) {
+      throw new Error("Middleware stack has already been executed!");
+    }
+    this.prevIndex = this.index;
+    const middleware = this.stack[this.index];
+    this.index++;
+    if (middleware) {
+      return middleware(input, (nextInput) => this.execute(nextInput));
+    }
+    this.done = true;
+    this.finalCallback?.(input);
   }
-  _addInboundTrack(inboundTrack) {
-    const attachments = this._getInboundTrackAttachments(inboundTrack);
-    if (!attachments) return;
-    const {
-      producerId,
-      consumerId
-    } = attachments;
-    this._inboundTrackToConsumerId.set(inboundTrack.id, consumerId);
-    this._consumerIdToProducerId.set(consumerId, producerId);
-    this._consumerIdToInboundTrack.set(consumerId, inboundTrack);
-    let producerConsumers = this._producerIdToConsumerIds.get(producerId);
-    if (!producerConsumers) {
-      producerConsumers = [];
-      this._producerIdToConsumerIds.set(producerId, producerConsumers);
-    }
-    producerConsumers.push(consumerId);
-  }
-  _removeInboundTrack(inboundTrack) {
-    const consumerId = this._inboundTrackToConsumerId.get(inboundTrack.id);
-    if (!consumerId) return;
-    this._inboundTrackToConsumerId.delete(inboundTrack.id);
-    this._consumerIdToProducerId.delete(consumerId);
-    this._consumerIdToInboundTrack.delete(consumerId);
-    const producerConsumers = this._producerIdToConsumerIds.get(consumerId);
-    if (!producerConsumers) return;
-    const filteredProducerConsumers = producerConsumers.filter((id) => id !== consumerId);
-    if (filteredProducerConsumers.length === 0) {
-      this._producerIdToConsumerIds.delete(consumerId);
-    } else {
-      this._producerIdToConsumerIds.set(consumerId, filteredProducerConsumers);
+};
+var MiddlewareProcessor = class {
+  stack = [];
+  finalCallback;
+  addMiddleware(...middlewares) {
+    if (middlewares && middlewares.length > 0) {
+      this.stack.push(...middlewares);
+    }
+    return this;
+  }
+  removeMiddleware(...middlewares) {
+    if (middlewares && middlewares.length > 0) {
+      for (const middleware of middlewares) {
+        const index = this.stack.indexOf(middleware);
+        if (index >= 0) {
+          this.stack.splice(index, 1);
+        }
+      }
     }
+    return this;
   }
-  _addOutboundTrack(outboundTrack) {
-    const attachments = this._getOutboundTrackAttachments(outboundTrack);
-    if (!attachments) return;
-    const {
-      producerId
-    } = attachments;
-    this._producerIdToOutboundTrack.set(producerId, outboundTrack);
-    this._outboundTrackToProducerId.set(outboundTrack.id, producerId);
-  }
-  _removeOutboundTrack(outboundTrack) {
-    const producerId = this._outboundTrackToProducerId.get(outboundTrack.id);
-    if (!producerId) return;
-    this._producerIdToOutboundTrack.delete(producerId);
-    this._outboundTrackToProducerId.delete(outboundTrack.id);
-  }
-  _getInboundTrackAttachments(inboundTrack) {
-    const {
-      producerId,
-      consumerId
-    } = inboundTrack.attachments ?? {};
-    if (!producerId || !consumerId || typeof producerId !== "string" || typeof consumerId !== "string") return;
-    return {
-      producerId,
-      consumerId
-    };
-  }
-  _getOutboundTrackAttachments(outboundTrack) {
-    const {
-      producerId
-    } = outboundTrack.attachments ?? {};
-    if (!producerId || typeof producerId !== "string") return;
-    return {
-      producerId
-    };
+  process(value) {
+    if (this.stack.length === 0) {
+      return this.finalCallback?.(value);
+    }
+    const executor = new Executor(this.stack, this.finalCallback);
+    executor.execute(value);
   }
 };
 
@@ -3473,7 +3240,7 @@ var Observer = class extends EventEmitter5 {
     this.config = config;
     this.setMaxListeners(Infinity);
     this.update = this.update.bind(this);
-    const currentUpdatePolicy = (config == null ? void 0 : config.updatePolicy) ?? "update-when-all-call-updated";
+    const currentUpdatePolicy = config?.updatePolicy ?? "update-when-all-call-updated";
     switch (currentUpdatePolicy) {
       case "update-on-any-call-updated":
         this.updater = new OnAnyCallObserverUpdater(this);
@@ -3481,19 +3248,6 @@ var Observer = class extends EventEmitter5 {
       case "update-when-all-call-updated":
         this.updater = new OnAllCallObserverUpdater(this);
         break;
-      case "update-on-interval": {
-        const interval = config == null ? void 0 : config.updateIntervalInMs;
-        if (!interval) {
-          logger6.warn('updateIntervalInMs must be set when updatePolicy is "update-on-interval"; falling back to "update-when-all-call-updated"');
-          this.updater = new OnAllCallObserverUpdater(this);
-        } else {
-          this.updater = new OnIntervalUpdater(
-            interval,
-            this.update.bind(this)
-          );
-        }
-        break;
-      }
     }
   }
   config;
@@ -3511,7 +3265,8 @@ var Observer = class extends EventEmitter5 {
   numberOfOutboundRtpStreams = 0;
   numberOfDataChannels = 0;
   numberOfPeerConnections = 0;
-  _timer;
+  /** Global, pre-dispatch middleware chain run on every accepted sample. */
+  acceptMiddlewares = new MiddlewareProcessor();
   get numberOfCalls() {
     return this.observedCalls.size;
   }
@@ -3523,7 +3278,6 @@ var Observer = class extends EventEmitter5 {
     return this.observedCalls.get(callId);
   }
   createObservedCall(settings) {
-    var _a, _b;
     if (this.closed) {
       logger6.warn("Attempted to create a call (callId: %s) on a closed observer", settings.callId);
       return void 0;
@@ -3535,14 +3289,11 @@ var Observer = class extends EventEmitter5 {
     const callSettings = {
       ...settings,
       updatePolicy: settings.updatePolicy ?? this.config.defaultCallUpdatePolicy,
-      updateIntervalInMs: settings.updateIntervalInMs ?? this.config.defaultCallUpdateIntervalInMs,
       closeCallIfEmptyForMs: settings.closeCallIfEmptyForMs ?? this.config.closeCallIfEmptyForMs,
-      appData: settings.appData ?? ((_b = (_a = this.config).createCallAppData) == null ? void 0 : _b.call(_a, { callId: settings.callId, observer: this }))
+      appData: settings.appData ?? this.config.createCallAppData?.({ callId: settings.callId, observer: this })
     };
     const observedCall = new ObservedCall(callSettings, this);
-    if (callSettings.remoteTrackResolvePolicy === "mediasoup-sfu") {
-      observedCall.remoteTrackResolver = new MediasoupRemoteTrackResolver(observedCall);
-    }
+    observedCall.remoteTrackResolver = this.config.createTrackResolver?.(observedCall);
     observedCall.once("close", () => {
       this.observedCalls.delete(observedCall.callId);
       ++this.totalRemovedCall;
@@ -3560,16 +3311,17 @@ var Observer = class extends EventEmitter5 {
       return logger6.debug("Attempted to close twice");
     }
     this.closed = true;
-    clearInterval(this._timer);
-    this._timer = void 0;
     this.observedCalls.forEach((call) => call.close());
     this._notify("observer-closed", { ...this.eventScope });
   }
   accept(sample, context) {
-    var _a, _b, _c, _d;
     if (this.closed) {
-      this._notify("sample-rejected", { ...this.eventScope, reason: "observer-closed", sample });
-      return;
+      return this._notify("sample-rejected", { ...this.eventScope, reason: "observer-closed", sample });
+    }
+    try {
+      this.acceptMiddlewares.process({ sample, context });
+    } catch (err) {
+      logger6.warn("An accept middleware threw; dropping the sample. %o", err);
     }
     if (!sample.callId) {
       this._notify("sample-rejected", { ...this.eventScope, reason: "missing-callId", sample });
@@ -3583,7 +3335,7 @@ var Observer = class extends EventEmitter5 {
     if (!call) {
       call = this.createObservedCall({
         callId: sample.callId,
-        appData: (_b = (_a = this.config).createCallAppData) == null ? void 0 : _b.call(_a, { callId: sample.callId, observer: this })
+        appData: this.config.createCallAppData?.({ callId: sample.callId, observer: this })
       });
     }
     if (!call) return;
@@ -3591,7 +3343,7 @@ var Observer = class extends EventEmitter5 {
     if (!client) {
       client = call.createObservedClient({
         clientId: sample.clientId,
-        appData: (_d = (_c = this.config).createClientAppData) == null ? void 0 : _d.call(_c, { clientId: sample.clientId, observedCall: call })
+        appData: this.config.createClientAppData?.({ clientId: sample.clientId, observedCall: call })
       });
     }
     if (!client) return;
@@ -3633,11 +3385,14 @@ var ClientSampleSink = class extends EventEmitter6 {
 import * as fs from "fs";
 import * as path from "path";
 var JsonlFileSink = class extends ClientSampleSink {
+  /** The file this sink writes to. Read it (e.g. in a `close` handler) to upload/move the file. */
+  path;
   _stream;
   _serializeSample;
   constructor(options) {
     super();
-    this._stream = fs.createWriteStream(options.path, { flags: "a" });
+    this.path = options.path;
+    this._stream = fs.createWriteStream(this.path, { flags: "a" });
     this._stream.on("close", () => this.emit("close"));
     this._stream.on("finish", () => this.emit("finish"));
     this._stream.on("drain", () => this.emit("drain"));
@@ -3657,8 +3412,7 @@ function createJsonlFileSink(options) {
 }
 function createJsonlFileSinkFactory(options) {
   return ({ clientId, observedCall }) => {
-    var _a;
-    const filename = ((_a = options.getFileName) == null ? void 0 : _a.call(options, { callId: observedCall.callId, clientId })) ?? `${observedCall.callId}__${clientId}.jsonl`;
+    const filename = options.getFileName?.({ callId: observedCall.callId, clientId }) ?? `${observedCall.callId}__${clientId}.jsonl`;
     return createJsonlFileSink({
       path: path.join(options.directory, filename),
       serializeSample: options.serializeSample
@@ -3684,6 +3438,126 @@ var InMemorySink = class extends ClientSampleSink {
 function createInMemorySink(samples) {
   return new InMemorySink(samples);
 }
+
+// src/utils/RemoteTrackResolver.ts
+var RemoteTrackResolver = class {
+  constructor(observedCall, resolvers) {
+    this.observedCall = observedCall;
+    this.resolvers = resolvers;
+    const observer = observedCall.observer;
+    const onInboundAdded = (p) => {
+      if (p.observedCall === this.observedCall) this._addInboundTrack(p.observedInboundTrack);
+    };
+    const onInboundRemoved = (p) => {
+      if (p.observedCall === this.observedCall) this._removeInboundTrack(p.observedInboundTrack);
+    };
+    const onOutboundAdded = (p) => {
+      if (p.observedCall === this.observedCall) this._addOutboundTrack(p.observedOutboundTrack);
+    };
+    const onOutboundRemoved = (p) => {
+      if (p.observedCall === this.observedCall) this._removeOutboundTrack(p.observedOutboundTrack);
+    };
+    observedCall.once("close", () => {
+      observer.off("inbound-track-added", onInboundAdded);
+      observer.off("inbound-track-removed", onInboundRemoved);
+      observer.off("outbound-track-added", onOutboundAdded);
+      observer.off("outbound-track-removed", onOutboundRemoved);
+    });
+    observer.on("inbound-track-added", onInboundAdded);
+    observer.on("inbound-track-removed", onInboundRemoved);
+    observer.on("outbound-track-added", onOutboundAdded);
+    observer.on("outbound-track-removed", onOutboundRemoved);
+  }
+  observedCall;
+  resolvers;
+  _publisherIdToOutboundTrack = /* @__PURE__ */ new Map();
+  _subscriberIdToInboundTrack = /* @__PURE__ */ new Map();
+  /** The published (outbound) track for a publisher id, if any. */
+  getOutboundTrackByPublisherId(publisherId) {
+    return this._publisherIdToOutboundTrack.get(publisherId);
+  }
+  /** The subscribed (inbound) track for a subscriber id, if the strategy resolves subscriber ids. */
+  getInboundTrackBySubscriberId(subscriberId) {
+    return this._subscriberIdToInboundTrack.get(subscriberId);
+  }
+  // RemoteTrackResolver interface — thin readers over the links maintained on the tracks.
+  resolveRemoteOutboundTrack(inboundTrack) {
+    return inboundTrack.remoteOutboundTrack;
+  }
+  resolveRemoteInboundTracks(outboundTrack) {
+    return [...outboundTrack.remoteInboundTracks];
+  }
+  _addInboundTrack(inboundTrack) {
+    const publisherId = this.resolvers.resolveInboundTrackPublisherId(inboundTrack);
+    if (!publisherId) return;
+    const subscriberId = this.resolvers.resolveInboundTrackSubscriberId?.(inboundTrack);
+    if (subscriberId) {
+      this._subscriberIdToInboundTrack.set(subscriberId, inboundTrack);
+    }
+    const outboundTrack = this._publisherIdToOutboundTrack.get(publisherId);
+    if (!outboundTrack) return;
+    outboundTrack.remoteInboundTracks.add(inboundTrack);
+    inboundTrack.remoteOutboundTrack = outboundTrack;
+  }
+  _removeInboundTrack(inboundTrack) {
+    inboundTrack.remoteOutboundTrack?.remoteInboundTracks.delete(inboundTrack);
+    inboundTrack.remoteOutboundTrack = void 0;
+    const subscriberId = this.resolvers.resolveInboundTrackSubscriberId?.(inboundTrack);
+    if (subscriberId) {
+      this._subscriberIdToInboundTrack.delete(subscriberId);
+    }
+  }
+  _addOutboundTrack(outboundTrack) {
+    const publisherId = this.resolvers.resolveOutboundTrackPublisherId(outboundTrack);
+    if (!publisherId) return;
+    this._publisherIdToOutboundTrack.set(publisherId, outboundTrack);
+    for (const observedClient of this.observedCall.observedClients.values()) {
+      for (const observedPeerConnection of observedClient.observedPeerConnections.values()) {
+        for (const inboundTrack of observedPeerConnection.observedInboundTracks.values()) {
+          if (this.resolvers.resolveInboundTrackPublisherId(inboundTrack) !== publisherId) continue;
+          outboundTrack.remoteInboundTracks.add(inboundTrack);
+          inboundTrack.remoteOutboundTrack = outboundTrack;
+        }
+      }
+    }
+  }
+  _removeOutboundTrack(outboundTrack) {
+    const publisherId = this.resolvers.resolveOutboundTrackPublisherId(outboundTrack);
+    if (publisherId && this._publisherIdToOutboundTrack.get(publisherId) === outboundTrack) {
+      this._publisherIdToOutboundTrack.delete(publisherId);
+    }
+    for (const inboundTrack of outboundTrack.remoteInboundTracks) {
+      inboundTrack.remoteOutboundTrack = void 0;
+    }
+    outboundTrack.remoteInboundTracks.clear();
+  }
+};
+
+// src/utils/RemoteTrackResolverFactories.ts
+function createDefaultMediasoupRemoteTrackResolverFactory() {
+  return (observedCall) => new RemoteTrackResolver(observedCall, {
+    resolveInboundTrackPublisherId: (inboundTrack) => inboundTrack.attachments?.producerId,
+    resolveInboundTrackSubscriberId: (inboundTrack) => inboundTrack.attachments?.consumerId,
+    resolveOutboundTrackPublisherId: (outboundTrack) => outboundTrack.attachments?.producerId
+  });
+}
+function createP2pRemoteTrackResolverFactory() {
+  return (observedCall) => new RemoteTrackResolver(observedCall, {
+    resolveInboundTrackPublisherId: (inboundTrack) => {
+      const ssrc = inboundTrack.getInboundRtp()?.ssrc;
+      return ssrc ? `${ssrc}` : void 0;
+    },
+    resolveInboundTrackSubscriberId: (inboundTrack) => {
+      const ssrc = inboundTrack.getInboundRtp()?.ssrc;
+      return ssrc ? `${ssrc}` : void 0;
+    },
+    resolveOutboundTrackPublisherId: (outboundTrack) => {
+      const rtps = outboundTrack.getOutboundRtps();
+      if (!rtps || rtps.length === 0) return void 0;
+      return rtps.map((rtp) => rtp.ssrc).join(",");
+    }
+  });
+}
 export {
   ClientEventTypes,
   ClientMetaTypes,
@@ -3710,10 +3584,13 @@ export {
   ObservedRemoteInboundRtp,
   ObservedRemoteOutboundRtp,
   Observer,
+  RemoteTrackResolver,
+  createDefaultMediasoupRemoteTrackResolverFactory,
   createInMemorySink,
   createJsonlFileSink,
   createJsonlFileSinkFactory,
   createLogger,
+  createP2pRemoteTrackResolverFactory,
   setObserverLogger
 };
 //# sourceMappingURL=index.mjs.map