@microsoft/omnichannel-chat-widget 0.1.0-main.02fa07b

package/lib/esm/components/emailtranscriptpanestateful/EmailTranscriptPaneStateful.js

@@ -0,0 +1,106 @@
+import { LogLevel, TelemetryEvent } from "../../common/telemetry/TelemetryConstants";
+import React, { useEffect, useState } from "react";
+import { findAllFocusableElement, findParentFocusableElementsWithoutChildContainer, preventFocusToMoveOutOfElement, setFocusOnElement, setFocusOnSendBox, setTabIndices } from "../../common/utils";
+import { DimLayer } from "../dimlayer/DimLayer";
+import { InputValidationPane } from "@microsoft/omnichannel-chat-components";
+import { LiveChatWidgetActionType } from "../../contexts/common/LiveChatWidgetActionType";
+import { NotificationHandler } from "../webchatcontainerstateful/webchatcontroller/notification/NotificationHandler";
+import { NotificationScenarios } from "../webchatcontainerstateful/webchatcontroller/enums/NotificationScenarios";
+import { Regex } from "../../common/Constants";
+import { TelemetryHelper } from "../../common/telemetry/TelemetryHelper";
+import useChatContextStore from "../../hooks/useChatContextStore";
+import useChatSDKStore from "../../hooks/useChatSDKStore";
+export const EmailTranscriptPaneStateful = props => {
+  var _props$controlProps;
+
+  const initialTabIndexMap = new Map();
+  let elements = [];
+  const [state, dispatch] = useChatContextStore(); // eslint-disable-next-line @typescript-eslint/no-explicit-any
+
+  const chatSDK = useChatSDKStore();
+  const [initialEmail, setInitialEmail] = useState("");
+
+  const closeEmailTranscriptPane = () => {
+    dispatch({
+      type: LiveChatWidgetActionType.SET_SHOW_EMAIL_TRANSCRIPT_PANE,
+      payload: false
+    });
+    const previousFocused = state.appStates.previousElementOnFocusBeforeModalOpen;
+
+    if (previousFocused) {
+      setFocusOnElement(previousFocused);
+    } else {
+      setFocusOnSendBox();
+    }
+
+    dispatch({
+      type: LiveChatWidgetActionType.SET_PREVIOUS_FOCUSED_ELEMENT,
+      payload: null
+    });
+    setTabIndices(elements, initialTabIndexMap, true);
+  };
+
+  const controlProps = {
+    id: "oclcw-emailTranscriptDialogContainer",
+    dir: state.domainStates.globalDir,
+    onSend: async email => {
+      closeEmailTranscriptPane();
+      const chatTranscriptBody = {
+        emailAddress: email,
+        attachmentMessage: (props === null || props === void 0 ? void 0 : props.attachmentMessage) ?? "The following attachment was uploaded during the conversation:"
+      };
+
+      try {
+        await (chatSDK === null || chatSDK === void 0 ? void 0 : chatSDK.emailLiveChatTranscript(chatTranscriptBody));
+        TelemetryHelper.logActionEvent(LogLevel.INFO, {
+          Event: TelemetryEvent.EmailTranscriptSent,
+          Description: "Transcript sent to email successfully."
+        });
+      } catch (ex) {
+        TelemetryHelper.logActionEvent(LogLevel.ERROR, {
+          Event: TelemetryEvent.EmailTranscriptFailed,
+          ExceptionDetails: {
+            exception: ex
+          }
+        });
+        NotificationHandler.notifyError(NotificationScenarios.EmailTranscriptError, (props === null || props === void 0 ? void 0 : props.bannerMessageOnError) ?? "Email transcript to " + email + " failed.");
+      }
+    },
+    onCancel: () => {
+      TelemetryHelper.logActionEvent(LogLevel.INFO, {
+        Event: TelemetryEvent.EmailTranscriptCancelButtonClicked,
+        Description: "Email Transcript cancel button clicked."
+      });
+      closeEmailTranscriptPane();
+    },
+    checkInput: function (input) {
+      return new RegExp(Regex.EmailRegex).test(input);
+    },
+    ...props.controlProps,
+    inputInitialText: ((_props$controlProps = props.controlProps) === null || _props$controlProps === void 0 ? void 0 : _props$controlProps.inputInitialText) ?? initialEmail
+  }; // Move focus to the first button
+
+  useEffect(() => {
+    preventFocusToMoveOutOfElement(controlProps.id);
+    const focusableElements = findAllFocusableElement(`#${controlProps.id}`);
+
+    if (focusableElements) {
+      focusableElements[0].focus();
+    }
+
+    elements = findParentFocusableElementsWithoutChildContainer(controlProps.id);
+    setTabIndices(elements, initialTabIndexMap, false);
+    setInitialEmail(state.appStates.preChatResponseEmail);
+    TelemetryHelper.logLoadingEvent(LogLevel.INFO, {
+      Event: TelemetryEvent.EmailTranscriptLoaded
+    });
+  }, [initialEmail]);
+  return /*#__PURE__*/React.createElement(React.Fragment, null, !(controlProps !== null && controlProps !== void 0 && controlProps.disableDimLayer) && /*#__PURE__*/React.createElement(DimLayer, {
+    brightness: (controlProps === null || controlProps === void 0 ? void 0 : controlProps.brightnessValueOnDim) ?? "0.2"
+  }), /*#__PURE__*/React.createElement(InputValidationPane, {
+    componentOverrides: props.componentOverrides,
+    controlProps: controlProps,
+    styleProps: props.styleProps
+  }));
+};
+export default EmailTranscriptPaneStateful;

