@botuyo/chat-widget-standalone 1.0.55 → 1.0.56

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"}

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

@@ -0,0 +1,328 @@
+/**
+ * @package @botuyo/chat-widget
+ * Tipos principales del Chat Widget
+ */
+import { BotEmotion, EmotionAvatarMap, PromptStrategy } from '../components/Launcher';
+/**
+ * Configuración de funcionalidades multimedia
+ */
+export interface MediaConfig {
+    /** Habilitar envío de imágenes (default: true) */
+    enableImages?: boolean;
+    /** Habilitar grabación y envío de audio (default: true) */
+    enableAudio?: boolean;
+    /** Habilitar voice chat en tiempo real - Enterprise (default: false) */
+    enableVoice?: boolean;
+    /** Habilitar envío de archivos (default: true) */
+    enableFiles?: boolean;
+    /** Habilitar compartir ubicación (default: true) */
+    enableLocation?: boolean;
+    /** Tipos de archivos permitidos (default: todos) */
+    allowedFileTypes?: string[];
+    /** Tamaño máximo de archivo en MB (default: 10) */
+    maxFileSizeMB?: number;
+}
+/**
+ * Animation configuration - all toggleable
+ * Control every aspect of widget animations
+ */
+export interface AnimationConfig {
+    /** Enable all animations (master toggle, default: true) */
+    enabled?: boolean;
+    /** Message entry animation style */
+    messageEntry?: 'slide' | 'fade' | 'scale' | 'spring' | 'none';
+    /** Typing indicator animation style */
+    typingIndicator?: 'dots' | 'wave' | 'pulse' | 'none';
+    /** Enable button micro-interactions (hover, press effects) */
+    buttonEffects?: boolean;
+    /** Enable smooth scroll in message list */
+    smoothScroll?: boolean;
+    /** Animation duration multiplier (0.5 = faster, 2 = slower, default: 1) */
+    speedMultiplier?: number;
+    /** Stagger delay between sequential message animations in ms (default: 50) */
+    staggerDelay?: number;
+    /** Enable chat window entry/exit animations */
+    windowTransitions?: boolean;
+    /** Enable launcher pulse animation */
+    launcherPulse?: boolean;
+}
+/**
+ * Visual effects configuration
+ * Premium visual enhancements - all toggleable
+ */
+export interface EffectsConfig {
+    /** Enable glassmorphism blur effect on headers (default: true) */
+    glassmorphism?: boolean;
+    /** Enable gradient backgrounds (default: true) */
+    gradients?: boolean;
+    /** Enable soft shadow effects (default: true) */
+    softShadows?: boolean;
+    /** Enable glow effects on hover/focus (default: true) */
+    glowEffects?: boolean;
+    /** Enable particle/confetti effects on actions (default: false) */
+    particles?: boolean;
+    /** Enable UI sound effects (default: false) */
+    soundEffects?: boolean;
+    /** Enable haptic feedback on mobile (default: true) */
+    hapticFeedback?: boolean;
+    /** Enable shimmer loading effect (default: true) */
+    shimmerLoading?: boolean;
+    /** Enable hover lift effect on cards (default: true) */
+    hoverLift?: boolean;
+}
+/**
+ * Voice chat configuration (Enterprise tier)
+ * Received from /api/widget/config endpoint
+ */
+export interface VoiceConfig {
+    /** If false, voice feature is disabled for this tenant */
+    enabled: boolean;
+    /** Preferred language for STT/TTS (e.g., 'es-AR', 'en-US') */
+    language?: string;
+    /** Voice ID for TTS (default or custom cloned voice) */
+    voiceId?: string;
+    /** Maximum recording duration in seconds (default: 60) */
+    maxDurationSeconds?: number;
+    /** WebSocket endpoint override (optional) */
+    wsEndpoint?: string;
+}
+/**
+ * Contexto de página que se envía con cada mensaje
+ * El padre puede pasar información sobre qué está viendo el usuario
+ * IMPORTANTE: Esto NO debe causar reconexiones del socket
+ */
+export interface PageContext {
+    page?: string;
+    id?: string | number;
+    url?: string;
+    title?: string;
+    [key: string]: any;
+}
+export interface ChatWidgetProps {
+    /** Public API Key del tenant/cliente */
+    apiKey: string;
+    /** URL base del backend (Gateway). Defaults to 'https://api.botuyo.com' */
+    apiBaseUrl?: string;
+    /** Optional agent flow ID — connects to a specific agent for this tenant */
+    agentId?: string;
+    /**
+     * Contexto de la página actual que se inyecta en cada mensaje
+     * ⚠️ IMPORTANTE: Usa useRef internamente para evitar reconexiones del socket
+     * Ejemplo: { page: 'Room', id: 123, price: 100 }
+     */
+    pageContext?: PageContext;
+    /**
+     * Incluir metadata SEO automáticamente en el contexto
+     * Si es true, captura: title, description, keywords, og:*, twitter:*, structured data
+     * Default: false
+     */
+    includeSEOMetadata?: boolean;
+    theme?: ChatTheme;
+    /** Configuración de funcionalidades multimedia (imágenes, audio, archivos, ubicación) */
+    mediaConfig?: MediaConfig;
+    /** Context del usuario si ya está autenticado en la app host */
+    userContext?: UserContext;
+    /** Se ejecuta cuando el bot completa un login/autenticación */
+    onLogin?: (userData: AuthenticatedUser) => void;
+    /** El bot solicita navegación a una ruta específica */
+    onNavigate?: (url: string) => void;
+    /** Eventos genéricos del widget */
+    onEvent?: (eventName: string, data: any) => void;
+    /** Callback cuando el widget cambia de estado (abierto/cerrado) */
+    onStateChange?: (isOpen: boolean) => void;
+}
+export interface BubbleStyles {
+    radius?: {
+        bubble?: string;
+        image?: string;
+        button?: string;
+        card?: string;
+    };
+    bot?: {
+        bg?: string;
+        text?: string;
+        border?: string;
+    };
+    user?: {
+        text?: string;
+    };
+    mapCard?: {
+        iconBg?: string;
+        iconColor?: string;
+    };
+    launcher?: {
+        bg?: string;
+        pulse?: boolean;
+    };
+}
+export interface ChatTheme {
+    /** Color primario (botón, burbujas del usuario) */
+    primaryColor?: string;
+    /** Nombre del bot que aparece en el header */
+    botName?: string;
+    /** URL del avatar/logo del bot */
+    logoUrl?: string;
+    avatars?: EmotionAvatarMap;
+    /** URL to a .vrm/.glb 3D model for voice call avatar */
+    avatar3dUrl?: string;
+    /** Posición del launcher */
+    position?: 'bottom-right' | 'bottom-left';
+    /** Mensaje de bienvenida personalizado */
+    welcomeMessage?: string;
+    /** Placeholder del input */
+    inputPlaceholder?: string;
+    /** Border radius del chat window (CSS value, ej: '24px', '1.5rem') */
+    borderRadius?: string;
+    /** Border radius del launcher button (CSS value, ej: '50%', '24px') */
+    launcherBorderRadius?: string;
+    /** Altura del chat window en desktop (CSS value, ej: '600px', '80vh') */
+    height?: string;
+    /** Distancia desde el bottom en desktop (CSS value, ej: '24px', '1.5rem') */
+    bottom?: string;
+    starterPrompt?: string;
+    bubbleStyles?: BubbleStyles;
+    promptPersistence?: PromptStrategy;
+    avatarScale?: number;
+    /** Muestra un mini avatar en el prompt bubble (default: false) */
+    showPromptAvatar?: boolean;
+    /** Idioma por defecto del widget */
+    defaultLocale?: 'es' | 'en' | 'pt' | 'fr';
+    /** Oculta el widget completamente (usado para agentes en modo borrador) */
+    isHidden?: boolean;
+    /** Variables CSS personalizadas para design system */
+    cssVariables?: {
+        /** Color de fondo principal (formato HSL sin hsl(), ej: "0 0% 100%") */
+        background?: string;
+        /** Color de texto principal (formato HSL sin hsl(), ej: "240 10% 3.9%") */
+        foreground?: string;
+        /** Color de fondo de tarjetas (formato HSL sin hsl(), ej: "0 0% 100%") */
+        card?: string;
+        /** Color de texto en tarjetas (formato HSL sin hsl(), ej: "240 10% 3.9%") */
+        cardForeground?: string;
+        /** Color primario (formato HSL sin hsl(), ej: "160 84% 39%") */
+        primary?: string;
+        /** Color de texto sobre fondo primario (formato HSL sin hsl(), ej: "0 0% 100%") */
+        primaryForeground?: string;
+        /** Color de fondo silenciado (formato HSL sin hsl(), ej: "240 4.8% 95.9%") */
+        muted?: string;
+        /** Color de texto silenciado (formato HSL sin hsl(), ej: "240 3.8% 46.1%") */
+        mutedForeground?: string;
+        /** Color de bordes (formato HSL sin hsl(), ej: "240 5.9% 90%") */
+        border?: string;
+        /** Color destructivo/error (formato HSL sin hsl(), ej: "0 84.2% 60.2%") */
+        destructive?: string;
+        /** Border radius base (ej: "0.5rem") */
+        radius?: string;
+        /** Spacing 1 - Extra small (ej: "0.25rem") */
+        spacing1?: string;
+        /** Spacing 2 - Small (ej: "0.5rem") */
+        spacing2?: string;
+        /** Spacing 3 - Medium small (ej: "0.75rem") */
+        spacing3?: string;
+        /** Spacing 4 - Medium (ej: "1rem") */
+        spacing4?: string;
+        /** Spacing 5 - Default padding (ej: "0.75rem") */
+        spacing5?: string;
+        /** Spacing 6 - Large (ej: "1.5rem") */
+        spacing6?: string;
+        /** Spacing 8 - Extra large (ej: "2rem") */
+        spacing8?: string;
+    };
+    /** Animation configuration - control all widget animations */
+    animations?: AnimationConfig;
+    /** Visual effects configuration - premium visual enhancements */
+    effects?: EffectsConfig;
+}
+export interface UserContext {
+    /** JWT token para autenticar al usuario real */
+    token?: string;
+    /** Metadata adicional del usuario */
+    metadata?: Record<string, any>;
+}
+export interface AuthenticatedUser {
+    user: {
+        id: string;
+        email?: string;
+        name?: string;
+        token?: string;
+        [key: string]: any;
+    };
+    token: string;
+}
+export type MessageType = 'text' | 'image' | 'location' | 'system' | 'audio' | 'location' | 'file';
+export type MessageSender = 'user' | 'bot' | 'system';
+export interface BaseMessage {
+    id: string;
+    type: MessageType;
+    sender: MessageSender;
+    timestamp: Date;
+}
+export interface TextMessage extends BaseMessage {
+    type: 'text';
+    content: string;
+    emotion?: BotEmotion;
+}
+export interface ImageMessage extends BaseMessage {
+    type: 'image';
+    imageUrl: string;
+    altText?: string;
+}
+export interface LocationMessage extends BaseMessage {
+    type: 'location';
+    latitude: number;
+    longitude: number;
+    name?: string;
+}
+export interface SystemMessage extends BaseMessage {
+    type: 'system';
+    sender: 'system';
+    content: string;
+}
+export interface AudioMessage extends BaseMessage {
+    type: 'audio';
+    content: string;
+}
+export interface FileMessage extends BaseMessage {
+    type: 'file';
+    fileUrl: string;
+    fileName: string;
+    fileSize?: number;
+    mimeType?: string;
+}
+export type ChatMessage = TextMessage | ImageMessage | LocationMessage | SystemMessage | AudioMessage | FileMessage;
+export interface ChatState {
+    isOpen: boolean;
+    isConnected: boolean;
+    isTyping: boolean;
+    messages: ChatMessage[];
+    error: string | null;
+    sessionId: string | null;
+}
+export type ChatAction = {
+    type: 'TOGGLE_WINDOW';
+} | {
+    type: 'OPEN_WINDOW';
+} | {
+    type: 'CLOSE_WINDOW';
+} | {
+    type: 'SET_CONNECTED';
+    payload: boolean;
+} | {
+    type: 'SET_TYPING';
+    payload: boolean;
+} | {
+    type: 'ADD_MESSAGE';
+    payload: ChatMessage;
+} | {
+    type: 'SET_MESSAGES';
+    payload: ChatMessage[];
+} | {
+    type: 'SET_ERROR';
+    payload: string | null;
+} | {
+    type: 'SET_SESSION_ID';
+    payload: string;
+} | {
+    type: 'CLEAR_CHAT';
+};
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/chat-widget/types/index.ts"],"names":[],"mappings":"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"}

