@livekit/rtc-node 0.13.27 → 0.13.29

package/dist/track_publication.js

@@ -46,6 +46,17 @@ class TrackPublication {
     var _a;
     return (_a = this.info) == null ? void 0 : _a.encryptionType;
   }
+  /**
+   * Update the publication's info in place. Used by the SDK when the
+   * server re-issues IDs / metadata for an existing publication (e.g.
+   * after a full reconnect). Application code holding a cached
+   * publication reference continues to read fresh values via the
+   * unchanged object identity.
+   * @internal
+   */
+  updateInfo(info) {
+    this.info = info;
+  }
 }
 class LocalTrackPublication extends TrackPublication {
   constructor(ownedInfo) {

package/dist/track_publication.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/track_publication.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2024 LiveKit, Inc.\n//\n// SPDX-License-Identifier: Apache-2.0\nimport type { EncryptionType } from '@livekit/rtc-ffi-bindings';\nimport type { SetSubscribedResponse } from '@livekit/rtc-ffi-bindings';\nimport { SetSubscribedRequest } from '@livekit/rtc-ffi-bindings';\nimport type {\n  OwnedTrackPublication,\n  TrackKind,\n  TrackPublicationInfo,\n  TrackSource,\n} from '@livekit/rtc-ffi-bindings';\nimport { FfiHandle } from '@livekit/rtc-ffi-bindings';\nimport { FfiClient } from './ffi_client.js';\nimport type { Track } from './track.js';\n\nexport abstract class TrackPublication {\n  /** @internal */\n  ffiHandle: FfiHandle;\n\n  /** @internal */\n  info?: TrackPublicationInfo;\n  track?: Track;\n\n  constructor(ownedInfo: OwnedTrackPublication) {\n    this.info = ownedInfo.info;\n    this.ffiHandle = new FfiHandle(ownedInfo.handle!.id!);\n  }\n\n  get sid(): string | undefined {\n    return this.info?.sid;\n  }\n\n  get name(): string | undefined {\n    return this.info?.name;\n  }\n\n  get kind(): TrackKind | undefined {\n    return this.info?.kind;\n  }\n\n  get source(): TrackSource | undefined {\n    return this.info?.source;\n  }\n\n  get simulcasted(): boolean | undefined {\n    return this.info?.simulcasted;\n  }\n\n  get width(): number | undefined {\n    return this.info?.width;\n  }\n\n  get height(): number | undefined {\n    return this.info?.height;\n  }\n\n  get mimeType(): string | undefined {\n    return this.info?.mimeType;\n  }\n\n  get muted(): boolean | undefined {\n    return this.info?.muted;\n  }\n\n  get encryptionType(): EncryptionType | undefined {\n    return this.info?.encryptionType;\n  }\n}\n\nexport class LocalTrackPublication extends TrackPublication {\n  private firstSubscription: Promise<void>;\n  private firstSubscriptionResolver: (() => void) | null = null;\n\n  constructor(ownedInfo: OwnedTrackPublication) {\n    super(ownedInfo);\n    this.firstSubscription = new Promise<void>((resolve) => {\n      this.firstSubscriptionResolver = resolve;\n    });\n  }\n\n  async waitForSubscription(): Promise<void> {\n    await this.firstSubscription;\n  }\n\n  /** @internal */\n  resolveFirstSubscription(): void {\n    if (this.firstSubscriptionResolver) {\n      this.firstSubscriptionResolver();\n      this.firstSubscriptionResolver = null;\n    }\n  }\n}\n\nexport class RemoteTrackPublication extends TrackPublication {\n  subscribed: boolean = false;\n\n  constructor(ownedInfo: OwnedTrackPublication) {\n    super(ownedInfo);\n  }\n\n  setSubscribed(subscribed: boolean) {\n    const req = new SetSubscribedRequest({\n      subscribe: subscribed,\n      publicationHandle: this.ffiHandle.handle,\n    });\n\n    FfiClient.instance.request<SetSubscribedResponse>({\n      message: { case: 'setSubscribed', value: req },\n    });\n  }\n}\n"],"mappings":"AAKA,SAAS,4BAA4B;AAOrC,SAAS,iBAAiB;AAC1B,SAAS,iBAAiB;AAGnB,MAAe,iBAAiB;AAAA,EAQrC,YAAY,WAAkC;AAC5C,SAAK,OAAO,UAAU;AACtB,SAAK,YAAY,IAAI,UAAU,UAAU,OAAQ,EAAG;AAAA,EACtD;AAAA,EAEA,IAAI,MAA0B;AA7BhC;AA8BI,YAAO,UAAK,SAAL,mBAAW;AAAA,EACpB;AAAA,EAEA,IAAI,OAA2B;AAjCjC;AAkCI,YAAO,UAAK,SAAL,mBAAW;AAAA,EACpB;AAAA,EAEA,IAAI,OAA8B;AArCpC;AAsCI,YAAO,UAAK,SAAL,mBAAW;AAAA,EACpB;AAAA,EAEA,IAAI,SAAkC;AAzCxC;AA0CI,YAAO,UAAK,SAAL,mBAAW;AAAA,EACpB;AAAA,EAEA,IAAI,cAAmC;AA7CzC;AA8CI,YAAO,UAAK,SAAL,mBAAW;AAAA,EACpB;AAAA,EAEA,IAAI,QAA4B;AAjDlC;AAkDI,YAAO,UAAK,SAAL,mBAAW;AAAA,EACpB;AAAA,EAEA,IAAI,SAA6B;AArDnC;AAsDI,YAAO,UAAK,SAAL,mBAAW;AAAA,EACpB;AAAA,EAEA,IAAI,WAA+B;AAzDrC;AA0DI,YAAO,UAAK,SAAL,mBAAW;AAAA,EACpB;AAAA,EAEA,IAAI,QAA6B;AA7DnC;AA8DI,YAAO,UAAK,SAAL,mBAAW;AAAA,EACpB;AAAA,EAEA,IAAI,iBAA6C;AAjEnD;AAkEI,YAAO,UAAK,SAAL,mBAAW;AAAA,EACpB;AACF;AAEO,MAAM,8BAA8B,iBAAiB;AAAA,EAI1D,YAAY,WAAkC;AAC5C,UAAM,SAAS;AAHjB,SAAQ,4BAAiD;AAIvD,SAAK,oBAAoB,IAAI,QAAc,CAAC,YAAY;AACtD,WAAK,4BAA4B;AAAA,IACnC,CAAC;AAAA,EACH;AAAA,EAEA,MAAM,sBAAqC;AACzC,UAAM,KAAK;AAAA,EACb;AAAA;AAAA,EAGA,2BAAiC;AAC/B,QAAI,KAAK,2BAA2B;AAClC,WAAK,0BAA0B;AAC/B,WAAK,4BAA4B;AAAA,IACnC;AAAA,EACF;AACF;AAEO,MAAM,+BAA+B,iBAAiB;AAAA,EAG3D,YAAY,WAAkC;AAC5C,UAAM,SAAS;AAHjB,sBAAsB;AAAA,EAItB;AAAA,EAEA,cAAc,YAAqB;AACjC,UAAM,MAAM,IAAI,qBAAqB;AAAA,MACnC,WAAW;AAAA,MACX,mBAAmB,KAAK,UAAU;AAAA,IACpC,CAAC;AAED,cAAU,SAAS,QAA+B;AAAA,MAChD,SAAS,EAAE,MAAM,iBAAiB,OAAO,IAAI;AAAA,IAC/C,CAAC;AAAA,EACH;AACF;","names":[]}
+{"version":3,"sources":["../src/track_publication.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2024 LiveKit, Inc.\n//\n// SPDX-License-Identifier: Apache-2.0\nimport type { EncryptionType } from '@livekit/rtc-ffi-bindings';\nimport type { SetSubscribedResponse } from '@livekit/rtc-ffi-bindings';\nimport { SetSubscribedRequest } from '@livekit/rtc-ffi-bindings';\nimport type {\n  OwnedTrackPublication,\n  TrackKind,\n  TrackPublicationInfo,\n  TrackSource,\n} from '@livekit/rtc-ffi-bindings';\nimport { FfiHandle } from '@livekit/rtc-ffi-bindings';\nimport { FfiClient } from './ffi_client.js';\nimport type { Track } from './track.js';\n\nexport abstract class TrackPublication {\n  /** @internal */\n  ffiHandle: FfiHandle;\n\n  /** @internal */\n  info?: TrackPublicationInfo;\n  track?: Track;\n\n  constructor(ownedInfo: OwnedTrackPublication) {\n    this.info = ownedInfo.info;\n    this.ffiHandle = new FfiHandle(ownedInfo.handle!.id!);\n  }\n\n  get sid(): string | undefined {\n    return this.info?.sid;\n  }\n\n  get name(): string | undefined {\n    return this.info?.name;\n  }\n\n  get kind(): TrackKind | undefined {\n    return this.info?.kind;\n  }\n\n  get source(): TrackSource | undefined {\n    return this.info?.source;\n  }\n\n  get simulcasted(): boolean | undefined {\n    return this.info?.simulcasted;\n  }\n\n  get width(): number | undefined {\n    return this.info?.width;\n  }\n\n  get height(): number | undefined {\n    return this.info?.height;\n  }\n\n  get mimeType(): string | undefined {\n    return this.info?.mimeType;\n  }\n\n  get muted(): boolean | undefined {\n    return this.info?.muted;\n  }\n\n  get encryptionType(): EncryptionType | undefined {\n    return this.info?.encryptionType;\n  }\n\n  /**\n   * Update the publication's info in place. Used by the SDK when the\n   * server re-issues IDs / metadata for an existing publication (e.g.\n   * after a full reconnect). Application code holding a cached\n   * publication reference continues to read fresh values via the\n   * unchanged object identity.\n   * @internal\n   */\n  updateInfo(info: TrackPublicationInfo): void {\n    this.info = info;\n  }\n}\n\nexport class LocalTrackPublication extends TrackPublication {\n  private firstSubscription: Promise<void>;\n  private firstSubscriptionResolver: (() => void) | null = null;\n\n  constructor(ownedInfo: OwnedTrackPublication) {\n    super(ownedInfo);\n    this.firstSubscription = new Promise<void>((resolve) => {\n      this.firstSubscriptionResolver = resolve;\n    });\n  }\n\n  async waitForSubscription(): Promise<void> {\n    await this.firstSubscription;\n  }\n\n  /** @internal */\n  resolveFirstSubscription(): void {\n    if (this.firstSubscriptionResolver) {\n      this.firstSubscriptionResolver();\n      this.firstSubscriptionResolver = null;\n    }\n  }\n}\n\nexport class RemoteTrackPublication extends TrackPublication {\n  subscribed: boolean = false;\n\n  constructor(ownedInfo: OwnedTrackPublication) {\n    super(ownedInfo);\n  }\n\n  setSubscribed(subscribed: boolean) {\n    const req = new SetSubscribedRequest({\n      subscribe: subscribed,\n      publicationHandle: this.ffiHandle.handle,\n    });\n\n    FfiClient.instance.request<SetSubscribedResponse>({\n      message: { case: 'setSubscribed', value: req },\n    });\n  }\n}\n"],"mappings":"AAKA,SAAS,4BAA4B;AAOrC,SAAS,iBAAiB;AAC1B,SAAS,iBAAiB;AAGnB,MAAe,iBAAiB;AAAA,EAQrC,YAAY,WAAkC;AAC5C,SAAK,OAAO,UAAU;AACtB,SAAK,YAAY,IAAI,UAAU,UAAU,OAAQ,EAAG;AAAA,EACtD;AAAA,EAEA,IAAI,MAA0B;AA7BhC;AA8BI,YAAO,UAAK,SAAL,mBAAW;AAAA,EACpB;AAAA,EAEA,IAAI,OAA2B;AAjCjC;AAkCI,YAAO,UAAK,SAAL,mBAAW;AAAA,EACpB;AAAA,EAEA,IAAI,OAA8B;AArCpC;AAsCI,YAAO,UAAK,SAAL,mBAAW;AAAA,EACpB;AAAA,EAEA,IAAI,SAAkC;AAzCxC;AA0CI,YAAO,UAAK,SAAL,mBAAW;AAAA,EACpB;AAAA,EAEA,IAAI,cAAmC;AA7CzC;AA8CI,YAAO,UAAK,SAAL,mBAAW;AAAA,EACpB;AAAA,EAEA,IAAI,QAA4B;AAjDlC;AAkDI,YAAO,UAAK,SAAL,mBAAW;AAAA,EACpB;AAAA,EAEA,IAAI,SAA6B;AArDnC;AAsDI,YAAO,UAAK,SAAL,mBAAW;AAAA,EACpB;AAAA,EAEA,IAAI,WAA+B;AAzDrC;AA0DI,YAAO,UAAK,SAAL,mBAAW;AAAA,EACpB;AAAA,EAEA,IAAI,QAA6B;AA7DnC;AA8DI,YAAO,UAAK,SAAL,mBAAW;AAAA,EACpB;AAAA,EAEA,IAAI,iBAA6C;AAjEnD;AAkEI,YAAO,UAAK,SAAL,mBAAW;AAAA,EACpB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUA,WAAW,MAAkC;AAC3C,SAAK,OAAO;AAAA,EACd;AACF;AAEO,MAAM,8BAA8B,iBAAiB;AAAA,EAI1D,YAAY,WAAkC;AAC5C,UAAM,SAAS;AAHjB,SAAQ,4BAAiD;AAIvD,SAAK,oBAAoB,IAAI,QAAc,CAAC,YAAY;AACtD,WAAK,4BAA4B;AAAA,IACnC,CAAC;AAAA,EACH;AAAA,EAEA,MAAM,sBAAqC;AACzC,UAAM,KAAK;AAAA,EACb;AAAA;AAAA,EAGA,2BAAiC;AAC/B,QAAI,KAAK,2BAA2B;AAClC,WAAK,0BAA0B;AAC/B,WAAK,4BAA4B;AAAA,IACnC;AAAA,EACF;AACF;AAEO,MAAM,+BAA+B,iBAAiB;AAAA,EAG3D,YAAY,WAAkC;AAC5C,UAAM,SAAS;AAHjB,sBAAsB;AAAA,EAItB;AAAA,EAEA,cAAc,YAAqB;AACjC,UAAM,MAAM,IAAI,qBAAqB;AAAA,MACnC,WAAW;AAAA,MACX,mBAAmB,KAAK,UAAU;AAAA,IACpC,CAAC;AAED,cAAU,SAAS,QAA+B;AAAA,MAChD,SAAS,EAAE,MAAM,iBAAiB,OAAO,IAAI;AAAA,IAC/C,CAAC;AAAA,EACH;AACF;","names":[]}

package/dist/version.cjs

@@ -21,7 +21,7 @@ __export(version_exports, {
   SDK_VERSION: () => SDK_VERSION
 });
 module.exports = __toCommonJS(version_exports);
-const SDK_VERSION = "0.13.27";
+const SDK_VERSION = "0.13.29";
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   SDK_VERSION

package/dist/version.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/version.ts"],"sourcesContent":["export const SDK_VERSION = \"0.13.27\";\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAO,MAAM,cAAc;","names":[]}
+{"version":3,"sources":["../src/version.ts"],"sourcesContent":["export const SDK_VERSION = \"0.13.29\";\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAO,MAAM,cAAc;","names":[]}

package/dist/version.d.cts

@@ -1,3 +1,3 @@
-declare const SDK_VERSION = "0.13.27";
+declare const SDK_VERSION = "0.13.29";
 
 export { SDK_VERSION };

package/dist/version.d.ts

@@ -1,3 +1,3 @@
-declare const SDK_VERSION = "0.13.27";
+declare const SDK_VERSION = "0.13.29";
 
 export { SDK_VERSION };

package/dist/version.js

@@ -1,4 +1,4 @@
-const SDK_VERSION = "0.13.27";
+const SDK_VERSION = "0.13.29";
 export {
   SDK_VERSION
 };

package/dist/version.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/version.ts"],"sourcesContent":["export const SDK_VERSION = \"0.13.27\";\n"],"mappings":"AAAO,MAAM,cAAc;","names":[]}
+{"version":3,"sources":["../src/version.ts"],"sourcesContent":["export const SDK_VERSION = \"0.13.29\";\n"],"mappings":"AAAO,MAAM,cAAc;","names":[]}

