@fusioni/client-sdk 1.1.5 → 1.1.8

package/README.md

@@ -105,9 +105,11 @@ When including via `<script src="...">`, the SDK exposes a global `Fusioni` obje
     position: 'bottom-right',
     primaryColor: '#6366f1'
   });
-  // Optional: unmount later
+  // Optional: unmount or change language/theme later
   // const result = Fusioni.mount('#my-chat', config);
   // result.unmount();
+  // result.setLanguage('el');
+  // result.setTheme('auto');
 </script>
 ```
 
@@ -115,10 +117,68 @@ When including via `<script src="...">`, the SDK exposes a global `Fusioni` obje
 
 | Method | Description |
 |--------|-------------|
-| `Fusioni.init(config)` | Mounts the chat widget with default placement (creates `#fusioni-chat-root`). Returns `{ unmount }`. |
-| `Fusioni.mount(container, config)` | Mounts into `container` (CSS selector string or `HTMLElement`). Returns `{ unmount }`. |
+| `Fusioni.init(config)` | Mounts the chat widget with default placement (creates `#fusioni-chat-root`). Returns [`FusioniMountResult`](#changing-language-and-theme-after-init). |
+| `Fusioni.mount(container, config)` | Mounts into `container` (CSS selector string or `HTMLElement`). Returns [`FusioniMountResult`](#changing-language-and-theme-after-init). |
 | `Fusioni.version` | SDK version string. |
 
+### Changing language and theme after init
+
+`Fusioni.init` and `Fusioni.mount` return the same handle (in TypeScript: `FusioniMountResult`), which includes **`setLanguage`** and **`setTheme`** so you can switch locale or appearance without remounting.
+
+| Property / method | Description |
+|-------------------|-------------|
+| `unmount()` | Removes the widget and cleans up the React root. |
+| `setLanguage(language)` | Sets UI language to `'en'` or `'el'`. Invalid values are ignored. |
+| `setTheme(theme)` | Sets appearance to `'light'`, `'dark'`, or `'auto'` (follows system preference). Persists like the in-widget theme control. |
+
+**Script example:**
+
+```html
+<script src="path/to/fusioni-sdk.umd.js"></script>
+<script>
+  const chat = Fusioni.init({
+    apiBaseUrl: 'https://your-fusioni-api.com',
+    agencyId: 'your-agency-id',
+    theme: 'light',
+    language: 'en'
+  });
+
+  document.getElementById('locale-el').addEventListener('click', () => {
+    chat.setLanguage('el');
+  });
+  document.getElementById('theme-dark').addEventListener('click', () => {
+    chat.setTheme('dark');
+  });
+</script>
+```
+
+**React (npm) example:** pass a ref to `ChatWidget` and call the same methods (type: `FusioniChatWidgetHandle`).
+
+```tsx
+import { useRef } from 'react';
+import { ChatWidget, type FusioniChatWidgetHandle, type FusioniSDKConfig } from '@fusioni/client-sdk';
+
+function App() {
+  const chatRef = useRef<FusioniChatWidgetHandle>(null);
+  const config: FusioniSDKConfig = {
+    apiBaseUrl: 'https://your-fusioni-api.com',
+    agencyId: 'your-agency-id',
+  };
+
+  return (
+    <>
+      <button type="button" onClick={() => chatRef.current?.setLanguage('el')}>
+        Greek
+      </button>
+      <button type="button" onClick={() => chatRef.current?.setTheme('dark')}>
+        Dark mode
+      </button>
+      <ChatWidget ref={chatRef} config={config} />
+    </>
+  );
+}
+```
+
 ### Advanced Usage with Event Handlers
 
 ```tsx
@@ -187,7 +247,11 @@ export default App;
 | `apiBaseUrl` | `string` | **Required** | Base URL of your Fusioni API |
 | `agencyId` | `string` | **Required** | Your agency ID |
 | `accessToken` | `string` | `undefined` | Optional access token for authentication |
-| `theme` | `'light' \| 'dark' \| 'auto'` | `'light'` | UI theme preference |
+| `theme` | `'light' \| 'dark' \| 'auto'` | `'light'` | UI theme preference (can be changed later via [`setTheme`](#changing-language-and-theme-after-init)) |
+| `language` | `'en' \| 'el'` | `'en'` | UI copy language (can be changed later via [`setLanguage`](#changing-language-and-theme-after-init)) |
+| `showThemeToggle` | `boolean` | `true` | Show/hide the theme toggle button in the chat header |
+| `showFullscreenToggle` | `boolean` | `true` | Show/hide the fullscreen toggle button in the chat header |
+| `showLanguageSwitcher` | `boolean` | `true` | Show/hide the language switcher in the chat header |
 | `position` | `'bottom-right' \| 'bottom-left' \| 'top-right' \| 'top-left'` | `'bottom-right'` | Position of the floating button |
 | `primaryColor` | `string` | `'#6366f1'` | Primary color for the UI |
 | `showConversationList` | `boolean` | `true` | Whether to show the conversation sidebar |
@@ -195,6 +259,7 @@ export default App;
 | `enableFileUpload` | `boolean` | `true` | Enable file upload functionality |
 | `maxFileSize` | `number` | `10` | Maximum file size in MB |
 | `allowedFileTypes` | `string[]` | `['image/*']` | Allowed MIME types for uploads |
+| `buttonVariant` | `'minimal' \| 'glass' \| 'solid'` | `'glass'` | Floating launcher button style |
 
 ## Event Handlers
 
@@ -386,4 +451,4 @@ For support and questions:
 
 ./fusioni-client-sdk && npm run build && npm link
 
-./usion-client-sdk-example && npm link @fusioni/client-sdk
+./fusion-client-sdk-example && npm link @fusioni/client-sdk

package/dist/browser.d.ts

@@ -1,9 +1,11 @@
-import type { FusioniSDKConfig } from './types';
+import type { FusioniChatWidgetHandle, FusioniSDKConfig } from './types';
 import './styles/index.css';
 export interface FusioniScriptConfig extends FusioniSDKConfig {
 }
 export interface FusioniMountResult {
     unmount: () => void;
+    setLanguage: FusioniChatWidgetHandle['setLanguage'];
+    setTheme: FusioniChatWidgetHandle['setTheme'];
 }
 /**
  * Mount the chat widget into a container.

package/dist/browser.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"browser.d.ts","sourceRoot":"","sources":["../src/browser.tsx"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAChD,OAAO,oBAAoB,CAAC;AAI5B,MAAM,WAAW,mBAAoB,SAAQ,gBAAgB;CAAG;AAEhE,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB;AA4BD;;;;;GAKG;AACH,iBAAS,KAAK,CACZ,SAAS,EAAE,MAAM,GAAG,WAAW,EAC/B,MAAM,EAAE,mBAAmB,GAC1B,kBAAkB,CAYpB;AAED;;;;;GAKG;AACH,iBAAS,IAAI,CAAC,MAAM,EAAE,mBAAmB,GAAG,kBAAkB,CAG7D;AAED,QAAA,MAAM,OAAO;;;;CAIZ,CAAC;AAMF,eAAe,OAAO,CAAC"}
+{"version":3,"file":"browser.d.ts","sourceRoot":"","sources":["../src/browser.tsx"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,uBAAuB,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AACzE,OAAO,oBAAoB,CAAC;AAI5B,MAAM,WAAW,mBAAoB,SAAQ,gBAAgB;CAAG;AAEhE,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,WAAW,EAAE,uBAAuB,CAAC,aAAa,CAAC,CAAC;IACpD,QAAQ,EAAE,uBAAuB,CAAC,UAAU,CAAC,CAAC;CAC/C;AA4BD;;;;;GAKG;AACH,iBAAS,KAAK,CACZ,SAAS,EAAE,MAAM,GAAG,WAAW,EAC/B,MAAM,EAAE,mBAAmB,GAC1B,kBAAkB,CAmBpB;AAED;;;;;GAKG;AACH,iBAAS,IAAI,CAAC,MAAM,EAAE,mBAAmB,GAAG,kBAAkB,CAG7D;AAED,QAAA,MAAM,OAAO;;;;CAIZ,CAAC;AAMF,eAAe,OAAO,CAAC"}

package/dist/components/ChatWidget.d.ts

@@ -1,5 +1,5 @@
 import React from 'react';
-import { ChatWidgetProps } from '../types';
+import { ChatWidgetProps, FusioniChatWidgetHandle } from '../types';
 import '../styles/index.css';
-export declare const ChatWidget: React.FC<ChatWidgetProps>;
+export declare const ChatWidget: React.ForwardRefExoticComponent<ChatWidgetProps & React.RefAttributes<FusioniChatWidgetHandle>>;
 //# sourceMappingURL=ChatWidget.d.ts.map

package/dist/components/ChatWidget.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ChatWidget.d.ts","sourceRoot":"","sources":["../../src/components/ChatWidget.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAiD,MAAM,OAAO,CAAC;AACtE,OAAO,EAAC,eAAe,EAAuD,MAAM,UAAU,CAAC;AAkB/F,OAAO,qBAAqB,CAAC;AAE7B,eAAO,MAAM,UAAU,EAAE,KAAK,CAAC,EAAE,CAAC,eAAe,CAmyBhD,CAAC"}
+{"version":3,"file":"ChatWidget.d.ts","sourceRoot":"","sources":["../../src/components/ChatWidget.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAkF,MAAM,OAAO,CAAC;AACvG,OAAO,EACL,eAAe,EAEf,uBAAuB,EAGxB,MAAM,UAAU,CAAC;AAmBlB,OAAO,qBAAqB,CAAC;AAE7B,eAAO,MAAM,UAAU,iGAu0BrB,CAAC"}

package/dist/components/Message.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Message.d.ts","sourceRoot":"","sources":["../../src/components/Message.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA6C,MAAM,OAAO,CAAC;AAClE,OAAO,EAAC,YAAY,EAAC,MAAM,UAAU,CAAC;AA6LtC,eAAO,MAAM,OAAO,EAAE,KAAK,CAAC,EAAE,CAAC,YAAY,CAmgB1C,CAAC"}
+{"version":3,"file":"Message.d.ts","sourceRoot":"","sources":["../../src/components/Message.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA6C,MAAM,OAAO,CAAC;AAClE,OAAO,EAAC,YAAY,EAAC,MAAM,UAAU,CAAC;AA6LtC,eAAO,MAAM,OAAO,EAAE,KAAK,CAAC,EAAE,CAAC,YAAY,CA0gB1C,CAAC"}

package/dist/components/MessageList.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MessageList.d.ts","sourceRoot":"","sources":["../../src/components/MessageList.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAmD,MAAM,OAAO,CAAC;AAExE,OAAO,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AAQhD,UAAU,gBAAgB;IACxB,QAAQ,EAAE,oBAAoB,EAAE,CAAC;IACjC,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,eAAe,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;IAC9C,aAAa,CAAC,EAAE,CAAC,OAAO,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;IAC1E,cAAc,CAAC,EAAE,CAAC,MAAM,EAAE;QAAE,SAAS,EAAE,WAAW,GAAG,cAAc,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;IAC7F,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;IAC9B,KAAK,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;CAC1B;AAED,eAAO,MAAM,WAAW,EAAE,KAAK,CAAC,EAAE,CAAC,gBAAgB,CA+UlD,CAAC"}
+{"version":3,"file":"MessageList.d.ts","sourceRoot":"","sources":["../../src/components/MessageList.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAmD,MAAM,OAAO,CAAC;AAExE,OAAO,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AAQhD,UAAU,gBAAgB;IACxB,QAAQ,EAAE,oBAAoB,EAAE,CAAC;IACjC,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,eAAe,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;IAC9C,aAAa,CAAC,EAAE,CAAC,OAAO,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;IAC1E,cAAc,CAAC,EAAE,CAAC,MAAM,EAAE;QAAE,SAAS,EAAE,WAAW,GAAG,cAAc,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;IAC7F,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;IAC9B,KAAK,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;CAC1B;AAED,eAAO,MAAM,WAAW,EAAE,KAAK,CAAC,EAAE,CAAC,gBAAgB,CAqVlD,CAAC"}