package/dist/src/chat-widget/types/socket.d.ts

@@ -0,0 +1,107 @@
+/**
+ * @package @botuyo/chat-widget
+ * Tipos de eventos Socket.IO del protocolo Backend
+ */
+import { BotEmotion } from '../components/Launcher';
+export interface ClientToServerEvents {
+    /** Enviar mensaje del usuario con confirmación opcional */
+    user_message: (data: UserMessagePayload, callback?: (ack: {
+        success: boolean;
+    }) => void) => void;
+    /** Solicitar historial de chat */
+    request_history: () => void;
+    /** Notificar que el usuario está escribiendo */
+    typing: (isTyping: boolean) => void;
+    /** Desconexión manual */
+    disconnect_session: () => void;
+}
+export interface UserMessagePayload {
+    content: string;
+    type: 'text' | 'image' | 'audio' | 'file' | 'location';
+    metadata?: Record<string, any>;
+}
+export interface ServerToClientEvents {
+    /** Mensaje del bot */
+    bot_message: (data: BotMessagePayload) => void;
+    /** Confirmación de conexión con configuración del backend */
+    connection_ack: (data: ConnectionAckPayload) => void;
+    /** Bot está escribiendo */
+    bot_typing: (isTyping: boolean) => void;
+    /** Autenticación exitosa */
+    auth_success: (data: AuthSuccessPayload) => void;
+    /** Error del servidor */
+    error: (data: ErrorPayload) => void;
+    /** Historial de mensajes */
+    chat_history: (data: ChatHistoryPayload) => void;
+    /** Evento de navegación (bot solicita cambio de ruta) */
+    navigate: (url: string) => void;
+    /** Evento genérico custom */
+    custom_event: (data: CustomEventPayload) => void;
+}
+export interface BotMessagePayload {
+    id: string;
+    type: 'text' | 'image' | 'audio' | 'location' | 'system';
+    content?: string;
+    imageUrl?: string;
+    audioUrl?: string;
+    latitude?: number;
+    longitude?: number;
+    timestamp: string;
+    metadata?: Record<string, any>;
+    emotion?: BotEmotion;
+}
+export interface ConnectionAckPayload {
+    sessionId: string;
+    deviceId: string;
+    /** Configuración que el backend puede sobrescribir */
+    config?: {
+        botName?: string;
+        logoUrl?: string;
+        primaryColor?: string;
+        welcomeMessage?: string;
+        avatar3dUrl?: string;
+        avatarAnimations?: Record<string, string>;
+        voiceEnabled?: boolean;
+        isHidden?: boolean;
+    };
+    /** Si el usuario ya tenía sesión previa */
+    hasHistory?: boolean;
+}
+export interface AuthSuccessPayload {
+    token: string;
+    user: {
+        id: string;
+        email?: string;
+        name?: string;
+        token?: string;
+        [key: string]: any;
+    };
+    message?: string;
+    theme?: import('./index').ChatTheme;
+}
+export interface ErrorPayload {
+    code: string;
+    message: string;
+    details?: any;
+}
+export interface ChatHistoryPayload {
+    messages: BotMessagePayload[];
+    hasMore: boolean;
+}
+export interface CustomEventPayload {
+    eventName: string;
+    data: any;
+}
+export interface SocketAuthPayload {
+    /** API Key del tenant */
+    apiKey: string;
+    /** Device ID del guest (persistido en localStorage) */
+    deviceId: string;
+    /** Optional agent flow ID to connect to a specific agent */
+    agentId?: string;
+    /** Token JWT opcional si el usuario ya está autenticado */
+    token?: string;
+    /** Metadata adicional */
+    metadata?: Record<string, any>;
+}
+//# sourceMappingURL=socket.d.ts.map

