@botuyo/chat-widget-standalone 1.0.0 → 1.0.2

package/dist/src/chat-widget/hooks/useFocusTrap.d.ts

@@ -0,0 +1,34 @@
+/**
+ * @package @botuyo/chat-widget
+ * Focus management hook for accessible dialogs
+ *
+ * Principio: Single Responsibility - solo gestionar el foco del teclado
+ */
+interface UseFocusTrapOptions {
+    /** Si el trap está activo */
+    enabled: boolean;
+    /** Elemento al que retornar el foco al desactivar */
+    returnFocusRef?: React.RefObject<HTMLElement>;
+    /** Callback al cerrar con Escape */
+    onEscape?: () => void;
+}
+/**
+ * Hook para atrapar el foco dentro de un contenedor (dialog, modal)
+ *
+ * Características:
+ * - Previene que Tab salga del contenedor
+ * - Retorna el foco al elemento anterior al cerrar
+ * - Cierra con tecla Escape
+ * - Compatible con lectores de pantalla
+ *
+ * @example
+ * const containerRef = useFocusTrap({
+ *   enabled: isOpen,
+ *   onEscape: handleClose
+ * })
+ *
+ * return <div ref={containerRef}>...</div>
+ */
+export declare function useFocusTrap({ enabled, returnFocusRef, onEscape }: UseFocusTrapOptions): import("react").RefObject<HTMLDivElement | null>;
+export {};
+//# sourceMappingURL=useFocusTrap.d.ts.map

package/dist/src/chat-widget/hooks/useFocusTrap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useFocusTrap.d.ts","sourceRoot":"","sources":["../../../../src/chat-widget/hooks/useFocusTrap.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,UAAU,mBAAmB;IAC3B,6BAA6B;IAC7B,OAAO,EAAE,OAAO,CAAA;IAChB,qDAAqD;IACrD,cAAc,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC,WAAW,CAAC,CAAA;IAC7C,oCAAoC;IACpC,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAA;CACtB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,YAAY,CAAC,EAAE,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,EAAE,mBAAmB,oDA+EtF"}

package/dist/src/chat-widget/hooks/useHighContrast.d.ts

@@ -0,0 +1,6 @@
+/**
+ * @package @botuyo/chat-widget
+ * Hook para detectar y soportar modo de alto contraste (WCAG AAA)
+ */
+export declare function useHighContrast(): boolean;
+//# sourceMappingURL=useHighContrast.d.ts.map

package/dist/src/chat-widget/hooks/useHighContrast.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useHighContrast.d.ts","sourceRoot":"","sources":["../../../../src/chat-widget/hooks/useHighContrast.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,wBAAgB,eAAe,YA4B9B"}

package/dist/src/chat-widget/hooks/useIsMobile.d.ts

@@ -0,0 +1,2 @@
+export declare function useIsMobile(breakpoint?: number): boolean;
+//# sourceMappingURL=useIsMobile.d.ts.map

package/dist/src/chat-widget/hooks/useIsMobile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useIsMobile.d.ts","sourceRoot":"","sources":["../../../../src/chat-widget/hooks/useIsMobile.ts"],"names":[],"mappings":"AAGA,wBAAgB,WAAW,CAAC,UAAU,SAAM,WAkB3C"}

package/dist/src/chat-widget/hooks/useNotifications.d.ts

@@ -0,0 +1,23 @@
+/**
+ * @package @botuyo/chat-widget
+ * Hook para notificaciones desktop y sonoras
+ */
+import type { ChatMessage } from '../types';
+export interface UseNotificationsOptions {
+    enabled?: boolean;
+    soundEnabled?: boolean;
+    desktopEnabled?: boolean;
+    botName?: string;
+    /** Custom logo URL. If not provided, uses bundled default avatar */
+    logoUrl?: string;
+    /** Custom notification sound URL. If not provided, uses bundled default sound */
+    notificationSoundUrl?: string;
+}
+export declare function useNotifications({ enabled, soundEnabled, desktopEnabled, botName, logoUrl, notificationSoundUrl, }?: UseNotificationsOptions): {
+    permission: NotificationPermission;
+    requestPermission: () => Promise<boolean>;
+    notify: (message: ChatMessage) => void;
+    playSound: () => void;
+    notifyWithSound: (message: ChatMessage) => void;
+};
+//# sourceMappingURL=useNotifications.d.ts.map

