@vkontakte/calls-sdk 2.8.12-dev.2d04df5e.0 → 2.8.12-dev.2e0e572e.0

package/classes/ExternalIdCache.d.ts

@@ -1,20 +1,18 @@
 import { ExternalId, ExternalParticipantId } from '../types/ExternalId';
-import { CompositeUserId, OkUserId, ParticipantId } from '../types/Participant';
+import { ParticipantId } from '../types/Participant';
 export declare class ExternalIdCache {
     private static _normalizeType;
-    private _okIdToExternalId;
-    private _externalIdToOkId;
+    private _participantIdToExternalId;
+    private _externalIdToParticipantId;
     private _decorativeIdToInitialId;
     private _initialIdToDecorativeId;
-    getOkId(externalId: ExternalId): OkUserId | null;
-    getExternalId(okId: OkUserId): ExternalParticipantId | null;
+    getExternalId(participantId: ParticipantId): ExternalParticipantId | null;
+    getParticipantId(externalId: ExternalId): ParticipantId | null;
     hasByExternalId(externalId: ExternalId): boolean;
-    hasByOkId(okId: OkUserId): boolean;
-    cache(participantId: OkUserId | CompositeUserId | ParticipantId, externalId: ExternalParticipantId): void;
-    mapDecorativeId(decorativeId: OkUserId | CompositeUserId | ParticipantId, initialId: OkUserId | CompositeUserId | ParticipantId): void;
-    unmapDecorativeId(initialId: OkUserId | CompositeUserId | ParticipantId): void;
-    getDecorativeIdByInitialId(initialId: OkUserId | CompositeUserId | ParticipantId): OkUserId | undefined;
-    replaceByInitialIdIdIfExists(id: OkUserId | CompositeUserId | ParticipantId): OkUserId;
-    getParticipantIdByExternalId(externalId: ExternalId): ParticipantId | null;
+    hasByParticipantId(participantId: ParticipantId): boolean;
+    cache(participantId: ParticipantId, externalId: ExternalParticipantId): void;
+    mapDecorativeId(decorativeId: ParticipantId, initialId: ParticipantId): void;
+    unmapDecorativeId(initialId: ParticipantId): void;
+    getDecorativeIdByInitialId(initialId: ParticipantId): ParticipantId | undefined;
     clear(): void;
 }

package/classes/conversation/Conversation.d.ts

@@ -5,7 +5,6 @@ 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';
@@ -16,11 +15,12 @@ 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 type { FastHangupHandler, HangupParams } from '../../types/FastHangup';
 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 { CompositeUserId, IGetParticipantsParameters, ParticipantId, ParticipantStateData } from '../../types/Participant';
 import { DisplayLayoutRequest, ParticipantLayout } from '../../types/ParticipantLayout';
 import { ParticipantListChunkParameters } from '../../types/ParticipantListChunk';
 import ParticipantPriority from '../../types/ParticipantPriority';
