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

package/calls-sdk.esm.js

@@ -1,6 +1,6 @@
 /*!
- * @vkontakte/calls-sdk v2.8.11-beta.8
- * Fri, 17 Jul 2026 15:43:31 GMT
+ * @vkontakte/calls-sdk v2.8.11-beta.9
+ * Tue, 21 Jul 2026 13:05:53 GMT
  * https://calls-sdk.cdn-vk.ru/doc/latest/index.html
  */
 
@@ -2159,7 +2159,7 @@ var hn = mn.getInstance(), j = class e {
 		return 1.1;
 	}
 	static get sdkVersion() {
-		return "2.8.11-beta.8";
+		return "2.8.11-beta.9";
 	}
 	static get debug() {
 		return e._params.debug;
@@ -2525,6 +2525,9 @@ var hn = mn.getInstance(), j = class e {
 	static get webtransportFF() {
 		return e._params.webtransportFF;
 	}
+	static get waitForRecordResponse() {
+		return e._params.waitForRecordResponse;
+	}
 	static get transparentAudio() {
 		return e._params.transparentAudio;
 	}
@@ -2566,6 +2569,7 @@ var hn = mn.getInstance(), j = class e {
 			simulcast: e._params.simulcast,
 			webtransport: e._params.webtransport,
 			webtransportFF: e._params.webtransportFF,
+			waitForRecordResponse: e._params.waitForRecordResponse,
 			transparentAudio: e._params.transparentAudio,
 			enableSessionStateUpdates: e._params.enableSessionStateUpdates
 		};
@@ -2677,6 +2681,7 @@ h(j, "_params", {
 	simulcast: !1,
 	webtransport: !1,
 	webtransportFF: !1,
+	waitForRecordResponse: !1,
 	transparentAudio: !1,
 	enableSessionStateUpdates: !1
 });
@@ -7191,7 +7196,7 @@ var ua = la, da = {
 					type: "notification",
 					notification: W.TOPOLOGY_CHANGED,
 					topology: e.conversation.topology
-				})), this.lastStamp && this._handleCachedMessages(), e.recoverMessages?.forEach((e) => {
+				}), this._resolvePendingRecordCommands(e)), this.lastStamp && this._handleCachedMessages(), e.recoverMessages?.forEach((e) => {
 					e.notification === W.ACCEPTED_CALL && e.peerId.id === this.peerId && e.peerId.type === "WEB_TRANSPORT" || this._handleMessage(e);
 				}), this._handleCommandsQueue(this.websocketCommandsQueue)) : !this.connected || !this.listenersReady ? this.incomingCache.push(e) : this._triggerEvent(pr.NOTIFICATION, e);
 				break;
@@ -7278,9 +7283,28 @@ var ua = la, da = {
 	}
 	_closeSocket(e = null) {
 		this.transport.readyState !== null && (this.transport.close(), this._stopWaitConnectionMessage(), Object.values(this.responseHandlers).forEach((t) => {
-			window.clearTimeout(t.responseTimer), e && t.reject(/* @__PURE__ */ Error(`Connection closed. Command ${t.name}`), !0);
+			window.clearTimeout(t.responseTimer), e ? t.reject(/* @__PURE__ */ Error(`Connection closed. Command ${t.name}`), !0) : j.waitForRecordResponse && this._isRecordCommand(t.name) && t.reject(/* @__PURE__ */ Error("Connection closed"), !0);
 		}), this.websocketCommandsQueue = [], this.responseHandlers = {}, this.lastStamp = 0, e && this._throwError(e));
 	}
