livekit-client 2.18.0 → 2.18.1

package/dist/ts4.2/room/data-track/RemoteDataTrack.d.ts

@@ -6,11 +6,11 @@ import type { DataTrackInfo } from './types';
 type RemoteDataTrackOptions = {
     publisherIdentity: Participant['identity'];
 };
-export type RemoteDataTrackSubscribeOptions = {
+export type DataTrackSubscribeOptions = {
     signal?: AbortSignal;
     /** The number of {@link DataTrackFrame}s to hold in the ReadableStream before disgarding extra
-     * frames. Defaults to 4, but this may not be good enough for especially high frequency data. */
-    highWaterMark?: number;
+     * frames. Defaults to 16, but this may not be good enough for especially high frequency data. */
+    bufferSize?: number;
 };
 export default class RemoteDataTrack implements IRemoteTrack, IDataTrack {
     readonly trackSymbol: symbol;
@@ -40,7 +40,7 @@ export default class RemoteDataTrack implements IRemoteTrack, IDataTrack {
      * Note that newly created subscriptions only receive frames published after
      * the initial subscription is established.
      */
-    subscribe(options?: RemoteDataTrackSubscribeOptions): Promise<ReadableStream<DataTrackFrame>>;
+    subscribe(options?: DataTrackSubscribeOptions): ReadableStream<DataTrackFrame>;
 }
 export {};
 //# sourceMappingURL=RemoteDataTrack.d.ts.map

package/dist/ts4.2/room/data-track/depacketizer.d.ts

@@ -1,6 +1,6 @@
 import type { Throws } from '@livekit/throws-transformer/throws';
 import { LivekitReasonedError } from '../errors';
-import type { DataTrackFrame } from './frame';
+import type { DataTrackFrameInternal } from './frame';
 import { DataTrackPacket } from './packet';
 /** An error indicating a frame was dropped. */
 export declare class DataTrackDepacketizerDropError<Reason extends DataTrackDepacketizerDropReason = DataTrackDepacketizerDropReason> extends LivekitReasonedError<Reason> {
@@ -11,7 +11,7 @@ export declare class DataTrackDepacketizerDropError<Reason extends DataTrackDepa
     constructor(message: string, reason: Reason, frameNumber: number, options?: {
         cause?: unknown;
     });
-    static interrupted(frameNumber: number): DataTrackDepacketizerDropError<DataTrackDepacketizerDropReason.Interrupted>;
+    static interrupted(frameNumber: number, newFrameNumber: number): DataTrackDepacketizerDropError<DataTrackDepacketizerDropReason.Interrupted>;
     static unknownFrame(frameNumber: number): DataTrackDepacketizerDropError<DataTrackDepacketizerDropReason.UnknownFrame>;
     static bufferFull(frameNumber: number): DataTrackDepacketizerDropError<DataTrackDepacketizerDropReason.BufferFull>;
     static incomplete(frameNumber: number, receivedPackets: number, expectedPackets: number): DataTrackDepacketizerDropError<DataTrackDepacketizerDropReason.Incomplete>;
@@ -35,9 +35,9 @@ export default class DataTrackDepacketizer {
     /** Should be repeatedly called with received {@link DataTrackPacket}s - intermediate calls
      * aggregate the packet's state internally, and return null.
      *
-     * Once this method is called with the final packet to form a frame, a new {@link DataTrackFrame}
+     * Once this method is called with the final packet to form a frame, a new {@link DataTrackFrameInternal}
      * is returned.*/
-    push(packet: DataTrackPacket, options?: PushOptions): Throws<DataTrackFrame | null, DataTrackDepacketizerDropError>;
+    push(packet: DataTrackPacket, options?: PushOptions): Throws<DataTrackFrameInternal | null, DataTrackDepacketizerDropError>;
     reset(): void;
     private frameFromSingle;
     /** Begin assembling a new packet. */

package/dist/ts4.2/room/data-track/frame.d.ts

@@ -1,7 +1,21 @@
 import { DataTrackExtensions } from './packet/extensions';
 /** A pair of payload bytes and packet extensions which can be fed into a {@link DataTrackPacketizer}. */
 export type DataTrackFrame = {
+    payload: Uint8Array;
+    userTimestamp?: bigint;
+};
+/** An internal representation o data track frame which contains all SFU metadata. */
+export type DataTrackFrameInternal = {
     payload: Uint8Array;
     extensions: DataTrackExtensions;
 };
+export declare const DataTrackFrameInternal: {
+    from(frame: DataTrackFrame): {
+        payload: Uint8Array<ArrayBufferLike>;
+        extensions: DataTrackExtensions;
+    };
+    /** Converts from a DataTrackFrameInternal -> DataTrackFrame. Some internal information is
+     * discarded like e2ee encrption extension data. */
+    lossyIntoFrame(frame: DataTrackFrameInternal): DataTrackFrame;
+};
 //# sourceMappingURL=frame.d.ts.map

package/dist/ts4.2/room/data-track/incoming/IncomingDataTrackManager.d.ts

@@ -1,9 +1,9 @@
 import type { Throws } from '@livekit/throws-transformer/throws';
 import type TypedEmitter from 'typed-emitter';
+import type { BaseE2EEManager } from '../../../e2ee/E2eeManager';
 import type Participant from '../../participant/Participant';
 import type RemoteParticipant from '../../participant/RemoteParticipant';
 import { DataTrackDepacketizerDropError } from '../depacketizer';
-import type { DecryptionProvider } from '../e2ee';
 import type { DataTrackFrame } from '../frame';
 import { DataTrackHandle } from '../handle';
 import type { DataTrackInfo, DataTrackSid } from '../types';
@@ -14,20 +14,20 @@ export type DataTrackIncomingManagerCallbacks = {
     sfuUpdateSubscription: (event: EventSfuUpdateSubscription) => void;
     /** A track has been published by a remote participant and is available to be
      * subscribed to. */
-    trackAvailable: (event: EventTrackAvailable) => void;
+    trackPublished: (event: EventTrackAvailable) => void;
     /** A track has been unpublished by a remote participant and can no longer be subscribed to. */
-    trackUnavailable: (event: EventTrackUnavailable) => void;
+    trackUnpublished: (event: EventTrackUnavailable) => void;
 };
 type IncomingDataTrackManagerOptions = {
     /** Provider to use for decrypting incoming frame payloads.
      * If none, remote tracks using end-to-end encryption will not be available
      * for subscription.
      */
-    decryptionProvider: DecryptionProvider | null;
+    e2eeManager?: BaseE2EEManager;
 };
 declare const IncomingDataTrackManager_base: new () => TypedEmitter<DataTrackIncomingManagerCallbacks>;
 export default class IncomingDataTrackManager extends IncomingDataTrackManager_base {
-    private decryptionProvider;
+    private e2eeManager;
     /** Mapping between track SID and descriptor. */
     private descriptors;
     /** Mapping between subscriber handle and track SID.
@@ -38,6 +38,20 @@ export default class IncomingDataTrackManager extends IncomingDataTrackManager_b
      */
     private subscriptionHandles;
     constructor(options?: IncomingDataTrackManagerOptions);
+    /** @internal */
+    updateE2eeManager(e2eeManager: BaseE2EEManager | null): void;
+    /** Allocates a ReadableStream which emits when a new {@link DataTrackFrame} is received from the
+     * SFU. The SFU subscription is initiated lazily when the stream is created.
+     *
+     * @returns A tuple of the ReadableStream and a Promise that resolves once the SFU subscription
+     * is fully established / the stream is ready to receive frames.
+     *
+     * @internal
+     **/
+    openSubscriptionStream(sid: DataTrackSid, signal?: AbortSignal, bufferSize?: number): [
+        ReadableStream<DataTrackFrame>,
+        Promise<Throws<void, DataTrackSubscribeError>>
+    ];
     /** Client requested to subscribe to a data track.
      *
      * This is sent when the user calls {@link RemoteDataTrack.subscribe}.
@@ -46,10 +60,7 @@ export default class IncomingDataTrackManager extends IncomingDataTrackManager_b
      * requests simply attach an additional receiver to the broadcast channel, allowing them to consume
      * frames from the existing subscription pipeline.
      */
-    subscribeRequest(sid: DataTrackSid, signal?: AbortSignal, highWaterMark?: number): Promise<Throws<ReadableStream<DataTrackFrame>, DataTrackSubscribeError>>;
-    /** Allocates a ReadableStream which emits when a new {@link DataTrackFrame} is received from the
-     * SFU. */
-    private createReadableStream;
+    subscribeRequest(sid: DataTrackSid, signal?: AbortSignal): Promise<Throws<void, DataTrackSubscribeError>>;
     /**
      * Get information about all currently subscribed tracks.
      * @internal */
@@ -82,7 +93,7 @@ export default class IncomingDataTrackManager extends IncomingDataTrackManager_b
     mapping: Map<DataTrackHandle, DataTrackSid>): void;
     private registerSubscriberHandle;
     /** Packet has been received over the transport. */
-    packetReceived(bytes: Uint8Array): Throws<void, DataTrackDepacketizerDropError>;
+    packetReceived(bytes: Uint8Array): Promise<Throws<void, DataTrackDepacketizerDropError>>;
     /** Resend all subscription updates.
      *
      * This must be sent after a full reconnect to ensure the SFU knows which

package/dist/ts4.2/room/data-track/incoming/pipeline.d.ts

@@ -1,7 +1,7 @@
 import type { Throws } from '@livekit/throws-transformer/throws';
+import type { BaseE2EEManager } from '../../../e2ee/E2eeManager';
 import { DataTrackDepacketizerDropError } from '../depacketizer';
-import type { DecryptionProvider } from '../e2ee';
-import type { DataTrackFrame } from '../frame';
+import type { DataTrackFrameInternal } from '../frame';
 import { DataTrackPacket } from '../packet';
 import type { DataTrackInfo } from '../types';
 /**
@@ -10,20 +10,21 @@ import type { DataTrackInfo } from '../types';
 type Options = {
     info: DataTrackInfo;
     publisherIdentity: string;
-    decryptionProvider: DecryptionProvider | null;
+    e2eeManager: BaseE2EEManager | null;
 };
 /**
  * Pipeline for an individual data track subscription.
  */
 export default class IncomingDataTrackPipeline {
     private publisherIdentity;
-    private e2eeProvider;
+    private e2eeManager;
     private depacketizer;
     /**
      * Creates a new pipeline with the given options.
      */
     constructor(options: Options);
-    processPacket(packet: DataTrackPacket): Throws<DataTrackFrame | null, DataTrackDepacketizerDropError>;
+    updateE2eeManager(e2eeManager: BaseE2EEManager | null): void;
+    processPacket(packet: DataTrackPacket): Promise<Throws<DataTrackFrameInternal | null, DataTrackDepacketizerDropError>>;
     /**
      * Depacketize the given frame, log if a drop occurs.
      */

package/dist/ts4.2/room/data-track/outgoing/OutgoingDataTrackManager.d.ts

@@ -1,20 +1,22 @@
 import type { Throws } from '@livekit/throws-transformer/throws';
 import type TypedEmitter from 'typed-emitter';
+import type { BaseE2EEManager } from '../../../e2ee/E2eeManager';
 import { Future } from '../../utils';
-import LocalDataTrack from '../LocalDataTrack';
-import type { EncryptionProvider } from '../e2ee';
+import type { DataTrackFrameInternal } from '../frame';
 import { DataTrackHandle } from '../handle';
 import type { DataTrackInfo } from '../types';
-import { DataTrackPublishError, DataTrackPublishErrorReason, DataTrackPushFrameError, DataTrackPushFrameErrorReason } from './errors';
+import { DataTrackPublishError, DataTrackPushFrameError, DataTrackPushFrameErrorReason } from './errors';
 import DataTrackOutgoingPipeline from './pipeline';
-import type { DataTrackOptions, EventPacketsAvailable, EventSfuPublishRequest, EventSfuUnpublishRequest, SfuPublishResponseResult } from './types';
+import type { DataTrackOptions, EventPacketAvailable, EventSfuPublishRequest, EventSfuUnpublishRequest, EventTrackPublished, EventTrackUnpublished, SfuPublishResponseResult } from './types';
 export type PendingDescriptor = {
     type: 'pending';
-    completionFuture: Future<LocalDataTrack, DataTrackPublishError<DataTrackPublishErrorReason.NotAllowed> | DataTrackPublishError<DataTrackPublishErrorReason.DuplicateName> | DataTrackPublishError<DataTrackPublishErrorReason.Timeout> | DataTrackPublishError<DataTrackPublishErrorReason.LimitReached> | DataTrackPublishError<DataTrackPublishErrorReason.Disconnected> | DataTrackPublishError<DataTrackPublishErrorReason.Cancelled>>;
+    /** Resolves when the descriptor is fully published. */
+    completionFuture: Future<void, DataTrackPublishError>;
 };
 export type ActiveDescriptor = {
     type: 'active';
     info: DataTrackInfo;
+    publishState: 'published' | 'republishing' | 'unpublished';
     pipeline: DataTrackOutgoingPipeline;
     /** Resolves when the descriptor is unpublished. */
     unpublishingFuture: Future<void, never>;
@@ -22,55 +24,87 @@ export type ActiveDescriptor = {
 export type Descriptor = PendingDescriptor | ActiveDescriptor;
 export declare const Descriptor: {
     pending(): PendingDescriptor;
-    active(info: DataTrackInfo, encryptionProvider: EncryptionProvider | null): ActiveDescriptor;
+    active(info: DataTrackInfo, e2eeManager: BaseE2EEManager | null): ActiveDescriptor;
 };
 export type DataTrackOutgoingManagerCallbacks = {
     /** Request sent to the SFU to publish a track. */
     sfuPublishRequest: (event: EventSfuPublishRequest) => void;
     /** Request sent to the SFU to unpublish a track. */
     sfuUnpublishRequest: (event: EventSfuUnpublishRequest) => void;
-    /** Serialized packets are ready to be sent over the transport. */
-    packetsAvailable: (event: EventPacketsAvailable) => void;
+    /** A serialized packet is ready to be sent over the transport. */
+    packetAvailable: (event: EventPacketAvailable) => void;
+    /** A new {@link LocalDataTrack} has been published */
+    trackPublished: (event: EventTrackPublished) => void;
+    /** A {@link LocalDataTrack} has been unpublished */
+    trackUnpublished: (event: EventTrackUnpublished) => void;
 };
 type OutgoingDataTrackManagerOptions = {
     /**
      * Provider to use for encrypting outgoing frame payloads.
      *
-     * If none, end-to-end encryption will be disabled for all published tracks.
+     * If null, end-to-end encryption will be disabled for all published tracks.
      */
-    encryptionProvider?: EncryptionProvider;
+    e2eeManager?: BaseE2EEManager;
 };
 declare const OutgoingDataTrackManager_base: new () => TypedEmitter<DataTrackOutgoingManagerCallbacks>;
 export default class OutgoingDataTrackManager extends OutgoingDataTrackManager_base {
-    private encryptionProvider;
+    private e2eeManager;
     private handleAllocator;
     private descriptors;
     constructor(options?: OutgoingDataTrackManagerOptions);
     static withDescriptors(descriptors: Map<DataTrackHandle, Descriptor>): OutgoingDataTrackManager;
+    /** @internal */
+    updateE2eeManager(e2eeManager: BaseE2EEManager | null): void;
     /**
      * Used by attached {@link LocalDataTrack} instances to query their associated descriptor info.
      * @internal
      */
     getDescriptor(handle: DataTrackHandle): Descriptor | null;
-    createLocalDataTrack(handle: DataTrackHandle): LocalDataTrack | null;
     /** Used by attached {@link LocalDataTrack} instances to broadcast data track packets to other
      * subscribers.
      * @internal
      */
-    tryProcessAndSend(handle: DataTrackHandle, payload: Uint8Array): Throws<void, DataTrackPushFrameError<DataTrackPushFrameErrorReason.Dropped> | DataTrackPushFrameError<DataTrackPushFrameErrorReason.TrackUnpublished>>;
-    /** Client requested to publish a track. */
-    publishRequest(options: DataTrackOptions, signal?: AbortSignal): Promise<LocalDataTrack & {
-        readonly __throws?: DataTrackPublishError<DataTrackPublishErrorReason.NotAllowed> | DataTrackPublishError<DataTrackPublishErrorReason.DuplicateName> | DataTrackPublishError<DataTrackPublishErrorReason.Timeout> | DataTrackPublishError<DataTrackPublishErrorReason.LimitReached> | DataTrackPublishError<DataTrackPublishErrorReason.Disconnected> | DataTrackPublishError<DataTrackPublishErrorReason.Cancelled> | undefined;
-    }>;
-    /** Get information about all currently published tracks. */
-    queryPublished(): Promise<DataTrackInfo[]>;
-    /** Client request to unpublish a track. */
+    tryProcessAndSend(handle: DataTrackHandle, frame: DataTrackFrameInternal): Promise<Throws<void, DataTrackPushFrameError<DataTrackPushFrameErrorReason.Dropped> | DataTrackPushFrameError<DataTrackPushFrameErrorReason.TrackUnpublished>>>;
+    /**
+     * Client requested to publish a track.
+     *
+     * If the LiveKit server is too old and doesn't support data tracks, a
+     * {@link DataTrackPublishError#timeout} will be thrown.
+     *
+     * @internal
+     **/
+    publishRequest(options: DataTrackOptions, signal?: AbortSignal): Promise<Throws<DataTrackHandle, DataTrackPublishError>>;
+    /**
+     * Get information about all currently published tracks.
+     * @internal
+     **/
+    queryPublished(): DataTrackInfo[];
+    /**
+     * Client request to unpublish a track.
+     * @internal
+     **/
     unpublishRequest(handle: DataTrackHandle): Promise<void>;
-    /** SFU responded to a request to publish a data track. */
+    /**
+     * SFU responded to a request to publish a data track.
+     * @internal
+     **/
     receivedSfuPublishResponse(handle: DataTrackHandle, result: SfuPublishResponseResult): void;
-    /** SFU notification that a track has been unpublished. */
+    /**
+     * SFU notification that a track has been unpublished.
+     * @internal
+     **/
     receivedSfuUnpublishResponse(handle: DataTrackHandle): void;
-    /** Shuts down the manager and all associated tracks. */
+    /** Republish all tracks.
+     *
+     * This must be sent after a full reconnect in order for existing publications
+     * to be recognized by the SFU. Each republished track will be assigned a new SID.
+     * @internal
+     */
+    sfuWillRepublishTracks(): void;
+    /**
+     * Shuts down the manager and all associated tracks.
+     * @internal
+     **/
     shutdown(): Promise<void>;
 }
 export {};

package/dist/ts4.2/room/data-track/outgoing/errors.d.ts

@@ -15,19 +15,29 @@ export declare enum DataTrackPublishErrorReason {
     LimitReached = 3,
     /** Cannot publish data track when the room is disconnected. */
     Disconnected = 4,
-    Cancelled = 5
+    Cancelled = 5,
+    /** The name requested is not able to be used when creating the data track. */
+    InvalidName = 6,
+    /** There was an error publishing, but it was not something that could be sorted into a known
+     * category. */
+    Unknown = 7
 }
-export declare class DataTrackPublishError<Reason extends DataTrackPublishErrorReason> extends LivekitReasonedError<Reason> {
+export declare class DataTrackPublishError<Reason extends DataTrackPublishErrorReason = DataTrackPublishErrorReason> extends LivekitReasonedError<Reason> {
     readonly name = "DataTrackPublishError";
     reason: Reason;
     reasonName: string;
+    /** Underling message from the SFU, if one was provided */
+    rawMessage?: string;
     constructor(message: string, reason: Reason, options?: {
+        rawMessage?: string;
         cause?: unknown;
     });
-    static notAllowed(): DataTrackPublishError<DataTrackPublishErrorReason.NotAllowed>;
-    static duplicateName(): DataTrackPublishError<DataTrackPublishErrorReason.DuplicateName>;
+    static notAllowed(rawMessage?: string): DataTrackPublishError<DataTrackPublishErrorReason.NotAllowed>;
+    static duplicateName(rawMessage?: string): DataTrackPublishError<DataTrackPublishErrorReason.DuplicateName>;
+    static invalidName(rawMessage?: string): DataTrackPublishError<DataTrackPublishErrorReason.InvalidName>;
     static timeout(): DataTrackPublishError<DataTrackPublishErrorReason.Timeout>;
-    static limitReached(): DataTrackPublishError<DataTrackPublishErrorReason.LimitReached>;
+    static limitReached(rawMessage?: string): DataTrackPublishError<DataTrackPublishErrorReason.LimitReached>;
+    static unknown(reason: number, message: string): DataTrackPublishError<DataTrackPublishErrorReason.Unknown>;
     static disconnected(): DataTrackPublishError<DataTrackPublishErrorReason.Disconnected>;
     static cancelled(): DataTrackPublishError<DataTrackPublishErrorReason.Cancelled>;
 }
@@ -45,7 +55,7 @@ export declare class DataTrackPushFrameError<Reason extends DataTrackPushFrameEr
         cause?: unknown;
     });
     static trackUnpublished(): DataTrackPushFrameError<DataTrackPushFrameErrorReason.TrackUnpublished>;
-    static dropped(cause: unknown): DataTrackPushFrameError<DataTrackPushFrameErrorReason.Dropped>;
+    static dropped(cause?: unknown): DataTrackPushFrameError<DataTrackPushFrameErrorReason.Dropped>;
 }
 export declare enum DataTrackOutgoingPipelineErrorReason {
     Packetizer = 0,

package/dist/ts4.2/room/data-track/outgoing/pipeline.d.ts

@@ -1,22 +1,23 @@
 import type { Throws } from '@livekit/throws-transformer/throws';
-import type { EncryptionProvider } from '../e2ee';
-import type { DataTrackFrame } from '../frame';
+import type { BaseE2EEManager } from '../../../e2ee/E2eeManager';
+import type { DataTrackFrameInternal } from '../frame';
 import { DataTrackPacket } from '../packet';
 import type { DataTrackInfo } from '../types';
 import { DataTrackOutgoingPipelineError, DataTrackOutgoingPipelineErrorReason } from './errors';
 type Options = {
     info: DataTrackInfo;
-    encryptionProvider: EncryptionProvider | null;
+    e2eeManager: BaseE2EEManager | null;
 };
 /** Processes outgoing frames into final packets for distribution to the SFU. */
 export default class DataTrackOutgoingPipeline {
-    private encryptionProvider;
+    private e2eeManager;
     private packetizer;
     /** Maximum transmission unit (MTU) of the transport. */
     private static TRANSPORT_MTU_BYTES;
     constructor(options: Options);
-    processFrame(frame: DataTrackFrame): Throws<Generator<DataTrackPacket>, DataTrackOutgoingPipelineError>;
-    encryptIfNeeded(frame: DataTrackFrame): Throws<DataTrackFrame, DataTrackOutgoingPipelineError<DataTrackOutgoingPipelineErrorReason.Encryption>>;
+    updateE2eeManager(e2eeManager: BaseE2EEManager | null): void;
+    processFrame(frame: DataTrackFrameInternal): Throws<AsyncGenerator<DataTrackPacket>, DataTrackOutgoingPipelineError>;
+    encryptIfNeeded(frame: DataTrackFrameInternal): Promise<Throws<DataTrackFrameInternal, DataTrackOutgoingPipelineError<DataTrackOutgoingPipelineErrorReason.Encryption>>>;
 }
 export {};
 //# sourceMappingURL=pipeline.d.ts.map

package/dist/ts4.2/room/data-track/outgoing/types.d.ts

@@ -1,5 +1,6 @@
+import type LocalDataTrack from '../LocalDataTrack';
 import type { DataTrackHandle } from '../handle';
-import type { DataTrackInfo } from '../types';
+import type { DataTrackInfo, DataTrackSid } from '../types';
 import type { DataTrackPublishError, DataTrackPublishErrorReason } from './errors';
 /** Options for publishing a data track. */
 export type DataTrackOptions = {
@@ -11,7 +12,7 @@ export type SfuPublishResponseResult = {
     data: DataTrackInfo;
 } | {
     type: 'error';
-    error: DataTrackPublishError<DataTrackPublishErrorReason.NotAllowed> | DataTrackPublishError<DataTrackPublishErrorReason.DuplicateName> | DataTrackPublishError<DataTrackPublishErrorReason.LimitReached>;
+    error: DataTrackPublishError<DataTrackPublishErrorReason.NotAllowed> | DataTrackPublishError<DataTrackPublishErrorReason.DuplicateName> | DataTrackPublishError<DataTrackPublishErrorReason.InvalidName> | DataTrackPublishError<DataTrackPublishErrorReason.LimitReached>;
 };
 /** Request sent to the SFU to publish a track. */
 export type EventSfuPublishRequest = {
@@ -23,8 +24,17 @@ export type EventSfuPublishRequest = {
 export type EventSfuUnpublishRequest = {
     handle: DataTrackHandle;
 };
-/** Serialized packets are ready to be sent over the transport. */
-export type EventPacketsAvailable = {
+/** A serialized packet is ready to be sent over the transport. */
+export type EventPacketAvailable = {
     bytes: Uint8Array;
 };
+/** A track has been created by a local participant and is available to be
+ * subscribed to. */
+export type EventTrackPublished = {
+    track: LocalDataTrack;
+};
+/** A track has been unpublished by a remote participant and can no longer be subscribed to. */
+export type EventTrackUnpublished = {
+    sid: DataTrackSid;
+};
 //# sourceMappingURL=types.d.ts.map

package/dist/ts4.2/room/data-track/packetizer.d.ts

@@ -1,6 +1,6 @@
 import type { Throws } from '@livekit/throws-transformer/throws';
 import { LivekitReasonedError } from '../errors';
-import type { DataTrackFrame } from './frame';
+import type { DataTrackFrameInternal } from './frame';
 import { DataTrackHandle } from './handle';
 import { DataTrackPacket, FrameMarker } from './packet';
 import { DataTrackTimestamp } from './utils';
@@ -21,7 +21,7 @@ export declare class DataTrackPacketizerError<Reason extends DataTrackPacketizer
 export declare enum DataTrackPacketizerReason {
     MtuTooShort = 0
 }
-/** A packetizer takes a {@link DataTrackFrame} as input and generates a series
+/** A packetizer takes a {@link DataTrackFrameInternal} as input and generates a series
  * of {@link DataTrackPacket}s for transmission to other clients over webrtc. */
 export default class DataTrackPacketizer {
     private handle;
@@ -32,12 +32,12 @@ export default class DataTrackPacketizer {
     constructor(trackHandle: DataTrackHandle, mtuSizeBytes: number);
     /** @internal */
     static computeFrameMarker(index: number, packetCount: number): FrameMarker;
-    /** Generates a series of packets for the specified {@link DataTrackPacketizerFrame}.
+    /** Generates a series of packets for the specified {@link DataTrackFrameInternal}.
      *
      * NOTE: The return value of this function is a generator, so it can be lazily ran if desired,
      * or converted to an array with {@link Array.from}.
      */
-    packetize(frame: DataTrackFrame, options?: PacketizeOptions): Throws<Generator<DataTrackPacket>, DataTrackPacketizerError>;
+    packetize(frame: DataTrackFrameInternal, options?: PacketizeOptions): Throws<Generator<DataTrackPacket>, DataTrackPacketizerError>;
 }
 export {};
 //# sourceMappingURL=packetizer.d.ts.map

package/dist/ts4.2/room/data-track/track-interfaces.d.ts

@@ -17,7 +17,7 @@ export declare const DataTrackSymbol: symbol;
 /** An interface representing a data track, either local or remote. */
 export interface IDataTrack extends ITrack {
     readonly typeSymbol: typeof DataTrackSymbol;
-    readonly info: DataTrackInfo;
+    readonly info?: DataTrackInfo;
 }
 export declare function isDataTrack(subject: unknown): subject is IDataTrack;
 //# sourceMappingURL=track-interfaces.d.ts.map

package/dist/ts4.2/room/data-track/types.d.ts

@@ -1,10 +1,15 @@
+import { DataTrackInfo as ProtocolDataTrackInfo } from '@livekit/protocol';
 import type { DataTrackHandle } from './handle';
 export type DataTrackSid = string;
 /** Information about a published data track. */
 export type DataTrackInfo = {
     sid: DataTrackSid;
     pubHandle: DataTrackHandle;
-    name: String;
+    name: string;
     usesE2ee: boolean;
 };
+export declare const DataTrackInfo: {
+    from(protocolInfo: ProtocolDataTrackInfo): DataTrackInfo;
+    toProtobuf(info: DataTrackInfo): ProtocolDataTrackInfo;
+};
 //# sourceMappingURL=types.d.ts.map

package/dist/ts4.2/room/events.d.ts

@@ -291,7 +291,7 @@ export declare enum RoomEvent {
     EncryptionError = "encryptionError",
     /**
      * Emits whenever the current buffer status of a data channel changes
-     * args: (isLow: boolean, kind: [[DataPacket_Kind]])
+     * args: (isLow: boolean, kind: [[DataChannelKind]])
      */
     DCBufferStatusChanged = "dcBufferStatusChanged",
     /**
@@ -307,7 +307,23 @@ export declare enum RoomEvent {
     /**
      * fired when the client receives connection metrics from other participants
      */
-    MetricsReceived = "metricsReceived"
+    MetricsReceived = "metricsReceived",
+    /**
+     * Emits when a new data track has been published by a downstream participant.
+     */
+    DataTrackPublished = "dataTrackPublished",
+    /**
+     * Emits when a new data track has been unpublished by a downstream participant.
+     */
+    DataTrackUnpublished = "dataTrackUnpublished",
+    /**
+     * Emits when a new data track has been published locally.
+     */
+    LocalDataTrackPublished = "localDataTrackPublished",
+    /**
+     * Emits when a new data track has been unpublished locally.
+     */
+    LocalDataTrackUnpublished = "localDataTrackUnpublished"
 }
 export declare enum ParticipantEvent {
     /**
@@ -528,7 +544,12 @@ export declare enum EngineEvent {
     Offline = "offline",
     SignalRequestResponse = "signalRequestResponse",
     SignalConnected = "signalConnected",
-    RoomMoved = "roomMoved"
+    RoomMoved = "roomMoved",
+    PublishDataTrackResponse = "publishDataTrackResponse",
+    UnPublishDataTrackResponse = "unPublishDataTrackResponse",
+    DataTrackSubscriberHandles = "dataTrackSubscriberHandles",
+    DataTrackPacketReceived = "dataTrackPacketReceived",
+    Joined = "joined"
 }
 export declare enum TrackEvent {
     Message = "message",

package/dist/ts4.2/room/participant/LocalParticipant.d.ts

@@ -4,6 +4,9 @@ import TypedPromise from '../../utils/TypedPromise';
 import type RTCEngine from '../RTCEngine';
 import type OutgoingDataStreamManager from '../data-stream/outgoing/OutgoingDataStreamManager';
 import type { TextStreamWriter } from '../data-stream/outgoing/StreamWriter';
+import LocalDataTrack from '../data-track/LocalDataTrack';
+import type OutgoingDataTrackManager from '../data-track/outgoing/OutgoingDataTrackManager';
+import type { DataTrackOptions } from '../data-track/outgoing/types';
 import type { PerformRpcParams, RpcInvocationData } from '../rpc';
 import { RpcError } from '../rpc';
 import LocalTrack from '../track/LocalTrack';
@@ -38,12 +41,13 @@ export default class LocalParticipant extends Participant {
     private firstActiveAgent?;
     private rpcHandlers;
     private roomOutgoingDataStreamManager;
+    private roomOutgoingDataTrackManager;
     private pendingSignalRequests;
     private enabledPublishVideoCodecs;
     private pendingAcks;
     private pendingResponses;
     /** @internal */
-    constructor(sid: string, identity: string, engine: RTCEngine, options: InternalRoomOptions, roomRpcHandlers: Map<string, (data: RpcInvocationData) => Promise<string>>, roomOutgoingDataStreamManager: OutgoingDataStreamManager);
+    constructor(sid: string, identity: string, engine: RTCEngine, options: InternalRoomOptions, roomRpcHandlers: Map<string, (data: RpcInvocationData) => Promise<string>>, roomOutgoingDataStreamManager: OutgoingDataStreamManager, roomOutgoingDataTrackManager: OutgoingDataTrackManager);
     get lastCameraError(): Error | undefined;
     get lastMicrophoneError(): Error | undefined;
     get isE2EEEnabled(): boolean;
@@ -261,5 +265,11 @@ export default class LocalParticipant extends Participant {
     private handleTrackEnded;
     private getPublicationForTrack;
     private waitForPendingPublicationOfSource;
+    /** Publishes a data track.
+     *
+     * Returns the published data track if successful. Use {@link LocalDataTrack#tryPush}
+     * to send data frames on the track.
+     */
+    publishDataTrack(options: DataTrackOptions): Promise<LocalDataTrack>;
 }
 //# sourceMappingURL=LocalParticipant.d.ts.map

package/dist/ts4.2/room/participant/RemoteParticipant.d.ts

@@ -1,5 +1,7 @@
 import type { ParticipantInfo } from '@livekit/protocol';
 import type { SignalClient } from '../../api/SignalClient';
+import { DeferrableMap } from '../../utils/deferrable-map';
+import type RemoteDataTrack from '../data-track/RemoteDataTrack';
 import RemoteTrackPublication from '../track/RemoteTrackPublication';
 import { Track } from '../track/Track';
 import type { AudioOutputOptions } from '../track/options';
@@ -11,6 +13,13 @@ export default class RemoteParticipant extends Participant {
     audioTrackPublications: Map<string, RemoteTrackPublication>;
     videoTrackPublications: Map<string, RemoteTrackPublication>;
     trackPublications: Map<string, RemoteTrackPublication>;
+    /** A map of data track name to the corresponding {@link RemoteDataTrack}.
+     * @example
+     * // An already existing data track:
+     * const track = remoteParticipant.dataTracks.get("data track name");
+     * // Wait for a data track which will be published soon:
+     * const track = await remoteParticipant.dataTracks.getDeferred("data track name"); */
+    dataTracks: DeferrableMap<RemoteDataTrack['info']['name'], RemoteDataTrack>;
     signalClient: SignalClient;
     private volumeMap;
     private audioOutput?;
@@ -53,6 +62,10 @@ export default class RemoteParticipant extends Participant {
      */
     setAudioOutput(output: AudioOutputOptions): Promise<void>;
     /** @internal */
+    addRemoteDataTrack(remoteDataTrack: RemoteDataTrack): void;
+    /** @internal */
+    removeRemoteDataTrack(remoteDataTrackSid: RemoteDataTrack['info']['sid']): void;
+    /** @internal */
     emit<E extends keyof ParticipantEventCallbacks>(event: E, ...args: Parameters<ParticipantEventCallbacks[E]>): boolean;
 }
 //# sourceMappingURL=RemoteParticipant.d.ts.map

package/dist/ts4.2/room/utils.d.ts

@@ -145,4 +145,5 @@ export declare function isLocalParticipant(p: Participant): p is LocalParticipan
 export declare function isRemoteParticipant(p: Participant): p is RemoteParticipant;
 export declare function splitUtf8(s: string, n: number): Uint8Array[];
 export declare function extractMaxAgeFromRequestHeaders(headers: Headers): number | undefined;
+export declare function isCompressionStreamSupported(): boolean;
 //# sourceMappingURL=utils.d.ts.map