package/dist/src/chat-widget/hooks/useNotifications.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useNotifications.d.ts","sourceRoot":"","sources":["../../../../src/chat-widget/hooks/useNotifications.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAA;AAI3C,MAAM,WAAW,uBAAuB;IACtC,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,oEAAoE;IACpE,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,iFAAiF;IACjF,oBAAoB,CAAC,EAAE,MAAM,CAAA;CAC9B;AAED,wBAAgB,gBAAgB,CAAC,EAC/B,OAAc,EACd,YAAmB,EACnB,cAAqB,EACrB,OAAqB,EACrB,OAAO,EACP,oBAAoB,GACrB,GAAE,uBAA4B;;;sBA0CjB,WAAW;;+BA2DX,WAAW;EAcxB"}

package/dist/src/chat-widget/hooks/useRateLimit.d.ts

@@ -0,0 +1,15 @@
+/**
+ * @package @botuyo/chat-widget
+ * Hook para rate limiting y protección contra spam
+ */
+export interface UseRateLimitOptions {
+    maxMessages: number;
+    windowMs: number;
+}
+export declare function useRateLimit(maxMessages?: number, windowMs?: number): {
+    isAllowed: () => boolean;
+    getRemainingAttempts: () => number;
+    getTimeUntilReset: () => number;
+    reset: () => void;
+};
+//# sourceMappingURL=useRateLimit.d.ts.map

package/dist/src/chat-widget/hooks/useRateLimit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useRateLimit.d.ts","sourceRoot":"","sources":["../../../../src/chat-widget/hooks/useRateLimit.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,MAAM,WAAW,mBAAmB;IAClC,WAAW,EAAE,MAAM,CAAA;IACnB,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED,wBAAgB,YAAY,CAAC,WAAW,SAAK,EAAE,QAAQ,SAAQ;;;;;EA6C9D"}

package/dist/src/chat-widget/hooks/useSEOMetadata.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Hook interno del widget para capturar metadata SEO del DOM
+ */
+/**
+ * Hook para capturar metadata SEO
+ * @param enabled - Si está habilitado
+ * @param pathname - Pathname actual para detectar cambios de página
+ */
+export declare function useSEOMetadata(enabled?: boolean): Record<string, any> | undefined;
+//# sourceMappingURL=useSEOMetadata.d.ts.map

package/dist/src/chat-widget/hooks/useSEOMetadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSEOMetadata.d.ts","sourceRoot":"","sources":["../../../../src/chat-widget/hooks/useSEOMetadata.ts"],"names":[],"mappings":"AAAA;;GAEG;AAiFH;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,OAAO,GAAE,OAAe,mCAqBtD"}

package/dist/src/chat-widget/hooks/useWidgetTheme.d.ts

@@ -0,0 +1,12 @@
+import type { ChatTheme, BubbleStyles } from '../types';
+/**
+ * Hook para gestionar el tema del widget
+ * Maneja el merge de temas con prioridades: proyecto > socket > default
+ * También gestiona alto contraste y estilos de burbujas
+ */
+export declare function useWidgetTheme(projectTheme?: ChatTheme, socketTheme?: ChatTheme): {
+    mergedTheme: Required<Omit<ChatTheme, "defaultLocale" | "avatars" | "emotion" | "starterPrompt" | "launcherBorderRadius" | "borderRadius" | "bubbleStyles" | "promptPersistence" | "avatarScale" | "height" | "bottom">>;
+    mergedStyles: BubbleStyles;
+    getContainerStyle: (isOpen: boolean, isMobile: boolean, position?: "bottom-left" | "bottom-right") => React.CSSProperties;
+};
+//# sourceMappingURL=useWidgetTheme.d.ts.map