+	_isRecordCommand(e) {
+		return e === z.RECORD_START || e === z.RECORD_STOP;
+	}
+	_resolvePendingRecordCommands(e) {
+		if (!j.waitForRecordResponse) return;
+		let t = Object.values(this.responseHandlers).filter((e) => this._isRecordCommand(e.name));
+		if (t.length === 0) return;
+		let n = /* @__PURE__ */ new Map();
+		n.set(null, !!e.conversation?.recordInfo);
+		for (let t of e.rooms?.rooms ?? []) t.id !== void 0 && n.set(t.id, !!t.recordInfo);
+		for (let e of t) {
+			let t = e.params.roomId ?? null, r = n.get(t) ?? !1, i = e.name === z.RECORD_START;
+			window.clearTimeout(e.responseTimer), delete this.responseHandlers[e.sequence], this._debug.debug(`[signaling] resolve pending record command [${e.sequence}] via reconnect state`), i === r ? e.resolve({
+				type: "response",
+				sequence: e.sequence,
+				response: e.name
+			}) : e.reject(/* @__PURE__ */ Error("Recording state mismatch"), !0);
+		}
+	}
 	_handleCommandResponse(t, n) {
 		if (!Object.hasOwn(this.responseHandlers, n.sequence)) return;
 		let r = this.responseHandlers[n.sequence];
@@ -7511,9 +7535,10 @@ var Va = Ba, Ha = /* @__PURE__ */ function(e) {
 		};
 	}
 	e.fromId = n;
