@stream-io/video-client 1.50.0 → 1.52.0

package/dist/src/Call.d.ts

@@ -103,6 +103,7 @@ export declare class Call {
     private statsReportingIntervalInMs;
     private statsReporter?;
     private sfuStatsReporter?;
+    private lastStatsOptions?;
     private dropTimeout;
     private readonly clientStore;
     readonly streamClient: StreamClient;

package/dist/src/devices/CameraManager.d.ts

@@ -45,5 +45,6 @@ export declare class CameraManager extends DeviceManager<CameraManagerState> {
      */
     apply(settings: VideoSettingsResponse, publish: boolean): Promise<void>;
     protected getDevices(): Observable<MediaDeviceInfo[]>;
+    protected getResolvedConstraints(constraints: MediaTrackConstraints): MediaTrackConstraints;
     protected getStream(constraints: MediaTrackConstraints): Promise<MediaStream>;
 }

package/dist/src/devices/DeviceManager.d.ts

@@ -6,6 +6,7 @@ import { ScopedLogger } from '../logger';
 import { TrackType } from '../gen/video/sfu/models/models';
 import { MediaStreamFilter, MediaStreamFilterRegistrationResult } from './filters';
 import { DevicePersistenceOptions } from './devicePersistence';
+import { VirtualDevice, VirtualDeviceEntry, VirtualDeviceHandle } from './VirtualDevice';
 export declare abstract class DeviceManager<S extends DeviceManagerState<C>, C = MediaTrackConstraints> {
     /**
      * if true, stops the media stream when call is left
@@ -21,6 +22,9 @@ export declare abstract class DeviceManager<S extends DeviceManagerState<C>, C =
     protected areSubscriptionsSetUp: boolean;
     private isTrackStoppedDueToTrackEnd;
     private filters;
+    private virtualDevicesSubject;
+    private activeVirtualSession;
+    private virtualDeviceConcurrencyTag;
     private statusChangeConcurrencyTag;
     private filterRegistrationConcurrencyTag;
     protected constructor(call: Call, state: S, trackType: TrackType, devicePersistence: Required<DevicePersistenceOptions>);
@@ -33,6 +37,21 @@ export declare abstract class DeviceManager<S extends DeviceManagerState<C>, C =
      * @returns an Observable that will be updated if a device is connected or disconnected
      */
     listDevices(): Observable<MediaDeviceInfo[]>;
+    /**
+     * Registers a virtual camera or microphone backed by a caller-supplied
+     * stream factory. The device appears in `listDevices()` and can be selected
+     * via `select()` like any real device.
+     *
+     * Web only. React Native is not supported.
+     *
+     * Only supported for camera and microphone managers; calling on any other
+     * manager throws.
+     */
+    registerVirtualDevice(virtualDevice: VirtualDevice<C>): VirtualDeviceHandle;
+    protected sanitizeVirtualStream(stream: MediaStream): MediaStream;
+    protected findVirtualDevice(deviceId: string | undefined): VirtualDeviceEntry<C> | undefined;
+    private stopActiveVirtualSession;
+    protected getSelectedStream(constraints: C): Promise<MediaStream>;
     /**
      * Returns `true` when this device is in enabled state.
      */
@@ -93,6 +112,7 @@ export declare abstract class DeviceManager<S extends DeviceManagerState<C>, C =
     private runCurrentStreamCleanups;
     protected applySettingsToStream(): Promise<void>;
     protected abstract getDevices(): Observable<MediaDeviceInfo[]>;
+    protected getResolvedConstraints(constraints: C): C;
     protected abstract getStream(constraints: C): Promise<MediaStream>;
     protected publishStream(stream: MediaStream, options?: TrackPublishOptions): Promise<void>;
     protected stopPublishStream(): Promise<void>;

package/dist/src/devices/VirtualDevice.d.ts

@@ -0,0 +1,59 @@
+/**
+ * A MediaStream produced for a virtual device session, along with an optional
+ * cleanup callback. Returned by {@link VirtualDevice.getUserMedia}.
+ */
+export interface VirtualDeviceSession {
+    readonly stream: MediaStream;
+    readonly stop?: () => void | Promise<void>;
+}
+/**
+ * A virtual camera or microphone definition supplied by the integrator.
+ *
+ * Pass this to `camera.registerVirtualDevice()` /
+ * `microphone.registerVirtualDevice()` to make it appear in the device list
+ * and become selectable.
+ */
+export interface VirtualDevice<C = MediaTrackConstraints> {
+    /**
+     * Human-readable label shown in device dropdowns.
+     */
+    label: string;
+    /**
+     * Called when the virtual device is selected and the SDK needs media.
+     * Returns the MediaStream to publish along with an optional `stop`
+     * callback that runs when the session is replaced, the tracks end, or
+     * the device is unregistered.
+     *
+     * `constraints` is the resolved set the SDK would otherwise pass to
+     * `getUserMedia` for a real device.
+     */
+    getUserMedia: (constraints: C) => VirtualDeviceSession | Promise<VirtualDeviceSession>;
+}
+/**
+ * @internal Internal entry stored in the device manager's registry.
+ */
+export interface VirtualDeviceEntry<C = MediaTrackConstraints> extends VirtualDevice<C> {
+    readonly deviceId: string;
+    readonly kind: 'audioinput' | 'videoinput';
+}
+/**
+ * @internal Tracks the currently active virtual device session inside the
+ * device manager so its `stop` callback can be invoked when the session is
+ * replaced or torn down.
+ */
+export interface ActiveVirtualSession {
+    deviceId: string;
+    stop?: () => void | Promise<void>;
+}
+export interface VirtualDeviceHandle {
+    /**
+     * The device id under which the virtual device was registered. Pass this
+     * to `camera.select()` / `microphone.select()` to switch to it.
+     */
+    readonly deviceId: string;
+    /**
+     * Removes the virtual device from the manager. If it is currently selected,
+     * the selection is reset so the SDK falls back to the default device.
+     */
+    unregister: () => Promise<void>;
+}

package/dist/src/devices/devicePersistence.d.ts

@@ -21,7 +21,7 @@ export type LocalDevicePreferences = {
 };
 export declare const defaultDeviceId = "default";
 export declare const normalize: (options: DevicePersistenceOptions | undefined) => Required<DevicePersistenceOptions>;
-export declare const createSyntheticDevice: (deviceId: string, kind: MediaDeviceKind) => MediaDeviceInfo;
+export declare const createSyntheticDevice: (deviceId: string, kind: MediaDeviceKind, label?: string) => MediaDeviceInfo;
 export declare const readPreferences: (storageKey: string) => LocalDevicePreferences;
 export declare const writePreferences: (currentDevice: MediaDeviceInfo | undefined, deviceKey: DevicePreferenceKey, muted: boolean | undefined, storageKey: string) => void;
 export declare const toPreferenceList: (preference?: LocalDevicePreference | LocalDevicePreference[]) => LocalDevicePreference[];

package/dist/src/devices/index.d.ts

@@ -10,3 +10,4 @@ export * from './ScreenShareManager';
 export * from './ScreenShareState';
 export * from './SpeakerManager';
 export * from './SpeakerState';
+export * from './VirtualDevice';

package/dist/src/gen/video/sfu/event/events.d.ts

@@ -623,6 +623,10 @@ export interface SubscriberOffer {
      * @generated from protobuf field: string sdp = 2;
      */
     sdp: string;
+    /**
+     * @generated from protobuf field: uint32 negotiation_id = 3;
+     */
+    negotiationId: number;
 }
 /**
  * @generated from protobuf message stream.video.sfu.event.PublisherAnswer

package/dist/src/gen/video/sfu/models/models.d.ts

@@ -449,6 +449,10 @@ export interface ClientDetails {
      * @generated from protobuf field: stream.video.sfu.models.Device device = 4;
      */
     device?: Device;
+    /**
+     * @generated from protobuf field: string webrtc_version = 5;
+     */
+    webrtcVersion: string;
 }
 /**
  * @generated from protobuf message stream.video.sfu.models.Sdk
@@ -702,6 +706,155 @@ export interface PerformanceStats {
      */
     targetBitrate: number;
 }
