wakz-chat-widget 1.0.0

package/README.md

@@ -0,0 +1,44 @@
+# wakz-chat-widget
+
+Production-grade AI chat widget by **WAKZ** — Shadow DOM isolated, zero dependencies, Intercom/Crisp quality.
+
+## Installation
+
+No installation needed. Add this script tag to your website:
+
+```html
+<!-- WAKZ Chat Widget -->
+<script
+  src="https://unpkg.com/wakz-chat-widget@latest/index.js"
+  data-api-key="YOUR_API_KEY"
+  data-server="https://your-wakz-server.com"
+  async>
+</script>
+```
+
+Replace:
+- `YOUR_API_KEY` — Your WAKZ embed API key
+- `https://your-wakz-server.com` — Your WAKZ server URL
+
+## Features
+
+- **Shadow DOM** — Fully isolated from your website's CSS
+- **Zero Dependencies** — Pure vanilla JavaScript
+- **RTL Support** — Full Arabic/Hebrew right-to-left support
+- **Dynamic Theming** — Colors, position, bot name, welcome message configurable from dashboard
+- **Responsive** — Full-screen on mobile, floating window on desktop
+- **Real-time Chat** — AI-powered responses via WAKZ backend
+- **Typing Indicator** — Smooth animated dots while bot is thinking
+- **Session Persistence** — Chat history preserved across page reloads
+- **Online/Offline Status** — Green/red dot with pulse animation
+
+## CDN
+
+```html
+https://unpkg.com/wakz-chat-widget@latest/index.js
+https://cdn.jsdelivr.net/npm/wakz-chat-widget@latest/index.js
+```
+
+## License
+
+MIT

package/index.js

