@contentstack/live-preview-utils 3.1.0 → 3.2.0-alpha.1

package/dist/modern/visualBuilder/types/collab.types.d.cts

@@ -0,0 +1,232 @@
+interface IUserDTO {
+    display?: string;
+    email: string;
+    uid: string;
+    firstName?: string | null;
+    lastName?: string | null;
+}
+declare interface IUserState {
+    mentionsList: Array<IMentionList>;
+    userMap: IUserMap;
+    currentUser: IUserDTO;
+}
+declare type IUserMap = {
+    [key: string]: IUserDTO;
+};
+declare interface IInviteMetadata {
+    users: Array<IUserDTO>;
+    currentUser: IUserDTO;
+    inviteUid: string;
+}
+declare type IMentionItem = {
+    id: string;
+    display: string;
+};
+declare interface IMentionList {
+    display: string;
+    email?: string;
+    uid?: string;
+}
+declare type IMentionedList = Array<IMentionItem>;
+declare interface ICommentState {
+    message: string;
+    toUsers?: Array<IMentionItem>;
+    images?: string[];
+    createdBy: string;
+    author: string;
+}
+declare interface IMessageDTO {
+    _id: string;
+    threadUid: string;
+    message: string;
+    author: string;
+    toUsers?: string[];
+    images?: string[];
+    createdAt: string;
+    createdBy: string;
+}
+declare interface IThreadContext {
+    inviteMetadata: IInviteMetadata;
+    commentCount: number;
+    error: IErrorState;
+    userState: IUserState;
+    onCreateComment: (data: ICommentPayload) => Promise<ICommentResponse>;
+    onEditComment: (data: IEditCommentArgs) => Promise<ICommentResponse>;
+    onDeleteComment: (data: IDeleteCommentArgs) => Promise<IDefaultAPIResponse>;
+    onDeleteThread: (data: IDeleteThreadArgs) => void;
+    setThreadState: (state: IThreadPopupState | ((prevState: IThreadPopupState) => IThreadPopupState)) => void;
+    onClose: (isResolved?: boolean) => void;
+    setError: Function;
+    editComment: string;
+    activeThread: IActiveThread;
+    setActiveThread: (thread: IActiveThread) => void;
+    createNewThread: () => Promise<any>;
+}
+interface IThreadPopupState {
+    commentCount: number;
+    userState: IUserState;
+    isLoading: boolean;
+    comments: Array<IMessageDTO>;
+    editComment: string;
+}
+interface IThreadRenderStatus {
+    threadId: string;
+    attempts: number;
+    isRendered: boolean;
+}
+interface ICommentDTO {
+    _id: string;
+    threadUid: string;
+    message: string;
+    author: string;
+    toUsers: string[];
+    images: string[];
+    createdAt: string;
+    createdBy: string;
+    updatedAt?: string;
+}
+interface IDefaultAPIResponse {
+    notice: string;
+}
+interface ICommentResponse extends IDefaultAPIResponse {
+    comment: ICommentDTO;
+}
+interface IFetchCommentsResponse {
+    comments: Array<ICommentDTO>;
+    count: number;
+}
+interface ICommentPayload {
+    threadUid: string;
+    commentPayload: ICommentState;
+}
+interface IThreadPayload {
+    elementXPath: string;
+    position: {
+        x: number;
+        y: number;
+    };
+    author: string;
+    pageRoute: string;
+    inviteUid: string;
+    createdBy: string;
+}
+interface IThreadDTO {
+    _id: string;
+    author: string;
+    inviteUid: string;
+    position: {
+        x: number;
+        y: number;
+    };
+    elementXPath: string;
+    isElementPresent: boolean;
+    pageRoute: string;
+    createdBy: string;
+    sequenceNumber: number;
+    threadState: number;
+    createdAt: string;
+    updatedAt?: string;
+}
+interface IThreadResponseDTO extends IDefaultAPIResponse {
+    thread: IThreadDTO;
+}
+interface IEditCommentArgs {
+    threadUid: string;
+    commentUid: string;
+    payload: ICommentState;
+}
+interface IDeleteCommentArgs {
+    threadUid: string;
+    commentUid: string;
+}
+interface IDeleteThreadArgs {
+    threadUid: string;
+}
+interface IThreadResolveArgs {
+    threadUid: string;
+    payload: {
+        threadState: number;
+    };
+}
+interface MissingThreadsInfo {
+    payload: {
+        isElementPresent: boolean;
+    };
+    threadUids: string[];
+}
+interface IErrorState {
+    hasError: boolean;
+    message: string;
+}
+interface IActiveThread extends Partial<IThreadDTO> {
+    _id: string;
+}
+interface IFetchComments {
+    threadUid: string;
+    offset: number;
+    limit: number;
+}
+interface toggleCollabPopupEvent {
+    threadUid: string;
+    action: string;
+}
+interface ICommentActionBar {
+    mode: "edit" | "view";
+    commentUser: IUserDTO;
+    currentUser: IUserDTO;
+    commentUID?: string | undefined;
+}
+interface ICommentCard {
+    comment: IMessageDTO | null;
+    onClose: (isResolved?: boolean) => void;
+    userState: IUserState;
+    mode: "edit" | "view";
+    handleOnSaveRef: React.MutableRefObject<any>;
+}
+interface ICommentResolvedText {
+    comment: IMessageDTO;
+    userState: IUserState;
+}
+interface ICommentTextAreaProps {
+    userState: IUserState;
+    onClose: (isResolved?: boolean) => void;
+    handleOnSaveRef: React.MutableRefObject<any>;
+    comment?: IMessageDTO | null;
+}
+interface IThreadPopup {
+    onCreateComment: (data: ICommentPayload) => Promise<ICommentResponse>;
+    onEditComment: (data: IEditCommentArgs) => Promise<ICommentResponse>;
+    onDeleteComment: (data: IDeleteCommentArgs) => Promise<IDefaultAPIResponse>;
+    onDeleteThread: (data: IDeleteThreadArgs) => void;
+    onClose: (isResolved?: boolean) => void;
+    onResolve: (data: IThreadResolveArgs) => Promise<IThreadResponseDTO>;
+    inviteMetadata: IInviteMetadata;
+    loadMoreMessages: (data: IFetchComments) => Promise<IFetchCommentsResponse>;
+    activeThread: IActiveThread;
+    setActiveThread: (thread: IActiveThread) => void;
+    createNewThread: () => Promise<IThreadResponseDTO>;
+}
+interface IThreadBody {
+    handleOnSaveRef: React.MutableRefObject<any>;
+    onClose: (isResolved?: boolean) => void;
+    userState: IUserState;
+    isLoading: boolean;
+    comments: IMessageDTO[];
+    fetchingMore: boolean;
+    editComment: string;
+}
+interface IThreadFooter {
+    onClose: (isResolved?: boolean) => void;
+    handleOnSaveRef: React.MutableRefObject<any>;
+    isDisabled: boolean;
+    editComment: string;
+}
+interface IThreadHeader {
+    onClose: (isResolved?: boolean) => void;
+    displayResolve: boolean;
+    onResolve: (data: IThreadResolveArgs) => Promise<IDefaultAPIResponse>;
+    commentCount: number;
+    activeThread: IActiveThread;
+}
+
+export type { IActiveThread, ICommentActionBar, ICommentCard, ICommentDTO, ICommentPayload, ICommentResolvedText, ICommentResponse, ICommentState, ICommentTextAreaProps, IDefaultAPIResponse, IDeleteCommentArgs, IDeleteThreadArgs, IEditCommentArgs, IErrorState, IFetchComments, IFetchCommentsResponse, IInviteMetadata, IMentionItem, IMentionList, IMentionedList, IMessageDTO, IThreadBody, IThreadContext, IThreadDTO, IThreadFooter, IThreadHeader, IThreadPayload, IThreadPopup, IThreadPopupState, IThreadRenderStatus, IThreadResolveArgs, IThreadResponseDTO, IUserDTO, IUserMap, IUserState, MissingThreadsInfo, toggleCollabPopupEvent };

