@docshound/chat-react 0.8.5

package/LICENSE

@@ -0,0 +1,7 @@
+Copyright (c) 2024 DocsHound Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/README.md

@@ -0,0 +1,92 @@
+# Docshound Chat for React
+
+`@docshound/chat-react` is a React component library for integrating the DocsHound chat widget into your React / Next.js applications.
+
+## Installation
+
+Install the package via npm:
+
+```bash
+npm install @docshound/chat-react
+```
+
+## Usage
+
+### Location
+
+To ensure the DocsHoundChat component remains mounted and does not unmount with navigation, you should include it in a global layout component that wraps your application's main content. This layout component will persist across different pages, preventing the chat widget from resetting every time the user navigates.
+
+### Basic Example
+
+Here is a simple example of how to use the DocsHoundChat component in your React project:
+
+```jsx
+import React from 'react';
+import { DocsHoundChat } from '@docshound/chat-react';
+
+const App = () => {
+  return (
+    <div>
+      <h1>My Application</h1>
+      <DocsHoundChat src="https://your-docshound-portal.com" />
+    </div>
+  );
+};
+
+export default App;
+
+```
+
+### Props
+
+The DocsHoundChat component accepts the following props:
+
+- `src` (required): The domain where the guide is published, e.g., https://docs.docshound.com.
+- `agentName`: The name of the agent responding in the chat. Optional.
+- `agentAvatarUrl`: The URL for the avatar image of the agent. Optional.
+- `userId`: A unique identifier for the user interacting with the chat. Optional.
+- `userEmail`: The email address of the user. Pre-filled when submitting a support ticket. Optional.
+- `userName`: The display name of the user. Defaults to 'You'. Optional.
+- `platform`: Specifies the platform where the chat is being used ('site', 'app', or 'docs'). Optional. Defaults to 'app'.
+- `userAvatarUrl`: The URL for the avatar image of the user. Optional.
+- `firstMessage`: The initial agent message that appears when the chat opens. Optional.
+- `theme`: Defines the theme of the chat interface, either 'light' or 'dark'. Optional.
+- `position`: The position of the chat widget on the screen ('center' or 'right'). Optional. Defaults to 'right'.
+- `accentColor`: The accent color of the chat interface. Optional.
+- `triggerLabel`: The label for the trigger button that starts the chat. Optional.
+
+## Hooks
+
+This package also provides a custom hook, `useDocsHoundChat`, to programmatically control the chat component.
+
+### Example
+
+```jsx
+import React from 'react';
+import { useDocsHoundChat } from '@docshound/chat-react';
+
+const ChatControls = () => {
+  const { show, clear } = useDocsHoundChat();
+
+  return (
+    <div>
+      <button onClick={() => show(true)}>Show Chat</button>
+      <button onClick={() => show(false)}>Hide Chat</button>
+      <button onClick={() => clear()}>Clear Chat</button>
+    </div>
+  );
+};
+
+export default ChatControls;
+```
+
+### API
+
+Hook's API:
+
+- `show(show: boolean)`: Programmatically show or hide the chat widget.
+- `clear()`: Clears the chat history.
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,104 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+
+type DocsHoundChatProps = {
+    /**
+     * Domain where the guide is published. Eg: https://docs.docshound.com
+     *
+     * This field is not reactive, so if you change it, you need to reload the page.
+     *
+     * Required field;
+     */
+    src: string;
+    /**
+     * The name of the agent responding in the chat.
+     *
+     * Optional field. Defaults to value set in the DocsHound.
+     */
+    agentName?: string;
+    /**
+     * The URL for the avatar image of the agent.
+     *
+     * Optional field. Defaults to value set in the DocsHound.
+     */
+    agentAvatarUrl?: string;
+    /**
+     * A unique identifier for the user interacting with the chat.
+     * This should be unique identifier coming from your system.
+     * Used to identify the user and their support tickets.
+     *
+     * Optional field. Defaults to undefined.
+     */
+    userId?: string;
+    /**
+     * The email address of the user interacting with the chat.
+     * Will be pre-filled for the user when they decide to submit a support ticket.
+     *
+     * Optional field. Defaults to undefined.
+     */
+    userEmail?: string;
+    /**
+     * The display name of the user interacting with the chat.
+     *
+     * Optional field. Defaults to 'You'.
+     */
+    userName?: string;
+    /**
+     * The platform where the chat is being used. Could be either 'site' (marketing site), 'app' (application), or 'docs' (documentation site / platform).
+     *
+     * Optional field, defaults to 'app'.
+     */
+    platform?: 'site' | 'app' | 'docs';
+    /**
+     * The URL for the avatar image of the user interacting with the chat.
+     *
+     * Optional field. Defaults to generic user avatar.
+     */
+    userAvatarUrl?: string;
+    /**
+     * The initial agent message that will be prepopulated when user opens the chatbot widget.
+     *
+     * Optional field. Default to value set in DocsHound.
+     */
+    firstMessage?: string;
+    /**
+     * Defines the theme of the chat interface, either 'light' or 'dark'.
+     *
+     * Optional field. Defaults to value set in DocsHound.
+     */
+    theme?: 'light' | 'dark';
+    /**
+     * Defines the position of the chat widget on the screen. Can be either 'center' or 'right'.
+     *
+     * Optional field. Defaults to 'right'
+     */
+    position?: 'center' | 'right';
+    /**
+     * Sets the accent color of the chat interface (e.g., for buttons or highlights).
+     *
+     * Optional field. Defaults to value set in DocsHound.
+     */
+    accentColor?: string;
+    /**
+     * The label for the trigger button that starts the chat.
+     *
+     * Optional field. Defaults to value set in DocsHound.
+     */
+    triggerLabel?: string;
+};
+declare const DocsHoundChat: ({ src, agentName, agentAvatarUrl, accentColor, platform, position, theme, triggerLabel, userAvatarUrl, userId, userEmail, userName, firstMessage }: DocsHoundChatProps) => react_jsx_runtime.JSX.Element | null;
+
+type UseDocsHoundChat = {
+    /**
+     * Method to show or hide the chat component
+     *
+     * @param show - Whether to show or hide the chat component
+     */
+    show: (show: boolean) => void;
+    /**
+     * Method to clear history of the chat component
+     */
+    clear: () => void;
+};
+declare function useDocsHoundChat(): UseDocsHoundChat;
+
+export { DocsHoundChat, type DocsHoundChatProps, useDocsHoundChat };