+/**
+ * ===================================================================
+ * BASE (shared by all RTP directions)
+ * ===================================================================
+ *
+ * @generated from protobuf message stream.video.sfu.models.RtpBase
+ */
+export interface RtpBase {
+    /**
+     * @generated from protobuf field: uint32 ssrc = 1;
+     */
+    ssrc: number;
+    /**
+     * @generated from protobuf field: string kind = 2;
+     */
+    kind: string;
+    /**
+     * @generated from protobuf field: double timestamp_ms = 3;
+     */
+    timestampMs: number;
+}
+/**
+ * ===================================================================
+ * INBOUND (SUBSCRIBER RECEIVING MEDIA)
+ * ===================================================================
+ *
+ * @generated from protobuf message stream.video.sfu.models.InboundRtp
+ */
+export interface InboundRtp {
+    /**
+     * @generated from protobuf field: stream.video.sfu.models.RtpBase base = 1;
+     */
+    base?: RtpBase;
+    /**
+     * @generated from protobuf field: double jitter_seconds = 2;
+     */
+    jitterSeconds: number;
+    /**
+     * @generated from protobuf field: uint64 packets_received = 3;
+     */
+    packetsReceived: string;
+    /**
+     * @generated from protobuf field: uint64 packets_lost = 4;
+     */
+    packetsLost: string;
+    /**
+     * @generated from protobuf field: double packet_loss_percent = 5;
+     */
+    packetLossPercent: number;
+    /**
+     * -------- AUDIO METRICS --------
+     *
+     * @generated from protobuf field: uint32 concealment_events = 10;
+     */
+    concealmentEvents: number;
+    /**
+     * @generated from protobuf field: double concealment_percent = 11;
+     */
+    concealmentPercent: number;
+    /**
+     * -------- VIDEO METRICS --------
+     *
+     * @generated from protobuf field: double fps = 20;
+     */
+    fps: number;
+    /**
+     * @generated from protobuf field: double freeze_duration_seconds = 21;
+     */
+    freezeDurationSeconds: number;
+    /**
+     * @generated from protobuf field: double avg_decode_time_seconds = 22;
+     */
+    avgDecodeTimeSeconds: number;
+    /**
+     * @generated from protobuf field: uint32 min_dimension_px = 23;
+     */
+    minDimensionPx: number;
+}
+/**
+ * ===================================================================
+ * OUTBOUND (PUBLISHER SENDING MEDIA)
+ * ===================================================================
+ *
+ * @generated from protobuf message stream.video.sfu.models.OutboundRtp
+ */
+export interface OutboundRtp {
+    /**
+     * @generated from protobuf field: stream.video.sfu.models.RtpBase base = 1;
+     */
+    base?: RtpBase;
+    /**
+     * @generated from protobuf field: double fps = 10;
+     */
+    fps: number;
+    /**
+     * @generated from protobuf field: double avg_encode_time_seconds = 11;
+     */
+    avgEncodeTimeSeconds: number;
+    /**
+     * @generated from protobuf field: double bitrate_bps = 12;
+     */
+    bitrateBps: number;
+    /**
+     * @generated from protobuf field: uint32 min_dimension_px = 13;
+     */
+    minDimensionPx: number;
+}
+/**
+ * ===================================================================
+ * SFU FEEDBACK: REMOTE-INBOUND (Publisher receives feedback)
+ * ===================================================================
+ *
+ * @generated from protobuf message stream.video.sfu.models.RemoteInboundRtp
+ */
+export interface RemoteInboundRtp {
+    /**
+     * @generated from protobuf field: stream.video.sfu.models.RtpBase base = 1;
+     */
+    base?: RtpBase;
+    /**
+     * @generated from protobuf field: double jitter_seconds = 2;
+     */
+    jitterSeconds: number;
+    /**
+     * @generated from protobuf field: double round_trip_time_s = 3;
+     */
+    roundTripTimeS: number;
+}
+/**
+ * ===================================================================
+ * SFU FEEDBACK: REMOTE-OUTBOUND (Subscriber receives feedback)
+ * ===================================================================
+ *
+ * @generated from protobuf message stream.video.sfu.models.RemoteOutboundRtp
+ */
+export interface RemoteOutboundRtp {
+    /**
+     * @generated from protobuf field: stream.video.sfu.models.RtpBase base = 1;
+     */
+    base?: RtpBase;
+    /**
+     * @generated from protobuf field: double jitter_seconds = 2;
+     */
+    jitterSeconds: number;
+    /**
+     * @generated from protobuf field: double round_trip_time_s = 3;
+     */
+    roundTripTimeS: number;
+}
 /**
  * @generated from protobuf enum stream.video.sfu.models.PeerType
  */