@@ -57,6 +57,7 @@ export default class Conversation extends EventEmitter {
     private _serverSettings;
     private _serverTimeOffset;
     private _delayedHangup;
+    private _onFastHangup?;
     private _hangupEmitted;
     private _hangupPromise;
     private _abortController;
@@ -78,7 +79,7 @@ export default class Conversation extends EventEmitter {
     private readonly _statFirstMediaReceived;
     constructor(api: BaseApi, externalLogger: BaseLogger | null);
     static current(): Conversation | null;
-    static hangupAfterInit(): void;
+    static hangupAfterInit(onFastHangup?: FastHangupHandler): void;
     static id(): string | null;
     get id(): string;
     get externalId(): ExternalParticipantId | undefined;
@@ -89,7 +90,9 @@ export default class Conversation extends EventEmitter {
     static debugMessageWithContext(type: DebugMessageType, conversationId: string, ...args: any[]): boolean;
     static getSyncedTime(): number;
     get debugSessionId(): string | null;
-    getCachedRawOkIdByExternalId(externalId: ExternalId): OkUserId | null;
+    getCachedParticipantIdByExternalId(externalId: ExternalId): ParticipantId | null;
+    private _onNonFatalError;
+    private _buildInternalParams;
     onStart({ opponentIds, opponentType, mediaOptions, payload, joiningAllowed, requireAuthToJoin, onlyAdminCanShareMovie, externalIds, onFastStart, conversationId, }: ConversationOnStartParams): Promise<ConversationData>;
     onJoin(joinArgs: ConversationOnJoinParams): Promise<ConversationData>;
     private _onJoinPart2;
@@ -105,8 +108,8 @@ export default class Conversation extends EventEmitter {
     private _getMainRoomParticipants;
     private _decodeExternalConversationParams;
     accept(mediaOptions: MediaOption[]): Promise<ConversationData>;
-    decline(reason?: ClientHangupReason): Promise<void>;
-    hangup(reason?: ClientHangupReason): Promise<void>;
+    decline(params?: HangupParams): Promise<void>;
+    hangup(params?: HangupParams): Promise<void>;
     addParticipant(participantIds: ExternalId[], params?: AddParticipantParams): Promise<void>;
     addParticipantLegacy(participantIds: CompositeUserId[], params?: AddParticipantParams): Promise<void>;
     removeParticipant(participantId: CompositeUserId, ban?: boolean): Promise<void>;
@@ -114,10 +117,12 @@ export default class Conversation extends EventEmitter {
     updateStatisticsInterval(): void;
     private _openTransport;
     private _allocateParticipantTransport;
+    private _closeParticipantTransport;
     private _cleanupRegistry;
     private _emitHangupOnce;
     private _sendHangupApi;
     private _close;
+    private _sendHangup;
     destroy(): void;
     private _destroy;
     private _getConversationParams;
@@ -160,8 +165,9 @@ export default class Conversation extends EventEmitter {
     private _registerParticipantInCache;
     private _getExistedParticipantByIdOrCreate;
     private _getExternalIdByParticipantId;
-    private _getExternalIdsByOkIdsFromCache;
-    private _getOrCacheExternalIdByCompositeId;
+    private _getExternalIdsByParticipantIds;
+    private _reportMissingExternalIds;
+    private _reportMissingExternalIdsById;
     private _registerParticipantAndSetMarkersIfChunkEnabled;
     private _warnParticipantNotInConversation;
     private _denormalizeMarkers;
@@ -222,8 +228,6 @@ export default class Conversation extends EventEmitter {
     setAnimojiFill(fill: RGBTuple | string): void;
     setVideoStream(stream: MediaStream, isScreen?: boolean): Promise<void>;
     setAudioStream(stream: MediaStream): Promise<void>;
-    private readonly _toggleLocalVideo;
-    private readonly _toggleLocalAudio;
     toggleLocalVideo(enabled: boolean): Promise<void>;
     toggleLocalAudio(enabled: boolean): Promise<void>;
     /**
@@ -420,8 +424,6 @@ export default class Conversation extends EventEmitter {
     private _toggleJoinAvailability;
     private _updateDisplayLayoutFromCache;
     private _setParticipantsStatus;
-    private _setParticipantsStalled;
-    private _updateParticipantsStatus;
     private _onJoinLinkChanged;
     private _onRoomsUpdated;
     private _onRoomUpdated;

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

@@ -35,6 +35,8 @@ declare function createParams(): {
     onChatRoomUpdated: Mock<import("@vitest/spy").Procedure>;
     onRemoteStatus: Mock<import("@vitest/spy").Procedure>;
     onSpeakerChanged: Mock<import("@vitest/spy").Procedure>;
+    onAcceptedCall: Mock<import("@vitest/spy").Procedure>;
+    onNonFatalError: Mock<import("@vitest/spy").Procedure>;
 };
 export type ConversationTestParams = ReturnType<typeof createParams>;
 export type ConversationTestTools = {

package/classes/conversation/DisplayLayoutRequester.d.ts

@@ -8,6 +8,7 @@ type DisplayLayoutRequesterParams = {
     getParticipants: () => Record<ParticipantId, Participant>;
     isMe: (participantId: ParticipantId) => boolean;
     updateDisplayLayout: (layouts: ParticipantLayout[]) => Promise<void>;
+    onNonFatalError: (message: string) => void;
 };
 export default class DisplayLayoutRequester {
     private readonly _api;
@@ -15,6 +16,7 @@ export default class DisplayLayoutRequester {
     private readonly _getParticipants;
     private readonly _isMe;
     private readonly _updateDisplayLayout;
+    private readonly _onNonFatalError;
     private _requestedLayouts;
     private _uncertainLayouts;
     private _pendingRequests;
@@ -25,7 +27,7 @@ export default class DisplayLayoutRequester {
     private _lastFlushAt;
     private _generation;
     private _forceNextFlush;
-    constructor({ api, debug, getParticipants, isMe, updateDisplayLayout }: DisplayLayoutRequesterParams);
+    constructor({ api, debug, getParticipants, isMe, updateDisplayLayout, onNonFatalError }: DisplayLayoutRequesterParams);
     request(requests: DisplayLayoutRequest[]): Promise<void>;
     resend(): void;
     cleanupParticipant(participantId: ParticipantId): void;

package/classes/transport/ServerTransport.d.ts

@@ -42,11 +42,12 @@ export default class ServerTransport extends BaseTransport {
     private _rtpReceiversByStreamId;
     private _producerSessionId;
     private _newAudioShareTrack;
+    private _simulcastInfo;
+    private _isSimulcastNegotiated;
     private readonly _debug;
     private readonly _logger;
     private readonly _statAggregator;
     private readonly _codecStatsAggregator;
-    private readonly _simulcast;
     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;
@@ -85,6 +86,8 @@ export default class ServerTransport extends BaseTransport {
     private _detectStaleTracks;
     private _allocateConsumer;
     private _processOffer;
+    private _findFirstSimTransceiver;
+    private _setupSimulcastTransceiver;
     private _acceptProducer;
     private _replaceScreenShareTrack;
     private _handleTracks;
@@ -99,6 +102,7 @@ export default class ServerTransport extends BaseTransport {
     private _onReplacedTrack;
     private _onSourcesChanged;
     getStreamWaitingTimeMs(streamId: string, targetRtpTimestamp: number): number;
+    private _changeSimulcastInfo;
     private _monitorRtpShare;
     private _startMonitorRtpShareInterval;
     private _stopMonitorRtpShareInterval;

package/default/Api.d.ts

@@ -5,14 +5,14 @@ import { IHangupParams } from '../types/Api';
 import ConversationParams from '../types/ConversationParams';
 import ConversationResponse from '../types/ConversationResponse';
 import { ExternalId, ExternalParticipantId, ExternalUserId } from '../types/ExternalId';
-import { CompositeUserId, OkUserId, ParticipantId } from '../types/Participant';
+import { OkUserId, ParticipantId } from '../types/Participant';
 import PushData from '../types/PushData';
 export default class Api extends BaseApi {
     private _uuid;
     private _idCache;
     private _callUnsafe;
     protected _call(method: string, data?: any, noSession?: boolean, allowReauthorize?: boolean): Promise<any>;
-    userId(participantId: ParticipantId): ExternalParticipantId;
+    userId(participantId: ParticipantId): ExternalParticipantId | null;
     authorize(): Promise<void>;
     private _getAnonymLoginCacheKey;
     private _getCachedAnonymLogin;
@@ -48,13 +48,11 @@ export default class Api extends BaseApi {
     getAnonymTokenByLink(joinLink: string, username?: string): Promise<string>;
     joinConversationByLink(joinLink: string, isVideo?: boolean, observedIds?: ExternalUserId[], payload?: string): Promise<ConversationResponse>;
     getCachedOkIdByExternalId(externalId: ExternalId): ParticipantId | null;
-    getCachedRawOkIdByExternalId(externalId: ExternalId): OkUserId | null;
-    getCachedExternalIdByOkId(okId: OkUserId): ExternalParticipantId | null;
-    cacheExternalId(participantId: OkUserId | CompositeUserId | ParticipantId, externalId: ExternalParticipantId): void;
-    mapDecorativeId(decorativeId: OkUserId | CompositeUserId | ParticipantId, initialId: OkUserId | CompositeUserId | ParticipantId): void;
-    unmapDecorativeId(initialId: OkUserId | CompositeUserId | ParticipantId): void;
-    getDecorativeIdByInitialId(initialId: OkUserId | CompositeUserId | ParticipantId): OkUserId | undefined;
-    replaceByInitialIdIdIfExists(id: OkUserId | CompositeUserId | ParticipantId): OkUserId;
+    getCachedExternalIdByParticipantId(participantId: ParticipantId): ExternalParticipantId | null;
+    cacheExternalId(participantId: ParticipantId, externalId: ExternalParticipantId): void;
+    mapDecorativeId(decorativeId: ParticipantId, initialId: ParticipantId): void;
+    unmapDecorativeId(initialId: ParticipantId): void;
+    getDecorativeIdByInitialId(initialId: ParticipantId): ParticipantId | undefined;
     getConversationParams(conversationId?: string): Promise<ConversationParams>;
     getUserId(): OkUserId | null;
     setUserId(userId: OkUserId): void;

package/package.json

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

package/static/External.d.ts

@@ -638,5 +638,15 @@ declare namespace External {
      * Собеседник подключился к сигналлингу
      */
     function onPeerRegistered(conversationId?: string, externalIds?: ExternalId[]): void;
+    /**
+     * SDK обнаружил ошибку, после которой звонок может продолжаться.
+     *
+     * Callback предназначен для отправки ошибки в клиентский мониторинг.
+     * Его вызов не означает завершение звонка.
+     *
+     * @param error
+     * @param conversationId ID звонка
+     */
+    function onNonFatalError(error: Error, conversationId: string | null): void;
 }
 export default External;

package/static/Params.d.ts

@@ -911,6 +911,13 @@ export type ParamsObject = {
      * Собеседник подключился к сигналлингу
      */
     onPeerRegistered?: (conversationId?: string, externalIds?: ExternalId[]) => void;
+    /**
+     * SDK обнаружил ошибку, после которой звонок может продолжаться.
+     *
+     * Callback предназначен для отправки ошибки в клиентский мониторинг.
+     * Его вызов не означает завершение звонка.
+     */
+    onNonFatalError?: (error: Error, conversationId: string | null) => void;
 };
 export default abstract class Params {
     private static _params;

package/static/ParticipantConnectionStatusUtils.d.ts

@@ -11,7 +11,6 @@ declare namespace ParticipantConnectionStatusUtils {
     function computeEffective(status: ParticipantConnectionStatus): ParticipantStatus;
     function setSessionState(status: ParticipantConnectionStatus, sessionState?: ParticipantSessionState, sessionStateConnectedBySpeaker?: boolean): StatusTransition;
     function setTransport(status: ParticipantConnectionStatus, transport: ParticipantStatus): StatusTransition;
-    function setStalled(status: ParticipantConnectionStatus, stalled: boolean): StatusTransition;
     function setSessionStateApplicable(status: ParticipantConnectionStatus, applicable: boolean): StatusTransition;
 }
 export default ParticipantConnectionStatusUtils;

package/static/SignalingCapabilities.d.ts

@@ -1,5 +1,5 @@
 /**
- * @see https://confluence.vk.team/display/CALLS/Websocket+Capability+Flags
+ * @see https://confluence.vk.team/display/VIDEOOK/Websocket+Capability+Flags
  */
 declare const PREDICATES: {
     readonly producerScreenTrack: () => boolean;

package/static/SimulcastInfo.d.ts

@@ -6,10 +6,8 @@ export declare const SIMULCAST_DEFAULT: {
     BITRATE: number;
 };
 export declare const SIMULCAST_SCALABILITY_MODE = "L1T2";
+export declare const MAP_RID_TO_SCALE_RESOLUTION_DOWN_BY: Record<string, number>;
 export declare function isEqualSimulcastInfo(si1: ISimulcastInfo | null, si2: ISimulcastInfo | null): boolean;
 export declare function findBitrateAsc(maxDimension: number, bitrates: VideoBitrateSettings[]): number;
-export declare function calculateSimulcastInfo(width?: number, height?: number, bitrates?: VideoBitrateSettings[], fps?: number): {
-    streams: import("../types/SimulcastInfo").SimulcastStreamInfo[];
-};
-export declare function findScaleResolutionDownBy(rid: string | undefined, simulcastInfo: ISimulcastInfo): number;
-export declare function applySimulcastInfoToEncodings(encodings: RTCRtpEncodingParameters[], simulcastInfo: ISimulcastInfo, maxDimension?: number, maxBitrate?: number): void;
+export declare function calculateSimulcastInfo(width?: number, height?: number, bitrates?: VideoBitrateSettings[]): ISimulcastInfo;
+export declare function findScaleResolutionDownBy(rid?: string): number;

package/static/Utils.d.ts

@@ -77,5 +77,6 @@ declare namespace Utils {
     function objectReduce<R, T extends object>(obj: T, callback: (acc: R, value: T[keyof T], key: keyof T) => R, initialValue: R): R;
     const setImmediate: (fn: VoidFunction) => VoidFunction;
     function isObject(obj: unknown): obj is object;
+    function patchSimulcastAnswerSdp(sdp: string, trans: RTCRtpTransceiver, width: number, height: number): string;
 }
 export default Utils;

package/types/Capabilities.d.ts

@@ -18,7 +18,6 @@ export type TCapabilities = {
     fastScreenShare: boolean;
     videoSuspend: boolean;
     simulcast: boolean;
-    simulcastNativeOrder: boolean;
     consumerFastScreenShare: boolean;
     consumerFastScreenShareQualityOnDemand: boolean;
     transparentAudio: boolean;

package/types/FastHangup.d.ts

@@ -0,0 +1,66 @@
+import type ClientHangupReason from '../enums/ClientHangupReason';
+import type HangupType from '../enums/HangupType';
+/**
+ * Параметры запроса завершения звонка через внешнего партнёра (fast hangup).
+ *
+ * SDK генерирует объект и передаёт его в {@link FastHangupHandler}.
+ * Хост и backend партнёра пробрасывают `internalParams` как есть, без парсинга.
+ */
+export interface FastHangupParams {
+    /**
+     * ID звонка
+     */
+    conversationId: string;
+    /**
+     * Причина завершения звонка
+     */
+    reason: HangupType;
+    /**
+     * Внутренние параметры звонка (JSON-строка). Генерируется SDK.
+     */
+    internalParams?: string | null;
+}
+/**
+ * Ответ внешнего партнёра на завершение звонка.
+ */
+export interface FastHangupResponse {
+    /**
+     * true — участие в звонке завершено
+     */
+    success: boolean;
+}
+/**
+ * Параметры публичных методов {@link hangup} / {@link declineCall}.
+ *
+ * `reason` и `conversationId` идут в signaling hangup.
+ * `onFastHangup` заменяет Calls API `vchat.hangupConversation`, если обработчик передан
+ * (явный hangup/decline или delayed hangup во время init).
+ * Если обработчик не передан, API hangup не вызывается — кроме закрытия вкладки (`pagehide`),
+ * где SDK всегда шлёт beacon, и delayed hangup без handler.
+ */
+export interface HangupParams {
+    /**
+     * ID звонка. Если опущен — завершается текущий активный звонок.
+     */
+    conversationId?: string;
+    /**
+     * Причина завершения для проброса в сигналинг. См. {@link ClientHangupReason}.
+     */
+    reason?: ClientHangupReason;
+    /**
+     * Обработчик fast hangup — завершение звонка через внешнего партнёра.
+     */
+    onFastHangup?: FastHangupHandler;
+}
+/**
+ * Функция-обработчик fast hangup.
+ *
+ * Если передана в {@link HangupParams.onFastHangup} при `hangup` / `declineCall`,
+ * SDK вызывает её вместо API `vchat.hangupConversation`.
+ *
+ * На `pagehide` не используется — SDK всегда отправляет `sendBeacon`.
+ *
+ * @param params Параметры запроса
+ * @param signal AbortSignal текущего звонка, если он ещё жив на момент вызова
+ */
+export type FastHangupHandler = (params: FastHangupParams, signal?: AbortSignal) => Promise<FastHangupResponse>;

package/types/Participant.d.ts

@@ -49,7 +49,6 @@ export interface ParticipantSessionState {
 }
 export interface ParticipantConnectionStatus {
     transport: ParticipantStatus;
-    stalled: boolean;
     sessionState?: ParticipantSessionState;
     sessionStateApplicable: boolean;
     sessionStateConnectedBySpeaker: boolean;

package/classes/transport/SimulcastSender.d.ts

@@ -1,27 +0,0 @@
-import BaseSignaling from '../../abstract/BaseSignaling';
-import { type DebugLogger } from '../../static/Debug';
-import type VideoSettings from '../../types/VideoSettings';
-import { MediaSource } from '../MediaSource';
-import StatsLogger from '../StatsLogger';
-export default class SimulcastSender {
-    private _pc;
-    private _transceiver;
-    private _simulcastInfo;
-    private readonly _signaling;
-    private readonly _mediaSource;
-    private readonly _getCameraSettings;
-    private readonly _debug;
-    private readonly _logger;
-    constructor(signaling: BaseSignaling, mediaSource: MediaSource, getCameraSettings: () => VideoSettings | null, debug?: DebugLogger, logger?: StatsLogger | null);
-    configureFromRemoteOffer(pc: RTCPeerConnection): Promise<void>;
-    finalizeAnswer(sdp: string): string;
-    sync({ force }?: {
-        force?: boolean;
-    }): Promise<void>;
-    replaceTrack(track: MediaStreamTrack): boolean;
-    reset(): void;
-    private _findTransceiver;
-    private _findMediaSection;
-    private _getTrackConfig;
-    private _syncReplacedTrack;
-}

package/static/Sdp.d.ts

@@ -1,3 +0,0 @@
-export declare const SDP_LINE_ENDING = "\r\n";
-export declare function splitSdpLines(sdp: string): string[];
-export declare function joinSdpLines(lines: string[]): string;

package/utils/SerializeLatest.d.ts

@@ -1,5 +0,0 @@
-/**
- * Последовательно выполняет операции, оставляя в очереди только последнее запрошенное значение.
- * Возвращает ошибку, только если не удалось применить итоговое состояние.
- */
-export declare function serializeLatest<T>(run: (value: T) => Promise<void> | undefined): (value: T) => Promise<void>;