@@ -0,0 +1,1285 @@
+/**
+ * WAKZ Chat Widget v2.0.0
+ * ─────────────────────────────────────────────────────────────────
+ * A production-grade, self-contained chat widget using Shadow DOM.
+ * Competes with Intercom & Crisp in quality.
+ *
+ * Embed: <script src="/wakz-widget.js" data-api-key="xxx" data-server="https://..." async></script>
+ *
+ * ZERO external dependencies — pure vanilla JavaScript.
+ */
+(function () {
+  'use strict';
+
+  /* ════════════════════════════════════════════════════════════════
+     UTILITY HELPERS
+     ════════════════════════════════════════════════════════════════ */
+
+  /** Generate a UUID v4 compliant string */
+  function _uuid() {
+    return 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, function (c) {
+      var r = (Math.random() * 16) | 0;
+      var v = c === 'x' ? r : (r & 0x3) | 0x8;
+      return v.toString(16);
+    });
+  }
+
+  /** Get or create a persistent visitor ID stored in localStorage */
+  function _getVisitorId() {
+    var KEY = 'wakz_visitor_id';
+    var id = null;
+    try { id = localStorage.getItem(KEY); } catch (e) { /* ignore */ }
+    if (!id) {
+      id = _uuid();
+      try { localStorage.setItem(KEY, id); } catch (e) { /* ignore */ }
+    }
+    return id;
+  }
+
+  /** Locate our own <script> tag and read its data attributes */
+  function _getScriptAttrs() {
+    var scripts = document.querySelectorAll('script[data-api-key]');
+    var target = null;
+    for (var i = 0; i < scripts.length; i++) {
+      var src = scripts[i].getAttribute('src') || '';
+      if (src.indexOf('wakz-widget') !== -1) {
+        target = scripts[i];
+        break;
+      }
+    }
+    if (!target && scripts.length > 0) target = scripts[scripts.length - 1];
+    return {
+      apiKey: (target && target.getAttribute('data-api-key')) || '',
+      server: (target && target.getAttribute('data-server')) || ''
+    };
+  }
+
+  /** Convenience DOM element creator */
+  function _el(tag, attrs, children) {
+    var el = document.createElement(tag);
+    if (attrs) {
+      Object.keys(attrs).forEach(function (k) {
+        var v = attrs[k];
+        if (k === 'className') { el.className = v; }
+        else if (k === 'style' && typeof v === 'object') {
+          Object.keys(v).forEach(function (s) { el.style.setProperty(s, v[s]); });
+        }
+        else if (k.indexOf('on') === 0 && typeof v === 'function') {
+          el.addEventListener(k.slice(2).toLowerCase(), v);
+        }
+        else { el.setAttribute(k, v); }
+      });
+    }
+    if (children) {
+      (Array.isArray(children) ? children : [children]).forEach(function (c) {
+        if (c === null || c === undefined) return;
+        el.appendChild(typeof c === 'string' ? document.createTextNode(c) : c);
+      });
+    }
+    return el;
+  }
+
+  /** Fetch with an AbortController timeout (default 30s) */
+  function _fetchWithTimeout(url, options, timeoutMs) {
+    var controller = new AbortController();
+    var merged = Object.assign({}, options, { signal: controller.signal });
+    var timer = setTimeout(function () { controller.abort(); }, timeoutMs || 30000);
+    return fetch(url, merged).finally(function () { clearTimeout(timer); });
+  }
+
+  /* ════════════════════════════════════════════════════════════════
+     SVG ICONS (inline for zero-dependency)
+     ════════════════════════════════════════════════════════════════ */
+
+  var _ICONS = {
+    chatBubble:
+      '<svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round"><path d="M21 11.5a8.38 8.38 0 0 1-.9 3.8 8.5 8.5 0 0 1-7.6 4.7 8.38 8.38 0 0 1-3.8-.9L3 21l1.9-5.7a8.38 8.38 0 0 1-.9-3.8 8.5 8.5 0 0 1 4.7-7.6 8.38 8.38 0 0 1 3.8-.9h.5a8.48 8.48 0 0 1 8 8v.5z"/></svg>',
+    send:
+      '<svg viewBox="0 0 24 24" fill="currentColor"><path d="M2.01 21L23 12 2.01 3 2 10l15 2-15 2z"/></svg>',
+    close:
+      '<svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2.5" stroke-linecap="round" stroke-linejoin="round"><line x1="18" y1="6" x2="6" y2="18"/><line x1="6" y1="6" x2="18" y2="18"/></svg>',
+    error:
+      '<svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><circle cx="12" cy="12" r="10"/><line x1="15" y1="9" x2="9" y2="15"/><line x1="9" y1="9" x2="15" y2="15"/></svg>'
+  };
+
+  /* ════════════════════════════════════════════════════════════════
+     LOCALIZATION STRINGS
+     ════════════════════════════════════════════════════════════════ */
+
+  var _I18N = {
+    ar: {
+      placeholder: 'اكتب رسالتك...',
+      online: 'متصل',
+      offline: 'غير متصل',
+      errorMsg: 'حدث خطأ في الاتصال. يرجى المحاولة مرة أخرى.',
+      retry: 'إعادة المحاولة',
+      configError: 'تعذر تحميل إعدادات المحادثة.',
+      openChat: 'فتح المحادثة',
+      closeChat: 'إغلاق المحادثة',
+      sendMessage: 'إرسال'
+    },
+    en: {
+      placeholder: 'Type your message...',
+      online: 'Online',
+      offline: 'Offline',
+      errorMsg: 'Something went wrong. Please try again.',
+      retry: 'Retry',
+      configError: 'Could not load chat settings.',
+      openChat: 'Open chat',
+      closeChat: 'Close chat',
+      sendMessage: 'Send'
+    },
+    fr: {
+      placeholder: 'Tapez votre message...',
+      online: 'En ligne',
+      offline: 'Hors ligne',
+      errorMsg: 'Une erreur est survenue. Veuillez réessayer.',
+      retry: 'Réessayer',
+      configError: 'Impossible de charger les paramètres.',
+      openChat: 'Ouvrir le chat',
+      closeChat: 'Fermer le chat',
+      sendMessage: 'Envoyer'
+    }
+  };
+
+  function _strings(lang) {
+    return _I18N[lang] || _I18N['en'];
+  }
+
+  /* ════════════════════════════════════════════════════════════════
+     DEFAULT CONFIGURATION
+     ════════════════════════════════════════════════════════════════ */
+
+  var _DEFAULTS = {
+    botName: 'WAKZ',
+    welcomeMessage: '',
+    primaryColor: '#171717',
+    chatBg: '#f8f9fa',
+    btnColor: '#171717',
+    widgetBg: '#ffffff',
+    position: 'bottom-right',
+    language: 'en',
+    showStatus: true,
+    online: true
+  };
+
+  /* ════════════════════════════════════════════════════════════════
+     WAKZ WIDGET — MAIN CLASS
+     ════════════════════════════════════════════════════════════════ */
+
+  /** Singleton guard — only one widget per page */
+  if (window.__wakz_widget_initialized) return;
+  window.__wakz_widget_initialized = true;
+
+  function WAKZWidget() {
+    var self = this;
+
+    /* ── Script attributes ── */
+    var attrs = _getScriptAttrs();
+    self.apiKey = attrs.apiKey;
+    self.server = attrs.server;
+    self.visitorId = _getVisitorId();
+
+    /* ── Runtime state ── */
+    self.config = Object.assign({}, _DEFAULTS);
+    self.isOpen = false;
+    self.isLoading = false;
+    self.messages = [];
+    self._hasFetchedHistory = false;
+    self._typingEl = null;
+    self._configLoaded = false;
+    self._configError = false;
+
+    /* ── DOM refs (populated after mount) ── */
+    self._host = null;
+    self._shadow = null;
+    self._root = null;
+    self._chatWindow = null;
+    self._messagesContainer = null;
+    self._inputEl = null;
+    self._sendBtn = null;
+    self._toggleBtn = null;
+    self._statusDot = null;
+    self._headerStatusDot = null;
+    self._headerStatusText = null;
+
+    /* ── Bootstrap ── */
+    self._injectCSS();
+    self._createDOM();
+    self._attachEvents();
+    self._fetchConfig();
+    self._playFabEntrance();
+  }
+
+  /* ════════════════════════════════════════════════════════════════
+     CSS — Complete styling injected into Shadow DOM
+     ════════════════════════════════════════════════════════════════ */
+
+  WAKZWidget.prototype._injectCSS = function () {
+    var self = this;
+    self._styleEl = _el('style');
+
+    self._styleEl.textContent = [
+      /* ── CSS Custom Properties (theming) ── */
+      ':host {',
+      '  --wakz-primary: #171717;',
+      '  --wakz-btn: #171717;',
+      '  --wakz-chat-bg: #f8f9fa;',
+      '  --wakz-widget-bg: #ffffff;',
+      '  --wakz-radius-window: 16px;',
+      '  --wakz-radius-bubble: 16px;',
+      '  --wakz-radius-fab: 28px;',
+      '  --wakz-shadow-sm: 0 1px 3px rgba(0,0,0,.08), 0 1px 2px rgba(0,0,0,.06);',
+      '  --wakz-shadow-md: 0 4px 12px rgba(0,0,0,.1), 0 2px 4px rgba(0,0,0,.06);',
+      '  --wakz-shadow-lg: 0 12px 40px rgba(0,0,0,.15), 0 4px 12px rgba(0,0,0,.1);',
+      '  --wakz-shadow-xl: 0 20px 60px rgba(0,0,0,.2), 0 8px 20px rgba(0,0,0,.12);',
+      '  --wakz-transition: 200ms ease;',
+      '  --wakz-font: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif;',
+      '  all: initial;',
+      '  font-family: var(--wakz-font);',
+      '}',
+
+      /* ── Reset ── */
+      '.wakz *, .wakz *::before, .wakz *::after {',
+      '  box-sizing: border-box;',
+      '  margin: 0;',
+      '  padding: 0;',
+      '}',
+
+      /* ══════════════════════════════════════════════════
+         FLOATING ACTION BUTTON (FAB)
+         ══════════════════════════════════════════════════ */
+      '.wakz-fab {',
+      '  position: fixed;',
+      '  z-index: 2147483647;',
+      '  width: 56px;',
+      '  height: 56px;',
+      '  border-radius: var(--wakz-radius-fab);',
+      '  border: none;',
+      '  cursor: pointer;',
+      '  display: flex;',
+      '  align-items: center;',
+      '  justify-content: center;',
+      '  box-shadow: var(--wakz-shadow-lg);',
+      '  transition: transform var(--wakz-transition), box-shadow var(--wakz-transition);',
+      '  outline: none;',
+      '  -webkit-tap-highlight-color: transparent;',
+      '  background: var(--wakz-btn);',
+      '}',
+      '.wakz-fab:hover {',
+      '  transform: scale(1.08);',
+      '  box-shadow: var(--wakz-shadow-xl);',
+      '}',
+      '.wakz-fab:active {',
+      '  transform: scale(0.96);',
+      '}',
+      '.wakz-fab svg {',
+      '  width: 26px;',
+      '  height: 26px;',
+      '  color: #ffffff;',
+      '  pointer-events: none;',
+      '}',
+
+      /* ── FAB Positioning ── */
+      '.wakz-fab-pos-br { bottom: 24px; right: 24px; }',
+      '.wakz-fab-pos-bl { bottom: 24px; left: 24px; }',
+
+      /* ── FAB Entrance Bounce ── */
+      '@keyframes wakz-fab-enter {',
+      '  0%   { opacity: 0; transform: scale(0.3); }',
+      '  50%  { opacity: 1; transform: scale(1.12); }',
+      '  70%  { transform: scale(0.92); }',
+      '  100% { transform: scale(1); }',
+      '}',
+      '.wakz-fab-enter {',
+      '  animation: wakz-fab-enter 0.6s cubic-bezier(0.34, 1.56, 0.64, 1) forwards;',
+      '}',
+
+      /* ══════════════════════════════════════════════════
+         STATUS DOT (on FAB)
+         ══════════════════════════════════════════════════ */
+      '.wakz-fab-dot {',
+      '  position: absolute;',
+      '  top: 0px;',
+      '  right: 0px;',
+      '  width: 14px;',
+      '  height: 14px;',
+      '  border-radius: 50%;',
+      '  border: 2.5px solid #ffffff;',
+      '  z-index: 2;',
+      '  transition: background 0.3s ease;',
+      '}',
+      '.wakz-fab-pos-bl .wakz-fab-dot {',
+      '  right: auto;',
+      '  left: 0px;',
+      '}',
+
+      /* ── Online (green pulse) ── */
+      '.wakz-fab-dot.online {',
+      '  background: #22c55e;',
+      '}',
+      '@keyframes wakz-dot-pulse {',
+      '  0%, 100% { box-shadow: 0 0 0 0 rgba(34,197,94,0.5); }',
+      '  50% { box-shadow: 0 0 0 6px rgba(34,197,94,0); }',
+      '}',
+      '.wakz-fab-dot.online {',
+      '  animation: wakz-dot-pulse 2s ease-in-out infinite;',
+      '}',
+
+      /* ── Offline (red, no pulse) ── */
+      '.wakz-fab-dot.offline {',
+      '  background: #ef4444;',
+      '  animation: none;',
+      '}',
+
+      /* ── Error (red, no pulse) ── */
+      '.wakz-fab-dot.error {',
+      '  background: #ef4444;',
+      '  animation: none;',
+      '}',
+
+      /* ══════════════════════════════════════════════════
+         CHAT WINDOW
+         ══════════════════════════════════════════════════ */
+      '.wakz-window {',
+      '  position: fixed;',
+      '  z-index: 2147483646;',
+      '  width: 380px;',
+      '  min-height: 500px;',
+      '  max-height: 70vh;',
+      '  border-radius: var(--wakz-radius-window);',
+      '  overflow: hidden;',
+      '  display: flex;',
+      '  flex-direction: column;',
+      '  background: var(--wakz-widget-bg);',
+      '  box-shadow: var(--wakz-shadow-xl);',
+      '  opacity: 0;',
+      '  transform: translateY(20px) scale(0.95);',
+      '  pointer-events: none;',
+      '  transition: opacity 0.3s cubic-bezier(0.4, 0, 0.2, 1),',
+      '              transform 0.3s cubic-bezier(0.4, 0, 0.2, 1);',
+      '}',
+      '.wakz-window.wakz-visible {',
+      '  opacity: 1;',
+      '  transform: translateY(0) scale(1);',
+      '  pointer-events: auto;',
+      '}',
+
+      /* ── Window Positioning ── */
+      '.wakz-win-pos-br { bottom: 92px; right: 24px; }',
+      '.wakz-win-pos-bl { bottom: 92px; left: 24px; }',
+
+      /* ══════════════════════════════════════════════════
+         HEADER
+         ══════════════════════════════════════════════════ */
+      '.wakz-hdr {',
+      '  flex-shrink: 0;',
+      '  padding: 14px 18px;',
+      '  display: flex;',
+      '  align-items: center;',
+      '  justify-content: space-between;',
+      '  color: #ffffff;',
+      '  cursor: default;',
+      '  user-select: none;',
+      '  background: var(--wakz-primary);',
+      '}',
+      '.wakz-hdr-left {',
+      '  display: flex;',
+      '  align-items: center;',
+      '  gap: 11px;',
+      '  min-width: 0;',
+      '}',
+
+      /* ── Bot Avatar ── */
+      '.wakz-avatar {',
+      '  width: 38px;',
+      '  height: 38px;',
+      '  border-radius: 50%;',
+      '  background: rgba(255,255,255,0.18);',
+      '  display: flex;',
+      '  align-items: center;',
+      '  justify-content: center;',
+      '  font-weight: 700;',
+      '  font-size: 16px;',
+      '  flex-shrink: 0;',
+      '  letter-spacing: 0.5px;',
+      '}',
+
+      /* ── Header Info ── */
+      '.wakz-hdr-info {',
+      '  display: flex;',
+      '  flex-direction: column;',
+      '  min-width: 0;',
+      '}',
+      '.wakz-hdr-name {',
+      '  font-size: 15px;',
+      '  font-weight: 600;',
+      '  line-height: 1.3;',
+      '  white-space: nowrap;',
+      '  overflow: hidden;',
+      '  text-overflow: ellipsis;',
+      '}',
+      '.wakz-hdr-status {',
+      '  font-size: 12px;',
+      '  opacity: 0.9;',
+      '  display: flex;',
+      '  align-items: center;',
+      '  gap: 5px;',
+      '  margin-top: 2px;',
+      '}',
+      '.wakz-hdr-status-dot {',
+      '  width: 7px;',
+      '  height: 7px;',
+      '  border-radius: 50%;',
+      '  display: inline-block;',
+      '  flex-shrink: 0;',
+      '  transition: background 0.3s ease;',
+      '}',
+      '.wakz-hdr-status-dot.online { background: #4ade80; }',
+      '.wakz-hdr-status-dot.offline { background: #f87171; }',
+
+      /* ── Close Button ── */
+      '.wakz-close {',
+      '  width: 32px;',
+      '  height: 32px;',
+      '  border-radius: 50%;',
+      '  border: none;',
+      '  background: rgba(255,255,255,0.12);',
+      '  color: #ffffff;',
+      '  cursor: pointer;',
+      '  display: flex;',
+      '  align-items: center;',
+      '  justify-content: center;',
+      '  transition: background var(--wakz-transition);',
+      '  outline: none;',
+      '  flex-shrink: 0;',
+      '}',
+      '.wakz-close:hover {',
+      '  background: rgba(255,255,255,0.28);',
+      '}',
+      '.wakz-close svg {',
+      '  width: 18px;',
+      '  height: 18px;',
+      '}',
+
+      /* ══════════════════════════════════════════════════
+         MESSAGES AREA
+         ══════════════════════════════════════════════════ */
+      '.wakz-msgs {',
+      '  flex: 1;',
+      '  overflow-y: auto;',
+      '  overflow-x: hidden;',
+      '  padding: 18px 16px 10px;',
+      '  display: flex;',
+      '  flex-direction: column;',
+      '  gap: 6px;',
+      '  scroll-behavior: smooth;',
+      '  background: var(--wakz-chat-bg);',
+      '}',
+      '.wakz-msgs::-webkit-scrollbar { width: 5px; }',
+      '.wakz-msgs::-webkit-scrollbar-track { background: transparent; }',
+      '.wakz-msgs::-webkit-scrollbar-thumb {',
+      '  background: rgba(0,0,0,0.12);',
+      '  border-radius: 10px;',
+      '}',
+
+      /* ══════════════════════════════════════════════════
+         MESSAGE BUBBLES
+         ══════════════════════════════════════════════════ */
+      '.wakz-msg-row {',
+      '  display: flex;',
+      '  max-width: 82%;',
+      '  animation: wakz-msg-in 0.3s cubic-bezier(0.4, 0, 0.2, 1) forwards;',
+      '}',
+      '.wakz-msg-row.bot { align-self: flex-start; }',
+      '.wakz-msg-row.user { align-self: flex-end; }',
+
+      '@keyframes wakz-msg-in {',
+      '  0%   { opacity: 0; transform: translateY(8px); }',
+      '  100% { opacity: 1; transform: translateY(0); }',
+      '}',
+
+      '.wakz-bubble {',
+      '  padding: 10px 14px;',
+      '  font-size: 14px;',
+      '  line-height: 1.55;',
+      '  word-wrap: break-word;',
+      '  overflow-wrap: break-word;',
+      '  white-space: pre-wrap;',
+      '  border-radius: var(--wakz-radius-bubble);',
+      '  position: relative;',
+      '}',
+      '.wakz-bubble.bot {',
+      '  background: #ffffff;',
+      '  color: #1a1a1a;',
+      '  border-bottom-left-radius: 4px;',
+      '  box-shadow: var(--wakz-shadow-sm);',
+      '}',
+      '.wakz-bubble.user {',
+      '  color: #ffffff;',
+      '  border-bottom-right-radius: 4px;',
+      '  background: var(--wakz-primary);',
+      '}',
+      '.wakz-bubble.error-bubble {',
+      '  background: #fef2f2;',
+      '  color: #dc2626;',
+      '  border: 1px solid #fecaca;',
+      '  border-bottom-left-radius: 4px;',
+      '  box-shadow: none;',
+      '}',
+
+      /* ── Message Timestamp ── */
+      '.wakz-ts {',
+      '  display: block;',
+      '  font-size: 11px;',
+      '  opacity: 0.45;',
+      '  margin-top: 4px;',
+      '}',
+      '.wakz-bubble.user .wakz-ts {',
+      '  text-align: right;',
+      '}',
+
+      /* ── Retry Button (inside error bubble) ── */
+      '.wakz-retry {',
+      '  display: inline-flex;',
+      '  align-items: center;',
+      '  gap: 4px;',
+      '  margin-top: 8px;',
+      '  padding: 5px 14px;',
+      '  font-size: 12px;',
+      '  font-weight: 500;',
+      '  border-radius: 20px;',
+      '  border: 1px solid #fca5a5;',
+      '  background: #ffffff;',
+      '  color: #dc2626;',
+      '  cursor: pointer;',
+      '  font-family: var(--wakz-font);',
+      '  transition: background var(--wakz-transition), border-color var(--wakz-transition);',
+      '  outline: none;',
+      '}',
+      '.wakz-retry:hover {',
+      '  background: #fef2f2;',
+      '  border-color: #f87171;',
+      '}',
+
+      /* ══════════════════════════════════════════════════
+         TYPING INDICATOR
+         ══════════════════════════════════════════════════ */
+      '.wakz-typing {',
+      '  display: flex;',
+      '  align-items: center;',
+      '  gap: 4px;',
+      '  padding: 14px 18px;',
+      '  background: #ffffff;',
+      '  border-radius: var(--wakz-radius-bubble);',
+      '  border-bottom-left-radius: 4px;',
+      '  box-shadow: var(--wakz-shadow-sm);',
+      '}',
+      '.wakz-typing-dot {',
+      '  width: 7px;',
+      '  height: 7px;',
+      '  border-radius: 50%;',
+      '  background: #9ca3af;',
+      '  animation: wakz-bounce-dot 1.4s ease-in-out infinite;',
+      '}',
+      '.wakz-typing-dot:nth-child(2) { animation-delay: 0.16s; }',
+      '.wakz-typing-dot:nth-child(3) { animation-delay: 0.32s; }',
+      '@keyframes wakz-bounce-dot {',
+      '  0%, 60%, 100% { transform: translateY(0); opacity: 0.4; }',
+      '  30% { transform: translateY(-7px); opacity: 1; }',
+      '}',
+
+      /* ══════════════════════════════════════════════════
+         INPUT AREA
+         ══════════════════════════════════════════════════ */
+      '.wakz-input-wrap {',
+      '  flex-shrink: 0;',
+      '  padding: 12px 14px;',
+      '  border-top: 1px solid #e5e7eb;',
+      '  background: var(--wakz-widget-bg);',
+      '  display: flex;',
+      '  align-items: flex-end;',
+      '  gap: 8px;',
+      '}',
+      '.wakz-input {',
+      '  flex: 1;',
+      '  border: 1.5px solid #e5e7eb;',
+      '  border-radius: 22px;',
+      '  padding: 10px 16px;',
+      '  font-size: 14px;',
+      '  line-height: 1.4;',
+      '  outline: none;',
+      '  font-family: var(--wakz-font);',
+      '  transition: border-color var(--wakz-transition);',
+      '  resize: none;',
+      '  max-height: 100px;',
+      '  overflow-y: auto;',
+      '  background: #f9fafb;',
+      '  color: #111827;',
+      '}',
+      '.wakz-input:focus {',
+      '  border-color: var(--wakz-primary);',
+      '  background: #ffffff;',
+      '}',
+      '.wakz-input::placeholder {',
+      '  color: #9ca3af;',
+      '}',
+
+      /* ── Send Button ── */
+      '.wakz-send {',
+      '  width: 40px;',
+      '  height: 40px;',
+      '  border-radius: 50%;',
+      '  border: none;',
+      '  color: #ffffff;',
+      '  cursor: pointer;',
+      '  display: flex;',
+      '  align-items: center;',
+      '  justify-content: center;',
+      '  flex-shrink: 0;',
+      '  transition: opacity var(--wakz-transition), transform 0.1s ease, box-shadow var(--wakz-transition);',
+      '  outline: none;',
+      '  background: var(--wakz-primary);',
+      '  box-shadow: var(--wakz-shadow-sm);',
+      '}',
+      '.wakz-send:hover:not(:disabled) {',
+      '  box-shadow: var(--wakz-shadow-md);',
+      '}',
+      '.wakz-send:disabled {',
+      '  opacity: 0.35;',
+      '  cursor: not-allowed;',
+      '}',
+      '.wakz-send:not(:disabled):active {',
+      '  transform: scale(0.88);',
+      '}',
+      '.wakz-send svg {',
+      '  width: 18px;',
+      '  height: 18px;',
+      '  pointer-events: none;',
+      '}',
+
+      /* ══════════════════════════════════════════════════
+         WELCOME MESSAGE
+         ══════════════════════════════════════════════════ */
+      '.wakz-welcome-wrap {',
+      '  display: flex;',
+      '  gap: 8px;',
+      '  max-width: 88%;',
+      '  align-self: flex-start;',
+      '  animation: wakz-msg-in 0.35s cubic-bezier(0.4, 0, 0.2, 1) forwards;',
+      '}',
+      '.wakz-welcome-avatar {',
+      '  width: 28px;',
+      '  height: 28px;',
+      '  border-radius: 50%;',
+      '  background: var(--wakz-primary);',
+      '  display: flex;',
+      '  align-items: center;',
+      '  justify-content: center;',
+      '  color: #ffffff;',
+      '  font-weight: 700;',
+      '  font-size: 12px;',
+      '  flex-shrink: 0;',
+      '  align-self: flex-end;',
+      '  margin-bottom: 2px;',
+      '}',
+
+      /* ══════════════════════════════════════════════════
+         RTL SUPPORT
+         ══════════════════════════════════════════════════ */
+      '.wakz-rtl { direction: rtl; }',
+      '.wakz-rtl .wakz-bubble.bot {',
+      '  border-bottom-left-radius: var(--wakz-radius-bubble);',
+      '  border-bottom-right-radius: 4px;',
+      '}',
+      '.wakz-rtl .wakz-bubble.user {',
+      '  border-bottom-right-radius: var(--wakz-radius-bubble);',
+      '  border-bottom-left-radius: 4px;',
+      '}',
+      '.wakz-rtl .wakz-typing {',
+      '  border-bottom-left-radius: var(--wakz-radius-bubble);',
+      '  border-bottom-right-radius: 4px;',
+      '}',
+      '.wakz-rtl .wakz-bubble.user .wakz-ts {',
+      '  text-align: left;',
+      '}',
+
+      /* ══════════════════════════════════════════════════
+         MOBILE RESPONSIVE
+         ══════════════════════════════════════════════════ */
+      '@media (max-width: 480px) {',
+      '  .wakz-window {',
+      '    width: 100vw !important;',
+      '    height: 100vh !important;',
+      '    min-height: 100vh !important;',
+      '    max-height: 100vh !important;',
+      '    bottom: 0 !important;',
+      '    top: 0 !important;',
+      '    right: 0 !important;',
+      '    left: 0 !important;',
+      '    border-radius: 0 !important;',
+      '  }',
+      '  .wakz-window.wakz-visible {',
+      '    transform: translateY(0) scale(1);',
+      '  }',
+      '  .wakz-fab-pos-br { bottom: 16px; right: 16px; }',
+      '  .wakz-fab-pos-bl { bottom: 16px; left: 16px; }',
+      '}'
+    ].join('\n');
+  };
+
+  /* ════════════════════════════════════════════════════════════════
+     DOM CREATION
+     ════════════════════════════════════════════════════════════════ */
+
+  WAKZWidget.prototype._createDOM = function () {
+    var self = this;
+    var isRtl = self.config.language === 'ar';
+    var posClass = self.config.position === 'bottom-left' ? 'bl' : 'br';
+    var str = _strings(self.config.language);
+
+    /* ── Host + Shadow DOM ── */
+    self._host = _el('div');
+    document.body.appendChild(self._host);
+    self._shadow = self._host.attachShadow({ mode: 'closed' });
+
+    /* ── Root wrapper ── */
+    self._root = _el('div', { className: 'wakz' + (isRtl ? ' wakz-rtl' : '') });
+    self._shadow.appendChild(self._styleEl);
+    self._shadow.appendChild(self._root);
+
+    /* ══════════════ FLOATING ACTION BUTTON ══════════════ */
+    self._toggleBtn = _el('button', {
+      className: 'wakz-fab wakz-fab-pos-' + posClass,
+      'aria-label': str.openChat
+    });
+    self._toggleBtn.innerHTML = _ICONS.chatBubble;
+
+    /* Status dot on FAB */
+    self._statusDot = _el('span', { className: 'wakz-fab-dot ' + (self.config.online ? 'online' : 'offline') });
+    self._statusDot.style.display = self.config.showStatus ? '' : 'none';
+    self._toggleBtn.appendChild(self._statusDot);
+    self._root.appendChild(self._toggleBtn);
+
+    /* ══════════════ CHAT WINDOW ══════════════ */
+    self._chatWindow = _el('div', { className: 'wakz-window wakz-win-pos-' + posClass });
+
+    /* ── Header ── */
+    var headerEl = _el('div', { className: 'wakz-hdr' });
+
+    var headerLeft = _el('div', { className: 'wakz-hdr-left' });
+    var avatarLetter = (self.config.botName || 'W')[0].toUpperCase();
+    headerLeft.appendChild(_el('div', { className: 'wakz-avatar' }, [avatarLetter]));
+
+    var headerInfo = _el('div', { className: 'wakz-hdr-info' });
+    headerInfo.appendChild(_el('span', { className: 'wakz-hdr-name' }, [self.config.botName]));
+
+    var statusLine = _el('span', { className: 'wakz-hdr-status' });
+    self._headerStatusDot = _el('span', { className: 'wakz-hdr-status-dot ' + (self.config.online ? 'online' : 'offline') });
+    if (self.config.showStatus) statusLine.appendChild(self._headerStatusDot);
+    self._headerStatusText = document.createTextNode(self.config.online ? str.online : str.offline);
+    statusLine.appendChild(self._headerStatusText);
+    headerInfo.appendChild(statusLine);
+
+    headerLeft.appendChild(headerInfo);
+    headerEl.appendChild(headerLeft);
+
+    var closeBtn = _el('button', { className: 'wakz-close', 'aria-label': str.closeChat });
+    closeBtn.innerHTML = _ICONS.close;
+    headerEl.appendChild(closeBtn);
+    self._chatWindow.appendChild(headerEl);
+
+    /* ── Messages Container ── */
+    self._messagesContainer = _el('div', { className: 'wakz-msgs' });
+    self._chatWindow.appendChild(self._messagesContainer);
+
+    /* ── Input Area ── */
+    var inputWrap = _el('div', { className: 'wakz-input-wrap' });
+
+    self._inputEl = _el('textarea', {
+      className: 'wakz-input',
+      placeholder: str.placeholder,
+      rows: 1,
+      dir: isRtl ? 'rtl' : 'ltr'
+    });
+    inputWrap.appendChild(self._inputEl);
+
+    self._sendBtn = _el('button', {
+      className: 'wakz-send',
+      'aria-label': str.sendMessage
+    });
+    self._sendBtn.innerHTML = _ICONS.send;
+    inputWrap.appendChild(self._sendBtn);
+    self._chatWindow.appendChild(inputWrap);
+
+    self._root.appendChild(self._chatWindow);
+  };
+
+  /* ════════════════════════════════════════════════════════════════
+     EVENT LISTENERS
+     ════════════════════════════════════════════════════════════════ */
+
+  WAKZWidget.prototype._attachEvents = function () {
+    var self = this;
+
+    /* Toggle button click */
+    self._toggleBtn.addEventListener('click', function () {
+      self.toggleChat(!self.isOpen);
+    });
+
+    /* Close button click */
+    self._chatWindow.querySelector('.wakz-close').addEventListener('click', function () {
+      self.toggleChat(false);
+    });
+
+    /* Send button click */
+    self._sendBtn.addEventListener('click', function () {
+      self._handleSend();
+    });
+
+    /* Enter key to send, Shift+Enter for newline */
+    self._inputEl.addEventListener('keydown', function (e) {
+      if (e.key === 'Enter' && !e.shiftKey) {
+        e.preventDefault();
+        if (!self._sendBtn.disabled) self._handleSend();
+      }
+    });
+
+    /* Auto-resize textarea */
+    self._inputEl.addEventListener('input', function () {
+      self._inputEl.style.height = 'auto';
+      self._inputEl.style.height = Math.min(self._inputEl.scrollHeight, 100) + 'px';
+    });
+
+    /* Escape to close */
+    document.addEventListener('keydown', function (e) {
+      if (e.key === 'Escape' && self.isOpen) self.toggleChat(false);
+    });
+  };
+
+  /* ════════════════════════════════════════════════════════════════
+     FAB ENTRANCE ANIMATION
+     ════════════════════════════════════════════════════════════════ */
+
+  WAKZWidget.prototype._playFabEntrance = function () {
+    var self = this;
+    /* Start invisible, then animate after a brief delay */
+    self._toggleBtn.style.opacity = '0';
+    setTimeout(function () {
+      self._toggleBtn.style.opacity = '';
+      self._toggleBtn.classList.add('wakz-fab-enter');
+    }, 800);
+  };
+
+  /* ════════════════════════════════════════════════════════════════
+     TOGGLE CHAT OPEN / CLOSE
+     ════════════════════════════════════════════════════════════════ */
+
+  WAKZWidget.prototype.toggleChat = function (open) {
+    var self = this;
+    self.isOpen = open;
+    if (open) {
+      self._chatWindow.classList.add('wakz-visible');
+      /* Fetch history on first open (after config is loaded) */
+      if (self._configLoaded && !self._hasFetchedHistory) {
+        self._fetchHistory();
+      }
+      /* Show welcome message if no messages yet */
+      if (self._configLoaded && self.messages.length === 0 && self.config.welcomeMessage) {
+        self._appendWelcomeMessage(self.config.welcomeMessage);
+      }
+      setTimeout(function () { self._inputEl.focus(); }, 320);
+    } else {
+      self._chatWindow.classList.remove('wakz-visible');
+    }
+  };
+
+  /* ════════════════════════════════════════════════════════════════
+     FETCH WIDGET CONFIG
+     ════════════════════════════════════════════════════════════════ */
+
+  WAKZWidget.prototype._fetchConfig = function () {
+    var self = this;
+    if (!self.server || !self.apiKey) {
+      self._handleConfigError();
+      return;
+    }
+
+    var url = self.server + '/api/v1/embed/config?key=' + encodeURIComponent(self.apiKey);
+
+    _fetchWithTimeout(url, {
+      method: 'GET',
+      headers: { 'Accept': 'application/json' }
+    }, 30000)
+    .then(function (res) { return res.json(); })
+    .then(function (data) {
+      if (data && data.success && data.config) {
+        self.config = Object.assign({}, _DEFAULTS, data.config);
+        self._configLoaded = true;
+        self._applyConfig();
+      } else {
+        self._handleConfigError();
+      }
+    })
+    .catch(function (err) {
+      /* AbortError means timeout */
+      self._handleConfigError();
+    });
+  };
+
+  /** Handle config fetch failure — show offline state */
+  WAKZWidget.prototype._handleConfigError = function () {
+    var self = this;
+    self._configError = true;
+    self.config.online = false;
+
+    /* Update FAB dot to red */
+    if (self._statusDot) {
+      self._statusDot.className = 'wakz-fab-dot offline';
+      self._statusDot.style.display = '';
+    }
+    /* Update header status */
+    if (self._headerStatusDot) {
+      self._headerStatusDot.className = 'wakz-hdr-status-dot offline';
+    }
+    if (self._headerStatusText) {
+      self._headerStatusText.textContent = _strings(self.config.language).offline;
+    }
+  };
+
+  /** Apply loaded config to the DOM */
+  WAKZWidget.prototype._applyConfig = function () {
+    var self = this;
+    var cfg = self.config;
+    var str = _strings(cfg.language);
+    var isRtl = cfg.language === 'ar';
+    var posClass = cfg.position === 'bottom-left' ? 'bl' : 'br';
+
+    /* ── Update CSS custom properties ── */
+    var hostStyle = self._shadow.host.style;
+    hostStyle.setProperty('--wakz-primary', cfg.primaryColor);
+    hostStyle.setProperty('--wakz-btn', cfg.btnColor);
+    hostStyle.setProperty('--wakz-chat-bg', cfg.chatBg);
+    hostStyle.setProperty('--wakz-widget-bg', cfg.widgetBg);
+
+    /* ── RTL ── */
+    if (isRtl) self._root.classList.add('wakz-rtl');
+    else self._root.classList.remove('wakz-rtl');
+
+    /* ── FAB ── */
+    self._toggleBtn.className = 'wakz-fab wakz-fab-pos-' + posClass + ' wakz-fab-enter';
+    self._toggleBtn.setAttribute('aria-label', str.openChat);
+
+    /* ── FAB Status Dot ── */
+    self._statusDot.className = 'wakz-fab-dot ' + (cfg.online ? 'online' : 'offline');
+    self._statusDot.style.display = cfg.showStatus ? '' : 'none';
+
+    /* ── Window Position ── */
+    self._chatWindow.className = 'wakz-window wakz-win-pos-' + posClass + (self.isOpen ? ' wakz-visible' : '');
+
+    /* ── Header ── */
+    var headerEl = self._chatWindow.querySelector('.wakz-hdr');
+    if (headerEl) headerEl.style.background = cfg.primaryColor;
+
+    /* ── Bot Name & Avatar ── */
+    var nameEl = self._chatWindow.querySelector('.wakz-hdr-name');
+    if (nameEl) nameEl.textContent = cfg.botName;
+    var avatarEl = self._chatWindow.querySelector('.wakz-avatar');
+    if (avatarEl) avatarEl.textContent = (cfg.botName || 'W')[0].toUpperCase();
+
+    /* ── Header Status ── */
+    if (self._headerStatusDot) {
+      self._headerStatusDot.className = 'wakz-hdr-status-dot ' + (cfg.online ? 'online' : 'offline');
+      self._headerStatusDot.style.display = cfg.showStatus ? '' : 'none';
+    }
+    if (self._headerStatusText) {
+      self._headerStatusText.textContent = cfg.online ? str.online : str.offline;
+    }
+
+    /* ── Input ── */
+    self._inputEl.placeholder = str.placeholder;
+    self._inputEl.dir = isRtl ? 'rtl' : 'ltr';
+
+    /* ── Close button label ── */
+    var closeBtn = self._chatWindow.querySelector('.wakz-close');
+    if (closeBtn) closeBtn.setAttribute('aria-label', str.closeChat);
+
+    /* ── Send button label ── */
+    self._sendBtn.setAttribute('aria-label', str.sendMessage);
+
+    /* ── If chat is already open, show welcome message ── */
+    if (self.isOpen && self.messages.length === 0 && cfg.welcomeMessage) {
+      self._appendWelcomeMessage(cfg.welcomeMessage);
+    }
+  };
+
+  /* ════════════════════════════════════════════════════════════════
+     FETCH CHAT HISTORY
+     ════════════════════════════════════════════════════════════════ */
+
+  WAKZWidget.prototype._fetchHistory = function () {
+    var self = this;
+    if (!self.server || !self.apiKey) return;
+
+    self._hasFetchedHistory = true;
+    var url = self.server + '/api/v1/embed/chat?api_key=' +
+      encodeURIComponent(self.apiKey) + '&visitor_id=' + encodeURIComponent(self.visitorId);
+
+    _fetchWithTimeout(url, {
+      method: 'GET',
+      headers: { 'Accept': 'application/json' }
+    }, 15000)
+    .then(function (res) { return res.json(); })
+    .then(function (data) {
+      if (data && data.success && data.messages && data.messages.length > 0) {
+        /* Clear any existing messages (e.g., welcome) and render history */
+        self._clearMessages();
+        var msgs = data.messages;
+        for (var i = 0; i < msgs.length; i++) {
+          var m = msgs[i];
+          var role = m.role === 'user' ? 'user' : 'bot';
+          self._appendMessage(role, m.content, false, m.createdAt);
+        }
+      }
+    })
+    .catch(function () {
+      /* Silently ignore history fetch failures */
+    });
+  };
+
+  /* ════════════════════════════════════════════════════════════════
+     CLEAR ALL MESSAGES
+     ════════════════════════════════════════════════════════════════ */
+
+  WAKZWidget.prototype._clearMessages = function () {
+    var self = this;
+    self._messagesContainer.innerHTML = '';
+    self.messages = [];
+  };
+
+  /* ════════════════════════════════════════════════════════════════
+     APPEND WELCOME MESSAGE (with bot avatar)
+     ════════════════════════════════════════════════════════════════ */
+
+  WAKZWidget.prototype._appendWelcomeMessage = function (text) {
+    var self = this;
+    if (!text) return;
+
+    var wrap = _el('div', { className: 'wakz-welcome-wrap' });
+
+    /* Bot avatar */
+    var avatar = _el('div', { className: 'wakz-welcome-avatar' },
+      [(self.config.botName || 'W')[0].toUpperCase()]);
+    wrap.appendChild(avatar);
+
+    /* Bubble */
+    var bubble = _el('div', { className: 'wakz-bubble bot' }, [text]);
+    wrap.appendChild(bubble);
+
+    self._messagesContainer.appendChild(wrap);
+    self.messages.push({ sender: 'bot', text: text });
+    self._scrollToBottom();
+  };
+
+  /* ════════════════════════════════════════════════════════════════
+     APPEND MESSAGE TO CHAT
+     ════════════════════════════════════════════════════════════════ */
+
+  WAKZWidget.prototype._appendMessage = function (sender, text, isError, timestamp) {
+    var self = this;
+
+    var row = _el('div', { className: 'wakz-msg-row ' + sender });
+
+    var bubbleClass = 'wakz-bubble ' + sender;
+    if (isError) bubbleClass += ' error-bubble';
+    var bubble = _el('div', { className: bubbleClass });
+
+    bubble.appendChild(document.createTextNode(text));
+
+    /* Timestamp */
+    var tsText = '';
+    if (timestamp) {
+      try {
+        var d = new Date(timestamp);
+        if (!isNaN(d.getTime())) {
+          tsText = d.getHours().toString().padStart(2, '0') + ':' +
+                   d.getMinutes().toString().padStart(2, '0');
+        }
+      } catch (e) { /* ignore */ }
+    }
+    if (!tsText) {
+      var now = new Date();
+      tsText = now.getHours().toString().padStart(2, '0') + ':' +
+               now.getMinutes().toString().padStart(2, '0');
+    }
+    bubble.appendChild(_el('span', { className: 'wakz-ts' }, [tsText]));
+
+    /* Retry button for errors */
+    if (isError) {
+      var str = _strings(self.config.language);
+      var retryBtn = _el('button', { className: 'wakz-retry' }, [
+        _ICONS.error + ' ' + str.retry
+      ]);
+      (function (rowCapture) {
+        retryBtn.addEventListener('click', function () {
+          /* Remove error row */
+          if (rowCapture.parentNode) rowCapture.parentNode.removeChild(rowCapture);
+          /* Find and remove from messages array */
+          for (var i = self.messages.length - 1; i >= 0; i--) {
+            if (self.messages[i].text === text && self.messages[i].isError) {
+              self.messages.splice(i, 1);
+              break;
+            }
+          }
+          /* Resend last user message */
+          var lastUserMsg = null;
+          for (var j = self.messages.length - 1; j >= 0; j--) {
+            if (self.messages[j].sender === 'user') {
+              lastUserMsg = self.messages[j].text;
+              break;
+            }
+          }
+          if (lastUserMsg) self._sendToAPI(lastUserMsg);
+        });
+      })(row);
+      bubble.appendChild(retryBtn);
+    }
+
+    row.appendChild(bubble);
+    self._messagesContainer.appendChild(row);
+
+    self.messages.push({ sender: sender, text: text, isError: !!isError });
+    self._scrollToBottom();
+  };
+
+  /* ════════════════════════════════════════════════════════════════
+     TYPING INDICATOR
+     ════════════════════════════════════════════════════════════════ */
+
+  WAKZWidget.prototype._showTyping = function () {
+    var self = this;
+    if (self._typingEl) return;
+
+    self._typingEl = _el('div', { className: 'wakz-msg-row bot' });
+    self._typingEl.innerHTML =
+      '<div class="wakz-typing">' +
+      '<span class="wakz-typing-dot"></span>' +
+      '<span class="wakz-typing-dot"></span>' +
+      '<span class="wakz-typing-dot"></span>' +
+      '</div>';
+    self._messagesContainer.appendChild(self._typingEl);
+    self._scrollToBottom();
+  };
+
+  WAKZWidget.prototype._hideTyping = function () {
+    var self = this;
+    if (self._typingEl && self._typingEl.parentNode) {
+      self._typingEl.parentNode.removeChild(self._typingEl);
+    }
+    self._typingEl = null;
+  };
+
+  /* ════════════════════════════════════════════════════════════════
+     SCROLL TO BOTTOM
+     ════════════════════════════════════════════════════════════════ */
+
+  WAKZWidget.prototype._scrollToBottom = function () {
+    var self = this;
+    requestAnimationFrame(function () {
+      requestAnimationFrame(function () {
+        self._messagesContainer.scrollTop = self._messagesContainer.scrollHeight;
+      });
+    });
+  };
+
+  /* ════════════════════════════════════════════════════════════════
+     HANDLE SEND ACTION
+     ════════════════════════════════════════════════════════════════ */
+
+  WAKZWidget.prototype._handleSend = function () {
+    var self = this;
+    var text = (self._inputEl.value || '').trim();
+    if (!text || self.isLoading) return;
+
+    /* Append user message immediately */
+    self._appendMessage('user', text);
+
+    /* Clear input */
+    self._inputEl.value = '';
+    self._inputEl.style.height = 'auto';
+
+    /* Send to API */
+    self._sendToAPI(text);
+  };
+
+  /* ════════════════════════════════════════════════════════════════
+     SEND MESSAGE TO API
+     ════════════════════════════════════════════════════════════════ */
+
+  WAKZWidget.prototype._sendToAPI = function (message) {
+    var self = this;
+
+    if (!self.server || !self.apiKey) {
+      self._appendMessage('bot', 'Widget not configured. Provide data-api-key and data-server.', true);
+      return;
+    }
+
+    self.isLoading = true;
+    self._sendBtn.disabled = true;
+    self._showTyping();
+
+    var payload = {
+      api_key: self.apiKey,
+      visitor_id: self.visitorId,
+      message: message,
+      session_data: {
+        domain: window.location.hostname || '',
+        page_url: window.location.href || '',
+        user_agent: navigator.userAgent || '',
+        language: navigator.language || ''
+      }
+    };
+
+    _fetchWithTimeout(self.server + '/api/v1/embed/chat', {
+      method: 'POST',
+      headers: {
+        'Content-Type': 'application/json',
+        'Accept': 'application/json'
+      },
+      body: JSON.stringify(payload)
+    }, 30000)
+    .then(function (res) { return res.json(); })
+    .then(function (data) {
+      self._hideTyping();
+      if (data && data.success && data.reply) {
+        self._appendMessage('bot', data.reply);
+      } else {
+        self._appendMessage('bot', _strings(self.config.language).errorMsg, true);
+      }
+    })
+    .catch(function () {
+      self._hideTyping();
+      self._appendMessage('bot', _strings(self.config.language).errorMsg, true);
+    })
+    .finally(function () {
+      self.isLoading = false;
+      self._sendBtn.disabled = false;
+      if (self.isOpen) self._inputEl.focus();
+    });
+  };
+
+  /* ════════════════════════════════════════════════════════════════
+     BOOTSTRAP
+     ════════════════════════════════════════════════════════════════ */
+
+  function boot() {
+    try { new WAKZWidget(); } catch (e) { console.error('[WAKZ Widget] Init error:', e); }
+  }
+
+  if (document.readyState === 'loading') {
+    document.addEventListener('DOMContentLoaded', boot);
+  } else {
+    boot();
+  }
+
+})();

package/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "wakz-chat-widget",
+  "version": "1.0.0",
+  "description": "Production-grade AI chat widget by WAKZ — Shadow DOM isolated, zero dependencies, Intercom/Crisp quality.",
+  "main": "index.js",
+  "scripts": {
+    "prepublishOnly": "echo 'Ready to publish wakz-chat-widget'"
+  },
+  "keywords": [
+    "chat",
+    "widget",
+    "ai",
+    "chatbot",
+    "wakz",
+    "embed",
+    "shadow-dom",
+    "customer-support",
+    "live-chat",
+    "saas"
+  ],
+  "author": "WAKZ",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": ""
+  },
+  "files": [
+    "index.js",
+    "README.md"
+  ]
+}