@@ -968,7 +1121,15 @@ export declare enum SdkType {
     /**
      * @generated from protobuf enum value: SDK_TYPE_PLAIN_JAVASCRIPT = 9;
      */
-    PLAIN_JAVASCRIPT = 9
+    PLAIN_JAVASCRIPT = 9,
+    /**
+     * @generated from protobuf enum value: SDK_TYPE_PYTHON = 10;
+     */
+    PYTHON = 10,
+    /**
+     * @generated from protobuf enum value: SDK_TYPE_VISION_AGENTS = 11;
+     */
+    VISION_AGENTS = 11
 }
 /**
  * @generated from protobuf enum stream.video.sfu.models.TrackUnpublishReason
@@ -1172,7 +1333,13 @@ export declare enum ClientCapability {
      *
      * @generated from protobuf enum value: CLIENT_CAPABILITY_SUBSCRIBER_VIDEO_PAUSE = 1;
      */
-    SUBSCRIBER_VIDEO_PAUSE = 1
+    SUBSCRIBER_VIDEO_PAUSE = 1,
+    /**
+     * Instructs SFU that stats will be sent to the coordinator
+     *
+     * @generated from protobuf enum value: CLIENT_CAPABILITY_COORDINATOR_STATS = 2;
+     */
+    COORDINATOR_STATS = 2
 }
 /**
  * DegradationPreference represents the RTCDegradationPreference from WebRTC.
@@ -1384,4 +1551,39 @@ declare class PerformanceStats$Type extends MessageType<PerformanceStats> {
  * @generated MessageType for protobuf message stream.video.sfu.models.PerformanceStats
  */
 export declare const PerformanceStats: PerformanceStats$Type;