package/dist/index.esm.js

@@ -0,0 +1,2 @@
+import{jsx as e}from"react/jsx-runtime";import t,{useEffect as o,useState as n,useCallback as r}from"react";const a=({src:n,agentName:r,agentAvatarUrl:a,accentColor:s,platform:d,position:c,theme:i,triggerLabel:u,userAvatarUrl:_,userId:m,userEmail:l,userName:h,firstMessage:w})=>{const H="__DH_CHAT_SCRIPT__",[p,C]=t.useState(!1);return o((()=>{if(customElements.get("docshound-chat"))return void C(!0);let e="";e=n.endsWith("/-/chat.js")?n:n.endsWith("/")?`${n}-/chat.js`:`${n}/-/chat.js`;const t=document.createElement("script");return t.src=e,t.id=H,t.type="text/javascript",t.async=!0,t.defer=!0,t.onload=()=>{C(!0),setTimeout((()=>{window.__DH_CHAT__=document.querySelector("docshound-chat");const e=new CustomEvent("docsHoundChatLoaded");window.dispatchEvent(e)}))},document.head.appendChild(t),()=>{const e=document.getElementById(H);e&&e.remove(),delete window.__DH_CHAT__}}),[]),p?e("docshound-chat",{"agent-name":r,"agent-avatar-url":a,"accent-color":s,platform:d,position:c,theme:i,"trigger-label":u,"user-id":m,"user-email":l,"user-name":h,"user-avatar-url":_,"first-message":w}):null};function s(){const[e,t]=n(null);o((()=>{if(!window.__DH_CHAT__){const e=()=>{t(window.__DH_CHAT__)};return window.addEventListener("docsHoundChatLoaded",e),()=>{window.removeEventListener("docsHoundChatLoaded",e)}}t(window.__DH_CHAT__)}),[]);return{show:r((t=>{e&&e.show(t)}),[e]),clear:r((()=>{e&&e.clear()}),[e])}}export{a as DocsHoundChat,s as useDocsHoundChat};
+//# sourceMappingURL=index.esm.js.map