package/dist/modern/visualBuilder/types/collab.types.d.ts

@@ -0,0 +1,232 @@
+interface IUserDTO {
+    display?: string;
+    email: string;
+    uid: string;
+    firstName?: string | null;
+    lastName?: string | null;
+}
+declare interface IUserState {
+    mentionsList: Array<IMentionList>;
+    userMap: IUserMap;
+    currentUser: IUserDTO;
+}
+declare type IUserMap = {
+    [key: string]: IUserDTO;
+};
+declare interface IInviteMetadata {
+    users: Array<IUserDTO>;
+    currentUser: IUserDTO;
+    inviteUid: string;
+}
+declare type IMentionItem = {
+    id: string;
+    display: string;
+};
+declare interface IMentionList {
+    display: string;
+    email?: string;
+    uid?: string;
+}
+declare type IMentionedList = Array<IMentionItem>;
+declare interface ICommentState {
+    message: string;
+    toUsers?: Array<IMentionItem>;
+    images?: string[];
+    createdBy: string;
+    author: string;
+}
+declare interface IMessageDTO {
+    _id: string;
+    threadUid: string;
+    message: string;
+    author: string;
+    toUsers?: string[];
+    images?: string[];
+    createdAt: string;
+    createdBy: string;
+}
+declare interface IThreadContext {
+    inviteMetadata: IInviteMetadata;
+    commentCount: number;
+    error: IErrorState;
+    userState: IUserState;
+    onCreateComment: (data: ICommentPayload) => Promise<ICommentResponse>;
+    onEditComment: (data: IEditCommentArgs) => Promise<ICommentResponse>;
+    onDeleteComment: (data: IDeleteCommentArgs) => Promise<IDefaultAPIResponse>;
+    onDeleteThread: (data: IDeleteThreadArgs) => void;
+    setThreadState: (state: IThreadPopupState | ((prevState: IThreadPopupState) => IThreadPopupState)) => void;
+    onClose: (isResolved?: boolean) => void;
+    setError: Function;
+    editComment: string;
+    activeThread: IActiveThread;
+    setActiveThread: (thread: IActiveThread) => void;
+    createNewThread: () => Promise<any>;
+}
+interface IThreadPopupState {
+    commentCount: number;
+    userState: IUserState;
+    isLoading: boolean;
+    comments: Array<IMessageDTO>;
+    editComment: string;
+}
+interface IThreadRenderStatus {
+    threadId: string;
+    attempts: number;
+    isRendered: boolean;
+}
+interface ICommentDTO {
+    _id: string;
+    threadUid: string;
+    message: string;
+    author: string;
+    toUsers: string[];
+    images: string[];
+    createdAt: string;
+    createdBy: string;
+    updatedAt?: string;
+}
+interface IDefaultAPIResponse {
+    notice: string;
+}
+interface ICommentResponse extends IDefaultAPIResponse {
+    comment: ICommentDTO;
+}
+interface IFetchCommentsResponse {
+    comments: Array<ICommentDTO>;
+    count: number;
+}
+interface ICommentPayload {
+    threadUid: string;
+    commentPayload: ICommentState;
+}
+interface IThreadPayload {
+    elementXPath: string;
+    position: {
+        x: number;
+        y: number;
+    };
+    author: string;
+    pageRoute: string;
+    inviteUid: string;
+    createdBy: string;
+}
+interface IThreadDTO {
+    _id: string;
+    author: string;
+    inviteUid: string;
+    position: {
+        x: number;
+        y: number;
+    };
+    elementXPath: string;
+    isElementPresent: boolean;
+    pageRoute: string;
+    createdBy: string;
+    sequenceNumber: number;
+    threadState: number;
+    createdAt: string;
+    updatedAt?: string;
+}
+interface IThreadResponseDTO extends IDefaultAPIResponse {
+    thread: IThreadDTO;
+}
+interface IEditCommentArgs {
+    threadUid: string;
+    commentUid: string;
+    payload: ICommentState;
+}
+interface IDeleteCommentArgs {
+    threadUid: string;
+    commentUid: string;
+}
+interface IDeleteThreadArgs {
+    threadUid: string;
+}
+interface IThreadResolveArgs {
+    threadUid: string;
+    payload: {
+        threadState: number;
+    };
+}
+interface MissingThreadsInfo {
+    payload: {
+        isElementPresent: boolean;
+    };
+    threadUids: string[];
+}
+interface IErrorState {
+    hasError: boolean;
+    message: string;
+}
+interface IActiveThread extends Partial<IThreadDTO> {
+    _id: string;
+}
+interface IFetchComments {
+    threadUid: string;
+    offset: number;
+    limit: number;
+}
+interface toggleCollabPopupEvent {
+    threadUid: string;
+    action: string;
+}
+interface ICommentActionBar {
+    mode: "edit" | "view";
+    commentUser: IUserDTO;
+    currentUser: IUserDTO;
+    commentUID?: string | undefined;
+}
+interface ICommentCard {
+    comment: IMessageDTO | null;
+    onClose: (isResolved?: boolean) => void;
+    userState: IUserState;
+    mode: "edit" | "view";
+    handleOnSaveRef: React.MutableRefObject<any>;
+}
+interface ICommentResolvedText {
+    comment: IMessageDTO;
+    userState: IUserState;
+}
+interface ICommentTextAreaProps {
+    userState: IUserState;
+    onClose: (isResolved?: boolean) => void;
+    handleOnSaveRef: React.MutableRefObject<any>;
+    comment?: IMessageDTO | null;
+}
+interface IThreadPopup {
+    onCreateComment: (data: ICommentPayload) => Promise<ICommentResponse>;
+    onEditComment: (data: IEditCommentArgs) => Promise<ICommentResponse>;
+    onDeleteComment: (data: IDeleteCommentArgs) => Promise<IDefaultAPIResponse>;
+    onDeleteThread: (data: IDeleteThreadArgs) => void;
+    onClose: (isResolved?: boolean) => void;
+    onResolve: (data: IThreadResolveArgs) => Promise<IThreadResponseDTO>;
+    inviteMetadata: IInviteMetadata;
+    loadMoreMessages: (data: IFetchComments) => Promise<IFetchCommentsResponse>;
+    activeThread: IActiveThread;
+    setActiveThread: (thread: IActiveThread) => void;
+    createNewThread: () => Promise<IThreadResponseDTO>;
+}
+interface IThreadBody {
+    handleOnSaveRef: React.MutableRefObject<any>;
+    onClose: (isResolved?: boolean) => void;
+    userState: IUserState;
+    isLoading: boolean;
+    comments: IMessageDTO[];
+    fetchingMore: boolean;
+    editComment: string;
+}
+interface IThreadFooter {
+    onClose: (isResolved?: boolean) => void;
+    handleOnSaveRef: React.MutableRefObject<any>;
+    isDisabled: boolean;
+    editComment: string;
+}
+interface IThreadHeader {
+    onClose: (isResolved?: boolean) => void;
+    displayResolve: boolean;
+    onResolve: (data: IThreadResolveArgs) => Promise<IDefaultAPIResponse>;
+    commentCount: number;
+    activeThread: IActiveThread;
+}
+
+export type { IActiveThread, ICommentActionBar, ICommentCard, ICommentDTO, ICommentPayload, ICommentResolvedText, ICommentResponse, ICommentState, ICommentTextAreaProps, IDefaultAPIResponse, IDeleteCommentArgs, IDeleteThreadArgs, IEditCommentArgs, IErrorState, IFetchComments, IFetchCommentsResponse, IInviteMetadata, IMentionItem, IMentionList, IMentionedList, IMessageDTO, IThreadBody, IThreadContext, IThreadDTO, IThreadFooter, IThreadHeader, IThreadPayload, IThreadPopup, IThreadPopupState, IThreadRenderStatus, IThreadResolveArgs, IThreadResponseDTO, IUserDTO, IUserMap, IUserState, MissingThreadsInfo, toggleCollabPopupEvent };