package/dist/src/chat-widget/hooks/useWidgetTheme.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useWidgetTheme.d.ts","sourceRoot":"","sources":["../../../../src/chat-widget/hooks/useWidgetTheme.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,UAAU,CAAA;AAqBvD;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,YAAY,CAAC,EAAE,SAAS,EAAE,WAAW,CAAC,EAAE,SAAS;;;gCA+CpE,OAAO,YACL,OAAO,aACN,aAAa,GAAG,cAAc,KACxC,KAAK,CAAC,aAAa;EAqBvB"}

package/dist/src/chat-widget/i18n/LanguageContext.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Contexto de idioma para el Chat Widget
+ * Permite cambio dinámico de idioma con persistencia en localStorage
+ */
+import { type ReactNode } from 'react';
+import { type SupportedLocale } from './translations';
+interface LanguageContextType {
+    locale: SupportedLocale;
+    setLocale: (locale: SupportedLocale) => void;
+}
+interface LanguageProviderProps {
+    children: ReactNode;
+    defaultLocale?: SupportedLocale;
+}
+/**
+ * Provider de idioma con detección automática y persistencia
+ *
+ * @example
+ * <LanguageProvider>
+ *   <ChatWidget />
+ * </LanguageProvider>
+ */
+export declare function LanguageProvider({ children, defaultLocale }: LanguageProviderProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * Hook para acceder al idioma actual del widget
+ *
+ * @example
+ * const { locale, setLocale } = useLanguage()
+ * setLocale('en') // Cambiar a inglés
+ */
+export declare function useLanguage(): LanguageContextType;
+export {};
+//# sourceMappingURL=LanguageContext.d.ts.map

package/dist/src/chat-widget/i18n/LanguageContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LanguageContext.d.ts","sourceRoot":"","sources":["../../../../src/chat-widget/i18n/LanguageContext.tsx"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAkD,KAAK,SAAS,EAAE,MAAM,OAAO,CAAA;AACtF,OAAO,EAAE,KAAK,eAAe,EAAkB,MAAM,gBAAgB,CAAA;AAErE,UAAU,mBAAmB;IAC3B,MAAM,EAAE,eAAe,CAAA;IACvB,SAAS,EAAE,CAAC,MAAM,EAAE,eAAe,KAAK,IAAI,CAAA;CAC7C;AAMD,UAAU,qBAAqB;IAC7B,QAAQ,EAAE,SAAS,CAAA;IACnB,aAAa,CAAC,EAAE,eAAe,CAAA;CAChC;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,EAAE,QAAQ,EAAE,aAAa,EAAE,EAAE,qBAAqB,2CAgDlF;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,wBAM1B"}

package/dist/src/chat-widget/i18n/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Sistema de internacionalización del Chat Widget
+ * Exportaciones centralizadas
+ */
+export { useTranslations, t, default } from './useTranslations';
+export { translations, detectLanguage, type SupportedLocale } from './translations';
+export { LanguageProvider, useLanguage } from './LanguageContext';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/chat-widget/i18n/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/chat-widget/i18n/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,eAAe,EAAE,CAAC,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAA;AAC/D,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,KAAK,eAAe,EAAE,MAAM,gBAAgB,CAAA;AACnF,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA"}

package/dist/src/chat-widget/i18n/translations.d.ts