package/package.json

@@ -3,7 +3,7 @@
   "description": "LiveKit RTC Node",
   "license": "Apache-2.0",
   "author": "LiveKit",
-  "version": "0.13.27",
+  "version": "0.13.29",
   "main": "dist/index.js",
   "require": "dist/index.cjs",
   "types": "dist/index.d.ts",
@@ -32,19 +32,19 @@
   "dependencies": {
     "@datastructures-js/deque": "1.0.8",
     "@livekit/mutex": "^1.0.0",
+    "@livekit/rtc-ffi-bindings": "0.12.60",
     "@livekit/typed-emitter": "^3.0.0",
-    "@livekit/rtc-ffi-bindings": "0.12.52-patch.0",
     "pino": "^9.0.0",
     "pino-pretty": "^13.0.0"
   },
   "devDependencies": {
     "@bufbuild/protobuf": "^1.10.1",
     "@types/node": "^22.13.10",
-    "vitest": "^3.0.0",
     "prettier": "^3.0.3",
     "tsup": "^8.3.5",
     "typescript": "5.8.2",
-    "livekit-server-sdk": "2.15.2"
+    "vitest": "^3.0.0",
+    "livekit-server-sdk": "2.15.3"
   },
   "engines": {
     "node": ">= 18"
@@ -53,6 +53,7 @@
     "prebuild": "node -p \"'export const SDK_VERSION = ' + JSON.stringify(require('./package.json').version) + ';'\" > src/version.ts",
     "build": "pnpm prebuild && tsup --onSuccess \"tsc --declaration --emitDeclarationOnly\"",
     "lint": "eslint -f unix \"src/**/*.ts\" --ignore-pattern \"src/proto/*\"",
-    "test": "vitest run src"
+    "test": "vitest run src",
+    "test:e2e": "node scripts/run-e2e.mjs"
   }
 }

