@tellyouai/plugin 0.1.0 → 0.1.1

package/README.md

@@ -9,7 +9,7 @@ it can be used from React, Vue, Svelte, or a plain browser application.
 Pin an exact release when application behavior must remain stable:
 
 ```sh
-npm install --save-exact @tellyouai/plugin@0.1.0
+npm install --save-exact @tellyouai/plugin@0.1.1
 ```
 
 Initialize the plugin after the page has loaded:
@@ -22,6 +22,7 @@ const plugin = await initialize({
 });
 
 plugin.toggle({ open: true });
+// Call plugin.destroy() when the host no longer needs the plugin.
 ```
 
 For an inline or otherwise custom target, create the element before
@@ -48,6 +49,29 @@ Pass an array to initialize multiple instances. The returned controller also
 provides `load`, `goTo`, `setConsent`, and `update` methods. Importing the
 package is safe in server-side builds, but `initialize` must run in a browser.
 
+In React, connect the controller to the component lifecycle:
+
+```tsx
+useEffect(() => {
+  let plugin: Awaited<ReturnType<typeof initialize>> | undefined;
+  let cancelled = false;
+
+  void initialize({ entityId: "YOUR_ENTITY_ID" }).then((controller) => {
+    if (cancelled) controller.destroy();
+    else plugin = controller;
+  });
+
+  return () => {
+    cancelled = true;
+    plugin?.destroy();
+  };
+}, []);
+```
+
+`destroy()` unmounts every instance owned by that controller. Pass a target ID
+to destroy only that instance. Containers created automatically by the plugin
+are removed; host-provided target elements remain in the document.
+
 ## CDN script
 
 Existing script integrations remain supported:

package/dist/package/index.js

@@ -85437,35 +85437,44 @@ var J9, Y9, Wxe, Gxe = o((() => {
 		return n;
 	}, $9 = () => {
 		Qxe();
-		let e = window, t = e[Zxe] ||= /* @__PURE__ */ new Map(), n = {
+		let e = window, t = Symbol("tellyouai.plugin.controller"), n = /* @__PURE__ */ new Set(), r = e[Zxe] ||= /* @__PURE__ */ new Map(), i = {
 			load: () => {
-				let n = e.tellyouai, r = Array.isArray(n) ? n : [n];
-				r.length === 0 && r.push(void 0), console.log("Tellyou AI: Initializing plugin instances:", r), r.forEach((e, n) => {
-					let r = e?.target;
+				let i = e.tellyouai, a = Array.isArray(i) ? i : [i];
+				a.length === 0 && a.push(void 0), console.log("Tellyou AI: Initializing plugin instances:", a), a.forEach((e, i) => {
+					let a = e?.target;
 					try {
-						let e = "tellyouai-plugin-" + n, i = !!r && r !== e, a = r || e, o = document.getElementById(a);
-						if (!o && !i && (o = document.createElement("div"), o.id = a, document.body.appendChild(o)), !o) throw Error("Tellyou AI: Failed to find target element for instance " + n + ", target: " + a + ", isCustomTarget: " + i);
-						let s = t.get(a);
-						if (s) {
-							if (s.elem === o && o.isConnected) return;
-							s.root.unmount(), t.delete(a);
+						let e = "tellyouai-plugin-" + i, o = !!a && a !== e, s = a || e, c = document.getElementById(s), l = !1;
+						if (!c && !o && (c = document.createElement("div"), c.id = s, document.body.appendChild(c), l = !0), !c) throw Error("Tellyou AI: Failed to find target element for instance " + i + ", target: " + s + ", isCustomTarget: " + o);
+						let u = r.get(s);
+						if (u) {
+							if (u.elem === c && c.isConnected) return;
+							u.root.unmount(), r.delete(s);
 						}
-						o.innerHTML = "";
-						let c = (0, Xxe.createRoot)(o);
-						t.set(a, {
-							root: c,
-							elem: o
-						}), c.render(/* @__PURE__ */ (0, Z9.jsx)(X9.StrictMode, { children: /* @__PURE__ */ (0, Z9.jsx)(uL, { children: /* @__PURE__ */ (0, Z9.jsxs)(sn, {
-							instanceIndex: n,
-							target: a,
-							isCustomTarget: i,
-							children: [/* @__PURE__ */ (0, Z9.jsx)(qxe, { id: a }), /* @__PURE__ */ (0, Z9.jsx)(Hxe, {})]
+						c.innerHTML = "";
+						let d = (0, Xxe.createRoot)(c);
+						r.set(s, {
+							root: d,
+							elem: c,
+							owner: t,
+							createdElement: l
+						}), n.add(s), d.render(/* @__PURE__ */ (0, Z9.jsx)(X9.StrictMode, { children: /* @__PURE__ */ (0, Z9.jsx)(uL, { children: /* @__PURE__ */ (0, Z9.jsxs)(sn, {
+							instanceIndex: i,
+							target: s,
+							isCustomTarget: o,
+							children: [/* @__PURE__ */ (0, Z9.jsx)(qxe, { id: s }), /* @__PURE__ */ (0, Z9.jsx)(Hxe, {})]
 						}) }) }));
 					} catch (e) {
-						console.warn("Tellyou AI: Failed to initialize plugin instance " + n, r, e);
+						console.warn("Tellyou AI: Failed to initialize plugin instance " + i, a, e);
 					}
 				});
 			},
+			destroy: (e) => {
+				let i = e ? [e] : [...n];
+				for (let e of i) {
+					let i = r.get(e);
+					i && i.owner === t && (i.root.unmount(), r.delete(e), n.delete(e), i.createdElement && i.elem.isConnected && i.elem.remove());
+				}
+			},
 			toggle: ({ target: e, open: t, userMessage: n, assistantMessage: r }) => {
 				window.dispatchEvent(new CustomEvent("tellyouai-plugin", { detail: {
 					id: e,
@@ -85491,8 +85500,8 @@ var J9, Y9, Wxe, Gxe = o((() => {
 				}
 				i || Object.assign(r, a[0] || {}), window.dispatchEvent(new CustomEvent("tellyouai-config-changed", { detail: { target: o } }));
 			}
-		}, r = e.tellyouai ||= {};
-		return Object.assign(r, n), n;
+		}, a = e.tellyouai ||= {};
+		return Object.assign(a, i), i;
 	};
 })), eSe = async (e) => {
 	if (typeof window > "u" || typeof document > "u") throw Error("Tellyou AI can only be initialized in a browser");

package/dist/package/public.d.ts

@@ -146,6 +146,7 @@ export type ToggleOptions = {
 };
 export type PluginController = {
     load: () => void;
+    destroy: (target?: string) => void;
     toggle: (options: ToggleOptions) => void;
     goTo: (mode: Mode, target?: string) => void;
     setConsent: (consent: Pick<ConsentState, "functional" | "analytics">) => void;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tellyouai/plugin",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Framework-agnostic browser SDK for the Tellyou AI plugin",
   "repository": {
     "type": "git",