@headwai/chat-bubble 4.0.0 → 6.0.0

package/README.dev.md

@@ -15,7 +15,6 @@ The chat bubble is based on a Svelte integration for the [deep-chat](https://www
 
 ```bash
 git clone <your-repo-url>
-cd chat-bubble
 ```
 
 2. Install dependencies:
@@ -61,8 +60,7 @@ Create a `.env` by copying `.env.example` file in your project root with the fol
 <script>
   // Runtime configuration override
   window.HEADWAI_CHAT_BUBBLE_CONFIG = {
-    apiUrl: 'https://customer-api.com/chat',
-    apiKey: 'customer-api-key',
+    apiUrl: 'https://company.localchat.at',
     modelId: 'gpt-4',
   };
 </script>
@@ -73,8 +71,7 @@ Create a `.env` by copying `.env.example` file in your project root with the fol
 ```html
 <div
   data-chat-bubble
-  data-chat-bubble-api-url="https://api1.com/chat"
-  data-chat-bubble-api-key="key1"
+  data-chat-bubble-api-url="https://company.localchat.at"
   data-chat-bubble-user-message-background-color="#ff9500"
   data-chat-bubble-ai-message-background-color="#00c851"
   data-chat-bubble-user-message-text-color="#ffffff"
@@ -104,8 +101,7 @@ This project builds a standalone widget that can be integrated into any website.
 
 ```bash
 # Production .env file
-VITE_CHAT_BUBBLE_API_URL=https://api.customer-domain.com/chat
-VITE_CHAT_BUBBLE_API_KEY=prod-api-key
+VITE_CHAT_BUBBLE_API_URL=https://company.localchat.at
 VITE_CHAT_BUBBLE_MODEL_ID=gpt-4
 ```
 
@@ -164,7 +160,7 @@ The chat bubble makes requests to the following API endpoints:
 
 #### 1. Chat Completions API
 
-- **Endpoint**: `{apiUrl}/api/chat-bubble/chat/completions`
+- **Endpoint**: `{apiUrl}/api/chat/completions`
 - **Method**: WebSocket (streaming)
 - **Purpose**: Main chat conversation endpoint for sending messages and receiving AI responses
 - **Authentication**: Bearer token via `Authorization` header
@@ -173,7 +169,7 @@ The chat bubble makes requests to the following API endpoints:
 
 #### 2. Chat Creation API
 
-- **Endpoint**: `{apiUrl}/api/chat-bubble/v1/chats/new`
+- **Endpoint**: `{apiUrl}/api/v1/chats/new`
 - **Method**: POST
 - **Purpose**: Create a new chat session when starting a conversation
 - **Authentication**: Bearer token via `Authorization` header
@@ -181,7 +177,7 @@ The chat bubble makes requests to the following API endpoints:
 
 #### 3. Chat Storage API
 
-- **Endpoint**: `{apiUrl}/api/chat-bubble/v1/chats/{chatId}`
+- **Endpoint**: `{apiUrl}/api/v1/chats/{chatId}`
 - **Method**: POST
 - **Purpose**: Store/update chat history and conversation state
 - **Authentication**: Bearer token via `Authorization` header
@@ -189,7 +185,7 @@ The chat bubble makes requests to the following API endpoints:
 
 #### 4. Feedback API
 
-- **Endpoint**: `{apiUrl}/api/chat-bubble/v1/evaluations/feedback`
+- **Endpoint**: `{apiUrl}/api/v1/evaluations/feedback`
 - **Method**: POST
 - **Purpose**: Submit user feedback (thumbs up/down) for AI responses
 - **Authentication**: Bearer token via `Authorization` header
@@ -204,7 +200,6 @@ The chat bubble can be configured using environment variables, data attributes,
 | Attribute | Environment Variable        | Data Attribute              | Purpose                                  | Default             |
 | --------- | --------------------------- | --------------------------- | ---------------------------------------- | ------------------- |
 | `apiUrl`  | `VITE_CHAT_BUBBLE_API_URL`  | `data-chat-bubble-api-url`  | Base URL for API endpoints               | `https://localhost` |
-| `apiKey`  | `VITE_CHAT_BUBBLE_API_KEY`  | `data-chat-bubble-api-key`  | Authentication token for API requests    | `''`                |
 | `modelId` | `VITE_CHAT_BUBBLE_MODEL_ID` | `data-chat-bubble-model-id` | AI model identifier to use for responses | `test-model`        |
 
 #### Message Configuration
@@ -302,6 +297,66 @@ The chat bubble can be configured using environment variables, data attributes,
 }
 ```
 
+#### Chat Storage Request
+
+```javascript
+{
+  "chat": {
+    "models": ["model-id"],
+    "history": {
+      "messages": {
+        "message-uuid-1": {
+          "id": "message-uuid-1",
+          "parentId": null,
+          "childrenIds": ["message-uuid-2"],
+          "role": "user",
+          "content": "user message content",
+          "timestamp": 1704636645,
+          "models": ["model-id"]
+        },
+        "message-uuid-2": {
+          "id": "message-uuid-2",
+          "parentId": "message-uuid-1",
+          "childrenIds": [],
+          "role": "assistant",
+          "content": "assistant response content",
+          "model": "model-id",
+          "modelId": "model-id",
+          "modelIdx": 0,
+          "timestamp": 1704636645,
+          "sources": []
+        }
+      },
+      "currentId": "message-uuid-2"
+    },
+    "messages": [
+      {
+        "id": "message-uuid-1",
+        "parentId": null,
+        "childrenIds": ["message-uuid-2"],
+        "role": "user",
+        "content": "user message content",
+        "timestamp": 1704636645,
+        "models": ["model-id"]
+      },
+      {
+        "id": "message-uuid-2",
+        "parentId": "message-uuid-1",
+        "childrenIds": [],
+        "role": "assistant",
+        "content": "assistant response content",
+        "model": "model-id",
+        "modelId": "model-id",
+        "modelIdx": 0,
+        "timestamp": 1704636645,
+        "sources": []
+      }
+    ],
+    "params": {}
+  }
+}
+```
+
 #### Feedback Request
 
 ```javascript
