@vkontakte/calls-sdk 2.8.13-dev.c9243c68.0 → 2.8.13-dev.d26e27ad.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (46) hide show
  1. package/CallsSDK.d.ts +5 -0
  2. package/abstract/BaseApi.d.ts +16 -18
  3. package/calls-sdk.cjs.js +7 -7
  4. package/calls-sdk.esm.js +2121 -1391
  5. package/classes/AudioFix.d.ts +2 -2
  6. package/classes/AudioOutput.d.ts +2 -2
  7. package/classes/ExternalIdCache.d.ts +9 -13
  8. package/classes/MediaSource.d.ts +2 -2
  9. package/classes/SpecListener.d.ts +2 -2
  10. package/classes/VolumesDetector.d.ts +0 -1
  11. package/classes/codec/LibVPxDecoder.d.ts +2 -2
  12. package/classes/codec/LibVPxEncoder.d.ts +2 -2
  13. package/classes/codec/WebCodecsDecoder.d.ts +2 -2
  14. package/classes/codec/WebCodecsEncoder.d.ts +2 -2
  15. package/classes/codec/WorkerBase.d.ts +3 -3
  16. package/classes/conversation/Conversation.d.ts +7 -4
  17. package/classes/conversation/Conversation.testUtils.d.ts +2 -0
  18. package/classes/conversation/DisplayLayoutRequester.d.ts +3 -1
  19. package/classes/screenshare/ScreenCaptureReceiver.d.ts +2 -2
  20. package/classes/screenshare/ScreenCaptureSender.d.ts +2 -2
  21. package/classes/screenshare/StreamBuilder.d.ts +2 -2
  22. package/classes/stat/CallLifecycleStats.d.ts +2 -2
  23. package/classes/stat/CodecStatsAggregator.d.ts +2 -2
  24. package/classes/stat/ConversationStats.d.ts +11 -2
  25. package/classes/stat/StatAggregator.d.ts +2 -2
  26. package/classes/stat/StatClock.d.ts +28 -0
  27. package/classes/stat/StatDrainScheduler.d.ts +92 -0
  28. package/classes/stat/StatEventCollector.d.ts +50 -0
  29. package/classes/stat/StatPings.d.ts +2 -2
  30. package/classes/stat/StatQueue.d.ts +79 -0
  31. package/classes/stat/StatSignalingCommands.d.ts +2 -2
  32. package/classes/stat/StatUnloadJournal.d.ts +27 -0
  33. package/classes/transport/DirectTransport.d.ts +2 -2
  34. package/classes/transport/ServerTransport.d.ts +2 -2
  35. package/classes/transport/SimulcastSender.d.ts +2 -2
  36. package/classes/transport/Transport.d.ts +2 -2
  37. package/default/Api.d.ts +18 -11
  38. package/default/Signaling.d.ts +2 -2
  39. package/enums/SessionError.d.ts +10 -0
  40. package/package.json +1 -1
  41. package/static/ApiTransport.d.ts +4 -0
  42. package/static/External.d.ts +10 -0
  43. package/static/Params.d.ts +40 -1
  44. package/static/SessionStore.d.ts +29 -0
  45. package/static/SimulcastInfo.d.ts +1 -0
  46. package/static/WebRTCUtils.d.ts +5 -5