@@ -0,0 +1,177 @@
+/**
+ * Sistema de internacionalización del Chat Widget
+ * Idiomas soportados: español, inglés, portugués, francés
+ */
+export declare const translations: {
+    es: {
+        online: string;
+        offline: string;
+        connecting: string;
+        con_amor_paseo_libre: string;
+        preview: string;
+        fotos: string;
+        ubicacion: string;
+        input_placeholder: string;
+        send: string;
+        attach_photo: string;
+        attach_location: string;
+        recording: string;
+        rate_limit_exceeded: string;
+        connection_error: string;
+        file_too_large: string;
+        invalid_file: string;
+        extracted: {
+            assistant: string;
+            anterior: string;
+            siguiente: string;
+            cerrar: string;
+            cerrar_chat: string;
+            abrir_chat: string;
+            ver_ubicacion: string;
+        };
+        accessibility: {
+            closeChat: string;
+            closeChatHint: string;
+            chatMessages: string;
+            messageHistory: string;
+            dialogDescription: string;
+            sendMessage: string;
+            sendMessageHint: string;
+            typeMessage: string;
+            botMessage: string;
+            userMessage: string;
+            messageFrom: string;
+            messageTime: string;
+            newMessage: string;
+        };
+    };
+    en: {
+        online: string;
+        offline: string;
+        connecting: string;
+        con_amor_paseo_libre: string;
+        preview: string;
+        fotos: string;
+        ubicacion: string;
+        input_placeholder: string;
+        send: string;
+        attach_photo: string;
+        attach_location: string;
+        recording: string;
+        rate_limit_exceeded: string;
+        connection_error: string;
+        file_too_large: string;
+        invalid_file: string;
+        extracted: {
+            assistant: string;
+            anterior: string;
+            siguiente: string;
+            cerrar: string;
+            cerrar_chat: string;
+            abrir_chat: string;
+            ver_ubicacion: string;
+        };
+        accessibility: {
+            closeChat: string;
+            closeChatHint: string;
+            chatMessages: string;
+            messageHistory: string;
+            dialogDescription: string;
+            sendMessage: string;
+            sendMessageHint: string;
+            typeMessage: string;
+            botMessage: string;
+            userMessage: string;
+            messageFrom: string;
+            messageTime: string;
+            newMessage: string;
+        };
+    };
+    pt: {
+        online: string;
+        offline: string;
+        connecting: string;
+        con_amor_paseo_libre: string;
+        preview: string;
+        fotos: string;
+        ubicacion: string;
+        input_placeholder: string;
+        send: string;
+        attach_photo: string;
+        attach_location: string;
+        recording: string;
+        rate_limit_exceeded: string;
+        connection_error: string;
+        file_too_large: string;
+        invalid_file: string;
+        extracted: {
+            assistant: string;
+            anterior: string;
+            siguiente: string;
+            cerrar: string;
+            cerrar_chat: string;
+            abrir_chat: string;
+            ver_ubicacion: string;
+        };
+        accessibility: {
+            closeChat: string;
+            closeChatHint: string;
+            chatMessages: string;
+            messageHistory: string;
+            dialogDescription: string;
+            sendMessage: string;
+            sendMessageHint: string;
+            typeMessage: string;
+            botMessage: string;
+            userMessage: string;
+            messageFrom: string;
+            messageTime: string;
+            newMessage: string;
+        };
+    };
+    fr: {
+        online: string;
+        offline: string;
+        connecting: string;
+        con_amor_paseo_libre: string;
+        preview: string;
+        fotos: string;
+        ubicacion: string;
+        input_placeholder: string;
+        send: string;
+        attach_photo: string;
+        attach_location: string;
+        recording: string;
+        rate_limit_exceeded: string;
+        connection_error: string;
+        file_too_large: string;
+        invalid_file: string;
+        extracted: {
+            assistant: string;
+            anterior: string;
+            siguiente: string;
+            cerrar: string;
+            cerrar_chat: string;
+            abrir_chat: string;
+            ver_ubicacion: string;
+        };
+        accessibility: {
+            closeChat: string;
+            closeChatHint: string;
+            chatMessages: string;
+            messageHistory: string;
+            dialogDescription: string;
+            sendMessage: string;
+            sendMessageHint: string;
+            typeMessage: string;
+            botMessage: string;
+            userMessage: string;
+            messageFrom: string;
+            messageTime: string;
+            newMessage: string;
+        };
+    };
+};
+export type SupportedLocale = keyof typeof translations;
+export declare function detectLanguage(): SupportedLocale;
+//# sourceMappingURL=translations.d.ts.map