package/lib/esm/components/emailtranscriptpanestateful/EmailTranscriptPaneStateful.spec.js

@@ -0,0 +1,69 @@
+import { OmnichannelChatSDK } from "@microsoft/omnichannel-chat-sdk";
+import { cleanup } from "@testing-library/react";
+jest.mock("@microsoft/omnichannel-chat-sdk");
+describe("EmailTranscriptPaneStateful unit test", () => {
+  afterEach(() => {
+    cleanup;
+    jest.resetAllMocks();
+  });
+  it("Method emailLiveChatTranscript is called", async () => {
+    const omnichannelConfig = {
+      orgUrl: "",
+      orgId: "",
+      widgetId: ""
+    };
+    const chatSDK = new OmnichannelChatSDK(omnichannelConfig);
+    jest.spyOn(chatSDK, "emailLiveChatTranscript").mockResolvedValue(Promise.resolve());
+    const chatTranscriptBody = {
+      emailAddress: "sample@microsoft.com",
+      attachmentMessage: "sample",
+      locale: "sample"
+    };
+
+    try {
+      await chatSDK.emailLiveChatTranscript(chatTranscriptBody);
+      expect(chatSDK.emailLiveChatTranscript).toHaveBeenCalledTimes(1); // eslint-disable-next-line no-empty
+    } catch (ex) {}
+  });
+  it("Method emailLiveChatTranscript throws exception", async () => {
+    const errorMessage = "Error";
+    const omnichannelConfig = {
+      orgUrl: "",
+      orgId: "",
+      widgetId: ""
+    };
+    const chatSDK = new OmnichannelChatSDK(omnichannelConfig);
+    jest.spyOn(chatSDK, "emailLiveChatTranscript").mockRejectedValue(new Error(errorMessage));
+    const chatTranscriptBody = {
+      emailAddress: "sample@microsoft.com",
+      attachmentMessage: "sample",
+      locale: "sample"
+    };
+
+    try {
+      await chatSDK.emailLiveChatTranscript(chatTranscriptBody); // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    } catch (ex) {
+      expect(ex.message).toEqual(errorMessage);
+    }
+  });
+  it("Method emailLiveChatTranscript undefined throws exception", async () => {
+    const errorMessage = "Error";
+    const omnichannelConfig = {
+      orgUrl: "",
+      orgId: "",
+      widgetId: ""
+    };
+    const chatSDK = new OmnichannelChatSDK(omnichannelConfig);
+    const chatTranscriptBody = {
+      emailAddress: "sample@microsoft.com",
+      attachmentMessage: "sample",
+      locale: "sample"
+    };
+
+    try {
+      await chatSDK.emailLiveChatTranscript(chatTranscriptBody); // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    } catch (ex) {
+      expect(ex.message).toEqual(errorMessage);
+    }
+  });
+});

