@vkontakte/calls-sdk 2.8.11-beta.7 → 2.8.11-beta.9

package/classes/Conversation.d.ts

@@ -43,6 +43,7 @@ export default class Conversation extends EventEmitter {
     private _participantState;
     private _participants;
     private _pendingParticipants;
+    private _directTransportIsMaster?;
     private _transport;
     private _debugInfo;
     private readonly _debug;
@@ -113,6 +114,7 @@ export default class Conversation extends EventEmitter {
     setVolume(volume: number): void;
     updateStatisticsInterval(): void;
     private _openTransport;
+    private _allocateParticipantTransport;
     private _close;
     destroy(): Promise<void>;
     private _getConversationParams;
@@ -132,6 +134,7 @@ export default class Conversation extends EventEmitter {
     private _prepareConversation;
     private _createParticipant;
     private _getParticipantId;
+    private _cacheParticipantExternalIds;
     private _setConversation;
     private _updateConversation;
     private _createMediaSource;
@@ -144,10 +147,16 @@ export default class Conversation extends EventEmitter {
     private _registerParticipants;
     /** Установим состояние локальных мьютов */
     private _registerParticipantLocalMuteState;
-    private _getStatusByTransportState;
+    private _remoteParticipantSessionState;
+    private _buildConnectionStatus;
+    private _isParticipantSessionStateApplicable;
+    private _setTransportStatus;
+    private _setSessionState;
+    private _emitParticipantTransition;
     private _registerParticipantInCache;
     private _getExistedParticipantByIdOrCreate;
     private _getExternalIdByParticipantId;
+    private _getExternalIdsByOkIdsFromCache;
     private _registerParticipantAndSetMarkersIfChunkEnabled;
     private _warnParticipantNotInConversation;
     private _denormalizeMarkers;
@@ -224,8 +233,6 @@ export default class Conversation extends EventEmitter {
     updateDisplayLayout(layouts: ParticipantLayout[]): Promise<void>;
     requestDisplayLayout(requests: DisplayLayoutRequest[]): Promise<void>;
     feedback(key: string): Promise<SignalingMessage>;
-    userFeedbackStats(userResponse: number, reason?: string, groupCallUsersCount?: number): void;
-    sendClientEvent(eventType: string, eventData?: Record<string, string | number | boolean>, immediately?: boolean): void;
     private _changeMediaSettings;
     private _stopStreaming;
     /**
@@ -327,6 +334,11 @@ export default class Conversation extends EventEmitter {
     private _onSignalingFailed;
     private _onAcceptedCall;
     private _onHungup;
+    private _onSessionState;
+    private _reconcileParticipantSessionStates;
+    private _updateParticipantExternalId;
+    private _updateParticipantSessionState;
+    private _emitParticipantEffectiveStatusIfSessionOverridesTransport;
     private _onAddedParticipant;
     private _onJoinedParticipant;
     private _onClosedConversation;

package/classes/StatsLogger.d.ts

@@ -10,20 +10,17 @@ export default class StatsLogger extends BaseLogger {
     private readonly _conversationIdProvider;
     private readonly _batchInterval;
     private _batchedClientStats;
-    private _batchedClientEvents;
     private _batchTimeout;
     private _serverTimeDelta;
     constructor(api: BaseApi, externalLogger: BaseLogger | null, conversationIdProvider: () => string | null);
     log(name: StatLog, value?: string, immediately?: boolean): void;
     logClientStats(data: Record<string, string | number | boolean | undefined | null>, immediately?: boolean): void;
-    logClientEvent(data: Record<string, string | number | boolean | undefined | null>, immediately?: boolean): void;
     destroy(): void;
     private _getConversationId;
     private _sendBatch;
     private _startTimeout;
     private _stopTimeout;
     private _sendClientStats;
-    private _sendClientEvents;
     private _calculateServerTimeDelta;
     private _now;
 }

package/classes/transport/DirectTransport.d.ts

@@ -53,6 +53,8 @@ export default class DirectTransport extends BaseTransport {
     allowRestart(): void;
     setRemoteHold(hold: boolean): void;
     private _recreatePeerConnection;
+    private _createPeerConnection;
+    private _disposePeerConnection;
     setAnimojiTransport(receiver: AnimojiReceiver, sender: AnimojiSender): void;
     close(error?: Error): void;
     private _setState;

package/default/Api.d.ts

@@ -1,10 +1,11 @@
-import BaseApi, { ClientEvent, ClientStats } from '../abstract/BaseApi';
+import BaseApi, { ClientStats } from '../abstract/BaseApi';
 import CallType from '../enums/CallType';
 import HangupType from '../enums/HangupType';
 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 PushData from '../types/PushData';
 export default class Api extends BaseApi {
     private _userId;
     private _uuid;
@@ -19,7 +20,6 @@ export default class Api extends BaseApi {
     private _removeCachedAnonymLogin;
     private _applyAnonymLogin;
     logClientStats(items: ClientStats[]): void;
-    logClientEvents(items: ClientEvent[]): void;
     uploadDebugLogs(conversationId: string, startTime: number, endTime: number, log: string): Promise<void>;
     joinConversation(conversationId: string, isVideo?: boolean, chatId?: string): Promise<ConversationResponse>;
     createConversation(conversationId: string, payload?: string, requireAuthToJoin?: boolean, { onlyAdminCanShareMovie, audienceMode, audioOnly, waitForAdmin, closedConversation, }?: {
@@ -45,13 +45,9 @@ export default class Api extends BaseApi {
     }>;
     getAnonymTokenByLink(joinLink: string, username?: string): Promise<string>;
     joinConversationByLink(joinLink: string, isVideo?: boolean, observedIds?: ExternalUserId[], payload?: string): Promise<ConversationResponse>;
-    /**
-     * NB: Не сохраняет порядок возвращаемых ID
-     * @hidden
-     */
-    getExternalIdsByOkIds(uids: OkUserId[]): Promise<ExternalParticipantId[]>;
     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;
@@ -63,6 +59,6 @@ export default class Api extends BaseApi {
     hangupConversation(conversationId: string, reason?: HangupType): void;
     removeHistoryRecords(recordIds: number[]): Promise<void>;
     cleanup(): void;
-    private _getExternalIdsByOkIds;
     getServerTime(): Promise<number>;
+    getInbounds(): Promise<PushData[]>;
 }

package/default/Signaling.d.ts

@@ -174,6 +174,8 @@ export default class Signaling extends BaseSignaling {
     private _serializeErrorEvent;
     private _onClose;
     private _closeSocket;
+    private _isRecordCommand;
+    private _resolvePendingRecordCommands;
     private _handleCommandResponse;
     private _handleCommandsQueue;
     private _startResponseTimer;

package/enums/SignalingNotification.d.ts

@@ -24,6 +24,7 @@ declare enum SignalingNotification {
     REALLOC_CON = "realloc-con",
     AUDIO_ACTIVITY = "audio-activity",
     SPEAKER_CHANGED = "speaker-changed",
+    SESSION_STATE = "session-state",
     STALLED_ACTIVITY = "stalled-activity",
     CHAT_MESSAGE = "chat-message",
     CUSTOM_DATA = "custom-data",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vkontakte/calls-sdk",
-  "version": "2.8.11-beta.7",
+  "version": "2.8.11-beta.9",
   "author": "vk.com",
   "description": "Library for video calls based on the vk.com platform",
   "homepage": "https://vk.com",

package/static/Params.d.ts

@@ -256,13 +256,6 @@ export type ParamsObject = {
     perfStatReportEnabled: boolean;
     /** @hidden */
     callStatReportEnabled: boolean;
-    /**
-     * Включает логирование событий продуктовой статистики.
-     *
-     * _По умолчанию: `false`_
-     * @hidden
-     */
-    clientEventsLoggingEnabled: boolean;
     /**
      * Отдавать приоритет кодеку H264 для исходящего видео
      *
@@ -494,12 +487,26 @@ export type ParamsObject = {
      * _По умолчанию: `false`_
      */
     webtransportFF: boolean;
+    /**
+     * Ждать подтверждения от бэкенда для команд startStream/stopStream.
+     * При включении: reject без соединения, resolve/reject по ответу бэкенда,
+     * а при реконнекте — по стейту записи из Connection-сообщения.
+     *
+     * _По умолчанию: `false`_
+     */
+    waitForRecordResponse: boolean;
     /**
      * Включить поддержку прозрачного аудио
      *
      * _По умолчанию: `false`_
      */
     transparentAudio: boolean;
+    /**
+     * Включить получение обновлений состояния медийной сессии участников
+     *
+     * _По умолчанию: `false`_
+     */
+    enableSessionStateUpdates: boolean;
     /**
      * Получен локальный стрим с камеры/микрофона
      */
@@ -977,7 +984,6 @@ export default abstract class Params {
     static get networkStatisticsInterval(): number;
     static get perfStatReportEnabled(): boolean;
     static get callStatReportEnabled(): boolean;
-    static get clientEventsLoggingEnabled(): boolean;
     static get enableLogPerfStatReport(): boolean;
     static get asrDataChannel(): boolean;
     static get consumerScreenDataChannelPacketSize(): number;
@@ -1020,7 +1026,9 @@ export default abstract class Params {
     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 toJSON(): {
         apiKey: string;
         apiEnv: string;
@@ -1055,6 +1063,8 @@ export default abstract class Params {
         simulcast: boolean;
         webtransport: boolean;
         webtransportFF: boolean;
+        waitForRecordResponse: boolean;
         transparentAudio: boolean;
+        enableSessionStateUpdates: boolean;
     };
 }

package/static/ParticipantConnectionStatusUtils.d.ts

@@ -0,0 +1,16 @@
+import { ParticipantConnectionStatus, ParticipantSessionState } from '../types/Participant';
+import { ParticipantStatus } from './External';
+import TransportState from '../enums/TransportState';
+type StatusTransition = {
+    status: ParticipantStatus;
+    shouldNotify: boolean;
+};
+declare namespace ParticipantConnectionStatusUtils {
+    function create(status?: Partial<ParticipantConnectionStatus> | null): ParticipantConnectionStatus;
+    function fromTransportState(state?: TransportState): ParticipantStatus | null;
+    function computeEffective(status: ParticipantConnectionStatus): ParticipantStatus;
+    function setSessionState(status: ParticipantConnectionStatus, sessionState?: ParticipantSessionState, sessionStateConnectedBySpeaker?: boolean): StatusTransition;
+    function setTransport(status: ParticipantConnectionStatus, transport: ParticipantStatus): StatusTransition;
+    function setSessionStateApplicable(status: ParticipantConnectionStatus, applicable: boolean): StatusTransition;
+}
+export default ParticipantConnectionStatusUtils;

package/types/ExternalId.d.ts

@@ -18,7 +18,7 @@ export type ExternalUserId = string;
 export declare namespace ExternalIdUtils {
     function fromIds(ids: ExternalUserId[] | ExternalId[]): ExternalId[];
     function fromId(id: ExternalUserId, type?: ExternalIdType, deviceIdx?: number): ExternalParticipantId;
-    function fromSignalingParticipant(participant: SignalingMessage.Participant, useDecorative?: boolean): ExternalParticipantId | undefined;
+    function fromSignalingParticipant(participant: SignalingMessage.Participant, useDecorative?: boolean, fallbackToNonDecorative?: boolean): ExternalParticipantId | undefined;
     function fromSignaling(signalingId: SignalingMessage.ExternalId, deviceIdx?: number): ExternalParticipantId;
     function toSignaling(externalId: ExternalId): string;
     function toString(externalId: ExternalId): ExternalIdString;

package/types/Participant.d.ts

@@ -44,6 +44,16 @@ export interface ParticipantStateMapped {
         ts: number;
     };
 }
+export interface ParticipantSessionState {
+    connected: boolean;
+}
+export interface ParticipantConnectionStatus {
+    transport: ParticipantStatus;
+    sessionState?: ParticipantSessionState;
+    sessionStateApplicable: boolean;
+    sessionStateConnectedBySpeaker: boolean;
+    lastEffective: ParticipantStatus;
+}
 /**
  * Состояния участников звонка
  */
@@ -63,7 +73,6 @@ export interface Participant {
     externalId: ExternalParticipantId;
     mediaSettings: MediaSettings;
     state: ParticipantState;
-    status: ParticipantStatus;
     remoteStream?: MediaStream | null;
     remoteAudioTrack?: MediaStreamTrack | null;
     secondStream?: MediaStream | null;
@@ -73,6 +82,7 @@ export interface Participant {
     roles: UserRole[];
     participantState: ParticipantStateMapped;
     isOnHold?: boolean;
+    connectionStatus: ParticipantConnectionStatus;
     networkRating: number;
     lastRequestedLayouts: {
         [key: StreamDescriptionString]: ParticipantLayout;

package/types/PushData.d.ts

@@ -1,8 +1,11 @@
+import IceServer from './IceServer';
 type PushData = {
     caller_id: string;
     caller_client_type?: string;
     conversation_id: string;
     endpoint: string;
+    wt_endpoint?: string;
+    turn_server?: IceServer;
     is_video: boolean;
     token: string;
     sdp_offer?: string;

package/types/SignalingMessage.d.ts

@@ -19,7 +19,7 @@ import MediaModifiers from './MediaModifiers';
 import MediaSettings from './MediaSettings';
 import { ISharedMovieInfo, ISharedMovieState, ISharedMovieStoppedInfo } from './MovieShare';
 import MuteStates from './MuteStates';
-import { CompositeUserId, OkUserId, ParticipantId, ParticipantListMarker as ParticipantParticipantListMarker, ParticipantListMarkers, ParticipantListType as ParticipantParticipantListType } from './Participant';
+import { CompositeUserId, OkUserId, ParticipantId, ParticipantListMarker as ParticipantParticipantListMarker, ParticipantListMarkers, ParticipantListType as ParticipantParticipantListType, ParticipantSessionState } from './Participant';
 import { MediaType, ParticipantStreamDescription } from './ParticipantStreamDescription';
 import { IRoomId } from './Room';
 import VideoSettings from './VideoSettings';
@@ -89,6 +89,7 @@ declare namespace SignalingMessage {
             state: Record<string, string>;
             stateUpdateTs: Record<string, number>;
         };
+        sessionState?: ParticipantSessionState;
         roles?: UserRole[];
         peerId?: PeerId;
         restricted?: boolean;
@@ -324,6 +325,13 @@ declare namespace SignalingMessage {
     export interface SpeakerChanged extends Notification {
         speaker: ParticipantId;
     }
+    export interface SessionState extends Notification {
+        connected: boolean;
+        participantId: OkUserId;
+        participantType: UserType;
+        deviceIdx?: number;
+        markers?: ParticipantListMarkers;
+    }
     export interface OptionsChanged extends Notification {
         options: ConversationOption[];
     }