package/dist/index.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.esm.js","sources":["../src/components/DocsHoundChat.tsx","../src/hooks/useDocsHoundChat.tsx"],"sourcesContent":["import React, { useEffect } from 'react';\n\nexport type DocsHoundChatProps = {\n  /**\n   * Domain where the guide is published. Eg: https://docs.docshound.com\n   *\n   * This field is not reactive, so if you change it, you need to reload the page.\n   *\n   * Required field;\n   */\n  src: string;\n\n  /**\n   * The name of the agent responding in the chat.\n   *\n   * Optional field. Defaults to value set in the DocsHound.\n   */\n  agentName?: string;\n\n  /**\n   * The URL for the avatar image of the agent.\n   *\n   * Optional field. Defaults to value set in the DocsHound.\n   */\n  agentAvatarUrl?: string;\n\n  /**\n   * A unique identifier for the user interacting with the chat.\n   * This should be unique identifier coming from your system.\n   * Used to identify the user and their support tickets.\n   *\n   * Optional field. Defaults to undefined.\n   */\n  userId?: string;\n\n  /**\n   * The email address of the user interacting with the chat.\n   * Will be pre-filled for the user when they decide to submit a support ticket.\n   *\n   * Optional field. Defaults to undefined.\n   */\n  userEmail?: string;\n\n  /**\n   * The display name of the user interacting with the chat.\n   *\n   * Optional field. Defaults to 'You'.\n   */\n  userName?: string;\n\n  /**\n   * The platform where the chat is being used. Could be either 'site' (marketing site), 'app' (application), or 'docs' (documentation site / platform).\n   *\n   * Optional field, defaults to 'app'.\n   */\n  platform?: 'site' | 'app' | 'docs';\n\n  /**\n   * The URL for the avatar image of the user interacting with the chat.\n   *\n   * Optional field. Defaults to generic user avatar.\n   */\n  userAvatarUrl?: string;\n\n  /**\n   * The initial agent message that will be prepopulated when user opens the chatbot widget.\n   *\n   * Optional field. Default to value set in DocsHound.\n   */\n  firstMessage?: string;\n\n  /**\n   * Defines the theme of the chat interface, either 'light' or 'dark'.\n   *\n   * Optional field. Defaults to value set in DocsHound.\n   */\n  theme?: 'light' | 'dark';\n\n  /**\n   * Defines the position of the chat widget on the screen. Can be either 'center' or 'right'.\n   *\n   * Optional field. Defaults to 'right'\n   */\n  position?: 'center' | 'right';\n\n  /**\n   * Sets the accent color of the chat interface (e.g., for buttons or highlights).\n   *\n   * Optional field. Defaults to value set in DocsHound.\n   */\n  accentColor?: string;\n\n  /**\n   * The label for the trigger button that starts the chat.\n   *\n   * Optional field. Defaults to value set in DocsHound.\n   */\n  triggerLabel?: string;\n}\n\nexport const DocsHoundChat = ({\n                                src,\n                                agentName,\n                                agentAvatarUrl,\n                                accentColor,\n                                platform,\n                                position,\n                                theme,\n                                triggerLabel,\n                                userAvatarUrl,\n                                userId,\n                                userEmail,\n                                userName,\n                                firstMessage\n                              }: DocsHoundChatProps) => {\n  const id = `__DH_CHAT_SCRIPT__`;\n  const [ isLoaded, setIsLoaded ] = React.useState(false);\n\n  useEffect(() => {\n    if (customElements.get('docshound-chat')) {\n      setIsLoaded(true);\n      return;\n    }\n\n    let finalSrc  = '';\n\n    if (src.endsWith('/-/chat.js')) {\n      finalSrc = src;\n    } else if (src.endsWith('/')) {\n      finalSrc = `${src}-/chat.js`;\n    } else {\n      finalSrc = `${src}/-/chat.js`;\n    }\n\n    const script = document.createElement('script');\n    script.src = finalSrc;\n    script.id = id;\n    script.type = 'text/javascript';\n    script.async = true;\n    script.defer = true;\n    script.onload = () => {\n      setIsLoaded(true);\n      setTimeout(() => {\n        window.__DH_CHAT__ = document.querySelector('docshound-chat') as DocsHoundChatElement;\n        const customEvent = new CustomEvent('docsHoundChatLoaded');\n        window.dispatchEvent(customEvent);\n      });\n    };\n    document.head.appendChild(script);\n    return () => {\n      const element = document.getElementById(id);\n      if (element) {\n        element.remove();\n      }\n      delete window.__DH_CHAT__;\n    };\n  }, [ ]);\n\n  if (!isLoaded) {\n    return null;\n  }\n\n  return (\n    <docshound-chat\n      agent-name={agentName}\n      agent-avatar-url={agentAvatarUrl}\n      accent-color={accentColor}\n      platform={platform}\n      position={position}\n      theme={theme}\n      trigger-label={triggerLabel}\n      user-id={userId}\n      user-email={userEmail}\n      user-name={userName}\n      user-avatar-url={userAvatarUrl}\n      first-message={firstMessage}\n    />\n  );\n};","import { useEffect, useState, useCallback } from 'react';\n\ntype UseDocsHoundChat = {\n\n  /**\n   * Method to show or hide the chat component\n   *\n   * @param show - Whether to show or hide the chat component\n   */\n  show: (show: boolean) => void;\n\n  /**\n   * Method to clear history of the chat component\n   */\n  clear: () => void;\n};\n\nexport function useDocsHoundChat(): UseDocsHoundChat {\n  const [chatElement, setChatElement] = useState<DocsHoundChatElement | null>(null);\n\n  useEffect(() => {\n    if (window.__DH_CHAT__) {\n      setChatElement(window.__DH_CHAT__);\n    } else {\n      const listener = () => {\n        setChatElement(window.__DH_CHAT__!);\n      };\n      window.addEventListener('docsHoundChatLoaded', listener);\n\n      return () => {\n        window.removeEventListener('docsHoundChatLoaded', listener);\n      }\n    }\n  }, []);\n\n  const show = useCallback((show: boolean) => {\n    if (chatElement) {\n      // Assuming the dochound-chat component has a show method\n      chatElement.show(show);\n    }\n  }, [chatElement]);\n\n  const clear = useCallback(() => {\n    if (chatElement) {\n      // Assuming the dochound-chat component has a clear method\n      chatElement.clear();\n    }\n  }, [chatElement]);\n\n  // Return the show and clear methods\n  return { show, clear };\n};\n\nexport default useDocsHoundChat;"],"names":["DocsHoundChat","src","agentName","agentAvatarUrl","accentColor","platform","position","theme","triggerLabel","userAvatarUrl","userId","userEmail","userName","firstMessage","id","isLoaded","setIsLoaded","React","useState","useEffect","customElements","get","finalSrc","endsWith","script","document","createElement","type","async","defer","onload","setTimeout","window","__DH_CHAT__","querySelector","customEvent","CustomEvent","dispatchEvent","head","appendChild","element","getElementById","remove","_jsx","useDocsHoundChat","chatElement","setChatElement","listener","addEventListener","removeEventListener","show","useCallback","clear"],"mappings":"4GAoGO,MAAMA,EAAgB,EACGC,MACAC,YACAC,iBACAC,cACAC,WACAC,WACAC,QACAC,eACAC,gBACAC,SACAC,YACAC,WACAC,mBAE9B,MAAMC,EAAK,sBACHC,EAAUC,GAAgBC,EAAMC,UAAS,GA0CjD,OAxCAC,GAAU,KACR,GAAIC,eAAeC,IAAI,kBAErB,YADAL,GAAY,GAId,IAAIM,EAAY,GAGdA,EADErB,EAAIsB,SAAS,cACJtB,EACFA,EAAIsB,SAAS,KACX,GAAGtB,aAEH,GAAGA,cAGhB,MAAMuB,EAASC,SAASC,cAAc,UAetC,OAdAF,EAAOvB,IAAMqB,EACbE,EAAOV,GAAKA,EACZU,EAAOG,KAAO,kBACdH,EAAOI,OAAQ,EACfJ,EAAOK,OAAQ,EACfL,EAAOM,OAAS,KACdd,GAAY,GACZe,YAAW,KACTC,OAAOC,YAAcR,SAASS,cAAc,kBAC5C,MAAMC,EAAc,IAAIC,YAAY,uBACpCJ,OAAOK,cAAcF,EAAY,GACjC,EAEJV,SAASa,KAAKC,YAAYf,GACnB,KACL,MAAMgB,EAAUf,SAASgB,eAAe3B,GACpC0B,GACFA,EAAQE,gBAEHV,OAAOC,WAAW,CAC1B,GACA,IAEElB,EAKH4B,EAAA,iBAAA,CAAA,aACczC,EAAS,mBACHC,EACJ,eAAAC,EACdC,SAAUA,EACVC,SAAUA,EACVC,MAAOA,EAAK,gBACGC,EAAY,UAClBE,EACG,aAAAC,EACD,YAAAC,oBACMH,EAAa,gBACfI,IAhBV,IAkBP,WChKY+B,IACd,MAAOC,EAAaC,GAAkB5B,EAAsC,MAE5EC,GAAU,KACR,IAAIa,OAAOC,YAEJ,CACL,MAAMc,EAAW,KACfD,EAAed,OAAOC,YAAa,EAIrC,OAFAD,OAAOgB,iBAAiB,sBAAuBD,GAExC,KACLf,OAAOiB,oBAAoB,sBAAuBF,EAAS,CAE9D,CAVCD,EAAed,OAAOC,YAUvB,GACA,IAiBH,MAAO,CAAEiB,KAfIC,GAAaD,IACpBL,GAEFA,EAAYK,KAAKA,EAClB,GACA,CAACL,IAUWO,MARDD,GAAY,KACpBN,GAEFA,EAAYO,OACb,GACA,CAACP,IAIN"}

package/dist/index.js

@@ -0,0 +1,2 @@
+"use strict";var e=require("react/jsx-runtime"),t=require("react");exports.DocsHoundChat=({src:a,agentName:s,agentAvatarUrl:n,accentColor:o,platform:r,position:c,theme:d,triggerLabel:u,userAvatarUrl:i,userId:l,userEmail:_,userName:m,firstMessage:h})=>{const w="__DH_CHAT_SCRIPT__",[C,H]=t.useState(!1);return t.useEffect((()=>{if(customElements.get("docshound-chat"))return void H(!0);let e="";e=a.endsWith("/-/chat.js")?a:a.endsWith("/")?`${a}-/chat.js`:`${a}/-/chat.js`;const t=document.createElement("script");return t.src=e,t.id=w,t.type="text/javascript",t.async=!0,t.defer=!0,t.onload=()=>{H(!0),setTimeout((()=>{window.__DH_CHAT__=document.querySelector("docshound-chat");const e=new CustomEvent("docsHoundChatLoaded");window.dispatchEvent(e)}))},document.head.appendChild(t),()=>{const e=document.getElementById(w);e&&e.remove(),delete window.__DH_CHAT__}}),[]),C?e.jsx("docshound-chat",{"agent-name":s,"agent-avatar-url":n,"accent-color":o,platform:r,position:c,theme:d,"trigger-label":u,"user-id":l,"user-email":_,"user-name":m,"user-avatar-url":i,"first-message":h}):null},exports.useDocsHoundChat=function(){const[e,a]=t.useState(null);return t.useEffect((()=>{if(!window.__DH_CHAT__){const e=()=>{a(window.__DH_CHAT__)};return window.addEventListener("docsHoundChatLoaded",e),()=>{window.removeEventListener("docsHoundChatLoaded",e)}}a(window.__DH_CHAT__)}),[]),{show:t.useCallback((t=>{e&&e.show(t)}),[e]),clear:t.useCallback((()=>{e&&e.clear()}),[e])}};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":["../src/components/DocsHoundChat.tsx","../src/hooks/useDocsHoundChat.tsx"],"sourcesContent":["import React, { useEffect } from 'react';\n\nexport type DocsHoundChatProps = {\n  /**\n   * Domain where the guide is published. Eg: https://docs.docshound.com\n   *\n   * This field is not reactive, so if you change it, you need to reload the page.\n   *\n   * Required field;\n   */\n  src: string;\n\n  /**\n   * The name of the agent responding in the chat.\n   *\n   * Optional field. Defaults to value set in the DocsHound.\n   */\n  agentName?: string;\n\n  /**\n   * The URL for the avatar image of the agent.\n   *\n   * Optional field. Defaults to value set in the DocsHound.\n   */\n  agentAvatarUrl?: string;\n\n  /**\n   * A unique identifier for the user interacting with the chat.\n   * This should be unique identifier coming from your system.\n   * Used to identify the user and their support tickets.\n   *\n   * Optional field. Defaults to undefined.\n   */\n  userId?: string;\n\n  /**\n   * The email address of the user interacting with the chat.\n   * Will be pre-filled for the user when they decide to submit a support ticket.\n   *\n   * Optional field. Defaults to undefined.\n   */\n  userEmail?: string;\n\n  /**\n   * The display name of the user interacting with the chat.\n   *\n   * Optional field. Defaults to 'You'.\n   */\n  userName?: string;\n\n  /**\n   * The platform where the chat is being used. Could be either 'site' (marketing site), 'app' (application), or 'docs' (documentation site / platform).\n   *\n   * Optional field, defaults to 'app'.\n   */\n  platform?: 'site' | 'app' | 'docs';\n\n  /**\n   * The URL for the avatar image of the user interacting with the chat.\n   *\n   * Optional field. Defaults to generic user avatar.\n   */\n  userAvatarUrl?: string;\n\n  /**\n   * The initial agent message that will be prepopulated when user opens the chatbot widget.\n   *\n   * Optional field. Default to value set in DocsHound.\n   */\n  firstMessage?: string;\n\n  /**\n   * Defines the theme of the chat interface, either 'light' or 'dark'.\n   *\n   * Optional field. Defaults to value set in DocsHound.\n   */\n  theme?: 'light' | 'dark';\n\n  /**\n   * Defines the position of the chat widget on the screen. Can be either 'center' or 'right'.\n   *\n   * Optional field. Defaults to 'right'\n   */\n  position?: 'center' | 'right';\n\n  /**\n   * Sets the accent color of the chat interface (e.g., for buttons or highlights).\n   *\n   * Optional field. Defaults to value set in DocsHound.\n   */\n  accentColor?: string;\n\n  /**\n   * The label for the trigger button that starts the chat.\n   *\n   * Optional field. Defaults to value set in DocsHound.\n   */\n  triggerLabel?: string;\n}\n\nexport const DocsHoundChat = ({\n                                src,\n                                agentName,\n                                agentAvatarUrl,\n                                accentColor,\n                                platform,\n                                position,\n                                theme,\n                                triggerLabel,\n                                userAvatarUrl,\n                                userId,\n                                userEmail,\n                                userName,\n                                firstMessage\n                              }: DocsHoundChatProps) => {\n  const id = `__DH_CHAT_SCRIPT__`;\n  const [ isLoaded, setIsLoaded ] = React.useState(false);\n\n  useEffect(() => {\n    if (customElements.get('docshound-chat')) {\n      setIsLoaded(true);\n      return;\n    }\n\n    let finalSrc  = '';\n\n    if (src.endsWith('/-/chat.js')) {\n      finalSrc = src;\n    } else if (src.endsWith('/')) {\n      finalSrc = `${src}-/chat.js`;\n    } else {\n      finalSrc = `${src}/-/chat.js`;\n    }\n\n    const script = document.createElement('script');\n    script.src = finalSrc;\n    script.id = id;\n    script.type = 'text/javascript';\n    script.async = true;\n    script.defer = true;\n    script.onload = () => {\n      setIsLoaded(true);\n      setTimeout(() => {\n        window.__DH_CHAT__ = document.querySelector('docshound-chat') as DocsHoundChatElement;\n        const customEvent = new CustomEvent('docsHoundChatLoaded');\n        window.dispatchEvent(customEvent);\n      });\n    };\n    document.head.appendChild(script);\n    return () => {\n      const element = document.getElementById(id);\n      if (element) {\n        element.remove();\n      }\n      delete window.__DH_CHAT__;\n    };\n  }, [ ]);\n\n  if (!isLoaded) {\n    return null;\n  }\n\n  return (\n    <docshound-chat\n      agent-name={agentName}\n      agent-avatar-url={agentAvatarUrl}\n      accent-color={accentColor}\n      platform={platform}\n      position={position}\n      theme={theme}\n      trigger-label={triggerLabel}\n      user-id={userId}\n      user-email={userEmail}\n      user-name={userName}\n      user-avatar-url={userAvatarUrl}\n      first-message={firstMessage}\n    />\n  );\n};","import { useEffect, useState, useCallback } from 'react';\n\ntype UseDocsHoundChat = {\n\n  /**\n   * Method to show or hide the chat component\n   *\n   * @param show - Whether to show or hide the chat component\n   */\n  show: (show: boolean) => void;\n\n  /**\n   * Method to clear history of the chat component\n   */\n  clear: () => void;\n};\n\nexport function useDocsHoundChat(): UseDocsHoundChat {\n  const [chatElement, setChatElement] = useState<DocsHoundChatElement | null>(null);\n\n  useEffect(() => {\n    if (window.__DH_CHAT__) {\n      setChatElement(window.__DH_CHAT__);\n    } else {\n      const listener = () => {\n        setChatElement(window.__DH_CHAT__!);\n      };\n      window.addEventListener('docsHoundChatLoaded', listener);\n\n      return () => {\n        window.removeEventListener('docsHoundChatLoaded', listener);\n      }\n    }\n  }, []);\n\n  const show = useCallback((show: boolean) => {\n    if (chatElement) {\n      // Assuming the dochound-chat component has a show method\n      chatElement.show(show);\n    }\n  }, [chatElement]);\n\n  const clear = useCallback(() => {\n    if (chatElement) {\n      // Assuming the dochound-chat component has a clear method\n      chatElement.clear();\n    }\n  }, [chatElement]);\n\n  // Return the show and clear methods\n  return { show, clear };\n};\n\nexport default useDocsHoundChat;"],"names":["src","agentName","agentAvatarUrl","accentColor","platform","position","theme","triggerLabel","userAvatarUrl","userId","userEmail","userName","firstMessage","id","isLoaded","setIsLoaded","React","useState","useEffect","customElements","get","finalSrc","endsWith","script","document","createElement","type","async","defer","onload","setTimeout","window","__DH_CHAT__","querySelector","customEvent","CustomEvent","dispatchEvent","head","appendChild","element","getElementById","remove","_jsx","jsx","chatElement","setChatElement","listener","addEventListener","removeEventListener","show","useCallback","clear"],"mappings":"yFAoG6B,EACGA,MACAC,YACAC,iBACAC,cACAC,WACAC,WACAC,QACAC,eACAC,gBACAC,SACAC,YACAC,WACAC,mBAE9B,MAAMC,EAAK,sBACHC,EAAUC,GAAgBC,EAAMC,UAAS,GA0CjD,OAxCAC,EAAAA,WAAU,KACR,GAAIC,eAAeC,IAAI,kBAErB,YADAL,GAAY,GAId,IAAIM,EAAY,GAGdA,EADErB,EAAIsB,SAAS,cACJtB,EACFA,EAAIsB,SAAS,KACX,GAAGtB,aAEH,GAAGA,cAGhB,MAAMuB,EAASC,SAASC,cAAc,UAetC,OAdAF,EAAOvB,IAAMqB,EACbE,EAAOV,GAAKA,EACZU,EAAOG,KAAO,kBACdH,EAAOI,OAAQ,EACfJ,EAAOK,OAAQ,EACfL,EAAOM,OAAS,KACdd,GAAY,GACZe,YAAW,KACTC,OAAOC,YAAcR,SAASS,cAAc,kBAC5C,MAAMC,EAAc,IAAIC,YAAY,uBACpCJ,OAAOK,cAAcF,EAAY,GACjC,EAEJV,SAASa,KAAKC,YAAYf,GACnB,KACL,MAAMgB,EAAUf,SAASgB,eAAe3B,GACpC0B,GACFA,EAAQE,gBAEHV,OAAOC,WAAW,CAC1B,GACA,IAEElB,EAKH4B,EAAAC,IAAA,iBAAA,CAAA,aACc1C,EAAS,mBACHC,EACJ,eAAAC,EACdC,SAAUA,EACVC,SAAUA,EACVC,MAAOA,EAAK,gBACGC,EAAY,UAClBE,EACG,aAAAC,EACD,YAAAC,oBACMH,EAAa,gBACfI,IAhBV,IAkBP,sCC/JF,MAAOgC,EAAaC,GAAkB5B,EAAQA,SAA8B,MAgC5E,OA9BAC,EAAAA,WAAU,KACR,IAAIa,OAAOC,YAEJ,CACL,MAAMc,EAAW,KACfD,EAAed,OAAOC,YAAa,EAIrC,OAFAD,OAAOgB,iBAAiB,sBAAuBD,GAExC,KACLf,OAAOiB,oBAAoB,sBAAuBF,EAAS,CAE9D,CAVCD,EAAed,OAAOC,YAUvB,GACA,IAiBI,CAAEiB,KAfIC,eAAaD,IACpBL,GAEFA,EAAYK,KAAKA,EAClB,GACA,CAACL,IAUWO,MARDD,EAAAA,aAAY,KACpBN,GAEFA,EAAYO,OACb,GACA,CAACP,IAIN"}

package/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "@docshound/chat-react",
+  "private": false,
+  "version": "0.8.5",
+  "description": "React component library for integrating the DocsHound chat widget into React and Next.js applications.",
+  "keywords": ["React", "Next.js", "DocsHound", "Chat Widget", "AI", "Customer Support", "Documentation", "Knowledge Base"],
+  "author": "DocsHound",
+  "files": ["dist"],
+  "main": "./dist/index.js",
+  "module": "./dist/index.esm.js",
+  "types": "./dist/index.d.ts",
+  "license": "MIT",
+  "scripts": {
+    "build": "rollup -c --bundleConfigAsCjs",
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "devDependencies": {
+    "@rollup/plugin-commonjs": "^28.0.1",
+    "@rollup/plugin-node-resolve": "^15.3.0",
+    "@rollup/plugin-terser": "^0.4.4",
+    "@rollup/plugin-typescript": "^12.1.1",
+    "@types/react": "^18",
+    "rollup": "^4.24.0",
+    "rollup-plugin-dts": "^6.1.1",
+    "rollup-plugin-peer-deps-external": "^2.2.4",
+    "tslib": "^2.8.0",
+    "typescript": "^5.6.3"
+  },
+  "peerDependencies": {
+    "react": "^18",
+    "react-dom": "^18"
+  }
+}