package/src/ffi_client.ts

@@ -41,6 +41,8 @@ export class FfiClient extends (EventEmitter as new () => TypedEmitter<FfiClient
     return globalThis._ffiClientInstance;
   }
 
+  private _nextRequestAsyncId = BigInt(0);
+
   constructor() {
     super();
     this.setMaxListeners(0);
@@ -70,6 +72,10 @@ export class FfiClient extends (EventEmitter as new () => TypedEmitter<FfiClient
     return livekitRetrievePtr(data);
   }
 
+  getNextRequestAsyncId() {
+    return ++this._nextRequestAsyncId;
+  }
+
   async waitFor<T>(
     predicate: (ev: FfiEvent) => boolean,
     options?: { signal?: AbortSignal },

package/src/index.ts

@@ -15,7 +15,11 @@ export type { E2EEOptions, KeyProviderOptions } from './e2ee.js';
 export { dispose } from './ffi_client.js';
 export { LocalParticipant, Participant, RemoteParticipant } from './participant.js';
 export { EncryptionState, EncryptionType } from '@livekit/rtc-ffi-bindings';
-export { DisconnectReason, ParticipantKind } from '@livekit/rtc-ffi-bindings';
+export {
+  DisconnectReason,
+  ParticipantKind,
+  ParticipantKindDetail,
+} from '@livekit/rtc-ffi-bindings';
 export {
   ConnectionQuality,
   ConnectionState,
@@ -25,7 +29,12 @@ export {
   IceTransportType,
   TrackPublishOptions,
 } from '@livekit/rtc-ffi-bindings';
-export { StreamState, TrackKind, TrackSource } from '@livekit/rtc-ffi-bindings';
+export {
+  SimulateScenarioKind,
+  StreamState,
+  TrackKind,
+  TrackSource,
+} from '@livekit/rtc-ffi-bindings';
 export { VideoBufferType, VideoCodec, VideoRotation } from '@livekit/rtc-ffi-bindings';
 export { ConnectError, Room, RoomEvent, type RoomOptions, type RtcConfiguration } from './room.js';
 export { RpcError, type PerformRpcParams, type RpcInvocationData } from './rpc.js';

package/src/participant.ts

@@ -7,6 +7,7 @@ import {
   type OwnedParticipant,
   type ParticipantInfo,
   ParticipantKind,
+  type ParticipantKindDetail,
 } from '@livekit/rtc-ffi-bindings';
 import {
   ChatMessage as ChatMessageModel,
@@ -128,6 +129,10 @@ export abstract class Participant {
     return this.info.kind ?? ParticipantKind.STANDARD;
   }
 
+  get kindDetails(): ParticipantKindDetail[] {
+    return this.info.kindDetails ?? [];
+  }
+
   get disconnectReason(): DisconnectReason | undefined {
     if (this.info.disconnectReason === DisconnectReason.UNKNOWN_REASON) {
       return undefined;

package/src/room.ts

@@ -3,9 +3,17 @@
 // SPDX-License-Identifier: Apache-2.0
 import { Mutex } from '@livekit/mutex';
 import { EncryptionState, type EncryptionType } from '@livekit/rtc-ffi-bindings';
-import type { FfiEvent } from '@livekit/rtc-ffi-bindings';
+import type {
+  FfiEvent,
+  GetSessionStatsCallback,
+  GetSessionStatsResponse,
+} from '@livekit/rtc-ffi-bindings';
 import { DisconnectReason, type OwnedParticipant } from '@livekit/rtc-ffi-bindings';
-import type { DataStream_Trailer, DisconnectCallback } from '@livekit/rtc-ffi-bindings';
+import type {
+  DataStream_Trailer,
+  DisconnectCallback,
+  TrackPublicationInfo,
+} from '@livekit/rtc-ffi-bindings';
 import {
   type ConnectCallback,
   ConnectRequest,
@@ -20,7 +28,11 @@ import {
   RoomOptions as FfiRoomOptions,
   type IceServer,
   IceTransportType,
+  type ReadyForRoomEventResponse,
   type RoomInfo,
+  type SimulateScenarioCallback,
+  type SimulateScenarioKind,
+  type SimulateScenarioResponse,
 } from '@livekit/rtc-ffi-bindings';
 import { TrackKind } from '@livekit/rtc-ffi-bindings';
 import type { TypedEventEmitter as TypedEmitter } from '@livekit/typed-emitter';
@@ -184,6 +196,36 @@ export class Room extends (EventEmitter as new () => TypedEmitter<RoomCallbacks>
     return this.sidPromise;
   }
 
+  async getRtcStats() {
+    if (!this.isConnected || !this.ffiHandle) {
+      throw new Error('getRtcStats requires a connected room');
+    }
+    // subscribe before issuing the request
+    const requestId = FfiClient.instance.getNextRequestAsyncId();
+    const cbPromise = FfiClient.instance.waitFor<GetSessionStatsCallback>(
+      (ev: FfiEvent) =>
+        ev.message.case === 'getSessionStats' && ev.message.value.asyncId === requestId,
+      { signal: this.disconnectController.signal },
+    );
+    FfiClient.instance.request<GetSessionStatsResponse>({
+      message: {
+        case: 'getSessionStats',
+        value: {
+          roomHandle: this.ffiHandle.handle,
+          requestAsyncId: requestId,
+        },
+      },
+    });
+    const cb = await cbPromise;
+    if (cb.message.case === 'error') {
+      throw new Error(cb.message.value);
+    } else if (cb.message.case === 'result') {
+      return cb.message.value;
+    } else {
+      throw new Error('could not retrieve rtc stats');
+    }
+  }
+
   get numParticipants(): number {
     return this.info?.numParticipants ?? 0;
   }
@@ -285,6 +327,15 @@ export class Room extends (EventEmitter as new () => TypedEmitter<RoomCallbacks>
             }
           }
           this.updateConnectionState(ConnectionState.CONN_CONNECTED);
+          // Release the FFI room event gate after our listener and local state are ready.
+          FfiClient.instance.request<ReadyForRoomEventResponse>({
+            message: {
+              case: 'readyForRoomEvent',
+              value: {
+                roomHandle: this.ffiHandle.handle,
+              },
+            },
+          });
           break;
         case 'error':
         default:
@@ -325,6 +376,36 @@ export class Room extends (EventEmitter as new () => TypedEmitter<RoomCallbacks>
     this.removeAllListeners();
   }
 
+  /**
+   * Trigger a reconnection / chaos scenario for testing. Most useful in
+   * tests to deterministically force a Resume (signal-only reconnect that
+   * preserves the PeerConnection and existing publications) or a full
+   * reconnect (the SDK rebuilds the RtcSession and re-publishes existing
+   * local tracks; `RoomEvent.Reconnected` fires).
+   */
+  async simulateScenario(scenario: SimulateScenarioKind): Promise<void> {
+    if (!this.isConnected || !this.ffiHandle) {
+      throw new Error('simulateScenario requires a connected room');
+    }
+    const res = FfiClient.instance.request<SimulateScenarioResponse>({
+      message: {
+        case: 'simulateScenario',
+        value: {
+          roomHandle: this.ffiHandle.handle,
+          scenario,
+        },
+      },
+    });
+    const cb = await FfiClient.instance.waitFor<SimulateScenarioCallback>(
+      (ev: FfiEvent) =>
+        ev.message.case === 'simulateScenario' && ev.message.value.asyncId === res.asyncId,
+      { signal: this.disconnectController.signal },
+    );
+    if (cb.error) {
+      throw new Error(`simulateScenario failed: ${cb.error}`);
+    }
+  }
+
   private updateConnectionState(newState: ConnectionState) {
     if (this._connectionState === newState) {
       return;
@@ -481,6 +562,19 @@ export class Room extends (EventEmitter as new () => TypedEmitter<RoomCallbacks>
       const publication = this.localParticipant.trackPublications.get(ev.value.publicationSid!);
       this.localParticipant.trackPublications.delete(ev.value.publicationSid!);
       this.emit(RoomEvent.LocalTrackUnpublished, publication!, this.localParticipant!);
+    } else if ((ev.case as string) == 'localTrackRepublished') {
+      const value = (ev as any).value;
+      const previousSid: string = value.previousSid!;
+      const newInfo: TrackPublicationInfo = value.info!;
+      const publication = this.localParticipant.trackPublications.get(previousSid);
+      if (publication) {
+        publication.updateInfo(newInfo);
+        this.localParticipant.trackPublications.delete(previousSid);
+        this.localParticipant.trackPublications.set(publication.sid!, publication);
+        this.emit(RoomEvent.LocalTrackRepublished, publication, previousSid, this.localParticipant);
+      } else {
+        log.warn(`RoomEvent.LocalTrackRepublished: previous publication not found: ${previousSid}`);
+      }
     } else if (ev.case == 'localTrackSubscribed') {
       const publication = this.localParticipant.trackPublications.get(ev.value.trackSid!);
       if (publication) {
@@ -903,6 +997,18 @@ export type RoomCallbacks = {
     publication: LocalTrackPublication,
     participant: LocalParticipant,
   ) => void;
+  /**
+   * Fired when the SDK auto-republished a local track during a full
+   * reconnect. The publication object's identity is preserved (the same
+   * instance is updated in place with the new server-assigned SIDs);
+   * `previousSid` is provided for callers that key external state on the
+   * old SID and need to reconcile.
+   */
+  localTrackRepublished: (
+    publication: LocalTrackPublication,
+    previousSid: string,
+    participant: LocalParticipant,
+  ) => void;
   localTrackSubscribed: (track: LocalTrack) => void;
   trackPublished: (publication: RemoteTrackPublication, participant: RemoteParticipant) => void;
   trackUnpublished: (publication: RemoteTrackPublication, participant: RemoteParticipant) => void;
@@ -960,6 +1066,7 @@ export enum RoomEvent {
   ParticipantDisconnected = 'participantDisconnected',
   LocalTrackPublished = 'localTrackPublished',
   LocalTrackUnpublished = 'localTrackUnpublished',
+  LocalTrackRepublished = 'localTrackRepublished',
   LocalTrackSubscribed = 'localTrackSubscribed',
   TrackPublished = 'trackPublished',
   TrackUnpublished = 'trackUnpublished',

package/src/tests/e2e.test.ts

@@ -15,6 +15,8 @@ import {
   Room,
   RoomEvent,
   RpcError,
+  SimulateScenarioKind,
+  TrackKind,
   TrackPublishOptions,
   TrackSource,
   dispose,
@@ -682,4 +684,159 @@ describeE2E('livekit-rtc e2e', () => {
     },
     testTimeoutMs,
   );
+
+  // -- Reconnect scenarios --
+  //
+  // Both tests verify the user-visible behavior: after the scenario fires,
+  // the subscriber continues to receive the publisher's tone. The full
+  // reconnect test additionally asserts there is exactly one audio
+  // publication on each side (regression: duplicate-publish bug).
+
+  const runReconnectScenario = async (scenario: SimulateScenarioKind) => {
+    const { rooms } = await connectTestRooms(2);
+    const [subRoom, pubRoom] = rooms;
+
+    const pubRateHz = 48_000;
+    const source = new AudioSource(pubRateHz, 1);
+    const track = LocalAudioTrack.createAudioTrack('reconnect_tone', source);
+    const opts = new TrackPublishOptions();
+    opts.source = TrackSource.SOURCE_MICROPHONE;
+    await pubRoom!.localParticipant!.publishTrack(track, opts);
+
+    let tonePhase = 0;
+    const samplesPer10ms = Math.floor(pubRateHz / 100);
+    const amplitude = 0.8 * 32767;
+    const sineHz = 60;
+    let toneRunning = true;
+    const toneTask = (async () => {
+      while (toneRunning) {
+        const frame = AudioFrame.create(pubRateHz, 1, samplesPer10ms);
+        for (let s = 0; s < samplesPer10ms; s++) {
+          frame.data[s] = Math.round(
+            amplitude * Math.sin((2 * Math.PI * sineHz * tonePhase) / pubRateHz),
+          );
+          tonePhase++;
+        }
+        await source.captureFrame(frame);
+      }
+    })();
+
+    // Subscriber-side: re-attach an AudioStream every time TrackSubscribed
+    // fires (a full reconnect may issue TrackUnsubscribed → TrackSubscribed
+    // with a fresh remote track).
+    const sub = {
+      lastFrameAt: 0,
+      collectFromMs: Number.POSITIVE_INFINITY,
+      collected: [] as Int16Array[],
+      readers: [] as ReturnType<AudioStream['getReader']>[],
+    };
+    const attach = (remoteTrack: unknown) => {
+      const stream = new AudioStream(remoteTrack as any, {
+        sampleRate: pubRateHz,
+        numChannels: 1,
+      });
+      const reader = stream.getReader();
+      sub.readers.push(reader);
+      (async () => {
+        try {
+          while (true) {
+            const { done, value } = await reader.read();
+            if (done) break;
+            sub.lastFrameAt = Date.now();
+            if (sub.lastFrameAt >= sub.collectFromMs) {
+              sub.collected.push(channelSamples(value, 0));
+            }
+          }
+        } catch {
+          // reader released
+        }
+      })();
+    };
+    subRoom!.on(RoomEvent.TrackSubscribed, (t) => attach(t));
+
+    try {
+      await waitFor(() => sub.lastFrameAt > 0 && Date.now() - sub.lastFrameAt < 500, {
+        timeoutMs: 10_000,
+        debugName: 'initial audio flow',
+      });
+
+      const simulateAt = Date.now();
+      await pubRoom!.simulateScenario(scenario);
+
+      // Wait for audio to actually flow again post-simulate: a frame
+      // received well after the simulate AND a fresh latest-frame timestamp.
+      await waitFor(
+        () => sub.lastFrameAt >= simulateAt + 500 && Date.now() - sub.lastFrameAt < 300,
+        { timeoutMs: 30_000, debugName: 'audio re-established after simulate' },
+      );
+      // Drain post-recovery buffer/jitter, then collect a 2s window of
+      // steady-state samples for tone detection.
+      await delay(1_500);
+      sub.collected.length = 0;
+      sub.collectFromMs = Date.now();
+      await waitFor(() => sub.collected.reduce((a, s) => a + s.length, 0) >= pubRateHz * 2, {
+        timeoutMs: 15_000,
+        debugName: 'post-simulate audio sampling',
+      });
+
+      const totalLen = sub.collected.reduce((a, s) => a + s.length, 0);
+      const concat = new Int16Array(totalLen);
+      let off = 0;
+      for (const s of sub.collected) {
+        concat.set(s, off);
+        off += s.length;
+      }
+      const detected = estimateFreqHz(concat, pubRateHz);
+      // Wider tolerance than the clean-path sine test: post-reconnect
+      // audio has brief discontinuities, and the autocorrelation is
+      // integer-lag (next neighbors to 60Hz are exactly 80Hz/40Hz), so
+      // ±20Hz lands right on the failure boundary under CI load.
+      expect(Math.abs(detected - sineHz)).toBeLessThan(25);
+
+      return { rooms, subRoom: subRoom!, pubRoom: pubRoom! };
+    } finally {
+      toneRunning = false;
+      await toneTask;
+      for (const r of sub.readers) {
+        try {
+          r.releaseLock();
+        } catch {
+          // ignore
+        }
+      }
+      await track.close();
+    }
+  };
+
+  itRaw(
+    'resume keeps audio flowing on the subscriber side',
+    async () => {
+      const { rooms } = await runReconnectScenario(SimulateScenarioKind.SIMULATE_SIGNAL_RECONNECT);
+      await Promise.all(rooms.map((r) => r.disconnect()));
+    },
+    testTimeoutMs * 4,
+  );
+
+  itRaw(
+    'full reconnect keeps audio flowing and ends with one publication on the subscriber',
+    async () => {
+      const { rooms, subRoom, pubRoom } = await runReconnectScenario(
+        SimulateScenarioKind.SIMULATE_FULL_RECONNECT,
+      );
+
+      try {
+        // Regression: subscriber must see exactly ONE audio publication after
+        // recovery — not duplicates from the auto-republish path.
+        const subscriberAudioPubs = Array.from(
+          subRoom.remoteParticipants
+            .get(pubRoom.localParticipant!.identity)!
+            .trackPublications.values(),
+        ).filter((p) => p.kind === TrackKind.KIND_AUDIO);
+        expect(subscriberAudioPubs.length).toBe(1);
+      } finally {
+        await Promise.all(rooms.map((r) => r.disconnect()));
+      }
+    },
+    testTimeoutMs * 4,
+  );
 });

package/src/track_publication.ts

@@ -66,6 +66,18 @@ export abstract class TrackPublication {
   get encryptionType(): EncryptionType | undefined {
     return this.info?.encryptionType;
   }
+
+  /**
+   * Update the publication's info in place. Used by the SDK when the
+   * server re-issues IDs / metadata for an existing publication (e.g.
+   * after a full reconnect). Application code holding a cached
+   * publication reference continues to read fresh values via the
+   * unchanged object identity.
+   * @internal
+   */
+  updateInfo(info: TrackPublicationInfo): void {
+    this.info = info;
+  }
 }
 
 export class LocalTrackPublication extends TrackPublication {

package/src/version.ts

@@ -1 +1 @@
-export const SDK_VERSION = "0.13.27";
+export const SDK_VERSION = "0.13.29";