+declare class RtpBase$Type extends MessageType<RtpBase> {
+    constructor();
+}
+/**
+ * @generated MessageType for protobuf message stream.video.sfu.models.RtpBase
+ */
+export declare const RtpBase: RtpBase$Type;
+declare class InboundRtp$Type extends MessageType<InboundRtp> {
+    constructor();
+}
+/**
+ * @generated MessageType for protobuf message stream.video.sfu.models.InboundRtp
+ */
+export declare const InboundRtp: InboundRtp$Type;
+declare class OutboundRtp$Type extends MessageType<OutboundRtp> {
+    constructor();
+}
+/**
+ * @generated MessageType for protobuf message stream.video.sfu.models.OutboundRtp
+ */
+export declare const OutboundRtp: OutboundRtp$Type;
+declare class RemoteInboundRtp$Type extends MessageType<RemoteInboundRtp> {
+    constructor();
+}
+/**
+ * @generated MessageType for protobuf message stream.video.sfu.models.RemoteInboundRtp
+ */
+export declare const RemoteInboundRtp: RemoteInboundRtp$Type;
+declare class RemoteOutboundRtp$Type extends MessageType<RemoteOutboundRtp> {
+    constructor();
+}
+/**
+ * @generated MessageType for protobuf message stream.video.sfu.models.RemoteOutboundRtp
+ */
+export declare const RemoteOutboundRtp: RemoteOutboundRtp$Type;
 export {};

package/dist/src/gen/video/sfu/signal_rpc/signal.client.d.ts

@@ -1,5 +1,5 @@
 import type { RpcOptions, RpcTransport, ServiceInfo, UnaryCall } from '@protobuf-ts/runtime-rpc';
-import type { ICERestartRequest, ICERestartResponse, ICETrickleResponse, SendAnswerRequest, SendAnswerResponse, SendStatsRequest, SendStatsResponse, SetPublisherRequest, SetPublisherResponse, StartNoiseCancellationRequest, StartNoiseCancellationResponse, StopNoiseCancellationRequest, StopNoiseCancellationResponse, UpdateMuteStatesRequest, UpdateMuteStatesResponse, UpdateSubscriptionsRequest, UpdateSubscriptionsResponse } from './signal';
+import type { ICERestartRequest, ICERestartResponse, ICETrickleResponse, SendAnswerRequest, SendAnswerResponse, SendMetricsRequest, SendMetricsResponse, SendStatsRequest, SendStatsResponse, SetPublisherRequest, SetPublisherResponse, StartNoiseCancellationRequest, StartNoiseCancellationResponse, StopNoiseCancellationRequest, StopNoiseCancellationResponse, UpdateMuteStatesRequest, UpdateMuteStatesResponse, UpdateSubscriptionsRequest, UpdateSubscriptionsResponse } from './signal';
 import type { ICETrickle } from '../models/models';
 /**
  * @generated from protobuf service stream.video.sfu.signal.SignalServer
@@ -42,6 +42,10 @@ export interface ISignalServerClient {
      * @generated from protobuf rpc: SendStats(stream.video.sfu.signal.SendStatsRequest) returns (stream.video.sfu.signal.SendStatsResponse);
      */
     sendStats(input: SendStatsRequest, options?: RpcOptions): UnaryCall<SendStatsRequest, SendStatsResponse>;
