@accurix/centrinfo-widget 1.0.1 → 1.1.0

package/README.md

@@ -17,7 +17,7 @@ Zero-JS, via `data-*` on the script:
 
 ```html
 <script
-  src="https://cdn.accurix.com/centrinfo/js/sdk-centrinfo-widget-v1.0.0/centrinfo-widget.js"
+  src="https://cdn.accurixtech.com/centrinfo/js/sdk-centrinfo-widget-v1.0.0/centrinfo-widget.js"
   data-token="pub_8f3k…"
   defer
 ></script>
@@ -27,7 +27,7 @@ Or call `init` yourself:
 
 ```html
 <script
-  src="https://cdn.accurix.com/centrinfo/js/sdk-centrinfo-widget-v1.0.0/centrinfo-widget.js"
+  src="https://cdn.accurixtech.com/centrinfo/js/sdk-centrinfo-widget-v1.0.0/centrinfo-widget.js"
   defer
 ></script>
 <script>
@@ -53,8 +53,11 @@ const widget = init({ token: 'pub_8f3k…' });
 | ------------------------------------------------------------- | ----------------------------- | ----------- | ----------------------------------------------------------------------------------------------------------------------------------- |
 | `token` **(required)**                                        | string                        | —           | The org's `pub_*` token. It _is_ the org identity.                                                                                  |
 | `analyticsContextToken`                                       | string                        | —           | Server-signed governed analytics context. It must expire within 15 minutes and be scoped to this public widget token.               |
+| `identityToken`                                               | string                        | —           | Short-lived customer identity JWT. Authenticated history is scoped to its verified external user ID.                                |
+| `getIdentityToken`                                            | function                      | —           | Returns a fresh customer identity JWT before authenticated requests. Prefer this for expiring tokens.                               |
 | `apiBaseUrl`                                                  | string                        | prod API    | Override for staging / self-host.                                                                                                   |
 | `accentColor`                                                 | string                        | brand green | Any CSS color — drives the launcher, header, user bubbles & send button (a darker shade for the gradient is derived automatically). |
+| `themeTokens`                                                 | object                        | —           | Enterprise theme tokens for chat surfaces: accent, background, surface, text, muted text, border, shadow, radius, and font family.  |
 | `launcherIcon`                                                | string                        | chat glyph  | Image URL (e.g. the org's logo) shown in the launcher bubble.                                                                       |
 | `theme`                                                       | `'light' \| 'dark' \| 'auto'` | `'auto'`    | `auto` follows the host's `prefers-color-scheme`; `light`/`dark` force it.                                                          |
 | `openByDefault`                                               | boolean                       | `false`     | Open the panel on load.                                                                                                             |
@@ -63,11 +66,58 @@ const widget = init({ token: 'pub_8f3k…' });
 | `configRefreshSeconds`                                        | number                        | `30`        | While the panel is open, refresh token branding/actions from `bootstrap`; set `0` to disable.                                       |
 | `onOpen` / `onClose` / `onMessage` / `onAction` / `onHandoff` | function                      | —           | Event hooks.                                                                                                                        |
 
+```ts
+init({
+  token: 'pub_8f3k...',
+  themeTokens: {
+    accent: '#176b45',
+    accentStrong: '#0f5134',
+    background: '#f8fafc',
+    surface: '#ffffff',
+    surfaceMuted: '#f1f5f9',
+    text: '#0f172a',
+    mutedText: '#64748b',
+    border: '#cbd5e1',
+    radius: '10px',
+    fontFamily: 'Inter, system-ui, sans-serif',
+  },
+});
+```
+
 Persona (agent name/avatar/greeting), the voice toggle, and which lead-gen
 actions appear all come from the token via `GET /public-chat/bootstrap` — not
 from the snippet. Open widgets refresh that bootstrap data every 30 seconds, so
 saved dashboard settings reach visitors without a page reload.
 
+## Authenticated history
+
+For a logged-in customer, mint a short-lived identity token on the host
+backend and supply `getIdentityToken`. Keep the signing private key on the
+server, and use a stable external user ID for that customer.
+
+```ts
+const widget = init({
+  token: 'pub_8f3k...',
+  getIdentityToken: async () => {
+    const response = await fetch('/api/centrinfo/token', {
+      credentials: 'include',
+    });
+    if (!response.ok) throw new Error('Sign in is required.');
+    return response.json();
+  },
+});
+```
+
+Authenticated conversations are restored from Centrinfo's backend in a new
+browser or device after the identity token is verified. Anonymous history is
+stored only according to the widget's `persistence` option and cannot be
+loaded through authenticated history.
+
+Call `widget.shutdown()` on host-app logout when the page may be shared. It
+removes the local transcript and resets the mounted widget to an anonymous
+session. Retained server history is not deleted and returns only when the same
+verified customer signs in again.
+
 When business data chat is enabled for a widget token, responses follow a
 visitor-safe presentation contract:
 
@@ -156,7 +206,7 @@ Remove `?demo` to test the real public-chat API and the organization’s publish
 Canonical v1 CDN URL:
 
 ```text
-https://cdn.accurix.com/centrinfo/js/sdk-centrinfo-widget-v1.0.0/centrinfo-widget.js
+https://cdn.accurixtech.com/centrinfo/js/sdk-centrinfo-widget-v1.0.0/centrinfo-widget.js
 ```
 
 ## Status