package/dist/modern/visualBuilder/types/collab.types.js

@@ -0,0 +1 @@
+//# sourceMappingURL=collab.types.js.map

package/dist/modern/visualBuilder/types/collab.types.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/modern/visualBuilder/utils/collabUtils.cjs

@@ -0,0 +1,116 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/visualBuilder/utils/collabUtils.ts
+var collabUtils_exports = {};
+__export(collabUtils_exports, {
+  filterOutInvalidMentions: () => filterOutInvalidMentions,
+  getCommentBody: () => getCommentBody,
+  getMessageWithDisplayName: () => getMessageWithDisplayName,
+  getThreadTitle: () => getThreadTitle,
+  getUserName: () => getUserName,
+  sanitizeData: () => sanitizeData,
+  validateCommentAndMentions: () => validateCommentAndMentions
+});
+module.exports = __toCommonJS(collabUtils_exports);
+var import_constants = require("./constants.cjs");
+var import_lodash_es = require("lodash-es");
+var import_dompurify = __toESM(require("dompurify"), 1);
+var escapeRegExp = (string) => {
+  return string.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+};
+var getThreadTitle = (commentCount) => {
+  if (commentCount === 0) return "Add New Comment";
+  return commentCount === 1 ? "1 Comment" : `${commentCount} Comments`;
+};
+var getUserName = (user) => {
+  return user.firstName && user.lastName ? `${user.firstName} ${user.lastName}` : user.firstName || user.lastName || user.email;
+};
+var validateCommentAndMentions = (comment, toUsers) => {
+  if (comment.length > import_constants.maxMessageLength) {
+    return `Limit exceeded. You can have a maximum length of ${import_constants.maxMessageLength} characters.`;
+  }
+  if (toUsers.length > import_constants.mentionLimit) {
+    return `Limit exceeded. You can tag a maximum of ${import_constants.mentionLimit} users.`;
+  }
+  return "";
+};
+var filterOutInvalidMentions = (message, toUsers) => {
+  const to_users_temp = toUsers.filter(
+    (user) => message.includes(user.display)
+  );
+  return {
+    toUsers: (0, import_lodash_es.uniqBy)(to_users_temp, "id")
+  };
+};
+var getMessageWithDisplayName = (comment, userState, profile) => {
+  if (!comment) return void 0;
+  let tempText = comment.message;
+  comment?.toUsers?.forEach((user) => {
+    const userPattern = new RegExp(`{{${user}}}`, "g");
+    const userData = userState.userMap[user];
+    const replacement = profile === "html" ? `<b class="collab-thread-comment--message">@${userData.display || getUserName(userData)}</b>` : `@${userData.display || getUserName(userData)}`;
+    tempText = tempText.replace(userPattern, replacement);
+  });
+  return tempText;
+};
+var sanitizeData = (dirty) => {
+  return import_dompurify.default.sanitize(dirty, { USE_PROFILES: { html: true } });
+};
+var getCommentBody = (state) => {
+  let finalMessage = state.message.replace(/[^\S\r\n]+/g, " ").replace(/ *\n */g, "\n").trim();
+  const comment = {
+    message: finalMessage,
+    toUsers: [],
+    images: [],
+    createdBy: state.createdBy,
+    author: state.author
+  };
+  const updateMentionToUID = (entity, result) => {
+    const displayName = entity.display;
+    const escapedDisplayName = escapeRegExp(`@${displayName}`);
+    const regexUser = new RegExp(escapedDisplayName, "g");
+    finalMessage = finalMessage.replace(regexUser, `{{${entity.id}}}`);
+    result.push(entity.id);
+  };
+  state.toUsers?.forEach((user) => updateMentionToUID(user, comment.toUsers));
+  comment.message = finalMessage;
+  return comment;
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  filterOutInvalidMentions,
+  getCommentBody,
+  getMessageWithDisplayName,
+  getThreadTitle,
+  getUserName,
+  sanitizeData,
+  validateCommentAndMentions
+});
+//# sourceMappingURL=collabUtils.cjs.map