package/lib/esm/components/emailtranscriptpanestateful/interfaces/IChatTranscriptBody.js

@@ -0,0 +1 @@
+export {};

package/lib/esm/components/emailtranscriptpanestateful/interfaces/IEmailTranscriptPaneProps.js

@@ -0,0 +1 @@
+export {};

package/lib/esm/components/footerstateful/FooterStateful.js

@@ -0,0 +1,103 @@
+import { LogLevel, TelemetryEvent } from "../../common/telemetry/TelemetryConstants";
+import React from "react";
+import AudioNotificationStateful from "./audionotificationstateful/AudioNotificationStateful";
+import { Constants } from "../../common/Constants";
+import { Footer } from "@microsoft/omnichannel-chat-components";
+import { LiveChatWidgetActionType } from "../../contexts/common/LiveChatWidgetActionType";
+import { NewMessageNotificationSoundBase64 } from "../../assets/Audios";
+import { NotificationHandler } from "../webchatcontainerstateful/webchatcontroller/notification/NotificationHandler";
+import { NotificationScenarios } from "../webchatcontainerstateful/webchatcontroller/enums/NotificationScenarios";
+import { TelemetryHelper } from "../../common/telemetry/TelemetryHelper";
+import { downloadTranscript } from "./downloadtranscriptstateful/DownloadTranscriptStateful";
+import useChatContextStore from "../../hooks/useChatContextStore";
+import useChatSDKStore from "../../hooks/useChatSDKStore"; // eslint-disable-next-line @typescript-eslint/no-explicit-any
+
+export const FooterStateful = props => {
+  var _footerProps$controlP3, _footerProps$controlP4;
+
+  const [state, dispatch] = useChatContextStore(); // hideFooterDisplay - the purpose of this is to keep the footer always "active", 
+  // but hide it visually in certain states (e.g., loading state) and show in some other states (e.g. active state).
+  // The reason for this approach is to make sure that state variables for audio notification work correctly after minimizing
+
+  const {
+    footerProps,
+    downloadTranscriptProps,
+    audioNotificationProps,
+    hideFooterDisplay
+  } = props; // eslint-disable-next-line @typescript-eslint/no-explicit-any
+
+  const chatSDK = useChatSDKStore();
+  const controlProps = {
+    id: "oc-lcw-footer",
+    dir: state.domainStates.globalDir,
+    onDownloadTranscriptClick: async () => {
+      try {
+        TelemetryHelper.logActionEvent(LogLevel.INFO, {
+          Event: TelemetryEvent.DownloadTranscriptButtonClicked,
+          Description: "Download Transcript button clicked."
+        });
+        await downloadTranscript(chatSDK, downloadTranscriptProps === null || downloadTranscriptProps === void 0 ? void 0 : downloadTranscriptProps.renderMarkDown, downloadTranscriptProps === null || downloadTranscriptProps === void 0 ? void 0 : downloadTranscriptProps.bannerMessageOnError, downloadTranscriptProps === null || downloadTranscriptProps === void 0 ? void 0 : downloadTranscriptProps.attachmentMessage);
+      } catch (ex) {
+        TelemetryHelper.logActionEvent(LogLevel.ERROR, {
+          Event: TelemetryEvent.DownloadTranscriptFailed,
+          ExceptionDetails: {
+            exception: ex
+          }
+        });
+        NotificationHandler.notifyError(NotificationScenarios.DownloadTranscriptError, (downloadTranscriptProps === null || downloadTranscriptProps === void 0 ? void 0 : downloadTranscriptProps.bannerMessageOnError) ?? Constants.defaultDownloadTranscriptError);
+      }
+    },
+    onEmailTranscriptClick: () => {
+      var _footerProps$controlP, _footerProps$controlP2;
+
+      TelemetryHelper.logActionEvent(LogLevel.INFO, {
+        Event: TelemetryEvent.EmailTranscriptButtonClicked,
+        Description: "Email Transcript button clicked."
+      });
+      const emailTranscriptButtonId = (footerProps === null || footerProps === void 0 ? void 0 : (_footerProps$controlP = footerProps.controlProps) === null || _footerProps$controlP === void 0 ? void 0 : (_footerProps$controlP2 = _footerProps$controlP.emailTranscriptButtonProps) === null || _footerProps$controlP2 === void 0 ? void 0 : _footerProps$controlP2.id) ?? "oc-lcw-footer-emailtranscript-button";
+      const emailTranscriptButton = document.getElementById(emailTranscriptButtonId);
+
+      if (emailTranscriptButton) {
+        dispatch({
+          type: LiveChatWidgetActionType.SET_PREVIOUS_FOCUSED_ELEMENT,
+          payload: emailTranscriptButton
+        });
+      }
+
+      dispatch({
+        type: LiveChatWidgetActionType.SET_SHOW_EMAIL_TRANSCRIPT_PANE,
+        payload: true
+      });
+    },
+    onAudioNotificationClick: () => {
+      TelemetryHelper.logActionEvent(LogLevel.INFO, {
+        Event: TelemetryEvent.AudioToggleButtonClicked,
+        Description: "Audio button clicked."
+      });
+      dispatch({
+        type: LiveChatWidgetActionType.SET_AUDIO_NOTIFICATION,
+        payload: !state.appStates.isAudioMuted
+      });
+    },
+    ...(footerProps === null || footerProps === void 0 ? void 0 : footerProps.controlProps),
+    audioNotificationButtonProps: { ...(footerProps === null || footerProps === void 0 ? void 0 : (_footerProps$controlP3 = footerProps.controlProps) === null || _footerProps$controlP3 === void 0 ? void 0 : _footerProps$controlP3.audioNotificationButtonProps),
+      isAudioMuted: state.appStates.isAudioMuted
+    }
+  };
+  const footerId = (controlProps === null || controlProps === void 0 ? void 0 : controlProps.id) ?? "oc-lcw-footer";
+  const footer = document.getElementById(footerId);
+
+  if (footer) {
+    footer.style.display = hideFooterDisplay ? "none" : "";
+  }
+
+  return /*#__PURE__*/React.createElement(React.Fragment, null, /*#__PURE__*/React.createElement(Footer, {
+    componentOverrides: footerProps === null || footerProps === void 0 ? void 0 : footerProps.componentOverrides,
+    controlProps: controlProps,
+    styleProps: footerProps === null || footerProps === void 0 ? void 0 : footerProps.styleProps
+  }), /*#__PURE__*/React.createElement(AudioNotificationStateful, {
+    audioSrc: (audioNotificationProps === null || audioNotificationProps === void 0 ? void 0 : audioNotificationProps.audioSrc) ?? NewMessageNotificationSoundBase64,
+    isAudioMuted: state.appStates.isAudioMuted === null ? (footerProps === null || footerProps === void 0 ? void 0 : (_footerProps$controlP4 = footerProps.controlProps) === null || _footerProps$controlP4 === void 0 ? void 0 : _footerProps$controlP4.hideAudioNotificationButton) ?? false : state.appStates.isAudioMuted ?? false
+  }));
+};
+export default FooterStateful;

