livekit-client 2.15.4 → 2.15.5

package/dist/src/room/types.d.ts.map

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

package/dist/ts4.2/src/e2ee/worker/FrameCryptor.d.ts

@@ -128,52 +128,6 @@ export declare class FrameCryptor extends BaseFrameCryptor {
      */
     private getVideoCodec;
 }
-/**
- * Slice the NALUs present in the supplied buffer, assuming it is already byte-aligned
- * code adapted from https://github.com/medooze/h264-frame-parser/blob/main/lib/NalUnits.ts to return indices only
- */
-export declare function findNALUIndices(stream: Uint8Array): number[];
-export declare function parseNALUType(startByte: number): NALUType;
-export declare enum NALUType {
-    /** Coded slice of a non-IDR picture */
-    SLICE_NON_IDR = 1,
-    /** Coded slice data partition A */
-    SLICE_PARTITION_A = 2,
-    /** Coded slice data partition B */
-    SLICE_PARTITION_B = 3,
-    /** Coded slice data partition C */
-    SLICE_PARTITION_C = 4,
-    /** Coded slice of an IDR picture */
-    SLICE_IDR = 5,
-    /** Supplemental enhancement information */
-    SEI = 6,
-    /** Sequence parameter set */
-    SPS = 7,
-    /** Picture parameter set */
-    PPS = 8,
-    /** Access unit delimiter */
-    AUD = 9,
-    /** End of sequence */
-    END_SEQ = 10,
-    /** End of stream */
-    END_STREAM = 11,
-    /** Filler data */
-    FILLER_DATA = 12,
-    /** Sequence parameter set extension */
-    SPS_EXT = 13,
-    /** Prefix NAL unit */
-    PREFIX_NALU = 14,
-    /** Subset sequence parameter set */
-    SUBSET_SPS = 15,
-    /** Depth parameter set */
-    DPS = 16,
-    /** Coded slice of an auxiliary coded picture without partitioning */
-    SLICE_AUX = 19,
-    /** Coded slice extension */
-    SLICE_EXT = 20,
-    /** Coded slice extension for a depth view component or a 3D-AVC texture view component */
-    SLICE_LAYER_EXT = 21
-}
 /**
  * we use a magic frame trailer to detect whether a frame is injected
  * by the livekit server and thus to be treated as unencrypted

package/dist/ts4.2/src/e2ee/worker/naluUtils.d.ts

@@ -0,0 +1,27 @@
+/**
+ * NALU (Network Abstraction Layer Unit) utilities for H.264 and H.265 video processing
+ * Contains functions for parsing and working with NALUs in video frames
+ */
+/**
+ * Detected codec type from NALU analysis
+ */
+export type DetectedCodec = 'h264' | 'h265' | 'unknown';
+/**
+ * Result of NALU processing for frame encryption
+ */
+export interface NALUProcessingResult {
+    /** Number of unencrypted bytes at the start of the frame */
+    unencryptedBytes: number;
+    /** Detected codec type */
+    detectedCodec: DetectedCodec;
+    /** Whether this frame requires NALU processing */
+    requiresNALUProcessing: boolean;
+}
+/**
+ * Process NALU data for frame encryption, detecting codec and finding unencrypted bytes
+ * @param data Frame data
+ * @param knownCodec Known codec from other sources (optional)
+ * @returns NALU processing result
+ */
+export declare function processNALUsForEncryption(data: Uint8Array, knownCodec?: 'h264' | 'h265'): NALUProcessingResult;
+//# sourceMappingURL=naluUtils.d.ts.map

package/dist/ts4.2/src/index.d.ts

@@ -40,8 +40,8 @@ export { facingModeFromDeviceLabel, facingModeFromLocalTrack } from './room/trac
 export * from './room/track/options';
 export * from './room/track/processor/types';
 export * from './room/track/types';
