bstp-agent-widget 0.2.78 → 0.2.80

package/README.md

@@ -30,31 +30,88 @@ npm publish --access public
 bun add bstp-agent-widget
 ```
 
+### 1. Provide runtime configuration via `/environment.json`
+
+Host applications must expose a GenAI configuration inside their own `public/environment.json`. The widget loads this file by default (or the URL you pass with `environmentUrl`).
+
+```json
+{
+  "url": {
+    "api": "https://your-api",
+    "apiPaths": {
+      "genai": "genai/api/v1"
+    }
+  },
+  "genai": {
+    "config": {
+      "assistantId": 220,
+      "agents": [
+        {
+          "assistantKey": "salesAgent",
+          "assistantId": 220,
+          "label": "Sales Assistant",
+          "initialMessage": "Hello, my customer id is "
+        }
+      ]
+    }
+  }
+}
+```
+
+> GenAI login credentials are bundled inside the widget. Do **not** expose `genai.init` or any client secrets in your app's `environment.json`.
+
+### 2. Mount the widget (React example)
+
+Prefer mounting through `mountAgentChatWidgetFromEnvironment`. It automatically hydrates GenAI config from the environment file, while allowing optional overrides through the `config` option.
+
 ```tsx
-import { AgentChatWidget } from 'bstp-agent-widget';
+import { useEffect, useRef } from 'react';
+import { mountAgentChatWidgetFromEnvironment } from 'bstp-agent-widget';
 import 'bstp-agent-widget/style.css';
 