package/lib/esm/components/footerstateful/audionotificationstateful/AudioNotificationStateful.js

@@ -0,0 +1,20 @@
+import React, { useEffect, useRef } from "react";
+import { BroadcastService } from "@microsoft/omnichannel-chat-components";
+export const AudioNotificationStateful = props => {
+  const {
+    audioSrc,
+    isAudioMuted
+  } = props;
+  const audioRef = useRef(new Audio(audioSrc));
+  useEffect(() => {
+    // eslint-disable-next-line @typescript-eslint/no-unused-vars, @typescript-eslint/no-explicit-any
+    BroadcastService.getMessageByEventName("NewMessageNotification").subscribe(msg => {
+      audioRef.current.play();
+    });
+  }, []);
+  useEffect(() => {
+    isAudioMuted ? audioRef.current.muted = true : audioRef.current.muted = false;
+  }, [isAudioMuted]);
+  return /*#__PURE__*/React.createElement(React.Fragment, null);
+};
+export default AudioNotificationStateful;

package/lib/esm/components/footerstateful/audionotificationstateful/interfaces/IAudioNotificationProps.js

@@ -0,0 +1 @@
+export {};

package/lib/esm/components/footerstateful/audionotificationstateful/interfaces/IAudioNotificationStatefulParams.js