package/dist/src/chat-widget/i18n/translations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"translations.d.ts","sourceRoot":"","sources":["../../../../src/chat-widget/i18n/translations.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyNxB,CAAA;AAED,MAAM,MAAM,eAAe,GAAG,MAAM,OAAO,YAAY,CAAA;AAGvD,wBAAgB,cAAc,IAAI,eAAe,CAKhD"}

package/dist/src/chat-widget/i18n/useTranslations.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Hook de internacionalización para el Chat Widget
+ * Sistema multi-idioma con detección automática y contexto global
+ */
+import { type SupportedLocale } from './translations';
+/**
+ * Hook para acceder a las traducciones con soporte multi-idioma
+ * Usa el contexto global de idioma automáticamente
+ *
+ * @example
+ * const { t, setLocale, currentLocale } = useTranslations()
+ * t('online') // 'En línea' (si locale es 'es')
+ * t('extracted.cerrar') // 'Cerrar'
+ * setLocale('en') // Cambiar a inglés
+ */
+export declare function useTranslations(namespace?: string): {
+    t: (key: string) => string;
+    setLocale: (locale: SupportedLocale) => void;
+    currentLocale: "es" | "en" | "pt" | "fr";
+};
+/**
+ * Función para obtener traducción directamente sin hook
+ * Útil para uso fuera de componentes
+ */
+export declare function t(key: string, locale?: SupportedLocale): string;
+export default useTranslations;
+//# sourceMappingURL=useTranslations.d.ts.map

package/dist/src/chat-widget/i18n/useTranslations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useTranslations.d.ts","sourceRoot":"","sources":["../../../../src/chat-widget/i18n/useTranslations.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAgB,KAAK,eAAe,EAAE,MAAM,gBAAgB,CAAA;AAQnE;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAAC,SAAS,CAAC,EAAE,MAAM;aAIxC,MAAM,KAAG,MAAM;;;EAcxB;AAED;;;GAGG;AACH,wBAAgB,CAAC,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,GAAE,eAAsB,GAAG,MAAM,CAErE;AAED,eAAe,eAAe,CAAA"}

package/dist/src/chat-widget/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * @package @botuyo/chat-widget
+ * Entry Point - Exporta el componente principal, Provider y tipos
+ */
+export { ChatWidget } from './ChatWidget';
+export { ChatWidgetProvider, useChatWidget } from './ChatWidgetProvider';
+export type { ChatWidgetContextValue } from './ChatWidgetProvider';
+export type { ChatWidgetProps, ChatTheme, UserContext, ChatMessage, TextMessage, ImageMessage, AudioMessage, LocationMessage, PageContext, BubbleStyles, AuthenticatedUser, } from './types';
+export type { ChatWidgetProviderProps } from './ChatWidgetProvider';
+export { ChatWidgetProvider as default } from './ChatWidgetProvider';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/chat-widget/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/chat-widget/index.tsx"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AACzC,OAAO,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AACxE,YAAY,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAA;AAGlE,YAAY,EACV,eAAe,EACf,SAAS,EACT,WAAW,EACX,WAAW,EACX,WAAW,EACX,YAAY,EACZ,YAAY,EACZ,eAAe,EACf,WAAW,EACX,YAAY,EACZ,iBAAiB,GAClB,MAAM,SAAS,CAAA;AAEhB,YAAY,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAA;AAGnE,OAAO,EAAE,kBAAkB,IAAI,OAAO,EAAE,MAAM,sBAAsB,CAAA"}