@evelan/jexity-widget 0.29.0 → 0.30.0

package/README.md

@@ -76,6 +76,7 @@ function HomePage() {
 | `locale` | `string` | browser / `'de'` | Force locale (`'de'` \| `'en'`). Overrides browser detection |
 | `parentOrigin` | `string` | `window.location.origin` | Trusted origin for postMessage dashboard preview updates |
 | `theme` | `JexityTheme` | — | Granular per-element color overrides (see below) |
+| `userToken` | `string \| () => string \| Promise<string>` | — | A signed-in user's pass: an HS256 JWT your **server** signs with the project's sign-in key (`sub`, optional `name`, `email`, `account_id`, `iat`, `exp` ≤ 24 h). A function is called on every bootstrap, including the hourly refresh. A refused pass stops the widget; it never falls back to anonymous. Script tag: `data-user-token`. A pass for another user (a changed attribute or string prop) starts over; with a function, call `logout()` at sign-out. See the help center: *Recognize signed-in users*. |
 
 ### Granular Theme Overrides
 
@@ -120,10 +121,15 @@ chat.close()                   // Close the chat window
 chat.toggle()                  // Toggle open/closed
 chat.ask("How do I crawl?")    // Open the chat and send this question
 chat.shutdown()                // Remove widget from DOM
+chat.logout()                  // Signed-in user signed out: forget this tab's chats, start over with the current pass
 chat.isOpen                    // readonly boolean — current open state
 chat.subscribe(cb)             // Subscribe to open/close changes
                                // Returns unsubscribe function
 
+// Your user signed out, also before the chat has loaded on this page:
+import { logout } from "@evelan/jexity-widget" // or "@evelan/jexity-widget/react"
+logout()                       // Forget this tab's chats
+
 // IIFE global (script tag):
 window.JexityChat.open()
 window.JexityChat.close()