@@ -0,0 +1 @@
+export {};

package/lib/esm/components/footerstateful/downloadtranscriptstateful/DownloadTranscriptStateful.js

@@ -0,0 +1,208 @@
+import { Constants, HtmlAttributeNames, TranscriptConstants } from "../../../common/Constants";
+import { NotificationScenarios } from "../../webchatcontainerstateful/webchatcontroller/enums/NotificationScenarios";
+import { NotificationHandler } from "../../webchatcontainerstateful/webchatcontroller/notification/NotificationHandler";
+import { TelemetryHelper } from "../../../common/telemetry/TelemetryHelper";
+import { LogLevel, TelemetryEvent } from "../../../common/telemetry/TelemetryConstants";
+
+const processDisplayName = displayName => {
+  // if displayname matches "teamsvisitor:<some alphanumeric string>", we replace it with "Customer"
+  const displayNameRegex = ".+:.+";
+  const matchedTeamsDisplayName = displayName.match(displayNameRegex);
+
+  if (displayName.indexOf("teamsvisitor") >= 0 && matchedTeamsDisplayName && matchedTeamsDisplayName.length > 0) {
+    displayName = "Customer";
+  }
+
+  return displayName;
+};
+
+const constructIconName = displayName => {
+  if (!displayName) {
+    return "";
+  }
+
+  let iconName = "C";
+  const displayNameSplit = displayName.split(" ");
+
+  if (displayNameSplit.length > 1) {
+    // get the first letter of name and surname
+    iconName = displayNameSplit[0][0] + displayNameSplit[1][0];
+  } else if (displayNameSplit.length == 1) {
+    // get the first letter of name
+    iconName = displayNameSplit[0][0];
+  }
+
+  return iconName;
+};
+
+const processCreatedDateTime = (createdDateTime, chatCount) => {
+  const formattedDate = new Date(createdDateTime); // TODO: Localization:
+
+  const formattedTimeString = formattedDate.toLocaleTimeString("en-us"
+  /* Bootstrapper.LiveChatConfiguration.chatWidgetLocale */
+  , {
+    hour: "2-digit",
+    minute: "2-digit"
+  });
+  const formattedSplitTimeString = formattedTimeString.split(" ");
+  let finalizedTimeString = "";
+
+  if (formattedSplitTimeString && formattedSplitTimeString.length > 1) {
+    finalizedTimeString = formattedSplitTimeString[0] + " " + formattedSplitTimeString[1];
+  }
+
+  if (chatCount == 0) {
+    return formattedDate.toLocaleDateString("en-us") + " " + finalizedTimeString;
+  }
+
+  return finalizedTimeString;
+};
+
+const processContent = (transcriptContent, isAgentChat, renderMarkDown) => {
+  if (transcriptContent.toString().toLowerCase().indexOf(TranscriptConstants.TranscriptMessageEmojiMessageType) >= 0) {
+    // eslint-disable-next-line no-useless-escape
+    const emojiRegex = "<img src=\"http.*:\/\/.+\/objects\/.+\/views.+\">";
+    const matchedEmojiImgTag = transcriptContent.match(emojiRegex);
+
+    if (matchedEmojiImgTag && matchedEmojiImgTag.length > 0 && transcriptContent.toString().toLowerCase().indexOf(matchedEmojiImgTag[0]) >= 0) {
+      transcriptContent = transcriptContent.replace(matchedEmojiImgTag[0], "");
+    }
+  }
+
+  if (!isAgentChat && transcriptContent.toString().toLowerCase().indexOf("a href") >= 0 && transcriptContent.toString().toLowerCase().indexOf("target") >= 0) {
+    transcriptContent = transcriptContent.slice(0, transcriptContent.toString().indexOf("target")) + " style='color:white' " + transcriptContent.slice(transcriptContent.toString().indexOf("target"));
+  }
+
+  if (renderMarkDown) {
+    transcriptContent = renderMarkDown(transcriptContent);
+  }
+
+  return transcriptContent;
+};
+
+const beautifyChatTranscripts = (chatTranscripts, renderMarkDown, attachmentMessage) => {
+  const chats = JSON.parse(chatTranscripts).reverse();
+  const docTypeTag = "<!DOCTYPE html>";
+  const docStartTag = "<html>";
+  const docMetaTag = "<meta charset='UTF-8'>";
+  const docEndTag = "</html>";
+  const bodyStartTag = "<body bgcolor='" + TranscriptConstants.ChatTranscriptsBodyColor + "'>";
+  const bodyEndTag = "</body>";
+  const divEndTag = "</div>";
+  const mainDiv = "<div class='transcripts' style='width:80%;margin-left:10%;'>";
+  let beautifiedChats = "";
+  let tabIndex = 1;
+  const mainTranscriptSection = "<div class='allTranscripts' style='max-width:60%;min-width:30%;margin-left:20%;background-color:#FFFFFF;'>";
+  let previousDisplayName = "";
+  let chatCount = 0; // eslint-disable-next-line @typescript-eslint/no-explicit-any
+
+  chats.forEach(value => {
+    let dialogNameMarginTop = "6px";
+    let dialogboxMarginleft = "40px";
+    let displayName = "User";
+    let iconName = "U";
+    let isAgentChat = false;
+    let fileAttachmentName = TranscriptConstants.DefaultFileAttachmentName;
+    let dialogColor = TranscriptConstants.CustomerDialogColor;
+    let fontColor = TranscriptConstants.CustomerFontColor;
+    const isSystemMessage = value.tags && value.tags.toLowerCase().indexOf(Constants.systemMessageTag) !== -1;
+    const isControlMessage = value.isControlMessage && value.isControlMessage === true;
+    const isAdaptiveCard = value.contentType && value.contentType.toLowerCase() === TranscriptConstants.AdaptiveCardType;
+    const isInternalMessage = value.deliveryMode && value.deliveryMode.toLowerCase() === TranscriptConstants.InternalMode;
+    const isHiddenMessage = value.tags && value.tags.toLowerCase().indexOf(Constants.hiddenTag.toLowerCase()) !== -1;
+    const shouldIgnoreMessage = isSystemMessage || isControlMessage || isAdaptiveCard || isInternalMessage || isHiddenMessage;
+
+    if (shouldIgnoreMessage) {
+      return;
+    } else if (value.from) {
+      if (value.from.application) {
+        displayName = value.from.application.displayName;
+        dialogColor = TranscriptConstants.AgentDialogColor;
+        fontColor = TranscriptConstants.AgentFontColor;
+        isAgentChat = true;
+      } else if (value.from.guest) {
+        displayName = value.from.guest.displayName;
+        dialogColor = TranscriptConstants.CustomerDialogColor;
+      } else if (value.from.user) {
+        displayName = value.from.user.displayName;
+        dialogColor = TranscriptConstants.CustomerDialogColor;
+      }
+
+      displayName = processDisplayName(displayName);
+      iconName = constructIconName(displayName);
+
+      if (value.attachments && value.attachments.length > 0 && value.attachments[0].name) {
+        fileAttachmentName = value.attachments[0].name;
+        value.content = attachmentMessage ? attachmentMessage + " " + fileAttachmentName : "The following attachment was uploaded during the conversation: " + fileAttachmentName;
+      }
+    }
+
+    let displayNamePlaceholder = processCreatedDateTime(value.createdDateTime, chatCount);
+    let iconPara = "";
+
+    if (displayName !== previousDisplayName) {
+      dialogboxMarginleft = "0px";
+      displayNamePlaceholder = "<b>" + displayName + " </b> " + processCreatedDateTime(value.createdDateTime, chatCount);
+      iconPara = "<div class='circle' style='display:inline-block;float:left;margin-right:5px;width:35px;height:35px;border-radius:20px;color:black;line-height:35px;text-align:center;background:" + dialogColor + ";'>\
+                            <font tabindex ='" + tabIndex + "' color =" + fontColor + " style='font-family:Segoe UI,SegoeUI,Helvetica Neue,Helvetica,Arial,sans-serif;'>\
+                                " + iconName + "\
+                            </font>\
+                            </div>";
+      tabIndex++;
+    }
+
+    if (displayName !== previousDisplayName) {
+      if (previousDisplayName === "") {
+        dialogNameMarginTop = "0px";
+      }
+
+      if (previousDisplayName !== "") {
+        dialogNameMarginTop = "20px";
+      }
+    }
+
+    const displayNameDiv = "<div style='margin-right:-2px;margin-top:" + dialogNameMarginTop + ";margin-bottom:-2px;margin-left:42px;top:-2px;position:relative;'>\
+                                    <font tabindex ='" + tabIndex + "' size = '1px' color='#000000' style='font-family:Segoe UI,SegoeUI,Helvetica Neue,Helvetica,Arial,sans-serif;font-weight:500;'>\
+                                        " + displayNamePlaceholder + "\
+                                    </font>\
+                                </div>";
+    tabIndex++;
+    const dialogbox = "<div class='dialogbox' style='font-family:Segoe UI,SegoeUI,Helvetica Neue,Helvetica,Arial,sans-serif;word-break:break-word;min-height:20px;max-width:80%;display:inline-block;margin-left:" + dialogboxMarginleft + ";padding: 10px; background-color:" + dialogColor + "; border-radius: 0px 12px 12px 12px; left: 3px; top: 2px; '>";
+    beautifiedChats = beautifiedChats + mainDiv + iconPara + displayNameDiv + dialogbox + "<font tabindex= '" + tabIndex++ + "' color =" + fontColor + ">" + processContent(value.content, isAgentChat, renderMarkDown) + "</font>" + divEndTag + divEndTag;
+    previousDisplayName = displayName;
+    chatCount++;
+  });
+  const str = docTypeTag + docStartTag + docMetaTag + bodyStartTag + mainTranscriptSection + beautifiedChats + divEndTag + bodyEndTag + docEndTag;
+  return str;
+}; // eslint-disable-next-line @typescript-eslint/no-explicit-any
+
+
+export const downloadTranscript = async (chatSDK, renderMarkDown, bannerMessageOnError, attachmentMessage) => {
+  let data = await (chatSDK === null || chatSDK === void 0 ? void 0 : chatSDK.getLiveChatTranscript());
+
+  if (typeof data === Constants.String) {
+    data = JSON.parse(data);
+  }
+
+  if (data[Constants.ChatMessagesJson] !== null && data[Constants.ChatMessagesJson] !== undefined) {
+    const chatTranscripts = window.btoa(encodeURIComponent(beautifyChatTranscripts(data[Constants.ChatMessagesJson], renderMarkDown, attachmentMessage)));
+    const byteCharacters = decodeURIComponent(window.atob(chatTranscripts));
+    const blob = new Blob([byteCharacters], {
+      "type": "text/html;charset=utf-8"
+    });
+    const link = document.createElement("a");
+    document.body.appendChild(link);
+    link.setAttribute(HtmlAttributeNames.download, TranscriptConstants.ChatTranscriptDownloadFile);
+    link.setAttribute(HtmlAttributeNames.href, URL.createObjectURL(blob));
+    link.setAttribute(HtmlAttributeNames.ariaHidden, "true");
+    link.click();
+  } else {
+    TelemetryHelper.logActionEvent(LogLevel.ERROR, {
+      Event: TelemetryEvent.DownloadTranscriptResponseNullOrUndefined,
+      ExceptionDetails: {
+        exception: "Download transcript failed: response null or undefined."
+      }
+    });
+    NotificationHandler.notifyError(NotificationScenarios.DownloadTranscriptError, bannerMessageOnError ?? Constants.defaultDownloadTranscriptError);
+  }
+};

