@observertc/observer-js 1.2.0 → 1.3.0-rc.2

package/dist/index.js

@@ -42,9 +42,9 @@ __export(src_exports, {
   ClientMetaTypes: () => ClientMetaTypes,
   ClientPopulationIssueDetector: () => ClientPopulationIssueDetector,
   ClientPopulationIssueTypes: () => ClientPopulationIssueTypes,
-  ClientSampleSink: () => ClientSampleSink,
   CodecConsistencyValidator: () => CodecConsistencyValidator,
   Detectors: () => Detectors,
+  ExtensionStatsRegistry: () => ExtensionStatsRegistry,
   GEOHASH_CELL_SIZES: () => GEOHASH_CELL_SIZES,
   InMemorySink: () => InMemorySink,
   IssueFanOutDetector: () => IssueFanOutDetector,
@@ -88,6 +88,7 @@ __export(src_exports, {
   SCORE_HISTOGRAM_NUMBER_OF_BUCKETS: () => SCORE_HISTOGRAM_NUMBER_OF_BUCKETS,
   SfuCongestionDetector: () => SfuCongestionDetector,
   SimulcastReceiverValidator: () => SimulcastReceiverValidator,
+  SinkRegistry: () => SinkRegistry,
   SlidingWindow: () => SlidingWindow,
   TrackDeliveryMismatchDetector: () => TrackDeliveryMismatchDetector,
   TrackDeliveryMismatchTypes: () => TrackDeliveryMismatchTypes,
@@ -108,7 +109,6 @@ __export(src_exports, {
   createDefaultMediasoupRemoteTrackResolverFactory: () => createDefaultMediasoupRemoteTrackResolverFactory,
   createInMemorySink: () => createInMemorySink,
   createJsonlFileSink: () => createJsonlFileSink,
-  createJsonlFileSinkFactory: () => createJsonlFileSinkFactory,
   createLogger: () => createLogger,
   createP2pRemoteTrackResolverFactory: () => createP2pRemoteTrackResolverFactory,
   defaultCallSummaryConfig: () => defaultCallSummaryConfig,
@@ -171,18 +171,189 @@ function createLogger(moduleName) {
     }
   }();
 }
-function setObserverLogger(logger11) {
-  mainLogger = logger11;
+function setObserverLogger(logger13) {
+  mainLogger = logger13;
 }
 
 // src/ObservedCall.ts
-var import_node_events3 = require("events");
+var import_node_events4 = require("events");
+
+// src/sinks/SinkRegistry.ts
+var import_uuid = require("uuid");
+var logger = createLogger("SinkRegistry");
+var SinkRegistry = class {
+  constructor(parent) {
+    this.parent = parent;
+  }
+  parent;
+  // This registry's sinks and its descendants'.
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  _sinks = /* @__PURE__ */ new Map();
+  /** Number of open sinks in this registry and its descendants. */
+  get size() {
+    return this._sinks.size;
+  }
+  keys() {
+    return this._sinks.keys();
+  }
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  values() {
+    return this._sinks.values();
+  }
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  get(id) {
+    return this._sinks.get(id);
+  }
+  /**
+   * Construct `new SinkClass(settings)` and register it. The id (`settings.id`, generated when
+   * omitted) is checked first, so nothing is constructed — no file is opened — when it is taken:
+   * `undefined` is returned and a warning logged.
+   */
+  create(SinkClass, settings) {
+    const lineage = this._lineage();
+    const id = settings.id ?? (0, import_uuid.v4)();
+    if (lineage[lineage.length - 1]._sinks.has(id)) {
+      logger.warn("Sink id %s is already in use; sink ids must be unique per observer. No sink was created", id);
+      return void 0;
+    }
+    const sink = new SinkClass({ ...settings, id });
+    const onError = (err) => logger.warn("Sink %s failed: %o", id, err);
+    sink.on("error", onError);
+    sink.once("close", () => sink.off("error", onError));
+    sink.once("ended", () => {
+      for (const registry of lineage) {
+        if (registry._sinks.get(id) === sink) registry._sinks.delete(id);
+      }
+    });
+    for (const registry of lineage) registry._sinks.set(id, sink);
+    return sink;
+  }
+  /** Write `record` to the sink `id`. `false` when there is no such sink, or on backpressure. */
+  write(id, record) {
+    const sink = this._sinks.get(id);
+    if (!sink) {
+      logger.debug("No sink %s; record dropped", id);
+      return false;
+    }
+    return sink.write(record);
+  }
+  /** End every sink of this registry and of its descendants. */
+  clear() {
+    for (const sink of [...this._sinks.values()]) {
+      try {
+        sink.end();
+      } catch (err) {
+        logger.warn("Sink %s failed to end: %o", sink.id, err);
+      }
+    }
+  }
+  /** This registry and its ancestors, up to the root. */
+  _lineage() {
+    return [this, ...this.parent?._lineage() ?? []];
+  }
+};
+
+// src/sinks/ExtensionStatsRegistry.ts
+var logger2 = createLogger("ExtensionStats");
+var ExtensionStatsRegistry = class {
+  constructor(id, _sinks) {
+    this.id = id;
+    this._sinks = _sinks;
+  }
+  id;
+  _sinks;
+  /** The last data accepted for each extension stats id. */
+  values = /* @__PURE__ */ new Map();
+  closed = false;
+  /**
+   * Refuse further `create` / `accept`, and end the extension stats' sinks (the sinks whose id is
+   * an extension stats id). Other sinks of the owner, e.g. client sample sinks, are left to the
+   * owner's `sinks.clear()`. Called by the owner when it closes.
+   */
+  close() {
+    if (this.closed) return;
+    this.closed = true;
+    for (const id of this.values.keys()) {
+      this._sinks.get(id)?.end();
+    }
+  }
+  create(settings) {
+    if (this.closed) {
+      logger2.warn("Attempted to create extension stats %s on closed %s", settings.id, this.id);
+      return void 0;
+    }
+    if (this.values.has(settings.id)) {
+      logger2.warn("Extension stats with id %s already exists on %s", settings.id, this.id);
+      return void 0;
+    }
+    this.values.set(settings.id, void 0);
+    if (!settings.createSink) return void 0;
+    const [SinkClass, sinkSettings] = settings.createSink;
+    this._sinks.get(settings.id)?.end();
+    return this._sinks.create(SinkClass, { ...sinkSettings, id: settings.id });
+  }
+  accept(id, data) {
+    if (this.closed) {
+      logger2.debug("Extension stats %s dropped: %s is closed", id, this.id);
+      return;
+    }
+    this.values.set(id, data);
+    try {
+      this._sinks.get(id)?.write(data);
+    } catch (err) {
+      logger2.warn("Failed to write extension stats %s to sink: %o", id, err);
+    }
+  }
+  get(id) {
+    return this.values.get(id);
+  }
+};
+
+// src/sinks/JsonlFileSink.ts
+var fs = __toESM(require("fs"));
+var import_node_events = require("events");
+var JsonlFileSink = class extends import_node_events.EventEmitter {
+  id;
+  /** The file this sink writes to. Read it (e.g. in a `close` handler) to upload/move the file. */
+  path;
+  _stream;
+  _serializeSample;
+  _ended = false;
+  constructor(options) {
+    super();
+    this.id = options.id ?? options.path;
+    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"));
+    this._stream.on("error", (err) => this.emit("error", err));
+    this._serializeSample = options.serializeSample ?? ((record) => JSON.stringify(record));
+  }
+  get ended() {
+    return this._ended;
+  }
+  write(record) {
+    if (this._ended) return false;
+    return this._stream.write(`${this._serializeSample(record)}
+`);
+  }
+  end() {
+    if (this._ended) return;
+    this._ended = true;
+    this.emit("ended");
+    this._stream.end();
+  }
+};
+function createJsonlFileSink(options) {
+  return new JsonlFileSink(options);
+}
 
 // src/ObservedClient.ts
-var import_node_events2 = require("events");
+var import_node_events3 = require("events");
 
 // src/ObservedPeerConnection.ts
-var import_node_events = require("events");
+var import_node_events2 = require("events");
 
 // src/utils/stats.ts
 function percentile(values, p) {
@@ -339,8 +510,9 @@ function percentileOfHistogram(histogram, bucketWidth, p, options = {}) {
       continue;
     }
     if (options.openEnded && index === histogram.length - 1 && options.max !== void 0) return options.max;
-    const estimate = index * bucketWidth + (rank - cumulative) / count * bucketWidth;
-    return Math.min(Math.max(estimate, options.min ?? estimate), options.max ?? estimate);
+    const lower = Math.max(index * bucketWidth, options.min ?? -Infinity);
+    const upper = Math.min((index + 1) * bucketWidth, options.max ?? Infinity);
+    return lower + (rank - cumulative) / count * Math.max(0, upper - lower);
   }
   return options.max;
 }
@@ -1874,14 +2046,14 @@ var ObservedOutboundTrack = class {
 
 // src/ObservedPeerConnection.ts
 var ascending2 = (a, b) => a - b;
-var logger = createLogger("ObservedPeerConnection");
+var logger3 = createLogger("ObservedPeerConnection");
 function publicAddressOfLocalCandidate(candidate) {
   if (!candidate) return void 0;
   if (candidate.candidateType !== "relay" && isPublicIpAddress(candidate.address)) return candidate.address;
   if (isPublicIpAddress(candidate.relatedAddress)) return candidate.relatedAddress;
   return void 0;
 }
-var ObservedPeerConnection = class extends import_node_events.EventEmitter {
+var ObservedPeerConnection = class extends import_node_events2.EventEmitter {
   constructor(peerConnectionId, client) {
     super();
     this.peerConnectionId = peerConnectionId;
@@ -2463,7 +2635,7 @@ var ObservedPeerConnection = class extends import_node_events.EventEmitter {
     let observedCertificate = this.observedCertificates.get(stats.id);
     if (!observedCertificate) {
       if (!stats.timestamp || !stats.id || !stats.fingerprint) {
-        return logger.warn(
+        return logger3.warn(
           `ObservedPeerConnection received an invalid CertificateStats (missing timestamp OR id OR fingerprint field). PeerConnectionId: ${this.peerConnectionId} ClientId: ${this.client.clientId}, CallId: ${this.client.call.callId}`,
           stats
         );
@@ -2482,7 +2654,7 @@ var ObservedPeerConnection = class extends import_node_events.EventEmitter {
     let observedCodec = this.observedCodecs.get(stats.id);
     if (!observedCodec) {
       if (!stats.timestamp || !stats.id || !stats.mimeType) {
-        return logger.warn(
+        return logger3.warn(
           `ObservedPeerConnection received an invalid CodecStats (missing timestamp OR id OR mimeType field). PeerConnectionId: ${this.peerConnectionId} ClientId: ${this.client.clientId}, CallId: ${this.client.call.callId}`,
           stats
         );
@@ -2501,7 +2673,7 @@ var ObservedPeerConnection = class extends import_node_events.EventEmitter {
     let observedDataChannel = this.observedDataChannels.get(stats.id);
     if (!observedDataChannel) {
       if (!stats.timestamp || !stats.id) {
-        return logger.warn(
+        return logger3.warn(
           `ObservedPeerConnection received an invalid DataChannelStats (missing timestamp OR id field). PeerConnectionId: ${this.peerConnectionId} ClientId: ${this.client.clientId}, CallId: ${this.client.call.callId}`,
           stats
         );
@@ -2520,7 +2692,7 @@ var ObservedPeerConnection = class extends import_node_events.EventEmitter {
     let observedIceCandidate = this.observedIceCandidates.get(stats.id);
     if (!observedIceCandidate) {
       if (!stats.timestamp || !stats.id) {
-        return logger.warn(
+        return logger3.warn(
           `ObservedPeerConnection received an invalid IceCandidateStats (missing timestamp OR id field). PeerConnectionId: ${this.peerConnectionId} ClientId: ${this.client.clientId}, CallId: ${this.client.call.callId}`,
           stats
         );
@@ -2539,7 +2711,7 @@ var ObservedPeerConnection = class extends import_node_events.EventEmitter {
     let observedIceCandidatePair = this.observedIceCandidatesPair.get(stats.id);
     if (!observedIceCandidatePair) {
       if (!stats.timestamp || !stats.id) {
-        return logger.warn(
+        return logger3.warn(
           `ObservedPeerConnection received an invalid IceCandidateStats (missing timestamp OR id field). PeerConnectionId: ${this.peerConnectionId} ClientId: ${this.client.clientId}, CallId: ${this.client.call.callId}`,
           stats
         );
@@ -2558,7 +2730,7 @@ var ObservedPeerConnection = class extends import_node_events.EventEmitter {
     let observedIceTransport = this.observedIceTransports.get(stats.id);
     if (!observedIceTransport) {
       if (!stats.timestamp || !stats.id) {
-        return logger.warn(
+        return logger3.warn(
           `ObservedPeerConnection received an invalid IceCandidateStats (missing timestamp OR id field). PeerConnectionId: ${this.peerConnectionId} ClientId: ${this.client.clientId}, CallId: ${this.client.call.callId}`,
           stats
         );
@@ -2577,7 +2749,7 @@ var ObservedPeerConnection = class extends import_node_events.EventEmitter {
     let observedInboundRtp = this.observedInboundRtps.get(stats.ssrc);
     if (!observedInboundRtp) {
       if (!stats.timestamp || !stats.id || !stats.ssrc || !stats.kind || !stats.trackIdentifier) {
-        return logger.warn(
+        return logger3.warn(
           `ObservedPeerConnection received an invalid InboundRtpStats (missing timestamp OR id OR ssrc OR kind OR trackIdentifier field). PeerConnectionId: ${this.peerConnectionId} ClientId: ${this.client.clientId}, CallId: ${this.client.call.callId}`,
           stats
         );
@@ -2603,7 +2775,7 @@ var ObservedPeerConnection = class extends import_node_events.EventEmitter {
     let observedInboundTrack = this.observedInboundTracks.get(stats.id);
     if (!observedInboundTrack) {
       if (!stats.timestamp || !stats.id || !stats.kind) {
-        return logger.warn(
+        return logger3.warn(
           `ObservedPeerConnection received an invalid InboundTrackSample (missing timestamp OR id OR kind field). PeerConnectionId: ${this.peerConnectionId} ClientId: ${this.client.clientId}, CallId: ${this.client.call.callId}`,
           stats
         );
@@ -2631,7 +2803,7 @@ var ObservedPeerConnection = class extends import_node_events.EventEmitter {
     let observedMediaPlayout = this.observedMediaPlayouts.get(stats.id);
     if (!observedMediaPlayout) {
       if (!stats.timestamp || !stats.id || !stats.kind) {
-        return logger.warn(
+        return logger3.warn(
           `ObservedPeerConnection received an invalid InboundRtpStats (missing timestamp OR id OR kind OR trackIdentifier field). PeerConnectionId: ${this.peerConnectionId} ClientId: ${this.client.clientId}, CallId: ${this.client.call.callId}`,
           stats
         );
@@ -2655,7 +2827,7 @@ var ObservedPeerConnection = class extends import_node_events.EventEmitter {
     let observedMediaSource = this.observedMediaSources.get(stats.id);
     if (!observedMediaSource) {
       if (!stats.timestamp || !stats.id || !stats.kind) {
-        return logger.warn(
+        return logger3.warn(
           `ObservedPeerConnection received an invalid InboundRtpStats (missing timestamp OR id OR kind field). PeerConnectionId: ${this.peerConnectionId} ClientId: ${this.client.clientId}, CallId: ${this.client.call.callId}`,
           stats
         );
@@ -2679,7 +2851,7 @@ var ObservedPeerConnection = class extends import_node_events.EventEmitter {
     let observedOutboundRtp = this.observedOutboundRtps.get(stats.ssrc);
     if (!observedOutboundRtp) {
       if (!stats.timestamp || !stats.id || !stats.ssrc || !stats.kind) {
-        return logger.warn(
+        return logger3.warn(
           `ObservedPeerConnection received an invalid OutboundRtpStats (missing timestamp OR id OR ssrc OR kind field). PeerConnectionId: ${this.peerConnectionId} ClientId: ${this.client.clientId}, CallId: ${this.client.call.callId}`,
           stats
         );
@@ -2704,7 +2876,7 @@ var ObservedPeerConnection = class extends import_node_events.EventEmitter {
     let observedOutboundTrack = this.observedOutboundTracks.get(stats.id);
     if (!observedOutboundTrack) {
       if (!stats.timestamp || !stats.id || !stats.kind) {
-        return logger.warn(
+        return logger3.warn(
           `ObservedPeerConnection received an invalid OutboundTrackSample (missing timestamp OR id OR kind field). PeerConnectionId: ${this.peerConnectionId} ClientId: ${this.client.clientId}, CallId: ${this.client.call.callId}`,
           stats
         );
@@ -2732,7 +2904,7 @@ var ObservedPeerConnection = class extends import_node_events.EventEmitter {
     let observedPeerConnectionTransport = this.observedPeerConnectionTransports.get(stats.id);
     if (!observedPeerConnectionTransport) {
       if (!stats.timestamp || !stats.id) {
-        return logger.warn(
+        return logger3.warn(
           `ObservedPeerConnection received an invalid PeerConnectionTransportStats (missing timestamp OR id field). PeerConnectionId: ${this.peerConnectionId} ClientId: ${this.client.clientId}, CallId: ${this.client.call.callId}`,
           stats
         );
@@ -2751,7 +2923,7 @@ var ObservedPeerConnection = class extends import_node_events.EventEmitter {
     let observedRemoteInboundRtp = this.observedRemoteInboundRtps.get(stats.ssrc);
     if (!observedRemoteInboundRtp) {
       if (!stats.timestamp || !stats.id || !stats.ssrc || !stats.kind) {
-        return logger.warn(
+        return logger3.warn(
           `ObservedPeerConnection received an invalid RemoteInboundRtpStats (missing timestamp OR id OR ssrc OR kind field). PeerConnectionId: ${this.peerConnectionId} ClientId: ${this.client.clientId}, CallId: ${this.client.call.callId}`,
           stats
         );
@@ -2776,7 +2948,7 @@ var ObservedPeerConnection = class extends import_node_events.EventEmitter {
     let observedRemoteOutboundRtp = this.observedRemoteOutboundRtps.get(stats.ssrc);
     if (!observedRemoteOutboundRtp) {
       if (!stats.timestamp || !stats.id || !stats.ssrc || !stats.kind) {
-        return logger.warn(
+        return logger3.warn(
           `ObservedPeerConnection received an invalid RemoteOutboundRtpStats (missing timestamp OR id OR ssrc OR kind field). PeerConnectionId: ${this.peerConnectionId} ClientId: ${this.client.clientId}, CallId: ${this.client.call.callId}`,
           stats
         );
@@ -2876,35 +3048,27 @@ function baseIssueType(type) {
 }
 
 // src/ObservedClient.ts
-var logger2 = createLogger("ObservedClient");
+var logger4 = createLogger("ObservedClient");
 var RTT_HISTOGRAM_BUCKET_WIDTH_IN_MS = 20;
 var RTT_HISTOGRAM_NUMBER_OF_BUCKETS = 50;
 var SCORE_HISTOGRAM_BUCKET_WIDTH = 1;
 var SCORE_HISTOGRAM_NUMBER_OF_BUCKETS = 5;
-var ObservedClient = class extends import_node_events2.EventEmitter {
+var ObservedClient = class extends import_node_events3.EventEmitter {
   constructor(settings, call, activeIssues) {
     super();
     this.call = call;
     this.setMaxListeners(Infinity);
     this.eventScope = { observer: call.observer, observedCall: call, observedClient: this };
-    this.sink = call.observer.config.createClientSink?.({ clientId: settings.clientId, observedCall: call });
     this.clientId = settings.clientId;
     this.appData = settings.appData ?? {};
     this.settings = {
       closeClientIfIdleForMs: settings.closeClientIfIdleForMs
     };
-    if (this.sink) {
-      const onError = (err) => logger2.warn("ClientSampleSink error for client %s: %o", this.clientId, err);
-      this.sink.once("close", () => this.sink?.off("error", onError));
-      this.sink.on("error", onError);
-    }
     this.activeIssues = activeIssues;
   }
   call;
   clientId;
   observedPeerConnections = /* @__PURE__ */ new Map();
-  /** Per-client sink (from `ObserverConfig.createClientSink`), if any. */
-  sink;
   /** Ancestry base shared by all Observer-bus events originating at this client. */
   eventScope;
   calculatedScore = {
@@ -3043,6 +3207,13 @@ var ObservedClient = class extends import_node_events2.EventEmitter {
   _closedPeerConnectionIds = /* @__PURE__ */ new Set();
   closeTimer;
   /** The distinct `publicAddress`es currently known by this client's open peer connections. */
+  /**
+   * The sink this client's samples are written to: whatever is registered under its client id in
+   * `call.sinks` (the `createClientJsonlSink` file, or a sink the application added), if any.
+   */
+  get sink() {
+    return this.call.sinks.get(this.clientId);
+  }
   get publicAddresses() {
     const result = /* @__PURE__ */ new Set();
     for (const observedPeerConnection of this.observedPeerConnections.values()) {
@@ -3137,12 +3308,12 @@ var ObservedClient = class extends import_node_events2.EventEmitter {
     try {
       this.sink?.end();
     } catch (err) {
-      logger2.warn("ClientSampleSink.end failed for client %s: %o", this.clientId, err);
+      logger4.warn("Sink end failed for client %s: %o", this.clientId, err);
     }
   }
   accept(sample, context) {
     if (this.closed) {
-      logger2.warn("Attempted to accept a sample on a closed client %s", this.clientId);
+      logger4.warn("Attempted to accept a sample on a closed client %s", this.clientId);
       return;
     }
     if (this.closeTimer) {
@@ -3332,7 +3503,7 @@ var ObservedClient = class extends import_node_events2.EventEmitter {
     try {
       this.sink?.write(sample);
     } catch (err) {
-      logger2.warn("ClientSampleSink.write failed for client %s: %o", this.clientId, err);
+      logger4.warn("Sink write failed for client %s: %o", this.clientId, err);
     }
   }
   injectMetaData(metaData) {
@@ -3515,10 +3686,10 @@ var ObservedClient = class extends import_node_events2.EventEmitter {
             this._notify("client-rejoined", { ...this.eventScope, timestamp: event.timestamp });
           } else {
             this.joinedAt = event.timestamp;
-            logger2.warn(`Client ${this.clientId} joinedAt timestamp was updated to ${event.timestamp}. the joined event will not be emitted.`);
+            logger4.warn(`Client ${this.clientId} joinedAt timestamp was updated to ${event.timestamp}. the joined event will not be emitted.`);
           }
         }
-        logger2.debug("Client %s joined at %o", this.clientId, event);
+        logger4.debug("Client %s joined at %o", this.clientId, event);
         break;
       }
       case "CLIENT_LEFT" /* CLIENT_LEFT */: {
@@ -3528,10 +3699,10 @@ var ObservedClient = class extends import_node_events2.EventEmitter {
             this.emit("left");
             this._notify("client-left", { ...this.eventScope });
           } else {
-            logger2.warn(`Client ${this.clientId} leftAt timestamp was already set`);
+            logger4.warn(`Client ${this.clientId} leftAt timestamp was already set`);
           }
         }
-        logger2.debug("Client %s left at %o", this.clientId, event);
+        logger4.debug("Client %s left at %o", this.clientId, event);
         break;
       }
       case "PEER_CONNECTION_OPENED" /* PEER_CONNECTION_OPENED */: {
@@ -3543,7 +3714,7 @@ var ObservedClient = class extends import_node_events2.EventEmitter {
           } else if (postBuffer) {
             postBuffer.push(event);
           } else {
-            logger2.warn("Received PEER_CONNECTION_OPENED event without a corresponding observedPeerConnection: %o", event);
+            logger4.warn("Received PEER_CONNECTION_OPENED event without a corresponding observedPeerConnection: %o", event);
           }
         }
         break;
@@ -3560,7 +3731,7 @@ var ObservedClient = class extends import_node_events2.EventEmitter {
           } else if (postBuffer) {
             postBuffer.push(event);
           } else {
-            logger2.warn("Received PEER_CONNECTION_CLOSED event without a corresponding observedPeerConnection: %o", event);
+            logger4.warn("Received PEER_CONNECTION_CLOSED event without a corresponding observedPeerConnection: %o", event);
           }
         }
         break;
@@ -3575,7 +3746,7 @@ var ObservedClient = class extends import_node_events2.EventEmitter {
           } else if (postBuffer) {
             postBuffer.push(event);
           } else {
-            logger2.warn("Received MEDIA_TRACK_ADDED event without a corresponding observedPeerConnection or observedTrack: %o", event);
+            logger4.warn("Received MEDIA_TRACK_ADDED event without a corresponding observedPeerConnection or observedTrack: %o", event);
           }
         }
         break;
@@ -3590,7 +3761,7 @@ var ObservedClient = class extends import_node_events2.EventEmitter {
           } else if (postBuffer) {
             postBuffer.push(event);
           } else {
-            logger2.warn("Received MEDIA_TRACK_REMOVED event without a corresponding observedPeerConnection or observedTrack: %o", event);
+            logger4.warn("Received MEDIA_TRACK_REMOVED event without a corresponding observedPeerConnection or observedTrack: %o", event);
           }
         }
         break;
@@ -3605,7 +3776,7 @@ var ObservedClient = class extends import_node_events2.EventEmitter {
           } else if (postBuffer) {
             postBuffer.push(event);
           } else {
-            logger2.warn("Received DATA_CHANNEL_OPENED event without a corresponding observedPeerConnection or observedDataChannel: %o", event);
+            logger4.warn("Received DATA_CHANNEL_OPENED event without a corresponding observedPeerConnection or observedDataChannel: %o", event);
           }
         }
         break;
@@ -3620,7 +3791,7 @@ var ObservedClient = class extends import_node_events2.EventEmitter {
           } else if (postBuffer) {
             postBuffer.push(event);
           } else {
-            logger2.warn("Received DATA_CHANNEL_CLOSE event without a corresponding observedPeerConnection or observedDataChannel: %o", event);
+            logger4.warn("Received DATA_CHANNEL_CLOSE event without a corresponding observedPeerConnection or observedDataChannel: %o", event);
           }
         }
         break;
@@ -3640,7 +3811,7 @@ var ObservedClient = class extends import_node_events2.EventEmitter {
           } else if (postBuffer) {
             postBuffer.push(event);
           } else {
-            logger2.warn("Received MEDIA_TRACK_MUTED event without a corresponding observedPeerConnection or observedTrack: %o", event);
+            logger4.warn("Received MEDIA_TRACK_MUTED event without a corresponding observedPeerConnection or observedTrack: %o", event);
           }
         }
         break;
@@ -3660,7 +3831,7 @@ var ObservedClient = class extends import_node_events2.EventEmitter {
           } else if (postBuffer) {
             postBuffer.push(event);
           } else {
-            logger2.warn("Received MEDIA_TRACK_UNMUTED event without a corresponding observedPeerConnection or observedTrack: %o", event);
+            logger4.warn("Received MEDIA_TRACK_UNMUTED event without a corresponding observedPeerConnection or observedTrack: %o", event);
           }
         }
         break;
@@ -3675,7 +3846,7 @@ var ObservedClient = class extends import_node_events2.EventEmitter {
           } else if (postBuffer) {
             postBuffer.push(event);
           } else {
-            logger2.warn("Received ICE_CONNECTION_STATE_CHANGED event without a corresponding observedPeerConnection: %o", event);
+            logger4.warn("Received ICE_CONNECTION_STATE_CHANGED event without a corresponding observedPeerConnection: %o", event);
           }
         }
         break;
@@ -3690,7 +3861,7 @@ var ObservedClient = class extends import_node_events2.EventEmitter {
           } else if (postBuffer) {
             postBuffer.push(event);
           } else {
-            logger2.warn("Received ICE_GATHERING_STATE_CHANGED event without a corresponding observedPeerConnection: %o", event);
+            logger4.warn("Received ICE_GATHERING_STATE_CHANGED event without a corresponding observedPeerConnection: %o", event);
           }
         }
         break;
@@ -3705,7 +3876,7 @@ var ObservedClient = class extends import_node_events2.EventEmitter {
           } else if (postBuffer) {
             postBuffer.push(event);
           } else {
-            logger2.warn("Received PEER_CONNECTION_STATE_CHANGED event without a corresponding observedPeerConnection: %o", event);
+            logger4.warn("Received PEER_CONNECTION_STATE_CHANGED event without a corresponding observedPeerConnection: %o", event);
           }
         }
         break;
@@ -3724,11 +3895,11 @@ var ObservedClient = class extends import_node_events2.EventEmitter {
     let observedPeerConnection = this.observedPeerConnections.get(sample.peerConnectionId);
     if (!observedPeerConnection) {
       if (this._closedPeerConnectionIds.has(sample.peerConnectionId)) {
-        logger2.debug("Ignoring stats of peer connection %s, already closed by client %s", sample.peerConnectionId, this.clientId);
+        logger4.debug("Ignoring stats of peer connection %s, already closed by client %s", sample.peerConnectionId, this.clientId);
         return void 0;
       }
       if (!sample.peerConnectionId) {
-        return logger2.warn(
+        return logger4.warn(
           `ObservedClient received an invalid PeerConnectionSample (missing peerConnectionId field). ClientId: ${this.clientId}, CallId: ${this.call.callId}`,
           sample
         ), void 0;
@@ -3788,7 +3959,7 @@ var ObservedClient = class extends import_node_events2.EventEmitter {
     try {
       this.sink?.write(finalSample);
     } catch (err) {
-      logger2.warn("ClientSampleSink.write failed during injection flush for client %s: %o", this.clientId, err);
+      logger4.warn("Sink write failed during injection flush for client %s: %o", this.clientId, err);
     }
   }
   /** Emit an Observer-bus event scoped to this client (or a peer connection under it). */
@@ -3816,7 +3987,7 @@ var DefaultCallScoreCalculator = class {
 };
 
 // src/detectors/Detectors.ts
-var logger3 = createLogger("Detectors");
+var logger5 = createLogger("Detectors");
 var Detectors = class {
   _detectors;
   constructor(...detectors) {
@@ -3897,7 +4068,7 @@ var Detectors = class {
       try {
         detector.update();
       } catch (err) {
-        logger3.warn(`Error updating detector ${detector?.name}`, err);
+        logger5.warn(`Error updating detector ${detector?.name}`, err);
       }
     }
   }
@@ -3910,7 +4081,7 @@ var Detectors = class {
     try {
       detector.close?.();
     } catch (err) {
-      logger3.warn(`Error closing detector ${detector?.name}`, err);
+      logger5.warn(`Error closing detector ${detector?.name}`, err);
     }
   }
 };
@@ -4877,8 +5048,8 @@ var AudioEchoDetector = class _AudioEchoDetector {
 };
 
 // src/ObservedCall.ts
-var logger4 = createLogger("ObservedCall");
-var ObservedCall = class extends import_node_events3.EventEmitter {
+var logger6 = createLogger("ObservedCall");
+var ObservedCall = class extends import_node_events4.EventEmitter {
   constructor(settings, observer, activeIssuesRegistry) {
     super();
     this.observer = observer;
@@ -4886,6 +5057,8 @@ var ObservedCall = class extends import_node_events3.EventEmitter {
     this.setMaxListeners(Infinity);
     this.eventScope = { observer: this.observer, observedCall: this };
     this.callId = settings.callId;
+    this.sinks = new SinkRegistry(this.observer.sinks);
+    this.extensionStats = new ExtensionStatsRegistry(this.callId, this.sinks);
     this.appData = settings.appData ?? {};
     this.scoreCalculator = new DefaultCallScoreCalculator(this);
     this.detectors = new Detectors();
@@ -4942,6 +5115,8 @@ var ObservedCall = class extends import_node_events3.EventEmitter {
   settings;
   /** Ancestry base shared by all Observer-bus events originating at this call. */
   eventScope;
+  sinks;
+  extensionStats;
   closeTimer;
   get numberOfClients() {
     return this.observedClients.size;
@@ -4984,7 +5159,7 @@ var ObservedCall = class extends import_node_events3.EventEmitter {
         break;
       }
       default: {
-        logger4.warn("Unknown detector name %s; skipping", name);
+        logger6.warn("Unknown detector name %s; skipping", name);
         return this;
       }
     }
@@ -5054,6 +5229,8 @@ var ObservedCall = class extends import_node_events3.EventEmitter {
       if (client.joinedAt) minSampleTimestamps = Math.min(minSampleTimestamps ?? client.joinedAt, client.joinedAt);
       if (client.leftAt) maxSampleTimestamps = Math.max(maxSampleTimestamps ?? client.leftAt, client.leftAt);
     }
+    this.extensionStats.close();
+    this.sinks.clear();
     if (this.startedAt === void 0) this.startedAt = minSampleTimestamps;
     if (this.endedAt === void 0) this.endedAt = maxSampleTimestamps;
     this.closedAt = Date.now();
@@ -5066,17 +5243,26 @@ var ObservedCall = class extends import_node_events3.EventEmitter {
     this.emit("close");
     this._notify("call-closed", { ...this.eventScope });
   }
+  createExtensionStats(settings) {
+    return this.extensionStats.create(settings);
+  }
+  acceptExtensionStats(id, data) {
+    this.extensionStats.accept(id, data);
+  }
+  getExtensionStats(id) {
+    return this.extensionStats.get(id);
+  }
   getObservedClient(clientId) {
     if (this.closed || !this.observedClients.has(clientId)) return;
     return this.observedClients.get(clientId);
   }
   createObservedClient(settings, acceptCtx) {
     if (this.closed) {
-      logger4.warn("Attempted to create a client (clientId: %s) on a closed call %s", settings.clientId, this.callId);
+      logger6.warn("Attempted to create a client (clientId: %s) on a closed call %s", settings.clientId, this.callId);
       return void 0;
     }
     if (this.observedClients.has(settings.clientId)) {
-      logger4.warn("Client with id %s already exists in call %s; returning the existing instance", settings.clientId, this.callId);
+      logger6.warn("Client with id %s already exists in call %s; returning the existing instance", settings.clientId, this.callId);
       return this.observedClients.get(settings.clientId);
     }
     const clientSettings = {
@@ -5126,10 +5312,17 @@ var ObservedCall = class extends import_node_events3.EventEmitter {
       clearTimeout(this.closeTimer);
       this.closeTimer = void 0;
     }
+    const jsonlPath = this.observer.config.createClientJsonlSink?.({ observedCall: this, clientId: settings.clientId });
+    let jsonlSink;
+    if (jsonlPath !== void 0 && this.observer.sinks.get(settings.clientId)) {
+      logger6.warn("No sample file for client %s in call %s: sink id %s is already in use", settings.clientId, this.callId, settings.clientId);
+    } else if (jsonlPath !== void 0) {
+      jsonlSink = this.sinks.create(JsonlFileSink, { id: settings.clientId, path: jsonlPath });
+    }
     this.emit("newclient", result);
     this._notify("client-added", { ...this.eventScope, observedClient: result });
-    if (result.sink) {
-      this._notify("client-sink-created", { ...this.eventScope, observedClient: result, sink: result.sink });
+    if (jsonlSink) {
+      this._notify("client-sink-created", { ...this.eventScope, observedClient: result, sink: jsonlSink });
     }
     if (wasEmpty) {
       this.emit("not-empty");
@@ -5182,10 +5375,10 @@ var ObservedCall = class extends import_node_events3.EventEmitter {
 };
 
 // src/Observer.ts
-var import_node_events6 = require("events");
+var import_node_events7 = require("events");
 
 // src/ObservedTURN.ts
-var import_node_events4 = require("events");
+var import_node_events5 = require("events");
 
 // src/ObservedTurnServer.ts
 var ObservedTurnServer = class {
@@ -5245,8 +5438,8 @@ var ObservedTurnServer = class {
 };
 
 // src/ObservedTURN.ts
-var logger5 = createLogger("ObservedTURN");
-var ObservedTURN = class extends import_node_events4.EventEmitter {
+var logger7 = createLogger("ObservedTURN");
+var ObservedTURN = class extends import_node_events5.EventEmitter {
   totalBytesSent = 0;
   totalBytesReceived = 0;
   totalPacketsSent = 0;
@@ -5275,12 +5468,12 @@ var ObservedTURN = class extends import_node_events4.EventEmitter {
   addPeerConnection(peerConnection) {
     const turnPairs = peerConnection.selectedIceCandiadtePairForTurn;
     if (turnPairs.length !== 1) {
-      return logger5.warn(`Expected exactly one TURN pair, but found for peerconnection ${peerConnection.peerConnectionId}`, turnPairs.length), void 0;
+      return logger7.warn(`Expected exactly one TURN pair, but found for peerconnection ${peerConnection.peerConnectionId}`, turnPairs.length), void 0;
     }
     const candidatePair = turnPairs[0];
     const rawUrl = candidatePair.getLocalCandidate()?.url;
     if (!rawUrl) {
-      return logger5.warn(`No local candidate URL found for peerconnection ${peerConnection.peerConnectionId}`), void 0;
+      return logger7.warn(`No local candidate URL found for peerconnection ${peerConnection.peerConnectionId}`), void 0;
     }
     const turnServerUrl = rawUrl.split("?")[0];
     let turnServer = this.servers.get(turnServerUrl);
@@ -5356,14 +5549,16 @@ var MiddlewareProcessor = class {
 };
 
 // src/ObservedMediasoupRouter.ts
-var import_node_events5 = require("events");
-var logger6 = createLogger("ObservedMediasoupRouter");
-var ObservedMediasoupRouter = class extends import_node_events5.EventEmitter {
+var import_node_events6 = require("events");
+var logger8 = createLogger("ObservedMediasoupRouter");
+var ObservedMediasoupRouter = class extends import_node_events6.EventEmitter {
   router;
   appData;
   sample;
   webrtcTransportIds = /* @__PURE__ */ new Set();
   closed = false;
+  sinks;
+  extensionStats;
   // Id -> sample indexes over the arrays in `this.sample`, so an entity can be reached in O(1)
   // instead of scanning (`sample.producers.find(...)`). They hold the *same* objects as the arrays.
   _transportSamples = /* @__PURE__ */ new Map();
@@ -5372,11 +5567,17 @@ var ObservedMediasoupRouter = class extends import_node_events5.EventEmitter {
   _dataProducerSamples = /* @__PURE__ */ new Map();
   _dataConsumerSamples = /* @__PURE__ */ new Map();
   _enrich;
-  constructor(settings) {
+  /**
+   * @param parentSinks the parent of `sinks`: `observer.sinks`, passed by
+   * `Observer.createObservedMediasoupRouter`. Internal; a router constructed directly has none.
+   */
+  constructor(settings, parentSinks) {
     super();
     this.router = settings.router;
     this.appData = settings.appData ?? {};
     this._enrich = settings.enrich;
+    this.sinks = new SinkRegistry(parentSinks);
+    this.extensionStats = new ExtensionStatsRegistry(this.router.id, this.sinks);
     this.sample = {
       routerId: this.router.id,
       attachments: settings.attachments ?? {},
@@ -5445,8 +5646,19 @@ var ObservedMediasoupRouter = class extends import_node_events5.EventEmitter {
     if (this.closed) return;
     this.closed = true;
     if (this.sample.closedAt === void 0) this.sample.closedAt = Date.now();
+    this.extensionStats.close();
+    this.sinks.clear();
     this.emit("close");
   }
+  createExtensionStats(settings) {
+    return this.extensionStats.create(settings);
+  }
+  acceptExtensionStats(id, data) {
+    this.extensionStats.accept(id, data);
+  }
+  getExtensionStats(id) {
+    return this.extensionStats.get(id);
+  }
   addTransport = (transport) => {
     let transportType = transport.type;
     if (!transportType) {
@@ -5455,7 +5667,7 @@ var ObservedMediasoupRouter = class extends import_node_events5.EventEmitter {
       else if (transport.constructor.name === "PipeTransport") transportType = "pipe";
       else if (transport.constructor.name === "DirectTransport") transportType = "direct";
     }
-    if (!transportType) return logger6.warn(`Unknown transport type for transport ${transport.id}: ${transport.constructor.name}`);
+    if (!transportType) return logger8.warn(`Unknown transport type for transport ${transport.id}: ${transport.constructor.name}`);
     switch (transportType) {
       case "webrtc":
         return this.addWebRtcTransport(transport);
@@ -5466,7 +5678,7 @@ var ObservedMediasoupRouter = class extends import_node_events5.EventEmitter {
       case "direct":
         return this.addDirectTransport(transport);
       default:
-        return logger6.warn(`Unsupported transport type for transport ${transport.id}: ${transportType}`);
+        return logger8.warn(`Unsupported transport type for transport ${transport.id}: ${transportType}`);
     }
   };
   addWebRtcTransport(transport) {
@@ -5708,7 +5920,7 @@ var ObservedMediasoupRouter = class extends import_node_events5.EventEmitter {
       const attachments = enrich();
       if (attachments) sample.attachments = { ...sample.attachments, ...attachments };
     } catch (err) {
-      logger6.warn("Mediasoup sample enricher threw for router %s: %o", this.id, err);
+      logger8.warn("Mediasoup sample enricher threw for router %s: %o", this.id, err);
     }
   }
   _attachTransportObserverListeners(transport, transportSample, onClose) {
@@ -5733,7 +5945,7 @@ var ObservedMediasoupRouter = class extends import_node_events5.EventEmitter {
 };
 
 // src/issues/ActiveIssuesRegistry.ts
-var logger7 = createLogger("ActiveIssuesRegistry");
+var logger9 = createLogger("ActiveIssuesRegistry");
 var ActiveIssuesRegistry = class {
   constructor(parent) {
     this.parent = parent;
@@ -5819,7 +6031,7 @@ var ActiveIssuesRegistry = class {
     try {
       apply(target);
     } catch (err) {
-      logger7.warn("An issue tracker threw while being notified; continuing with the rest. %o", err);
+      logger9.warn("An issue tracker threw while being notified; continuing with the rest. %o", err);
     }
   }
 };
@@ -5848,7 +6060,7 @@ function createCallSummary(callId, config) {
 }
 
 // src/summaries/CallSummaryCollector.ts
-var logger8 = createLogger("CallSummaryCollector");
+var logger10 = createLogger("CallSummaryCollector");
 var CallSummaryCollector = class {
   constructor(_observer, _config) {
     this._observer = _observer;
@@ -5923,7 +6135,7 @@ var CallSummaryCollector = class {
       try {
         handler(summary, scratch, ...args);
       } catch (err) {
-        logger8.warn("A call-summary handler for %s threw; continuing. %o", event, err);
+        logger10.warn("A call-summary handler for %s threw; continuing. %o", event, err);
       }
     };
     this._observer.on(event, listener);
@@ -6348,7 +6560,7 @@ function geohash(location, precision = 3) {
 }
 
 // src/detectors/ClientPopulationIssueDetector.ts
-var logger9 = createLogger("ClientPopulationIssueDetector");
+var logger11 = createLogger("ClientPopulationIssueDetector");
 var ClientPopulationIssueTypes = {
   /** One issue type is concentrated on one client population while the rest of the fleet is fine. */
   clientPopulationIssue: "CLIENT_POPULATION_ISSUE"
@@ -6370,7 +6582,7 @@ var ClientPopulationIssueDetector = class _ClientPopulationIssueDetector {
       ...config
     };
     if (this._config.groupBy === "location" && !this._config.resolveClientLocation) {
-      logger9.warn(
+      logger11.warn(
         "%s is configured with groupBy: 'location' but no resolveClientLocation, so no client can be placed and nothing will ever be detected",
         this.name
       );
@@ -7204,11 +7416,13 @@ function mediaKindOf(mimeType) {
 }
 
 // src/Observer.ts
-var logger10 = createLogger("Observer");
-var Observer = class extends import_node_events6.EventEmitter {
+var logger12 = createLogger("Observer");
+var Observer = class extends import_node_events7.EventEmitter {
   observedTURN = new ObservedTURN();
   observedCalls = /* @__PURE__ */ new Map();
   observedMediasoupRouters = /* @__PURE__ */ new Map();
+  sinks = new SinkRegistry();
+  extensionStats = new ExtensionStatsRegistry("observer", this.sinks);
   /** Ancestry base shared by all Observer-bus events originating at the observer. */
   eventScope = { observer: this };
   config;
@@ -7323,7 +7537,7 @@ var Observer = class extends import_node_events6.EventEmitter {
         break;
       }
       default: {
-        logger10.warn("Unknown detector name %s; skipping", name);
+        logger12.warn("Unknown detector name %s; skipping", name);
         return this;
       }
     }
@@ -7408,7 +7622,7 @@ var Observer = class extends import_node_events6.EventEmitter {
         break;
     }
     if (!validator) {
-      logger10.warn("Unknown validator name %s; skipping", name);
+      logger12.warn("Unknown validator name %s; skipping", name);
       return this;
     }
     this.validators.add(validator);
@@ -7439,7 +7653,7 @@ var Observer = class extends import_node_events6.EventEmitter {
       try {
         validator.cancel(reason);
       } catch (err) {
-        logger10.warn("Error cancelling validator %s: %o", validator.name, err);
+        logger12.warn("Error cancelling validator %s: %o", validator.name, err);
       }
     }
     return matching.length;
@@ -7455,11 +7669,11 @@ var Observer = class extends import_node_events6.EventEmitter {
    */
   createObservedCall(settings, acceptCtx) {
     if (this.closed) {
-      logger10.warn("Attempted to create a call (callId: %s) on a closed observer", settings.callId);
+      logger12.warn("Attempted to create a call (callId: %s) on a closed observer", settings.callId);
       return void 0;
     }
     if (this.observedCalls.has(settings.callId)) {
-      logger10.warn("Observed Call with id %s already exists; returning the existing instance", settings.callId);
+      logger12.warn("Observed Call with id %s already exists; returning the existing instance", settings.callId);
       return this.observedCalls.get(settings.callId);
     }
     const callSettings = {
@@ -7497,14 +7711,14 @@ var Observer = class extends import_node_events6.EventEmitter {
   }
   createObservedMediasoupRouter(settings) {
     if (this.closed) {
-      logger10.warn("Attempted to create mediasoup router (id: %d) on a closed observer", settings.router.id);
+      logger12.warn("Attempted to create mediasoup router (id: %d) on a closed observer", settings.router.id);
       return void 0;
     }
     if (this.observedMediasoupRouters.has(settings.router.id)) {
-      logger10.warn("Observed Mediasoup Router (id %s) already exists; returning the existing instance", settings.router.id);
+      logger12.warn("Observed Mediasoup Router (id %s) already exists; returning the existing instance", settings.router.id);
       return this.observedMediasoupRouters.get(settings.router.id);
     }
-    const observedMediasoupRouter = new ObservedMediasoupRouter(settings);
+    const observedMediasoupRouter = new ObservedMediasoupRouter(settings, this.sinks);
     const observedMediasoupRouterScope = {
       observedMediasoupRouter,
       observer: this
@@ -7532,7 +7746,7 @@ var Observer = class extends import_node_events6.EventEmitter {
   }
   close() {
     if (this.closed) {
-      return logger10.debug("Attempted to close twice");
+      return logger12.debug("Attempted to close twice");
     }
     this.closed = true;
     for (const call of [...this.observedCalls.values()]) call.close();
@@ -7541,8 +7755,19 @@ var Observer = class extends import_node_events6.EventEmitter {
     this.validators.clear();
     this.callSummaryCollector?.close();
     this.activeIssuesRegistry.clear();
+    this.extensionStats.close();
+    this.sinks.clear();
     this._notify("observer-closed", { ...this.eventScope });
   }
+  createExtensionStats(settings) {
+    return this.extensionStats.create(settings);
+  }
+  acceptExtensionStats(id, data) {
+    this.extensionStats.accept(id, data);
+  }
+  getExtensionStats(id) {
+    return this.extensionStats.get(id);
+  }
   accept(sample, context) {
     if (this.closed) {
       return this._notify("sample-rejected", { ...this.eventScope, reason: "observer-closed", sample });
@@ -7550,7 +7775,7 @@ var Observer = class extends import_node_events6.EventEmitter {
     try {
       this.acceptMiddlewares.process({ sample, context });
     } catch (err) {
-      logger10.warn("An accept middleware threw; dropping the sample. %o", err);
+      logger12.warn("An accept middleware threw; dropping the sample. %o", err);
     }
     if (!sample.callId) {
       this._notify("sample-rejected", { ...this.eventScope, reason: "missing-callId", sample });
@@ -7590,7 +7815,7 @@ var Observer = class extends import_node_events6.EventEmitter {
       try {
         validator.update();
       } catch (err) {
-        logger10.warn("Error running validator %s: %o", validator.name, err);
+        logger12.warn("Error running validator %s: %o", validator.name, err);
       }
     }
     this._notify("observer-updated", { ...this.eventScope });
@@ -7826,67 +8051,34 @@ var TrendTester = class {
   }
 };
 
-// src/sinks/ClientSampleSink.ts
-var import_node_events7 = require("events");
-var ClientSampleSink = class extends import_node_events7.EventEmitter {
-};
-
-// src/sinks/JsonlFileSink.ts
-var fs = __toESM(require("fs"));
-var path = __toESM(require("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.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"));
-    this._stream.on("error", (err) => this.emit("error", err));
-    this._serializeSample = options.serializeSample ?? ((sample) => JSON.stringify(sample));
-  }
-  write(sample) {
-    return this._stream.write(`${this._serializeSample(sample)}
-`);
-  }
-  end() {
-    this._stream.end();
-  }
-};
-function createJsonlFileSink(options) {
-  return new JsonlFileSink(options);
-}
-function createJsonlFileSinkFactory(options) {
-  return ({ clientId, observedCall }) => {
-    const filename = options.getFileName?.({ callId: observedCall.callId, clientId }) ?? `${observedCall.callId}__${clientId}.jsonl`;
-    return createJsonlFileSink({
-      path: path.join(options.directory, filename),
-      serializeSample: options.serializeSample
-    });
-  };
-}
-
 // src/sinks/InMemorySink.ts
-var InMemorySink = class extends ClientSampleSink {
-  constructor(samples = []) {
+var import_node_events8 = require("events");
+var InMemorySink = class extends import_node_events8.EventEmitter {
+  id;
+  samples;
+  _ended = false;
+  constructor(settings = {}) {
     super();
-    this.samples = samples;
+    this.id = settings.id ?? "in-memory";
+    this.samples = settings.samples ?? [];
+  }
+  get ended() {
+    return this._ended;
   }
-  samples;
   write(sample) {
+    if (this._ended) return false;
     this.samples.push(sample);
     return true;
   }
   end() {
+    if (this._ended) return;
+    this._ended = true;
+    this.emit("ended");
     this.emit("close");
   }
 };
 function createInMemorySink(samples) {
-  return new InMemorySink(samples);
+  return new InMemorySink({ samples });
 }
 
 // src/resolvers/RemoteTrackResolver.ts
@@ -8075,9 +8267,9 @@ function createP2pRemoteTrackResolverFactory() {
   ClientMetaTypes,
   ClientPopulationIssueDetector,
   ClientPopulationIssueTypes,
-  ClientSampleSink,
   CodecConsistencyValidator,
   Detectors,
+  ExtensionStatsRegistry,
   GEOHASH_CELL_SIZES,
   InMemorySink,
   IssueFanOutDetector,
@@ -8121,6 +8313,7 @@ function createP2pRemoteTrackResolverFactory() {
   SCORE_HISTOGRAM_NUMBER_OF_BUCKETS,
   SfuCongestionDetector,
   SimulcastReceiverValidator,
+  SinkRegistry,
   SlidingWindow,
   TrackDeliveryMismatchDetector,
   TrackDeliveryMismatchTypes,
@@ -8141,7 +8334,6 @@ function createP2pRemoteTrackResolverFactory() {
   createDefaultMediasoupRemoteTrackResolverFactory,
   createInMemorySink,
   createJsonlFileSink,
-  createJsonlFileSinkFactory,
   createLogger,
   createP2pRemoteTrackResolverFactory,
   defaultCallSummaryConfig,