package/dist/src/chat-widget/types/socket.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"socket.d.ts","sourceRoot":"","sources":["../../../../src/chat-widget/types/socket.ts"],"names":[],"mappings":"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"}

package/dist/src/chat-widget/utils/dateUtils.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Utilidades de formateo de fechas usando Intl nativo
+ * Reemplaza date-fns para reducir el bundle
+ */
+/**
+ * Formatea una fecha en formato corto (día de mes, HH:mm)
+ */
+export declare function formatShort(date: Date): string;
+/**
+ * Verifica si una fecha es hoy
+ */
+export declare function isToday(date: Date): boolean;
+/**
+ * Verifica si una fecha fue ayer
+ */
+export declare function isYesterday(date: Date): boolean;
+/**
+ * Calcula la diferencia en minutos entre dos fechas
+ */
+export declare function differenceInMinutes(laterDate: Date, earlierDate: Date): number;
+/**
+ * Formatea la hora en formato HH:mm
+ */
+export declare function formatTime(date: Date): string;
+/**
+ * Formatea fecha completa con día, mes y hora
+ */
+export declare function formatFull(date: Date): string;
+/**
+ * Formatea fecha relativa (Hoy, Ayer, o fecha)
+ */
+export declare function formatRelative(date: Date): string;
+//# sourceMappingURL=dateUtils.d.ts.map

