@liveblocks/core 1.8.1 → 1.8.3-oss1

package/dist/index.d.mts

@@ -96,6 +96,25 @@ declare type AckOp = {
     readonly id: "ACK";
     readonly opId: string;
 };
+/**
+ * Create an Op that can be used as an acknowledgement for the given opId, to
+ * send back to the originating client in cases where the server decided to
+ * ignore the Op and not forward it.
+ *
+ * Why?
+ * It's important for the client to receive an acknowledgement for this, so
+ * that it can correctly update its own unacknowledged Ops administration.
+ * Otherwise it could get in "synchronizing" state indefinitely.
+ *
+ * CLEVER HACK
+ * Introducing a new Op type for this would not be backward-compatible as
+ * receiving such Op would crash old clients :(
+ * So the clever backward-compatible hack pulled here is that we codify the
+ * acknowledgement as a "deletion Op" for the non-existing node id "ACK". In
+ * old clients such Op is accepted, but will effectively be a no-op as that
+ * node does not exist, but as a side-effect the Op will get acknowledged.
+ */
+declare function ackOp(opId: string): AckOp;
 declare type SetParentKeyOp = {
     readonly opId?: string;
     readonly id: string;
@@ -686,13 +705,16 @@ declare type CommentBody = {
     content: CommentBodyBlockElement[];
 };
 
-declare type CommentReactionUser = {
-    id: string;
+declare type DateToString<T> = {
+    [P in keyof T]: T[P] extends Date ? string : T[P];
 };
+
 declare type CommentReaction = {
     emoji: string;
-    createdAt: string;
-    users: CommentReactionUser[];
+    createdAt: Date;
+    users: {
+        id: string;
+    }[];
 };
 /**
  * Represents a comment.
@@ -703,17 +725,33 @@ declare type CommentData = {
     threadId: string;
     roomId: string;
     userId: string;
-    createdAt: string;
-    editedAt?: string;
+    createdAt: Date;
+    editedAt?: Date;
     reactions: CommentReaction[];
 } & ({
     body: CommentBody;
     deletedAt?: never;
+} | {
+    body?: never;
+    deletedAt: Date;
+});
+declare type CommentDataPlain = Omit<DateToString<CommentData>, "reaction" | "body"> & {
+    reactions: DateToString<CommentReaction[]>;
+} & ({
+    body: CommentBody;
+    deletedAt?: never;
 } | {
     body?: never;
     deletedAt: string;
 });
 
+declare type CommentUserReaction = {
+    emoji: string;
+    createdAt: Date;
+    userId: string;
+};
+declare type CommentUserReactionPlain = DateToString<CommentUserReaction>;
+
 /**
  * Represents a thread of comments.
  */
@@ -721,11 +759,15 @@ declare type ThreadData<TThreadMetadata extends BaseMetadata = never> = {
     type: "thread";
     id: string;
     roomId: string;
-    createdAt: string;
-    updatedAt?: string;
+    createdAt: Date;
+    updatedAt?: Date;
     comments: CommentData[];
     metadata: [TThreadMetadata] extends [never] ? Record<string, never> : TThreadMetadata;
 };
+declare type ThreadDataPlain<TThreadMetadata extends BaseMetadata = never> = Omit<DateToString<ThreadData<TThreadMetadata>>, "comments" | "metadata"> & {
+    comments: CommentDataPlain[];
+    metadata: [TThreadMetadata] extends [never] ? Record<string, never> : TThreadMetadata;
+};
 
 declare type Options = {
     baseUrl: string;
@@ -744,7 +786,7 @@ declare type CommentsApi<TThreadMetadata extends BaseMetadata> = {
     editThreadMetadata(options: {
         metadata: PartialNullable<TThreadMetadata>;
         threadId: string;
-    }): Promise<ThreadData<TThreadMetadata>>;
+    }): Promise<TThreadMetadata>;
     createComment(options: {
         threadId: string;
         commentId: string;
@@ -763,12 +805,12 @@ declare type CommentsApi<TThreadMetadata extends BaseMetadata> = {
         threadId: string;
         commentId: string;
         emoji: string;
-    }): Promise<CommentData>;
+    }): Promise<CommentUserReaction>;
     removeReaction(options: {
         threadId: string;
         commentId: string;
         emoji: string;
-    }): Promise<CommentData>;
+    }): Promise<void>;
 };
 declare class CommentsApiError extends Error {
     message: string;
@@ -2007,8 +2049,8 @@ declare function assert(condition: boolean, errmsg: string): asserts condition;
  */
 declare function nn<T>(value: T, errmsg?: string): NonNullable<T>;
 
-declare type PromiseOrNot<T> = T | Promise<T>;
-declare type AsyncCacheFunction<T, A extends any[] = any[]> = (...args: A) => PromiseOrNot<T>;
+declare type PromiseOrNot$1<T> = T | Promise<T>;
+declare type AsyncCacheFunction<T, A extends any[] = any[]> = (...args: A) => PromiseOrNot$1<T>;
 declare type AsyncCacheOptions<T, E> = {
     isStateEqual?: (a: AsyncState<T, E>, b: AsyncState<T, E>) => boolean;
 };
@@ -2130,12 +2172,7 @@ declare const fancyConsole_errorWithTitle: typeof errorWithTitle;
 declare const fancyConsole_warn: typeof warn;
 declare const fancyConsole_warnWithTitle: typeof warnWithTitle;
 declare namespace fancyConsole {
-  export {
-    fancyConsole_error as error,
-    fancyConsole_errorWithTitle as errorWithTitle,
-    fancyConsole_warn as warn,
-    fancyConsole_warnWithTitle as warnWithTitle,
-  };
+  export { fancyConsole_error as error, fancyConsole_errorWithTitle as errorWithTitle, fancyConsole_warn as warn, fancyConsole_warnWithTitle as warnWithTitle };
 }
 
 /**
@@ -2300,14 +2337,7 @@ type DevToolsTreeNode_LsonTreeNode = LsonTreeNode;
 type DevToolsTreeNode_TreeNode = TreeNode;
 type DevToolsTreeNode_UserTreeNode = UserTreeNode;
 declare namespace DevToolsTreeNode {
-  export {
-    DevToolsTreeNode_CustomEventTreeNode as CustomEventTreeNode,
-    DevToolsTreeNode_JsonTreeNode as JsonTreeNode,
-    DevToolsTreeNode_LiveTreeNode as LiveTreeNode,
-    DevToolsTreeNode_LsonTreeNode as LsonTreeNode,
-    DevToolsTreeNode_TreeNode as TreeNode,
-    DevToolsTreeNode_UserTreeNode as UserTreeNode,
-  };
+  export type { DevToolsTreeNode_CustomEventTreeNode as CustomEventTreeNode, DevToolsTreeNode_JsonTreeNode as JsonTreeNode, DevToolsTreeNode_LiveTreeNode as LiveTreeNode, DevToolsTreeNode_LsonTreeNode as LsonTreeNode, DevToolsTreeNode_TreeNode as TreeNode, DevToolsTreeNode_UserTreeNode as UserTreeNode };
 }
 
 /**
@@ -2427,14 +2457,120 @@ type protocol_FullClientToPanelMessage = FullClientToPanelMessage;
 type protocol_FullPanelToClientMessage = FullPanelToClientMessage;
 type protocol_PanelToClientMessage = PanelToClientMessage;
 declare namespace protocol {
-  export {
-    protocol_ClientToPanelMessage as ClientToPanelMessage,
-    protocol_FullClientToPanelMessage as FullClientToPanelMessage,
-    protocol_FullPanelToClientMessage as FullPanelToClientMessage,
-    protocol_PanelToClientMessage as PanelToClientMessage,
-  };
+  export type { protocol_ClientToPanelMessage as ClientToPanelMessage, protocol_FullClientToPanelMessage as FullClientToPanelMessage, protocol_FullPanelToClientMessage as FullPanelToClientMessage, protocol_PanelToClientMessage as PanelToClientMessage };
 }
 
+declare type PromiseOrNot<T> = T | Promise<T>;
+declare type CommentBodyResolveUsersArgs = {
+    /**
+     * The ID of the users to resolve.
+     */
+    userIds: string[];
+};
+declare type CommentBodyParagraphElementArgs = {
+    /**
+     * The paragraph element.
+     */
+    element: CommentBodyParagraph;
+    /**
+     * The text content of the paragraph.
+     */
+    children: string;
+};
+declare type CommentBodyTextElementArgs = {
+    /**
+     * The text element.
+     */
+    element: CommentBodyText;
+};
+declare type CommentBodyLinkElementArgs = {
+    /**
+     * The link element.
+     */
+    element: CommentBodyLink;
+    /**
+     * The absolute URL of the link.
+     */
+    href: string;
+};
+declare type CommentBodyMentionElementArgs<TUserMeta extends BaseUserMeta = BaseUserMeta> = {
+    /**
+     * The mention element.
+     */
+    element: CommentBodyMention;
+    /**
+     * The mention's user info, if the `resolvedUsers` option was provided.
+     */
+    user?: TUserMeta["info"];
+};
+declare type StringifyCommentBodyElements<TUserMeta extends BaseUserMeta = BaseUserMeta> = {
+    /**
+     * The element used to display paragraphs.
+     */
+    paragraph: (args: CommentBodyParagraphElementArgs, index: number) => string;
+    /**
+     * The element used to display text elements.
+     */
+    text: (args: CommentBodyTextElementArgs, index: number) => string;
+    /**
+     * The element used to display links.
+     */
+    link: (args: CommentBodyLinkElementArgs, index: number) => string;
+    /**
+     * The element used to display mentions.
+     */
+    mention: (args: CommentBodyMentionElementArgs<TUserMeta>, index: number) => string;
+};
+declare type StringifyCommentBodyOptions<TUserMeta extends BaseUserMeta = BaseUserMeta> = {
+    /**
+     * Which format to convert the comment to.
+     */
+    format?: "plain" | "html" | "markdown";
+    /**
+     * The elements used to customize the resulting string. Each element has
+     * priority over the defaults inherited from the `format` option.
+     */
+    elements?: Partial<StringifyCommentBodyElements<TUserMeta>>;
+    /**
+     * The separator used between paragraphs.
+     */
+    separator?: string;
+    /**
+     * A function that returns user info from user IDs.
+     */
+    resolveUsers?: (args: CommentBodyResolveUsersArgs) => PromiseOrNot<(TUserMeta["info"] | undefined)[] | undefined>;
+};
+/**
+ * Get an array of each user's ID that has been mentioned in a `CommentBody`.
+ */
+declare function getMentionedIdsFromCommentBody(body: CommentBody): string[];
+/**
+ * Convert a `CommentBody` into either a plain string,
+ * Markdown, HTML, or a custom format.
+ */
+declare function stringifyCommentBody<TUserMeta extends BaseUserMeta = BaseUserMeta>(body: CommentBody, options?: StringifyCommentBodyOptions<TUserMeta>): Promise<string>;
+/**
+ * Converts a plain comment data object (usually returned by the API) to a comment data object that can be used by the client.
+ * This is necessary because the plain data object stores dates as ISO strings, but the client expects them as Date objects.
+ * @param data The plain comment data object (usually returned by the API)
+ * @returns The rich comment data object that can be used by the client.
+ */
+declare function convertToCommentData(data: CommentDataPlain): CommentData;
+/**
+ * Converts a plain thread data object (usually returned by the API) to a thread data object that can be used by the client.
+ * This is necessary because the plain data object stores dates as ISO strings, but the client expects them as Date objects.
+ * @param data The plain thread data object (usually returned by the API)
+ * @returns The rich hread data object that can be used by the client.
+ */
+declare function convertToThreadData<TThreadMetadata extends BaseMetadata = never>(data: ThreadDataPlain<TThreadMetadata>): ThreadData<TThreadMetadata>;
+/**
+ * Converts a plain comment reaction object (usually returned by the API) to a comment reaction object that can be used by the client.
+ * This is necessary because the plain data object stores dates as ISO strings, but the client expects them as Date objects.
+ * @param data The plain comment reaction object (usually returned by the API)
+ * @returns The rich comment reaction object that can be used by the client.
+ */
+declare function convertToCommentUserReaction(data: CommentUserReactionPlain): CommentUserReaction;
+
 /**
  * Helper type to help users adopt to Lson types from interface definitions.
  * You should only use this to wrap interfaces you don't control. For more
@@ -2447,4 +2583,4 @@ declare type EnsureJson<T> = [
     [K in keyof T]: EnsureJson<T[K]>;
 };
 
-export { AckOp, AsyncCache, AsyncState, AsyncStateError, AsyncStateInitial, AsyncStateLoading, AsyncStateResolved, AsyncStateSuccess, BaseAuthResult, BaseMetadata, BaseUserMeta, Brand, BroadcastEventClientMsg, BroadcastOptions, BroadcastedEventServerMsg, Client, ClientMsg, ClientMsgCode, CommentBody, CommentBodyBlockElement, CommentBodyElement, CommentBodyInlineElement, CommentBodyLink, CommentBodyMention, CommentBodyParagraph, CommentBodyText, CommentData, CommentReaction, CommentsApi, CommentsApiError, CrdtType, CreateListOp, CreateMapOp, CreateObjectOp, CreateOp, CreateRegisterOp, CustomAuthenticationResult, Delegates, DeleteCrdtOp, DeleteObjectKeyOp, DevToolsTreeNode as DevTools, protocol as DevToolsMsg, EnsureJson, EnterOptions, EventSource, FetchStorageClientMsg, FetchYDocClientMsg, History, IUserInfo, IWebSocket, IWebSocketCloseEvent, IWebSocketEvent, IWebSocketInstance, IWebSocketMessageEvent, IdTuple, Immutable, InitialDocumentStateServerMsg, Json, JsonArray, JsonObject, JsonScalar, LegacyConnectionStatus, LiveList, LiveListUpdate, LiveMap, LiveMapUpdate, LiveNode, LiveObject, LiveObjectUpdate, LiveStructure, LostConnectionEvent, Lson, LsonObject, NodeMap, Op, OpCode, Others, OthersEvent, ParentToChildNodeMap, PlainLson, PlainLsonFields, PlainLsonList, PlainLsonMap, PlainLsonObject, RejectedStorageOpServerMsg, Resolve, Room, RoomEventMessage, RoomInitializers, RoomStateServerMsg, SerializedChild, SerializedCrdt, SerializedList, SerializedMap, SerializedObject, SerializedRegister, SerializedRootObject, ServerMsg, ServerMsgCode, SetParentKeyOp, Status, StorageStatus, StorageUpdate, ThreadData, ToImmutable, ToJson, UnsubscribeCallback, UpdateObjectOp, UpdatePresenceClientMsg, UpdatePresenceServerMsg, UpdateStorageClientMsg, UpdateStorageServerMsg, UpdateYDocClientMsg, User, UserJoinServerMsg, UserLeftServerMsg, WebsocketCloseCodes, YDocUpdateServerMsg, asPos, assert, assertNever, b64decode, cloneLson, fancyConsole as console, createAsyncCache, createClient, createCommentsApi, deprecate, deprecateIf, detectDupes, errorIf, freeze, isChildCrdt, isJsonArray, isJsonObject, isJsonScalar, isLiveNode, isPlainObject, isRootCrdt, legacy_patchImmutableObject, lsonToJson, makeEventSource, makePoller, makePosition, nn, patchLiveObjectKey, raise, shallow, stringify, throwUsageError, toPlainLson, tryParseJson, withTimeout };
+export { type AckOp, type AsyncCache, type AsyncState, type AsyncStateError, type AsyncStateInitial, type AsyncStateLoading, type AsyncStateResolved, type AsyncStateSuccess, type BaseAuthResult, type BaseMetadata, type BaseUserMeta, type Brand, type BroadcastEventClientMsg, type BroadcastOptions, type BroadcastedEventServerMsg, type Client, type ClientMsg, ClientMsgCode, type CommentBody, type CommentBodyBlockElement, type CommentBodyElement, type CommentBodyInlineElement, type CommentBodyLink, type CommentBodyLinkElementArgs, type CommentBodyMention, type CommentBodyMentionElementArgs, type CommentBodyParagraph, type CommentBodyParagraphElementArgs, type CommentBodyResolveUsersArgs, type CommentBodyText, type CommentBodyTextElementArgs, type CommentData, type CommentDataPlain, type CommentReaction, type CommentUserReaction, type CommentUserReactionPlain, type CommentsApi, CommentsApiError, CrdtType, type CreateListOp, type CreateMapOp, type CreateObjectOp, type CreateOp, type CreateRegisterOp, type CustomAuthenticationResult, type Delegates, type DeleteCrdtOp, type DeleteObjectKeyOp, DevToolsTreeNode as DevTools, protocol as DevToolsMsg, type EnsureJson, type EnterOptions, type EventSource, type FetchStorageClientMsg, type FetchYDocClientMsg, type History, type IUserInfo, type IWebSocket, type IWebSocketCloseEvent, type IWebSocketEvent, type IWebSocketInstance, type IWebSocketMessageEvent, type IdTuple, type Immutable, type InitialDocumentStateServerMsg, type Json, type JsonArray, type JsonObject, type JsonScalar, type LegacyConnectionStatus, LiveList, type LiveListUpdate, LiveMap, type LiveMapUpdate, type LiveNode, LiveObject, type LiveObjectUpdate, type LiveStructure, type LostConnectionEvent, type Lson, type LsonObject, type NodeMap, type Op, OpCode, type Others, type OthersEvent, type ParentToChildNodeMap, type PlainLson, type PlainLsonFields, type PlainLsonList, type PlainLsonMap, type PlainLsonObject, type RejectedStorageOpServerMsg, type Resolve, type Room, type RoomEventMessage, type RoomInitializers, type RoomStateServerMsg, type SerializedChild, type SerializedCrdt, type SerializedList, type SerializedMap, type SerializedObject, type SerializedRegister, type SerializedRootObject, type ServerMsg, ServerMsgCode, type SetParentKeyOp, type Status, type StorageStatus, type StorageUpdate, type StringifyCommentBodyElements, type StringifyCommentBodyOptions, type ThreadData, type ThreadDataPlain, type ToImmutable, type ToJson, type UnsubscribeCallback, type UpdateObjectOp, type UpdatePresenceClientMsg, type UpdatePresenceServerMsg, type UpdateStorageClientMsg, type UpdateStorageServerMsg, type UpdateYDocClientMsg, type User, type UserJoinServerMsg, type UserLeftServerMsg, WebsocketCloseCodes, type YDocUpdateServerMsg, ackOp, asPos, assert, assertNever, b64decode, cloneLson, fancyConsole as console, convertToCommentData, convertToCommentUserReaction, convertToThreadData, createAsyncCache, createClient, createCommentsApi, deprecate, deprecateIf, detectDupes, errorIf, freeze, getMentionedIdsFromCommentBody, isChildCrdt, isJsonArray, isJsonObject, isJsonScalar, isLiveNode, isPlainObject, isRootCrdt, legacy_patchImmutableObject, lsonToJson, makeEventSource, makePoller, makePosition, nn, patchLiveObjectKey, raise, shallow, stringify, stringifyCommentBody, throwUsageError, toPlainLson, tryParseJson, withTimeout };

package/dist/index.d.ts

@@ -96,6 +96,25 @@ declare type AckOp = {
     readonly id: "ACK";
     readonly opId: string;
 };
+/**
+ * Create an Op that can be used as an acknowledgement for the given opId, to
+ * send back to the originating client in cases where the server decided to
+ * ignore the Op and not forward it.
+ *
+ * Why?
+ * It's important for the client to receive an acknowledgement for this, so
+ * that it can correctly update its own unacknowledged Ops administration.
+ * Otherwise it could get in "synchronizing" state indefinitely.
+ *
+ * CLEVER HACK
+ * Introducing a new Op type for this would not be backward-compatible as
+ * receiving such Op would crash old clients :(
+ * So the clever backward-compatible hack pulled here is that we codify the
+ * acknowledgement as a "deletion Op" for the non-existing node id "ACK". In
+ * old clients such Op is accepted, but will effectively be a no-op as that
+ * node does not exist, but as a side-effect the Op will get acknowledged.
+ */
+declare function ackOp(opId: string): AckOp;
 declare type SetParentKeyOp = {
     readonly opId?: string;
     readonly id: string;
@@ -686,13 +705,16 @@ declare type CommentBody = {
     content: CommentBodyBlockElement[];
 };
 
-declare type CommentReactionUser = {
-    id: string;
+declare type DateToString<T> = {
+    [P in keyof T]: T[P] extends Date ? string : T[P];
 };
+
 declare type CommentReaction = {
     emoji: string;
-    createdAt: string;
-    users: CommentReactionUser[];
+    createdAt: Date;
+    users: {
+        id: string;
+    }[];
 };
 /**
  * Represents a comment.
@@ -703,17 +725,33 @@ declare type CommentData = {
     threadId: string;
     roomId: string;
     userId: string;
-    createdAt: string;
-    editedAt?: string;
+    createdAt: Date;
+    editedAt?: Date;
     reactions: CommentReaction[];
 } & ({
     body: CommentBody;
     deletedAt?: never;
+} | {
+    body?: never;
+    deletedAt: Date;
+});
+declare type CommentDataPlain = Omit<DateToString<CommentData>, "reaction" | "body"> & {
+    reactions: DateToString<CommentReaction[]>;
+} & ({
+    body: CommentBody;
+    deletedAt?: never;
 } | {
     body?: never;
     deletedAt: string;
 });
 
+declare type CommentUserReaction = {
+    emoji: string;
+    createdAt: Date;
+    userId: string;
+};
+declare type CommentUserReactionPlain = DateToString<CommentUserReaction>;
+
 /**
  * Represents a thread of comments.
  */
@@ -721,11 +759,15 @@ declare type ThreadData<TThreadMetadata extends BaseMetadata = never> = {
     type: "thread";
     id: string;
     roomId: string;
-    createdAt: string;
-    updatedAt?: string;
+    createdAt: Date;
+    updatedAt?: Date;
     comments: CommentData[];
     metadata: [TThreadMetadata] extends [never] ? Record<string, never> : TThreadMetadata;
 };
+declare type ThreadDataPlain<TThreadMetadata extends BaseMetadata = never> = Omit<DateToString<ThreadData<TThreadMetadata>>, "comments" | "metadata"> & {
+    comments: CommentDataPlain[];
+    metadata: [TThreadMetadata] extends [never] ? Record<string, never> : TThreadMetadata;
+};
 
 declare type Options = {
     baseUrl: string;
@@ -744,7 +786,7 @@ declare type CommentsApi<TThreadMetadata extends BaseMetadata> = {
     editThreadMetadata(options: {
         metadata: PartialNullable<TThreadMetadata>;
         threadId: string;
-    }): Promise<ThreadData<TThreadMetadata>>;
+    }): Promise<TThreadMetadata>;
     createComment(options: {
         threadId: string;
         commentId: string;
@@ -763,12 +805,12 @@ declare type CommentsApi<TThreadMetadata extends BaseMetadata> = {
         threadId: string;
         commentId: string;
         emoji: string;
-    }): Promise<CommentData>;
+    }): Promise<CommentUserReaction>;
     removeReaction(options: {
         threadId: string;
         commentId: string;
         emoji: string;
-    }): Promise<CommentData>;
+    }): Promise<void>;
 };
 declare class CommentsApiError extends Error {
     message: string;
@@ -2007,8 +2049,8 @@ declare function assert(condition: boolean, errmsg: string): asserts condition;
  */
 declare function nn<T>(value: T, errmsg?: string): NonNullable<T>;
 
-declare type PromiseOrNot<T> = T | Promise<T>;
-declare type AsyncCacheFunction<T, A extends any[] = any[]> = (...args: A) => PromiseOrNot<T>;
+declare type PromiseOrNot$1<T> = T | Promise<T>;
+declare type AsyncCacheFunction<T, A extends any[] = any[]> = (...args: A) => PromiseOrNot$1<T>;
 declare type AsyncCacheOptions<T, E> = {
     isStateEqual?: (a: AsyncState<T, E>, b: AsyncState<T, E>) => boolean;
 };
@@ -2130,12 +2172,7 @@ declare const fancyConsole_errorWithTitle: typeof errorWithTitle;
 declare const fancyConsole_warn: typeof warn;
 declare const fancyConsole_warnWithTitle: typeof warnWithTitle;
 declare namespace fancyConsole {
-  export {
-    fancyConsole_error as error,
-    fancyConsole_errorWithTitle as errorWithTitle,
-    fancyConsole_warn as warn,
-    fancyConsole_warnWithTitle as warnWithTitle,
-  };
+  export { fancyConsole_error as error, fancyConsole_errorWithTitle as errorWithTitle, fancyConsole_warn as warn, fancyConsole_warnWithTitle as warnWithTitle };
 }
 
 /**
@@ -2300,14 +2337,7 @@ type DevToolsTreeNode_LsonTreeNode = LsonTreeNode;
 type DevToolsTreeNode_TreeNode = TreeNode;
 type DevToolsTreeNode_UserTreeNode = UserTreeNode;
 declare namespace DevToolsTreeNode {
-  export {
-    DevToolsTreeNode_CustomEventTreeNode as CustomEventTreeNode,
-    DevToolsTreeNode_JsonTreeNode as JsonTreeNode,
-    DevToolsTreeNode_LiveTreeNode as LiveTreeNode,
-    DevToolsTreeNode_LsonTreeNode as LsonTreeNode,
-    DevToolsTreeNode_TreeNode as TreeNode,
-    DevToolsTreeNode_UserTreeNode as UserTreeNode,
-  };
+  export type { DevToolsTreeNode_CustomEventTreeNode as CustomEventTreeNode, DevToolsTreeNode_JsonTreeNode as JsonTreeNode, DevToolsTreeNode_LiveTreeNode as LiveTreeNode, DevToolsTreeNode_LsonTreeNode as LsonTreeNode, DevToolsTreeNode_TreeNode as TreeNode, DevToolsTreeNode_UserTreeNode as UserTreeNode };
 }
 
 /**
@@ -2427,14 +2457,120 @@ type protocol_FullClientToPanelMessage = FullClientToPanelMessage;
 type protocol_FullPanelToClientMessage = FullPanelToClientMessage;
 type protocol_PanelToClientMessage = PanelToClientMessage;
 declare namespace protocol {
-  export {
-    protocol_ClientToPanelMessage as ClientToPanelMessage,
-    protocol_FullClientToPanelMessage as FullClientToPanelMessage,
-    protocol_FullPanelToClientMessage as FullPanelToClientMessage,
-    protocol_PanelToClientMessage as PanelToClientMessage,
-  };
+  export type { protocol_ClientToPanelMessage as ClientToPanelMessage, protocol_FullClientToPanelMessage as FullClientToPanelMessage, protocol_FullPanelToClientMessage as FullPanelToClientMessage, protocol_PanelToClientMessage as PanelToClientMessage };
 }
 
+declare type PromiseOrNot<T> = T | Promise<T>;
+declare type CommentBodyResolveUsersArgs = {
+    /**
+     * The ID of the users to resolve.
+     */
+    userIds: string[];
+};
+declare type CommentBodyParagraphElementArgs = {
+    /**
+     * The paragraph element.
+     */
+    element: CommentBodyParagraph;
+    /**
+     * The text content of the paragraph.
+     */
+    children: string;
+};
+declare type CommentBodyTextElementArgs = {
+    /**
+     * The text element.
+     */
+    element: CommentBodyText;
+};
+declare type CommentBodyLinkElementArgs = {
+    /**
+     * The link element.
+     */
+    element: CommentBodyLink;
+    /**
+     * The absolute URL of the link.
+     */
+    href: string;
+};
+declare type CommentBodyMentionElementArgs<TUserMeta extends BaseUserMeta = BaseUserMeta> = {
+    /**
+     * The mention element.
+     */
+    element: CommentBodyMention;
+    /**
+     * The mention's user info, if the `resolvedUsers` option was provided.
+     */
+    user?: TUserMeta["info"];
+};
+declare type StringifyCommentBodyElements<TUserMeta extends BaseUserMeta = BaseUserMeta> = {
+    /**
+     * The element used to display paragraphs.
+     */
+    paragraph: (args: CommentBodyParagraphElementArgs, index: number) => string;
+    /**
+     * The element used to display text elements.
+     */
+    text: (args: CommentBodyTextElementArgs, index: number) => string;
+    /**
+     * The element used to display links.
+     */
+    link: (args: CommentBodyLinkElementArgs, index: number) => string;
+    /**
+     * The element used to display mentions.
+     */
+    mention: (args: CommentBodyMentionElementArgs<TUserMeta>, index: number) => string;
+};
+declare type StringifyCommentBodyOptions<TUserMeta extends BaseUserMeta = BaseUserMeta> = {
+    /**
+     * Which format to convert the comment to.
+     */
+    format?: "plain" | "html" | "markdown";
+    /**
+     * The elements used to customize the resulting string. Each element has
+     * priority over the defaults inherited from the `format` option.
+     */
+    elements?: Partial<StringifyCommentBodyElements<TUserMeta>>;
+    /**
+     * The separator used between paragraphs.
+     */
+    separator?: string;
+    /**
+     * A function that returns user info from user IDs.
+     */
+    resolveUsers?: (args: CommentBodyResolveUsersArgs) => PromiseOrNot<(TUserMeta["info"] | undefined)[] | undefined>;
+};
+/**
+ * Get an array of each user's ID that has been mentioned in a `CommentBody`.
+ */
+declare function getMentionedIdsFromCommentBody(body: CommentBody): string[];
+/**
+ * Convert a `CommentBody` into either a plain string,
+ * Markdown, HTML, or a custom format.
+ */
+declare function stringifyCommentBody<TUserMeta extends BaseUserMeta = BaseUserMeta>(body: CommentBody, options?: StringifyCommentBodyOptions<TUserMeta>): Promise<string>;
+/**
+ * Converts a plain comment data object (usually returned by the API) to a comment data object that can be used by the client.
+ * This is necessary because the plain data object stores dates as ISO strings, but the client expects them as Date objects.
+ * @param data The plain comment data object (usually returned by the API)
+ * @returns The rich comment data object that can be used by the client.
+ */
+declare function convertToCommentData(data: CommentDataPlain): CommentData;
+/**
+ * Converts a plain thread data object (usually returned by the API) to a thread data object that can be used by the client.
+ * This is necessary because the plain data object stores dates as ISO strings, but the client expects them as Date objects.
+ * @param data The plain thread data object (usually returned by the API)
+ * @returns The rich hread data object that can be used by the client.
+ */
+declare function convertToThreadData<TThreadMetadata extends BaseMetadata = never>(data: ThreadDataPlain<TThreadMetadata>): ThreadData<TThreadMetadata>;
+/**
+ * Converts a plain comment reaction object (usually returned by the API) to a comment reaction object that can be used by the client.
+ * This is necessary because the plain data object stores dates as ISO strings, but the client expects them as Date objects.
+ * @param data The plain comment reaction object (usually returned by the API)
+ * @returns The rich comment reaction object that can be used by the client.
+ */
+declare function convertToCommentUserReaction(data: CommentUserReactionPlain): CommentUserReaction;
+
 /**
  * Helper type to help users adopt to Lson types from interface definitions.
  * You should only use this to wrap interfaces you don't control. For more
@@ -2447,4 +2583,4 @@ declare type EnsureJson<T> = [
     [K in keyof T]: EnsureJson<T[K]>;
 };
 
-export { AckOp, AsyncCache, AsyncState, AsyncStateError, AsyncStateInitial, AsyncStateLoading, AsyncStateResolved, AsyncStateSuccess, BaseAuthResult, BaseMetadata, BaseUserMeta, Brand, BroadcastEventClientMsg, BroadcastOptions, BroadcastedEventServerMsg, Client, ClientMsg, ClientMsgCode, CommentBody, CommentBodyBlockElement, CommentBodyElement, CommentBodyInlineElement, CommentBodyLink, CommentBodyMention, CommentBodyParagraph, CommentBodyText, CommentData, CommentReaction, CommentsApi, CommentsApiError, CrdtType, CreateListOp, CreateMapOp, CreateObjectOp, CreateOp, CreateRegisterOp, CustomAuthenticationResult, Delegates, DeleteCrdtOp, DeleteObjectKeyOp, DevToolsTreeNode as DevTools, protocol as DevToolsMsg, EnsureJson, EnterOptions, EventSource, FetchStorageClientMsg, FetchYDocClientMsg, History, IUserInfo, IWebSocket, IWebSocketCloseEvent, IWebSocketEvent, IWebSocketInstance, IWebSocketMessageEvent, IdTuple, Immutable, InitialDocumentStateServerMsg, Json, JsonArray, JsonObject, JsonScalar, LegacyConnectionStatus, LiveList, LiveListUpdate, LiveMap, LiveMapUpdate, LiveNode, LiveObject, LiveObjectUpdate, LiveStructure, LostConnectionEvent, Lson, LsonObject, NodeMap, Op, OpCode, Others, OthersEvent, ParentToChildNodeMap, PlainLson, PlainLsonFields, PlainLsonList, PlainLsonMap, PlainLsonObject, RejectedStorageOpServerMsg, Resolve, Room, RoomEventMessage, RoomInitializers, RoomStateServerMsg, SerializedChild, SerializedCrdt, SerializedList, SerializedMap, SerializedObject, SerializedRegister, SerializedRootObject, ServerMsg, ServerMsgCode, SetParentKeyOp, Status, StorageStatus, StorageUpdate, ThreadData, ToImmutable, ToJson, UnsubscribeCallback, UpdateObjectOp, UpdatePresenceClientMsg, UpdatePresenceServerMsg, UpdateStorageClientMsg, UpdateStorageServerMsg, UpdateYDocClientMsg, User, UserJoinServerMsg, UserLeftServerMsg, WebsocketCloseCodes, YDocUpdateServerMsg, asPos, assert, assertNever, b64decode, cloneLson, fancyConsole as console, createAsyncCache, createClient, createCommentsApi, deprecate, deprecateIf, detectDupes, errorIf, freeze, isChildCrdt, isJsonArray, isJsonObject, isJsonScalar, isLiveNode, isPlainObject, isRootCrdt, legacy_patchImmutableObject, lsonToJson, makeEventSource, makePoller, makePosition, nn, patchLiveObjectKey, raise, shallow, stringify, throwUsageError, toPlainLson, tryParseJson, withTimeout };
+export { type AckOp, type AsyncCache, type AsyncState, type AsyncStateError, type AsyncStateInitial, type AsyncStateLoading, type AsyncStateResolved, type AsyncStateSuccess, type BaseAuthResult, type BaseMetadata, type BaseUserMeta, type Brand, type BroadcastEventClientMsg, type BroadcastOptions, type BroadcastedEventServerMsg, type Client, type ClientMsg, ClientMsgCode, type CommentBody, type CommentBodyBlockElement, type CommentBodyElement, type CommentBodyInlineElement, type CommentBodyLink, type CommentBodyLinkElementArgs, type CommentBodyMention, type CommentBodyMentionElementArgs, type CommentBodyParagraph, type CommentBodyParagraphElementArgs, type CommentBodyResolveUsersArgs, type CommentBodyText, type CommentBodyTextElementArgs, type CommentData, type CommentDataPlain, type CommentReaction, type CommentUserReaction, type CommentUserReactionPlain, type CommentsApi, CommentsApiError, CrdtType, type CreateListOp, type CreateMapOp, type CreateObjectOp, type CreateOp, type CreateRegisterOp, type CustomAuthenticationResult, type Delegates, type DeleteCrdtOp, type DeleteObjectKeyOp, DevToolsTreeNode as DevTools, protocol as DevToolsMsg, type EnsureJson, type EnterOptions, type EventSource, type FetchStorageClientMsg, type FetchYDocClientMsg, type History, type IUserInfo, type IWebSocket, type IWebSocketCloseEvent, type IWebSocketEvent, type IWebSocketInstance, type IWebSocketMessageEvent, type IdTuple, type Immutable, type InitialDocumentStateServerMsg, type Json, type JsonArray, type JsonObject, type JsonScalar, type LegacyConnectionStatus, LiveList, type LiveListUpdate, LiveMap, type LiveMapUpdate, type LiveNode, LiveObject, type LiveObjectUpdate, type LiveStructure, type LostConnectionEvent, type Lson, type LsonObject, type NodeMap, type Op, OpCode, type Others, type OthersEvent, type ParentToChildNodeMap, type PlainLson, type PlainLsonFields, type PlainLsonList, type PlainLsonMap, type PlainLsonObject, type RejectedStorageOpServerMsg, type Resolve, type Room, type RoomEventMessage, type RoomInitializers, type RoomStateServerMsg, type SerializedChild, type SerializedCrdt, type SerializedList, type SerializedMap, type SerializedObject, type SerializedRegister, type SerializedRootObject, type ServerMsg, ServerMsgCode, type SetParentKeyOp, type Status, type StorageStatus, type StorageUpdate, type StringifyCommentBodyElements, type StringifyCommentBodyOptions, type ThreadData, type ThreadDataPlain, type ToImmutable, type ToJson, type UnsubscribeCallback, type UpdateObjectOp, type UpdatePresenceClientMsg, type UpdatePresenceServerMsg, type UpdateStorageClientMsg, type UpdateStorageServerMsg, type UpdateYDocClientMsg, type User, type UserJoinServerMsg, type UserLeftServerMsg, WebsocketCloseCodes, type YDocUpdateServerMsg, ackOp, asPos, assert, assertNever, b64decode, cloneLson, fancyConsole as console, convertToCommentData, convertToCommentUserReaction, convertToThreadData, createAsyncCache, createClient, createCommentsApi, deprecate, deprecateIf, detectDupes, errorIf, freeze, getMentionedIdsFromCommentBody, isChildCrdt, isJsonArray, isJsonObject, isJsonScalar, isLiveNode, isPlainObject, isRootCrdt, legacy_patchImmutableObject, lsonToJson, makeEventSource, makePoller, makePosition, nn, patchLiveObjectKey, raise, shallow, stringify, stringifyCommentBody, throwUsageError, toPlainLson, tryParseJson, withTimeout };