-export function Page() {
-  return (
-    <AgentChatWidget
-      config={{
-        baseUrl: 'https://your-genai-api-url',
-        assistantId: 123,
-        genaiInit: {
-          email: 'agent@example.com',
-          clientSecret: 'secret',
+export function AgentWidgetHost() {
+  const hostRef = useRef<HTMLDivElement | null>(null);
+
+  useEffect(() => {
+    if (!hostRef.current) return;
+
+    let cleanup: (() => void) | undefined;
+
+    (async () => {
+      cleanup = await mountAgentChatWidgetFromEnvironment(hostRef.current!, {
+        runtime: {
+          customerId: '590100010884',
+          customerToken: 'jwt-token',
+          language: 'tr-TR',
         },
-      }}
-      runtime={{
-        customerId: '590100010884',
-        customerToken: 'jwt-token',
-        language: 'tr-TR',
-      }}
-    />
-  );
+        // Optional: override assistant selection coming from environment.json
+        config: {
+          assistantId: 220,
+          assistants: [
+            {
+              assistantKey: 'serviceAgent',
+              assistantId: 94,
+              label: 'Get help with your service issues',
+              initialMessage: 'Hello, my customer id is ',
+            },
+          ],
+        },
+        // Optional UI overrides
+        // theme: { withinPortal: true, fabPosition: { bottom: 16, right: 16 } },
+        // Optional: supply a different environment file
+        // environmentUrl: '/configs/widget-environment.json',
+      });
+    })();
+
+    return () => cleanup?.();
+  }, []);
+
+  return <div ref={hostRef} />;
 }
 ```
 
+> Precedence rules: runtime data is always provided by the host. If you pass a `config` option, the widget overrides the `genai.config` block from `environment.json` before booting (so every consumer, including initial automated messages, sees the admin UI values). When no override is provided, it falls back to the values coming from `environment.json`.
+
 ## Development Notes
 
 - `react` and `react-dom` are defined as `peerDependencies`.
@@ -101,15 +158,19 @@ export class AgentChatWidgetComponent implements AfterViewInit, OnDestroy {
         customerToken: 'jwt-token',
         language: 'en-US',
       },
-      // Agent config can be supplied by host app.
-      // baseUrl and genai.init still come from environment.json.
+      // Optional: override what environment.json provides
       config: {
         assistantId: 220,
         assistants: [
-          { assistantKey: 'salesAgent', assistantId: 220, label: 'Sales Assistant' },
+          {
+            assistantKey: 'salesAgent',
+            assistantId: 220,
+            label: 'Sales Assistant',
+            initialMessage: 'Hello, my customer id is ',
+          },
         ],
       },
-      ui: {
+      theme: {
         zIndex: 12000,
         withinPortal: true,
         fabPosition: { bottom: 16, right: 16 },
@@ -137,13 +198,21 @@ export class AgentChatWidgetComponent implements AfterViewInit, OnDestroy {
   },
   "genai": {
     "config": {
-      "assistantId": 220
+      "assistantId": 220,
+      "agents": [
+        {
+          "assistantKey": "serviceAgent",
+          "assistantId": 94,
+          "label": "Get help with your service issues",
+          "initialMessage": "Hello, my customer id is "
+        }
+      ]
     }
   }
 }
 ```
 
-Base URL is resolved from `url.api` + `url.apiPaths.genai`.
+Base URL is resolved from `url.api` + `url.apiPaths.genai`. External `config` overrides supplied when mounting the widget take precedence over this environment file. GenAI login credentials are managed internally by the widget, so Angular hosts never provide `genai.init`.
 
 # React Starter Kit
 

package/dist/agent-widget.js

@@ -28695,8 +28695,8 @@ function PF() {
 		sendMessage: _,
 		sendInitialMessage: u(async () => {
 			if (m.current || l || r.length > 0 || !e || !t) return;
-			let n = nk(e), i = ck(t), a = i ? `${i} ${n}`.trim() : `Hello, my customer id is ${n}`;
-			m.current = !0, await _(a, { showUserBubble: !1 });
+			let n = nk(e), i = ck(t)?.trim(), a = null;
+			a = i ? n ? `${i} ${n}`.trim() : i : n ? `Hello, my customer id is ${n}` : "Hello", a.trim() && (m.current = !0, await _(a, { showUserBubble: !1 }));
 		}, [
 			e,
 			t,
@@ -33534,7 +33534,7 @@ var zB = RB(), BB = {
 		apiPaths: {
 			crm: "/crm",
 			uiAuthz: "/ui-authz",
-			genai: "genai/api/v1"
+			genai: "/genai/api/v1"
 		}
 	},
 	keycloak: {
@@ -33573,20 +33573,28 @@ var zB = RB(), BB = {
 		}
 	}
 };
-//#endregion
-//#region src/lib/config.service.ts
-async function VB(e) {
+function VB(e) {
+	let t = BB.genai?.init;
+	return !t || e.genai?.init ? e : {
+		...e,
+		genai: {
+			...e.genai ?? {},
+			init: t
+		}
+	};
+}
+async function HB(e) {
 	let t = `${(globalThis.__BASE_URL__ ?? "").replace(/\/$/, "")}/environment.json`, n = e ?? t;
 	try {
 		let e = await fetch(n);
-		return e.ok ? await e.json() : BB;
+		return e.ok ? VB(await e.json()) : BB;
 	} catch {
 		return BB;
 	}
 }
 //#endregion
 //#region src/lib/agent-widget.tsx
-function HB({ config: e, runtime: t, theme: n }) {
+function UB({ config: e, runtime: t, theme: n }) {
 	return _A.locale || _A.activate("en"), /* @__PURE__ */ T(fC, {
 		i18n: _A,
 		children: /* @__PURE__ */ T(Gn, {
@@ -33605,17 +33613,17 @@ function HB({ config: e, runtime: t, theme: n }) {
 		})
 	});
 }
-var UB = /* @__PURE__ */ new WeakMap();
-function WB(e, t) {
-	let n = UB.get(e);
+var WB = /* @__PURE__ */ new WeakMap();
+function GB(e, t) {
+	let n = WB.get(e);
 	n && n.unmount();
 	let r = D(e);
-	return r.render(/* @__PURE__ */ T(HB, { ...t })), UB.set(e, r), () => {
-		let t = UB.get(e);
-		t && (t.unmount(), UB.delete(e));
+	return r.render(/* @__PURE__ */ T(UB, { ...t })), WB.set(e, r), () => {
+		let t = WB.get(e);
+		t && (t.unmount(), WB.delete(e));
 	};
 }
-function GB(e) {
+function KB(e) {
 	let t = e.genai?.config;
 	if (!t?.assistantId) throw Error("GenAI config is missing in environment.json.");
 	return {
@@ -33624,22 +33632,27 @@ function GB(e) {
 		genaiInit: e.genai?.init
 	};
 }
-function KB(e, t) {
+function qB(e, t) {
 	return t ? {
 		assistantId: t.assistantId ?? e.assistantId,
 		assistants: t.assistants ?? e.assistants,
 		genaiInit: e.genaiInit
 	} : e;
 }
-async function qB(e, t) {
-	let n = await VB(t.environmentUrl);
-	return OF(n), WB(e, {
-		config: KB(GB(n), t.config),
+function JB(e, t) {
+	if (!t) return e;
+	let n = e.genai ??= {}, r = n.config ??= {};
+	return typeof t.assistantId == "number" && (r.assistantId = t.assistantId), t.assistants && (r.agents = t.assistants), e;
+}
+async function YB(e, t) {
+	let n = JB(await HB(t.environmentUrl), t.config);
+	return OF(n), GB(e, {
+		config: qB(KB(n), t.config),
 		runtime: t.runtime,
 		theme: t.theme
 	});
 }
 //#endregion
-export { HB as AgentChatWidget, WB as mountAgentChatWidget, qB as mountAgentChatWidgetFromEnvironment };
+export { UB as AgentChatWidget, GB as mountAgentChatWidget, YB as mountAgentChatWidgetFromEnvironment };
 
 //# sourceMappingURL=agent-widget.js.map