@@ -352,7 +407,6 @@ This component is designed to work with OpenAI-compatible APIs. The request and
 ### Common Issues
 
 **CORS Errors**: Ensure your API endpoint allows requests from your domain
-**Authentication Failures**: Verify your API key is correct and has proper permissions
 **Environment Variables Not Loading**: Ensure variables are prefixed with `VITE_CHAT_BUBBLE_`
 **CDN Version Delays**: Sometimes the `@latest` tag on jsDelivr CDN takes time to propagate to all edge servers and may not deliver the newest version immediately. If you need the latest features or fixes, specify the exact version number instead of using `@latest`:
 

package/README.md

@@ -23,7 +23,6 @@ Add the Headwai Chat Bubble to the respective .html file.
       // Runtime configuration override
       window.HEADWAI_CHAT_BUBBLE_CONFIG = {
         apiUrl: 'https://company.localchat.at', // required
-        apiKey: 'chat-bubble-proxy-api-key', // required
         modelId: 'customer-support-model-id', // required
         maxMessages: 0, // optional - 0 means unlimited
         placeholderText: 'Ask your question here!', // optional - default: 'Enter your questions here'
@@ -86,7 +85,6 @@ For multiple instances use data attributes of the `<div>` tag for configuration
 <div
   data-chat-bubble
   data-chat-bubble-api-url="https://company.localchat.at"
-  data-chat-bubble-api-key="chat-bubble-proxy-api-key"
   data-chat-bubble-model-id="customer-support-model-id"
   data-chat-bubble-max-messages="0"
   data-chat-bubble-placeholder-text="Ask your question here!"
@@ -106,7 +104,6 @@ For multiple instances use data attributes of the `<div>` tag for configuration
 <div
   data-chat-bubble
   data-chat-bubble-api-url="https://company.localchat.at"
-  data-chat-bubble-api-key="chat-bubble-proxy-api-key"
   data-chat-bubble-model-id="FAQ-model-id"
   data-chat-bubble-max-messages="10"
   data-chat-bubble-placeholder-text="Ask about our FAQ..."
@@ -144,31 +141,6 @@ The base URL of your LocalChat API endpoint where the chat bubble will send mess
 apiUrl: 'https://company.localchat.at';
 ```
 
-#### `apiKey`
-
-**Type:** `string` | **Required:** ✅  
-The API Key of the dedicated Headwai Chat Bubble Proxy for LocalChat.
-
-```javascript
-apiKey: 'chat-bubble-proxy-api-key';
-```
-
-**How to get your API Key:**
-
-1. **Access Settings**: Login to LocalChat with the dedicated Headwai Chat Bubble user (All conversations will be stored at this user's chats list) and click on the user menu, then select `Settings`.
-
-   <img src="docs/images/settings.png" alt="LocalChat User Menu" width="50%" />
-
-2. **Navigate to Account**: In the Settings sidebar, click on `Account` to access your account settings.
-
-   <img src="docs/images/api-keys.png" alt="LocalChat Settings Account" width="50%" />
-
-3. **Get your API credentials**: In the API keys section, you have two options:
-   - **JWT Token**: Copy the existing JWT Token (expires after 7 days)
-   - **API Key**: Generate an API Key via `Generate API Key` button. Click the copy button next to the API Key field, or click the refresh button to generate a new permanent API Key
-
-**⚠️ Security Note:** When using permanent API Keys, ensure they are stored securely (e.g., environment variables, secure configuration) and never expose them directly in client-side code. If using JWT Tokens, implement an automatic refresh mechanism since they expire after 7 days - consider using a server-side proxy to handle token renewal and keep tokens secure.
-
 #### `modelId`
 
 **Type:** `string` | **Required:** ✅  
@@ -338,7 +310,6 @@ When using data attributes for multiple chat bubbles, convert camelCase property
 ### Common Issues
 
 **CORS Errors**: Ensure your API endpoint allows requests from your domain
-**Authentication Failures**: Verify your API key is correct and has proper permissions
 **CDN Version Delays**: Sometimes the `@latest` tag on jsDelivr CDN takes time to propagate to all edge servers and may not deliver the newest version immediately. If you need the latest features or fixes, specify the exact version number instead of using `@latest`:
 
 ```html