package/dist/src/chat-widget/utils/dateUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dateUtils.d.ts","sourceRoot":"","sources":["../../../../src/chat-widget/utils/dateUtils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAO9C;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAO3C;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAQ/C;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,GAAG,MAAM,CAG9E;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAK7C;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAQ7C;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAQjD"}

package/dist/src/chat-widget/utils/defaultAssets.d.ts

@@ -0,0 +1,20 @@
+/**
+ * @package @botuyo/chat-widget
+ * Default assets bundled inline to avoid external dependencies
+ *
+ * These are fallback values when the client doesn't provide custom assets.
+ * All assets are embedded as data URLs or inline content to work regardless
+ * of the hosting environment.
+ */
+/**
+ * Default bot avatar as an inline SVG data URL
+ * Simple friendly bot icon in a circular format
+ */
+export declare const DEFAULT_AVATAR_URL: string;
+/**
+ * Notification sound as base64-encoded WAV
+ * Simple short "ding" sound (minimal file size)
+ * Generated programmatically - a brief 440Hz tone
+ */
+export declare const DEFAULT_NOTIFICATION_SOUND_URL: string;
+//# sourceMappingURL=defaultAssets.d.ts.map

package/dist/src/chat-widget/utils/defaultAssets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaultAssets.d.ts","sourceRoot":"","sources":["../../../../src/chat-widget/utils/defaultAssets.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;;GAGG;AACH,eAAO,MAAM,kBAAkB,QAe3B,CAAA;AAEJ;;;;GAIG;AACH,eAAO,MAAM,8BAA8B,QAAmC,CAAA"}

