@ibti-tech/chatbot 0.8.0 → 0.8.1

package/README.md

@@ -21,7 +21,7 @@ npm install @ibti-tech/chatbot
 ## Usage (React)
 
 ```jsx
-import { ChatbotProvider, ChatbotBar } from '@ibti-tech/chatbot'
+import { ChatbotProvider, ChatbotBar, useChatbot } from '@ibti-tech/chatbot'
 
 function App() {
   return (
@@ -37,6 +37,8 @@ function App() {
 }
 ```
 
+All public types (e.g. `ChatbotTypes`, `ChatbotBarProps`) and parameters are documented with JSDoc in English in the source—your IDE will show parameter names, types, and descriptions on hover.
+
 ### Main props
 
 **ChatbotProvider**
@@ -62,6 +64,22 @@ function App() {
 
 When using `pushContentDown={true}` with `verticalPosition="top"`, render `ChatbotBar` **before** your header/main content so it appears at the top.
 
+### Types (`ChatbotTypes`)
+
+Import: `import type { ChatbotTypes } from '@ibti-tech/chatbot'`
+
+| Type | Description |
+|------|-------------|
+| `Theme` | `'light' \| 'dark'` |
+| `Locale` | `'pt-BR' \| 'en'` |
+| `CustomColors` | `{ primaryColor?, headerBackground?, userBalloonColor? }` (hex or rgb) |
+| `ChatMessage` | `{ id, timestamp, role, content, error? }` — one message in the thread |
+| `ChatContextItem` | `{ role, content }` — minimal shape for API context |
+| `Status` | `'writing' \| 'loading' \| 'online' \| 'unavailable'` |
+| `InitializationStatus` | `'loading' \| 'domain_not_allowed' \| 'error' \| 'ready'` |
+| `ChatbotPublicResponse` | Response of GET `/chatbots/public/:hash` (id, name, domain, etc.) |
+| `CustomTexts` / `Texts` | Override UI strings per locale (see JSDoc in `types/index.ts`) |
+
 ## Embed (no React)
 
 For static HTML, WordPress, PHP, or any site without React, load the script from the CDN:

package/dist/index.d.ts

@@ -55,56 +55,42 @@ declare module '@ibti-tech/chatbot/components/ChatUserFeedbackRating/styles.d.ts
 }
 declare module '@ibti-tech/chatbot/components/ChatbotBar/index' {
   import React from 'react';
+  /**
+   * Props for the ChatbotBar component (toggle button + floating chat panel).
+   * Use with ChatbotProvider; positioning is relative to viewport unless pushContentDown is used.
+   */
   export type ChatbotBarProps = {
+      /** Vertical anchor: 'top' | 'bottom'. Default: 'bottom'. */
       verticalPosition?: 'top' | 'bottom';
+      /** Horizontal anchor of the bar: 'left' | 'right'. Default: 'right'. */
       horizontalPosition?: 'left' | 'right';
       /**
-       * Horizontal position of the ChatbotDevice on desktop.
-       * Can be a predefined value ('left', 'right', 'center') or a custom value with any unit (e.g., '20px', '10%', '2rem', 'calc(100% - 200px)').
-       * When using a custom value, it will be applied as the 'left' property.
-       * If not provided, the device will use the parent container's positioning.
+       * Horizontal position of the chat panel on desktop.
+       * Predefined: 'left' | 'right' | 'center', or any CSS length (e.g. '20px', '10%', 'calc(100% - 200px)').
+       * Custom values are applied as the 'left' CSS property. Omit to use parent positioning.
        */
       deviceHorizontalPosition?: 'left' | 'right' | 'center' | string;
-      /**
-       * Custom z-index value. If not provided, uses theme.zIndex.modals
-       * Useful when you need the chatbot to appear above specific elements like headers
-       */
+      /** Custom z-index for the bar/panel. If omitted, uses theme.zIndex.modals. Use to appear above headers. */
       zIndex?: number;
-      /**
-       * Offset from the top when verticalPosition is 'top'
-       * Can be a number (in pixels) or a string (e.g., '100px', '10rem')
-       * Useful to position the chatbot below a fixed header
-       */
+      /** Offset from top when verticalPosition is 'top'. Number (px) or string (e.g. '100px', '10rem'). Use to sit below a fixed header. */
       topOffset?: string | number;
-      /**
-       * Convenient prop to position the chatbot above header elements
-       * When true, sets z-index to 9999 and allows topOffset configuration
-       */
+      /** When true, sets z-index to 9999 so the chatbot appears above header elements; use with topOffset. */
       aboveHeader?: boolean;
       /**
-       * When true and verticalPosition is 'top', the chatbot will push content down
-       * instead of overlaying it. The chatbot will occupy space in the document flow.
-       * When false, the chatbot will be fixed and overlay the content.
+       * When true and verticalPosition is 'top', the bar takes space in the document flow (pushes content down)
+       * instead of overlaying. When false, the bar is fixed and overlays content.
        */
       pushContentDown?: boolean;
-      /**
-       * Background color of the push-content-down row (full-width bar) for light theme.
-       * Does not affect the chatbot button. Accepts rgb(), hex (e.g. #e6e6e6), etc.
-       * Default: rgb(230, 230, 230)
-       */
+      /** Background of the push-content-down full-width row (light theme). Hex or rgb(). Default: rgb(230, 230, 230). */
       pushContentDownRowBackgroundLight?: string;
-      /**
-       * Background color of the push-content-down row (full-width bar) for dark theme.
-       * Does not affect the chatbot button. Accepts rgb(), hex (e.g. #000000), etc.
-       * Default: rgb(0, 0, 0)
-       */
+      /** Background of the push-content-down full-width row (dark theme). Hex or rgb(). Default: rgb(0, 0, 0). */
       pushContentDownRowBackgroundDark?: string;
   };
   export const ChatbotBar: ({ verticalPosition, horizontalPosition, deviceHorizontalPosition, zIndex, topOffset, aboveHeader, pushContentDown, pushContentDownRowBackgroundLight, pushContentDownRowBackgroundDark, }: ChatbotBarProps) => React.JSX.Element;
   //# sourceMappingURL=index.d.ts.map
 }
 declare module '@ibti-tech/chatbot/components/ChatbotBar/index.d.ts' {
-  {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../home/runner/work/ibti-chatbot/ibti-chatbot/src/components/ChatbotBar/index.tsx"],"names":[],"mappings":"AAEA,OAAO,KAA8B,MAAM,OAAO,CAAA;AAIlD,MAAM,MAAM,eAAe,GAAG;IAC5B,gBAAgB,CAAC,EAAE,KAAK,GAAG,QAAQ,CAAA;IACnC,kBAAkB,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;IACrC;;;;;OAKG;IACH,wBAAwB,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM,CAAA;IAC/D;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAA;IACf;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;IAC3B;;;OAGG;IACH,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB;;;;OAIG;IACH,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB;;;;OAIG;IACH,iCAAiC,CAAC,EAAE,MAAM,CAAA;IAC1C;;;;OAIG;IACH,gCAAgC,CAAC,EAAE,MAAM,CAAA;CAC1C,CAAA;AAKD,eAAO,MAAM,UAAU,GAAI,2LAUxB,eAAe,sBAuFjB,CAAA"}
+  {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../home/runner/work/ibti-chatbot/ibti-chatbot/src/components/ChatbotBar/index.tsx"],"names":[],"mappings":"AAEA,OAAO,KAA8B,MAAM,OAAO,CAAA;AAIlD;;;GAGG;AACH,MAAM,MAAM,eAAe,GAAG;IAC5B,4DAA4D;IAC5D,gBAAgB,CAAC,EAAE,KAAK,GAAG,QAAQ,CAAA;IACnC,wEAAwE;IACxE,kBAAkB,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;IACrC;;;;OAIG;IACH,wBAAwB,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM,CAAA;IAC/D,2GAA2G;IAC3G,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,sIAAsI;IACtI,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;IAC3B,wGAAwG;IACxG,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB;;;OAGG;IACH,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB,mHAAmH;IACnH,iCAAiC,CAAC,EAAE,MAAM,CAAA;IAC1C,4GAA4G;IAC5G,gCAAgC,CAAC,EAAE,MAAM,CAAA;CAC1C,CAAA;AAKD,eAAO,MAAM,UAAU,GAAI,2LAUxB,eAAe,sBAuFjB,CAAA"}
 }
 declare module '@ibti-tech/chatbot/components/ChatbotBar/styles' {
   import { breakpoints } from '@ibti-tech/ui';
@@ -372,57 +358,84 @@ declare module '@ibti-tech/chatbot/contexts/Chatbot/context' {
   import * as React from 'react';
   import { ChatbotTypes } from 'types';
   import { useChatbotSuggestedQuestions } from '@ibti-tech/chatbot/contexts/Chatbot/useChatbotSuggestedQuestions';
+  /**
+   * Shape of the chatbot context provided by ChatbotProvider.
+   * Consume via useChatbot() inside the provider tree.
+   */
   export type ChatbotContextProps = {
+      /** Current locale: 'pt-BR' | 'en'. */
       locale: ChatbotTypes.Locale;
+      /** Ordered list of chat messages (user + assistant). */
       chatMessages: ChatbotTypes.ChatMessage[];
+      /** Optional ref for the scrollable messages container. */
       scrollRef?: React.MutableRefObject<HTMLElement | null>;
+      /** Sends a user message and streams the assistant reply. Resolves when stream ends. */
       makeQuestion: (question: string) => Promise<void>;
+      /** True while the assistant is streaming a response. */
       writing: boolean;
+      /** True while the request is in flight (before first chunk). */
       loading: boolean;
+      /** Whether the chat panel is open. */
       opened: boolean;
+      /** Toggles opened state. */
       openedToggle: () => void;
+      /** Derived status: 'writing' | 'loading' | 'online' | 'unavailable'. */
       status: ChatbotTypes.Status;
+      /** True when API health check or request failed (e.g. network/CORS). */
       apiConnectionError: boolean;
+      /** Suggested questions hook result: { loading, data, fetchData, resetData }. */
       suggestedQuestions: ReturnType<typeof useChatbotSuggestedQuestions>;
+      /** Base URL of the chatbot API. */
       apiURL: string;
+      /** Optional custom texts per locale (overrides defaults). */
       texts?: ChatbotTypes.Texts;
+      /** Current theme: 'light' | 'dark'. */
       theme: ChatbotTypes.Theme;
-      /** Lucide icon name for the chatbot (button/header). */
+      /** Optional Lucide icon name for the chatbot button/header (e.g. 'Bot', 'MessageCircle'). */
       icon?: string;
-      /** Public hash of the chatbot (when using new API) */
+      /** Public hash of the chatbot when using the public API. */
       publicHash?: string;
-      /** Stable visitor ID for this chatbot session */
+      /** Stable visitor id for this session (when using publicHash). */
       visitorId?: string;
-      /** Whether the current domain is allowed for this chatbot */
+      /** True when current origin is in the chatbot's allowed domains. */
       domainAllowed: boolean;
-      /** Initialization state of the widget */
+      /** Widget init state: 'loading' | 'domain_not_allowed' | 'error' | 'ready'. */
       initializationStatus: ChatbotTypes.InitializationStatus;
-      /** Chatbot data from GET /chatbots/public/:hash (when ready) */
+      /** Chatbot config from GET /chatbots/public/:hash when initializationStatus is 'ready'. */
       chatbot?: ChatbotTypes.ChatbotPublicResponse;
   };
+  /** React context for chatbot state. Use useChatbot() to consume. */
   export const ChatbotContext: React.Context<ChatbotContextProps>;
   //# sourceMappingURL=context.d.ts.map
 }
 declare module '@ibti-tech/chatbot/contexts/Chatbot/context.d.ts' {
-  {"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../../../../home/runner/work/ibti-chatbot/ibti-chatbot/src/contexts/Chatbot/context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAC9B,OAAO,EAAE,YAAY,EAAE,MAAM,OAAO,CAAA;AACpC,OAAO,EAAE,4BAA4B,EAAE,MAAM,gCAAgC,CAAA;AAE7E,MAAM,MAAM,mBAAmB,GAAG;IAChC,MAAM,EAAE,YAAY,CAAC,MAAM,CAAA;IAC3B,YAAY,EAAE,YAAY,CAAC,WAAW,EAAE,CAAA;IACxC,SAAS,CAAC,EAAE,KAAK,CAAC,gBAAgB,CAAC,WAAW,GAAG,IAAI,CAAC,CAAA;IACtD,YAAY,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IACjD,OAAO,EAAE,OAAO,CAAA;IAChB,OAAO,EAAE,OAAO,CAAA;IAChB,MAAM,EAAE,OAAO,CAAA;IACf,YAAY,EAAE,MAAM,IAAI,CAAA;IACxB,MAAM,EAAE,YAAY,CAAC,MAAM,CAAA;IAC3B,kBAAkB,EAAE,OAAO,CAAA;IAC3B,kBAAkB,EAAE,UAAU,CAAC,OAAO,4BAA4B,CAAC,CAAA;IACnE,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,CAAC,EAAE,YAAY,CAAC,KAAK,CAAA;IAC1B,KAAK,EAAE,YAAY,CAAC,KAAK,CAAA;IACzB,wDAAwD;IACxD,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,sDAAsD;IACtD,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,iDAAiD;IACjD,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,6DAA6D;IAC7D,aAAa,EAAE,OAAO,CAAA;IACtB,yCAAyC;IACzC,oBAAoB,EAAE,YAAY,CAAC,oBAAoB,CAAA;IACvD,gEAAgE;IAChE,OAAO,CAAC,EAAE,YAAY,CAAC,qBAAqB,CAAA;CAC7C,CAAA;AAED,eAAO,MAAM,cAAc,oCAAiD,CAAA"}
+  {"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../../../../home/runner/work/ibti-chatbot/ibti-chatbot/src/contexts/Chatbot/context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAC9B,OAAO,EAAE,YAAY,EAAE,MAAM,OAAO,CAAA;AACpC,OAAO,EAAE,4BAA4B,EAAE,MAAM,gCAAgC,CAAA;AAE7E;;;GAGG;AACH,MAAM,MAAM,mBAAmB,GAAG;IAChC,sCAAsC;IACtC,MAAM,EAAE,YAAY,CAAC,MAAM,CAAA;IAC3B,wDAAwD;IACxD,YAAY,EAAE,YAAY,CAAC,WAAW,EAAE,CAAA;IACxC,0DAA0D;IAC1D,SAAS,CAAC,EAAE,KAAK,CAAC,gBAAgB,CAAC,WAAW,GAAG,IAAI,CAAC,CAAA;IACtD,uFAAuF;IACvF,YAAY,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IACjD,wDAAwD;IACxD,OAAO,EAAE,OAAO,CAAA;IAChB,gEAAgE;IAChE,OAAO,EAAE,OAAO,CAAA;IAChB,sCAAsC;IACtC,MAAM,EAAE,OAAO,CAAA;IACf,4BAA4B;IAC5B,YAAY,EAAE,MAAM,IAAI,CAAA;IACxB,wEAAwE;IACxE,MAAM,EAAE,YAAY,CAAC,MAAM,CAAA;IAC3B,wEAAwE;IACxE,kBAAkB,EAAE,OAAO,CAAA;IAC3B,gFAAgF;IAChF,kBAAkB,EAAE,UAAU,CAAC,OAAO,4BAA4B,CAAC,CAAA;IACnE,mCAAmC;IACnC,MAAM,EAAE,MAAM,CAAA;IACd,6DAA6D;IAC7D,KAAK,CAAC,EAAE,YAAY,CAAC,KAAK,CAAA;IAC1B,uCAAuC;IACvC,KAAK,EAAE,YAAY,CAAC,KAAK,CAAA;IACzB,6FAA6F;IAC7F,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,4DAA4D;IAC5D,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,kEAAkE;IAClE,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,oEAAoE;IACpE,aAAa,EAAE,OAAO,CAAA;IACtB,+EAA+E;IAC/E,oBAAoB,EAAE,YAAY,CAAC,oBAAoB,CAAA;IACvD,2FAA2F;IAC3F,OAAO,CAAC,EAAE,YAAY,CAAC,qBAAqB,CAAA;CAC7C,CAAA;AAED,oEAAoE;AACpE,eAAO,MAAM,cAAc,oCAAiD,CAAA"}
 }
 declare module '@ibti-tech/chatbot/contexts/Chatbot/provider' {
   import React, { ReactNode } from 'react';
   import { ChatbotTypes } from 'types';
+  /**
+   * Props for ChatbotProvider. Wrap your app (or chatbot subtree) with this to enable useChatbot().
+   */
   export type ChatbotProviderProps = {
+      /** Locale: 'pt-BR' | 'en'. */
       locale: ChatbotTypes.Locale;
+      /** Base URL of the chatbot API (e.g. https://api.example.com). */
       apiURL: string;
-      /** Public hash of the chatbot (required for new API; omit for legacy mode) */
+      /** Public hash of the chatbot (required for domain-validated API; omit for legacy). */
       publicHash?: string;
       children?: ReactNode;
+      /** UI theme: 'light' | 'dark'. */
       theme: ChatbotTypes.Theme;
+      /** Initial open state of the chat panel. Default: false. */
       isOpen?: boolean;
+      /** Optional custom texts per locale (key: 'pt-BR' | 'en', value: CustomTexts). */
       texts?: ChatbotTypes.Texts;
-      /** Override list of origins that skip domain check */
+      /** Origins that skip domain validation (e.g. for staging). */
       allowedOriginsWithoutCheck?: string[];
-      /** When true (e.g. admin preview iframe), skip domain validation entirely */
+      /** When true, skip domain check (e.g. admin preview iframe). Do not use in production embed. */
       skipDomainCheck?: boolean;
-      /** Custom colors for branding (primary, header, user balloons) */
+      /** Custom colors: primaryColor, headerBackground, userBalloonColor (hex or rgb). */
       colors?: ChatbotTypes.CustomColors;
       /** Lucide icon name for the chatbot button/header (e.g. 'Bot', 'MessageCircle'). */
       icon?: string;
@@ -431,13 +444,22 @@ declare module '@ibti-tech/chatbot/contexts/Chatbot/provider' {
   //# sourceMappingURL=provider.d.ts.map
 }
 declare module '@ibti-tech/chatbot/contexts/Chatbot/provider.d.ts' {
-  {"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../../../../home/runner/work/ibti-chatbot/ibti-chatbot/src/contexts/Chatbot/provider.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,SAAS,EAAwC,MAAM,OAAO,CAAA;AAC9E,OAAO,EAAE,YAAY,EAAE,MAAM,OAAO,CAAA;AASpC,MAAM,MAAM,oBAAoB,GAAG;IACjC,MAAM,EAAE,YAAY,CAAC,MAAM,CAAA;IAC3B,MAAM,EAAE,MAAM,CAAA;IACd,8EAA8E;IAC9E,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,EAAE,SAAS,CAAA;IACpB,KAAK,EAAE,YAAY,CAAC,KAAK,CAAA;IACzB,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,KAAK,CAAC,EAAE,YAAY,CAAC,KAAK,CAAA;IAC1B,sDAAsD;IACtD,0BAA0B,CAAC,EAAE,MAAM,EAAE,CAAA;IACrC,6EAA6E;IAC7E,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB,kEAAkE;IAClE,MAAM,CAAC,EAAE,YAAY,CAAC,YAAY,CAAA;IAClC,oFAAoF;IACpF,IAAI,CAAC,EAAE,MAAM,CAAA;CACd,CAAA;AAED,eAAO,MAAM,eAAe,GAAI,sJAY7B,oBAAoB,sBAgLtB,CAAA"}
+  {"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../../../../home/runner/work/ibti-chatbot/ibti-chatbot/src/contexts/Chatbot/provider.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,SAAS,EAAwC,MAAM,OAAO,CAAA;AAC9E,OAAO,EAAE,YAAY,EAAE,MAAM,OAAO,CAAA;AASpC;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG;IACjC,8BAA8B;IAC9B,MAAM,EAAE,YAAY,CAAC,MAAM,CAAA;IAC3B,kEAAkE;IAClE,MAAM,EAAE,MAAM,CAAA;IACd,uFAAuF;IACvF,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,EAAE,SAAS,CAAA;IACpB,kCAAkC;IAClC,KAAK,EAAE,YAAY,CAAC,KAAK,CAAA;IACzB,4DAA4D;IAC5D,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,kFAAkF;IAClF,KAAK,CAAC,EAAE,YAAY,CAAC,KAAK,CAAA;IAC1B,8DAA8D;IAC9D,0BAA0B,CAAC,EAAE,MAAM,EAAE,CAAA;IACrC,gGAAgG;IAChG,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB,oFAAoF;IACpF,MAAM,CAAC,EAAE,YAAY,CAAC,YAAY,CAAA;IAClC,oFAAoF;IACpF,IAAI,CAAC,EAAE,MAAM,CAAA;CACd,CAAA;AAED,eAAO,MAAM,eAAe,GAAI,sJAY7B,oBAAoB,sBAgLtB,CAAA"}
 }
 declare module '@ibti-tech/chatbot/contexts/Chatbot/useChatFeedbackBox' {
+  /** Parameters for sendUserRating from useChatFeedbackBox. */
   type SendUserRatingProps = {
+      /** Rating value (e.g. 1–5). */
       ratingScore: number;
+      /** Optional free-text feedback. */
       description: string;
   };
+  /**
+   * Hook for the feedback modal: open/close and send rating.
+   * Uses useChatbot() for apiURL, locale, chatMessages, publicHash, visitorId.
+   *
+   * @returns { opened, open, close, sendUserRating, loading } — loading true while submit in progress
+   */
   export const useChatFeedbackBox: () => {
       opened: boolean;
       open: () => void;
@@ -449,22 +471,35 @@ declare module '@ibti-tech/chatbot/contexts/Chatbot/useChatFeedbackBox' {
   //# sourceMappingURL=useChatFeedbackBox.d.ts.map
 }
 declare module '@ibti-tech/chatbot/contexts/Chatbot/useChatFeedbackBox.d.ts' {
-  {"version":3,"file":"useChatFeedbackBox.d.ts","sourceRoot":"","sources":["../../../../../home/runner/work/ibti-chatbot/ibti-chatbot/src/contexts/Chatbot/useChatFeedbackBox.ts"],"names":[],"mappings":"AAIA,KAAK,mBAAmB,GAAG;IACzB,WAAW,EAAE,MAAM,CAAA;IACnB,WAAW,EAAE,MAAM,CAAA;CACpB,CAAA;AAED,eAAO,MAAM,kBAAkB;;;;oDAkB1B,mBAAmB;;CA6BvB,CAAA"}
+  {"version":3,"file":"useChatFeedbackBox.d.ts","sourceRoot":"","sources":["../../../../../home/runner/work/ibti-chatbot/ibti-chatbot/src/contexts/Chatbot/useChatFeedbackBox.ts"],"names":[],"mappings":"AAIA,6DAA6D;AAC7D,KAAK,mBAAmB,GAAG;IACzB,+BAA+B;IAC/B,WAAW,EAAE,MAAM,CAAA;IACnB,mCAAmC;IACnC,WAAW,EAAE,MAAM,CAAA;CACpB,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB;;;;oDAkB1B,mBAAmB;;CA6BvB,CAAA"}
 }
 declare module '@ibti-tech/chatbot/contexts/Chatbot/useChatbot' {
+  /**
+   * Returns the chatbot context (state and actions).
+   * Must be used within a ChatbotProvider; throws otherwise.
+   *
+   * @returns ChatbotContextProps (locale, chatMessages, makeQuestion, opened, openedToggle, status, etc.)
+   */
   export const useChatbot: () => import("@ibti-tech/chatbot/contexts/Chatbot/context").ChatbotContextProps;
   export default useChatbot;
   //# sourceMappingURL=useChatbot.d.ts.map
 }
 declare module '@ibti-tech/chatbot/contexts/Chatbot/useChatbot.d.ts' {
-  {"version":3,"file":"useChatbot.d.ts","sourceRoot":"","sources":["../../../../../home/runner/work/ibti-chatbot/ibti-chatbot/src/contexts/Chatbot/useChatbot.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,UAAU,+CAMtB,CAAA;AAED,eAAe,UAAU,CAAA"}
+  {"version":3,"file":"useChatbot.d.ts","sourceRoot":"","sources":["../../../../../home/runner/work/ibti-chatbot/ibti-chatbot/src/contexts/Chatbot/useChatbot.ts"],"names":[],"mappings":"AAGA;;;;;GAKG;AACH,eAAO,MAAM,UAAU,+CAMtB,CAAA;AAED,eAAe,UAAU,CAAA"}
 }
 declare module '@ibti-tech/chatbot/contexts/Chatbot/useChatbotMessages' {
   import { ChatbotTypes } from 'types';
+  /**
+   * Options for useChatbotMessages (used internally by ChatbotProvider).
+   */
   export type UseChatbotMessagesOptions = {
+      /** Base URL of the chatbot API. */
       apiURL: string;
+      /** Locale: 'pt-BR' | 'en'. */
       locale: ChatbotTypes.Locale;
+      /** Optional. Public hash when using the public API. */
       publicHash?: string;
+      /** Optional. Visitor id for conversation continuity. */
       visitorId?: string;
   };
   export const useChatbotMessages: ({ apiURL, locale, publicHash, visitorId, }: UseChatbotMessagesOptions) => {
@@ -485,15 +520,25 @@ declare module '@ibti-tech/chatbot/contexts/Chatbot/useChatbotMessages' {
   //# sourceMappingURL=useChatbotMessages.d.ts.map
 }
 declare module '@ibti-tech/chatbot/contexts/Chatbot/useChatbotMessages.d.ts' {
-  {"version":3,"file":"useChatbotMessages.d.ts","sourceRoot":"","sources":["../../../../../home/runner/work/ibti-chatbot/ibti-chatbot/src/contexts/Chatbot/useChatbotMessages.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,OAAO,CAAA;AAYpC,MAAM,MAAM,yBAAyB,GAAG;IACtC,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,YAAY,CAAC,MAAM,CAAA;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB,CAAA;AAED,eAAO,MAAM,kBAAkB,GAAI,4CAKhC,yBAAyB;;iCA2JgB,MAAM;;;;;;;;;;;CAqNjD,CAAA;AAED,eAAe,kBAAkB,CAAA"}
+  {"version":3,"file":"useChatbotMessages.d.ts","sourceRoot":"","sources":["../../../../../home/runner/work/ibti-chatbot/ibti-chatbot/src/contexts/Chatbot/useChatbotMessages.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,OAAO,CAAA;AAYpC;;GAEG;AACH,MAAM,MAAM,yBAAyB,GAAG;IACtC,mCAAmC;IACnC,MAAM,EAAE,MAAM,CAAA;IACd,8BAA8B;IAC9B,MAAM,EAAE,YAAY,CAAC,MAAM,CAAA;IAC3B,uDAAuD;IACvD,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,wDAAwD;IACxD,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB,CAAA;AAED,eAAO,MAAM,kBAAkB,GAAI,4CAKhC,yBAAyB;;iCA2JgB,MAAM;;;;;;;;;;;CAqNjD,CAAA;AAED,eAAe,kBAAkB,CAAA"}
 }
 declare module '@ibti-tech/chatbot/contexts/Chatbot/useChatbotSuggestedQuestions' {
   import { ChatbotTypes } from 'types';
+  /**
+   * Options for useChatbotSuggestedQuestions (used internally for suggested questions).
+   */
   export type UseChatbotSuggestedQuestionsOptions = {
+      /** Current conversation context (role + content). */
       chatContext: ChatbotTypes.ChatContextItem[];
+      /** Base URL of the API. */
       apiURL: string;
+      /** Locale: 'pt-BR' | 'en'. */
       locale: ChatbotTypes.Locale;
   };
+  /**
+   * Hook for suggested questions (used by ChatbotProvider).
+   * Returns loading state, list of question strings, fetchData, and resetData.
+   */
   export const useChatbotSuggestedQuestions: ({ chatContext, locale, apiURL, }: UseChatbotSuggestedQuestionsOptions) => {
       loading: boolean;
       data: string[];
@@ -503,7 +548,7 @@ declare module '@ibti-tech/chatbot/contexts/Chatbot/useChatbotSuggestedQuestions
   //# sourceMappingURL=useChatbotSuggestedQuestions.d.ts.map
 }
 declare module '@ibti-tech/chatbot/contexts/Chatbot/useChatbotSuggestedQuestions.d.ts' {
-  {"version":3,"file":"useChatbotSuggestedQuestions.d.ts","sourceRoot":"","sources":["../../../../../home/runner/work/ibti-chatbot/ibti-chatbot/src/contexts/Chatbot/useChatbotSuggestedQuestions.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,OAAO,CAAA;AAEpC,MAAM,MAAM,mCAAmC,GAAG;IAChD,WAAW,EAAE,YAAY,CAAC,eAAe,EAAE,CAAA;IAC3C,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,YAAY,CAAC,MAAM,CAAA;CAC5B,CAAA;AAED,eAAO,MAAM,4BAA4B,GAAI,kCAI1C,mCAAmC;;;;;CA2BrC,CAAA"}
+  {"version":3,"file":"useChatbotSuggestedQuestions.d.ts","sourceRoot":"","sources":["../../../../../home/runner/work/ibti-chatbot/ibti-chatbot/src/contexts/Chatbot/useChatbotSuggestedQuestions.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,OAAO,CAAA;AAEpC;;GAEG;AACH,MAAM,MAAM,mCAAmC,GAAG;IAChD,qDAAqD;IACrD,WAAW,EAAE,YAAY,CAAC,eAAe,EAAE,CAAA;IAC3C,2BAA2B;IAC3B,MAAM,EAAE,MAAM,CAAA;IACd,8BAA8B;IAC9B,MAAM,EAAE,YAAY,CAAC,MAAM,CAAA;CAC5B,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,4BAA4B,GAAI,kCAI1C,mCAAmC;;;;;CA2BrC,CAAA"}
 }
 declare module '@ibti-tech/chatbot/cookies/chat' {
   import { ChatbotTypes } from 'types';
@@ -555,29 +600,37 @@ declare module '@ibti-tech/chatbot/cookies/chat.d.ts' {
 }
 declare module '@ibti-tech/chatbot/embed' {
   /**
-   * Embed entry point for HTML/WordPress/PHP.
-   * Reads config from window.IBTIChatbotConfig or data-* attributes on the script element.
-   * Mounts the chatbot widget into a container (auto-created or existing #ibti-chatbot-root).
+   * Embed entry point for HTML / WordPress / PHP.
+   * Config: window.IBTIChatbotConfig or data-* attributes on the script tag.
+   * Mounts the widget into #ibti-chatbot-root (or containerId). Exposes window.IBTIChatbotEmbed.init(config) and destroy().
    */
   import type { ChatbotTypes } from '@ibti-tech/chatbot/types/index';
-  /** Embed configuration (from window.IBTIChatbotConfig or data-* attributes). */
+  /**
+   * Embed configuration. Pass to IBTIChatbotEmbed.init(config) or set window.IBTIChatbotConfig.
+   * data-* attributes: data-api-url, data-public-hash, data-locale, data-theme, data-position, data-colors (JSON), data-icon, data-texts (JSON).
+   */
   export interface IBTIChatbotEmbedConfig {
+      /** Base URL of the chatbot API. Required. */
       apiURL: string;
+      /** Public hash of the chatbot. Required. */
       publicHash: string;
+      /** Locale: 'pt-BR' | 'en'. Default: 'pt-BR'. */
       locale?: ChatbotTypes.Locale;
+      /** Theme: 'light' | 'dark'. Default: 'light'. */
       theme?: ChatbotTypes.Theme;
+      /** Bar position. Default: 'bottom-right'. */
       position?: 'bottom-right' | 'bottom-left' | 'top-right' | 'top-left';
-      /** Optional: custom container selector. Default creates a div appended to body. */
+      /** DOM id for the mount container. Default: 'ibti-chatbot-root'. If missing, a div is created and appended to body. */
       containerId?: string;
-      /** When true (e.g. admin embed preview), skip domain validation. Do not use in production embed. */
+      /** Skip domain validation (e.g. admin preview). Do not use in production. */
       skipDomainCheck?: boolean;
-      /** Custom colors for branding (hex or rgb). */
+      /** Custom colors: primaryColor, headerBackground, userBalloonColor (hex or rgb). */
       colors?: ChatbotTypes.CustomColors;
-      /** Initial open state of the chatbot. Default: false */
+      /** Initial open state of the chat panel. Default: false. */
       isOpen?: boolean;
-      /** Lucide icon name for the chatbot button/header (e.g. 'Bot', 'MessageCircle'). */
+      /** Lucide icon name for the button/header (e.g. 'Bot', 'MessageCircle'). */
       icon?: string;
-      /** Custom texts per locale for the chatbot UI. */
+      /** Custom UI texts per locale: { 'pt-BR': CustomTexts, 'en': CustomTexts }. */
       texts?: ChatbotTypes.Texts;
   }
   global {
@@ -593,7 +646,7 @@ declare module '@ibti-tech/chatbot/embed' {
   //# sourceMappingURL=embed.d.ts.map
 }
 declare module '@ibti-tech/chatbot/embed.d.ts' {
-  {"version":3,"file":"embed.d.ts","sourceRoot":"","sources":["../../../home/runner/work/ibti-chatbot/ibti-chatbot/src/embed.tsx"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AAE3C,gFAAgF;AAChF,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,MAAM,CAAA;IACd,UAAU,EAAE,MAAM,CAAA;IAClB,MAAM,CAAC,EAAE,YAAY,CAAC,MAAM,CAAA;IAC5B,KAAK,CAAC,EAAE,YAAY,CAAC,KAAK,CAAA;IAC1B,QAAQ,CAAC,EAAE,cAAc,GAAG,aAAa,GAAG,WAAW,GAAG,UAAU,CAAA;IACpE,mFAAmF;IACnF,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,oGAAoG;IACpG,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB,+CAA+C;IAC/C,MAAM,CAAC,EAAE,YAAY,CAAC,YAAY,CAAA;IAClC,wDAAwD;IACxD,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,oFAAoF;IACpF,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,kDAAkD;IAClD,KAAK,CAAC,EAAE,YAAY,CAAC,KAAK,CAAA;CAC3B;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,MAAM;QACd,iBAAiB,CAAC,EAAE,sBAAsB,CAAA;QAC1C,gBAAgB,CAAC,EAAE;YACjB,IAAI,EAAE,CAAC,MAAM,CAAC,EAAE,sBAAsB,KAAK,IAAI,CAAA;YAC/C,OAAO,EAAE,MAAM,IAAI,CAAA;SACpB,CAAA;KACF;CACF;AAyID,wBAAgB,UAAU,SAEzB"}
+  {"version":3,"file":"embed.d.ts","sourceRoot":"","sources":["../../../home/runner/work/ibti-chatbot/ibti-chatbot/src/embed.tsx"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AAE3C;;;GAGG;AACH,MAAM,WAAW,sBAAsB;IACrC,6CAA6C;IAC7C,MAAM,EAAE,MAAM,CAAA;IACd,4CAA4C;IAC5C,UAAU,EAAE,MAAM,CAAA;IAClB,gDAAgD;IAChD,MAAM,CAAC,EAAE,YAAY,CAAC,MAAM,CAAA;IAC5B,iDAAiD;IACjD,KAAK,CAAC,EAAE,YAAY,CAAC,KAAK,CAAA;IAC1B,6CAA6C;IAC7C,QAAQ,CAAC,EAAE,cAAc,GAAG,aAAa,GAAG,WAAW,GAAG,UAAU,CAAA;IACpE,uHAAuH;IACvH,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,6EAA6E;IAC7E,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB,oFAAoF;IACpF,MAAM,CAAC,EAAE,YAAY,CAAC,YAAY,CAAA;IAClC,4DAA4D;IAC5D,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,4EAA4E;IAC5E,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,+EAA+E;IAC/E,KAAK,CAAC,EAAE,YAAY,CAAC,KAAK,CAAA;CAC3B;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,MAAM;QACd,iBAAiB,CAAC,EAAE,sBAAsB,CAAA;QAC1C,gBAAgB,CAAC,EAAE;YACjB,IAAI,EAAE,CAAC,MAAM,CAAC,EAAE,sBAAsB,KAAK,IAAI,CAAA;YAC/C,OAAO,EAAE,MAAM,IAAI,CAAA;SACpB,CAAA;KACF;CACF;AAyID,wBAAgB,UAAU,SAEzB"}
 }
 declare module '@ibti-tech/chatbot/events/assistant-answer' {
   export const dispatchAssitantAnswer: () => void;
@@ -711,6 +764,18 @@ declare module '@ibti-tech/chatbot/i18n/index.d.ts' {
   {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../home/runner/work/ibti-chatbot/ibti-chatbot/src/i18n/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,OAAO,CAAA;AACpC,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAI3C,eAAO,MAAM,OAAO,0BAA2B,CAAA;AAE/C,eAAO,MAAM,IAAI,EAAE,MAAM,CAAC,YAAY,CAAC,MAAM,EAAE,WAAW,CAGzD,CAAA;AAED,eAAO,MAAM,eAAe,GAAI,MAAM,YAAY,CAAC,MAAM,gBAAe,CAAA"}
 }
 declare module '@ibti-tech/chatbot/index' {
+  /**
+   * @ibti-tech/chatbot — React package entry.
+   *
+   * React usage:
+   * - ChatbotProvider: wrap your app; props: locale, apiURL, publicHash, theme, isOpen?, texts?, colors?, icon?, skipDomainCheck?, allowedOriginsWithoutCheck?
+   * - ChatbotBar: floating bar + panel; props: verticalPosition?, horizontalPosition?, deviceHorizontalPosition?, zIndex?, topOffset?, aboveHeader?, pushContentDown?, pushContentDownRowBackgroundLight?, pushContentDownRowBackgroundDark?
+   * - useChatbot(): returns context (chatMessages, makeQuestion, opened, openedToggle, status, etc.)
+   * - ChatbotContext: React context (prefer useChatbot())
+   * - ChatbotDevice: inner device component (usually used by ChatbotBar)
+   *
+   * Types: ChatbotTypes (Theme, Locale, CustomColors, ChatMessage, ChatContextItem, Status, InitializationStatus, ChatbotPublicResponse, Config, CustomTexts, Texts)
+   */
   export { useChatbot } from 'contexts/Chatbot/useChatbot';
   export { ChatbotContext } from 'contexts/Chatbot/context';
   export { ChatbotProvider } from 'contexts/Chatbot/provider';
@@ -720,7 +785,7 @@ declare module '@ibti-tech/chatbot/index' {
   //# sourceMappingURL=index.d.ts.map
 }
 declare module '@ibti-tech/chatbot/index.d.ts' {
-  {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../home/runner/work/ibti-chatbot/ibti-chatbot/src/index.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAA;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAA;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAA;AAC3D,OAAO,EAAE,UAAU,EAAE,KAAK,eAAe,EAAE,MAAM,uBAAuB,CAAA;AACxE,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAA;AACxD,YAAY,EAAE,YAAY,EAAE,MAAM,OAAO,CAAA"}
+  {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../home/runner/work/ibti-chatbot/ibti-chatbot/src/index.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAA;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAA;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAA;AAC3D,OAAO,EAAE,UAAU,EAAE,KAAK,eAAe,EAAE,MAAM,uBAAuB,CAAA;AACxE,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAA;AACxD,YAAY,EAAE,YAAY,EAAE,MAAM,OAAO,CAAA"}
 }
 declare module '@ibti-tech/chatbot/mocks/chatHistory' {
   export const chatHistoryMocked: readonly [{
@@ -788,61 +853,67 @@ declare module '@ibti-tech/chatbot/mocks/chatHistory.d.ts' {
 }
 declare module '@ibti-tech/chatbot/services/api/http-client' {
   /**
-   * Returns default headers for all API requests.
-   * Includes Content-Type and User-Agent (from navigator when available).
+   * Default headers for all chatbot API requests.
+   * - Content-Type: application/json
+   * - User-Agent: navigator.userAgent when available, else 'IBTI-Chatbot/1.0'
+   *
+   * @returns Record of header name to value (suitable for fetch headers)
    */
   export const getDefaultHeaders: () => Record<string, string>;
   //# sourceMappingURL=http-client.d.ts.map
 }
 declare module '@ibti-tech/chatbot/services/api/http-client.d.ts' {
-  {"version":3,"file":"http-client.d.ts","sourceRoot":"","sources":["../../../../../home/runner/work/ibti-chatbot/ibti-chatbot/src/services/api/http-client.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,iBAAiB,QAAO,MAAM,CAAC,MAAM,EAAE,MAAM,CAIxD,CAAA"}
+  {"version":3,"file":"http-client.d.ts","sourceRoot":"","sources":["../../../../../home/runner/work/ibti-chatbot/ibti-chatbot/src/services/api/http-client.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,QAAO,MAAM,CAAC,MAAM,EAAE,MAAM,CAIxD,CAAA"}
 }
 declare module '@ibti-tech/chatbot/services/chat/chat.api' {
   import { ChatbotTypes } from 'types';
   import type { SendNewQuestionOptions } from '@ibti-tech/chatbot/services/types/index';
   /**
    * Sends chat context to the completion endpoint and streams the response.
-   * POST /chat/completion?locale=&hash=&visitorId=
+   * Endpoint: POST /chat/completion?locale=&hash=&visitorId=
    *
-   * @param options - Chat context, locale, callbacks, and optional hash/visitorId
+   * @param options - SendNewQuestionOptions: chatContext, locale, apiURL, optional publicHash/visitorId, onReceiving, onDone
+   * @returns Promise that resolves when the stream ends (no value)
+   * @throws Error when response is not ok (includes status in message)
    */
   export const sendChatContext: ({ chatContext, locale, onReceiving, onDone, apiURL, publicHash, visitorId, }: SendNewQuestionOptions) => Promise<void>;
   /**
-   * Checks if the API is available by making a lightweight request.
-   * Tries HEAD first, falls back to GET if HEAD fails.
+   * Checks if the API is available (lightweight health check).
+   * Tries HEAD on /chat/welcome first; falls back to GET on failure. Timeout: 5s.
    *
-   * @param apiUrl - Base URL of the API
-   * @param locale - Locale for the request
-   * @param publicHash - Optional; includes hash in welcome URL when provided
-   * @returns true if API responds with ok status
+   * @param apiUrl - Base URL of the API (e.g. https://api.example.com)
+   * @param locale - Locale for query: 'pt-BR' | 'en'
+   * @param publicHash - Optional; added as query param when provided
+   * @returns true if response is ok, false on error or timeout
    */
   export const checkApiHealth: (apiUrl: string, locale?: ChatbotTypes.Locale, publicHash?: string) => Promise<boolean>;
   /**
    * Fetches the welcome message for the chatbot.
-   * GET /chat/welcome?locale=&hash=
+   * Endpoint: GET /chat/welcome?locale=&hash=
    *
    * @param apiUrl - Base URL of the API
-   * @param locale - Locale for the welcome message
-   * @param publicHash - Optional; identifies the chatbot when provided
-   * @returns The welcome message string
+   * @param locale - Locale for the welcome message: 'pt-BR' | 'en'
+   * @param publicHash - Optional; chatbot identifier when using public API
+   * @returns Promise resolving to the welcome message string
+   * @throws Error when response is not ok (uses i18n error message + status)
    */
   export const getWelcomeMessage: (apiUrl: string, locale?: ChatbotTypes.Locale, publicHash?: string) => Promise<string>;
   //# sourceMappingURL=chat.api.d.ts.map
 }
 declare module '@ibti-tech/chatbot/services/chat/chat.api.d.ts' {
-  {"version":3,"file":"chat.api.d.ts","sourceRoot":"","sources":["../../../../../home/runner/work/ibti-chatbot/ibti-chatbot/src/services/chat/chat.api.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,OAAO,CAAA;AAEpC,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,UAAU,CAAA;AAEtD;;;;;GAKG;AACH,eAAO,MAAM,eAAe,GAAU,8EAQnC,sBAAsB,KAAG,OAAO,CAAC,IAAI,CAwCvC,CAAA;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,cAAc,GACzB,QAAQ,MAAM,EACd,SAAQ,YAAY,CAAC,MAAa,EAClC,aAAa,MAAM,KAClB,OAAO,CAAC,OAAO,CAuCjB,CAAA;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,iBAAiB,GAC5B,QAAQ,MAAM,EACd,SAAQ,YAAY,CAAC,MAAa,EAClC,aAAa,MAAM,KAClB,OAAO,CAAC,MAAM,CAoBhB,CAAA"}
+  {"version":3,"file":"chat.api.d.ts","sourceRoot":"","sources":["../../../../../home/runner/work/ibti-chatbot/ibti-chatbot/src/services/chat/chat.api.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,OAAO,CAAA;AAEpC,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,UAAU,CAAA;AAEtD;;;;;;;GAOG;AACH,eAAO,MAAM,eAAe,GAAU,8EAQnC,sBAAsB,KAAG,OAAO,CAAC,IAAI,CAwCvC,CAAA;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,cAAc,GACzB,QAAQ,MAAM,EACd,SAAQ,YAAY,CAAC,MAAa,EAClC,aAAa,MAAM,KAClB,OAAO,CAAC,OAAO,CAuCjB,CAAA;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,iBAAiB,GAC5B,QAAQ,MAAM,EACd,SAAQ,YAAY,CAAC,MAAa,EAClC,aAAa,MAAM,KAClB,OAAO,CAAC,MAAM,CAoBhB,CAAA"}
 }
 declare module '@ibti-tech/chatbot/services/chatbot/chatbot.api' {
   import { ChatbotTypes } from 'types';
   /**
    * Fetches a chatbot by its public hash.
-   * GET /chatbots/public/:hash
-   * Results are cached in memory for 5 minutes to speed up repeated loads (e.g. preview).
+   * Endpoint: GET /chatbots/public/:hash
+   * Results are cached in memory for 5 minutes (key: apiURL:publicHash).
    *
-   * @param apiURL - Base URL of the API
-   * @param publicHash - Public hash of the chatbot
-   * @returns The chatbot with domain, settings, instructions
-   * @throws Error when chatbot is not found (404 or other error status)
+   * @param apiURL - Base URL of the API (no trailing slash)
+   * @param publicHash - Public hash of the chatbot (from admin/embed config)
+   * @returns Promise resolving to ChatbotPublicResponse (id, name, domain, etc.)
+   * @throws Error when chatbot is not found (e.g. 404) or request fails
    */
   export const getChatbotByPublicHash: (apiURL: string, publicHash: string) => Promise<ChatbotTypes.ChatbotPublicResponse>;
   //# sourceMappingURL=chatbot.api.d.ts.map
@@ -853,25 +924,34 @@ declare module '@ibti-tech/chatbot/services/chatbot/chatbot.api.d.ts' {
 declare module '@ibti-tech/chatbot/services/feedback/feedback.api' {
   import type { SendUserChatFeedbackParams } from '@ibti-tech/chatbot/services/types/index';
   /**
-   * Sends user feedback (rating) for the chat session.
-   * POST /chat/feedback
-   *
-   * When publicHash and visitorId are provided, the API can associate
-   * the feedback with the correct conversation.
+   * Sends user feedback (rating) for the current chat session.
+   * Endpoint: POST /chat/feedback
+   * Body: locale, rating_score, chat_context, message (optional), hash (optional), visitorId (optional).
    *
-   * @param params - Feedback data including rating, context, optional hash/visitorId
-   * @returns The fetch Response (caller should check response.ok)
+   * @param params - SendUserChatFeedbackParams: apiURL, locale, chatContext, ratingScore, optional description, publicHash, visitorId
+   * @returns Promise resolving to the fetch Response; check response.ok for success
    */
   export const sendUserChatFeedback: ({ apiURL, chatContext, locale, ratingScore, description, publicHash, visitorId, }: SendUserChatFeedbackParams) => Promise<Response>;
   //# sourceMappingURL=feedback.api.d.ts.map
 }
 declare module '@ibti-tech/chatbot/services/feedback/feedback.api.d.ts' {
-  {"version":3,"file":"feedback.api.d.ts","sourceRoot":"","sources":["../../../../../home/runner/work/ibti-chatbot/ibti-chatbot/src/services/feedback/feedback.api.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,UAAU,CAAA;AAE1D;;;;;;;;;GASG;AACH,eAAO,MAAM,oBAAoB,GAAU,mFAQxC,0BAA0B,KAAG,OAAO,CAAC,QAAQ,CAa/C,CAAA"}
+  {"version":3,"file":"feedback.api.d.ts","sourceRoot":"","sources":["../../../../../home/runner/work/ibti-chatbot/ibti-chatbot/src/services/feedback/feedback.api.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,UAAU,CAAA;AAE1D;;;;;;;GAOG;AACH,eAAO,MAAM,oBAAoB,GAAU,mFAQxC,0BAA0B,KAAG,OAAO,CAAC,QAAQ,CAa/C,CAAA"}
 }
 declare module '@ibti-tech/chatbot/services/index' {
   /**
-   * Services barrel export.
-   * Provides backward-compatible imports from 'services/chatbot-api' equivalent.
+   * Chatbot API services (barrel).
+   * Use these when integrating the chatbot or building a custom client.
+   *
+   * Chatbot config:
+   * - getChatbotByPublicHash(apiURL, publicHash) → ChatbotPublicResponse
+   *
+   * Chat:
+   * - sendChatContext(options) → streams completion, calls onReceiving/onDone
+   * - checkApiHealth(apiUrl, locale?, publicHash?) → boolean
+   * - getWelcomeMessage(apiUrl, locale?, publicHash?) → string
+   *
+   * Feedback:
+   * - sendUserChatFeedback(params) → Response
    */
   export { getChatbotByPublicHash } from '@ibti-tech/chatbot/services/chatbot/chatbot.api';
   export { sendChatContext, checkApiHealth, getWelcomeMessage, } from '@ibti-tech/chatbot/services/chat/chat.api';
@@ -880,24 +960,32 @@ declare module '@ibti-tech/chatbot/services/index' {
   //# sourceMappingURL=index.d.ts.map
 }
 declare module '@ibti-tech/chatbot/services/index.d.ts' {
-  {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../home/runner/work/ibti-chatbot/ibti-chatbot/src/services/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAA;AAC9D,OAAO,EACL,eAAe,EACf,cAAc,EACd,iBAAiB,GAClB,MAAM,iBAAiB,CAAA;AACxB,OAAO,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAA;AAE9D,YAAY,EACV,sBAAsB,EACtB,qBAAqB,EACrB,oBAAoB,EACpB,0BAA0B,GAC3B,MAAM,SAAS,CAAA"}
+  {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../home/runner/work/ibti-chatbot/ibti-chatbot/src/services/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAA;AAC9D,OAAO,EACL,eAAe,EACf,cAAc,EACd,iBAAiB,GAClB,MAAM,iBAAiB,CAAA;AACxB,OAAO,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAA;AAE9D,YAAY,EACV,sBAAsB,EACtB,qBAAqB,EACrB,oBAAoB,EACpB,0BAA0B,GAC3B,MAAM,SAAS,CAAA"}
 }
 declare module '@ibti-tech/chatbot/services/types/chat.types' {
   import { ChatbotTypes } from 'types';
   /**
-   * Options for sending a new question to the chat completion endpoint.
+   * Options for sending a new question to the chat completion endpoint (POST /chat/completion).
+   * Used by `sendChatContext`.
    */
   export type SendNewQuestionOptions = {
+      /** Ordered list of messages (role + content) to send as context. */
       chatContext: Pick<ChatbotTypes.ChatMessage, 'content' | 'role'>[];
+      /** Locale for the request: `'pt-BR'` | `'en'`. */
       locale: ChatbotTypes.Locale;
+      /** Base URL of the chatbot API (no trailing slash). */
       apiURL: string;
+      /** Optional. Public hash of the chatbot (required for domain-validated API). */
       publicHash?: string;
+      /** Optional. Stable visitor id for conversation continuity. */
       visitorId?: string;
+      /** Called for each streamed chunk: full message so far and the new chunk. */
       onReceiving: (receivedMessage: string, receivedPart: string) => void;
+      /** Called when the stream finishes. */
       onDone: () => void;
   };
   /**
-   * Options for fetching suggested questions (currently unused).
+   * Options for fetching suggested questions (currently unused in UI).
    */
   export type GetSuggestedQuestions = {
       chatContext: Pick<ChatbotTypes.ChatMessage, 'content' | 'role'>[];
@@ -905,32 +993,40 @@ declare module '@ibti-tech/chatbot/services/types/chat.types' {
       apiURL: string;
   };
   /**
-   * DTO for suggested questions response.
+   * Suggested question DTO (single string per item; API may return an array of these).
    */
   export type SuggestedQuestionDTO = string;
   //# sourceMappingURL=chat.types.d.ts.map
 }
 declare module '@ibti-tech/chatbot/services/types/chat.types.d.ts' {
-  {"version":3,"file":"chat.types.d.ts","sourceRoot":"","sources":["../../../../../home/runner/work/ibti-chatbot/ibti-chatbot/src/services/types/chat.types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,OAAO,CAAA;AAEpC;;GAEG;AACH,MAAM,MAAM,sBAAsB,GAAG;IACnC,WAAW,EAAE,IAAI,CAAC,YAAY,CAAC,WAAW,EAAE,SAAS,GAAG,MAAM,CAAC,EAAE,CAAA;IACjE,MAAM,EAAE,YAAY,CAAC,MAAM,CAAA;IAC3B,MAAM,EAAE,MAAM,CAAA;IACd,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,WAAW,EAAE,CAAC,eAAe,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,KAAK,IAAI,CAAA;IACpE,MAAM,EAAE,MAAM,IAAI,CAAA;CACnB,CAAA;AAED;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG;IAClC,WAAW,EAAE,IAAI,CAAC,YAAY,CAAC,WAAW,EAAE,SAAS,GAAG,MAAM,CAAC,EAAE,CAAA;IACjE,MAAM,EAAE,YAAY,CAAC,MAAM,CAAA;IAC3B,MAAM,EAAE,MAAM,CAAA;CACf,CAAA;AAED;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG,MAAM,CAAA"}
+  {"version":3,"file":"chat.types.d.ts","sourceRoot":"","sources":["../../../../../home/runner/work/ibti-chatbot/ibti-chatbot/src/services/types/chat.types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,OAAO,CAAA;AAEpC;;;GAGG;AACH,MAAM,MAAM,sBAAsB,GAAG;IACnC,oEAAoE;IACpE,WAAW,EAAE,IAAI,CAAC,YAAY,CAAC,WAAW,EAAE,SAAS,GAAG,MAAM,CAAC,EAAE,CAAA;IACjE,kDAAkD;IAClD,MAAM,EAAE,YAAY,CAAC,MAAM,CAAA;IAC3B,uDAAuD;IACvD,MAAM,EAAE,MAAM,CAAA;IACd,gFAAgF;IAChF,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,+DAA+D;IAC/D,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,6EAA6E;IAC7E,WAAW,EAAE,CAAC,eAAe,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,KAAK,IAAI,CAAA;IACpE,uCAAuC;IACvC,MAAM,EAAE,MAAM,IAAI,CAAA;CACnB,CAAA;AAED;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG;IAClC,WAAW,EAAE,IAAI,CAAC,YAAY,CAAC,WAAW,EAAE,SAAS,GAAG,MAAM,CAAC,EAAE,CAAA;IACjE,MAAM,EAAE,YAAY,CAAC,MAAM,CAAA;IAC3B,MAAM,EAAE,MAAM,CAAA;CACf,CAAA;AAED;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG,MAAM,CAAA"}
 }
 declare module '@ibti-tech/chatbot/services/types/feedback.types' {
   import { ChatbotTypes } from 'types';
   /**
-   * Parameters for sending user chat feedback (rating).
+   * Parameters for sending user chat feedback (POST /chat/feedback).
+   * Used by `sendUserChatFeedback`.
    */
   export type SendUserChatFeedbackParams = {
+      /** Locale: `'pt-BR'` | `'en'`. */
       locale: ChatbotTypes.Locale;
+      /** Base URL of the chatbot API. */
       apiURL: string;
+      /** Optional. Public hash of the chatbot. */
       publicHash?: string;
+      /** Optional. Visitor id to associate feedback with the conversation. */
       visitorId?: string;
+      /** Current conversation context (role + content) for the session being rated. */
       chatContext: Pick<ChatbotTypes.ChatMessage, 'content' | 'role'>[];
+      /** Rating score (e.g. 1–5). */
       ratingScore: number;
+      /** Optional. Free-text feedback. */
       description?: string;
   };
   //# sourceMappingURL=feedback.types.d.ts.map
 }
 declare module '@ibti-tech/chatbot/services/types/feedback.types.d.ts' {
-  {"version":3,"file":"feedback.types.d.ts","sourceRoot":"","sources":["../../../../../home/runner/work/ibti-chatbot/ibti-chatbot/src/services/types/feedback.types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,OAAO,CAAA;AAEpC;;GAEG;AACH,MAAM,MAAM,0BAA0B,GAAG;IACvC,MAAM,EAAE,YAAY,CAAC,MAAM,CAAA;IAC3B,MAAM,EAAE,MAAM,CAAA;IACd,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,WAAW,EAAE,IAAI,CAAC,YAAY,CAAC,WAAW,EAAE,SAAS,GAAG,MAAM,CAAC,EAAE,CAAA;IACjE,WAAW,EAAE,MAAM,CAAA;IACnB,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB,CAAA"}
+  {"version":3,"file":"feedback.types.d.ts","sourceRoot":"","sources":["../../../../../home/runner/work/ibti-chatbot/ibti-chatbot/src/services/types/feedback.types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,OAAO,CAAA;AAEpC;;;GAGG;AACH,MAAM,MAAM,0BAA0B,GAAG;IACvC,kCAAkC;IAClC,MAAM,EAAE,YAAY,CAAC,MAAM,CAAA;IAC3B,mCAAmC;IACnC,MAAM,EAAE,MAAM,CAAA;IACd,4CAA4C;IAC5C,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,wEAAwE;IACxE,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,iFAAiF;IACjF,WAAW,EAAE,IAAI,CAAC,YAAY,CAAC,WAAW,EAAE,SAAS,GAAG,MAAM,CAAC,EAAE,CAAA;IACjE,+BAA+B;IAC/B,WAAW,EAAE,MAAM,CAAA;IACnB,oCAAoC;IACpC,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB,CAAA"}
 }
 declare module '@ibti-tech/chatbot/services/types/index' {
   export * from '@ibti-tech/chatbot/services/types/chat.types';
@@ -1072,33 +1168,64 @@ declare module '@ibti-tech/chatbot/themes/index.d.ts' {
   {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../home/runner/work/ibti-chatbot/ibti-chatbot/src/themes/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoB,iBAAiB,EAAE,MAAM,eAAe,CAAA;AACnE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,OAAO,CAAA;AAEzC,eAAO,MAAM,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAGlB,CAAA;AAED,gDAAgD;AAChD,wBAAgB,0BAA0B,CACxC,SAAS,EAAE,OAAO,iBAAiB,EACnC,YAAY,CAAC,EAAE,YAAY,CAAC,YAAY,GACvC,OAAO,iBAAiB,CAqC1B"}
 }
 declare module '@ibti-tech/chatbot/types/index' {
+  /**
+   * Chatbot frontend type definitions.
+   * Use these types when integrating the chatbot as a client (React app or embed).
+   */
   export namespace ChatbotTypes {
+      /** UI theme: `'light'` or `'dark'`. */
       type Theme = 'light' | 'dark';
+      /** Supported locales: `'pt-BR'` | `'en'`. */
       type Locale = 'pt-BR' | 'en';
-      /** Custom colors to override chatbot theme elements. Values in hex (#rrggbb) or rgb(r,g,b). */
+      /**
+       * Custom colors to override chatbot theme elements.
+       * Values: hex (e.g. `#rrggbb`) or `rgb(r,g,b)`.
+       */
       interface CustomColors {
-          /** Primary accent: header avatar, toggle, buttons, user balloons, links, scrollbars */
+          /** Primary accent: header avatar, toggle button, action buttons, user balloons, links, scrollbars. */
           primaryColor?: string;
-          /** Header bar background. Defaults to primaryColor if not set */
+          /** Header bar background. Defaults to `primaryColor` if not set. */
           headerBackground?: string;
-          /** User message balloon background. Defaults to primaryColor if not set */
+          /** User message balloon background. Defaults to `primaryColor` if not set. */
           userBalloonColor?: string;
       }
+      /**
+       * A single message in the chat thread (user or assistant).
+       */
       type ChatMessage = {
+          /** Unique message id (e.g. UUID). */
           id: string;
+          /** ISO/UTC timestamp string. */
           timestamp: string;
+          /** Sender: `'user'` or `'assistant'`. */
           role: 'user' | 'assistant';
+          /** Message body (plain text). */
           content: string;
+          /** When true, content is an error message to display. */
           error?: boolean;
       };
+      /**
+       * Minimal message shape for API context (role + content only).
+       * Used when sending chat context to completion or feedback endpoints.
+       */
       type ChatContextItem = {
           role: 'user' | 'assistant';
           content: string;
       };
+      /** Widget status shown in the header: writing indicator, loading, online, or unavailable. */
       type Status = 'writing' | 'loading' | 'online' | 'unavailable';
-      /** Status of the widget initialization */
+      /**
+       * Initialization state of the widget (when using `publicHash`).
+       * - `loading`: fetching chatbot config
+       * - `domain_not_allowed`: current origin not in allowed domains
+       * - `error`: network or API error
+       * - `ready`: widget ready to chat
+       */
       type InitializationStatus = 'loading' | 'domain_not_allowed' | 'error' | 'ready';
-      /** Response from GET /chatbots/public/:hash */
+      /**
+       * Response from GET `/chatbots/public/:hash`.
+       * Contains chatbot metadata and domain info.
+       */
       interface ChatbotPublicResponse {
           id: number;
           name: string;
@@ -1112,12 +1239,21 @@ declare module '@ibti-tech/chatbot/types/index' {
           chatInstructions?: unknown;
           client?: unknown;
       }
+      /**
+       * Optional config for API and domain behaviour.
+       * Used internally; for embed/client prefer ChatbotProvider props or IBTIChatbotEmbedConfig.
+       */
       interface Config {
           apiURL?: string;
           publicHash?: string;
           additionalInstructions?: string;
+          /** Origins that skip domain validation (e.g. for preview). */
           allowedOriginsWithoutCheck?: string[];
       }
+      /**
+       * Custom UI copy per section (locale key → strings).
+       * Override only the keys you need; rest use defaults.
+       */
       interface CustomTexts {
           CHATBOT_NAME?: string;
           INPUT_PLACEHOLDER?: string;
@@ -1155,6 +1291,7 @@ declare module '@ibti-tech/chatbot/types/index' {
           USER_LABEL?: string;
           WRITING_MESSAGE?: string;
       }
+      /** Map of locale code to CustomTexts. Example: `{ 'pt-BR': { ... }, 'en': { ... } }`. */
       interface Texts {
           [locale: string]: CustomTexts;
       }
@@ -1162,7 +1299,7 @@ declare module '@ibti-tech/chatbot/types/index' {
   //# sourceMappingURL=index.d.ts.map
 }
 declare module '@ibti-tech/chatbot/types/index.d.ts' {
-  {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../home/runner/work/ibti-chatbot/ibti-chatbot/src/types/index.ts"],"names":[],"mappings":"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"}
+  {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../home/runner/work/ibti-chatbot/ibti-chatbot/src/types/index.ts"],"names":[],"mappings":"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"}
 }
 declare module '@ibti-tech/chatbot/utils/domainValidation' {
   /**

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@ibti-tech/chatbot",
-  "version": "0.8.0",
-  "description": "Chatbot developed for IBTI products",
+  "version": "0.8.1",
+  "description": "Chatbot system developed to be embedded in any website",
   "packageManager": "yarn@3.6.4",
   "main": "./dist/index.mjs",
   "types": "./dist/index.d.ts",