@vkontakte/calls-sdk 2.8.12-dev.26c45af4.0 → 2.8.12-dev.35600965.0

package/classes/CallRegistry.d.ts

@@ -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/Conversation.d.ts

@@ -9,17 +9,17 @@ 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, ConversationOnStartParams } from '../types/Conversation';
-import { ExternalId, ExternalParticipant, ExternalParticipantId, ExternalParticipantListChunk, ExternalUserId } from '../types/ExternalId';
-import type { FastJoinHandler } from '../types/FastJoin';
+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, ParticipantId, ParticipantStateData } from '../types/Participant';
+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';
@@ -60,6 +60,7 @@ export default class Conversation extends EventEmitter {
     private _abortController;
     private _registeredPeerReceived;
     private _calleeUnavailableTimer;
+    private _reservedId;
     private readonly _onUnload;
     private readonly _audioOutput;
     private readonly _stats;
@@ -82,22 +83,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,7 +102,6 @@ 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>;
@@ -117,6 +112,7 @@ export default class Conversation extends EventEmitter {
     updateStatisticsInterval(): void;
     private _openTransport;
     private _allocateParticipantTransport;
+    private _cleanupRegistry;
     private _close;
     destroy(): void;
     private _getConversationParams;
@@ -197,6 +193,9 @@ export default class Conversation extends EventEmitter {
     private _cleanupParticipants;
     private _cleanupParticipantAgnosticStreams;
     private _cleanupTransport;
+    private _finishLifecycle;
+    private _getFirstMediaSentCallback;
+    private _stopFirstMediaSentProbe;
     private _cleanupTransportForHold;
     private _cleanupSpeakerDetector;
     private _cleanupSpecListener;

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/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,46 @@
+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 _warmupStartedAtMonotonic;
+    private _pendingEvents;
+    private _warmupCompleted;
+    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;
+    markWarmupStarted(): void;
+    markWarmupCompleted(): 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;

package/classes/transport/ServerTransport.d.ts

@@ -47,7 +47,7 @@ export default class ServerTransport extends BaseTransport {
     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;

package/default/Api.d.ts

@@ -7,11 +7,10 @@ import { ExternalId, ExternalParticipantId, ExternalUserId } from '../types/Exte
 import { CompositeUserId, OkUserId, ParticipantId } from '../types/Participant';
 import PushData from '../types/PushData';
 export default class Api extends BaseApi {
-    private _userId;
     private _uuid;
     private _idCache;
     private _callUnsafe;
-    protected _call(method: string, data?: any, noSession?: boolean): Promise<any>;
+    protected _call(method: string, data?: any, noSession?: boolean, allowReauthorize?: boolean): Promise<any>;
     userId(participantId: ParticipantId): ExternalParticipantId;
     authorize(): Promise<void>;
     private _getAnonymLoginCacheKey;

package/default/Signaling.d.ts

@@ -1,15 +1,15 @@
 import BaseSignaling, { AddParticipantParams } from '../abstract/BaseSignaling';
-import StatsLogger from '../classes/StatsLogger';
 import { ParticipantIdRegistry } from '../classes/ParticipantIdRegistry';
 import { SharingStatReport } from '../classes/screenshare/SharingStatReport';
 import { StatAggregator } from '../classes/stat/StatAggregator';
 import { StatPings } from '../classes/stat/StatPings';
 import { StatSignalingCommands } from '../classes/stat/StatSignalingCommands';
-import TransportTopology from '../enums/TransportTopology';
+import StatsLogger from '../classes/StatsLogger';
 import ConversationFeature from '../enums/ConversationFeature';
 import ConversationOption from '../enums/ConversationOption';
 import MediaOption from '../enums/MediaOption';
 import SignalingConnectionType from '../enums/SignalingConnectionType';
+import TransportTopology from '../enums/TransportTopology';
 import UserRole from '../enums/UserRole';
 import { type DebugLogger } from '../static/Debug';
 import { JSONObject } from '../static/Json';
@@ -75,7 +75,7 @@ export default class Signaling extends BaseSignaling {
     connect(connectionType: SignalingConnectionType): Promise<SignalingMessage.Connection>;
     getNextCommandSequenceNumber(): number;
     hangup(reason: string): Promise<SignalingMessage | void>;
-    sendCandidate(participantId: ParticipantId, candidate: RTCIceCandidate): Promise<SignalingMessage>;
+    sendCandidate(participantId: ParticipantId, candidate: RTCIceCandidateInit): Promise<SignalingMessage>;
     requestTestMode(consumerCommand: string, producerCommand: string | null): Promise<SignalingMessage>;
     sendSdp(participantId: ParticipantId, sdp: RTCSessionDescriptionInit, extraPayload?: Record<string, any>): Promise<SignalingMessage>;
     acceptCall(mediaSettings: MediaSettings): Promise<SignalingMessage>;
@@ -187,6 +187,8 @@ export default class Signaling extends BaseSignaling {
     private _onTransportFailed;
     private _onTransportReconnectScheduled;
     private _onTransportConnectionDead;
+    private _attachNotificationCallError;
+    private _createSignalingCallError;
     private _getSocketType;
     private _markTransportStat;
     private _logTransportStat;

package/default/SignalingTransport.d.ts

@@ -1,5 +1,6 @@
 import SignalingConnectionType from '../enums/SignalingConnectionType';
 import { SignalingTransportType } from '../enums/SignalingTransportStat';
+import { DebugLogger } from '../static/Debug';
 export declare enum SignalingTransportFailure {
     EMPTY_ENDPOINT = "EMPTY_ENDPOINT",
     NETWORK_ERROR = "NETWORK_ERROR",
@@ -8,6 +9,7 @@ export declare enum SignalingTransportFailure {
 export type SignalingTransportFailedEvent = {
     failure: SignalingTransportFailure;
     message: string;
+    source: SignalingTransportType;
     remote?: boolean;
 };
 export type SignalingTransportReconnectEvent = {
@@ -38,7 +40,8 @@ export default class SignalingTransport {
     private abortSignal;
     private manualClose;
     private currentType;
-    constructor(handlers: SignalingTransportHandlers);
+    private readonly _debug;
+    constructor(debug: DebugLogger | undefined, handlers: SignalingTransportHandlers);
     get readyState(): number | null;
     get type(): SignalingTransportType;
     setEndpoint(endpoint: string): void;

package/enums/HangupType.d.ts

@@ -20,7 +20,6 @@ declare enum HangupType {
     CALLER_IS_REJECTED = "CALLER_IS_REJECTED",
     UNKNOWN_ERROR = "UNKNOWN_ERROR",
     UNSUPPORTED = "UNSUPPORTED",
-    OLD_VERSION = "OLD_VERSION",
     SERVICE_DISABLED = "SERVICE_DISABLED",
     SERVICE_UNAVAILABLE = "SERVICE_UNAVAILABLE",
     EXTERNAL_API_ERROR = "EXTERNAL_API_ERROR",

package/enums/Stat.d.ts

@@ -1,4 +1,10 @@
 declare const enum Stat {
+    CALL_INIT = "call_init",
+    CALL_WARMUP = "call_warmup",
+    CALL_START = "call_start",
+    CALL_ACCEPTED_OUTGOING = "call_accepted_outgoing",
+    CALL_ACCEPTED_INCOMING = "call_accepted_incoming",
+    FIRST_MEDIA_SENT = "first_media_sent",
     CALL_FINISH = "call_finish",// событие отправляемое в конце звонка
     CODEC_USAGE = "codec_usage",// событие когда меняется кодек
     SIGNALING_CONNECTED = "signaling_connected",// measure
@@ -7,7 +13,6 @@ declare const enum Stat {
     FIRST_MEDIA_RECEIVED = "first_media_received",
     CALL_DECLINED_OR_HANGED_LOCALLY = "CallDeclinedOrHangedLocally",
     USER_FEEDBACK_RECEIVED = "UserFeedbackReceived",
-    CALL_START = "call_start",
     SIGNALING_PING_SUMMARY = "signaling_ping_summary",
     SIGNALING_COMMAND_SUMMARY = "signaling_command_summary",
     WEBSOCKET_CONNECTED = "websocket_connected",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vkontakte/calls-sdk",
-  "version": "2.8.12-dev.26c45af4.0",
+  "version": "2.8.12-dev.35600965.0",
   "author": "vk.com",
   "description": "Library for video calls based on the vk.com platform",
   "homepage": "https://vk.com",

package/static/AuthData.d.ts

@@ -1,12 +1,22 @@
+import type { OkUserId } from '../types/Participant';
 export default abstract class AuthData {
     private static _sessionKey;
     private static _sessionSecretKey;
     private static _accessToken;
+    private static _userId;
+    private static _reauthorizePromise;
     static get sessionKey(): string | undefined;
     static set sessionKey(value: string | undefined);
     static get sessionSecretKey(): string | undefined;
     static set sessionSecretKey(value: string | undefined);
     static get accessToken(): string | undefined;
     static set accessToken(value: string | undefined);
+    static get userId(): OkUserId | null;
+    static set userId(value: OkUserId | null);
     static isEmpty(): boolean;
+    /**
+     * Дедуплицирует одновременные попытки реавторизации из разных инстансов Api.
+     * Первый вызов выполняет authorizeFn, остальные ждут того же промиса.
+     */
+    static reauthorize(authorizeFn: () => Promise<void>): Promise<void>;
 }

package/static/Debug.d.ts

@@ -21,6 +21,7 @@ export type DebugSessionLogger = DebugLogger & {
     readonly sessionId: string | null;
     readonly conversationId: string | null;
     setConversationId(conversationId: string | null): void;
+    send(type: DebugMessageType, ...args: any[]): void;
 };
 declare namespace Debug {
     type ContextProvider = () => DebugMessageContext;

package/static/External.d.ts

@@ -637,6 +637,6 @@ declare namespace External {
     /**
      * Собеседник подключился к сигналлингу
      */
-    function onPeerRegistered(conversationId?: string): void;
+    function onPeerRegistered(conversationId?: string, externalIds?: ExternalId[]): void;
 }
 export default External;

package/static/Params.d.ts

@@ -485,13 +485,6 @@ export type ParamsObject = {
      * _По умолчанию: `false`_
      */
     webtransport: boolean;
-    /**
-     * Включить поддержку webtransport для сигналинга в FireFox
-     * Отдельная ручка, так как есть проблемы сейчас с FF
-     *
-     * _По умолчанию: `false`_
-     */
-    webtransportFF: boolean;
     /**
      * Ждать подтверждения от бэкенда для команд startStream/stopStream.
      * При включении: reject без соединения, resolve/reject по ответу бэкенда,
@@ -512,6 +505,16 @@ export type ParamsObject = {
      * _По умолчанию: `false`_
      */
     enableSessionStateUpdates: boolean;
+    /**
+     * Использовать `<audio>` вместо `<video>` для воспроизведения звука в desktop Safari
+     * @hidden
+     */
+    safariAudioElement: boolean;
+    /**
+     * Отправлять пустой ICE candidate (end-of-candidates) удалённому пиру
+     * @hidden
+     */
+    forwardEmptyIceCandidate: boolean;
     /**
      * Получен локальный стрим с камеры/микрофона
      */
@@ -899,7 +902,7 @@ export type ParamsObject = {
     /**
      * Собеседник подключился к сигналлингу
      */
-    onPeerRegistered?: (conversationId?: string) => void;
+    onPeerRegistered?: (conversationId?: string, externalIds?: ExternalId[]) => void;
 };
 export default abstract class Params {
     private static _params;
@@ -1031,10 +1034,11 @@ export default abstract class Params {
     static get enableVideoEffectsFpsDegradation(): boolean;
     static get simulcast(): boolean;
     static get webtransport(): boolean;
-    static get webtransportFF(): boolean;
     static get waitForRecordResponse(): boolean;
     static get transparentAudio(): boolean;
     static get enableSessionStateUpdates(): boolean;
+    static get safariAudioElement(): boolean;
+    static get forwardEmptyIceCandidate(): boolean;
     static toJSON(): {
         apiKey: string;
         apiEnv: string;
@@ -1068,9 +1072,10 @@ export default abstract class Params {
         switchVideoAtBadNetwork: boolean;
         simulcast: boolean;
         webtransport: boolean;
-        webtransportFF: boolean;
         waitForRecordResponse: boolean;
         transparentAudio: boolean;
         enableSessionStateUpdates: boolean;
+        safariAudioElement: boolean;
+        forwardEmptyIceCandidate: boolean;
     };
 }

package/static/WebRTCUtils.d.ts

@@ -122,6 +122,10 @@ declare namespace WebRTCUtils {
      * Проверяет поддержку WebRTC браузером
      */
     function isBrowserSupported(): boolean;
+    /**
+     * Возвращает первую отсутствующую capability в стабильном порядке.
+     */
+    function getBrowserSupportFailure(): BrowserSupportFailure | null;
     /**
      * Проверяет поддержку шаринга экрана браузером
      */
@@ -149,7 +153,9 @@ declare namespace WebRTCUtils {
      */
     function canPreferH264(): boolean;
     /**
-     * Некоторые браузеры (Firefox, Safari) некорректно поддерживают симулкаст
+     * Поддержка simulcast браузером.
+     * Safari корректно поддерживает simulcast начиная с версии 18.
+     * Firefox поддерживает simulcast с VP8 начиная с версии 134.
      */
     function isSimulcastSupportedByBrowser(): boolean;
     /**

package/types/Conversation.d.ts

@@ -7,7 +7,8 @@ import MediaOption from '../enums/MediaOption';
 import UserRole from '../enums/UserRole';
 import { AsrInfo } from './Asr';
 import { IFeaturesPerRole } from './ConversationFeature';
-import { ExternalId, ExternalParticipantId } from './ExternalId';
+import { ExternalId, ExternalParticipantId, ExternalUserId } from './ExternalId';
+import { FastJoinHandler } from './FastJoin';
 import { FastStartHandler } from './FastStart';
 import MediaModifiers from './MediaModifiers';
 import MuteStates from './MuteStates';
@@ -84,6 +85,16 @@ export type ConversationOnStartParams = {
     onFastStart?: FastStartHandler;
     conversationId?: string;
 };
+export type ConversationOnJoinParams = {
+    conversationId?: string;
+    mediaOptions: MediaOption[];
+    chatId?: string;
+    joinLink?: string;
+    observedIds?: ExternalUserId[];
+    payload?: string;
+    onFastJoin?: FastJoinHandler;
+    anonymous?: boolean;
+};
 export type StartConversationParams = {
     opponentIds?: OkUserId[];
     opponentType: CallType;
@@ -94,7 +105,6 @@ export type StartConversationParams = {
     requireAuthToJoin?: boolean;
     onlyAdminCanShareMovie?: boolean;
     externalIds?: ExternalId[];
-    startedTime: number;
     onFastStart?: FastStartHandler;
     conversationId?: string;
 };

package/types/SignalingMessage.d.ts

@@ -34,8 +34,11 @@ export type RecordInfo = {
     recordExternalOwnerId?: string;
 };
 export interface SignalingResponse extends SignalingMessage {
-    response?: SignalingCommandType;
     error?: string;
+    errorCode?: string;
+    errorMessage?: string;
+    message?: string;
+    response?: SignalingCommandType;
     reason?: HangupType | FatalError;
     sequence?: number;
     type: 'response' | 'error' | 'timeout';