@livekit/rtc-node 0.10.2 → 0.10.4

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -3,7 +3,7 @@
   "description": "LiveKit RTC Node",
   "license": "Apache-2.0",
   "author": "LiveKit",
-  "version": "0.10.2",
+  "version": "0.10.4",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "type": "module",
@@ -43,11 +43,11 @@
     "prettier": "^3.0.3"
   },
   "optionalDependencies": {
-    "@livekit/rtc-node-darwin-arm64": "0.10.2",
-    "@livekit/rtc-node-darwin-x64": "0.10.2",
-    "@livekit/rtc-node-linux-x64-gnu": "0.10.2",
-    "@livekit/rtc-node-win32-x64-msvc": "0.10.2",
-    "@livekit/rtc-node-linux-arm64-gnu": "0.10.2"
+    "@livekit/rtc-node-darwin-arm64": "0.10.4",
+    "@livekit/rtc-node-linux-arm64-gnu": "0.10.4",
+    "@livekit/rtc-node-darwin-x64": "0.10.4",
+    "@livekit/rtc-node-linux-x64-gnu": "0.10.4",
+    "@livekit/rtc-node-win32-x64-msvc": "0.10.4"
   },
   "engines": {
     "node": ">= 18"

package/src/index.ts

@@ -43,3 +43,4 @@ export { StreamState, TrackKind, TrackSource } from './proto/track_pb.js';
 export { VideoBufferType, VideoRotation, VideoCodec } from './proto/video_frame_pb.js';
 export { ParticipantKind } from './proto/participant_pb.js';
 export { dispose } from './ffi_client.js';
+export type { ChatMessage } from './types.js';

package/src/napi/native.d.ts

@@ -3,11 +3,14 @@
 
 /* auto-generated by NAPI-RS */
 
-export function livekitInitialize(callback: (data: Uint8Array) => void, captureLogs: boolean): void;
-export function livekitFfiRequest(data: Uint8Array): Uint8Array;
-export function livekitRetrievePtr(handle: Uint8Array): bigint;
-export function livekitCopyBuffer(ptr: bigint, len: number): Uint8Array;
-export function livekitDispose(): Promise<void>;
+export declare function livekitInitialize(
+  callback: (data: Uint8Array) => void,
+  captureLogs: boolean,
+): void;
+export declare function livekitFfiRequest(data: Uint8Array): Uint8Array;
+export declare function livekitRetrievePtr(handle: Uint8Array): bigint;
+export declare function livekitCopyBuffer(ptr: bigint, len: number): Uint8Array;
+export declare function livekitDispose(): Promise<void>;
 export declare class FfiHandle {
   constructor(handle: bigint);
   dispose(): void;

package/src/participant.ts

@@ -3,7 +3,8 @@
 // SPDX-License-Identifier: Apache-2.0
 import { FfiClient, FfiHandle } from './ffi_client.js';
 import type { OwnedParticipant, ParticipantInfo, ParticipantKind } from './proto/participant_pb.js';
-import type {
+import {
+  ChatMessage as ChatMessageModel,
   PublishDataCallback,
   PublishDataResponse,
   PublishSipDtmfCallback,
@@ -12,6 +13,8 @@ import type {
   PublishTrackResponse,
   PublishTranscriptionCallback,
   PublishTranscriptionResponse,
+  SendChatMessageCallback,
+  SendChatMessageResponse,
   SetLocalAttributesCallback,
   SetLocalAttributesResponse,
   SetLocalMetadataCallback,
@@ -23,11 +26,13 @@ import type {
   UnpublishTrackResponse,
 } from './proto/room_pb.js';
 import {
+  EditChatMessageRequest,
   TranscriptionSegment as ProtoTranscriptionSegment,
   PublishDataRequest,
   PublishSipDtmfRequest,
   PublishTrackRequest,
   PublishTranscriptionRequest,
+  SendChatMessageRequest,
   SetLocalAttributesRequest,
   SetLocalMetadataRequest,
   SetLocalNameRequest,
@@ -37,6 +42,7 @@ import type { LocalTrack } from './track.js';
 import type { RemoteTrackPublication, TrackPublication } from './track_publication.js';
 import { LocalTrackPublication } from './track_publication.js';
 import type { Transcription } from './transcription.js';
+import { ChatMessage } from './types.js';
 
 export abstract class Participant {
   /** @internal */
@@ -185,6 +191,79 @@ export class LocalParticipant extends Participant {
     });
   }
 
+  /**
+   * Sends a chat message to participants in the room
+   *
+   * @param text - The text content of the chat message.
+   * @param destinationIdentities - An optional array of recipient identities to whom the message will be sent. If omitted, the message is broadcast to all participants.
+   * @param senderIdentity - An optional identity of the sender. If omitted, the default sender identity is used.
+   *
+   */
+  async sendChatMessage(
+    text: string,
+    destinationIdentities?: Array<string>,
+    senderIdentity?: string,
+  ): Promise<ChatMessage> {
+    const req = new SendChatMessageRequest({
+      localParticipantHandle: this.ffi_handle.handle,
+      message: text,
+      destinationIdentities,
+      senderIdentity,
+    });
+
+    const res = FfiClient.instance.request<SendChatMessageResponse>({
+      message: { case: 'sendChatMessage', value: req },
+    });
+
+    const cb = await FfiClient.instance.waitFor<SendChatMessageCallback>((ev) => {
+      return ev.message.case == 'chatMessage' && ev.message.value.asyncId == res.asyncId;
+    });
+
+    if (cb.error) {
+      throw new Error(cb.error);
+    }
+    const { id, timestamp, editTimestamp, message } = cb.chatMessage!;
+    return { id, timestamp: Number(timestamp), editTimestamp: Number(editTimestamp), message };
+  }
+
+  /**
+   * @experimental
+   */
+  async editChatMessage(
+    editText: string,
+    originalMessage: ChatMessage,
+    destinationIdentities?: Array<string>,
+    senderIdentity?: string,
+  ): Promise<ChatMessage> {
+    const req = new EditChatMessageRequest({
+      localParticipantHandle: this.ffi_handle.handle,
+      editText,
+      originalMessage: new ChatMessageModel({
+        ...originalMessage,
+        timestamp: BigInt(originalMessage.timestamp),
+        editTimestamp: originalMessage.editTimestamp
+          ? BigInt(originalMessage.editTimestamp)
+          : undefined,
+      }),
+      destinationIdentities,
+      senderIdentity,
+    });
+
+    const res = FfiClient.instance.request<SendChatMessageResponse>({
+      message: { case: 'editChatMessage', value: req },
+    });
+
+    const cb = await FfiClient.instance.waitFor<SendChatMessageCallback>((ev) => {
+      return ev.message.case == 'chatMessage' && ev.message.value.asyncId == res.asyncId;
+    });
+
+    if (cb.error) {
+      throw new Error(cb.error);
+    }
+    const { id, timestamp, editTimestamp, message } = cb.chatMessage!;
+    return { id, timestamp: Number(timestamp), editTimestamp: Number(editTimestamp), message };
+  }
+
   async updateName(name: string) {
     const req = new SetLocalNameRequest({
       localParticipantHandle: this.ffi_handle.handle,
@@ -237,7 +316,7 @@ export class LocalParticipant extends Participant {
       throw new Error(cb.error);
     }
 
-    const track_publication = new LocalTrackPublication(cb.publication);
+    const track_publication = new LocalTrackPublication(cb.publication!);
     track_publication.track = track;
     this.trackPublications.set(track_publication.sid, track_publication);
 
@@ -263,7 +342,9 @@ export class LocalParticipant extends Participant {
     }
 
     const pub = this.trackPublications.get(trackSid);
-    pub.track = undefined;
+    if (pub) {
+      pub.track = undefined;
+    }
     this.trackPublications.delete(trackSid);
   }
 }

package/src/proto/ffi_pb.ts

@@ -19,7 +19,7 @@
 
 import type { BinaryReadOptions, FieldList, JsonReadOptions, JsonValue, PartialMessage, PlainMessage } from "@bufbuild/protobuf";
 import { Message, proto3, protoInt64 } from "@bufbuild/protobuf";
-import { ConnectCallback, ConnectRequest, ConnectResponse, DisconnectCallback, DisconnectRequest, DisconnectResponse, GetSessionStatsCallback, GetSessionStatsRequest, GetSessionStatsResponse, PublishDataCallback, PublishDataRequest, PublishDataResponse, PublishSipDtmfCallback, PublishSipDtmfRequest, PublishSipDtmfResponse, PublishTrackCallback, PublishTrackRequest, PublishTrackResponse, PublishTranscriptionCallback, PublishTranscriptionRequest, PublishTranscriptionResponse, RoomEvent, SetLocalAttributesCallback, SetLocalAttributesRequest, SetLocalAttributesResponse, SetLocalMetadataCallback, SetLocalMetadataRequest, SetLocalMetadataResponse, SetLocalNameCallback, SetLocalNameRequest, SetLocalNameResponse, SetSubscribedRequest, SetSubscribedResponse, UnpublishTrackCallback, UnpublishTrackRequest, UnpublishTrackResponse } from "./room_pb.js";
+import { ConnectCallback, ConnectRequest, ConnectResponse, DisconnectCallback, DisconnectRequest, DisconnectResponse, EditChatMessageRequest, GetSessionStatsCallback, GetSessionStatsRequest, GetSessionStatsResponse, PublishDataCallback, PublishDataRequest, PublishDataResponse, PublishSipDtmfCallback, PublishSipDtmfRequest, PublishSipDtmfResponse, PublishTrackCallback, PublishTrackRequest, PublishTrackResponse, PublishTranscriptionCallback, PublishTranscriptionRequest, PublishTranscriptionResponse, RoomEvent, SendChatMessageCallback, SendChatMessageRequest, SendChatMessageResponse, SetLocalAttributesCallback, SetLocalAttributesRequest, SetLocalAttributesResponse, SetLocalMetadataCallback, SetLocalMetadataRequest, SetLocalMetadataResponse, SetLocalNameCallback, SetLocalNameRequest, SetLocalNameResponse, SetSubscribedRequest, SetSubscribedResponse, UnpublishTrackCallback, UnpublishTrackRequest, UnpublishTrackResponse } from "./room_pb.js";
 import { CreateAudioTrackRequest, CreateAudioTrackResponse, CreateVideoTrackRequest, CreateVideoTrackResponse, EnableRemoteTrackRequest, EnableRemoteTrackResponse, GetStatsCallback, GetStatsRequest, GetStatsResponse, LocalTrackMuteRequest, LocalTrackMuteResponse, TrackEvent } from "./track_pb.js";
 import { CaptureVideoFrameRequest, CaptureVideoFrameResponse, NewVideoSourceRequest, NewVideoSourceResponse, NewVideoStreamRequest, NewVideoStreamResponse, VideoConvertRequest, VideoConvertResponse, VideoStreamEvent, VideoStreamFromParticipantRequest, VideoStreamFromParticipantResponse } from "./video_frame_pb.js";
 import { AudioStreamEvent, AudioStreamFromParticipantRequest, AudioStreamFromParticipantResponse, CaptureAudioFrameCallback, CaptureAudioFrameRequest, CaptureAudioFrameResponse, ClearAudioBufferRequest, ClearAudioBufferResponse, FlushSoxResamplerRequest, FlushSoxResamplerResponse, NewAudioResamplerRequest, NewAudioResamplerResponse, NewAudioSourceRequest, NewAudioSourceResponse, NewAudioStreamRequest, NewAudioStreamResponse, NewSoxResamplerRequest, NewSoxResamplerResponse, PushSoxResamplerRequest, PushSoxResamplerResponse, RemixAndResampleRequest, RemixAndResampleResponse } from "./audio_frame_pb.js";
@@ -285,6 +285,18 @@ export class FfiRequest extends Message<FfiRequest> {
      */
     value: FlushSoxResamplerRequest;
     case: "flushSoxResampler";
+  } | {
+    /**
+     * @generated from field: livekit.proto.SendChatMessageRequest send_chat_message = 36;
+     */
+    value: SendChatMessageRequest;
+    case: "sendChatMessage";
+  } | {
+    /**
+     * @generated from field: livekit.proto.EditChatMessageRequest edit_chat_message = 37;
+     */
+    value: EditChatMessageRequest;
+    case: "editChatMessage";
   } | { case: undefined; value?: undefined } = { case: undefined };
 
   constructor(data?: PartialMessage<FfiRequest>) {
@@ -329,6 +341,8 @@ export class FfiRequest extends Message<FfiRequest> {
     { no: 33, name: "new_sox_resampler", kind: "message", T: NewSoxResamplerRequest, oneof: "message" },
     { no: 34, name: "push_sox_resampler", kind: "message", T: PushSoxResamplerRequest, oneof: "message" },
     { no: 35, name: "flush_sox_resampler", kind: "message", T: FlushSoxResamplerRequest, oneof: "message" },
+    { no: 36, name: "send_chat_message", kind: "message", T: SendChatMessageRequest, oneof: "message" },
+    { no: 37, name: "edit_chat_message", kind: "message", T: EditChatMessageRequest, oneof: "message" },
   ]);
 
   static fromBinary(bytes: Uint8Array, options?: Partial<BinaryReadOptions>): FfiRequest {
@@ -569,6 +583,12 @@ export class FfiResponse extends Message<FfiResponse> {
      */
     value: FlushSoxResamplerResponse;
     case: "flushSoxResampler";
+  } | {
+    /**
+     * @generated from field: livekit.proto.SendChatMessageResponse send_chat_message = 36;
+     */
+    value: SendChatMessageResponse;
+    case: "sendChatMessage";
   } | { case: undefined; value?: undefined } = { case: undefined };
 
   constructor(data?: PartialMessage<FfiResponse>) {
@@ -613,6 +633,7 @@ export class FfiResponse extends Message<FfiResponse> {
     { no: 33, name: "new_sox_resampler", kind: "message", T: NewSoxResamplerResponse, oneof: "message" },
     { no: 34, name: "push_sox_resampler", kind: "message", T: PushSoxResamplerResponse, oneof: "message" },
     { no: 35, name: "flush_sox_resampler", kind: "message", T: FlushSoxResamplerResponse, oneof: "message" },
+    { no: 36, name: "send_chat_message", kind: "message", T: SendChatMessageResponse, oneof: "message" },
   ]);
 
   static fromBinary(bytes: Uint8Array, options?: Partial<BinaryReadOptions>): FfiResponse {
@@ -763,6 +784,12 @@ export class FfiEvent extends Message<FfiEvent> {
      */
     value: PublishSipDtmfCallback;
     case: "publishSipDtmf";
+  } | {
+    /**
+     * @generated from field: livekit.proto.SendChatMessageCallback chat_message = 22;
+     */
+    value: SendChatMessageCallback;
+    case: "chatMessage";
   } | { case: undefined; value?: undefined } = { case: undefined };
 
   constructor(data?: PartialMessage<FfiEvent>) {
@@ -793,6 +820,7 @@ export class FfiEvent extends Message<FfiEvent> {
     { no: 19, name: "get_session_stats", kind: "message", T: GetSessionStatsCallback, oneof: "message" },
     { no: 20, name: "panic", kind: "message", T: Panic, oneof: "message" },
     { no: 21, name: "publish_sip_dtmf", kind: "message", T: PublishSipDtmfCallback, oneof: "message" },
+    { no: 22, name: "chat_message", kind: "message", T: SendChatMessageCallback, oneof: "message" },
   ]);
 
   static fromBinary(bytes: Uint8Array, options?: Partial<BinaryReadOptions>): FfiEvent {

package/src/proto/room_pb.ts

@@ -1375,6 +1375,208 @@ export class SetLocalMetadataCallback extends Message<SetLocalMetadataCallback>
   }
 }
 
+/**
+ * @generated from message livekit.proto.SendChatMessageRequest
+ */
+export class SendChatMessageRequest extends Message<SendChatMessageRequest> {
+  /**
+   * @generated from field: uint64 local_participant_handle = 1;
+   */
+  localParticipantHandle = protoInt64.zero;
+
+  /**
+   * @generated from field: string message = 2;
+   */
+  message = "";
+
+  /**
+   * @generated from field: repeated string destination_identities = 3;
+   */
+  destinationIdentities: string[] = [];
+
+  /**
+   * @generated from field: optional string sender_identity = 4;
+   */
+  senderIdentity?: string;
+
+  constructor(data?: PartialMessage<SendChatMessageRequest>) {
+    super();
+    proto3.util.initPartial(data, this);
+  }
+
+  static readonly runtime: typeof proto3 = proto3;
+  static readonly typeName = "livekit.proto.SendChatMessageRequest";
+  static readonly fields: FieldList = proto3.util.newFieldList(() => [
+    { no: 1, name: "local_participant_handle", kind: "scalar", T: 4 /* ScalarType.UINT64 */ },
+    { no: 2, name: "message", kind: "scalar", T: 9 /* ScalarType.STRING */ },
+    { no: 3, name: "destination_identities", kind: "scalar", T: 9 /* ScalarType.STRING */, repeated: true },
+    { no: 4, name: "sender_identity", kind: "scalar", T: 9 /* ScalarType.STRING */, opt: true },
+  ]);
+
+  static fromBinary(bytes: Uint8Array, options?: Partial<BinaryReadOptions>): SendChatMessageRequest {
+    return new SendChatMessageRequest().fromBinary(bytes, options);
+  }
+
+  static fromJson(jsonValue: JsonValue, options?: Partial<JsonReadOptions>): SendChatMessageRequest {
+    return new SendChatMessageRequest().fromJson(jsonValue, options);
+  }
+
+  static fromJsonString(jsonString: string, options?: Partial<JsonReadOptions>): SendChatMessageRequest {
+    return new SendChatMessageRequest().fromJsonString(jsonString, options);
+  }
+
+  static equals(a: SendChatMessageRequest | PlainMessage<SendChatMessageRequest> | undefined, b: SendChatMessageRequest | PlainMessage<SendChatMessageRequest> | undefined): boolean {
+    return proto3.util.equals(SendChatMessageRequest, a, b);
+  }
+}
+
+/**
+ * @generated from message livekit.proto.EditChatMessageRequest
+ */
+export class EditChatMessageRequest extends Message<EditChatMessageRequest> {
+  /**
+   * @generated from field: uint64 local_participant_handle = 1;
+   */
+  localParticipantHandle = protoInt64.zero;
+
+  /**
+   * @generated from field: string edit_text = 2;
+   */
+  editText = "";
+
+  /**
+   * @generated from field: livekit.proto.ChatMessage original_message = 3;
+   */
+  originalMessage?: ChatMessage;
+
+  /**
+   * @generated from field: repeated string destination_identities = 4;
+   */
+  destinationIdentities: string[] = [];
+
+  /**
+   * @generated from field: optional string sender_identity = 5;
+   */
+  senderIdentity?: string;
+
+  constructor(data?: PartialMessage<EditChatMessageRequest>) {
+    super();
+    proto3.util.initPartial(data, this);
+  }
+
+  static readonly runtime: typeof proto3 = proto3;
+  static readonly typeName = "livekit.proto.EditChatMessageRequest";
+  static readonly fields: FieldList = proto3.util.newFieldList(() => [
+    { no: 1, name: "local_participant_handle", kind: "scalar", T: 4 /* ScalarType.UINT64 */ },
+    { no: 2, name: "edit_text", kind: "scalar", T: 9 /* ScalarType.STRING */ },
+    { no: 3, name: "original_message", kind: "message", T: ChatMessage },
+    { no: 4, name: "destination_identities", kind: "scalar", T: 9 /* ScalarType.STRING */, repeated: true },
+    { no: 5, name: "sender_identity", kind: "scalar", T: 9 /* ScalarType.STRING */, opt: true },
+  ]);
+
+  static fromBinary(bytes: Uint8Array, options?: Partial<BinaryReadOptions>): EditChatMessageRequest {
+    return new EditChatMessageRequest().fromBinary(bytes, options);
+  }
+
+  static fromJson(jsonValue: JsonValue, options?: Partial<JsonReadOptions>): EditChatMessageRequest {
+    return new EditChatMessageRequest().fromJson(jsonValue, options);
+  }
+
+  static fromJsonString(jsonString: string, options?: Partial<JsonReadOptions>): EditChatMessageRequest {
+    return new EditChatMessageRequest().fromJsonString(jsonString, options);
+  }
+
+  static equals(a: EditChatMessageRequest | PlainMessage<EditChatMessageRequest> | undefined, b: EditChatMessageRequest | PlainMessage<EditChatMessageRequest> | undefined): boolean {
+    return proto3.util.equals(EditChatMessageRequest, a, b);
+  }
+}
+
+/**
+ * @generated from message livekit.proto.SendChatMessageResponse
+ */
+export class SendChatMessageResponse extends Message<SendChatMessageResponse> {
+  /**
+   * @generated from field: uint64 async_id = 1;
+   */
+  asyncId = protoInt64.zero;
+
+  constructor(data?: PartialMessage<SendChatMessageResponse>) {
+    super();
+    proto3.util.initPartial(data, this);
+  }
+
+  static readonly runtime: typeof proto3 = proto3;
+  static readonly typeName = "livekit.proto.SendChatMessageResponse";
+  static readonly fields: FieldList = proto3.util.newFieldList(() => [
+    { no: 1, name: "async_id", kind: "scalar", T: 4 /* ScalarType.UINT64 */ },
+  ]);
+
+  static fromBinary(bytes: Uint8Array, options?: Partial<BinaryReadOptions>): SendChatMessageResponse {
+    return new SendChatMessageResponse().fromBinary(bytes, options);
+  }
+
+  static fromJson(jsonValue: JsonValue, options?: Partial<JsonReadOptions>): SendChatMessageResponse {
+    return new SendChatMessageResponse().fromJson(jsonValue, options);
+  }
+
+  static fromJsonString(jsonString: string, options?: Partial<JsonReadOptions>): SendChatMessageResponse {
+    return new SendChatMessageResponse().fromJsonString(jsonString, options);
+  }
+
+  static equals(a: SendChatMessageResponse | PlainMessage<SendChatMessageResponse> | undefined, b: SendChatMessageResponse | PlainMessage<SendChatMessageResponse> | undefined): boolean {
+    return proto3.util.equals(SendChatMessageResponse, a, b);
+  }
+}
+
+/**
+ * @generated from message livekit.proto.SendChatMessageCallback
+ */
+export class SendChatMessageCallback extends Message<SendChatMessageCallback> {
+  /**
+   * @generated from field: uint64 async_id = 1;
+   */
+  asyncId = protoInt64.zero;
+
+  /**
+   * @generated from field: optional string error = 2;
+   */
+  error?: string;
+
+  /**
+   * @generated from field: optional livekit.proto.ChatMessage chat_message = 3;
+   */
+  chatMessage?: ChatMessage;
+
+  constructor(data?: PartialMessage<SendChatMessageCallback>) {
+    super();
+    proto3.util.initPartial(data, this);
+  }
+
+  static readonly runtime: typeof proto3 = proto3;
+  static readonly typeName = "livekit.proto.SendChatMessageCallback";
+  static readonly fields: FieldList = proto3.util.newFieldList(() => [
+    { no: 1, name: "async_id", kind: "scalar", T: 4 /* ScalarType.UINT64 */ },
+    { no: 2, name: "error", kind: "scalar", T: 9 /* ScalarType.STRING */, opt: true },
+    { no: 3, name: "chat_message", kind: "message", T: ChatMessage, opt: true },
+  ]);
+
+  static fromBinary(bytes: Uint8Array, options?: Partial<BinaryReadOptions>): SendChatMessageCallback {
+    return new SendChatMessageCallback().fromBinary(bytes, options);
+  }
+
+  static fromJson(jsonValue: JsonValue, options?: Partial<JsonReadOptions>): SendChatMessageCallback {
+    return new SendChatMessageCallback().fromJson(jsonValue, options);
+  }
+
+  static fromJsonString(jsonString: string, options?: Partial<JsonReadOptions>): SendChatMessageCallback {
+    return new SendChatMessageCallback().fromJsonString(jsonString, options);
+  }
+
+  static equals(a: SendChatMessageCallback | PlainMessage<SendChatMessageCallback> | undefined, b: SendChatMessageCallback | PlainMessage<SendChatMessageCallback> | undefined): boolean {
+    return proto3.util.equals(SendChatMessageCallback, a, b);
+  }
+}
+
 /**
  * Change the local participant's attributes
  *
@@ -2491,6 +2693,12 @@ export class RoomEvent extends Message<RoomEvent> {
      */
     value: TranscriptionReceived;
     case: "transcriptionReceived";
+  } | {
+    /**
+     * @generated from field: livekit.proto.ChatMessageReceived chat_message = 29;
+     */
+    value: ChatMessageReceived;
+    case: "chatMessage";
   } | { case: undefined; value?: undefined } = { case: undefined };
 
   constructor(data?: PartialMessage<RoomEvent>) {
@@ -2529,6 +2737,7 @@ export class RoomEvent extends Message<RoomEvent> {
     { no: 26, name: "eos", kind: "message", T: RoomEOS, oneof: "message" },
     { no: 27, name: "data_packet_received", kind: "message", T: DataPacketReceived, oneof: "message" },
     { no: 28, name: "transcription_received", kind: "message", T: TranscriptionReceived, oneof: "message" },
+    { no: 29, name: "chat_message", kind: "message", T: ChatMessageReceived, oneof: "message" },
   ]);
 
   static fromBinary(bytes: Uint8Array, options?: Partial<BinaryReadOptions>): RoomEvent {
@@ -3517,6 +3726,116 @@ export class UserPacket extends Message<UserPacket> {
   }
 }
 
+/**
+ * @generated from message livekit.proto.ChatMessage
+ */
+export class ChatMessage extends Message<ChatMessage> {
+  /**
+   * @generated from field: string id = 1;
+   */
+  id = "";
+
+  /**
+   * @generated from field: int64 timestamp = 2;
+   */
+  timestamp = protoInt64.zero;
+
+  /**
+   * @generated from field: string message = 3;
+   */
+  message = "";
+
+  /**
+   * @generated from field: optional int64 edit_timestamp = 4;
+   */
+  editTimestamp?: bigint;
+
+  /**
+   * @generated from field: optional bool deleted = 5;
+   */
+  deleted?: boolean;
+
+  /**
+   * @generated from field: optional bool generated = 6;
+   */
+  generated?: boolean;
+
+  constructor(data?: PartialMessage<ChatMessage>) {
+    super();
+    proto3.util.initPartial(data, this);
+  }
+
+  static readonly runtime: typeof proto3 = proto3;
+  static readonly typeName = "livekit.proto.ChatMessage";
+  static readonly fields: FieldList = proto3.util.newFieldList(() => [
+    { no: 1, name: "id", kind: "scalar", T: 9 /* ScalarType.STRING */ },
+    { no: 2, name: "timestamp", kind: "scalar", T: 3 /* ScalarType.INT64 */ },
+    { no: 3, name: "message", kind: "scalar", T: 9 /* ScalarType.STRING */ },
+    { no: 4, name: "edit_timestamp", kind: "scalar", T: 3 /* ScalarType.INT64 */, opt: true },
+    { no: 5, name: "deleted", kind: "scalar", T: 8 /* ScalarType.BOOL */, opt: true },
+    { no: 6, name: "generated", kind: "scalar", T: 8 /* ScalarType.BOOL */, opt: true },
+  ]);
+
+  static fromBinary(bytes: Uint8Array, options?: Partial<BinaryReadOptions>): ChatMessage {
+    return new ChatMessage().fromBinary(bytes, options);
+  }
+
+  static fromJson(jsonValue: JsonValue, options?: Partial<JsonReadOptions>): ChatMessage {
+    return new ChatMessage().fromJson(jsonValue, options);
+  }
+
+  static fromJsonString(jsonString: string, options?: Partial<JsonReadOptions>): ChatMessage {
+    return new ChatMessage().fromJsonString(jsonString, options);
+  }
+
+  static equals(a: ChatMessage | PlainMessage<ChatMessage> | undefined, b: ChatMessage | PlainMessage<ChatMessage> | undefined): boolean {
+    return proto3.util.equals(ChatMessage, a, b);
+  }
+}
+
+/**
+ * @generated from message livekit.proto.ChatMessageReceived
+ */
+export class ChatMessageReceived extends Message<ChatMessageReceived> {
+  /**
+   * @generated from field: livekit.proto.ChatMessage message = 1;
+   */
+  message?: ChatMessage;
+
+  /**
+   * @generated from field: string participant_identity = 2;
+   */
+  participantIdentity = "";
+
+  constructor(data?: PartialMessage<ChatMessageReceived>) {
+    super();
+    proto3.util.initPartial(data, this);
+  }
+
+  static readonly runtime: typeof proto3 = proto3;
+  static readonly typeName = "livekit.proto.ChatMessageReceived";
+  static readonly fields: FieldList = proto3.util.newFieldList(() => [
+    { no: 1, name: "message", kind: "message", T: ChatMessage },
+    { no: 2, name: "participant_identity", kind: "scalar", T: 9 /* ScalarType.STRING */ },
+  ]);
+
+  static fromBinary(bytes: Uint8Array, options?: Partial<BinaryReadOptions>): ChatMessageReceived {
+    return new ChatMessageReceived().fromBinary(bytes, options);
+  }
+
+  static fromJson(jsonValue: JsonValue, options?: Partial<JsonReadOptions>): ChatMessageReceived {
+    return new ChatMessageReceived().fromJson(jsonValue, options);
+  }
+
+  static fromJsonString(jsonString: string, options?: Partial<JsonReadOptions>): ChatMessageReceived {
+    return new ChatMessageReceived().fromJsonString(jsonString, options);
+  }
+
+  static equals(a: ChatMessageReceived | PlainMessage<ChatMessageReceived> | undefined, b: ChatMessageReceived | PlainMessage<ChatMessageReceived> | undefined): boolean {
+    return proto3.util.equals(ChatMessageReceived, a, b);
+  }
+}
+
 /**
  * @generated from message livekit.proto.SipDTMF
  */

package/src/room.ts

@@ -32,6 +32,7 @@ import type { LocalTrack, RemoteTrack } from './track.js';
 import { RemoteAudioTrack, RemoteVideoTrack } from './track.js';
 import type { LocalTrackPublication, TrackPublication } from './track_publication.js';
 import { RemoteTrackPublication } from './track_publication.js';
+import type { ChatMessage } from './types.js';
 
 export interface RtcConfiguration {
   iceTransportType: IceTransportType;
@@ -262,6 +263,17 @@ export class Room extends (EventEmitter as new () => TypedEmitter<RoomCallbacks>
     } else if (ev.case == 'connectionQualityChanged') {
       const participant = this.retrieveParticipantByIdentity(ev.value.participantIdentity);
       this.emit(RoomEvent.ConnectionQualityChanged, ev.value.quality, participant);
+    } else if (ev.case == 'chatMessage') {
+      const participant = this.retrieveParticipantByIdentity(ev.value.participantIdentity);
+      const { id, message: messageText, timestamp, editTimestamp, generated } = ev.value.message;
+      const message: ChatMessage = {
+        id,
+        message: messageText,
+        timestamp: Number(timestamp),
+        editTimestamp: Number(editTimestamp),
+        generated,
+      };
+      this.emit(RoomEvent.ChatMessage, message, participant);
     } else if (ev.case == 'dataPacketReceived') {
       // Can be undefined if the data is sent from a Server SDK
       const participant = this.remoteParticipants.get(ev.value.participantIdentity);
@@ -285,7 +297,6 @@ export class Room extends (EventEmitter as new () => TypedEmitter<RoomCallbacks>
           const { code, digit } = dataPacket.value;
           this.emit(RoomEvent.DtmfReceived, code, digit, participant);
           break;
-
         default:
           break;
       }
@@ -376,6 +387,7 @@ export type RoomCallbacks = {
     kind?: DataPacketKind,
     topic?: string,
   ) => void;
+  chatMessage: (message: ChatMessage, participant?: Participant) => void;
   dtmfReceived: (code: number, digit: string, participant: RemoteParticipant) => void;
   encryptionError: (error: Error) => void;
   connectionStateChanged: (state: ConnectionState) => void;
@@ -405,6 +417,7 @@ export enum RoomEvent {
   ParticipantAttributesChanged = 'participantAttributesChanged',
   ConnectionQualityChanged = 'connectionQualityChanged',
   DataReceived = 'dataReceived',
+  ChatMessage = 'chatMessage',
   DtmfReceived = 'dtmfReceived',
   EncryptionError = 'encryptionError',
   ConnectionStateChanged = 'connectionStateChanged',

package/src/types.ts

@@ -0,0 +1,10 @@
+// SPDX-FileCopyrightText: 2024 LiveKit, Inc.
+//
+// SPDX-License-Identifier: Apache-2.0
+export interface ChatMessage {
+  id: string;
+  timestamp: number;
+  message: string;
+  editTimestamp?: number;
+  generated?: boolean;
+}