@livekit/rtc-node 0.13.31 → 0.13.33

package/dist/room.d.ts

@@ -1,18 +1,220 @@
-import '@livekit/rtc-ffi-bindings';
-import '@livekit/typed-emitter';
-import './types-_PdPVish.js';
-import './e2ee.js';
-export { C as ConnectError, j as Room, o as RoomCallbacks, k as RoomEvent, l as RoomOptions, m as RtcConfiguration, p as defaultRoomOptions, q as defaultRtcConfiguration } from './audio_stream-DEG1JKge.js';
-import './types.js';
-import 'node:stream/web';
-import './audio_frame.js';
-import './frame_processor.js';
-import './video_frame.js';
-import './audio_source.js';
-import './ffi_client.js';
-import '@livekit/mutex';
-import 'node:fs';
-import './data_streams/stream_writer.js';
-import './rpc.js';
-import './transcription.js';
-import './video_source.js';
+import { type EncryptionType } from '@livekit/rtc-ffi-bindings';
+import { DisconnectReason } from '@livekit/rtc-ffi-bindings';
+import { type ConnectionQuality, ConnectionState, ContinualGatheringPolicy, type DataPacketKind, RoomOptions as FfiRoomOptions, type IceServer, IceTransportType, RoomDataStreamOptions, type RoomInfo, type SimulateScenarioKind } from '@livekit/rtc-ffi-bindings';
+import type { TypedEventEmitter as TypedEmitter } from '@livekit/typed-emitter';
+import type { ByteStreamHandler, TextStreamHandler } from './data_streams/types.js';
+import type { E2EEOptions } from './e2ee.js';
+import { E2EEManager } from './e2ee.js';
+import type { Participant } from './participant.js';
+import { LocalParticipant, RemoteParticipant } from './participant.js';
+import type { LocalTrack, RemoteTrack } from './track.js';
+import type { LocalTrackPublication, TrackPublication } from './track_publication.js';
+import { RemoteTrackPublication } from './track_publication.js';
+import type { ChatMessage } from './types.js';
+export { RoomDataStreamOptions };
+export interface RtcConfiguration {
+    iceTransportType: IceTransportType;
+    continualGatheringPolicy: ContinualGatheringPolicy;
+    iceServers: IceServer[];
+}
+export declare const defaultRtcConfiguration: RtcConfiguration;
+export interface RoomOptions {
+    autoSubscribe: boolean;
+    dynacast: boolean;
+    /**
+     * @deprecated Use `encryption` instead. See x for details
+     */
+    e2ee?: E2EEOptions;
+    encryption?: E2EEOptions;
+    rtcConfig?: RtcConfiguration;
+}
+export declare const defaultRoomOptions: FfiRoomOptions;
+declare const Room_base: new () => TypedEmitter<RoomCallbacks>;
+export declare class Room extends Room_base {
+    private info?;
+    private ffiHandle?;
+    /**
+     * used to ensure events are processed sequentially and allow for
+     * the local participant to acquire the lock while doing state updates related to FFI events
+     * before processing the next events
+     */
+    private ffiEventLock;
+    private byteStreamControllers;
+    private textStreamControllers;
+    private byteStreamHandlers;
+    private textStreamHandlers;
+    private preConnectEvents;
+    private disconnectController;
+    private hasCleanedUp;
+    private _token?;
+    private _serverUrl?;
+    private _connectionState;
+    e2eeManager?: E2EEManager;
+    remoteParticipants: Map<string, RemoteParticipant>;
+    localParticipant?: LocalParticipant;
+    constructor();
+    get connectionState(): ConnectionState;
+    get name(): string | undefined;
+    get metadata(): string | undefined;
+    get isConnected(): boolean;
+    /** @internal */
+    get token(): string | undefined;
+    /** @internal */
+    get serverUrl(): string | undefined;
+    private sidPromise?;
+    /**
+     * Gets the room's server ID. This ID is assigned by the LiveKit server
+     * and is unique for each room session.
+     * SID is assigned asynchronously after connection.
+     * @returns Promise that resolves to the room's server ID, or empty string if not connected
+     */
+    getSid(): Promise<string>;
+    getRtcStats(): Promise<import("@livekit/rtc-ffi-bindings").GetSessionStatsCallback_Result>;
+    get numParticipants(): number;
+    get numPublishers(): number;
+    get creationTime(): Date;
+    get isRecording(): boolean;
+    /**
+     * The time in seconds after which a room will be closed after the last
+     * participant has disconnected.
+     */
+    get departureTimeout(): number;
+    /**
+     * The time in seconds after which an empty room will be automatically closed.
+     */
+    get emptyTimeout(): number;
+    /**
+     * Connects to a LiveKit room using the provided URL and access token.
+     * @param url - The WebSocket URL of the LiveKit server
+     * @param token - A valid LiveKit access token for authentication
+     * @param opts - Optional room configuration options
+     * @throws ConnectError - if connection fails
+     */
+    connect(url: string, token: string, opts?: RoomOptions): Promise<void>;
+    /**
+     * Disconnects from the room and cleans up all resources.
+     * This will stop all tracks and close the connection.
+     */
+    disconnect(): Promise<void>;
+    /**
+     * 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).
+     */
+    simulateScenario(scenario: SimulateScenarioKind): Promise<void>;
+    private updateConnectionState;
+    private cleanupOnDisconnect;
+    /**
+     * Registers a handler for incoming text data streams on a specific topic.
+     * Text streams are used for receiving structured text data from other participants.
+     * @param topic - The topic to listen for text streams on
+     * @param callback - Function to handle incoming text stream data
+     * @throws Error - if a handler for this topic is already registered
+     */
+    registerTextStreamHandler(topic: string, callback: TextStreamHandler): void;
+    unregisterTextStreamHandler(topic: string): void;
+    /**
+     * Registers a handler for incoming byte data streams on a specific topic.
+     * Byte streams are used for receiving binary data like files from other participants.
+     * @param topic - The topic to listen for byte streams on
+     * @param callback - Function to handle incoming byte stream data
+     * @throws Error - if a handler for this topic is already registered
+     */
+    registerByteStreamHandler(topic: string, callback: ByteStreamHandler): void;
+    unregisterByteStreamHandler(topic: string): void;
+    private onFfiEvent;
+    private processFfiEvent;
+    private retrieveParticipantByIdentity;
+    private requireParticipantByIdentity;
+    private requireRemoteParticipant;
+    private requirePublicationOfParticipant;
+    private requirePublicationOfRemoteParticipant;
+    private createRemoteParticipant;
+    private handleStreamHeader;
+    private handleStreamChunk;
+    private handleStreamTrailer;
+}
+export declare class ConnectError extends Error {
+    constructor(message: string);
+}
+export type RoomCallbacks = {
+    participantConnected: (participant: RemoteParticipant) => void;
+    participantDisconnected: (participant: RemoteParticipant) => void;
+    localTrackPublished: (publication: LocalTrackPublication, participant: LocalParticipant) => void;
+    localTrackUnpublished: (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;
+    trackSubscribed: (track: RemoteTrack, publication: RemoteTrackPublication, participant: RemoteParticipant) => void;
+    trackUnsubscribed: (track: RemoteTrack, publication: RemoteTrackPublication, participant: RemoteParticipant) => void;
+    trackSubscriptionFailed: (trackSid: string, participant: RemoteParticipant, reason?: string) => void;
+    trackMuted: (publication: TrackPublication, participant: Participant) => void;
+    trackUnmuted: (publication: TrackPublication, participant: Participant) => void;
+    activeSpeakersChanged: (speakers: Participant[]) => void;
+    roomMetadataChanged: (metadata: string) => void;
+    roomInfoUpdated: (info: RoomInfo) => void;
+    participantMetadataChanged: (metadata: string | undefined, participant: Participant) => void;
+    participantNameChanged: (name: string, participant: Participant) => void;
+    participantAttributesChanged: (changedAttributes: Record<string, string>, participant: Participant) => void;
+    participantEncryptionStatusChanged: (isEncrypted: boolean, participant: Participant) => void;
+    connectionQualityChanged: (quality: ConnectionQuality, participant: Participant) => void;
+    dataReceived: (payload: Uint8Array, participant?: RemoteParticipant, kind?: DataPacketKind, topic?: string, encryptionType?: EncryptionType) => void;
+    chatMessage: (message: ChatMessage, participant?: Participant) => void;
+    dtmfReceived: (code: number, digit: string, participant: RemoteParticipant) => void;
+    encryptionError: (error: Error) => void;
+    connectionStateChanged: (state: ConnectionState) => void;
+    connected: () => void;
+    disconnected: (reason: DisconnectReason) => void;
+    reconnecting: () => void;
+    reconnected: () => void;
+    roomSidChanged: (sid: string) => void;
+    roomUpdated: () => void;
+    moved: () => void;
+    tokenRefreshed: () => void;
+};
+export declare enum RoomEvent {
+    ParticipantConnected = "participantConnected",
+    ParticipantDisconnected = "participantDisconnected",
+    LocalTrackPublished = "localTrackPublished",
+    LocalTrackUnpublished = "localTrackUnpublished",
+    LocalTrackRepublished = "localTrackRepublished",
+    LocalTrackSubscribed = "localTrackSubscribed",
+    TrackPublished = "trackPublished",
+    TrackUnpublished = "trackUnpublished",
+    TrackSubscribed = "trackSubscribed",
+    TrackUnsubscribed = "trackUnsubscribed",
+    TrackSubscriptionFailed = "trackSubscriptionFailed",
+    TrackMuted = "trackMuted",
+    TrackUnmuted = "trackUnmuted",
+    ActiveSpeakersChanged = "activeSpeakersChanged",
+    RoomMetadataChanged = "roomMetadataChanged",
+    RoomSidChanged = "roomSidChanged",
+    ParticipantMetadataChanged = "participantMetadataChanged",
+    ParticipantNameChanged = "participantNameChanged",
+    ParticipantAttributesChanged = "participantAttributesChanged",
+    ParticipantEncryptionStatusChanged = "participantEncryptionStatusChanged",
+    ConnectionQualityChanged = "connectionQualityChanged",
+    DataReceived = "dataReceived",
+    ChatMessage = "chatMessage",
+    DtmfReceived = "dtmfReceived",
+    EncryptionError = "encryptionError",
+    ConnectionStateChanged = "connectionStateChanged",
+    Connected = "connected",
+    Disconnected = "disconnected",
+    Reconnecting = "reconnecting",
+    Reconnected = "reconnected",
+    RoomUpdated = "roomUpdated",
+    Moved = "moved",
+    TokenRefreshed = "tokenRefreshed"
+}
+//# sourceMappingURL=room.d.ts.map

package/dist/room.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"room.d.ts","sourceRoot":"","sources":["../src/room.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"room.d.ts","sourceRoot":"","sources":["../src/room.ts"],"names":[],"mappings":"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"}

package/dist/rpc.d.ts

@@ -1,7 +1,6 @@
-import { RpcError as RpcError$1 } from '@livekit/rtc-ffi-bindings';
-
+import type { RpcError as RpcError_Proto } from '@livekit/rtc-ffi-bindings';
 /** Parameters for initiating an RPC call */
-interface PerformRpcParams {
+export interface PerformRpcParams {
     /** The `identity` of the destination participant */
     destinationIdentity: string;
     /** The method name to call */
@@ -14,7 +13,7 @@ interface PerformRpcParams {
 /**
  * Data passed to method handler for incoming RPC invocations
  */
-interface RpcInvocationData {
+export interface RpcInvocationData {
     /**
      * The unique request ID. Will match at both sides of the call, useful for debugging or logging.
      */
@@ -40,7 +39,7 @@ interface RpcInvocationData {
  *
  * Built-in types are included but developers may use any string, with a max length of 256 bytes.
  */
-declare class RpcError extends Error {
+export declare class RpcError extends Error {
     code: typeof RpcError.ErrorCode | number;
     data?: string;
     /**
@@ -51,8 +50,8 @@ declare class RpcError extends Error {
      * Error codes 1001-1999 are reserved for built-in errors (see RpcError.ErrorCode for their meanings).
      */
     constructor(code: number, message: string, data?: string);
-    static fromProto(proto: RpcError$1): RpcError;
-    toProto(): RpcError$1;
+    static fromProto(proto: RpcError_Proto): RpcError;
+    toProto(): RpcError_Proto;
     static ErrorCode: {
         readonly APPLICATION_ERROR: 1500;
         readonly CONNECTION_TIMEOUT: 1501;
@@ -76,5 +75,4 @@ declare class RpcError extends Error {
      */
     static builtIn(key: keyof typeof RpcError.ErrorCode, data?: string): RpcError;
 }
-
-export { type PerformRpcParams, RpcError, type RpcInvocationData };
+//# sourceMappingURL=rpc.d.ts.map

package/dist/track.cjs

@@ -94,6 +94,22 @@ class Track {
       }
     }
   }
+  /**
+   * End every {@link AudioStream} attached to this track.
+   *
+   * @remarks
+   * The FFI keeps feeding an audio stream until the stream's own handle is
+   * dropped, so streams on a track that is no longer subscribed would otherwise
+   * go on delivering audio for the lifetime of the process.
+   *
+   * @internal
+   */
+  closeAudioStreams() {
+    for (const stream of [...this.iterateStreams()]) {
+      stream.teardown();
+    }
+    this.audioStreams.clear();
+  }
   *iterateStreams() {
     const dead = [];
     for (const ref of this.audioStreams) {

package/dist/track.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/track.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2024 LiveKit, Inc.\n//\n// SPDX-License-Identifier: Apache-2.0\nimport type {\n  CreateAudioTrackResponse,\n  CreateVideoTrackResponse,\n  OwnedTrack,\n  StreamState,\n  TrackInfo,\n  TrackKind,\n} from '@livekit/rtc-ffi-bindings';\nimport { CreateAudioTrackRequest, CreateVideoTrackRequest } from '@livekit/rtc-ffi-bindings';\nimport type { AudioSource } from './audio_source.js';\nimport type { AudioStreamSource } from './audio_stream.js';\nimport { FfiClient, FfiHandle } from './ffi_client.js';\nimport type { Room } from './room.js';\nimport type { VideoSource } from './video_source.js';\n\nexport abstract class Track {\n  /** @internal */\n  info?: TrackInfo;\n\n  /** @internal */\n  ffi_handle: FfiHandle;\n\n  private roomRef: WeakRef<Room> | null = null;\n  private audioStreams: Set<WeakRef<AudioStreamSource>> = new Set();\n  private streamFinalizationRegistry: FinalizationRegistry<WeakRef<AudioStreamSource>>;\n  private onRoomTokenRefreshed = () => {\n    const room = this.resolveRoom();\n    if (!room || !room.token || !room.serverUrl) {\n      return;\n    }\n    for (const stream of this.iterateStreams()) {\n      const processor = stream.processor;\n      if (!processor) {\n        continue;\n      }\n      processor.onCredentialsUpdated({ token: room.token, url: room.serverUrl });\n    }\n  };\n\n  constructor(owned: OwnedTrack) {\n    this.info = owned.info;\n    this.ffi_handle = new FfiHandle(owned.handle!.id!);\n    this.streamFinalizationRegistry = new FinalizationRegistry<WeakRef<AudioStreamSource>>(\n      (ref) => {\n        this.audioStreams.delete(ref);\n      },\n    );\n  }\n\n  /** @internal */\n  resolveRoom(): Room | null {\n    return this.roomRef?.deref() ?? null;\n  }\n\n  /** @internal */\n  setRoom(room: Room | null): void {\n    const oldRoom = this.resolveRoom();\n    if (!oldRoom && !room) {\n      // Already roomless — nothing to detach and nothing to re-clear. Without\n      // this guard a second setRoom(null) (e.g. the unpublishTrack /\n      // localTrackUnpublished race calling it from both paths) would re-fire\n      // onStreamInfoCleared / onCredentialsCleared on every registered processor.\n      return;\n    }\n    if (oldRoom && oldRoom !== room) {\n      oldRoom.off('tokenRefreshed', this.onRoomTokenRefreshed);\n    }\n    if (room) {\n      room.off('tokenRefreshed', this.onRoomTokenRefreshed);\n      room.on('tokenRefreshed', this.onRoomTokenRefreshed);\n    }\n    this.roomRef = room ? new WeakRef(room) : null;\n    for (const stream of this.iterateStreams()) {\n      this.pushProcessorMetadataToStream(stream, room);\n    }\n  }\n\n  /** @internal */\n  registerAudioStream(stream: AudioStreamSource): void {\n    const ref = new WeakRef(stream);\n    this.audioStreams.add(ref);\n    this.streamFinalizationRegistry.register(stream, ref);\n    const room = this.resolveRoom();\n    if (room) {\n      this.pushProcessorMetadataToStream(stream, room);\n    }\n  }\n\n  /** @internal */\n  unregisterAudioStream(stream: AudioStreamSource): void {\n    for (const ref of this.audioStreams) {\n      if (ref.deref() === stream) {\n        this.audioStreams.delete(ref);\n        return;\n      }\n    }\n  }\n\n  private *iterateStreams(): Generator<AudioStreamSource> {\n    const dead: Array<WeakRef<AudioStreamSource>> = [];\n    for (const ref of this.audioStreams) {\n      const stream = ref.deref();\n      if (stream) {\n        yield stream;\n      } else {\n        dead.push(ref);\n      }\n    }\n    for (const ref of dead) {\n      this.audioStreams.delete(ref);\n    }\n  }\n\n  private pushProcessorMetadataToStream(stream: AudioStreamSource, room: Room | null): void {\n    const processor = stream.processor;\n    if (!processor) {\n      return;\n    }\n\n    if (!room) {\n      // Guard with optional-call: plugins built against an older @livekit/rtc-node\n      // inherit a FrameProcessor base class that doesn't define these methods,\n      // so they could be undefined on the prototype chain.\n      processor.onStreamInfoCleared?.();\n      processor.onCredentialsCleared?.();\n      return;\n    }\n\n    let identity = '';\n    let publicationSid = '';\n    const trackSid = this.sid;\n    if (trackSid) {\n      let found = false;\n      for (const participant of room.remoteParticipants.values()) {\n        const publication = participant.trackPublications.get(trackSid);\n        if (publication) {\n          identity = participant.identity;\n          publicationSid = publication.sid ?? '';\n          found = true;\n          break;\n        }\n      }\n      if (!found) {\n        const local = room.localParticipant;\n        if (local) {\n          for (const publication of local.trackPublications.values()) {\n            if (publication.sid === trackSid) {\n              identity = local.identity;\n              publicationSid = publication.sid ?? '';\n              break;\n            }\n          }\n        }\n      }\n    }\n\n    processor.onStreamInfoUpdated({\n      roomName: room.name ?? '',\n      participantIdentity: identity,\n      publicationSid,\n    });\n    if (room.token && room.serverUrl) {\n      processor.onCredentialsUpdated({ token: room.token, url: room.serverUrl });\n    }\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 stream_state(): StreamState | undefined {\n    return this.info?.streamState;\n  }\n\n  get muted(): boolean | undefined {\n    return this.info?.muted;\n  }\n\n  async close() {\n    this.ffi_handle.dispose();\n  }\n}\n\nexport class LocalAudioTrack extends Track {\n  private source?: AudioSource;\n\n  constructor(owned: OwnedTrack, source?: AudioSource) {\n    super(owned);\n    this.source = source;\n  }\n\n  static createAudioTrack(name: string, source: AudioSource): LocalAudioTrack {\n    const req = new CreateAudioTrackRequest({\n      name: name,\n      sourceHandle: source.ffiHandle.handle,\n    });\n\n    const res = FfiClient.instance.request<CreateAudioTrackResponse>({\n      message: { case: 'createAudioTrack', value: req },\n    });\n\n    return new LocalAudioTrack(res.track!, source);\n  }\n\n  async close(closeSource = true) {\n    await super.close();\n    if (closeSource) {\n      await this.source?.close();\n    }\n  }\n}\n\nexport class LocalVideoTrack extends Track {\n  private source?: VideoSource;\n\n  constructor(owned: OwnedTrack, source?: VideoSource) {\n    super(owned);\n    this.source = source;\n  }\n\n  static createVideoTrack(name: string, source: VideoSource): LocalVideoTrack {\n    const req = new CreateVideoTrackRequest({\n      name: name,\n      sourceHandle: source.ffiHandle.handle,\n    });\n\n    const res = FfiClient.instance.request<CreateVideoTrackResponse>({\n      message: { case: 'createVideoTrack', value: req },\n    });\n\n    return new LocalVideoTrack(res.track!, source);\n  }\n\n  async close(closeSource = true) {\n    await super.close();\n    if (closeSource) {\n      await this.source?.close();\n    }\n  }\n}\n\nexport class RemoteVideoTrack extends Track {\n  constructor(owned: OwnedTrack) {\n    super(owned);\n  }\n}\n\nexport class RemoteAudioTrack extends Track {\n  constructor(owned: OwnedTrack) {\n    super(owned);\n  }\n}\n\nexport type LocalTrack = LocalVideoTrack | LocalAudioTrack;\nexport type RemoteTrack = RemoteVideoTrack | RemoteAudioTrack;\nexport type AudioTrack = LocalAudioTrack | RemoteAudioTrack;\nexport type VideoTrack = LocalVideoTrack | RemoteVideoTrack;\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/track.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2024 LiveKit, Inc.\n//\n// SPDX-License-Identifier: Apache-2.0\nimport type {\n  CreateAudioTrackResponse,\n  CreateVideoTrackResponse,\n  OwnedTrack,\n  StreamState,\n  TrackInfo,\n  TrackKind,\n} from '@livekit/rtc-ffi-bindings';\nimport { CreateAudioTrackRequest, CreateVideoTrackRequest } from '@livekit/rtc-ffi-bindings';\nimport type { AudioSource } from './audio_source.js';\nimport type { AudioStreamSource } from './audio_stream.js';\nimport { FfiClient, FfiHandle } from './ffi_client.js';\nimport type { Room } from './room.js';\nimport type { VideoSource } from './video_source.js';\n\nexport abstract class Track {\n  /** @internal */\n  info?: TrackInfo;\n\n  /** @internal */\n  ffi_handle: FfiHandle;\n\n  private roomRef: WeakRef<Room> | null = null;\n  private audioStreams: Set<WeakRef<AudioStreamSource>> = new Set();\n  private streamFinalizationRegistry: FinalizationRegistry<WeakRef<AudioStreamSource>>;\n  private onRoomTokenRefreshed = () => {\n    const room = this.resolveRoom();\n    if (!room || !room.token || !room.serverUrl) {\n      return;\n    }\n    for (const stream of this.iterateStreams()) {\n      const processor = stream.processor;\n      if (!processor) {\n        continue;\n      }\n      processor.onCredentialsUpdated({ token: room.token, url: room.serverUrl });\n    }\n  };\n\n  constructor(owned: OwnedTrack) {\n    this.info = owned.info;\n    this.ffi_handle = new FfiHandle(owned.handle!.id!);\n    this.streamFinalizationRegistry = new FinalizationRegistry<WeakRef<AudioStreamSource>>(\n      (ref) => {\n        this.audioStreams.delete(ref);\n      },\n    );\n  }\n\n  /** @internal */\n  resolveRoom(): Room | null {\n    return this.roomRef?.deref() ?? null;\n  }\n\n  /** @internal */\n  setRoom(room: Room | null): void {\n    const oldRoom = this.resolveRoom();\n    if (!oldRoom && !room) {\n      // Already roomless — nothing to detach and nothing to re-clear. Without\n      // this guard a second setRoom(null) (e.g. the unpublishTrack /\n      // localTrackUnpublished race calling it from both paths) would re-fire\n      // onStreamInfoCleared / onCredentialsCleared on every registered processor.\n      return;\n    }\n    if (oldRoom && oldRoom !== room) {\n      oldRoom.off('tokenRefreshed', this.onRoomTokenRefreshed);\n    }\n    if (room) {\n      room.off('tokenRefreshed', this.onRoomTokenRefreshed);\n      room.on('tokenRefreshed', this.onRoomTokenRefreshed);\n    }\n    this.roomRef = room ? new WeakRef(room) : null;\n    for (const stream of this.iterateStreams()) {\n      this.pushProcessorMetadataToStream(stream, room);\n    }\n  }\n\n  /** @internal */\n  registerAudioStream(stream: AudioStreamSource): void {\n    const ref = new WeakRef(stream);\n    this.audioStreams.add(ref);\n    this.streamFinalizationRegistry.register(stream, ref);\n    const room = this.resolveRoom();\n    if (room) {\n      this.pushProcessorMetadataToStream(stream, room);\n    }\n  }\n\n  /** @internal */\n  unregisterAudioStream(stream: AudioStreamSource): void {\n    for (const ref of this.audioStreams) {\n      if (ref.deref() === stream) {\n        this.audioStreams.delete(ref);\n        return;\n      }\n    }\n  }\n\n  /**\n   * End every {@link AudioStream} attached to this track.\n   *\n   * @remarks\n   * The FFI keeps feeding an audio stream until the stream's own handle is\n   * dropped, so streams on a track that is no longer subscribed would otherwise\n   * go on delivering audio for the lifetime of the process.\n   *\n   * @internal\n   */\n  closeAudioStreams(): void {\n    for (const stream of [...this.iterateStreams()]) {\n      stream.teardown();\n    }\n    this.audioStreams.clear();\n  }\n\n  private *iterateStreams(): Generator<AudioStreamSource> {\n    const dead: Array<WeakRef<AudioStreamSource>> = [];\n    for (const ref of this.audioStreams) {\n      const stream = ref.deref();\n      if (stream) {\n        yield stream;\n      } else {\n        dead.push(ref);\n      }\n    }\n    for (const ref of dead) {\n      this.audioStreams.delete(ref);\n    }\n  }\n\n  private pushProcessorMetadataToStream(stream: AudioStreamSource, room: Room | null): void {\n    const processor = stream.processor;\n    if (!processor) {\n      return;\n    }\n\n    if (!room) {\n      // Guard with optional-call: plugins built against an older @livekit/rtc-node\n      // inherit a FrameProcessor base class that doesn't define these methods,\n      // so they could be undefined on the prototype chain.\n      processor.onStreamInfoCleared?.();\n      processor.onCredentialsCleared?.();\n      return;\n    }\n\n    let identity = '';\n    let publicationSid = '';\n    const trackSid = this.sid;\n    if (trackSid) {\n      let found = false;\n      for (const participant of room.remoteParticipants.values()) {\n        const publication = participant.trackPublications.get(trackSid);\n        if (publication) {\n          identity = participant.identity;\n          publicationSid = publication.sid ?? '';\n          found = true;\n          break;\n        }\n      }\n      if (!found) {\n        const local = room.localParticipant;\n        if (local) {\n          for (const publication of local.trackPublications.values()) {\n            if (publication.sid === trackSid) {\n              identity = local.identity;\n              publicationSid = publication.sid ?? '';\n              break;\n            }\n          }\n        }\n      }\n    }\n\n    processor.onStreamInfoUpdated({\n      roomName: room.name ?? '',\n      participantIdentity: identity,\n      publicationSid,\n    });\n    if (room.token && room.serverUrl) {\n      processor.onCredentialsUpdated({ token: room.token, url: room.serverUrl });\n    }\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 stream_state(): StreamState | undefined {\n    return this.info?.streamState;\n  }\n\n  get muted(): boolean | undefined {\n    return this.info?.muted;\n  }\n\n  async close() {\n    this.ffi_handle.dispose();\n  }\n}\n\nexport class LocalAudioTrack extends Track {\n  private source?: AudioSource;\n\n  constructor(owned: OwnedTrack, source?: AudioSource) {\n    super(owned);\n    this.source = source;\n  }\n\n  static createAudioTrack(name: string, source: AudioSource): LocalAudioTrack {\n    const req = new CreateAudioTrackRequest({\n      name: name,\n      sourceHandle: source.ffiHandle.handle,\n    });\n\n    const res = FfiClient.instance.request<CreateAudioTrackResponse>({\n      message: { case: 'createAudioTrack', value: req },\n    });\n\n    return new LocalAudioTrack(res.track!, source);\n  }\n\n  async close(closeSource = true) {\n    await super.close();\n    if (closeSource) {\n      await this.source?.close();\n    }\n  }\n}\n\nexport class LocalVideoTrack extends Track {\n  private source?: VideoSource;\n\n  constructor(owned: OwnedTrack, source?: VideoSource) {\n    super(owned);\n    this.source = source;\n  }\n\n  static createVideoTrack(name: string, source: VideoSource): LocalVideoTrack {\n    const req = new CreateVideoTrackRequest({\n      name: name,\n      sourceHandle: source.ffiHandle.handle,\n    });\n\n    const res = FfiClient.instance.request<CreateVideoTrackResponse>({\n      message: { case: 'createVideoTrack', value: req },\n    });\n\n    return new LocalVideoTrack(res.track!, source);\n  }\n\n  async close(closeSource = true) {\n    await super.close();\n    if (closeSource) {\n      await this.source?.close();\n    }\n  }\n}\n\nexport class RemoteVideoTrack extends Track {\n  constructor(owned: OwnedTrack) {\n    super(owned);\n  }\n}\n\nexport class RemoteAudioTrack extends Track {\n  constructor(owned: OwnedTrack) {\n    super(owned);\n  }\n}\n\nexport type LocalTrack = LocalVideoTrack | LocalAudioTrack;\nexport type RemoteTrack = RemoteVideoTrack | RemoteAudioTrack;\nexport type AudioTrack = LocalAudioTrack | RemoteAudioTrack;\nexport type VideoTrack = LocalVideoTrack | RemoteVideoTrack;\n"],"mappings":"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","names":[]}

package/dist/track.d.cts

@@ -1,6 +1,6 @@
 import '@livekit/rtc-ffi-bindings';
 import './audio_source.cjs';
-export { a as AudioTrack, L as LocalAudioTrack, c as LocalTrack, e as LocalVideoTrack, R as RemoteAudioTrack, g as RemoteTrack, i as RemoteVideoTrack, T as Track, V as VideoTrack } from './audio_stream-B4hGVcKz.cjs';
+export { a as AudioTrack, L as LocalAudioTrack, c as LocalTrack, e as LocalVideoTrack, R as RemoteAudioTrack, g as RemoteTrack, i as RemoteVideoTrack, T as Track, V as VideoTrack } from './audio_stream-CnODFAmo.cjs';
 import './ffi_client.cjs';
 import './video_source.cjs';
 import './audio_frame.cjs';

package/dist/track.d.ts

@@ -1,18 +1,67 @@
-import '@livekit/rtc-ffi-bindings';
-import './audio_source.js';
-export { a as AudioTrack, L as LocalAudioTrack, c as LocalTrack, e as LocalVideoTrack, R as RemoteAudioTrack, g as RemoteTrack, i as RemoteVideoTrack, T as Track, V as VideoTrack } from './audio_stream-DEG1JKge.js';
-import './ffi_client.js';
-import './video_source.js';
-import './audio_frame.js';
-import 'node:stream/web';
-import './frame_processor.js';
-import './video_frame.js';
-import '@livekit/typed-emitter';
-import './types-_PdPVish.js';
-import './e2ee.js';
-import '@livekit/mutex';
-import 'node:fs';
-import './data_streams/stream_writer.js';
-import './rpc.js';
-import './transcription.js';
-import './types.js';
+import type { OwnedTrack, StreamState, TrackInfo, TrackKind } from '@livekit/rtc-ffi-bindings';
+import type { AudioSource } from './audio_source.js';
+import type { AudioStreamSource } from './audio_stream.js';
+import { FfiHandle } from './ffi_client.js';
+import type { Room } from './room.js';
+import type { VideoSource } from './video_source.js';
+export declare abstract class Track {
+    /** @internal */
+    info?: TrackInfo;
+    /** @internal */
+    ffi_handle: FfiHandle;
+    private roomRef;
+    private audioStreams;
+    private streamFinalizationRegistry;
+    private onRoomTokenRefreshed;
+    constructor(owned: OwnedTrack);
+    /** @internal */
+    resolveRoom(): Room | null;
+    /** @internal */
+    setRoom(room: Room | null): void;
+    /** @internal */
+    registerAudioStream(stream: AudioStreamSource): void;
+    /** @internal */
+    unregisterAudioStream(stream: AudioStreamSource): void;
+    /**
+     * End every {@link AudioStream} attached to this track.
+     *
+     * @remarks
+     * The FFI keeps feeding an audio stream until the stream's own handle is
+     * dropped, so streams on a track that is no longer subscribed would otherwise
+     * go on delivering audio for the lifetime of the process.
+     *
+     * @internal
+     */
+    closeAudioStreams(): void;
+    private iterateStreams;
+    private pushProcessorMetadataToStream;
+    get sid(): string | undefined;
+    get name(): string | undefined;
+    get kind(): TrackKind | undefined;
+    get stream_state(): StreamState | undefined;
+    get muted(): boolean | undefined;
+    close(): Promise<void>;
+}
+export declare class LocalAudioTrack extends Track {
+    private source?;
+    constructor(owned: OwnedTrack, source?: AudioSource);
+    static createAudioTrack(name: string, source: AudioSource): LocalAudioTrack;
+    close(closeSource?: boolean): Promise<void>;
+}
+export declare class LocalVideoTrack extends Track {
+    private source?;
+    constructor(owned: OwnedTrack, source?: VideoSource);
+    static createVideoTrack(name: string, source: VideoSource): LocalVideoTrack;
+    close(closeSource?: boolean): Promise<void>;
+}
+export declare class RemoteVideoTrack extends Track {
+    constructor(owned: OwnedTrack);
+}
+export declare class RemoteAudioTrack extends Track {
+    constructor(owned: OwnedTrack);
+}
+export type LocalTrack = LocalVideoTrack | LocalAudioTrack;
+export type RemoteTrack = RemoteVideoTrack | RemoteAudioTrack;
+export type AudioTrack = LocalAudioTrack | RemoteAudioTrack;
+export type VideoTrack = LocalVideoTrack | RemoteVideoTrack;
+//# sourceMappingURL=track.d.ts.map

package/dist/track.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"track.d.ts","sourceRoot":"","sources":["../src/track.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAGV,UAAU,EACV,WAAW,EACX,SAAS,EACT,SAAS,EACV,MAAM,2BAA2B,CAAC;AAEnC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAC3D,OAAO,EAAa,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD,8BAAsB,KAAK;IACzB,gBAAgB;IAChB,IAAI,CAAC,EAAE,SAAS,CAAC;IAEjB,gBAAgB;IAChB,UAAU,EAAE,SAAS,CAAC;IAEtB,OAAO,CAAC,OAAO,CAA8B;IAC7C,OAAO,CAAC,YAAY,CAA8C;IAClE,OAAO,CAAC,0BAA0B,CAAmD;IACrF,OAAO,CAAC,oBAAoB,CAY1B;gBAEU,KAAK,EAAE,UAAU;IAU7B,gBAAgB;IAChB,WAAW,IAAI,IAAI,GAAG,IAAI;IAI1B,gBAAgB;IAChB,OAAO,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI;IAsBhC,gBAAgB;IAChB,mBAAmB,CAAC,MAAM,EAAE,iBAAiB,GAAG,IAAI;IAUpD,gBAAgB;IAChB,qBAAqB,CAAC,MAAM,EAAE,iBAAiB,GAAG,IAAI;IAStD,OAAO,CAAE,cAAc;IAevB,OAAO,CAAC,6BAA6B;IAqDrC,IAAI,GAAG,IAAI,MAAM,GAAG,SAAS,CAE5B;IAED,IAAI,IAAI,IAAI,MAAM,GAAG,SAAS,CAE7B;IAED,IAAI,IAAI,IAAI,SAAS,GAAG,SAAS,CAEhC;IAED,IAAI,YAAY,IAAI,WAAW,GAAG,SAAS,CAE1C;IAED,IAAI,KAAK,IAAI,OAAO,GAAG,SAAS,CAE/B;IAEK,KAAK;CAGZ;AAED,qBAAa,eAAgB,SAAQ,KAAK;IACxC,OAAO,CAAC,MAAM,CAAC,CAAc;gBAEjB,KAAK,EAAE,UAAU,EAAE,MAAM,CAAC,EAAE,WAAW;IAKnD,MAAM,CAAC,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,eAAe;IAarE,KAAK,CAAC,WAAW,UAAO;CAM/B;AAED,qBAAa,eAAgB,SAAQ,KAAK;IACxC,OAAO,CAAC,MAAM,CAAC,CAAc;gBAEjB,KAAK,EAAE,UAAU,EAAE,MAAM,CAAC,EAAE,WAAW;IAKnD,MAAM,CAAC,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,eAAe;IAarE,KAAK,CAAC,WAAW,UAAO;CAM/B;AAED,qBAAa,gBAAiB,SAAQ,KAAK;gBAC7B,KAAK,EAAE,UAAU;CAG9B;AAED,qBAAa,gBAAiB,SAAQ,KAAK;gBAC7B,KAAK,EAAE,UAAU;CAG9B;AAED,MAAM,MAAM,UAAU,GAAG,eAAe,GAAG,eAAe,CAAC;AAC3D,MAAM,MAAM,WAAW,GAAG,gBAAgB,GAAG,gBAAgB,CAAC;AAC9D,MAAM,MAAM,UAAU,GAAG,eAAe,GAAG,gBAAgB,CAAC;AAC5D,MAAM,MAAM,UAAU,GAAG,eAAe,GAAG,gBAAgB,CAAC"}
+{"version":3,"file":"track.d.ts","sourceRoot":"","sources":["../src/track.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAGV,UAAU,EACV,WAAW,EACX,SAAS,EACT,SAAS,EACV,MAAM,2BAA2B,CAAC;AAEnC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAC3D,OAAO,EAAa,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD,8BAAsB,KAAK;IACzB,gBAAgB;IAChB,IAAI,CAAC,EAAE,SAAS,CAAC;IAEjB,gBAAgB;IAChB,UAAU,EAAE,SAAS,CAAC;IAEtB,OAAO,CAAC,OAAO,CAA8B;IAC7C,OAAO,CAAC,YAAY,CAA8C;IAClE,OAAO,CAAC,0BAA0B,CAAmD;IACrF,OAAO,CAAC,oBAAoB,CAY1B;gBAEU,KAAK,EAAE,UAAU;IAU7B,gBAAgB;IAChB,WAAW,IAAI,IAAI,GAAG,IAAI;IAI1B,gBAAgB;IAChB,OAAO,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI;IAsBhC,gBAAgB;IAChB,mBAAmB,CAAC,MAAM,EAAE,iBAAiB,GAAG,IAAI;IAUpD,gBAAgB;IAChB,qBAAqB,CAAC,MAAM,EAAE,iBAAiB,GAAG,IAAI;IAStD;;;;;;;;;OASG;IACH,iBAAiB,IAAI,IAAI;IAOzB,OAAO,CAAE,cAAc;IAevB,OAAO,CAAC,6BAA6B;IAqDrC,IAAI,GAAG,IAAI,MAAM,GAAG,SAAS,CAE5B;IAED,IAAI,IAAI,IAAI,MAAM,GAAG,SAAS,CAE7B;IAED,IAAI,IAAI,IAAI,SAAS,GAAG,SAAS,CAEhC;IAED,IAAI,YAAY,IAAI,WAAW,GAAG,SAAS,CAE1C;IAED,IAAI,KAAK,IAAI,OAAO,GAAG,SAAS,CAE/B;IAEK,KAAK;CAGZ;AAED,qBAAa,eAAgB,SAAQ,KAAK;IACxC,OAAO,CAAC,MAAM,CAAC,CAAc;gBAEjB,KAAK,EAAE,UAAU,EAAE,MAAM,CAAC,EAAE,WAAW;IAKnD,MAAM,CAAC,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,eAAe;IAarE,KAAK,CAAC,WAAW,UAAO;CAM/B;AAED,qBAAa,eAAgB,SAAQ,KAAK;IACxC,OAAO,CAAC,MAAM,CAAC,CAAc;gBAEjB,KAAK,EAAE,UAAU,EAAE,MAAM,CAAC,EAAE,WAAW;IAKnD,MAAM,CAAC,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,eAAe;IAarE,KAAK,CAAC,WAAW,UAAO;CAM/B;AAED,qBAAa,gBAAiB,SAAQ,KAAK;gBAC7B,KAAK,EAAE,UAAU;CAG9B;AAED,qBAAa,gBAAiB,SAAQ,KAAK;gBAC7B,KAAK,EAAE,UAAU;CAG9B;AAED,MAAM,MAAM,UAAU,GAAG,eAAe,GAAG,eAAe,CAAC;AAC3D,MAAM,MAAM,WAAW,GAAG,gBAAgB,GAAG,gBAAgB,CAAC;AAC9D,MAAM,MAAM,UAAU,GAAG,eAAe,GAAG,gBAAgB,CAAC;AAC5D,MAAM,MAAM,UAAU,GAAG,eAAe,GAAG,gBAAgB,CAAC"}

package/dist/track_publication.d.cts

@@ -1,5 +1,5 @@
 import '@livekit/rtc-ffi-bindings';
-export { d as LocalTrackPublication, h as RemoteTrackPublication, n as TrackPublication } from './audio_stream-B4hGVcKz.cjs';
+export { d as LocalTrackPublication, h as RemoteTrackPublication, n as TrackPublication } from './audio_stream-CnODFAmo.cjs';
 import 'node:stream/web';
 import './audio_frame.cjs';
 import './frame_processor.cjs';

package/dist/track_publication.d.ts

@@ -1,18 +1,45 @@
-import '@livekit/rtc-ffi-bindings';
-export { d as LocalTrackPublication, h as RemoteTrackPublication, n as TrackPublication } from './audio_stream-DEG1JKge.js';
-import 'node:stream/web';
-import './audio_frame.js';
-import './frame_processor.js';
-import './video_frame.js';
-import './audio_source.js';
-import './ffi_client.js';
-import '@livekit/typed-emitter';
-import './types-_PdPVish.js';
-import './e2ee.js';
-import '@livekit/mutex';
-import 'node:fs';
-import './data_streams/stream_writer.js';
-import './rpc.js';
-import './transcription.js';
-import './types.js';
-import './video_source.js';
+import type { EncryptionType } from '@livekit/rtc-ffi-bindings';
+import type { OwnedTrackPublication, TrackKind, TrackPublicationInfo, TrackSource } from '@livekit/rtc-ffi-bindings';
+import { FfiHandle } from '@livekit/rtc-ffi-bindings';
+import type { Track } from './track.js';
+export declare abstract class TrackPublication {
+    /** @internal */
+    ffiHandle: FfiHandle;
+    /** @internal */
+    info?: TrackPublicationInfo;
+    track?: Track;
+    constructor(ownedInfo: OwnedTrackPublication);
+    get sid(): string | undefined;
+    get name(): string | undefined;
+    get kind(): TrackKind | undefined;
+    get source(): TrackSource | undefined;
+    get simulcasted(): boolean | undefined;
+    get width(): number | undefined;
+    get height(): number | undefined;
+    get mimeType(): string | undefined;
+    get muted(): boolean | undefined;
+    get encryptionType(): EncryptionType | undefined;
+    /**
+     * 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;
+}
+export declare class LocalTrackPublication extends TrackPublication {
+    private firstSubscription;
+    private firstSubscriptionResolver;
+    constructor(ownedInfo: OwnedTrackPublication);
+    waitForSubscription(): Promise<void>;
+    /** @internal */
+    resolveFirstSubscription(): void;
+}
+export declare class RemoteTrackPublication extends TrackPublication {
+    subscribed: boolean;
+    constructor(ownedInfo: OwnedTrackPublication);
+    setSubscribed(subscribed: boolean): void;
+}
+//# sourceMappingURL=track_publication.d.ts.map

package/dist/transcription.d.ts

@@ -1,4 +1,4 @@
-interface TranscriptionSegment {
+export interface TranscriptionSegment {
     id: string;
     text: string;
     startTime: bigint;
@@ -6,10 +6,9 @@ interface TranscriptionSegment {
     language: string;
     final: boolean;
 }
-interface Transcription {
+export interface Transcription {
     participantIdentity: string;
     trackSid: string;
     segments: TranscriptionSegment[];
 }
-
-export type { Transcription, TranscriptionSegment };
+//# sourceMappingURL=transcription.d.ts.map

package/dist/types.d.ts

@@ -1,9 +1,8 @@
-interface ChatMessage {
+export interface ChatMessage {
     id: string;
     timestamp: number;
     message: string;
     editTimestamp?: number;
     generated?: boolean;
 }
-
-export type { ChatMessage };
+//# sourceMappingURL=types.d.ts.map

package/dist/utils.d.ts

@@ -1,7 +1,6 @@
 /** convert bigints to numbers preserving undefined values */
-declare function bigIntToNumber<T extends bigint | undefined>(value: T): T extends bigint ? number : undefined;
+export declare function bigIntToNumber<T extends bigint | undefined>(value: T): T extends bigint ? number : undefined;
 /** convert numbers to bigints preserving undefined values */
-declare function numberToBigInt<T extends number | undefined>(value: T): T extends number ? bigint : undefined;
-declare function splitUtf8(s: string, n: number): Uint8Array[];
-
-export { bigIntToNumber, numberToBigInt, splitUtf8 };
+export declare function numberToBigInt<T extends number | undefined>(value: T): T extends number ? bigint : undefined;
+export declare function splitUtf8(s: string, n: number): Uint8Array[];
+//# sourceMappingURL=utils.d.ts.map

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.31";
+const SDK_VERSION = "0.13.33";
 // 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.31\";\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAO,MAAM,cAAc;","names":[]}
+{"version":3,"sources":["../src/version.ts"],"sourcesContent":["export const SDK_VERSION = \"0.13.33\";\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAO,MAAM,cAAc;","names":[]}