@liveblocks/emails 2.21.0 → 2.22.0

package/dist/index.d.cts

@@ -1,100 +1,9 @@
-import { CommentBodyText, CommentBodyLink, BaseUserMeta, DU, CommentBodyMention, ResolveUsersArgs, Awaitable, DRI, CommentBody } from '@liveblocks/core';
+import { BaseUserMeta, DU, ResolveUsersArgs, Awaitable, DRI, CommentBodyText, CommentBodyLink, CommentBodyMention } from '@liveblocks/core';
 export { ResolveUsersArgs } from '@liveblocks/core';
 import { ReactNode, ComponentType } from 'react';
 import { Properties } from 'csstype';
 import { Liveblocks, TextMentionNotificationEvent, ThreadNotificationEvent } from '@liveblocks/node';
 
-/**
- * CSS properties object.
- * Type alias for DX purposes.
- *
- */
-type CSSProperties = Properties;
-
-type CommentBodyContainerComponentProps = {
-    /**
-     * The blocks of the comment body
-     */
-    children: ReactNode;
-};
-type CommentBodyParagraphComponentProps = {
-    /**
-     * The text content of the paragraph.
-     */
-    children: ReactNode;
-};
-type CommentBodyTextComponentProps = {
-    /**
-     * The text element.
-     */
-    element: CommentBodyText;
-};
-type CommentBodyLinkComponentProps = {
-    /**
-     * The link element.
-     */
-    element: CommentBodyLink;
-    /**
-     * The absolute URL of the link.
-     */
-    href: string;
-};
-type CommentBodyMentionComponentProps<U extends BaseUserMeta = DU> = {
-    /**
-     * The mention element.
-     */
-    element: CommentBodyMention;
-    /**
-     * The mention's user info, if the `resolvedUsers` option was provided.
-     */
-    user?: U["info"];
-};
-type ConvertCommentBodyAsReactComponents<U extends BaseUserMeta = DU> = {
-    /**
-     *
-     * The component used to act as a container to wrap comment body blocks,
-     */
-    Container: ComponentType<CommentBodyContainerComponentProps>;
-    /**
-     * The component used to display paragraphs.
-     */
-    Paragraph: ComponentType<CommentBodyParagraphComponentProps>;
-    /**
-     * The component used to display text elements.
-     */
-    Text: ComponentType<CommentBodyTextComponentProps>;
-    /**
-     * The component used to display links.
-     */
-    Link: ComponentType<CommentBodyLinkComponentProps>;
-    /**
-     * The component used to display mentions.
-     */
-    Mention: ComponentType<CommentBodyMentionComponentProps<U>>;
-};
-type ConvertCommentBodyAsHtmlStyles = {
-    /**
-     * The default inline CSS styles used to display paragraphs.
-     */
-    paragraph: CSSProperties;
-    /**
-     * The default inline CSS styles used to display text `<strong />` elements.
-     */
-    strong: CSSProperties;
-    /**
-     * The default inline CSS styles used to display text `<code />` elements.
-     */
-    code: CSSProperties;
-    /**
-     * The default inline CSS styles used to display links.
-     */
-    mention: CSSProperties;
-    /**
-     * The default inline CSS styles used to display mentions.
-     */
-    link: CSSProperties;
-};
-
 type ResolveRoomInfoArgs = {
     /**
      * The ID of the room to resolve
@@ -102,6 +11,13 @@ type ResolveRoomInfoArgs = {
     roomId: string;
 };
 
+/**
+ * CSS properties object.
+ * Type alias for DX purposes.
+ *
+ */
+type CSSProperties = Properties;
+
 /**
  * Liveblocks Text Editor
  *
@@ -293,52 +209,76 @@ type TextMentionNotificationEmailDataAsHtml = TextMentionNotificationEmailData<B
  */
 declare function prepareTextMentionNotificationEmailAsHtml(client: Liveblocks, event: TextMentionNotificationEvent, options?: PrepareTextMentionNotificationEmailAsHtmlOptions<BaseUserMeta>): Promise<TextMentionNotificationEmailDataAsHtml | null>;
 
-type CommentEmailBaseData = {
+type CommentEmailData<BodyType, U extends BaseUserMeta = DU> = {
     id: string;
     threadId: string;
     roomId: string;
-    userId: string;
     createdAt: Date;
     url?: string;
-    rawBody: CommentBody;
-};
-type PrepareThreadNotificationEmailBaseDataOptions = {
-    /**
-     * A function that returns room info from room IDs.
-     */
-    resolveRoomInfo?: (args: ResolveRoomInfoArgs) => Awaitable<DRI | undefined>;
-};
-type CommentEmailAsHtmlData<U extends BaseUserMeta = DU> = Omit<CommentEmailBaseData, "userId" | "rawBody"> & {
     author: U;
-    htmlBody: string;
+    body: BodyType;
 };
-type CommentEmailAsReactData<U extends BaseUserMeta = DU> = Omit<CommentEmailBaseData, "userId" | "rawBody"> & {
-    author: U;
-    reactBody: ReactNode;
-};
-type ThreadNotificationEmailUnreadRepliesData<U extends BaseUserMeta, C extends CommentEmailAsHtmlData<U> | CommentEmailAsReactData<U>> = {
+type ThreadNotificationEmailData<BodyType, U extends BaseUserMeta = DU, C extends CommentEmailData<BodyType, U> = CommentEmailData<BodyType, U>> = ({
     type: "unreadReplies";
     comments: C[];
-};
-type ThreadNotificationEmailUnreadMentionsData<U extends BaseUserMeta, C extends CommentEmailAsHtmlData<U> | CommentEmailAsReactData<U>> = {
+} | {
     type: "unreadMention";
     comment: C;
-};
-type ThreadNotificationEmailData<U extends BaseUserMeta, C extends CommentEmailAsHtmlData<U> | CommentEmailAsReactData<U>> = (ThreadNotificationEmailUnreadRepliesData<U, C> | ThreadNotificationEmailUnreadMentionsData<U, C>) & {
+}) & {
     roomInfo: DRI;
 };
-type PrepareThreadNotificationEmailAsHtmlOptions<U extends BaseUserMeta = DU> = PrepareThreadNotificationEmailBaseDataOptions & {
+type CommentEmailAsHtmlData<U extends BaseUserMeta = DU> = CommentEmailData<string, U> & {
+    /** @deprecated Use `body` property instead. */
+    htmlBody: string;
+};
+type CommentEmailAsReactData<U extends BaseUserMeta = DU> = CommentEmailData<ReactNode, U> & {
+    /** @deprecated Use `body` property instead. */
+    reactBody: ReactNode;
+};
+type PrepareThreadNotificationEmailOptions<U extends BaseUserMeta = DU> = {
+    /**
+     * A function that returns room info from room IDs.
+     */
+    resolveRoomInfo?: (args: ResolveRoomInfoArgs) => Awaitable<DRI | undefined>;
     /**
      * A function that returns info from user IDs.
      */
     resolveUsers?: (args: ResolveUsersArgs) => Awaitable<(U["info"] | undefined)[] | undefined>;
+};
+/**
+ * The styles used to customize the html elements in the resulting html safe string.
+ * Each styles has priority over the base styles inherited.
+ */
+type ConvertCommentBodyAsHtmlStyles = {
+    /**
+     * The default inline CSS styles used to display paragraphs.
+     */
+    paragraph: CSSProperties;
+    /**
+     * The default inline CSS styles used to display text `<strong />` elements.
+     */
+    strong: CSSProperties;
+    /**
+     * The default inline CSS styles used to display text `<code />` elements.
+     */
+    code: CSSProperties;
+    /**
+     * The default inline CSS styles used to display links.
+     */
+    mention: CSSProperties;
+    /**
+     * The default inline CSS styles used to display mentions.
+     */
+    link: CSSProperties;
+};
+type PrepareThreadNotificationEmailAsHtmlOptions<U extends BaseUserMeta = DU> = PrepareThreadNotificationEmailOptions<U> & {
     /**
      * The styles used to customize the html elements in the resulting html safe string inside a comment body.
      * Each styles has priority over the base styles inherited.
      */
     styles?: Partial<ConvertCommentBodyAsHtmlStyles>;
 };
-type ThreadNotificationEmailDataAsHtml = ThreadNotificationEmailData<BaseUserMeta, CommentEmailAsHtmlData>;
+type ThreadNotificationEmailDataAsHtml<U extends BaseUserMeta = DU> = ThreadNotificationEmailData<string, U, CommentEmailAsHtmlData<U>>;
 /**
  * Prepares data from a `ThreadNotificationEvent` and convert comment bodies as an html safe string.
  *
@@ -366,18 +306,75 @@ type ThreadNotificationEmailDataAsHtml = ThreadNotificationEmailData<BaseUserMet
  *
  */
 declare function prepareThreadNotificationEmailAsHtml(client: Liveblocks, event: ThreadNotificationEvent, options?: PrepareThreadNotificationEmailAsHtmlOptions<BaseUserMeta>): Promise<ThreadNotificationEmailDataAsHtml | null>;
-type PrepareThreadNotificationEmailAsReactOptions<U extends BaseUserMeta = DU> = PrepareThreadNotificationEmailBaseDataOptions & {
+type CommentBodyContainerComponentProps = {
     /**
-     * A function that returns info from user IDs.
+     * The blocks of the comment body
      */
-    resolveUsers?: (args: ResolveUsersArgs) => Awaitable<(U["info"] | undefined)[] | undefined>;
+    children: ReactNode;
+};
+type CommentBodyParagraphComponentProps = {
+    /**
+     * The text content of the paragraph.
+     */
+    children: ReactNode;
+};
+type CommentBodyTextComponentProps = {
+    /**
+     * The text element.
+     */
+    element: CommentBodyText;
+};
+type CommentBodyLinkComponentProps = {
+    /**
+     * The link element.
+     */
+    element: CommentBodyLink;
+    /**
+     * The absolute URL of the link.
+     */
+    href: string;
+};
+type CommentBodyMentionComponentProps<U extends BaseUserMeta = DU> = {
+    /**
+     * The mention element.
+     */
+    element: CommentBodyMention;
+    /**
+     * The mention's user info, if the `resolvedUsers` option was provided.
+     */
+    user?: U["info"];
+};
+type ConvertCommentBodyAsReactComponents<U extends BaseUserMeta = DU> = {
+    /**
+     *
+     * The component used to act as a container to wrap comment body blocks,
+     */
+    Container: ComponentType<CommentBodyContainerComponentProps>;
+    /**
+     * The component used to display paragraphs.
+     */
+    Paragraph: ComponentType<CommentBodyParagraphComponentProps>;
+    /**
+     * The component used to display text elements.
+     */
+    Text: ComponentType<CommentBodyTextComponentProps>;
+    /**
+     * The component used to display links.
+     */
+    Link: ComponentType<CommentBodyLinkComponentProps>;
+    /**
+     * The component used to display mentions.
+     */
+    Mention: ComponentType<CommentBodyMentionComponentProps<U>>;
+};
+type PrepareThreadNotificationEmailAsReactOptions<U extends BaseUserMeta = DU> = PrepareThreadNotificationEmailOptions<U> & {
     /**
      * The components used to customize the resulting React nodes inside a comment body.
      * Each components has priority over the base components inherited internally defined.
      */
     components?: Partial<ConvertCommentBodyAsReactComponents<U>>;
 };
-type ThreadNotificationEmailDataAsReact = ThreadNotificationEmailData<BaseUserMeta, CommentEmailAsReactData>;
+type ThreadNotificationEmailDataAsReact<U extends BaseUserMeta = DU> = ThreadNotificationEmailData<ReactNode, U, CommentEmailAsReactData<U>>;
 /**
  * Prepares data from a `ThreadNotificationEvent` and convert comment bodies as React nodes.
  *

package/dist/index.d.ts

@@ -1,100 +1,9 @@
-import { CommentBodyText, CommentBodyLink, BaseUserMeta, DU, CommentBodyMention, ResolveUsersArgs, Awaitable, DRI, CommentBody } from '@liveblocks/core';
+import { BaseUserMeta, DU, ResolveUsersArgs, Awaitable, DRI, CommentBodyText, CommentBodyLink, CommentBodyMention } from '@liveblocks/core';
 export { ResolveUsersArgs } from '@liveblocks/core';
 import { ReactNode, ComponentType } from 'react';
 import { Properties } from 'csstype';
 import { Liveblocks, TextMentionNotificationEvent, ThreadNotificationEvent } from '@liveblocks/node';
 
-/**
- * CSS properties object.
- * Type alias for DX purposes.
- *
- */
-type CSSProperties = Properties;
-
-type CommentBodyContainerComponentProps = {
-    /**
-     * The blocks of the comment body
-     */
-    children: ReactNode;
-};
-type CommentBodyParagraphComponentProps = {
-    /**
-     * The text content of the paragraph.
-     */
-    children: ReactNode;
-};
-type CommentBodyTextComponentProps = {
-    /**
-     * The text element.
-     */
-    element: CommentBodyText;
-};
-type CommentBodyLinkComponentProps = {
-    /**
-     * The link element.
-     */
-    element: CommentBodyLink;
-    /**
-     * The absolute URL of the link.
-     */
-    href: string;
-};
-type CommentBodyMentionComponentProps<U extends BaseUserMeta = DU> = {
-    /**
-     * The mention element.
-     */
-    element: CommentBodyMention;
-    /**
-     * The mention's user info, if the `resolvedUsers` option was provided.
-     */
-    user?: U["info"];
-};
-type ConvertCommentBodyAsReactComponents<U extends BaseUserMeta = DU> = {
-    /**
-     *
-     * The component used to act as a container to wrap comment body blocks,
-     */
-    Container: ComponentType<CommentBodyContainerComponentProps>;
-    /**
-     * The component used to display paragraphs.
-     */
-    Paragraph: ComponentType<CommentBodyParagraphComponentProps>;
-    /**
-     * The component used to display text elements.
-     */
-    Text: ComponentType<CommentBodyTextComponentProps>;
-    /**
-     * The component used to display links.
-     */
-    Link: ComponentType<CommentBodyLinkComponentProps>;
-    /**
-     * The component used to display mentions.
-     */
-    Mention: ComponentType<CommentBodyMentionComponentProps<U>>;
-};
-type ConvertCommentBodyAsHtmlStyles = {
-    /**
-     * The default inline CSS styles used to display paragraphs.
-     */
-    paragraph: CSSProperties;
-    /**
-     * The default inline CSS styles used to display text `<strong />` elements.
-     */
-    strong: CSSProperties;
-    /**
-     * The default inline CSS styles used to display text `<code />` elements.
-     */
-    code: CSSProperties;
-    /**
-     * The default inline CSS styles used to display links.
-     */
-    mention: CSSProperties;
-    /**
-     * The default inline CSS styles used to display mentions.
-     */
-    link: CSSProperties;
-};
-
 type ResolveRoomInfoArgs = {
     /**
      * The ID of the room to resolve
@@ -102,6 +11,13 @@ type ResolveRoomInfoArgs = {
     roomId: string;
 };
 
+/**
+ * CSS properties object.
+ * Type alias for DX purposes.
+ *
+ */
+type CSSProperties = Properties;
+
 /**
  * Liveblocks Text Editor
  *
@@ -293,52 +209,76 @@ type TextMentionNotificationEmailDataAsHtml = TextMentionNotificationEmailData<B
  */
 declare function prepareTextMentionNotificationEmailAsHtml(client: Liveblocks, event: TextMentionNotificationEvent, options?: PrepareTextMentionNotificationEmailAsHtmlOptions<BaseUserMeta>): Promise<TextMentionNotificationEmailDataAsHtml | null>;
 
-type CommentEmailBaseData = {
+type CommentEmailData<BodyType, U extends BaseUserMeta = DU> = {
     id: string;
     threadId: string;
     roomId: string;
-    userId: string;
     createdAt: Date;
     url?: string;
-    rawBody: CommentBody;
-};
-type PrepareThreadNotificationEmailBaseDataOptions = {
-    /**
-     * A function that returns room info from room IDs.
-     */
-    resolveRoomInfo?: (args: ResolveRoomInfoArgs) => Awaitable<DRI | undefined>;
-};
-type CommentEmailAsHtmlData<U extends BaseUserMeta = DU> = Omit<CommentEmailBaseData, "userId" | "rawBody"> & {
     author: U;
-    htmlBody: string;
+    body: BodyType;
 };
-type CommentEmailAsReactData<U extends BaseUserMeta = DU> = Omit<CommentEmailBaseData, "userId" | "rawBody"> & {
-    author: U;
-    reactBody: ReactNode;
-};
-type ThreadNotificationEmailUnreadRepliesData<U extends BaseUserMeta, C extends CommentEmailAsHtmlData<U> | CommentEmailAsReactData<U>> = {
+type ThreadNotificationEmailData<BodyType, U extends BaseUserMeta = DU, C extends CommentEmailData<BodyType, U> = CommentEmailData<BodyType, U>> = ({
     type: "unreadReplies";
     comments: C[];
-};
-type ThreadNotificationEmailUnreadMentionsData<U extends BaseUserMeta, C extends CommentEmailAsHtmlData<U> | CommentEmailAsReactData<U>> = {
+} | {
     type: "unreadMention";
     comment: C;
-};
-type ThreadNotificationEmailData<U extends BaseUserMeta, C extends CommentEmailAsHtmlData<U> | CommentEmailAsReactData<U>> = (ThreadNotificationEmailUnreadRepliesData<U, C> | ThreadNotificationEmailUnreadMentionsData<U, C>) & {
+}) & {
     roomInfo: DRI;
 };
-type PrepareThreadNotificationEmailAsHtmlOptions<U extends BaseUserMeta = DU> = PrepareThreadNotificationEmailBaseDataOptions & {
+type CommentEmailAsHtmlData<U extends BaseUserMeta = DU> = CommentEmailData<string, U> & {
+    /** @deprecated Use `body` property instead. */
+    htmlBody: string;
+};
+type CommentEmailAsReactData<U extends BaseUserMeta = DU> = CommentEmailData<ReactNode, U> & {
+    /** @deprecated Use `body` property instead. */
+    reactBody: ReactNode;
+};
+type PrepareThreadNotificationEmailOptions<U extends BaseUserMeta = DU> = {
+    /**
+     * A function that returns room info from room IDs.
+     */
+    resolveRoomInfo?: (args: ResolveRoomInfoArgs) => Awaitable<DRI | undefined>;
     /**
      * A function that returns info from user IDs.
      */
     resolveUsers?: (args: ResolveUsersArgs) => Awaitable<(U["info"] | undefined)[] | undefined>;
+};
+/**
+ * The styles used to customize the html elements in the resulting html safe string.
+ * Each styles has priority over the base styles inherited.
+ */
+type ConvertCommentBodyAsHtmlStyles = {
+    /**
+     * The default inline CSS styles used to display paragraphs.
+     */
+    paragraph: CSSProperties;
+    /**
+     * The default inline CSS styles used to display text `<strong />` elements.
+     */
+    strong: CSSProperties;
+    /**
+     * The default inline CSS styles used to display text `<code />` elements.
+     */
+    code: CSSProperties;
+    /**
+     * The default inline CSS styles used to display links.
+     */
+    mention: CSSProperties;
+    /**
+     * The default inline CSS styles used to display mentions.
+     */
+    link: CSSProperties;
+};
+type PrepareThreadNotificationEmailAsHtmlOptions<U extends BaseUserMeta = DU> = PrepareThreadNotificationEmailOptions<U> & {
     /**
      * The styles used to customize the html elements in the resulting html safe string inside a comment body.
      * Each styles has priority over the base styles inherited.
      */
     styles?: Partial<ConvertCommentBodyAsHtmlStyles>;
 };
-type ThreadNotificationEmailDataAsHtml = ThreadNotificationEmailData<BaseUserMeta, CommentEmailAsHtmlData>;
+type ThreadNotificationEmailDataAsHtml<U extends BaseUserMeta = DU> = ThreadNotificationEmailData<string, U, CommentEmailAsHtmlData<U>>;
 /**
  * Prepares data from a `ThreadNotificationEvent` and convert comment bodies as an html safe string.
  *
@@ -366,18 +306,75 @@ type ThreadNotificationEmailDataAsHtml = ThreadNotificationEmailData<BaseUserMet
  *
  */
 declare function prepareThreadNotificationEmailAsHtml(client: Liveblocks, event: ThreadNotificationEvent, options?: PrepareThreadNotificationEmailAsHtmlOptions<BaseUserMeta>): Promise<ThreadNotificationEmailDataAsHtml | null>;
-type PrepareThreadNotificationEmailAsReactOptions<U extends BaseUserMeta = DU> = PrepareThreadNotificationEmailBaseDataOptions & {
+type CommentBodyContainerComponentProps = {
     /**
-     * A function that returns info from user IDs.
+     * The blocks of the comment body
      */
-    resolveUsers?: (args: ResolveUsersArgs) => Awaitable<(U["info"] | undefined)[] | undefined>;
+    children: ReactNode;
+};
+type CommentBodyParagraphComponentProps = {
+    /**
+     * The text content of the paragraph.
+     */
+    children: ReactNode;
+};
+type CommentBodyTextComponentProps = {
+    /**
+     * The text element.
+     */
+    element: CommentBodyText;
+};
+type CommentBodyLinkComponentProps = {
+    /**
+     * The link element.
+     */
+    element: CommentBodyLink;
+    /**
+     * The absolute URL of the link.
+     */
+    href: string;
+};
+type CommentBodyMentionComponentProps<U extends BaseUserMeta = DU> = {
+    /**
+     * The mention element.
+     */
+    element: CommentBodyMention;
+    /**
+     * The mention's user info, if the `resolvedUsers` option was provided.
+     */
+    user?: U["info"];
+};
+type ConvertCommentBodyAsReactComponents<U extends BaseUserMeta = DU> = {
+    /**
+     *
+     * The component used to act as a container to wrap comment body blocks,
+     */
+    Container: ComponentType<CommentBodyContainerComponentProps>;
+    /**
+     * The component used to display paragraphs.
+     */
+    Paragraph: ComponentType<CommentBodyParagraphComponentProps>;
+    /**
+     * The component used to display text elements.
+     */
+    Text: ComponentType<CommentBodyTextComponentProps>;
+    /**
+     * The component used to display links.
+     */
+    Link: ComponentType<CommentBodyLinkComponentProps>;
+    /**
+     * The component used to display mentions.
+     */
+    Mention: ComponentType<CommentBodyMentionComponentProps<U>>;
+};
+type PrepareThreadNotificationEmailAsReactOptions<U extends BaseUserMeta = DU> = PrepareThreadNotificationEmailOptions<U> & {
     /**
      * The components used to customize the resulting React nodes inside a comment body.
      * Each components has priority over the base components inherited internally defined.
      */
     components?: Partial<ConvertCommentBodyAsReactComponents<U>>;
 };
-type ThreadNotificationEmailDataAsReact = ThreadNotificationEmailData<BaseUserMeta, CommentEmailAsReactData>;
+type ThreadNotificationEmailDataAsReact<U extends BaseUserMeta = DU> = ThreadNotificationEmailData<ReactNode, U, CommentEmailAsReactData<U>>;
 /**
  * Prepares data from a `ThreadNotificationEvent` and convert comment bodies as React nodes.
  *