@mypatientspace/chatbot-widget 1.0.75 → 1.0.77

package/README.md

@@ -94,7 +94,7 @@ yarn preview
 <script src="https://unpkg.com/@mypatientspace/chatbot-widget@latest/dist/mypatientspace-widget.umd.js"></script>
 <script>
   ChatbotWidget.init({
-    apiEndpoint: 'https://your-api.com/chat',
+    apiEndpoint: 'https://your-api.com',
     token: 'your-auth-token'
   });
 </script>
@@ -106,8 +106,9 @@ yarn preview
 <script>
   ChatbotWidget.init({
     // API & Auth
-    apiEndpoint: 'https://your-api.com/chat',
+    apiEndpoint: 'https://your-api.com',
     token: 'your-auth-token',
+    userType: 'patient',             // 'patient' (default) or 'staff'
     assistantId: 'your-assistant-id',
 
     // Display mode
@@ -168,10 +169,63 @@ yarn preview
 import '@mypatientspace/chatbot-widget';
 
 ChatbotWidget.init({
-  apiEndpoint: 'https://your-api.com/chat'
+  apiEndpoint: 'https://your-api.com'
 });
 ```
 
+### Patient & Staff Integration
+
+The widget supports two user types with separate API routing. Each type uses different backend endpoints for chat, message history, and assistant lookup.
+
+#### Patient (Default)
+
+Patient mode is the default — no `userType` needed:
+
+```html
+<script>
+  ChatbotWidget.init({
+    apiEndpoint: 'https://your-api.com',
+    token: 'your-auth-token'
+  });
+</script>
+```
+
+API endpoints used:
+- `POST /api/patient/chat/stream` — Send messages
+- `GET /api/patient/chat/messages` — Load history
+- `GET /api/patient/assistant` — Get assistant config
+
+#### Staff
+
+Staff mode requires `userType: 'staff'` along with `contextPatientId` and `patientTypeId`:
+
+```html
+<script>
+  ChatbotWidget.init({
+    apiEndpoint: 'https://your-api.com',
+    token: 'your-auth-token',
+    userType: 'staff',
+    contextPatientId: 'patient-123',
+    patientTypeId: 'type-456'
+  });
+</script>
+```
+
+API endpoints used:
+- `POST /api/staff/chat/stream` — Send messages (includes `contextPatientId` in body)
+- `GET /api/staff/chat/messages` — Load history (requires `contextPatientId` query param)
+- `GET /api/staff/assistant/{patientTypeId}` — Get assistant config
+
+#### Required Fields by User Type
+
+| Field | Patient | Staff |
+|-------|---------|-------|
+| `apiEndpoint` | Required | Required |
+| `token` | Required | Required |
+| `userType` | Optional (default) | `'staff'` |
+| `contextPatientId` | Optional | Required |
+| `patientTypeId` | - | Required |
+
 ### API Methods
 ```javascript
 ChatbotWidget.open();         // Open chat window
@@ -196,7 +250,7 @@ Embed the chat inside an existing element:
 <script src="https://unpkg.com/@mypatientspace/chatbot-widget@latest/dist/mypatientspace-widget.umd.js"></script>
 <script>
   ChatbotWidget.init({
-    apiEndpoint: 'https://your-api.com/chat',
+    apiEndpoint: 'https://your-api.com',
     containerSelector: '#my-chat'
   });
 </script>
@@ -209,7 +263,7 @@ Enable floating mode with FAB button (classic chatbot style):
 ```html
 <script>
   ChatbotWidget.init({
-    apiEndpoint: 'https://your-api.com/chat',
+    apiEndpoint: 'https://your-api.com',
     floatingMode: true
   });
 </script>
@@ -249,7 +303,7 @@ class ChatActivity : AppCompatActivity() {
                     <script src="https://unpkg.com/@mypatientspace/chatbot-widget@latest/dist/mypatientspace-widget.umd.js"></script>
                     <script>
                         ChatbotWidget.init({
-                            apiEndpoint: 'https://your-api.com/chat'
+                            apiEndpoint: 'https://your-api.com'
                         });
                         ChatbotWidget.open();
                     </script>
@@ -293,7 +347,7 @@ class ChatViewController: UIViewController {
             <script src="https://unpkg.com/@mypatientspace/chatbot-widget@latest/dist/mypatientspace-widget.umd.js"></script>
             <script>
                 ChatbotWidget.init({
-                    apiEndpoint: 'https://your-api.com/chat'
+                    apiEndpoint: 'https://your-api.com'
                 });
                 ChatbotWidget.open();
             </script>
@@ -336,7 +390,7 @@ class ChatViewController: UIViewController {
         "<body>"
         "<script src='https://unpkg.com/@mypatientspace/chatbot-widget@latest/dist/mypatientspace-widget.umd.js'></script>"
         "<script>"
-        "ChatbotWidget.init({ apiEndpoint: 'https://your-api.com/chat' });"
+        "ChatbotWidget.init({ apiEndpoint: 'https://your-api.com' });"
         "ChatbotWidget.open();"
         "</script>"
         "</body>"
@@ -363,7 +417,7 @@ const ChatScreen = () => {
         <script src="https://unpkg.com/@mypatientspace/chatbot-widget@latest/dist/mypatientspace-widget.umd.js"></script>
         <script>
             ChatbotWidget.init({
-                apiEndpoint: 'https://your-api.com/chat'
+                apiEndpoint: 'https://your-api.com'
             });
             ChatbotWidget.open();
         </script>
@@ -387,8 +441,10 @@ const ChatScreen = () => {
 
 | Option | Type | Default | Description |
 |--------|------|---------|-------------|
-| `apiEndpoint` | `string` | - | Chat API endpoint URL (widget offline if not set) |
+| `apiEndpoint` | `string` | - | Base API URL, e.g. `https://your-api.com` (widget offline if not set) |
 | `token` | `string` | - | Auth token for API requests |
+| `userType` | `'patient' \| 'staff'` | `'patient'` | User type for API endpoint routing |
+| `patientTypeId` | `string` | - | Patient type ID for staff assistant lookup (required when `userType` is `'staff'`) |
 | `sessionId` | `string` | - | Existing session ID to resume |
 | `assistantId` | `string` | - | Specific assistant ID to use |
 | `contextPatientId` | `string` | - | Patient context for the chat |