package/dist/modern/visualBuilder/utils/collabUtils.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/visualBuilder/utils/collabUtils.ts"],"sourcesContent":["import {\n    ICommentState,\n    IMentionedList,\n    IMentionItem,\n    IMessageDTO,\n    IUserDTO,\n    IUserState,\n} from \"../types/collab.types\";\nimport { maxMessageLength, mentionLimit } from \"./constants\";\nimport { uniqBy } from \"lodash-es\";\nimport DOMPurify from \"dompurify\";\n\nconst escapeRegExp = (string: string): string => {\n    return string.replace(/[.*+?^${}()|[\\]\\\\]/g, \"\\\\$&\");\n};\n\n/**\n * Generates the title for the thread based on the number of comments.\n * @param {number} commentCount - The number of comments.\n * @returns {string} The title for the thread.\n */\nexport const getThreadTitle = (commentCount: number): string => {\n    if (commentCount === 0) return \"Add New Comment\";\n    return commentCount === 1 ? \"1 Comment\" : `${commentCount} Comments`;\n};\n\n/**\n * returns the available email.\n * @param {IUserDTO} user - The user object.\n * @returns {string} The user's email.\n */\nexport const getUserName = (user: IUserDTO): string => {\n    return user.firstName && user.lastName\n        ? `${user.firstName} ${user.lastName}`\n        : user.firstName || user.lastName || user.email;\n};\n\n/**\n * Validates the comment length and the number of mentions.\n * @param {string} comment - The comment message.\n * @param {IMentionedList} toUsers - The list of mentioned users.\n * @returns {string} The error message if validation fails, otherwise an empty string.\n */\nexport const validateCommentAndMentions = (\n    comment: string,\n    toUsers: IMentionedList\n): string => {\n    if (comment.length > maxMessageLength) {\n        return `Limit exceeded. You can have a maximum length of ${maxMessageLength} characters.`;\n    }\n    if (toUsers.length > mentionLimit) {\n        return `Limit exceeded. You can tag a maximum of ${mentionLimit} users.`;\n    }\n    return \"\";\n};\n\n/**\n * Removes mentions that no longer exist in the message.\n * @param {string} message - The comment message.\n * @param {IMentionedList} toUsers - The list of mentioned users.\n * @returns {Object} The updated lists of mentioned users.\n */\nexport const filterOutInvalidMentions = (\n    message: string,\n    toUsers: IMentionedList\n) => {\n    const to_users_temp = toUsers.filter((user) =>\n        message.includes(user.display)\n    );\n\n    return {\n        toUsers: uniqBy(to_users_temp, \"id\"),\n    };\n};\n\n/**\n * Replaces mention placeholders with display names in the comment message.\n * @param {IMessageDTO | undefined} comment - The comment object.\n * @param {IUserState} userState - The user state containing user and role maps.\n * @param {\"text\" | \"html\"} profile - The format for the output message, either plain text or HTML.\n * @returns {string | undefined} The formatted message or undefined if the comment is not provided.\n */\nexport const getMessageWithDisplayName = (\n    comment: IMessageDTO | undefined | null,\n    userState: IUserState,\n    profile: \"text\" | \"html\"\n): string | undefined => {\n    if (!comment) return undefined;\n\n    let tempText = comment.message;\n\n    comment?.toUsers?.forEach((user) => {\n        const userPattern = new RegExp(`{{${user}}}`, \"g\");\n        const userData = userState.userMap[user];\n        const replacement =\n            profile === \"html\"\n                ? `<b class=\"collab-thread-comment--message\">@${userData.display || getUserName(userData)}</b>`\n                : `@${userData.display || getUserName(userData)}`;\n        tempText = tempText.replace(userPattern, replacement);\n    });\n\n    return tempText;\n};\n\n/**\n * Sanitizes HTML content to prevent XSS attacks.\n * @param {any} dirty - The unsanitized HTML content.\n * @returns {string} The sanitized HTML content.\n */\nexport const sanitizeData = (dirty: any): string => {\n    return DOMPurify.sanitize(dirty, { USE_PROFILES: { html: true } });\n};\n\n/**\n * Constructs the comment body with mentions replaced by their unique identifiers.\n * @param {ICommentState} state - The state containing the comment and mentions.\n * @returns {Object} The comment body containing the sanitized message and mentioned users.\n */\nexport const getCommentBody = (state: ICommentState): ICommentState => {\n    let finalMessage = state.message\n        .replace(/[^\\S\\r\\n]+/g, \" \")\n        .replace(/ *\\n */g, \"\\n\")\n        .trim();\n\n    const comment = {\n        message: finalMessage,\n        toUsers: [],\n        images: [],\n        createdBy: state.createdBy,\n        author: state.author,\n    };\n\n    const updateMentionToUID = (\n        entity: IMentionItem,\n        result: Array<string>\n    ) => {\n        const displayName = entity.display;\n\n        const escapedDisplayName = escapeRegExp(`@${displayName}`);\n        const regexUser = new RegExp(escapedDisplayName, \"g\");\n        finalMessage = finalMessage.replace(regexUser, `{{${entity.id}}}`);\n        result.push(entity.id);\n    };\n\n    state.toUsers?.forEach((user) => updateMentionToUID(user, comment.toUsers));\n\n    comment.message = finalMessage;\n    return comment;\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAQA,uBAA+C;AAC/C,uBAAuB;AACvB,uBAAsB;AAEtB,IAAM,eAAe,CAAC,WAA2B;AAC7C,SAAO,OAAO,QAAQ,uBAAuB,MAAM;AACvD;AAOO,IAAM,iBAAiB,CAAC,iBAAiC;AAC5D,MAAI,iBAAiB,EAAG,QAAO;AAC/B,SAAO,iBAAiB,IAAI,cAAc,GAAG,YAAY;AAC7D;AAOO,IAAM,cAAc,CAAC,SAA2B;AACnD,SAAO,KAAK,aAAa,KAAK,WACxB,GAAG,KAAK,SAAS,IAAI,KAAK,QAAQ,KAClC,KAAK,aAAa,KAAK,YAAY,KAAK;AAClD;AAQO,IAAM,6BAA6B,CACtC,SACA,YACS;AACT,MAAI,QAAQ,SAAS,mCAAkB;AACnC,WAAO,oDAAoD,iCAAgB;AAAA,EAC/E;AACA,MAAI,QAAQ,SAAS,+BAAc;AAC/B,WAAO,4CAA4C,6BAAY;AAAA,EACnE;AACA,SAAO;AACX;AAQO,IAAM,2BAA2B,CACpC,SACA,YACC;AACD,QAAM,gBAAgB,QAAQ;AAAA,IAAO,CAAC,SAClC,QAAQ,SAAS,KAAK,OAAO;AAAA,EACjC;AAEA,SAAO;AAAA,IACH,aAAS,yBAAO,eAAe,IAAI;AAAA,EACvC;AACJ;AASO,IAAM,4BAA4B,CACrC,SACA,WACA,YACqB;AACrB,MAAI,CAAC,QAAS,QAAO;AAErB,MAAI,WAAW,QAAQ;AAEvB,WAAS,SAAS,QAAQ,CAAC,SAAS;AAChC,UAAM,cAAc,IAAI,OAAO,KAAK,IAAI,MAAM,GAAG;AACjD,UAAM,WAAW,UAAU,QAAQ,IAAI;AACvC,UAAM,cACF,YAAY,SACN,8CAA8C,SAAS,WAAW,YAAY,QAAQ,CAAC,SACvF,IAAI,SAAS,WAAW,YAAY,QAAQ,CAAC;AACvD,eAAW,SAAS,QAAQ,aAAa,WAAW;AAAA,EACxD,CAAC;AAED,SAAO;AACX;AAOO,IAAM,eAAe,CAAC,UAAuB;AAChD,SAAO,iBAAAA,QAAU,SAAS,OAAO,EAAE,cAAc,EAAE,MAAM,KAAK,EAAE,CAAC;AACrE;AAOO,IAAM,iBAAiB,CAAC,UAAwC;AACnE,MAAI,eAAe,MAAM,QACpB,QAAQ,eAAe,GAAG,EAC1B,QAAQ,WAAW,IAAI,EACvB,KAAK;AAEV,QAAM,UAAU;AAAA,IACZ,SAAS;AAAA,IACT,SAAS,CAAC;AAAA,IACV,QAAQ,CAAC;AAAA,IACT,WAAW,MAAM;AAAA,IACjB,QAAQ,MAAM;AAAA,EAClB;AAEA,QAAM,qBAAqB,CACvB,QACA,WACC;AACD,UAAM,cAAc,OAAO;AAE3B,UAAM,qBAAqB,aAAa,IAAI,WAAW,EAAE;AACzD,UAAM,YAAY,IAAI,OAAO,oBAAoB,GAAG;AACpD,mBAAe,aAAa,QAAQ,WAAW,KAAK,OAAO,EAAE,IAAI;AACjE,WAAO,KAAK,OAAO,EAAE;AAAA,EACzB;AAEA,QAAM,SAAS,QAAQ,CAAC,SAAS,mBAAmB,MAAM,QAAQ,OAAO,CAAC;AAE1E,UAAQ,UAAU;AAClB,SAAO;AACX;","names":["DOMPurify"]}

