@belonguniverseai/react-sdk 0.6.18 → 0.6.20

package/README.md

@@ -48,6 +48,36 @@ export function App() {
 The dock renders into its own shadow root, so its styles never leak into (or
 inherit from) your app.
 
+### Host context (`window.belong.init`)
+
+The script-tag embed's `init` takes two optional host-context props that
+personalise what the dock shows before the first message:
+
+| Prop          | Type                                              | Required | Description                                                         |
+| ------------- | ------------------------------------------------- | -------- | ------------------------------------------------------------------- |
+| `user`        | `{ displayName?: string }`                        | no       | Signed-in user; personalises the first message and the avatar menu. |
+| `pageContext` | `{ label?: string; fromDocumentTitle?: boolean }` | no       | Page label for the first message; defaults to the tab title.        |
+
+Both have runtime setters on `window.belong`, alongside `setLocale` and
+`setWorkspace`:
+
+- `belong.setUser({ displayName })` — wins over `init({ user })`. `setUser(null)`
+  drops the override back to the init value; `setUser({ displayName: null })`
+  means "no name for this user" and shows none even when `init` seeded one.
+- `belong.setPageContext(label)` — wins over `init({ pageContext })` and the tab
+  title; `setPageContext(null)` drops the override. With no label anywhere, the
+  dock reads `document.title` live (SPA navigation updates it), unless the host
+  passed `pageContext: { fromDocumentTitle: false }`.
+
+A re-`init` states the host's context in full: omitting `user` or
+`pageContext` CLEARS what a previous `init` seeded (the config is replaced
+wholesale, not merged). A live `setUser` / `setPageContext` override outranks
+`init` and survives a later one — clear it with `null` to hand control back to
+the init values.
+
+Neither value is persisted — a reload re-derives both from the host's next
+`init`.
+
 ## Account authorization and Content Security Policy
 
 Browser-bound account authorization opens an `about:blank` popup, clears its

package/dist/api/account-connectors.d.ts

@@ -17,8 +17,8 @@ declare const accountConnectorSchema: z.ZodObject<{
         label: z.ZodString;
         status: z.ZodEnum<{
             error: "error";
-            ready: "ready";
             needs_auth: "needs_auth";
+            ready: "ready";
             needs_admin_consent: "needs_admin_consent";
             disabled: "disabled";
         }>;
@@ -26,12 +26,12 @@ declare const accountConnectorSchema: z.ZodObject<{
     actions: z.ZodArray<z.ZodObject<{
         id: z.ZodString;
         kind: z.ZodEnum<{
-            disconnect: "disconnect";
             authorization: "authorization";
+            disconnect: "disconnect";
         }>;
         label: z.ZodEnum<{
-            disconnect: "disconnect";
             reconnect: "reconnect";
+            disconnect: "disconnect";
             connect: "connect";
             grant_admin_consent: "grant_admin_consent";
         }>;