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

package/dist/index.d.ts

@@ -1,6 +1,128 @@
 import { EventEmitter } from 'node:events';
 import { types } from 'mediasoup';
 
+/** The lifecycle events a sink emits. */
+type SinkEvents = {
+    /**
+     * `end()` was called: the sink accepts no more writes. **Required**: a sink emits it
+     * synchronously, once, from `end()` — it is how its registry removes it and frees its id.
+     */
+    ended: [];
+    /** The destination is fully written and closed (e.g. a file flushed and its fd closed). */
+    close: [];
+    /** The destination failed. */
+    error: [Error];
+    /** All queued data was flushed (before `close`). */
+    finish: [];
+    /** The buffer drained after backpressure; safe to write more. */
+    drain: [];
+};
+/** What a registry passes to a sink's constructor. Implementations extend it with their own settings. */
+type SinkSettings = {
+    /** Unique per observer. The registry generates one (uuid v4) when it is omitted. */
+    id: string;
+};
+/**
+ * A destination for records. It is **object-mode** and agnostic about what passes through it:
+ * `write` receives the record itself, and the implementation decides how to serialize it (JSON
+ * line, protobuf, a remote payload, …). `JsonlFileSink` and `InMemorySink` are the built-in
+ * implementations; `ClientSampleSink` is `Sink<ClientSample>`.
+ *
+ * Create sinks with a registry's `create(SinkClass, settings)`, which constructs
+ * `new SinkClass({ ...settings, id })` and registers it on the object that owns its lifecycle.
+ * `end()` closes a sink and — through the `ended` event — removes it from its registry; the owner
+ * ends whatever is left when it closes.
+ *
+ * An implementation typically `extends EventEmitter implements Sink<T>`, and must:
+ * - emit `ended` synchronously, once, from `end()` (and make a second `end()` a no-op);
+ * - refuse writes after `end()` (return `false`);
+ * - emit `close` when the destination is ready, and `error` when it fails.
+ */
+interface Sink<T = unknown> {
+    readonly id: string;
+    /** Accept one record. `false` once ended (nothing written), or on backpressure. */
+    write(record: T): boolean;
+    /** No more writes; emit `ended`, then flush and emit `close`. Idempotent. */
+    end(): void;
+    on(event: keyof SinkEvents, listener: (...args: any[]) => void): this;
+    once(event: keyof SinkEvents, listener: (...args: any[]) => void): this;
+    off(event: keyof SinkEvents, listener: (...args: any[]) => void): this;
+}
+
+/** A sink class `SinkRegistry.create` can construct: its constructor takes one settings object (with `id`). */
+type SinkConstructor = new (settings: any) => Sink<any>;
+/** The settings `create` takes for `SinkClass`: its constructor's, with `id` optional. */
+type SinkCreateSettings<C extends SinkConstructor> = Omit<ConstructorParameters<C>[0], 'id'> & {
+    id?: string;
+};
+/**
+ * The sinks of one object, ended by that object's lifecycle. `create(SinkClass, settings)` builds a
+ * sink and registers it; `sink.end()` closes it and removes it; the owner calls `clear()` when it
+ * closes, ending whatever is left.
+ *
+ * Registries form a tree like the issue registries: `observer.sinks` is the parent of every
+ * `observedCall.sinks` and `observedMediasoupRouter.sinks`. **A sink id is unique per observer**:
+ * `create` refuses an id that any registry of the tree holds. Each registry sees its own sinks and
+ * its descendants', so `get`, `write` and `clear` on a parent reach a child's sinks too.
+ *
+ * A client's sample sink is the one under its client id in its call's registry.
+ */
+declare class SinkRegistry {
+    readonly parent?: SinkRegistry | undefined;
+    private readonly _sinks;
+    constructor(parent?: SinkRegistry | undefined);
+    /** Number of open sinks in this registry and its descendants. */
+    get size(): number;
+    keys(): IterableIterator<string>;
+    values(): IterableIterator<Sink<any>>;
+    get<T extends Sink<any> = Sink>(id: string): T | undefined;
+    /**
+     * 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<C extends SinkConstructor>(SinkClass: C, settings: SinkCreateSettings<C>): InstanceType<C> | undefined;
+    /** Write `record` to the sink `id`. `false` when there is no such sink, or on backpressure. */
+    write(id: string, record: unknown): boolean;
+    /** End every sink of this registry and of its descendants. */
+    clear(): void;
+    /** This registry and its ancestors, up to the root. */
+    private _lineage;
+}
+
+/** The settings of `createExtensionStats` on an observer, a call or a mediasoup router. */
+type CreateExtensionStatsSettings<C extends SinkConstructor> = {
+    /** Unique per observer: it is also the id of the sink that receives the stats. */
+    id: string;
+    /** What `sinks.create` takes; the sink is created under `id` (an `id` in its settings is ignored). */
+    createSink?: [SinkClass: C, settings: Omit<SinkCreateSettings<C>, 'id'>];
+};
+/**
+ * The extension stats of one object — `observer.extensionStats`, `observedCall.extensionStats`,
+ * `observedMediasoupRouter.extensionStats`: the last data per id (`values`), written to the
+ * object's sink with the same id. The owner closes it when it closes.
+ */
+declare class ExtensionStatsRegistry {
+    /** The owner's id (call id, router id, or `observer`), used in log messages. */
+    readonly id: string;
+    private readonly _sinks;
+    /** The last data accepted for each extension stats id. */
+    readonly values: Map<string, unknown>;
+    closed: boolean;
+    constructor(
+    /** The owner's id (call id, router id, or `observer`), used in log messages. */
+    id: string, _sinks: SinkRegistry);
+    /**
+     * 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(): void;
+    create<C extends SinkConstructor>(settings: CreateExtensionStatsSettings<C>): InstanceType<C> | undefined;
+    accept(id: string, data: unknown): void;
+    get<T>(id: string): T | undefined;
+}
+
 declare const schemaVersion = "3.7.0";
 /**
 * The WebRTC app provided custom stats payload
@@ -1947,7 +2069,9 @@ declare function mannKendallVerdict(s: number, variance: number, alpha?: number)
  * holds the values in `[i * bucketWidth, (i + 1) * bucketWidth)`. Interpolates linearly inside
  * the bucket the rank falls in, so the error is at most one bucket width. With `openEnded`, the
  * last bucket holds every value above its lower bound, and a percentile falling in it is reported
- * as `max`. The estimate is clamped to `[min, max]` when given. `undefined` for an empty histogram.
+ * as `max`. With `min`/`max` (the observed extremes), the bucket holding them is narrowed to the
+ * observed range before interpolating, so the estimate never leaves `[min, max]`. `undefined` for an
+ * empty histogram.
  */
 declare function percentileOfHistogram(histogram: readonly number[], bucketWidth: number, p: number, options?: {
     min?: number;
@@ -3023,52 +3147,38 @@ declare function isClientIssueResolutionEntry(issue: ClientIssue): boolean;
 /** Strip the `-resolved` suffix, so both entries of a lifecycle share one logical type. */
 declare function baseIssueType(type: string): string;
 
-/** The lifecycle events a sink may emit (a subset of Node's writable-stream events). */
-type ClientSampleSinkEvents = {
-    /** The destination is fully written and closed (e.g. a file flushed and its fd closed). */
-    close: [];
-    /** The destination failed. */
-    error: [Error];
-    /** `end()` was processed and all queued data was flushed (before `close`). */
-    finish: [];
-    /** The buffer drained after backpressure; safe to write more. */
-    drain: [];
+type JsonlFileSinkOptions<T = ClientSample> = Partial<SinkSettings> & {
+    /** Absolute or relative file path to append JSONL lines to. */
+    path: string;
+    /** Optional custom serializer; defaults to `JSON.stringify`. */
+    serializeSample?: (record: T) => string;
 };
-declare interface ClientSampleSink {
-    on<E extends keyof ClientSampleSinkEvents>(event: E, listener: (...args: ClientSampleSinkEvents[E]) => void): this;
-    once<E extends keyof ClientSampleSinkEvents>(event: E, listener: (...args: ClientSampleSinkEvents[E]) => void): this;
-    off<E extends keyof ClientSampleSinkEvents>(event: E, listener: (...args: ClientSampleSinkEvents[E]) => void): this;
-    emit<E extends keyof ClientSampleSinkEvents>(event: E, ...args: ClientSampleSinkEvents[E]): boolean;
-}
 /**
- * A per-client destination for accepted samples — a typed `EventEmitter` base class. One sink is
- * created per `ObservedClient` (via `ObserverConfig.createClientSink`). It is **object-mode**:
- * `write` receives the `ClientSample` itself, so each sink decides how to serialize it (JSON
- * line, protobuf, msgpack, a remote payload, …).
- *
- * The library calls `write(sample)` synchronously per accepted sample (not awaited), `end()`s the
- * sink when the client closes, and attaches an `error` listener so a failing sink can't crash the
- * process. The application — which created the sink — listens for `close` (destination ready,
- * e.g. a file flushed and its fd closed) and `error`.
- *
- * Subclass this and implement `write`/`end` (and `emit` your lifecycle events). Built-in sinks
- * (`JsonlFileSink`, `InMemorySink`) and their factories are exported from the package root.
+ * A sink that serializes each record to a JSON line and appends it to a file. Defaults to client
+ * samples, but takes any record type: `sinks.create(JsonlFileSink<PipeTransportStats[]>, { id, path })`. It wraps an
+ * `fs.WriteStream` and re-emits its lifecycle events, so `close` fires once the file is flushed
+ * and its descriptor is closed (file ready) and `error` surfaces file errors.
  */
-declare abstract class ClientSampleSink extends EventEmitter {
-    /** Accept one sample; the sink serializes it however it likes. `false` signals backpressure. */
-    abstract write(sample: ClientSample): boolean;
-    /** Finish writing; the sink flushes and (if applicable) emits `close`. */
-    abstract end(): void;
+declare interface JsonlFileSink {
+    on<E extends keyof SinkEvents>(event: E, listener: (...args: SinkEvents[E]) => void): this;
+    once<E extends keyof SinkEvents>(event: E, listener: (...args: SinkEvents[E]) => void): this;
+    off<E extends keyof SinkEvents>(event: E, listener: (...args: SinkEvents[E]) => void): this;
+    emit<E extends keyof SinkEvents>(event: E, ...args: SinkEvents[E]): boolean;
 }
-/**
- * Produces a sink for a newly-created client, or `undefined` for no sink. Receives the
- * client id and its (already-created) parent call, so the destination can be derived
- * from `callId` / `clientId`.
- */
-type ClientSampleSinkFactory = (params: {
-    clientId: string;
-    observedCall: ObservedCall;
-}) => ClientSampleSink | undefined;
+declare class JsonlFileSink<T = ClientSample> extends EventEmitter implements Sink<T> {
+    readonly id: string;
+    /** The file this sink writes to. Read it (e.g. in a `close` handler) to upload/move the file. */
+    readonly path: string;
+    private readonly _stream;
+    private readonly _serializeSample;
+    private _ended;
+    constructor(options: JsonlFileSinkOptions<T>);
+    get ended(): boolean;
+    write(record: T): boolean;
+    end(): void;
+}
+/** Build a JSONL file sink for a single path. */
+declare function createJsonlFileSink<T = ClientSample>(options: JsonlFileSinkOptions<T>): JsonlFileSink<T>;
 
 /** mediasoup `TransportTuple` (the selected local/remote address pair of a transport). */
 type TransportTuple = {
@@ -3320,13 +3430,19 @@ declare class ObservedMediasoupRouter<AppData extends Record<string, unknown> =
     readonly sample: MediasoupRouterSample;
     readonly webrtcTransportIds: Set<string>;
     closed: boolean;
+    readonly sinks: SinkRegistry;
+    readonly extensionStats: ExtensionStatsRegistry;
     private readonly _transportSamples;
     private readonly _producerSamples;
     private readonly _consumerSamples;
     private readonly _dataProducerSamples;
     private readonly _dataConsumerSamples;
     private readonly _enrich?;
-    constructor(settings: ObservedMediasoupRouterSettings<AppData>);
+    /**
+     * @param parentSinks the parent of `sinks`: `observer.sinks`, passed by
+     * `Observer.createObservedMediasoupRouter`. Internal; a router constructed directly has none.
+     */
+    constructor(settings: ObservedMediasoupRouterSettings<AppData>, parentSinks?: SinkRegistry);
     get id(): string;
     get attachments(): Record<string, unknown>;
     getTransportSample(id: string): MediasoupTransportSample | undefined;
@@ -3351,6 +3467,9 @@ declare class ObservedMediasoupRouter<AppData extends Record<string, unknown> =
      */
     snapshot(): MediasoupRouterSample;
     close(): void;
+    createExtensionStats<C extends SinkConstructor>(settings: CreateExtensionStatsSettings<C>): InstanceType<C> | undefined;
+    acceptExtensionStats(id: string, data: unknown): void;
+    getExtensionStats<T>(id: string): T | undefined;
     addTransport: (transport: types.Transport) => void;
     addWebRtcTransport(transport: types.WebRtcTransport): void;
     addPlainTransport(transport: types.PlainTransport): void;
@@ -3446,7 +3565,7 @@ type ObserverEvents = {
     }];
     'client-added': [ObservedClientScope];
     'client-sink-created': [ObservedClientScope & {
-        sink: ClientSampleSink;
+        sink: JsonlFileSink;
     }];
     'client-updated': [ObservedClientScope & {
         sample: ClientSample;
@@ -3755,8 +3874,6 @@ declare class ObservedClient<AppData extends Record<string, unknown> = Record<st
     readonly call: ObservedCall;
     readonly clientId: string;
     readonly observedPeerConnections: Map<string, ObservedPeerConnection>;
-    /** Per-client sink (from `ObserverConfig.createClientSink`), if any. */
-    readonly sink?: ClientSampleSink;
     /** Ancestry base shared by all Observer-bus events originating at this client. */
     readonly eventScope: ObservedClientScope;
     readonly calculatedScore: CalculatedScore;
@@ -3886,6 +4003,11 @@ declare class ObservedClient<AppData extends Record<string, unknown> = Record<st
     private closeTimer?;
     constructor(settings: ObservedClientSettings<AppData>, call: ObservedCall, activeIssues: ObservedClientIssueRegistry);
     /** 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(): Sink<ClientSample> | undefined;
     get publicAddresses(): string[];
     get numberOfPeerConnections(): number;
     get score(): number | undefined;
@@ -5698,6 +5820,8 @@ declare class ObservedCall<AppData extends Record<string, unknown> = Record<stri
     readonly settings: Pick<ObservedCallSettings, 'closeCallIfEmptyForMs' | 'autoUpdateOnClientUpdate'>;
     /** Ancestry base shared by all Observer-bus events originating at this call. */
     readonly eventScope: ObservedCallScope;
+    readonly sinks: SinkRegistry;
+    readonly extensionStats: ExtensionStatsRegistry;
     private closeTimer?;
     constructor(settings: ObservedCallSettings<AppData>, observer: Observer, activeIssuesRegistry: ActiveIssuesRegistry);
     get numberOfClients(): number;
@@ -5750,6 +5874,9 @@ declare class ObservedCall<AppData extends Record<string, unknown> = Record<stri
      */
     addIssue(issue: Omit<CallIssue, 'scope'>): void;
     close(): void;
+    createExtensionStats<C extends SinkConstructor>(settings: CreateExtensionStatsSettings<C>): InstanceType<C> | undefined;
+    acceptExtensionStats(id: string, data: unknown): void;
+    getExtensionStats<T>(id: string): T | undefined;
     getObservedClient<ClientAppData extends Record<string, unknown> = Record<string, unknown>>(clientId: string): ObservedClient<ClientAppData> | undefined;
     createObservedClient<ClientAppData extends Record<string, unknown> = Record<string, unknown>>(settings: ObservedClientSettings<ClientAppData>, acceptCtx?: AcceptContext): ObservedClient<ClientAppData> | undefined;
     getOrCreateObservedClient<ClientAppData extends Record<string, unknown> = Record<string, unknown>>(settings: ObservedClientSettings<ClientAppData>, acceptCtx?: AcceptContext): ObservedClient<ClientAppData> | undefined;
@@ -6471,11 +6598,38 @@ type ObserverConfig<AppData extends Record<string, unknown> = Record<string, unk
     /** Same as `createCallAppData`, for clients. Receives the (already-created) parent call. */
     createClientAppData?: ClientAppDataFactory;
     /**
-     * Optional factory invoked when a client is created, producing a per-client sink that
-     * receives every sample the client accepts (or `undefined` for no sink). The destination
-     * can be derived from `callId` / `clientId`.
+     * Write every sample a client accepts to a JSONL file: return the file path for a newly-created
+     * client, or `undefined` for no file. The directory must exist. The `JsonlFileSink` is added to
+     * `observedCall.sinks` under the client id and is ended when the client closes; `client-sink-created`
+     * announces it, so a `close` handler can upload or move the file once it is flushed.
+     *
+     * For any other destination, add your own sink under the client id instead, e.g. on
+     * `client-added`: `observedCall.sinks.create(MySink, { id: observedClient.clientId, ... })`.
+     *
+     * Replaces `createClientSink` (removed in 1.3.0), and with it `createJsonlFileSinkFactory`.
+     * To migrate:
+     *
+     * ```ts
+     * // before (1.2): JSONL files
+     * new Observer({ createClientSink: createJsonlFileSinkFactory({ directory: './stats' }) });
+     * // after: return the path; `${callId}__${clientId}.jsonl` was the factory's default file name
+     * new Observer({
+     *   createClientJsonlSink: ({ observedCall, clientId }) => path.join('./stats', `${observedCall.callId}__${clientId}.jsonl`),
+     * });
+     *
+     * // before (1.2): any other sink
+     * new Observer({ createClientSink: ({ clientId, observedCall }) => new HttpSink(url(observedCall, clientId)) });
+     * // after: create it under the client id when the client is added (HttpSink implements
+     * // `ClientSampleSink`, takes `SinkSettings & { ... }` and emits `ended` from `end()`)
+     * observer.on('client-added', ({ observedCall, observedClient }) => {
+     *   observedCall.sinks.create(HttpSink, { id: observedClient.clientId, url: url(observedCall, observedClient.clientId) });
+     * });
+     * ```
      */
-    createClientSink?: ClientSampleSinkFactory;
+    createClientJsonlSink?: (params: {
+        observedCall: ObservedCall;
+        clientId: string;
+    }) => string | undefined;
     /**
      * Optional factory invoked when a call is created, producing the call's `RemoteTrackResolver`
      * (or `undefined` for none). Use the built-ins
@@ -6494,6 +6648,8 @@ declare class Observer<AppData extends Record<string, unknown> = Record<string,
     readonly observedTURN: ObservedTURN;
     readonly observedCalls: Map<string, ObservedCall<Record<string, unknown>>>;
     readonly observedMediasoupRouters: Map<string, ObservedMediasoupRouter<Record<string, unknown>>>;
+    readonly sinks: SinkRegistry;
+    readonly extensionStats: ExtensionStatsRegistry;
     /** Ancestry base shared by all Observer-bus events originating at the observer. */
     readonly eventScope: ObserverEventBase;
     readonly config: ObserverConfig<AppData>;
@@ -6644,6 +6800,9 @@ declare class Observer<AppData extends Record<string, unknown> = Record<string,
         matchPeerConnectionByWebRtcTransportId?: boolean;
     }): ObservedMediasoupRouter<Record<string, unknown>> | undefined;
     close(): void;
+    createExtensionStats<C extends SinkConstructor>(settings: CreateExtensionStatsSettings<C>): InstanceType<C> | undefined;
+    acceptExtensionStats(id: string, data: unknown): void;
+    getExtensionStats<T>(id: string): T | undefined;
     accept(sample: ClientSample, context?: AcceptContext): void;
     update(): void;
     /**
@@ -7037,52 +7196,38 @@ declare function createLogger(moduleName: string): Logger;
  */
 declare function setObserverLogger(logger: ObserverLogger): void;
 
-type JsonlFileSinkOptions = {
-    /** Absolute or relative file path to append JSONL lines to. */
-    path: string;
-    /** Optional custom serializer; defaults to `JSON.stringify`. */
-    serializeSample?: (sample: ClientSample) => string;
-};
+/** The lifecycle events a client sample sink may emit. Same as {@link SinkEvents}. */
+type ClientSampleSinkEvents = SinkEvents;
 /**
- * A sink that serializes each sample to a JSON line and appends it to a file. It wraps an
- * `fs.WriteStream` and re-emits its lifecycle events, so `close` fires once the file is flushed
- * and its descriptor is closed (file ready) and `error` surfaces file errors.
+ * A per-client destination for accepted samples. Create one under the client id with
+ * `observedCall.sinks.create(MySink, { id: clientId, ... })`, or let
+ * `ObserverConfig.createClientJsonlSink` create a `JsonlFileSink` there.
+ *
+ * The library calls `write(sample)` synchronously per accepted sample (not awaited) and `end()`s
+ * the sink when the client closes; the registry attaches an `error` listener so a failing sink
+ * can't crash the process. Because `write` isn't awaited, backpressure and batching are the sink's
+ * concern.
  */
-declare class JsonlFileSink extends ClientSampleSink {
-    /** The file this sink writes to. Read it (e.g. in a `close` handler) to upload/move the file. */
-    readonly path: string;
-    private readonly _stream;
-    private readonly _serializeSample;
-    constructor(options: JsonlFileSinkOptions);
-    write(sample: ClientSample): boolean;
-    end(): void;
-}
-/** Build a JSONL file sink for a single path. */
-declare function createJsonlFileSink(options: JsonlFileSinkOptions): ClientSampleSink;
-type JsonlFileSinkFactoryOptions = {
-    /** Directory the per-client files are written into (must exists). */
-    directory: string;
-    /** Builds the file name from the call/client ids. Defaults to `${callId}__${clientId}.jsonl`. */
-    getFileName?: (params: {
-        callId: string;
-        clientId: string;
-    }) => string;
-    /** Optional custom serializer; defaults to `JSON.stringify`. */
-    serializeSample?: (sample: ClientSample) => string;
-};
-/**
- * Convenience factory that writes one JSONL file per client, with the path derived from
- * `callId` / `clientId`. Plug into `ObserverConfig.createClientSink`.
- */
-declare function createJsonlFileSinkFactory(options: JsonlFileSinkFactoryOptions): ClientSampleSinkFactory;
+type ClientSampleSink = Sink<ClientSample>;
 
+declare interface InMemorySink {
+    on<E extends keyof SinkEvents>(event: E, listener: (...args: SinkEvents[E]) => void): this;
+    once<E extends keyof SinkEvents>(event: E, listener: (...args: SinkEvents[E]) => void): this;
+    off<E extends keyof SinkEvents>(event: E, listener: (...args: SinkEvents[E]) => void): this;
+    emit<E extends keyof SinkEvents>(event: E, ...args: SinkEvents[E]): boolean;
+}
 /**
- * A `ClientSampleSink` that collects the accepted sample objects into an array. Useful for
- * tests and offline replay. Emits `close` on `end()`.
+ * A client sample sink that collects the accepted sample objects into an array. Useful for tests
+ * and offline replay. Emits `ended` and `close` on `end()`.
  */
-declare class InMemorySink extends ClientSampleSink {
+declare class InMemorySink extends EventEmitter implements Sink<ClientSample> {
+    readonly id: string;
     readonly samples: ClientSample[];
-    constructor(samples?: ClientSample[]);
+    private _ended;
+    constructor(settings?: Partial<SinkSettings> & {
+        samples?: ClientSample[];
+    });
+    get ended(): boolean;
     write(sample: ClientSample): boolean;
     end(): void;
 }
@@ -7091,4 +7236,4 @@ declare function createInMemorySink(samples?: ClientSample[]): InMemorySink;
 declare function createDefaultMediasoupRemoteTrackResolverFactory(): RemoteTrackResolverFactory;
 declare function createP2pRemoteTrackResolverFactory(): RemoteTrackResolverFactory;
 
-export { type AcceptContext, type AcceptMiddleware, type AcceptMiddlewarePayload, type ActiveClientIssue, type ActiveIssueTracker, ActiveIssuesRegistry, AudioEchoDetector, type AudioEchoDetectorConfig, AudioEchoTypes, type AudioInputDevice, type AvailableCallScopeDetectorsConfigs, type AvailableDetectorsConfigs, type AvailableObserverScopeDetectorsConfigs, type AvailableValidatorConfigs, CODEC_MISMATCH_ISSUE, type CalculatedScore, type CallAppDataFactory, CallConcurrentIssueDetector, type CallConcurrentIssueDetectorConfig, type CallConcurrentIssueGroup, CallConcurrentIssueTypes, type CallHealth, CallHealthAggregator, type CallIssue, type CallIssueSpread, type CallScopedEventName, type CallSummary, type CallSummaryClients, CallSummaryCollector, type CallSummaryConfig, type CallSummaryEnricher, type CallSummaryEnrichers, type CallSummaryScores, type CallSummarySection, type CallSummaryTruncation, type CallSummaryTurnServers, type CertificateStats, type ClientAppDataFactory, type ClientEvent, ClientEventTypes, type ClientHealth, type ClientHealthThresholds, type ClientIssue, type ClientLocation, type ClientLocationResolver, type ClientMetaData, ClientMetaTypes, type ClientPopulation, type ClientPopulationAxis, ClientPopulationIssueDetector, type ClientPopulationIssueDetectorConfig, ClientPopulationIssueTypes, type ClientSample, ClientSampleSink, type ClientSampleSinkEvents, type ClientSampleSinkFactory, type CodecConsistencyReportPayload, CodecConsistencyValidator, type CodecConsistencyValidatorConfig, type CodecEvidence, type CodecStats, type CorroboratedPublisherFault, type DataChannelStats, type Detector, Detectors, type ExtensionStat, GEOHASH_CELL_SIZES, type IceCandidatePairStats, type IceCandidateStats, type IceTransportStats, InMemorySink, type InboundRtpStats, type InboundTrackSample, type Issue, type IssueBase, type IssueConclusion, IssueFanOutDetector, type IssueFanOutDetectorConfig, IssueFanOutTypes, type IssueFaultDomain, JsonlFileSink, type JsonlFileSinkFactoryOptions, type JsonlFileSinkOptions, LOWEST_COMMON_DENOMINATOR_ISSUE, type Logger, type MannKendallResult, type MediaKind, type MediaPlayoutStats, type MediaSourceStats, type MediasoupConsumerSample, type MediasoupConsumerSampleEvent, type MediasoupDataConsumerSample, type MediasoupDataProducerSample, type MediasoupDirectTransportSample, type MediasoupDirectTransportSampleEventMap, type MediasoupPipeTransportSample, type MediasoupPipeTransportSampleEventMap, type MediasoupPlainTransportSample, type MediasoupPlainTransportSampleEventMap, type MediasoupProducerSample, type MediasoupProducerSampleEvent, type MediasoupRouterSample, type MediasoupSampleEnricher, type MediasoupTransportSample, type MediasoupWebRtcTransportSample, type MediasoupWebRtcTransportSampleEventMap, type Middleware, MiddlewareProcessor, ObservedCall, type ObservedCallScope, type ObservedCallSettings, ObservedCertificate, ObservedClient, ObservedClientIssueRegistry, type ObservedClientScope, type ObservedClientSettings, ObservedCodec, ObservedDataChannel, ObservedIceCandidate, ObservedIceCandidatePair, ObservedIceTransport, ObservedInboundRtp, ObservedInboundTrack, ObservedMediaPlayout, ObservedMediaSource, ObservedMediasoupRouter, type ObservedMediasoupRouterEvents, type ObservedMediasoupRouterScope, type ObservedMediasoupRouterSettings, ObservedOutboundRtp, ObservedOutboundTrack, ObservedPeerConnection, type ObservedPeerConnectionScope, ObservedPeerConnectionTransport, ObservedRemoteInboundRtp, ObservedRemoteOutboundRtp, ObservedTURN, type ObservedTURNEventMap, ObservedTurnServer, Observer, ObserverConcurrentIssueDetector, type ObserverConcurrentIssueDetectorConfig, type ObserverConcurrentIssueGroup, ObserverConcurrentIssueTypes, type ObserverEventBase, type ObserverEvents, type ObserverIssue, type ObserverIssueSpread, type ObserverLogger, type OutboundRtpStats, type OutboundTrackSample, type PageHinkleyResult, type PeerConnectionSample, type PeerConnectionTransportStats, type PsnrSum, PublisherFaultCorroborationDetector, type PublisherFaultCorroborationDetectorConfig, PublisherFaultTypes, type QualityLimitationDurations, RESOLVED_ISSUE_SUFFIX, RTT_HISTOGRAM_BUCKET_WIDTH_IN_MS, RTT_HISTOGRAM_NUMBER_OF_BUCKETS, type RemoteInboundRtpStats, type RemoteOutboundRtpStats, type RemoteTrackLinkEvidence, RemoteTrackResolver, type RemoteTrackResolverFactory, type RemoteTrackResolverReportPayload, RemoteTrackResolverValidator, type RemoteTrackResolverValidatorConfig, type RemoteTrackResolvers, type ResolvedActiveClientIssue, type RttSummary, type RunningValidator, SCORE_HISTOGRAM_BUCKET_WIDTH, SCORE_HISTOGRAM_NUMBER_OF_BUCKETS, type SampleRejectedReason, type ScoreCalculator, type ScoreSummary, SfuCongestionDetector, type SfuCongestionDetectorBucket, type SfuCongestionDetectorConfig, type SfuCongestionDetectorEvaluation, type SfuCongestionDetectorReport, type SimulcastReceiverEvidence, type SimulcastReceiverReportPayload, SimulcastReceiverValidator, type SimulcastReceiverValidatorConfig, SlidingWindow, type SlidingWindowEntry, type StatsSummary, TrackDeliveryMismatchDetector, type TrackDeliveryMismatchDetectorConfig, TrackDeliveryMismatchTypes, TrendTester, type TrendTesterConfig, type TurnServerHealth, TurnServerHealthDetector, type TurnServerHealthDetectorConfig, TurnServerHealthTypes, TurnServerOutageDetector, type TurnServerOutageDetectorConfig, TurnServerOutageTypes, UNRESOLVED_TRACK_LINKS_ISSUE, UnconsumedTrackDetector, type UnconsumedTrackDetectorConfig, UnconsumedTrackTypes, type ValidationReport, type Validator, type ValidatorName, baseIssueType, concludeCallIssue, concludeObserverIssue, correlation, counterDelta, createCallSummary, createDefaultMediasoupRemoteTrackResolverFactory, createInMemorySink, createJsonlFileSink, createJsonlFileSinkFactory, createLogger, createP2pRemoteTrackResolverFactory, defaultCallSummaryConfig, defaultClientHealthThresholds, geohash, isClientIssueResolutionEntry, isPublicIpAddress, issuePayloadAsString, mannKendall, mannKendallVerdict, median, medianAbsoluteDeviation, pageHinkley, percentile, percentileOfHistogram, percentileOfSorted, robustZScore, schemaVersion, setObserverLogger, summarize };
+export { type AcceptContext, type AcceptMiddleware, type AcceptMiddlewarePayload, type ActiveClientIssue, type ActiveIssueTracker, ActiveIssuesRegistry, AudioEchoDetector, type AudioEchoDetectorConfig, AudioEchoTypes, type AudioInputDevice, type AvailableCallScopeDetectorsConfigs, type AvailableDetectorsConfigs, type AvailableObserverScopeDetectorsConfigs, type AvailableValidatorConfigs, CODEC_MISMATCH_ISSUE, type CalculatedScore, type CallAppDataFactory, CallConcurrentIssueDetector, type CallConcurrentIssueDetectorConfig, type CallConcurrentIssueGroup, CallConcurrentIssueTypes, type CallHealth, CallHealthAggregator, type CallIssue, type CallIssueSpread, type CallScopedEventName, type CallSummary, type CallSummaryClients, CallSummaryCollector, type CallSummaryConfig, type CallSummaryEnricher, type CallSummaryEnrichers, type CallSummaryScores, type CallSummarySection, type CallSummaryTruncation, type CallSummaryTurnServers, type CertificateStats, type ClientAppDataFactory, type ClientEvent, ClientEventTypes, type ClientHealth, type ClientHealthThresholds, type ClientIssue, type ClientLocation, type ClientLocationResolver, type ClientMetaData, ClientMetaTypes, type ClientPopulation, type ClientPopulationAxis, ClientPopulationIssueDetector, type ClientPopulationIssueDetectorConfig, ClientPopulationIssueTypes, type ClientSample, type ClientSampleSink, type ClientSampleSinkEvents, type CodecConsistencyReportPayload, CodecConsistencyValidator, type CodecConsistencyValidatorConfig, type CodecEvidence, type CodecStats, type CorroboratedPublisherFault, type CreateExtensionStatsSettings, type DataChannelStats, type Detector, Detectors, type ExtensionStat, ExtensionStatsRegistry, GEOHASH_CELL_SIZES, type IceCandidatePairStats, type IceCandidateStats, type IceTransportStats, InMemorySink, type InboundRtpStats, type InboundTrackSample, type Issue, type IssueBase, type IssueConclusion, IssueFanOutDetector, type IssueFanOutDetectorConfig, IssueFanOutTypes, type IssueFaultDomain, JsonlFileSink, type JsonlFileSinkOptions, LOWEST_COMMON_DENOMINATOR_ISSUE, type Logger, type MannKendallResult, type MediaKind, type MediaPlayoutStats, type MediaSourceStats, type MediasoupConsumerSample, type MediasoupConsumerSampleEvent, type MediasoupDataConsumerSample, type MediasoupDataProducerSample, type MediasoupDirectTransportSample, type MediasoupDirectTransportSampleEventMap, type MediasoupPipeTransportSample, type MediasoupPipeTransportSampleEventMap, type MediasoupPlainTransportSample, type MediasoupPlainTransportSampleEventMap, type MediasoupProducerSample, type MediasoupProducerSampleEvent, type MediasoupRouterSample, type MediasoupSampleEnricher, type MediasoupTransportSample, type MediasoupWebRtcTransportSample, type MediasoupWebRtcTransportSampleEventMap, type Middleware, MiddlewareProcessor, ObservedCall, type ObservedCallScope, type ObservedCallSettings, ObservedCertificate, ObservedClient, ObservedClientIssueRegistry, type ObservedClientScope, type ObservedClientSettings, ObservedCodec, ObservedDataChannel, ObservedIceCandidate, ObservedIceCandidatePair, ObservedIceTransport, ObservedInboundRtp, ObservedInboundTrack, ObservedMediaPlayout, ObservedMediaSource, ObservedMediasoupRouter, type ObservedMediasoupRouterEvents, type ObservedMediasoupRouterScope, type ObservedMediasoupRouterSettings, ObservedOutboundRtp, ObservedOutboundTrack, ObservedPeerConnection, type ObservedPeerConnectionScope, ObservedPeerConnectionTransport, ObservedRemoteInboundRtp, ObservedRemoteOutboundRtp, ObservedTURN, type ObservedTURNEventMap, ObservedTurnServer, Observer, ObserverConcurrentIssueDetector, type ObserverConcurrentIssueDetectorConfig, type ObserverConcurrentIssueGroup, ObserverConcurrentIssueTypes, type ObserverEventBase, type ObserverEvents, type ObserverIssue, type ObserverIssueSpread, type ObserverLogger, type OutboundRtpStats, type OutboundTrackSample, type PageHinkleyResult, type PeerConnectionSample, type PeerConnectionTransportStats, type PsnrSum, PublisherFaultCorroborationDetector, type PublisherFaultCorroborationDetectorConfig, PublisherFaultTypes, type QualityLimitationDurations, RESOLVED_ISSUE_SUFFIX, RTT_HISTOGRAM_BUCKET_WIDTH_IN_MS, RTT_HISTOGRAM_NUMBER_OF_BUCKETS, type RemoteInboundRtpStats, type RemoteOutboundRtpStats, type RemoteTrackLinkEvidence, RemoteTrackResolver, type RemoteTrackResolverFactory, type RemoteTrackResolverReportPayload, RemoteTrackResolverValidator, type RemoteTrackResolverValidatorConfig, type RemoteTrackResolvers, type ResolvedActiveClientIssue, type RttSummary, type RunningValidator, SCORE_HISTOGRAM_BUCKET_WIDTH, SCORE_HISTOGRAM_NUMBER_OF_BUCKETS, type SampleRejectedReason, type ScoreCalculator, type ScoreSummary, SfuCongestionDetector, type SfuCongestionDetectorBucket, type SfuCongestionDetectorConfig, type SfuCongestionDetectorEvaluation, type SfuCongestionDetectorReport, type SimulcastReceiverEvidence, type SimulcastReceiverReportPayload, SimulcastReceiverValidator, type SimulcastReceiverValidatorConfig, type Sink, type SinkConstructor, type SinkCreateSettings, type SinkEvents, SinkRegistry, type SinkSettings, SlidingWindow, type SlidingWindowEntry, type StatsSummary, TrackDeliveryMismatchDetector, type TrackDeliveryMismatchDetectorConfig, TrackDeliveryMismatchTypes, TrendTester, type TrendTesterConfig, type TurnServerHealth, TurnServerHealthDetector, type TurnServerHealthDetectorConfig, TurnServerHealthTypes, TurnServerOutageDetector, type TurnServerOutageDetectorConfig, TurnServerOutageTypes, UNRESOLVED_TRACK_LINKS_ISSUE, UnconsumedTrackDetector, type UnconsumedTrackDetectorConfig, UnconsumedTrackTypes, type ValidationReport, type Validator, type ValidatorName, baseIssueType, concludeCallIssue, concludeObserverIssue, correlation, counterDelta, createCallSummary, createDefaultMediasoupRemoteTrackResolverFactory, createInMemorySink, createJsonlFileSink, createLogger, createP2pRemoteTrackResolverFactory, defaultCallSummaryConfig, defaultClientHealthThresholds, geohash, isClientIssueResolutionEntry, isPublicIpAddress, issuePayloadAsString, mannKendall, mannKendallVerdict, median, medianAbsoluteDeviation, pageHinkley, percentile, percentileOfHistogram, percentileOfSorted, robustZScore, schemaVersion, setObserverLogger, summarize };