package/dist/src/chat-widget/utils/deviceId.d.ts

@@ -0,0 +1,18 @@
+/**
+ * @package @botuyo/chat-widget
+ * Utilidad para gestionar el Device ID persistente
+ */
+/**
+ * Obtiene el Device ID existente o genera uno nuevo
+ * Crítico: Esto permite mantener la sesión de chat tras refrescar la página
+ */
+export declare function getOrCreateDeviceId(): string;
+/**
+ * Limpia el Device ID (útil para testing o logout completo)
+ */
+export declare function clearDeviceId(): void;
+/**
+ * Obtiene el Device ID sin crearlo (retorna null si no existe)
+ */
+export declare function getDeviceId(): string | null;
+//# sourceMappingURL=deviceId.d.ts.map

package/dist/src/chat-widget/utils/deviceId.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deviceId.d.ts","sourceRoot":"","sources":["../../../../src/chat-widget/utils/deviceId.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAiBH;;;GAGG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,CAmB5C;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,IAAI,CAMpC;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,MAAM,GAAG,IAAI,CAM3C"}

package/dist/src/chat-widget/utils/fileValidation.d.ts

@@ -0,0 +1,75 @@
+/**
+ * @package @botuyo/chat-widget
+ * File validation utilities with magic bytes verification
+ *
+ * Validates file types by checking magic bytes (file signatures)
+ * to prevent MIME type spoofing and detect corrupted files.
+ */
+/**
+ * Validates a file by checking its magic bytes against expected signature
+ *
+ * @param file - File to validate
+ * @returns Promise<boolean> - true if file matches expected type, false otherwise
+ *
+ * @example
+ * const isValid = await validateFileType(file)
+ * if (!isValid) {
+ *   alert('El archivo está corrupto o no es del tipo indicado')
+ * }
+ */
+export declare function validateFileType(file: File): Promise<boolean>;
+/**
+ * Validates file size against maximum allowed
+ *
+ * @param file - File to validate
+ * @param maxSizeMB - Maximum size in megabytes (default: 10MB)
+ * @returns boolean - true if file is within size limit
+ *
+ * @example
+ * if (!validateFileSize(file, 5)) {
+ *   alert('El archivo es demasiado grande. Máximo 5MB')
+ * }
+ */
+export declare function validateFileSize(file: File, maxSizeMB?: number): boolean;
+/**
+ * Validates file extension matches allowed list
+ *
+ * @param file - File to validate
+ * @param allowedExtensions - Array of allowed extensions (e.g., ['jpg', 'png'])
+ * @returns boolean - true if extension is allowed
+ *
+ * @example
+ * if (!validateFileExtension(file, ['jpg', 'png', 'webp'])) {
+ *   alert('Solo se permiten imágenes JPG, PNG o WebP')
+ * }
+ */
+export declare function validateFileExtension(file: File, allowedExtensions: string[]): boolean;
+/**
+ * Comprehensive file validation combining all checks
+ *
+ * @param file - File to validate
+ * @param options - Validation options
+ * @returns Promise<ValidationResult> - Validation result with details
+ *
+ * @example
+ * const result = await validateFile(file, {
+ *   maxSizeMB: 5,
+ *   allowedExtensions: ['jpg', 'png'],
+ *   checkMagicBytes: true
+ * })
+ *
+ * if (!result.valid) {
+ *   alert(result.error)
+ * }
+ */
+export interface FileValidationOptions {
+    maxSizeMB?: number;
+    allowedExtensions?: string[];
+    checkMagicBytes?: boolean;
+}
+export interface ValidationResult {
+    valid: boolean;
+    error?: string;
+}
+export declare function validateFile(file: File, options?: FileValidationOptions): Promise<ValidationResult>;
+//# sourceMappingURL=fileValidation.d.ts.map

package/dist/src/chat-widget/utils/fileValidation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fileValidation.d.ts","sourceRoot":"","sources":["../../../../src/chat-widget/utils/fileValidation.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAiBH;;;;;;;;;;;GAWG;AACH,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,CAqBnE;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,IAAI,EAAE,SAAS,GAAE,MAAW,GAAG,OAAO,CAG5E;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,IAAI,EAAE,iBAAiB,EAAE,MAAM,EAAE,GAAG,OAAO,CAKtF;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,WAAW,qBAAqB;IACpC,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAA;IAC5B,eAAe,CAAC,EAAE,OAAO,CAAA;CAC1B;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAA;IACd,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED,wBAAsB,YAAY,CAChC,IAAI,EAAE,IAAI,EACV,OAAO,GAAE,qBAA0B,GAClC,OAAO,CAAC,gBAAgB,CAAC,CA+B3B"}