@buni.ai/chatbot-core

Core functionality for BuniAI Chat Widget adapters - provides framework-agnostic utilities and API for seamless chatbot integration.

Features

• 🚀 Framework Agnostic - Works with any JavaScript framework or vanilla JS
• 📦 TypeScript Ready - Full type definitions included
• 🎯 Event-Driven - Comprehensive event system for real-time updates
• 🔧 Configurable - Extensive customization options
• 📱 Mobile Friendly - Responsive design and touch support
• 🎨 Themeable - Multiple built-in themes and custom styling options

Installation

npm install @buni.ai/chatbot-core

Quick Start

import { BuniChatWidget } from '@buni.ai/chatbot-core';

// Initialize the widget
const widget = new BuniChatWidget();

await widget.initialize({
  token: 'your-embed-token',
  config: {
    theme: 'default',
    position: 'bottom-right',
    welcomeMessage: 'Hello! How can we help you today?'
  }
});

// Control the widget
widget.show();
widget.hide();
widget.toggle();

// Set customer data
widget.setCustomerData({
  name: 'John Doe',
  email: '[email protected]',
  userId: 'user123'
});

// Listen for events
widget.on('new_message', (data) => {
  console.log('New message:', data.message);
});

widget.on('visibility_changed', (data) => {
  console.log('Widget visibility:', data.visibility);
});

API Reference

Configuration Options

interface BuniChatConfig {
  theme?: 'default' | 'dark' | 'light' | 'corporate' | 'friendly' | 'minimal';
  primaryColor?: string;
  secondaryColor?: string;
  companyName?: string;
  customAvatar?: string;
  welcomeMessage?: string;
  position?: 'bottom-right' | 'bottom-left' | 'top-right' | 'top-left';
  width?: number;
  height?: number;
  triggerText?: string;
  autoOpen?: boolean;
  showMinimize?: boolean;
  showBranding?: boolean;
  enableMobile?: boolean;
}

Widget Methods

• initialize(options) - Initialize the widget with configuration
• destroy() - Clean up and remove the widget
• show() - Show the chat widget
• hide() - Hide the chat widget
• toggle() - Toggle widget visibility
• minimize() - Minimize the widget
• maximize() - Maximize the widget
• setCustomerData(data) - Set customer information
• getCustomerData() - Get current customer data
• setSessionVariables(variables) - Set session variables
• sendMessage(message) - Send a message programmatically
• clearChat() - Clear chat history

Events

• ready - Widget is loaded and ready
• visibility_changed - Widget visibility changed
• new_message - New message received
• minimized - Widget was minimized
• maximized - Widget was maximized
• error - An error occurred

TypeScript Support

This package includes comprehensive TypeScript definitions:

import { 
  BuniChatWidget, 
  BuniChatOptions, 
  BuniChatConfig,
  CustomerData,
  SessionVariables 
} from '@buni.ai/chatbot-core';

Framework Adapters

For framework-specific implementations, use these packages:

• React: @buni.ai/chatbot-react
• Vue: @buni.ai/chatbot-vue
• Angular: @buni.ai/chatbot-angular

License

MIT © BuniAI Team