@vkontakte/calls-sdk 2.8.12-dev.e23c81f4.0 → 2.8.12-dev.ec5956ec.0

package/classes/CallRegistry.d.ts

@@ -1,4 +1,4 @@
-import Conversation from './Conversation';
+import type Conversation from './conversation';
 import MediaSettings from '../types/MediaSettings';
 export interface HoldableConversation extends Conversation {
     id: string;
@@ -6,8 +6,11 @@ export interface HoldableConversation extends Conversation {
 }
 export declare class CallRegistry {
     private _conversations;
+    private _reserved;
     private _activeId;
     private _mutex;
+    private _pendingRemovals;
+    reserve(id: string): void;
     add(conversation: HoldableConversation): void;
     remove(id: string | null): void;
     get(id: string): HoldableConversation | undefined;
@@ -21,6 +24,7 @@ export declare class CallRegistry {
     setHold(id: string): Promise<void>;
     switchCall(id: string): Promise<void>;
     clear(): void;
+    private _flushPendingRemovals;
 }
 declare const callRegistry: CallRegistry;
 export { callRegistry };

package/classes/ExternalIdCache.d.ts

@@ -1,6 +1,7 @@
 import { ExternalId, ExternalParticipantId } from '../types/ExternalId';
 import { CompositeUserId, OkUserId, ParticipantId } from '../types/Participant';
 export declare class ExternalIdCache {
+    private static _normalizeType;
     private _okIdToExternalId;
     private _externalIdToOkId;
     private _decorativeIdToInitialId;

package/classes/StatsLogger.d.ts

@@ -1,6 +1,14 @@
 import BaseApi from '../abstract/BaseApi';
 import BaseLogger from '../abstract/BaseLogger';
 import StatLog from '../enums/StatLog';
+import TransportTopology from '../enums/TransportTopology';
+type ClientStatsPayload = Record<string, string | number | boolean | undefined | null>;
+export type LogClientStatsOptions = {
+    immediately?: boolean;
+    occurredAt?: number;
+    conversationId?: string | null;
+    deferUntilServerTime?: boolean;
+};
 /**
  * Класс отвечает за отправку различной информации в сервис статистики (события, статистика и подобное)
  */
@@ -8,19 +16,26 @@ export default class StatsLogger extends BaseLogger {
     private readonly _externalLogger;
     private readonly _api;
     private readonly _conversationIdProvider;
+    private readonly _topologyProvider;
     private readonly _batchInterval;
     private _batchedClientStats;
     private _batchTimeout;
     private _serverTimeDelta;
-    constructor(api: BaseApi, externalLogger: BaseLogger | null, conversationIdProvider: () => string | null);
+    private _waitingForServerTime;
+    private _deferredClientStats;
+    constructor(api: BaseApi, externalLogger: BaseLogger | null, conversationIdProvider: () => string | null, topologyProvider?: () => TransportTopology | undefined);
     log(name: StatLog, value?: string, immediately?: boolean): void;
-    logClientStats(data: Record<string, string | number | boolean | undefined | null>, immediately?: boolean): void;
+    logClientStats(data: ClientStatsPayload, immediatelyOrOptions?: boolean | LogClientStatsOptions): void;
     destroy(): void;
+    private _logClientStats;
     private _getConversationId;
+    private _getCallTopology;
     private _sendBatch;
     private _startTimeout;
     private _stopTimeout;
     private _sendClientStats;
     private _calculateServerTimeDelta;
+    private _flushDeferredClientStats;
     private _now;
 }
+export {};

package/classes/{Conversation.d.ts → conversation/Conversation.d.ts}

@@ -1,33 +1,34 @@
 import type { IEffect } from '@vkontakte/calls-video-effects';
 import type { RGBTuple } from '@vkontakte/calls-vmoji';
-import BaseApi from '../abstract/BaseApi';
-import BaseLogger from '../abstract/BaseLogger';
-import { AddParticipantParams } from '../abstract/BaseSignaling';
-import ConversationFeature from '../enums/ConversationFeature';
-import ConversationOption from '../enums/ConversationOption';
-import MediaOption from '../enums/MediaOption';
-import UpdateDisplayLayoutErrorReason from '../enums/UpdateDisplayLayoutErrorReason';
-import UserRole from '../enums/UserRole';
-import UserType from '../enums/UserType';
-import { JSONObject } from '../static/Json';
-import { IAsrStartParams, IAsrStopParams } from '../types/Asr';
-import { AudienceModeHandsResponse } from '../types/AudienceMode';
-import { ConversationData, ConversationOnStartParams } from '../types/Conversation';
-import { ExternalId, ExternalParticipant, ExternalParticipantId, ExternalParticipantListChunk, ExternalUserId } from '../types/ExternalId';
-import type { FastJoinHandler } from '../types/FastJoin';
-import MediaModifiers from '../types/MediaModifiers';
-import MediaSettings, { IVideoDimentions } from '../types/MediaSettings';
-import { IAddMovieParams, IUpdateMovieData } from '../types/MovieShare';
-import MuteStates from '../types/MuteStates';
-import { CompositeUserId, IGetParticipantsParameters, ParticipantId, ParticipantStateData } from '../types/Participant';
-import { DisplayLayoutRequest, ParticipantLayout } from '../types/ParticipantLayout';
-import { ParticipantListChunkParameters } from '../types/ParticipantListChunk';
-import ParticipantPriority from '../types/ParticipantPriority';
-import { ParticipantStreamDescription } from '../types/ParticipantStreamDescription';
-import { ScreenCaptureSettings } from '../types/ScreenCaptureSettings';
-import SignalingMessage from '../types/SignalingMessage';
-import { WaitingHallResponse } from '../types/WaitingHall';
-import EventEmitter from './EventEmitter';
+import BaseApi from '../../abstract/BaseApi';
+import BaseLogger from '../../abstract/BaseLogger';
+import { AddParticipantParams } from '../../abstract/BaseSignaling';
+import ConversationFeature from '../../enums/ConversationFeature';
+import ConversationOption from '../../enums/ConversationOption';
+import type ClientHangupReason from '../../enums/ClientHangupReason';
+import MediaOption from '../../enums/MediaOption';
+import UpdateDisplayLayoutErrorReason from '../../enums/UpdateDisplayLayoutErrorReason';
+import UserRole from '../../enums/UserRole';
+import UserType from '../../enums/UserType';
+import { DebugMessageType } from '../../static/Debug';
+import { JSONObject } from '../../static/Json';
+import { IAsrStartParams, IAsrStopParams } from '../../types/Asr';
+import { AudienceModeHandsResponse } from '../../types/AudienceMode';
+import { ConversationData, ConversationOnJoinParams, ConversationOnStartParams } from '../../types/Conversation';
+import { ExternalId, ExternalParticipant, ExternalParticipantId, ExternalParticipantListChunk } from '../../types/ExternalId';
+import MediaModifiers from '../../types/MediaModifiers';
+import MediaSettings, { IVideoDimentions } from '../../types/MediaSettings';
+import { IAddMovieParams, IUpdateMovieData } from '../../types/MovieShare';
+import MuteStates from '../../types/MuteStates';
+import { CompositeUserId, IGetParticipantsParameters, OkUserId, ParticipantId, ParticipantStateData } from '../../types/Participant';
+import { DisplayLayoutRequest, ParticipantLayout } from '../../types/ParticipantLayout';
+import { ParticipantListChunkParameters } from '../../types/ParticipantListChunk';
+import ParticipantPriority from '../../types/ParticipantPriority';
+import { ParticipantStreamDescription } from '../../types/ParticipantStreamDescription';
+import { ScreenCaptureSettings } from '../../types/ScreenCaptureSettings';
+import SignalingMessage from '../../types/SignalingMessage';
+import { WaitingHallResponse } from '../../types/WaitingHall';
+import EventEmitter from '../EventEmitter';
 export default class Conversation extends EventEmitter {
     private readonly _api;
     private readonly _signaling;
@@ -42,7 +43,6 @@ export default class Conversation extends EventEmitter {
     private _waitingHallHoldPending;
     private _participantState;
     private _participants;
-    private _pendingParticipants;
     private _directTransportIsMaster?;
     private _transport;
     private _debugInfo;
@@ -57,9 +57,12 @@ export default class Conversation extends EventEmitter {
     private _serverSettings;
     private _serverTimeOffset;
     private _delayedHangup;
+    private _hangupEmitted;
+    private _hangupPromise;
     private _abortController;
     private _registeredPeerReceived;
     private _calleeUnavailableTimer;
+    private _reservedId;
     private readonly _onUnload;
     private readonly _audioOutput;
     private readonly _stats;
@@ -82,22 +85,17 @@ export default class Conversation extends EventEmitter {
     get mediaSettings(): MediaSettings | undefined;
     get isCallHeld(): boolean;
     static debugSessionId(): string | null;
+    static debugMessage(type: DebugMessageType, ...args: any[]): boolean;
+    static debugMessageWithContext(type: DebugMessageType, conversationId: string, ...args: any[]): boolean;
     static getSyncedTime(): number;
     get debugSessionId(): string | null;
+    getCachedRawOkIdByExternalId(externalId: ExternalId): OkUserId | null;
     onStart({ opponentIds, opponentType, mediaOptions, payload, joiningAllowed, requireAuthToJoin, onlyAdminCanShareMovie, externalIds, onFastStart, conversationId, }: ConversationOnStartParams): Promise<ConversationData>;
-    onJoin(joinArgs: {
-        conversationId?: string;
-        mediaOptions: MediaOption[];
-        chatId?: string;
-        joinLink?: string;
-        observedIds?: ExternalUserId[];
-        payload?: string;
-        onFastJoin?: FastJoinHandler;
-    }): Promise<ConversationData>;
+    onJoin(joinArgs: ConversationOnJoinParams): Promise<ConversationData>;
     private _onJoinPart2;
     private _extractExternalRooms;
     private _extractExternalRoomsData;
-    onPush(conversationId: string, type?: UserType, peerId?: number, conversationParams?: string, wsEndpoint?: string): Promise<void>;
+    onPush(conversationId: string, type?: UserType, peerId?: number, conversationParams?: string, wsEndpoint?: string, userId?: number): Promise<void>;
     private _isInWaitingHall;
     private _isWaitForAdmin;
     private _isRestricted;
@@ -106,10 +104,9 @@ export default class Conversation extends EventEmitter {
     private _acceptConcurrent;
     private _getMainRoomParticipants;
     private _decodeExternalConversationParams;
-    private _logCallStartEvent;
     accept(mediaOptions: MediaOption[]): Promise<ConversationData>;
-    decline(): Promise<void>;
-    hangup(): Promise<void>;
+    decline(reason?: ClientHangupReason): Promise<void>;
+    hangup(reason?: ClientHangupReason): Promise<void>;
     addParticipant(participantIds: ExternalId[], params?: AddParticipantParams): Promise<void>;
     addParticipantLegacy(participantIds: CompositeUserId[], params?: AddParticipantParams): Promise<void>;
     removeParticipant(participantId: CompositeUserId, ban?: boolean): Promise<void>;
@@ -117,8 +114,11 @@ export default class Conversation extends EventEmitter {
     updateStatisticsInterval(): void;
     private _openTransport;
     private _allocateParticipantTransport;
+    private _cleanupRegistry;
+    private _emitHangupOnce;
     private _close;
-    destroy(): Promise<void>;
+    destroy(): void;
+    private _destroy;
     private _getConversationParams;
     private _setConversationParams;
     private _buildSignalingEndpoint;
@@ -197,10 +197,13 @@ export default class Conversation extends EventEmitter {
     private _cleanupParticipants;
     private _cleanupParticipantAgnosticStreams;
     private _cleanupTransport;
+    private _finishLifecycle;
+    private _getFirstMediaSentCallback;
+    private _stopFirstMediaSentProbe;
     private _cleanupTransportForHold;
     private _cleanupSpeakerDetector;
     private _cleanupSpecListener;
-    private _cleanupSignaling;
+    private _disposeSignaling;
     private _onAddParticipant;
     private _onRemoveParticipant;
     changeDevice(kind: MediaDeviceKind): Promise<void>;
@@ -233,7 +236,7 @@ export default class Conversation extends EventEmitter {
     private _getWaitingForPromotionStatus;
     putHandsDown(): Promise<void>;
     requestKeyFrame(participantStreamDescription: ParticipantStreamDescription): Promise<void | SignalingMessage>;
-    requestTestMode(consumerCommand: string, producerCommand: string): Promise<void>;
+    requestTestMode(consumerCommand: string, producerCommand: string): Promise<void | SignalingMessage>;
     updateDisplayLayout(layouts: ParticipantLayout[]): Promise<void>;
     requestDisplayLayout(requests: DisplayLayoutRequest[]): Promise<void>;
     feedback(key: string): Promise<SignalingMessage>;
@@ -362,7 +365,7 @@ export default class Conversation extends EventEmitter {
     private _onRecordInfo;
     private _onStopRecordInfo;
     private _changePinnedParticipantForRoom;
-    _changeRecordInfoForRoom(): Promise<void>;
+    _changeRecordInfoForRoom(): void;
     private _changeAsrInfoForRoom;
     private _changeUrlSharingInfoForRoom;
     private _onParticipantAnimojiChanged;
@@ -437,7 +440,6 @@ export default class Conversation extends EventEmitter {
     private _setMuteStatesForRoomId;
     private _forceOpenTransportForAloneInCall;
     private _registerParticipant;
-    private _getParticipants;
     private _getParticipant;
 }
 declare function _resetPendingInstance(): void;

package/classes/conversation/Conversation.testUtils.d.ts

@@ -0,0 +1,148 @@
+import { FetchMock } from 'vitest-fetch-mock';
+import { Mock } from 'vitest';
+import { Client, Server } from 'mock-socket';
+import { ISharedMovieInfo, OkUserId } from '../../CallsSDK';
+import Api from '../../default/Api';
+import CallDirection from '../../enums/CallDirection';
+import ConversationOption from '../../enums/ConversationOption';
+import TransportState from '../../enums/TransportState';
+import TransportTopology from '../../enums/TransportTopology';
+import { ParticipantStatus } from '../../static/External';
+import { ExternalParticipantId } from '../../types/ExternalId';
+import { ParticipantListMarkers } from '../../types/Participant';
+import SignalingMessage from '../../types/SignalingMessage';
+import Conversation from './Conversation';
+declare function createParams(): {
+    apiKey: string;
+    apiEnv: string;
+    onLocalStream: Mock<import("@vitest/spy").Procedure>;
+    onLocalStatus: Mock<import("@vitest/spy").Procedure>;
+    onConversation: Mock<import("@vitest/spy").Procedure>;
+    onLocalSharedMovieInfo: Mock<import("@vitest/spy").Procedure>;
+    onRemoteSharedMovieInfo: Mock<import("@vitest/spy").Procedure>;
+    onRemoteSharedUrl: Mock<import("@vitest/spy").Procedure>;
+    onCallState: Mock<import("@vitest/spy").Procedure>;
+    onOptionsChanged: Mock<import("@vitest/spy").Procedure>;
+    onPinnedParticipant: Mock<import("@vitest/spy").Procedure>;
+    onRemoteMediaSettings: Mock<import("@vitest/spy").Procedure>;
+    onRemoteParticipantState: Mock<import("@vitest/spy").Procedure>;
+    onLocalPin: Mock<import("@vitest/spy").Procedure>;
+    onDebugMessage: Mock<import("@vitest/spy").Procedure>;
+    onHangup: Mock<import("@vitest/spy").Procedure>;
+    onRemoteRemoved: Mock<import("@vitest/spy").Procedure>;
+    onConversationParticipantListChunk: Mock<import("@vitest/spy").Procedure>;
+    onRoomParticipantsUpdated: Mock<import("@vitest/spy").Procedure>;
+    onChatRoomUpdated: Mock<import("@vitest/spy").Procedure>;
+    onRemoteStatus: Mock<import("@vitest/spy").Procedure>;
+    onSpeakerChanged: Mock<import("@vitest/spy").Procedure>;
+};
+export type ConversationTestParams = ReturnType<typeof createParams>;
+export type ConversationTestTools = {
+    readonly endpointURL: string;
+    readonly fetchMocker: FetchMock;
+    readonly params: ConversationTestParams;
+    readonly server: Server;
+    readonly wsBaseURL: string;
+    createConnectionMessage(data?: Partial<SignalingMessage.Connection>): SignalingMessage.Connection;
+    createConversation(options?: {
+        api?: Api;
+    }): Conversation;
+    createExternalIdMock(id: string, data?: Partial<ExternalParticipantId>): ExternalParticipantId;
+    createMarkers(data?: Partial<ParticipantListMarkers>): ParticipantListMarkers;
+    createMovieShareInfo(initiatorId: string, data?: Partial<ISharedMovieInfo> | null): ISharedMovieInfo;
+    createParticipant(id: number, data?: Partial<SignalingMessage.Participant>): SignalingMessage.Participant & Required<Pick<SignalingMessage.Participant, 'markers'>>;
+    createParticipantWithMarkers(id: number, data?: Partial<SignalingMessage.Participant>): SignalingMessage.Participant & Required<Pick<SignalingMessage.Participant, 'markers'>>;
+    createPromoteParticipantMessage(): SignalingMessage.PromoteParticipant;
+    createSignallingConversation(okUserId: OkUserId, peerId: SignalingMessage.PeerId, data?: Partial<SignalingMessage.Conversation>): SignalingMessage.Conversation;
+    createWaitingHallConversationData(): ReturnType<typeof createWaitingHallConversationData>;
+    emitMessageOnConnection(wsServer: Server, message?: SignalingMessage.Connection): void;
+    enableParticipantListChunk(): void;
+    expectRemoteStatus(status: ParticipantStatus, participantId?: string): Promise<void>;
+    expectRemoteStatusCall(status: ParticipantStatus, participantId?: string): void;
+    forgetConversation(conversation: Conversation): void;
+    getActiveSocket(wsServer: Server): Client;
+    hasRemoteStatusCall(status: ParticipantStatus, participantId?: string): boolean;
+    isCapabilityEnabled(predicateIndex: number, wsServer: Server): boolean;
+    parseUrlSearch(search: string): Record<string, string>;
+    resetRemoteStatusCallbacks(): void;
+    respondOnGetParticipantListChunkWith(data: Partial<SignalingMessage.ParticipantListChunk>): void;
+    sendAcceptedCall(participant: SignalingMessage.Participant): void;
+    sendHungup(participant: SignalingMessage.Participant): void;
+    sendSessionState(participant: SignalingMessage.Participant | number, connected: boolean, data?: Partial<SignalingMessage.SessionState>): void;
+    setApiAuth(data?: {
+        sessionKey?: string;
+        sessionSecretKey?: string;
+    }): void;
+    setTransportState(conversation: Conversation, state: TransportState): void;
+    socketRespondWith(socket: Client, command: string, response: SignalingMessage): void;
+    socketSendNotification(socket: Client, notification: string, response?: SignalingMessage): void;
+    startConversation(message?: SignalingMessage.Connection): Promise<Conversation>;
+    startConversationWithParticipants(participants: SignalingMessage.Participant[], peerId?: SignalingMessage.PeerId): Promise<Conversation>;
+    startConversationWithRemoteParticipant(remoteParticipantData?: Partial<SignalingMessage.Participant>): Promise<{
+        conversation: Conversation;
+        meParticipant: SignalingMessage.Participant;
+        remoteParticipant: SignalingMessage.Participant;
+    }>;
+    stubApiRequest(endpoint: string, method: string, data: object): void;
+    waitFor(fn: () => Promise<boolean> | boolean, message?: string, timeout?: number): Promise<true>;
+    flushSdkCallbacks(): Promise<null>;
+};
+export declare function defineConversationTests(name: string, defineTests: (tools: ConversationTestTools) => void): void;
+export declare function createExternalIdMock(id: string, data?: Partial<ExternalParticipantId>): ExternalParticipantId;
+export declare function enableParticipantListChunk(): void;
+export declare function setApiAuth(data?: {
+    sessionKey?: string;
+    sessionSecretKey?: string;
+}): void;
+export declare function setTransportState(conversation: Conversation, state: TransportState): void;
+export declare function socketRespondWith(socket: Client, command: string, response: SignalingMessage): void;
+export declare function socketSendNotification(socket: Client, notification: string, response?: SignalingMessage): void;
+export declare function createWaitingHallConversationData(): {
+    acceptTime: null;
+    asrInfo: null;
+    asrInfoByRoom: Map<any, any>;
+    audienceMode: boolean;
+    chatId: null;
+    compositeUserId: string;
+    concurrent: boolean;
+    direction: CallDirection;
+    externalId: ExternalParticipantId;
+    features: never[];
+    featuresPerRole: null;
+    id: string;
+    mediaModifiers: {
+        denoise: boolean;
+        denoiseAnn: boolean;
+    };
+    muteStates: Map<any, any>;
+    muteStatesPersonal: {};
+    needRate: boolean;
+    networkRating: number;
+    observer: boolean;
+    options: ConversationOption[];
+    participantsLimit: number;
+    pinnedParticipantIdByRoom: Map<any, any>;
+    recordsInfoByRoom: Map<any, any>;
+    restricted: boolean;
+    roles: never[];
+    roomId: number | null;
+    topology: TransportTopology;
+    urlSharingInfoByRoom: Map<any, any>;
+    userId: number;
+    waitForAdmin: boolean;
+    waitingHall: boolean;
+};
+export declare function createPromoteParticipantMessage(): SignalingMessage.PromoteParticipant;
+export declare function emitMessageOnConnection(wsServer: Server, message?: SignalingMessage.Connection): void;
+export declare function getActiveSocket(wsServer: Server): Client;
+export declare function isCapabilityEnabled(predicateIndex: number, wsServer: Server): boolean;
+export declare function parseUrlSearch(search: string): Record<string, string>;
+export declare function flushSdkCallbacks(): Promise<null>;
+export declare function waitFor(fn: () => Promise<boolean> | boolean, message?: string, timeout?: number): Promise<true>;
+export declare function createSignallingConversation(okUserId: OkUserId, peerId: SignalingMessage.PeerId, data?: Partial<SignalingMessage.Conversation>): SignalingMessage.Conversation;
+export declare function createConnectionMessage(data?: Partial<SignalingMessage.Connection>): SignalingMessage.Connection;
+export declare function createParticipant(id: number, data?: Partial<SignalingMessage.Participant>): SignalingMessage.Participant & Required<Pick<SignalingMessage.Participant, 'markers'>>;
+export declare function createParticipantWithMarkers(id: number, data?: Partial<SignalingMessage.Participant>): SignalingMessage.Participant & Required<Pick<SignalingMessage.Participant, 'markers'>>;
+export declare function createMarkers(data?: Partial<ParticipantListMarkers>): ParticipantListMarkers;
+export declare function createMovieShareInfo(initiatorId: string, data?: Partial<ISharedMovieInfo> | null): ISharedMovieInfo;
+export {};

package/classes/{ConversationResponseValidator.d.ts → conversation/ConversationResponseValidator.d.ts}

@@ -1,3 +1,3 @@
-import ConversationResponse from '../types/ConversationResponse';
+import ConversationResponse from '../../types/ConversationResponse';
 export type ConversationResponseSource = 'startConversation' | 'joinConversation' | 'joinConversationByLink' | 'fastStart' | 'fastJoin';
 export declare function assertValidConversationResponse(response: ConversationResponse | null | undefined, source: ConversationResponseSource): void;

package/classes/{DisplayLayoutRequester.d.ts → conversation/DisplayLayoutRequester.d.ts}

@@ -1,11 +1,11 @@
-import BaseApi from '../abstract/BaseApi';
-import type { DebugLogger } from '../static/Debug';
-import { DisplayLayoutRequest, ParticipantLayout } from '../types/ParticipantLayout';
-import { Participant, ParticipantId } from '../types/Participant';
+import BaseApi from '../../abstract/BaseApi';
+import type { DebugLogger } from '../../static/Debug';
+import { DisplayLayoutRequest, ParticipantLayout } from '../../types/ParticipantLayout';
+import { Participant, ParticipantId } from '../../types/Participant';
 type DisplayLayoutRequesterParams = {
     api: BaseApi;
     debug: DebugLogger;
-    getParticipants: () => Promise<Record<ParticipantId, Participant>>;
+    getParticipants: () => Record<ParticipantId, Participant>;
     isMe: (participantId: ParticipantId) => boolean;
     updateDisplayLayout: (layouts: ParticipantLayout[]) => Promise<void>;
 };

package/classes/conversation/index.d.ts

@@ -0,0 +1 @@
+export { default } from './Conversation';

package/classes/stat/CallFinishClassifier.d.ts

@@ -0,0 +1,11 @@
+export type SemanticCallFinishReason = 'hangup' | 'canceled' | 'rejected' | 'busy' | 'missed' | 'timeout' | 'another_device' | 'removed' | 'banned' | 'initially_closed' | 'call_timeout' | 'socket_closed' | 'killed' | 'killed_without_delete' | 'obsolete_client' | 'unavailable';
+export type ClassifiedCallFinish = {
+    reason: SemanticCallFinishReason;
+    string_value?: string;
+} | {
+    reason: 'error';
+    string_value: string;
+} | {
+    reason: 'failed';
+};
+export declare function classifyCallFinish(error: unknown): ClassifiedCallFinish;

package/classes/stat/CallLifecycleStats.d.ts

@@ -0,0 +1,42 @@
+import StatsLogger from '../StatsLogger';
+export type CallLifecycleSource = 'outgoing' | 'incoming' | 'join' | 'anonym_join';
+export interface CallLifecycleInitializationParams {
+    source: CallLifecycleSource;
+    conversationId?: string;
+}
+export interface CallLifecycleClock {
+    wallNow(): number;
+    monotonicNow(): number;
+}
+export declare class CallLifecycleStats {
+    private readonly _logger;
+    private readonly _clock;
+    private _conversationId;
+    private _callStartLabel;
+    private _lifecycleStartedAtMonotonic;
+    private _pendingEvents;
+    private _callStarted;
+    private _accepted;
+    private _firstMediaSent;
+    private _finished;
+    private _destroyed;
+    constructor(logger: StatsLogger, clock?: CallLifecycleClock);
+    get firstMediaSentReported(): boolean;
+    get terminated(): boolean;
+    markInitializationStarted({ source, conversationId }: CallLifecycleInitializationParams): void;
+    bindConversationId(conversationId: string): void;
+    markCallStarted(): void;
+    markOutgoingAccepted(): void;
+    markIncomingAccepted(concurrent: boolean): void;
+    markFirstMediaSent(): void;
+    markFinished(reason: unknown): void;
+    markTerminated(): void;
+    destroy(): void;
+    private _canRecord;
+    private _durationSince;
+    private _finish;
+    private _ensureConversationId;
+    private _record;
+    private _flushPendingEvents;
+    private _logEvent;
+}

package/classes/stat/ConversationStats.d.ts

@@ -1,21 +1,22 @@
 import BaseApi from '../../abstract/BaseApi';
 import BaseLogger from '../../abstract/BaseLogger';
+import TransportTopology from '../../enums/TransportTopology';
 import HangupReason from '../HangupReason';
 import StatsLogger from '../StatsLogger';
-import TransportTopology from '../../enums/TransportTopology';
+import { CallLifecycleStats } from './CallLifecycleStats';
 import { CodecStatsAggregator } from './CodecStatsAggregator';
 import { StatAggregator } from './StatAggregator';
 import { StatPings } from './StatPings';
 import { StatSignalingCommands } from './StatSignalingCommands';
 export declare class ConversationStats {
     readonly logger: StatsLogger;
+    readonly lifecycle: CallLifecycleStats;
     readonly statAggregator: StatAggregator;
     readonly codecStatsAggregator: CodecStatsAggregator;
     readonly pings: StatPings;
     readonly signalingCommands: StatSignalingCommands;
     constructor(api: BaseApi, externalLogger: BaseLogger | null, getConversationId: () => string | null, getTopology: () => TransportTopology | undefined);
-    logHangup(reason: HangupReason, topology?: TransportTopology): void;
-    flushCallMetrics(topology?: TransportTopology): void;
+    logHangup(reason: HangupReason): void;
+    flushCallMetrics(): void;
     destroy(): void;
-    private static correctHangupReason;
 }

package/classes/stat/FirstMediaSentProbe.d.ts

@@ -0,0 +1,13 @@
+export declare class FirstMediaSentProbe {
+    private readonly _peerConnection;
+    private readonly _onFirstMediaSent;
+    private readonly _pollIntervalMs;
+    private _timer;
+    private _state;
+    constructor(peerConnection: RTCPeerConnection, onFirstMediaSent: () => void, pollIntervalMs?: number);
+    start(): void;
+    destroy(): void;
+    private _getStatsReports;
+    private _poll;
+    private _scheduleNextPoll;
+}

package/classes/stat/StatPings.d.ts

@@ -1,6 +1,5 @@
 import { SignalingTransportType } from '../../enums/SignalingTransportStat';
 import StatsLogger from '../StatsLogger';
-import TransportTopology from '../../enums/TransportTopology';
 export declare class StatPings {
     private readonly _logger;
     private trackerByTransport;
@@ -12,6 +11,6 @@ export declare class StatPings {
      */
     mark(transport: SignalingTransportType): void;
     /** Отправляем данные в стату */
-    logMetrics(topology?: TransportTopology): void;
+    logMetrics(): void;
     destroy(): void;
 }

package/classes/stat/StatSignalingCommands.d.ts

@@ -1,12 +1,11 @@
 import { SignalingTransportType } from '../../enums/SignalingTransportStat';
 import StatsLogger from '../StatsLogger';
-import TransportTopology from '../../enums/TransportTopology';
 export declare class StatSignalingCommands {
     private readonly _logger;
     private trackerByCommand;
     constructor(logger: StatsLogger);
     mark(command: string, time: number, transport: SignalingTransportType): void;
     /** Отправляем данные в стату */
-    logMetrics(topology?: TransportTopology): void;
+    logMetrics(): void;
     destroy(): void;
 }

package/classes/transport/BaseTransport.d.ts

@@ -7,7 +7,13 @@ export default abstract class BaseTransport extends EventEmitter {
     protected readonly _mediaSource: MediaSource;
     protected _state: TransportState;
     protected _pc: RTCPeerConnection | null;
-    protected constructor(signaling: BaseSignaling, mediaSource: MediaSource);
+    private readonly _onFirstMediaSent;
+    private _firstMediaSentProbe;
+    private _firstMediaSentProbeStopped;
+    protected constructor(signaling: BaseSignaling, mediaSource: MediaSource, onFirstMediaSent?: (() => void) | null);
     getState(): TransportState;
+    stopFirstMediaSentProbe(): void;
     abstract close(error?: Error): void;
+    protected _startFirstMediaSentProbe(): void;
+    protected _disposeFirstMediaSentProbe(): void;
 }

package/classes/transport/DirectTransport.d.ts

@@ -43,7 +43,7 @@ export default class DirectTransport extends BaseTransport {
     private readonly _logger;
     private readonly _statAggregator;
     private readonly _codecStatsAggregator;
-    constructor(participantId: ParticipantId, isMaster: boolean, signaling: BaseSignaling, mediaSource: MediaSource, serverSettings: ServerSettings, debug?: DebugLogger, logger?: StatsLogger | null, statAggregator?: StatAggregator | null, codecStatsAggregator?: CodecStatsAggregator | null);
+    constructor(participantId: ParticipantId, isMaster: boolean, signaling: BaseSignaling, mediaSource: MediaSource, serverSettings: ServerSettings, debug?: DebugLogger, logger?: StatsLogger | null, statAggregator?: StatAggregator | null, codecStatsAggregator?: CodecStatsAggregator | null, onFirstMediaSent?: (() => void) | null);
     get participantId(): ParticipantId;
     updateStatisticsInterval(): void;
     private _isDeadConnection;
@@ -57,6 +57,7 @@ export default class DirectTransport extends BaseTransport {
     private _disposePeerConnection;
     setAnimojiTransport(receiver: AnimojiReceiver, sender: AnimojiSender): void;
     close(error?: Error): void;
+    private _finishClose;
     private _setState;
     private _onSignalingNotification;
     private _handleTransmittedData;

package/classes/transport/ServerTransport.d.ts

@@ -43,11 +43,12 @@ export default class ServerTransport extends BaseTransport {
     private _producerSessionId;
     private _newAudioShareTrack;
     private _simulcastInfo;
+    private _isSimulcastNegotiated;
     private readonly _debug;
     private readonly _logger;
     private readonly _statAggregator;
     private readonly _codecStatsAggregator;
-    constructor(signaling: BaseSignaling, mediaSource: MediaSource, serverSettings: ServerSettings, debug?: DebugLogger, logger?: StatsLogger | null, statAggregator?: StatAggregator | null, codecStatsAggregator?: CodecStatsAggregator | null);
+    constructor(signaling: BaseSignaling, mediaSource: MediaSource, serverSettings: ServerSettings, debug?: DebugLogger, logger?: StatsLogger | null, statAggregator?: StatAggregator | null, codecStatsAggregator?: CodecStatsAggregator | null, onFirstMediaSent?: (() => void) | null);
     updateStatisticsInterval(): void;
     open(observer?: boolean): void;
     close(error?: Error): void;

package/classes/transport/Transport.d.ts

@@ -48,13 +48,16 @@ export declare class Transport extends EventEmitter {
     private readonly _logger;
     private readonly _statAggregator;
     private readonly _codecStatsAggregator;
-    constructor(topology: TransportTopology, signaling: BaseSignaling, mediaSource: MediaSource, serverSettings: ServerSettings, debug?: DebugLogger, logger?: StatsLogger | null, statAggregator?: StatAggregator | null, codecStatsAggregator?: CodecStatsAggregator | null);
+    private readonly _onFirstMediaSent;
+    private _firstMediaSentProbeStopped;
+    constructor(topology: TransportTopology, signaling: BaseSignaling, mediaSource: MediaSource, serverSettings: ServerSettings, debug?: DebugLogger, logger?: StatsLogger | null, statAggregator?: StatAggregator | null, codecStatsAggregator?: CodecStatsAggregator | null, onFirstMediaSent?: (() => void) | null);
     updateSettings(settings: ServerSettings): void;
     updateStatisticsInterval(): void;
     allocate(participantId: ParticipantId, isMaster?: boolean): void;
     open(participantIds: ParticipantId[], peerId?: string | null, observer?: boolean, force?: boolean): void;
     close(participantId: ParticipantId): void;
     destroy(): void;
+    stopFirstMediaSentProbe(): void;
     holdClose(): void;
     setRemoteHold(hold: boolean): void;
     getTopology(): TransportTopology;
@@ -69,6 +72,8 @@ export declare class Transport extends EventEmitter {
     private _setStates;
     private _setLocalState;
     private _onSignalingNotification;
+    private _handleFirstMediaSent;
+    private _getFirstMediaSentCallback;
     private _onTopologyChanged;
     private _createDirectTransport;
     private _createServerTransport;