@@ -0,0 +1,79 @@
1
+ /** Потолок хранения событий: и очереди на диске, и буфера в памяти вкладки. */
2
+ export declare const RECORD_LIMIT = 5000;
3
+ /** Срок жизни события в очереди. */
4
+ export declare const MAX_AGE_MS: number;
5
+ /** Произвольный набор скалярных полей события. */
6
+ export type StatPayload = Record<string, string | number | boolean | null>;
7
+ /** Запись очереди без сгенерированного ключа. */
8
+ export type StatQueueEntry = {
9
+ /** userId владельца события. Не может быть неизвестным. */
10
+ uid: number;
11
+ /** conversationId. null — событие залогировано до старта звонка. */
12
+ vcid: string | null;
13
+ /** Время записи в device-time, без коррекции по серверу. */
14
+ ts: number;
15
+ /** Поправка к серверному времени на момент записи. null — ещё не знали. */
16
+ delta?: number | null;
17
+ ev: StatPayload;
18
+ };
19
+ /** Запись очереди, прочитанная из хранилища. */
20
+ export type StatQueueRecord = StatQueueEntry & {
21
+ /** Автоинкремент. Единственный источник истины для порядка событий. */
22
+ id: number;
23
+ };
24
+ /**
25
+ * Персистентная очередь событий статистики поверх IndexedDB.
26
+ *
27
+ * База одна на origin, поэтому класс статический. Ошибки хранилища только
28
+ * логируются: статистика не влияет на звонок.
29
+ */
30
+ export default abstract class StatQueue {
31
+ private static _db;
32
+ private static _dbPromise;
33
+ /** Имя базы. Подменяется только тестами, см. __resetForTests(). */
34
+ private static _dbName;
35
+ private static _supported;
36
+ private static _appendsSinceEvictCheck;
37
+ /** Момент последней неудачи открытия; до конца кулдауна не пробуем снова. */
38
+ private static _lastOpenFailureAt;
39
+ static isSupported(): boolean;
40
+ /** @returns ключ записи или null, если хранилище не приняло её. */
41
+ static append(entry: StatQueueEntry): Promise<number | null>;
42
+ /**
43
+ * Проставляет delta перечисленным записям, у которых её ещё нет.
44
+ *
45
+ * Ключи перечисляются явно: между своими в очередь могли лечь чужие записи,
46
+ * писанные другими часами.
47
+ */
48
+ static fillDelta(ids: number[], delta: number): Promise<void>;
49
+ static count(): Promise<number>;
50
+ /**
51
+ * Читает самые старые события пользователя. Индекс by_uid отдаёт их в
52
+ * порядке автоинкрементного id, то есть в порядке записи.
53
+ */
54
+ static readOldest(uid: number, limit: number): Promise<StatQueueRecord[]>;
55
+ static remove(ids: number[]): Promise<void>;
56
+ /** Уникальные uid, у которых есть записи. Курсор по индексу by_uid с nextunique. */
57
+ static listUids(): Promise<number[]>;
58
+ /**
59
+ * Приводит размер хранилища к лимиту, вынося самые старые звонки целиком:
60
+ * частично удалённый звонок — это неполная цепочка событий. Записи без
61
+ * vcid одной группой не считаются, иначе эвикшн вынес бы pre-call события
62
+ * сразу всех звонков.
63
+ */
64
+ static evictToLimit(limit: number): Promise<void>;
65
+ /** Удаляет события старше указанного возраста. */
66
+ static evictOlderThan(maxAgeMs: number, now?: number): Promise<void>;
67
+ private static _checkSupport;
68
+ private static _open;
69
+ private static _close;
70
+ private static _createSchema;
71
+ /** Обёртка над транзакцией: резолвится после успешного коммита. */
72
+ private static _runTransaction;
73
+ /** Читает запись с минимальным id, то есть самую старую в хранилище. */
74
+ private static _readOldestRecord;
75
+ /**
76
+ * Удаляет все события звонка одной транзакцией.
77
+ */
78
+ private static _deleteConversation;
79
+ }
@@ -1,9 +1,9 @@
1
1
  import { SignalingTransportType } from '../../enums/SignalingTransportStat';