+    /**
+     * @generated from protobuf rpc: SendMetrics(stream.video.sfu.signal.SendMetricsRequest) returns (stream.video.sfu.signal.SendMetricsResponse);
+     */
+    sendMetrics(input: SendMetricsRequest, options?: RpcOptions): UnaryCall<SendMetricsRequest, SendMetricsResponse>;
     /**
      * @generated from protobuf rpc: StartNoiseCancellation(stream.video.sfu.signal.StartNoiseCancellationRequest) returns (stream.video.sfu.signal.StartNoiseCancellationResponse);
      */
@@ -99,6 +103,10 @@ export declare class SignalServerClient implements ISignalServerClient, ServiceI
      * @generated from protobuf rpc: SendStats(stream.video.sfu.signal.SendStatsRequest) returns (stream.video.sfu.signal.SendStatsResponse);
      */
     sendStats(input: SendStatsRequest, options?: RpcOptions): UnaryCall<SendStatsRequest, SendStatsResponse>;
+    /**
+     * @generated from protobuf rpc: SendMetrics(stream.video.sfu.signal.SendMetricsRequest) returns (stream.video.sfu.signal.SendMetricsResponse);
+     */
+    sendMetrics(input: SendMetricsRequest, options?: RpcOptions): UnaryCall<SendMetricsRequest, SendMetricsResponse>;
     /**
      * @generated from protobuf rpc: StartNoiseCancellation(stream.video.sfu.signal.StartNoiseCancellationRequest) returns (stream.video.sfu.signal.StartNoiseCancellationResponse);
      */

package/dist/src/gen/video/sfu/signal_rpc/signal.d.ts

@@ -1,6 +1,20 @@
-import { AndroidState, AppleState, Error, InputDevices, PeerType, PerformanceStats, RTMPIngress, TrackInfo, TrackType, VideoDimension, WebsocketReconnectStrategy } from '../models/models';
 import { ServiceType } from '@protobuf-ts/runtime-rpc';
 import { MessageType } from '@protobuf-ts/runtime';
+import { TrackInfo } from '../models/models';
+import { VideoDimension } from '../models/models';
+import { TrackType } from '../models/models';
+import { PeerType } from '../models/models';
+import { PerformanceStats } from '../models/models';
+import { RTMPIngress } from '../models/models';
+import { AppleState } from '../models/models';
+import { AndroidState } from '../models/models';
+import { InputDevices } from '../models/models';
+import { RemoteOutboundRtp } from '../models/models';
+import { RemoteInboundRtp } from '../models/models';
+import { OutboundRtp } from '../models/models';
+import { InboundRtp } from '../models/models';
+import { WebsocketReconnectStrategy } from '../models/models';
+import { Error } from '../models/models';
 /**
  * @generated from protobuf message stream.video.sfu.signal.StartNoiseCancellationRequest
  */
@@ -73,6 +87,40 @@ export interface Telemetry {
         oneofKind: undefined;
     };
 }
+/**
+ * @generated from protobuf message stream.video.sfu.signal.SendMetricsRequest
+ */
+export interface SendMetricsRequest {
+    /**
+     * @generated from protobuf field: string session_id = 1;
+     */
+    sessionId: string;
+    /**
+     * @generated from protobuf field: string unified_session_id = 2;
+     */
+    unifiedSessionId: string;
+    /**
+     * @generated from protobuf field: repeated stream.video.sfu.models.InboundRtp inbounds = 3;
+     */
+    inbounds: InboundRtp[];
+    /**
+     * @generated from protobuf field: repeated stream.video.sfu.models.OutboundRtp outbounds = 4;
+     */
+    outbounds: OutboundRtp[];
+    /**
+     * @generated from protobuf field: repeated stream.video.sfu.models.RemoteInboundRtp remote_inbounds = 5;
+     */
+    remoteInbounds: RemoteInboundRtp[];
+    /**
+     * @generated from protobuf field: repeated stream.video.sfu.models.RemoteOutboundRtp remote_outbounds = 6;
+     */
+    remoteOutbounds: RemoteOutboundRtp[];
+}
+/**
+ * @generated from protobuf message stream.video.sfu.signal.SendMetricsResponse
+ */
+export interface SendMetricsResponse {
+}
 /**
  * @generated from protobuf message stream.video.sfu.signal.SendStatsRequest
  */