-export type * from './room/StreamReader';
-export type * from './room/StreamWriter';
+export type * from './room/data-stream/incoming/StreamReader';
+export type * from './room/data-stream/outgoing/StreamWriter';
 export type { DataPublishOptions, SimulationScenario, TranscriptionSegment, ChatMessage, SendTextOptions, } from './room/types';
 export * from './version';
 export { 

package/dist/ts4.2/src/room/Room.d.ts

@@ -3,7 +3,7 @@ import type TypedEmitter from 'typed-emitter';
 import 'webrtc-adapter';
 import type { InternalRoomOptions, RoomConnectOptions, RoomOptions } from '../options';
 import RTCEngine from './RTCEngine';
-import type { ByteStreamHandler, TextStreamHandler } from './StreamReader';
+import type { ByteStreamHandler, TextStreamHandler } from './data-stream/incoming/StreamReader';
 import LocalParticipant from './participant/LocalParticipant';
 import type Participant from './participant/Participant';
 import type { ConnectionQuality } from './participant/Participant';
@@ -74,10 +74,8 @@ declare class Room extends Room_base {
      * map to store first point in time when a particular transcription segment was received
      */
     private transcriptionReceivedTimes;
-    private byteStreamControllers;
-    private textStreamControllers;
-    private byteStreamHandlers;
-    private textStreamHandlers;
+    private incomingDataStreamManager;
+    private outgoingDataStreamManager;
     private rpcHandlers;
     /**
      * Creates a new Room, the primary construct for a LiveKit session.
@@ -121,7 +119,6 @@ declare class Room extends Room_base {
      * @param method - The name of the RPC method to unregister
      */
     unregisterRpcMethod(method: string): void;
-    private handleIncomingRpcRequest;
     /**
      * @experimental
      */
@@ -226,15 +223,14 @@ declare class Room extends Room_base {
     private handleSubscriptionPermissionUpdate;
     private handleSubscriptionError;
     private handleDataPacket;
-    private handleStreamHeader;
-    private handleStreamChunk;
-    private handleStreamTrailer;
     private handleUserPacket;
     private handleSipDtmf;
-    bufferedSegments: Map<string, TranscriptionSegmentModel>;
     private handleTranscription;
     private handleChatMessage;
     private handleMetrics;
+    private handleDataStream;
+    private handleIncomingRpcRequest;
+    bufferedSegments: Map<string, TranscriptionSegmentModel>;
     private handleAudioPlaybackStarted;
     private handleAudioPlaybackFailed;
     private handleVideoPlaybackStarted;

package/dist/ts4.2/src/room/data-stream/incoming/IncomingDataStreamManager.d.ts

@@ -0,0 +1,20 @@
+import type { DataPacket } from '@livekit/protocol';
+import type { ByteStreamHandler, TextStreamHandler } from './StreamReader';
+export default class IncomingDataStreamManager {
+    private log;
+    private byteStreamControllers;
+    private textStreamControllers;
+    private byteStreamHandlers;
+    private textStreamHandlers;
+    registerTextStreamHandler(topic: string, callback: TextStreamHandler): void;
+    unregisterTextStreamHandler(topic: string): void;
+    registerByteStreamHandler(topic: string, callback: ByteStreamHandler): void;
+    unregisterByteStreamHandler(topic: string): void;
+    clearHandlersAndControllers(): void;
+    validateParticipantHasNoActiveDataStreams(participantIdentity: string): void;
+    handleDataStreamPacket(packet: DataPacket): Promise<void>;
+    private handleStreamHeader;
+    private handleStreamChunk;
+    private handleStreamTrailer;
+}
+//# sourceMappingURL=IncomingDataStreamManager.d.ts.map

package/dist/ts4.2/src/room/{StreamReader.d.ts → data-stream/incoming/StreamReader.d.ts}

@@ -1,35 +1,53 @@
 import type { DataStream_Chunk } from '@livekit/protocol';
-import type { BaseStreamInfo, ByteStreamInfo, TextStreamInfo } from './types';
+import type { BaseStreamInfo, ByteStreamInfo, TextStreamInfo } from '../../types';
+import { Future } from '../../utils';
+export type BaseStreamReaderReadAllOpts = {
+    /** An AbortSignal can be used to terminate reads early. */
+    signal?: AbortSignal;
+};
 declare abstract class BaseStreamReader<T extends BaseStreamInfo> {
     protected reader: ReadableStream<DataStream_Chunk>;
     protected totalByteSize?: number;
     protected _info: T;
     protected bytesReceived: number;
+    protected outOfBandFailureRejectingFuture?: Future<never>;
     get info(): T;
-    constructor(info: T, stream: ReadableStream<DataStream_Chunk>, totalByteSize?: number);
+    /** @internal */
+    protected validateBytesReceived(doneReceiving?: boolean): void;
+    constructor(info: T, stream: ReadableStream<DataStream_Chunk>, totalByteSize?: number, outOfBandFailureRejectingFuture?: Future<never>);
     protected abstract handleChunkReceived(chunk: DataStream_Chunk): void;
     onProgress?: (progress: number | undefined) => void;
-    abstract readAll(): Promise<string | Array<Uint8Array>>;
+    abstract readAll(opts?: BaseStreamReaderReadAllOpts): Promise<string | Array<Uint8Array>>;
 }
 export declare class ByteStreamReader extends BaseStreamReader<ByteStreamInfo> {
     protected handleChunkReceived(chunk: DataStream_Chunk): void;
     onProgress?: (progress: number | undefined) => void;
+    signal?: AbortSignal;
     [Symbol.asyncIterator](): {
         next: () => Promise<IteratorResult<Uint8Array>>;
         return(): Promise<IteratorResult<Uint8Array>>;
     };
-    readAll(): Promise<Array<Uint8Array>>;
+    /**
+     * Injects an AbortSignal, which if aborted, will terminate the currently active
+     * stream iteration operation.
+     *
+     * Note that when using AbortSignal.timeout(...), the timeout applies across
+     * the whole iteration operation, not just one individual chunk read.
+     */
+    withAbortSignal(signal: AbortSignal): this;
+    readAll(opts?: BaseStreamReaderReadAllOpts): Promise<Array<Uint8Array>>;
 }
 /**
  * A class to read chunks from a ReadableStream and provide them in a structured format.
  */
 export declare class TextStreamReader extends BaseStreamReader<TextStreamInfo> {
     private receivedChunks;
+    signal?: AbortSignal;
     /**
      * A TextStreamReader instance can be used as an AsyncIterator that returns the entire string
      * that has been received up to the current point in time.
      */
-    constructor(info: TextStreamInfo, stream: ReadableStream<DataStream_Chunk>, totalChunkCount?: number);
+    constructor(info: TextStreamInfo, stream: ReadableStream<DataStream_Chunk>, totalChunkCount?: number, outOfBandFailureRejectingFuture?: Future<never>);
     protected handleChunkReceived(chunk: DataStream_Chunk): void;
     /**
      * @param progress - progress of the stream between 0 and 1. Undefined for streams of unknown size
@@ -44,7 +62,15 @@ export declare class TextStreamReader extends BaseStreamReader<TextStreamInfo> {
         next: () => Promise<IteratorResult<string>>;
         return(): Promise<IteratorResult<string>>;
     };
-    readAll(): Promise<string>;
+    /**
+     * Injects an AbortSignal, which if aborted, will terminate the currently active
+     * stream iteration operation.
+     *
+     * Note that when using AbortSignal.timeout(...), the timeout applies across
+     * the whole iteration operation, not just one individual chunk read.
+     */
+    withAbortSignal(signal: AbortSignal): this;
+    readAll(opts?: BaseStreamReaderReadAllOpts): Promise<string>;
 }
 export type ByteStreamHandler = (reader: ByteStreamReader, participantInfo: {
     identity: string;

package/dist/ts4.2/src/room/data-stream/outgoing/OutgoingDataStreamManager.d.ts

@@ -0,0 +1,27 @@
+import type { StructuredLogger } from '../../../logger';
+import type RTCEngine from '../../RTCEngine';
+import type { SendFileOptions, SendTextOptions, StreamBytesOptions, StreamTextOptions, TextStreamInfo } from '../../types';
+import { ByteStreamWriter, TextStreamWriter } from './StreamWriter';
+/**
+ * Manages sending custom user data via data channels.
+ * @internal
+ */
+export default class OutgoingDataStreamManager {
+    protected engine: RTCEngine;
+    protected log: StructuredLogger;
+    constructor(engine: RTCEngine, log: StructuredLogger);
+    setupEngine(engine: RTCEngine): void;
+    /** {@inheritDoc LocalParticipant.sendText} */
+    sendText(text: string, options?: SendTextOptions): Promise<TextStreamInfo>;
+    /**
+     * @internal
+     * @experimental CAUTION, might get removed in a minor release
+     */
+    streamText(options?: StreamTextOptions): Promise<TextStreamWriter>;
+    sendFile(file: File, options?: SendFileOptions): Promise<{
+        id: string;
+    }>;
+    private _sendFile;
+    streamBytes(options?: StreamBytesOptions): Promise<ByteStreamWriter>;
+}
+//# sourceMappingURL=OutgoingDataStreamManager.d.ts.map

package/dist/ts4.2/src/room/{StreamWriter.d.ts → data-stream/outgoing/StreamWriter.d.ts}

@@ -1,4 +1,4 @@
-import type { BaseStreamInfo, ByteStreamInfo, TextStreamInfo } from './types';
+import type { BaseStreamInfo, ByteStreamInfo, TextStreamInfo } from '../../types';
 declare class BaseStreamWriter<T, InfoType extends BaseStreamInfo> {
     protected writableStream: WritableStream<T>;
     protected defaultWriter: WritableStreamDefaultWriter<T>;

package/dist/ts4.2/src/room/errors.d.ts

@@ -46,6 +46,19 @@ export declare class SignalRequestError extends LivekitError {
     reasonName: string;
     constructor(message: string, reason: RequestErrorReason);
 }
+export declare enum DataStreamErrorReason {
+    AlreadyOpened = 0,
+    AbnormalEnd = 1,
+    DecodeFailed = 2,
+    LengthExceeded = 3,
+    Incomplete = 4,
+    HandlerAlreadyRegistered = 7
+}
+export declare class DataStreamError extends LivekitError {
+    reason: DataStreamErrorReason;
+    reasonName: string;
+    constructor(message: string, reason: DataStreamErrorReason);
+}
 export declare enum MediaDeviceFailure {
     PermissionDenied = "PermissionDenied",
     NotFound = "NotFound",

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

@@ -1,13 +1,14 @@
 import { Codec, ParticipantInfo, ParticipantPermission } from '@livekit/protocol';
 import type { InternalRoomOptions } from '../../options';
 import type RTCEngine from '../RTCEngine';
-import { ByteStreamWriter, TextStreamWriter } from '../StreamWriter';
+import type OutgoingDataStreamManager from '../data-stream/outgoing/OutgoingDataStreamManager';
+import type { TextStreamWriter } from '../data-stream/outgoing/StreamWriter';
 import type { PerformRpcParams, RpcInvocationData } from '../rpc';
 import LocalTrack from '../track/LocalTrack';
 import LocalTrackPublication from '../track/LocalTrackPublication';
 import { Track } from '../track/Track';
 import type { AudioCaptureOptions, BackupVideoCodec, CreateLocalTracksOptions, ScreenShareCaptureOptions, TrackPublishOptions, VideoCaptureOptions } from '../track/options';
-import type { ChatMessage, DataPublishOptions, SendTextOptions, StreamTextOptions, TextStreamInfo } from '../types';
+import type { ChatMessage, DataPublishOptions, SendFileOptions, SendTextOptions, StreamBytesOptions, StreamTextOptions, TextStreamInfo } from '../types';
 import Participant from './Participant';
 import type { ParticipantTrackPermission } from './ParticipantTrackPermission';
 import type RemoteParticipant from './RemoteParticipant';
@@ -34,12 +35,13 @@ export default class LocalParticipant extends Participant {
     private activeAgentFuture?;
     private firstActiveAgent?;
     private rpcHandlers;
+    private roomOutgoingDataStreamManager;
     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>>);
+    constructor(sid: string, identity: string, engine: RTCEngine, options: InternalRoomOptions, roomRpcHandlers: Map<string, (data: RpcInvocationData) => Promise<string>>, roomOutgoingDataStreamManager: OutgoingDataStreamManager);
     get lastCameraError(): Error | undefined;
     get lastMicrophoneError(): Error | undefined;
     get isE2EEEnabled(): boolean;
@@ -156,7 +158,9 @@ export default class LocalParticipant extends Participant {
      * @param digit DTMF digit
      */
     publishDtmf(code: number, digit: string): Promise<void>;
+    /** @deprecated Consider migrating to {@link sendText} */
     sendChatMessage(text: string, options?: SendTextOptions): Promise<ChatMessage>;
+    /** @deprecated Consider migrating to {@link sendText} */
     editChatMessage(editText: string, originalMessage: ChatMessage): Promise<{
         readonly message: string;
         readonly editTimestamp: number;
@@ -164,30 +168,39 @@ export default class LocalParticipant extends Participant {
         readonly timestamp: number;
         readonly attachedFiles?: Array<File>;
     }>;
+    /**
+     * Sends the given string to participants in the room via the data channel.
+     * For longer messages, consider using {@link streamText} instead.
+     *
+     * @param text The text payload
+     * @param options.topic Topic identifier used to route the stream to appropriate handlers.
+     */
     sendText(text: string, options?: SendTextOptions): Promise<TextStreamInfo>;
     /**
+     * Creates a new TextStreamWriter which can be used to stream text incrementally
+     * to participants in the room via the data channel.
+     *
+     * @param options.topic Topic identifier used to route the stream to appropriate handlers.
+     *
      * @internal
      * @experimental CAUTION, might get removed in a minor release
      */
     streamText(options?: StreamTextOptions): Promise<TextStreamWriter>;
-    sendFile(file: File, options?: {
-        mimeType?: string;
-        topic?: string;
-        destinationIdentities?: Array<string>;
-        onProgress?: (progress: number) => void;
-    }): Promise<{
+    /** Send a File to all participants in the room via the data channel.
+     * @param file The File object payload
+     * @param options.topic Topic identifier used to route the stream to appropriate handlers.
+     * @param options.onProgress A callback function used to monitor the upload progress percentage.
+     */
+    sendFile(file: File, options?: SendFileOptions): Promise<{
         id: string;
     }>;
-    private _sendFile;
-    streamBytes(options?: {
-        name?: string;
-        topic?: string;
-        attributes?: Record<string, string>;
-        destinationIdentities?: Array<string>;
-        streamId?: string;
-        mimeType?: string;
-        totalSize?: number;
-    }): Promise<ByteStreamWriter>;
+    /**
+     * Stream bytes incrementally to participants in the room via the data channel.
+     * For sending files, consider using {@link sendFile} instead.
+     *
+     * @param options.topic Topic identifier used to route the stream to appropriate handlers.
+     */
+    streamBytes(options?: StreamBytesOptions): Promise<import("../data-stream/outgoing/StreamWriter").ByteStreamWriter>;
     /**
      * Initiate an RPC call to a remote participant
      * @param params - Parameters for initiating the RPC call, see {@link PerformRpcParams}

package/dist/ts4.2/src/room/track/LocalTrack.d.ts

@@ -23,11 +23,10 @@ export default abstract class LocalTrack<TrackKind extends Track.Kind = Track.Ki
     protected pauseUpstreamLock: Mutex;
     protected processorElement?: HTMLMediaElement;
     protected processor?: TrackProcessor<TrackKind, any>;
-    protected processorLock: Mutex;
     protected audioContext?: AudioContext;
     protected manuallyStopped: boolean;
     protected localTrackRecorder: LocalTrackRecorder<typeof this> | undefined;
-    private restartLock;
+    protected trackChangeLock: Mutex;
     /**
      *
      * @param mediaTrack
@@ -104,6 +103,12 @@ export default abstract class LocalTrack<TrackKind extends Track.Kind = Track.Ki
      * @returns
      */
     stopProcessor(keepElement?: boolean): Promise<void>;
+    /**
+     * @internal
+     * This method assumes the caller has acquired a trackChangeLock already.
+     * The public facing method for stopping the processor is `stopProcessor` and it wraps this method in the trackChangeLock.
+     */
+    protected internalStopProcessor(keepElement?: boolean): Promise<void>;
     /** @internal */
     startPreConnectBuffer(timeslice?: number): void;
     /** @internal */

package/dist/ts4.2/src/room/types.d.ts

@@ -1,4 +1,5 @@
-import type { DataStream_Chunk } from '@livekit/protocol';
+import type { DataStream_Chunk, Encryption_Type } from '@livekit/protocol';
+import type { Future } from './utils';
 export type SimulationOptions = {
     publish?: {
         audio?: boolean;
@@ -30,6 +31,19 @@ export interface StreamTextOptions {
     totalSize?: number;
     attributes?: Record<string, string>;
 }
+export type StreamBytesOptions = {
+    name?: string;
+    topic?: string;
+    attributes?: Record<string, string>;
+    destinationIdentities?: Array<string>;
+    streamId?: string;
+    mimeType?: string;
+    totalSize?: number;
+};
+export type SendFileOptions = Pick<StreamBytesOptions, 'topic' | 'mimeType' | 'destinationIdentities'> & {
+    onProgress?: (progress: number) => void;
+    encryptionType?: Encryption_Type.NONE;
+};
 export type DataPublishOptions = {
     /**
      * whether to send this as reliable or lossy.
@@ -76,6 +90,8 @@ export interface StreamController<T extends DataStream_Chunk> {
     controller: ReadableStreamDefaultController<T>;
     startTime: number;
     endTime?: number;
+    sendingParticipantIdentity: string;
+    outOfBandFailureRejectingFuture: Future<never>;
 }
 export interface BaseStreamInfo {
     id: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "livekit-client",
-  "version": "2.15.4",
+  "version": "2.15.5",
   "description": "JavaScript/TypeScript client SDK for LiveKit",
   "main": "./dist/livekit-client.umd.js",
   "unpkg": "./dist/livekit-client.umd.js",