-	function r(e, t = !0) {
-		let n = t ? e.decorativeExternalUserId : e.externalId, r = e.deviceIdx ?? 0;
-		if (n) return i(n, r);
+	function r(e, t = !0, n = !1) {
+		let r = t ? e.decorativeExternalUserId : e.externalId, a = e.deviceIdx ?? 0;
+		if (r) return i(r, a);
+		if (n && t && e.externalId) return i(e.externalId, a);
 	}
 	e.fromSignalingParticipant = r;
 	function i(e, t = 0) {
@@ -9055,9 +9080,8 @@ var ro = 90, io = 3, ao = class extends y {
 			throw this._close(new D(E.NETWORK_ERROR), e), e;
 		}
 	}
-	async _setConversation(e, t, n, r = k.USER) {
-		let { participants: i } = t.conversation;
-		t.conversationParams?.serverTime && (this._serverTimeOffset = t.conversationParams.serverTime - Date.now()), i.forEach((e) => {
+	_cacheParticipantExternalIds(e) {
+		e.forEach((e) => {
 			let t = A.composeId(e), n = Z.fromSignalingParticipant(e, !1);
 			if (n) {
 				this._api.cacheExternalId(t, n);
@@ -9065,6 +9089,10 @@ var ro = 90, io = 3, ao = class extends y {
 				r && i && (this._api.cacheExternalId(r, i), this._api.mapDecorativeId(e.decorativeUserId, e.id));
 			}
 		});
+	}
+	async _setConversation(e, t, n, r = k.USER) {
+		let { participants: i } = t.conversation;
+		t.conversationParams?.serverTime && (this._serverTimeOffset = t.conversationParams.serverTime - Date.now()), this._cacheParticipantExternalIds(i);
 		let a = this._api.getUserId(), o = this._extractLocalParticipantFromConnection(t), s = e.device_idx || 0;
 		if (!a) {
 			if (!o) throw new D(E.UNKNOWN_ERROR);
@@ -9107,7 +9135,7 @@ var ro = 90, io = 3, ao = class extends y {
 	}
 	_updateConversation(e) {
 		if (!this._conversation) throw new D(E.UNKNOWN_ERROR);
-		this._conversation.acceptTime = e.conversation.acceptTime, this._conversation.features = e.conversation.features || [], this._conversation.featuresPerRole = e.conversation.featuresPerRole, this._conversation.participantsLimit = e.conversation.participantsLimit || 30, this._conversation.topology = e.conversation.topology || K.DIRECT, this._conversation.concurrent = e.isConcurrent || !1, this._conversation.chatId = e.conversation.multichatId, this._conversation.mediaModifiers = e.mediaModifiers, this._conversation.waitingHall = !1, this._conversation.waitForAdmin = !1, this._conversation.restricted = !1;
+		this._conversation.acceptTime = e.conversation.acceptTime, this._conversation.features = e.conversation.features || [], this._conversation.featuresPerRole = e.conversation.featuresPerRole, this._conversation.participantsLimit = e.conversation.participantsLimit || 30, this._conversation.topology = e.conversation.topology || K.DIRECT, this._conversation.concurrent = e.isConcurrent || !1, this._conversation.chatId = e.conversation.multichatId, this._conversation.mediaModifiers = e.mediaModifiers, this._conversation.waitingHall = !1, this._conversation.waitForAdmin = !1, this._conversation.restricted = !1, this._cacheParticipantExternalIds(e.conversation.participants ?? []);
 	}
 	_createMediaSource() {
 		let e = new Yt(this._debug, this._stats.logger);
@@ -9167,7 +9195,7 @@ var ro = 90, io = 3, ao = class extends y {
 			let i = A.composeDecorativeId(n);
 			this._registerParticipant({
 				id: e,
-				externalId: Z.fromSignalingParticipant(n),
+				externalId: Z.fromSignalingParticipant(n, !0, !0),
 				mediaSettings: T(n.mediaSettings),
 				participantState: A.mapParticipantState(n),
 				state: n.state,
@@ -9248,6 +9276,9 @@ var ro = 90, io = 3, ao = class extends y {
 			return this._api.cacheExternalId(e, t), t;
 		}
 	}
+	_getExternalIdsByOkIdsFromCache(e) {
+		return e.map((e) => this._api.getCachedExternalIdByOkId(e) ?? Z.fromId(String(e)));
+	}
 	async _registerParticipantAndSetMarkersIfChunkEnabled(e, t) {
 		if (j.useParticipantListChunk) {
 			let n = this._registerParticipantInCache(await this._getExistedParticipantByIdOrCreate(e));
@@ -9371,7 +9402,7 @@ var ro = 90, io = 3, ao = class extends y {
 			let n = A.composeDecorativeId(t);
 			this._registerParticipant({
 				id: e,
-				externalId: Z.fromSignalingParticipant(t),
+				externalId: Z.fromSignalingParticipant(t, !0, !0),
 				mediaSettings: T(t.mediaSettings),
 				state: t.state,
 				roles: t.roles || [],
@@ -9651,11 +9682,8 @@ var ro = 90, io = 3, ao = class extends y {
 			I.onChatRoomUpdated(e, t, l, [], [], this.id);
 			return;
 		}
-		if (c.length) {
-			let e = await this._api.getExternalIdsByOkIds(c);
-			l.push(...e);
-		}
-		let u = await this._api.getExternalIdsByOkIds(o), d = await this._api.getExternalIdsByOkIds(s);
+		c.length && l.push(...this._getExternalIdsByOkIdsFromCache(c));
+		let u = this._getExternalIdsByOkIdsFromCache(o), d = this._getExternalIdsByOkIdsFromCache(s);
 		I.onChatRoomUpdated(e, t, l, u, d, this.id);
 	}
 	async _onSharedMovieUpdate(e) {
@@ -9899,7 +9927,7 @@ var ro = 90, io = 3, ao = class extends y {
 					let t = Z.fromSignaling(e.externalId);
 					n.push(e.id.addedTs), r.push(t), this._api.cacheExternalId(e.id.id, t);
 				} else i.push(A.decomposeId(e.id.id).id);
-			}), i.length && !r.length && (r = await this._api.getExternalIdsByOkIds(i), n = r.map((e) => {
+			}), i.length && !r.length && (r = this._getExternalIdsByOkIdsFromCache(i), n = r.map((e) => {
 				let n = this._api.getCachedOkIdByExternalId(e);
 				return (n ? t.get(n) : void 0) || Date.now();
 			}));
@@ -10018,13 +10046,14 @@ var ro = 90, io = 3, ao = class extends y {
 			roomId: a,
 			streamMovie: !e
 		}, s = await this._signaling.startStream(o);
-		if (s.error) return Promise.reject(s.message);
+		if (s.error) return Promise.reject(Error(s.message));
 	}
 	async stopStream(e = null, t) {
-		if ((await this._signaling.stopStream({
+		let n = await this._signaling.stopStream({
 			roomId: e,
 			...t && { remove: t }
-		})).error) return Promise.reject();
+		});
+		if (n.error) return Promise.reject(Error(n.message));
 	}
 	async publishStream(e = null) {
 		if ((await this._signaling.publishStream({ roomId: e })).error) return Promise.reject();
@@ -10070,7 +10099,7 @@ var ro = 90, io = 3, ao = class extends y {
 			let t = A.composeId(e);
 			return this._createParticipant({
 				id: t,
-				externalId: Z.fromSignalingParticipant(e),
+				externalId: Z.fromSignalingParticipant(e, !0, !0),
 				mediaSettings: T(e.mediaSettings),
 				participantState: A.mapParticipantState(e),
 				state: e.state,
@@ -10312,7 +10341,10 @@ var ro = 90, io = 3, ao = class extends y {
 			this._warnParticipantNotInConversation(t);
 			return;
 		}
-		this._transport && this._transport.close(t), n.state = e.reason === E.REJECTED ? X.REJECTED : X.HUNGUP, this._state !== "CLOSE" && this._removeParticipant(n, e.reason ?? E.HUNGUP);
+		if (this._transport && this._transport.close(t), n.state = e.reason === E.REJECTED ? X.REJECTED : X.HUNGUP, this._state !== "CLOSE") {
+			let t = e.reason === E.OBSOLETE_CLIENT ? E.OBSOLETE_CLIENT : E.HUNGUP;
+			this._removeParticipant(n, t);
+		}
 	}
 	async _onSessionState(e) {
 		if (!j.enableSessionStateUpdates) return;
@@ -10361,7 +10393,7 @@ var ro = 90, io = 3, ao = class extends y {
 			let { participant: r } = e, i = r.decorativeUserId;
 			this._registerParticipant({
 				id: t,
-				externalId: Z.fromSignalingParticipant(r),
+				externalId: Z.fromSignalingParticipant(r, !0, !0),
 				mediaSettings: T(r.mediaSettings),
 				state: r.state,
 				participantState: A.mapParticipantState(r),
@@ -10388,7 +10420,7 @@ var ro = 90, io = 3, ao = class extends y {
 			let { participant: r } = e, i = r.decorativeUserId;
 			this._registerParticipant({
 				id: t,
-				externalId: Z.fromSignalingParticipant(r),
+				externalId: Z.fromSignalingParticipant(r, !0, !0),
 				mediaSettings: T(r.mediaSettings),
 				state: r.state,
 				participantState: A.mapParticipantState(r),
@@ -10955,7 +10987,7 @@ var ro = 90, io = 3, ao = class extends y {
 		};
 	}
 	async _onRoomParticipantsUpdated(e) {
-		let t = this._transport?.getState(), n = e.roomId ?? null, r = e.addedParticipantIds?.map((e) => A.decomposeId(e).id) || [], i = await this._api.getExternalIdsByOkIds(r), a = e.addedParticipants;
+		let t = this._transport?.getState(), n = e.roomId ?? null, r = e.addedParticipantIds?.map((e) => A.decomposeId(e).id) || [], i = this._getExternalIdsByOkIdsFromCache(r), a = e.addedParticipants;
 		if (i.length && a?.length !== i.length && !this._isCalledState()) {
 			let e = this._convertExternalIdsToServerExternalIds(i);
 			a = (await this._signaling.getParticipants(e)).participants;
@@ -10964,7 +10996,7 @@ var ro = 90, io = 3, ao = class extends y {
 			let r = A.composeId(e);
 			return this._createParticipant({
 				id: r,
-				externalId: Z.fromSignalingParticipant(e),
+				externalId: Z.fromSignalingParticipant(e, !0, !0),
 				mediaSettings: T(e.mediaSettings),
 				participantState: A.mapParticipantState(e),
 				state: e.state,
@@ -11226,6 +11258,9 @@ var Go = class {
 	getCachedRawOkIdByExternalId(e) {
 		return null;
 	}
+	getCachedExternalIdByOkId(e) {
+		return null;
+	}
 	cacheExternalId(e, t) {}
 	mapDecorativeId(e, t) {}
 	unmapDecorativeId(e) {}
@@ -11357,7 +11392,7 @@ var Go = class {
 	}
 	async userId(e) {
 		let t = A.extractOkId(e);
-		return v.isEmpty() ? Z.fromId(String(t)) : (this._idCache.hasByOkId(t) || await this._getExternalIdsByOkIds([t]), this._idCache.getExternalId(t) || Z.fromId(String(t)));
+		return v.isEmpty() ? Z.fromId(String(t)) : this._idCache.getExternalId(t) || Z.fromId(String(t));
 	}
 	async authorize() {
 		if (this._ensureUuid(), !j.apiKey) throw new D(b.API, { message: "Required argument apiAppKey not passed" });
@@ -11516,22 +11551,15 @@ var Go = class {
 		};
 		return n?.length && (i.observedIds = n.join(",")), j.anonymToken && (i.anonymToken = j.anonymToken), r && (i.payload = r), this._call("vchat.joinConversationByLink", i);
 	}
-	async getExternalIdsByOkIds(e) {
-		let t = [], n = [];
-		for (let r of e) {
-			let e = this._idCache.getExternalId(r);
-			e ? t.push(e) : n.push(r);
-		}
-		if (!n.length) return t;
-		let r = await this._getExternalIdsByOkIds(n);
-		return Array.from(r.values());
-	}
 	getCachedOkIdByExternalId(e) {
 		return this._idCache.getParticipantIdByExternalId(e);
 	}
 	getCachedRawOkIdByExternalId(e) {
 		return this._idCache.getOkId(e);
 	}
+	getCachedExternalIdByOkId(e) {
+		return this._idCache.getExternalId(e);
+	}
 	cacheExternalId(e, t) {
 		this._idCache.cache(e, t);
 	}
@@ -11570,29 +11598,6 @@ var Go = class {
 	cleanup() {
 		this._idCache.clear();
 	}
-	async _getExternalIdsByOkIds(e) {
-		let t = /* @__PURE__ */ new Map();
-		e = e.map((e) => this.getDecorativeIdByInitialId(e) ?? e);
-		try {
-			let n = await this._call("vchat.getExternalIdsByOkIds", { uids: e.join(",") }), r = (e, n) => {
-				for (let [r, i] of Object.entries(e)) {
-					let e = Number(r), a = Z.fromId(i, n);
-					t.set(e, a), this.cacheExternalId(e, a);
-				}
-			};
-			n.external_ids && r(n.external_ids, Ha.USER), n.anonym_ids && r(n.anonym_ids, Ha.ANONYM);
-			for (let n of e) {
-				let e = Number(n);
-				if (!t.has(e)) {
-					let n = Z.fromId(String(e));
-					t.set(e, n), this.cacheExternalId(e, n);
-				}
-			}
-			return t;
-		} catch {
-			return t;
-		}
-	}
 	async getServerTime() {
 		return (await this._call("system.getInfo")).serverTime;
 	}

package/classes/Conversation.d.ts

@@ -134,6 +134,7 @@ export default class Conversation extends EventEmitter {
     private _prepareConversation;
     private _createParticipant;
     private _getParticipantId;
+    private _cacheParticipantExternalIds;
     private _setConversation;
     private _updateConversation;
     private _createMediaSource;
@@ -155,6 +156,7 @@ export default class Conversation extends EventEmitter {
     private _registerParticipantInCache;
     private _getExistedParticipantByIdOrCreate;
     private _getExternalIdByParticipantId;
+    private _getExternalIdsByOkIdsFromCache;
     private _registerParticipantAndSetMarkersIfChunkEnabled;
     private _warnParticipantNotInConversation;
     private _denormalizeMarkers;

package/default/Api.d.ts

@@ -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,7 +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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vkontakte/calls-sdk",
-  "version": "2.8.11-beta.8",
+  "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

@@ -487,6 +487,14 @@ export type ParamsObject = {
      * _По умолчанию: `false`_
      */
     webtransportFF: boolean;
+    /**
+     * Ждать подтверждения от бэкенда для команд startStream/stopStream.
+     * При включении: reject без соединения, resolve/reject по ответу бэкенда,
+     * а при реконнекте — по стейту записи из Connection-сообщения.
+     *
+     * _По умолчанию: `false`_
+     */
+    waitForRecordResponse: boolean;
     /**
      * Включить поддержку прозрачного аудио
      *
@@ -1018,6 +1026,7 @@ 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(): {
@@ -1054,6 +1063,7 @@ export default abstract class Params {
         simulcast: boolean;
         webtransport: boolean;
         webtransportFF: boolean;
+        waitForRecordResponse: boolean;
         transparentAudio: boolean;
         enableSessionStateUpdates: boolean;
     };

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;