package/lib/esm/components/footerstateful/downloadtranscriptstateful/DownloadTranscriptStateful.spec.js

@@ -0,0 +1,54 @@
+import { OmnichannelChatSDK } from "@microsoft/omnichannel-chat-sdk";
+import { cleanup } from "@testing-library/react";
+jest.mock("@microsoft/omnichannel-chat-sdk");
+describe("DownloadTranscriptStateful unit test", () => {
+  afterEach(() => {
+    cleanup;
+    jest.resetAllMocks();
+  });
+  it("Method getLiveChatTranscript is called", async () => {
+    const omnichannelConfig = {
+      orgUrl: "",
+      orgId: "",
+      widgetId: ""
+    };
+    const chatSDK = new OmnichannelChatSDK(omnichannelConfig);
+    jest.spyOn(chatSDK, "getLiveChatTranscript").mockResolvedValue(Promise.resolve());
+
+    try {
+      await chatSDK.getLiveChatTranscript();
+      expect(chatSDK.getLiveChatTranscript).toHaveBeenCalledTimes(1); // eslint-disable-next-line no-empty
+    } catch (ex) {}
+  });
+  it("Method getLiveChatTranscript throws exception", async () => {
+    const errorMessage = "Error";
+    const omnichannelConfig = {
+      orgUrl: "",
+      orgId: "",
+      widgetId: ""
+    };
+    const chatSDK = new OmnichannelChatSDK(omnichannelConfig);
+    jest.spyOn(chatSDK, "getLiveChatTranscript").mockRejectedValue(new Error(errorMessage));
+
+    try {
+      await chatSDK.getLiveChatTranscript(); // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    } catch (ex) {
+      expect(ex.message).toEqual(errorMessage);
+    }
+  });
+  it("Method getLiveChatTranscript undefined throws exception", async () => {
+    const errorMessage = "Error";
+    const omnichannelConfig = {
+      orgUrl: "",
+      orgId: "",
+      widgetId: ""
+    };
+    const chatSDK = new OmnichannelChatSDK(omnichannelConfig);
+
+    try {
+      await chatSDK.getLiveChatTranscript(); // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    } catch (ex) {
+      expect(ex.message).toEqual(errorMessage);
+    }
+  });
+});

package/lib/esm/components/footerstateful/downloadtranscriptstateful/interfaces/IDownloadTranscriptProps.js

@@ -0,0 +1 @@
+export {};