2
- import StatsLogger from '../StatsLogger';
2
+ import StatEventCollector from './StatEventCollector';
3
3
  export declare class StatSignalingCommands {
4
4
  private readonly _logger;
5
5
  private trackerByCommand;
6
- constructor(logger: StatsLogger);
6
+ constructor(logger: StatEventCollector);
7
7
  mark(command: string, time: number, transport: SignalingTransportType): void;
8
8
  /** Отправляем данные в стату */
9
9
  logMetrics(): void;
@@ -0,0 +1,27 @@
1
+ import { StatQueueEntry } from './StatQueue';
2
+ /**
3
+ * Синхронный журнал умирающей вкладки поверх localStorage: транзакция
4
+ * IndexedDB из pagehide не успевает закоммититься. Следующий старт SDK
5
+ * переносит журнал в очередь. Ключ уникален на вкладку.
6
+ */
7
+ export default abstract class StatUnloadJournal {
8
+ private static _tabKey;
9
+ private static _entries;
10
+ /**
11
+ * Открывает новый журнал для этой вкладки. Без сброса пережившая pagehide
12
+ * вкладка записала бы во второй журнал уже перенесённые события.
13
+ */
14
+ static beginTabSession(): void;
15
+ static writeSync(entry: StatQueueEntry): boolean;
16
+ /**
17
+ * Переносит журналы всех закрытых вкладок в очередь. Журнал стирается
18
+ * независимо от исхода: повторные попытки дали бы дубли.
19
+ *
20
+ * @returns число перенесённых событий.
21
+ */
22
+ static drainToQueue(): Promise<number>;
23
+ /** Читает журнал и сразу удаляет его. null — ключа уже нет или хранилище недоступно. */
24
+ private static _take;
25
+ private static _storage;
26
+ private static _isValidEntry;
27
+ }
@@ -3,7 +3,7 @@ import BaseSignaling from '../../abstract/BaseSignaling';
3
3
  import { type DebugLogger } from '../../static/Debug';
4
4
  import { ParticipantId } from '../../types/Participant';
5
5
  import ServerSettings from '../../types/ServerSettings';
6
- import StatsLogger from '../StatsLogger';
6
+ import StatEventCollector from '../stat/StatEventCollector';
7
7
  import { MediaSource } from '../MediaSource';
8
8
  import { CodecStatsAggregator } from '../stat/CodecStatsAggregator';
9
9
  import { StatAggregator } from '../stat/StatAggregator';
@@ -43,7 +43,7 @@ export default class DirectTransport extends BaseTransport {
43
43
  private readonly _logger;
44
44
  private readonly _statAggregator;
45
45
  private readonly _codecStatsAggregator;
46
- 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);
46
+ constructor(participantId: ParticipantId, isMaster: boolean, signaling: BaseSignaling, mediaSource: MediaSource, serverSettings: ServerSettings, debug?: DebugLogger, logger?: StatEventCollector | null, statAggregator?: StatAggregator | null, codecStatsAggregator?: CodecStatsAggregator | null, onFirstMediaSent?: (() => void) | null);
47
47
  get participantId(): ParticipantId;
48
48
  updateStatisticsInterval(): void;
49
49
  private _isDeadConnection;
@@ -3,7 +3,7 @@ import BaseSignaling from '../../abstract/BaseSignaling';
3
3
  import { type DebugLogger } from '../../static/Debug';
4
4
  import { ParticipantId } from '../../types/Participant';
5
5
  import ServerSettings from '../../types/ServerSettings';
6
- import StatsLogger from '../StatsLogger';
6
+ import StatEventCollector from '../stat/StatEventCollector';
7
7
  import { MediaSource } from '../MediaSource';
8
8
  import { CodecStatsAggregator } from '../stat/CodecStatsAggregator';
9
9
  import { StatAggregator } from '../stat/StatAggregator';
@@ -47,7 +47,7 @@ export default class ServerTransport extends BaseTransport {
47
47
  private readonly _statAggregator;
48
48
  private readonly _codecStatsAggregator;
49
49
  private readonly _simulcast;
50
- constructor(signaling: BaseSignaling, mediaSource: MediaSource, serverSettings: ServerSettings, debug?: DebugLogger, logger?: StatsLogger | null, statAggregator?: StatAggregator | null, codecStatsAggregator?: CodecStatsAggregator | null, onFirstMediaSent?: (() => void) | null);
50
+ constructor(signaling: BaseSignaling, mediaSource: MediaSource, serverSettings: ServerSettings, debug?: DebugLogger, logger?: StatEventCollector | null, statAggregator?: StatAggregator | null, codecStatsAggregator?: CodecStatsAggregator | null, onFirstMediaSent?: (() => void) | null);
51
51
  updateStatisticsInterval(): void;
52
52
  open(observer?: boolean): void;
53
53
  close(error?: Error): void;
@@ -2,7 +2,7 @@ import BaseSignaling from '../../abstract/BaseSignaling';
2
2
  import { type DebugLogger } from '../../static/Debug';
3
3
  import type VideoSettings from '../../types/VideoSettings';
4
4
  import { MediaSource } from '../MediaSource';
5
- import StatsLogger from '../StatsLogger';
5
+ import StatEventCollector from '../stat/StatEventCollector';
6
6
  export default class SimulcastSender {
7
7
  private _pc;
8
8
  private _transceiver;
@@ -12,7 +12,7 @@ export default class SimulcastSender {
12
12
  private readonly _getCameraSettings;
13
13
  private readonly _debug;
14
14
  private readonly _logger;
15
- constructor(signaling: BaseSignaling, mediaSource: MediaSource, getCameraSettings: () => VideoSettings | null, debug?: DebugLogger, logger?: StatsLogger | null);
15
+ constructor(signaling: BaseSignaling, mediaSource: MediaSource, getCameraSettings: () => VideoSettings | null, debug?: DebugLogger, logger?: StatEventCollector | null);
16
16
  configureFromRemoteOffer(pc: RTCPeerConnection): Promise<void>;
17
17
  finalizeAnswer(sdp: string): string;
18
18
  sync({ force }?: {
@@ -6,7 +6,7 @@ import { type DebugLogger } from '../../static/Debug';
6
6
  import { ParticipantId } from '../../types/Participant';
7
7
  import ServerSettings from '../../types/ServerSettings';
8
8
  import EventEmitter from '../EventEmitter';
9
- import StatsLogger from '../StatsLogger';
9
+ import StatEventCollector from '../stat/StatEventCollector';
10
10
  import { MediaSource } from '../MediaSource';
11
11
  import { CodecStatsAggregator } from '../stat/CodecStatsAggregator';
12
12
  import { StatAggregator } from '../stat/StatAggregator';
@@ -51,7 +51,7 @@ export declare class Transport extends EventEmitter {
51
51
  private readonly _onFirstMediaSent;
52
52
  private _firstMediaSentProbeStopped;
53
53
  private _vadController;
54
- constructor(topology: TransportTopology, signaling: BaseSignaling, mediaSource: MediaSource, serverSettings: ServerSettings, debug?: DebugLogger, logger?: StatsLogger | null, statAggregator?: StatAggregator | null, codecStatsAggregator?: CodecStatsAggregator | null, onFirstMediaSent?: (() => void) | null);
54
+ constructor(topology: TransportTopology, signaling: BaseSignaling, mediaSource: MediaSource, serverSettings: ServerSettings, debug?: DebugLogger, logger?: StatEventCollector | null, statAggregator?: StatAggregator | null, codecStatsAggregator?: CodecStatsAggregator | null, onFirstMediaSent?: (() => void) | null);
55
55
  updateSettings(settings: ServerSettings): void;
56
56
  updateStatisticsInterval(): void;
57
57
  allocate(participantId: ParticipantId, isMaster?: boolean): void;
package/default/Api.d.ts CHANGED
@@ -5,23 +5,32 @@ import { IHangupParams } from '../types/Api';
5
5
  import ConversationParams from '../types/ConversationParams';
6
6
  import ConversationResponse from '../types/ConversationResponse';
7
7
  import { ExternalId, ExternalParticipantId, ExternalUserId } from '../types/ExternalId';
8
- import { CompositeUserId, OkUserId, ParticipantId } from '../types/Participant';
8
+ import { OkUserId, ParticipantId } from '../types/Participant';
9
9
  import PushData from '../types/PushData';
10
10
  export default class Api extends BaseApi {
11
11
  private _uuid;
12
12
  private _idCache;
13
13
  private _callUnsafe;
14
14
  protected _call(method: string, data?: any, noSession?: boolean, allowReauthorize?: boolean): Promise<any>;
15
- userId(participantId: ParticipantId): ExternalParticipantId;
15
+ userId(participantId: ParticipantId): ExternalParticipantId | null;
16
16
  authorize(): Promise<void>;
17
+ /** Запрос auth.anonymLogin без побочных эффектов. Пустой токен — версия 2. */
18
+ private _anonymLogin;
17
19
  private _getAnonymLoginCacheKey;
18
20
  private _getCachedAnonymLogin;
19
21
  private _setCachedAnonymLogin;
20
22
  private _removeCachedAnonymLogin;
21
23
  private _reauthorize;
22
24
  private _applyAnonymLogin;
25
+ private _buildClientStatsData;
26
+ /** Ошибки по отдельным событиям логируются, но батч трактуется целиком. */
27
+ private _reportClientStatsItemErrors;
28
+ /** noSession = true, иначе _prepareQuery перебил бы явный session_key. */
29
+ private _sendClientStatsWith;
30
+ /** Бекенд отвечает 200 всегда: ошибки статистики лежат в теле. */
23
31
  private _sendClientStats;
24
- logClientStats(items: ClientStats[]): void;
32
+ logClientStats(items: ClientStats[]): Promise<void>;
33
+ logClientStatsWith(sessionKey: string, items: ClientStats[]): Promise<void>;
25
34
  uploadDebugLogs(conversationId: string, startTime: number, endTime: number, log: string): Promise<void>;
26
35
  joinConversation(conversationId: string, isVideo?: boolean, chatId?: string): Promise<ConversationResponse>;
27
36
  createConversation(conversationId: string, payload?: string, requireAuthToJoin?: boolean, { onlyAdminCanShareMovie, audienceMode, audioOnly, waitForAdmin, closedConversation, }?: {
@@ -47,14 +56,12 @@ export default class Api extends BaseApi {
47
56
  }>;
48
57
  getAnonymTokenByLink(joinLink: string, username?: string): Promise<string>;
49
58
  joinConversationByLink(joinLink: string, isVideo?: boolean, observedIds?: ExternalUserId[], payload?: string): Promise<ConversationResponse>;
50
- getCachedOkIdByExternalId(externalId: ExternalId): ParticipantId | null;
51
- getCachedRawOkIdByExternalId(externalId: ExternalId): OkUserId | null;
52
- getCachedExternalIdByOkId(okId: OkUserId): ExternalParticipantId | null;
53
- cacheExternalId(participantId: OkUserId | CompositeUserId | ParticipantId, externalId: ExternalParticipantId): void;
54
- mapDecorativeId(decorativeId: OkUserId | CompositeUserId | ParticipantId, initialId: OkUserId | CompositeUserId | ParticipantId): void;
55
- unmapDecorativeId(initialId: OkUserId | CompositeUserId | ParticipantId): void;
56
- getDecorativeIdByInitialId(initialId: OkUserId | CompositeUserId | ParticipantId): OkUserId | undefined;
57
- replaceByInitialIdIdIfExists(id: OkUserId | CompositeUserId | ParticipantId): OkUserId;
59
+ getCachedParticipantIdByExternalId(externalId: ExternalId): ParticipantId | null;
60
+ getCachedExternalIdByParticipantId(participantId: ParticipantId): ExternalParticipantId | null;
61
+ cacheExternalId(participantId: ParticipantId, externalId: ExternalParticipantId): void;
62
+ mapDecorativeId(decorativeId: ParticipantId, initialId: ParticipantId): void;
63
+ unmapDecorativeId(initialId: ParticipantId): void;
64
+ getDecorativeIdByInitialId(initialId: ParticipantId): ParticipantId | undefined;
58
65
  getConversationParams(conversationId?: string): Promise<ConversationParams>;
59
66
  getUserId(): OkUserId | null;
60
67
  setUserId(userId: OkUserId): void;
@@ -4,7 +4,7 @@ import { SharingStatReport } from '../classes/screenshare/SharingStatReport';
4
4
  import { StatAggregator } from '../classes/stat/StatAggregator';
5
5
  import { StatPings } from '../classes/stat/StatPings';
6
6
  import { StatSignalingCommands } from '../classes/stat/StatSignalingCommands';
7
- import StatsLogger from '../classes/StatsLogger';
7
+ import StatEventCollector from '../classes/stat/StatEventCollector';
8
8
  import ConversationFeature from '../enums/ConversationFeature';
9
9
  import ConversationOption from '../enums/ConversationOption';
10
10
  import MediaOption from '../enums/MediaOption';
@@ -56,7 +56,7 @@ export default class Signaling extends BaseSignaling {
56
56
  private static get WAIT_CONNECTION_DELAY();
57
57
  private static get WAIT_RESPONSE_DELAY();
58
58
  get ready(): boolean;
59
- constructor(debug?: DebugLogger, logger?: StatsLogger | null, statAggregator?: StatAggregator | null, statPings?: StatPings | null, statSignalingCommands?: StatSignalingCommands | null);
59
+ constructor(debug?: DebugLogger, logger?: StatEventCollector | null, statAggregator?: StatAggregator | null, statPings?: StatPings | null, statSignalingCommands?: StatSignalingCommands | null);
60
60
  setAbortSignal(signal: AbortSignal | undefined): void;
61
61
  setEndpoint(endpoint: string): void;
62
62
  setWebTransportEndpoint(endpoint: string | null): void;
@@ -0,0 +1,10 @@
1
+ /** Коды ошибок сессии API. */
2
+ declare enum SessionError {
3
+ PARAM_SESSION_EXPIRED = 102,
4
+ PARAM_SESSION_KEY = 103,
5
+ PARAM_SIGNATURE = 104,
6
+ AUTH_LOGIN = 401
7
+ }
8
+ /** Ошибки, после которых имеет смысл переавторизоваться. 401 — токен хоста. */
9
+ export declare function isSessionErrorCode(code: unknown): boolean;
10
+ export default SessionError;
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@vkontakte/calls-sdk",
3
- "version": "2.8.13-dev.c9243c68.0",
3
+ "version": "2.8.13-dev.d26e27ad.0",
4
4
  "author": "vk.com",
5
5
  "description": "Library for video calls based on the vk.com platform",
6
6
  "homepage": "https://vk.com",
@@ -1,5 +1,9 @@
1
1
  import { IAPIBaseUrl, IApiEnv } from '../types/Params';
2
2
  export declare function resetApiEndpoint(): void;
3
+ /**
4
+ * Убираем слэш на конце
5
+ */
6
+ export declare function sanitizeApiBaseUrl(url: IAPIBaseUrl): IAPIBaseUrl;
3
7
  export declare function _resolveApiEndpoint(apiBaseUrl?: IAPIBaseUrl, apiEnv?: IApiEnv): Promise<string>;
4
8
  export declare function sendBeakon(method: string, params?: {
5
9
  [key: string]: any;
@@ -638,5 +638,15 @@ declare namespace External {
638
638
  * Собеседник подключился к сигналлингу
639
639
  */
640
640
  function onPeerRegistered(conversationId?: string, externalIds?: ExternalId[]): void;
641
+ /**
642
+ * SDK обнаружил ошибку, после которой звонок может продолжаться.
643
+ *
644
+ * Callback предназначен для отправки ошибки в клиентский мониторинг.
645
+ * Его вызов не означает завершение звонка.
646
+ *
647
+ * @param error
648
+ * @param conversationId ID звонка
649
+ */
650
+ function onNonFatalError(error: Error, conversationId: string | null): void;
641
651
  }
642
652
  export default External;
@@ -37,6 +37,27 @@ export type ParamsObject = {
37
37
  platform: string;
38
38
  /** @hidden */
39
39
  clientStatsPlatform: string;
40
+ /**
41
+ * Версия приложения-хоста, уходит в статистику и сигналинг, например `'26.31.0:6822'`.
42
+ * По умолчанию `'0.0.0'`
43
+ */
44
+ appVersion: string;
45
+ /**
46
+ * Автоматически запускать отправку клиентской статистики при `init()`.
47
+ *
48
+ * При `false` события копятся в очереди, но не уходят в сеть, пока хост не
49
+ * вызовет `startStats()`.
50
+ *
51
+ * _По умолчанию: `true`_
52
+ */
53
+ autoStartStats: boolean;
54
+ /**
55
+ * Персистентная очередь клиентской статистики: события копятся в IndexedDB
56
+ * и уезжают пачками с подтверждением, переживая перезагрузку вкладки.
57
+ *
58
+ * _По умолчанию: `false`_
59
+ */
60
+ statQueueEnabled: boolean;
40
61
  /** @hidden */
41
62
  clientType: string;
42
63
  /** @hidden */
@@ -911,6 +932,13 @@ export type ParamsObject = {
911
932
  * Собеседник подключился к сигналлингу
912
933
  */
913
934
  onPeerRegistered?: (conversationId?: string, externalIds?: ExternalId[]) => void;
935
+ /**
936
+ * SDK обнаружил ошибку, после которой звонок может продолжаться.
937
+ *
938
+ * Callback предназначен для отправки ошибки в клиентский мониторинг.
939
+ * Его вызов не означает завершение звонка.
940
+ */
941
+ onNonFatalError?: (error: Error, conversationId: string | null) => void;
914
942
  };
915
943
  export default abstract class Params {
916
944
  private static _params;
@@ -920,7 +948,13 @@ export default abstract class Params {
920
948
  static getScreenFrameRate(fastScreenShare: boolean): number;
921
949
  static get<N extends keyof ParamsObject>(name: N): ParamsObject[N];
922
950
  static get appName(): string;
923
- static get appVersion(): number;
951
+ static get appVersion(): string;
952
+ /**
953
+ * Версия клиента для `client_version` в `auth.anonymLogin`. Бэкенд валидирует формат,
954
+ * поэтому это фиксированное значение, а не версия приложения-хоста (см. {@link Params.appVersion}).
955
+ * @hidden
956
+ */
957
+ static get apiClientVersion(): number;
924
958
  static get sdkVersion(): string;
925
959
  static get debug(): boolean;
926
960
  static get protocolVersion(): 5 | 6;
@@ -928,6 +962,8 @@ export default abstract class Params {
928
962
  static set platform(value: string);
929
963
  static get clientStatsPlatform(): string;
930
964
  static set clientStatsPlatform(value: string);
965
+ static get autoStartStats(): boolean;
966
+ static get statQueueEnabled(): boolean;
931
967
  static get clientType(): string;
932
968
  static set clientType(value: string);
933
969
  static get externalUserType(): string;
@@ -1080,6 +1116,9 @@ export default abstract class Params {
1080
1116
  movieShare: boolean;
1081
1117
  clientType: string;
1082
1118
  clientStatsPlatform: string;
1119
+ appVersion: string;
1120
+ autoStartStats: boolean;
1121
+ statQueueEnabled: boolean;
1083
1122
  consumerScreenDataChannelPacketSize: number;
1084
1123
  switchVideoAtBadNetwork: boolean;
1085
1124
  simulcast: boolean;
@@ -0,0 +1,29 @@
1
+ export type StoredSession = {
2
+ sessionKey: string;
3
+ /** Ключ окружения на момент сохранения, см. currentEndpoint(). */
4
+ endpoint: string;
5
+ savedAt: number;
6
+ };
7
+ /**
8
+ * Снимки сессий по uid на диске. Снимок может быть протухшим и переавторизации
9
+ * не подлежит, поэтому годится только для отложенных best-effort задач вроде
10
+ * досылки статистики.
11
+ */
12
+ export default abstract class SessionStore {
13
+ static remember(uid: number, session: {
14
+ sessionKey: string;
15
+ endpoint: string;
16
+ }): void;
17
+ static get(uid: number): StoredSession | null;
18
+ static forget(uid: number): void;
19
+ /** Снимок живёт столько же, сколько события, которые он мог бы дослать. */
20
+ static prune(now?: number): void;
21
+ /**
22
+ * Ключ окружения: сессия прода не должна улететь на тестовый кластер.
23
+ * Адрес нормализуется так же, как в транспорте.
24
+ */
25
+ static currentEndpoint(): string;
26
+ private static _read;
27
+ private static _write;
28
+ private static _isValid;
29
+ }
@@ -4,6 +4,7 @@ export declare const SIMULCAST_DEFAULT: {
4
4
  HEIGHT: number;
5
5
  WIDTH: number;
6
6
  BITRATE: number;
7
+ FPS: number;
7
8
  };
8
9
  export declare const SIMULCAST_SCALABILITY_MODE = "L1T2";
9
10
  export declare function isEqualSimulcastInfo(si1: ISimulcastInfo | null, si2: ISimulcastInfo | null): boolean;
@@ -2,7 +2,7 @@
2
2
  * Вспомогательный плагин для работы с WebRTC
3
3
  */
4
4
  import { IVideoDimentions } from '../types/MediaSettings';
5
- import type StatsLogger from '../classes/StatsLogger';
5
+ import type StatEventCollector from '../classes/stat/StatEventCollector';
6
6
  import { type DebugLogger } from './Debug';
7
7
  /**
8
8
  * Тип камеры мобильного устройства
@@ -85,24 +85,24 @@ declare namespace WebRTCUtils {
85
85
  * @param needAudio Нужно ли аудио
86
86
  * @param needEmptyTracks Добавлять ли в стрим пустые треки для отключенного видео/аудио
87
87
  */
88
- function getUserMedia(needVideo?: boolean, needAudio?: boolean, needEmptyTracks?: boolean, debug?: DebugLogger, logger?: StatsLogger | null): Promise<MediaStream>;
88
+ function getUserMedia(needVideo?: boolean, needAudio?: boolean, needEmptyTracks?: boolean, debug?: DebugLogger, logger?: StatEventCollector | null): Promise<MediaStream>;
89
89
  /**
90
90
  * Запрашивает трансляцию экрана пользователя с опциональным захватом звука
91
91
  */
92
- function getScreenMedia(fastScreenShare: boolean, withAudioShare: boolean, debug?: DebugLogger, logger?: StatsLogger | null): Promise<MediaStream>;
92
+ function getScreenMedia(fastScreenShare: boolean, withAudioShare: boolean, debug?: DebugLogger, logger?: StatEventCollector | null): Promise<MediaStream>;
93
93
  /**
94
94
  * Запрашивает камеру пользователя
95
95
  *
96
96
  * @param deviceId ID устройства
97
97
  * @param resolution Размеры видео
98
98
  */
99
- function getUserVideo(deviceId?: string, resolution?: IVideoDimentions, debug?: DebugLogger, logger?: StatsLogger | null): Promise<MediaStream>;
99
+ function getUserVideo(deviceId?: string, resolution?: IVideoDimentions, debug?: DebugLogger, logger?: StatEventCollector | null): Promise<MediaStream>;
100
100
  /**
101
101
  * Запрашивает микрофон пользователя
102
102
  *
103
103
  * @param deviceId ID устройства
104
104
  */
105
- function getUserAudio(deviceId?: string, debug?: DebugLogger, logger?: StatsLogger | null): Promise<MediaStream>;
105
+ function getUserAudio(deviceId?: string, debug?: DebugLogger, logger?: StatEventCollector | null): Promise<MediaStream>;
106
106
  /**
107
107
  * Устанавливает размер видео в стриме
108
108
  *