@@ -313,6 +361,10 @@ export interface SendAnswerRequest {
      * @generated from protobuf field: string session_id = 3;
      */
     sessionId: string;
+    /**
+     * @generated from protobuf field: uint32 negotiation_id = 4;
+     */
+    negotiationId: number;
 }
 /**
  * @generated from protobuf message stream.video.sfu.signal.SendAnswerResponse
@@ -416,6 +468,20 @@ declare class Telemetry$Type extends MessageType<Telemetry> {
  * @generated MessageType for protobuf message stream.video.sfu.signal.Telemetry
  */
 export declare const Telemetry: Telemetry$Type;
+declare class SendMetricsRequest$Type extends MessageType<SendMetricsRequest> {
+    constructor();
+}
+/**
+ * @generated MessageType for protobuf message stream.video.sfu.signal.SendMetricsRequest
+ */
+export declare const SendMetricsRequest: SendMetricsRequest$Type;
+declare class SendMetricsResponse$Type extends MessageType<SendMetricsResponse> {
+    constructor();
+}
+/**
+ * @generated MessageType for protobuf message stream.video.sfu.signal.SendMetricsResponse
+ */
+export declare const SendMetricsResponse: SendMetricsResponse$Type;
 declare class SendStatsRequest$Type extends MessageType<SendStatsRequest> {
     constructor();
 }

package/dist/src/helpers/participantUtils.d.ts

@@ -1,4 +1,5 @@
 import { StreamVideoParticipant, VideoTrackType } from '../types';
+import { TrackType } from '../gen/video/sfu/models/models';
 /**
  * Check if a participant has a video.
  *
@@ -29,6 +30,15 @@ export declare const hasScreenShareAudio: (p: StreamVideoParticipant) => boolean
  * @param p the participant.
  */
 export declare const isPinned: (p: StreamVideoParticipant) => boolean;
+/**
+ * Check if a participant has a track that is currently interrupted: the
+ * participant intends to publish it (it is in `publishedTracks`) but no
+ * media is flowing right now (it is in `interruptedTracks`).
+ *
+ * @param p the participant to check.
+ * @param trackType the track type to check.
+ */
+export declare const hasInterruptedTrack: (p: StreamVideoParticipant, trackType: TrackType) => boolean;
 /**
  * Check if a participant has a paused track of the specified type.
  *

package/dist/src/rtc/BasePeerConnection.d.ts

@@ -27,7 +27,7 @@ export declare abstract class BasePeerConnection {
     private iceRestartTimeout?;
     private preConnectStuckTimeout?;
     protected isIceRestarting: boolean;
-    private isDisposed;
+    protected isDisposed: boolean;
     protected trackIdToTrackType: Map<string, TrackType>;
     readonly tracer?: Tracer;
     readonly stats: StatsTracer;
@@ -37,12 +37,12 @@ export declare abstract class BasePeerConnection {
     /**
      * Constructs a new `BasePeerConnection` instance.
      */
-    protected constructor(peerType: PeerType, { sfuClient, connectionConfig, state, dispatcher, onReconnectionNeeded, onIceConnected, tag, enableTracing, clientPublishOptions, iceRestartDelay, }: BasePeerConnectionOpts);
+    protected constructor(peerType: PeerType, { sfuClient, connectionConfig, state, dispatcher, onReconnectionNeeded, onIceConnected, tag, enableTracing, clientPublishOptions, iceRestartDelay, statsTimestampDriftThresholdMs, }: BasePeerConnectionOpts);
     private createPeerConnection;
     /**
      * Disposes the `RTCPeerConnection` instance.
      */
-    dispose(): void;
+    dispose(): Promise<void>;
     /**
      * Detaches the event handlers from the `RTCPeerConnection`.
      */