package/dist/modern/visualBuilder/utils/collabUtils.d.cts

@@ -0,0 +1,52 @@
+import { IUserDTO, IMentionedList, IMentionItem, IMessageDTO, IUserState, ICommentState } from '../types/collab.types.cjs';
+
+/**
+ * Generates the title for the thread based on the number of comments.
+ * @param {number} commentCount - The number of comments.
+ * @returns {string} The title for the thread.
+ */
+declare const getThreadTitle: (commentCount: number) => string;
+/**
+ * returns the available email.
+ * @param {IUserDTO} user - The user object.
+ * @returns {string} The user's email.
+ */
+declare const getUserName: (user: IUserDTO) => string;
+/**
+ * Validates the comment length and the number of mentions.
+ * @param {string} comment - The comment message.
+ * @param {IMentionedList} toUsers - The list of mentioned users.
+ * @returns {string} The error message if validation fails, otherwise an empty string.
+ */
+declare const validateCommentAndMentions: (comment: string, toUsers: IMentionedList) => string;
+/**
+ * Removes mentions that no longer exist in the message.
+ * @param {string} message - The comment message.
+ * @param {IMentionedList} toUsers - The list of mentioned users.
+ * @returns {Object} The updated lists of mentioned users.
+ */
+declare const filterOutInvalidMentions: (message: string, toUsers: IMentionedList) => {
+    toUsers: IMentionItem[];
+};
+/**
+ * Replaces mention placeholders with display names in the comment message.
+ * @param {IMessageDTO | undefined} comment - The comment object.
+ * @param {IUserState} userState - The user state containing user and role maps.
+ * @param {"text" | "html"} profile - The format for the output message, either plain text or HTML.
+ * @returns {string | undefined} The formatted message or undefined if the comment is not provided.
+ */
+declare const getMessageWithDisplayName: (comment: IMessageDTO | undefined | null, userState: IUserState, profile: "text" | "html") => string | undefined;
+/**
+ * Sanitizes HTML content to prevent XSS attacks.
+ * @param {any} dirty - The unsanitized HTML content.
+ * @returns {string} The sanitized HTML content.
+ */
+declare const sanitizeData: (dirty: any) => string;
+/**
+ * Constructs the comment body with mentions replaced by their unique identifiers.
+ * @param {ICommentState} state - The state containing the comment and mentions.
+ * @returns {Object} The comment body containing the sanitized message and mentioned users.
+ */
+declare const getCommentBody: (state: ICommentState) => ICommentState;
+
+export { filterOutInvalidMentions, getCommentBody, getMessageWithDisplayName, getThreadTitle, getUserName, sanitizeData, validateCommentAndMentions };