@nethesis/chat-island 0.1.13 → 0.1.14

package/README.md

@@ -110,6 +110,8 @@ A complete example page is in `widget-example/`; the live demo is `index.html`.
 | `chat-island-close` | in | |
 | `chat-island-new` | in | open the new chat panel |
 | `chat-island-delete` | in | `{ username }` purge a conversation, leave or destroy a group |
+| `chat-island-send` | in | `{ username, text }` send a text to an operator or group |
+| `chat-island-group-create` | in | `{ name, members }` create a group with these usernames and open it |
 | `chat-island-contacts` | in | `{ contacts }` names, avatars, presence, number |
 | `chat-island-conversations-request` | in | ask for the list |
 | `chat-island-theme-change` | in | `{ theme }` light, dark or system, remembered |
@@ -122,6 +124,24 @@ A complete example page is in `widget-example/`; the live demo is `index.html`.
 | `chat-island-call` | out | `{ username, number }` |
 | `chat-island-notify` | out | `{ peer, name, body, kind, author, text, attachment, avatar, ts }` message not in view |
 
+## Integrate in an existing app
+
+An app with its own users (WebTop, an intranet) embeds the widget and builds its view on the events:
+
+1. log the user in on the CTI (`/api/login`, or a QR code token with two-factor authentication) and pass `<cti_host>:<username>:<token>` as `data-config`;
+2. on `chat-island-status` `unauthorized`, log in again and set the new token in `data-config`: the island reconnects in place;
+3. keep its conversation list with `chat-island-conversations-request` / `chat-island-conversations`, badges with `chat-island-unread`;
+4. drive the island with `chat-island-open`, `chat-island-close`, `chat-island-send`, `chat-island-group-create`, `chat-island-delete`; `newChatButton: false` hides the island's own entry point;
+5. serve `chat-island-sw.js` from its own origin for notifications with the tab closed.
+
+```js
+const send = (name, detail) => window.dispatchEvent(new CustomEvent(name, { detail }))
+window.addEventListener('chat-island-conversations', (e) => render(e.detail.conversations))
+send('chat-island-conversations-request')
+send('chat-island-group-create', { name: 'Support', members: ['mario', 'anna'] })
+send('chat-island-send', { username: 'mario', text: 'Ciao!' })
+```
+
 ## Live demo
 
 `index.html` is published on [GitHub Pages](https://nethesis.github.io/chat-island/) by `.github/workflows/pages.yml` at every push to `main`, with the widget built from the same commit. It logs in with NethVoice credentials (or a token), mounts the widget and shows its events.

package/dist/index.js

@@ -5063,9 +5063,9 @@ function Jr({ dataConfig: e, position: t = "bottom-right", theme: n, serviceWork
 			scope: "contacts",
 			message: e.message
 		}));
-		let d = X("chat-island-open", ({ username: t }) => t && e.openChat(t)), f = X("chat-island-close", () => e.closeChat()), p = X("chat-island-new", () => e.setPicker(!0)), m = X("chat-island-delete", ({ username: e }) => e && N.remove(e)), h = X("chat-island-contacts", ({ contacts: t }) => t && e.setContacts(t)), _ = X("chat-island-conversations-request", () => Y("chat-island-conversations", { conversations: Wr() }));
+		let d = X("chat-island-open", ({ username: t }) => t && e.openChat(t)), f = X("chat-island-close", () => e.closeChat()), p = X("chat-island-new", () => e.setPicker(!0)), m = X("chat-island-delete", ({ username: e }) => e && N.remove(e)), h = X("chat-island-send", ({ username: e, text: t }) => e && t && N.send(e, t).catch(() => {})), _ = X("chat-island-group-create", ({ name: e, members: t }) => e && t?.length && N.createGroup(e, t)), v = X("chat-island-contacts", ({ contacts: t }) => t && e.setContacts(t)), x = X("chat-island-conversations-request", () => Y("chat-island-conversations", { conversations: Wr() }));
 		return () => {
-			window.removeEventListener("pagehide", s), window.clearInterval(u), _(), p(), m(), d(), f(), h(), O.current && t.disablePush(O.current.service, O.current.node).catch(() => {}), O.current = null, t.stop(), C.current = null, D.current = !1;
+			window.removeEventListener("pagehide", s), window.clearInterval(u), x(), p(), m(), h(), _(), d(), f(), v(), O.current && t.disablePush(O.current.service, O.current.node).catch(() => {}), O.current = null, t.stop(), C.current = null, D.current = !1;
 		};
 	}, [
 		g,