@@ -62,6 +62,11 @@ export declare abstract class BasePeerConnection {
      * Consecutive events are queued and executed one after the other.
      */
     protected on: <E extends keyof AllSfuEvents>(event: E, fn: CallEventListener<E>) => void;
+    /**
+     * Returns the per-event `withoutConcurrency` tag used to serialize the
+     * dispatcher handler for `event` on this peer connection.
+     */
+    protected eventLockKey: (event: keyof AllSfuEvents) => string;
     /**
      * Appends the trickled ICE candidates to the `RTCPeerConnection`.
      */

package/dist/src/rtc/Publisher.d.ts

@@ -17,7 +17,7 @@ export declare class Publisher extends BasePeerConnection {
     /**
      * Disposes this Publisher instance.
      */
-    dispose(): void;
+    dispose(): Promise<void>;
     /**
      * Starts publishing the given track of the given media stream.
      *
@@ -71,11 +71,11 @@ export declare class Publisher extends BasePeerConnection {
     /**
      * Stops the cloned track that is being published to the SFU.
      */
-    stopTracks: (...trackTypes: TrackType[]) => void;
+    stopTracks: (...trackTypes: TrackType[]) => Promise<void>;
     /**
      * Stops all the cloned tracks that are being published to the SFU.
      */
-    stopAllTracks: () => void;
+    stopAllTracks: () => Promise<void>;
     private changePublishQuality;
     /**
      * Restarts the ICE connection and renegotiates with the SFU.
@@ -108,4 +108,22 @@ export declare class Publisher extends BasePeerConnection {
     private toTrackInfo;
     private cloneTrack;
     private stopTrack;
+    /**
+     * Silences a Firefox sender on the wire during unpublish.
+     *
+     * Firefox keeps emitting RTP after track.stop(), but the right lever
+     * differs by track type:
+     *   - audio: `replaceTrack(null)` is the only reliable silencer;
+     *     `setParameters({encodings:[...active:false]})` does NOT stop
+     *     the Opus encoder.
+     *   - video: `setParameters({encodings:[...active:false]})` pauses
+     *     the encoder; `replaceTrack(null)` does NOT reliably stop the
+     *     video encoder. The prior active=true configuration is captured
+     *     onto `bundle.videoSender` so `updateTransceiver` can restore
+     *     it on the next publish.
+     *
+     * No-op on non-Firefox browsers and during teardown.
+     */
+    private silenceSenderOnFirefox;
+    private disableAllEncodings;
 }

package/dist/src/rtc/TransceiverCache.d.ts

@@ -1,4 +1,4 @@
-import { PublishOption } from '../gen/video/sfu/models/models';
+import { PublishOption, TrackType } from '../gen/video/sfu/models/models';
 import type { OptimalVideoLayer } from './layers';
 import type { PublishBundle } from './types';
 export declare class TransceiverCache {
@@ -18,6 +18,10 @@ export declare class TransceiverCache {
      * Gets the transceiver for the given publish option.
      */
     get: (publishOption: PublishOption) => PublishBundle | undefined;
+    /**
+     * Gets the transceiver for the given publish option id and track type.
+     */
+    getBy: (publishOptionId: number, trackType: TrackType) => PublishBundle | undefined;
     /**
      * Updates the cached bundle with the given patch.
      */

package/dist/src/rtc/helpers/degradationPreference.d.ts

@@ -1,2 +1,3 @@
 import { DegradationPreference } from '../../gen/video/sfu/models/models';
 export declare const toRTCDegradationPreference: (preference: DegradationPreference) => RTCDegradationPreference | undefined;
+export declare const fromRTCDegradationPreference: (preference: RTCDegradationPreference | undefined) => DegradationPreference;

package/dist/src/rtc/types.d.ts

@@ -4,6 +4,7 @@ import { CallState } from '../store';
 import { Dispatcher } from './Dispatcher';
 import type { OptimalVideoLayer } from './layers';
 import type { ClientPublishOptions } from '../types';
+import type { VideoSender } from '../gen/video/sfu/event/events';
 /**
  * Canonical reasons the SDK uses to trigger a reconnection. Free-form strings
  * are still accepted at the callback boundary (e.g. when forwarding an SFU
@@ -47,6 +48,7 @@ export type BasePeerConnectionOpts = {
     enableTracing: boolean;
     iceRestartDelay?: number;
     clientPublishOptions?: ClientPublishOptions;
+    statsTimestampDriftThresholdMs?: number;
 };
 export type TrackPublishOptions = {
     audioBitrateProfile?: AudioBitrateProfile;
@@ -55,6 +57,7 @@ export type PublishBundle = {
     publishOption: PublishOption;
     transceiver: RTCRtpTransceiver;
     options: TrackPublishOptions;
+    videoSender?: VideoSender;
 };
 export type TrackLayersCache = {
     publishOption: PublishOption;