@agentup-inksen/web-chat-core 0.0.1

package/README.md

@@ -0,0 +1,33 @@
+# @agentup-inksen/web-chat-core
+
+Framework-agnostic SDK that the AgentUp web chat clients (`@agentup-inksen/web-chat-app`, the bubble widget, future React Native clients) build on top of.
+
+```ts
+import { AgentUpChatClient, AgentUpChatHub } from '@agentup-inksen/web-chat-core';
+
+const api = new AgentUpChatClient({
+  apiUrl: 'https://api.example.com',
+  visitorToken: visitorJwtFromHost,
+  tenantId: 'acme'
+});
+
+const agents = await api.listAgents();
+const conversations = await api.listConversations();
+
+const hub = new AgentUpChatHub(
+  { apiUrl: 'https://api.example.com', accessTokenFactory: () => visitorJwtFromHost },
+  {
+    onMessage: (msg) => console.log('new', msg),
+    onConnectionStateChanged: (s) => console.log('state', s)
+  }
+);
+await hub.start();
+await hub.joinConversation(conversations[0].id);
+```
+
+Build:
+
+```bash
+npm install
+npm run build
+```

package/dist/index.cjs

@@ -0,0 +1,284 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  AgentUpChatClient: () => AgentUpChatClient,
+  AgentUpChatHub: () => AgentUpChatHub,
+  WebChatAuthError: () => WebChatAuthError,
+  storage: () => storage_exports
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/api-client.ts
+var WebChatAuthError = class extends Error {
+  constructor(message) {
+    super(message);
+    this.name = "WebChatAuthError";
+  }
+};
+var AgentUpChatClient = class {
+  constructor(config) {
+    __publicField(this, "baseUrl");
+    __publicField(this, "tenantId");
+    __publicField(this, "fetchImpl");
+    __publicField(this, "visitorToken");
+    if (!config.apiUrl) throw new Error("AgentUpChatClient: apiUrl is required");
+    if (!config.visitorToken) throw new Error("AgentUpChatClient: visitorToken is required");
+    this.baseUrl = config.apiUrl.replace(/\/$/, "");
+    this.visitorToken = config.visitorToken;
+    this.tenantId = config.tenantId;
+    this.fetchImpl = config.fetch ?? fetch.bind(globalThis);
+  }
+  /** Refresh the visitor token in place (e.g. after a silent re-auth round-trip). */
+  setVisitorToken(token) {
+    if (!token) throw new Error("AgentUpChatClient.setVisitorToken: empty token");
+    this.visitorToken = token;
+  }
+  listAgents(signal) {
+    return this.get("/api/webchat/agents", signal);
+  }
+  listConversations(signal) {
+    return this.get("/api/webchat/conversations", signal);
+  }
+  createConversation(agentCode) {
+    return this.post("/api/webchat/conversations", { agentCode });
+  }
+  getConversation(conversationId, signal) {
+    return this.get(`/api/webchat/conversations/${conversationId}`, signal);
+  }
+  /**
+   * Message history is returned on `GET /api/webchat/conversations/{id}` (there is no GET on
+   * `/api/webchat/messages/{id}` — that route is POST-only for sending).
+   */
+  async getMessages(conversationId, signal) {
+    const conv = await this.get(`/api/webchat/conversations/${conversationId}`, signal);
+    const raw = conv.messages;
+    if (!raw?.length) return [];
+    return raw.map((m) => ({
+      ...m,
+      conversationId: m.conversationId || conversationId
+    }));
+  }
+  /**
+   * REST fallback for sending. The API binds `[FromForm] content` (see `WebChatController`),
+   * not JSON — multipart/form-data is required.
+   */
+  sendMessage(conversationId, content) {
+    const form = new FormData();
+    form.append("content", content);
+    return this.postForm(`/api/webchat/messages/${conversationId}`, form);
+  }
+  closeConversation(conversationId) {
+    return this.post(`/api/webchat/conversations/${conversationId}/close`, {});
+  }
+  // ---------------- internals ----------------
+  async get(path, signal) {
+    const res = await this.fetchImpl(`${this.baseUrl}${path}`, {
+      method: "GET",
+      headers: this.headers(),
+      signal
+    });
+    return this.unwrap(res);
+  }
+  async post(path, body) {
+    const res = await this.fetchImpl(`${this.baseUrl}${path}`, {
+      method: "POST",
+      headers: { ...this.headers(), "Content-Type": "application/json" },
+      body: JSON.stringify(body ?? {})
+    });
+    return this.unwrap(res);
+  }
+  /** POST multipart/form-data (do not set Content-Type — boundary is set by the runtime). */
+  async postForm(path, formData) {
+    const res = await this.fetchImpl(`${this.baseUrl}${path}`, {
+      method: "POST",
+      headers: this.headers(),
+      body: formData
+    });
+    return this.unwrap(res);
+  }
+  headers() {
+    const h = {
+      Authorization: `Bearer ${this.visitorToken}`,
+      Accept: "application/json"
+    };
+    if (this.tenantId) h["X-Tenant-Id"] = this.tenantId;
+    return h;
+  }
+  async unwrap(res) {
+    if (res.status === 401) {
+      throw new WebChatAuthError("Visitor token expired or invalid");
+    }
+    if (!res.ok) {
+      let detail = "";
+      try {
+        const text = await res.text();
+        detail = text.length > 200 ? text.slice(0, 200) + "\u2026" : text;
+      } catch {
+      }
+      throw new Error(`AgentUp request ${res.url} failed (${res.status}): ${detail}`);
+    }
+    if (res.status === 204) return void 0;
+    const json = await res.json();
+    if (json && typeof json === "object" && "success" in json && "result" in json) {
+      const env = json;
+      if (!env.success) {
+        throw new Error(env.message ?? "AgentUp request failed");
+      }
+      return env.result;
+    }
+    return json;
+  }
+};
+
+// src/signalr-client.ts
+var import_signalr = require("@microsoft/signalr");
+var AgentUpChatHub = class {
+  constructor(options, handlers = {}) {
+    __publicField(this, "options");
+    __publicField(this, "handlers");
+    __publicField(this, "connection", null);
+    __publicField(this, "state", "idle");
+    this.options = options;
+    this.handlers = handlers;
+  }
+  get currentState() {
+    return this.state;
+  }
+  async start() {
+    if (this.connection && this.connection.state === import_signalr.HubConnectionState.Connected) {
+      return;
+    }
+    this.setState("connecting");
+    const base = this.options.apiUrl.replace(/\/$/, "");
+    const url = `${base}/api/chatHub`;
+    this.connection = new import_signalr.HubConnectionBuilder().withUrl(url, {
+      accessTokenFactory: () => Promise.resolve(this.options.accessTokenFactory())
+    }).withAutomaticReconnect().configureLogging(import_signalr.LogLevel.Warning).build();
+    this.connection.on("ReceiveMessage", (msg) => this.handlers.onMessage?.(msg));
+    this.connection.on(
+      "ReceiveMessageChunk",
+      (chunk) => this.handlers.onMessageChunk?.(chunk)
+    );
+    this.connection.on(
+      "UserTyping",
+      (payload) => this.handlers.onUserTyping?.(payload)
+    );
+    this.connection.on(
+      "UserStoppedTyping",
+      (userId) => this.handlers.onUserStoppedTyping?.(userId)
+    );
+    this.connection.on("Error", (msg) => this.handlers.onError?.(new Error(msg)));
+    this.connection.onreconnecting(() => this.setState("reconnecting"));
+    this.connection.onreconnected(() => this.setState("connected"));
+    this.connection.onclose(() => this.setState("disconnected"));
+    await this.connection.start();
+    this.setState("connected");
+  }
+  async stop() {
+    if (this.connection) {
+      await this.connection.stop();
+      this.connection = null;
+    }
+    this.setState("idle");
+  }
+  async joinConversation(conversationId) {
+    await this.ensureConnected();
+    await this.connection.invoke("JoinConversation", conversationId);
+  }
+  async leaveConversation(conversationId) {
+    if (this.connection?.state !== import_signalr.HubConnectionState.Connected) return;
+    await this.connection.invoke("LeaveConversation", conversationId);
+  }
+  async sendMessage(conversationId, content) {
+    await this.ensureConnected();
+    await this.connection.invoke("SendMessage", conversationId, content);
+  }
+  async sendTyping(conversationId, isTyping) {
+    if (this.connection?.state !== import_signalr.HubConnectionState.Connected) return;
+    await this.connection.invoke("Typing", conversationId, isTyping);
+  }
+  async ensureConnected() {
+    if (!this.connection) {
+      await this.start();
+      return;
+    }
+    if (this.connection.state !== import_signalr.HubConnectionState.Connected) {
+      await this.connection.start();
+      this.setState("connected");
+    }
+  }
+  setState(next) {
+    if (this.state === next) return;
+    this.state = next;
+    this.handlers.onConnectionStateChanged?.(next);
+  }
+};
+
+// src/storage.ts
+var storage_exports = {};
+__export(storage_exports, {
+  clearToken: () => clearToken,
+  getItem: () => getItem,
+  loadToken: () => loadToken,
+  removeItem: () => removeItem,
+  saveToken: () => saveToken,
+  setItem: () => setItem
+});
+var PREFIX = "agentup.webchat:";
+function getItem(key) {
+  try {
+    return localStorage.getItem(PREFIX + key);
+  } catch {
+    return null;
+  }
+}
+function setItem(key, value) {
+  try {
+    localStorage.setItem(PREFIX + key, value);
+  } catch {
+  }
+}
+function removeItem(key) {
+  try {
+    localStorage.removeItem(PREFIX + key);
+  } catch {
+  }
+}
+function saveToken(token) {
+  setItem("visitor_token", token);
+}
+function loadToken() {
+  return getItem("visitor_token");
+}
+function clearToken() {
+  removeItem("visitor_token");
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  AgentUpChatClient,
+  AgentUpChatHub,
+  WebChatAuthError,
+  storage
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/api-client.ts","../src/signalr-client.ts","../src/storage.ts"],"sourcesContent":["export * from './types.js';\r\nexport { AgentUpChatClient, WebChatAuthError } from './api-client.js';\r\nexport { AgentUpChatHub } from './signalr-client.js';\r\nexport type {\r\n  AgentUpChatHubOptions,\r\n  AgentUpChatHubHandlers,\r\n  ChatConnectionState\r\n} from './signalr-client.js';\r\nexport * as storage from './storage.js';\r\n","import type {\r\n  AgentUpChatClientConfig,\r\n  ChatMessage,\r\n  ConversationDetails,\r\n  PublicAgent,\r\n  VisitorConversationSummary\r\n} from './types.js';\r\n\r\n/** Thrown when the visitor token is expired/invalid; UIs should surface a re-auth flow. */\r\nexport class WebChatAuthError extends Error {\r\n  constructor(message: string) {\r\n    super(message);\r\n    this.name = 'WebChatAuthError';\r\n  }\r\n}\r\n\r\n/**\r\n * Minimal REST client for the embedded web chat app endpoints. Wraps fetch with\r\n * the visitor JWT and unwraps the AgentUp `ApiResponse<T>` envelope automatically.\r\n *\r\n * Endpoints used:\r\n * - `GET    /api/webchat/agents`\r\n * - `GET    /api/webchat/conversations`\r\n * - `POST   /api/webchat/conversations`\r\n * - `GET    /api/webchat/conversations/{id}` (includes `messages` history)\r\n * - `POST   /api/webchat/messages/{conversationId}` (send)\r\n * - `POST   /api/webchat/conversations/{id}/close`\r\n */\r\nexport class AgentUpChatClient {\r\n  private readonly baseUrl: string;\r\n  private readonly tenantId?: string;\r\n  private readonly fetchImpl: typeof fetch;\r\n  private visitorToken: string;\r\n\r\n  constructor(config: AgentUpChatClientConfig) {\r\n    if (!config.apiUrl) throw new Error('AgentUpChatClient: apiUrl is required');\r\n    if (!config.visitorToken) throw new Error('AgentUpChatClient: visitorToken is required');\r\n    this.baseUrl = config.apiUrl.replace(/\\/$/, '');\r\n    this.visitorToken = config.visitorToken;\r\n    this.tenantId = config.tenantId;\r\n    this.fetchImpl = config.fetch ?? fetch.bind(globalThis);\r\n  }\r\n\r\n  /** Refresh the visitor token in place (e.g. after a silent re-auth round-trip). */\r\n  setVisitorToken(token: string): void {\r\n    if (!token) throw new Error('AgentUpChatClient.setVisitorToken: empty token');\r\n    this.visitorToken = token;\r\n  }\r\n\r\n  listAgents(signal?: AbortSignal): Promise<PublicAgent[]> {\r\n    return this.get<PublicAgent[]>('/api/webchat/agents', signal);\r\n  }\r\n\r\n  listConversations(signal?: AbortSignal): Promise<VisitorConversationSummary[]> {\r\n    return this.get<VisitorConversationSummary[]>('/api/webchat/conversations', signal);\r\n  }\r\n\r\n  createConversation(agentCode: string): Promise<VisitorConversationSummary> {\r\n    return this.post<VisitorConversationSummary>('/api/webchat/conversations', { agentCode });\r\n  }\r\n\r\n  getConversation(conversationId: string, signal?: AbortSignal): Promise<ConversationDetails> {\r\n    return this.get<ConversationDetails>(`/api/webchat/conversations/${conversationId}`, signal);\r\n  }\r\n\r\n  /**\r\n   * Message history is returned on `GET /api/webchat/conversations/{id}` (there is no GET on\r\n   * `/api/webchat/messages/{id}` — that route is POST-only for sending).\r\n   */\r\n  async getMessages(conversationId: string, signal?: AbortSignal): Promise<ChatMessage[]> {\r\n    const conv = await this.get<ConversationDetails>(`/api/webchat/conversations/${conversationId}`, signal);\r\n    const raw = conv.messages;\r\n    if (!raw?.length) return [];\r\n    return raw.map((m) => ({\r\n      ...m,\r\n      conversationId: m.conversationId || conversationId\r\n    }));\r\n  }\r\n\r\n  /**\r\n   * REST fallback for sending. The API binds `[FromForm] content` (see `WebChatController`),\r\n   * not JSON — multipart/form-data is required.\r\n   */\r\n  sendMessage(conversationId: string, content: string): Promise<ChatMessage> {\r\n    const form = new FormData();\r\n    form.append('content', content);\r\n    return this.postForm<ChatMessage>(`/api/webchat/messages/${conversationId}`, form);\r\n  }\r\n\r\n  closeConversation(conversationId: string): Promise<void> {\r\n    return this.post<void>(`/api/webchat/conversations/${conversationId}/close`, {});\r\n  }\r\n\r\n  // ---------------- internals ----------------\r\n\r\n  private async get<T>(path: string, signal?: AbortSignal): Promise<T> {\r\n    const res = await this.fetchImpl(`${this.baseUrl}${path}`, {\r\n      method: 'GET',\r\n      headers: this.headers(),\r\n      signal\r\n    });\r\n    return this.unwrap<T>(res);\r\n  }\r\n\r\n  private async post<T>(path: string, body: unknown): Promise<T> {\r\n    const res = await this.fetchImpl(`${this.baseUrl}${path}`, {\r\n      method: 'POST',\r\n      headers: { ...this.headers(), 'Content-Type': 'application/json' },\r\n      body: JSON.stringify(body ?? {})\r\n    });\r\n    return this.unwrap<T>(res);\r\n  }\r\n\r\n  /** POST multipart/form-data (do not set Content-Type — boundary is set by the runtime). */\r\n  private async postForm<T>(path: string, formData: FormData): Promise<T> {\r\n    const res = await this.fetchImpl(`${this.baseUrl}${path}`, {\r\n      method: 'POST',\r\n      headers: this.headers(),\r\n      body: formData\r\n    });\r\n    return this.unwrap<T>(res);\r\n  }\r\n\r\n  private headers(): Record<string, string> {\r\n    const h: Record<string, string> = {\r\n      Authorization: `Bearer ${this.visitorToken}`,\r\n      Accept: 'application/json'\r\n    };\r\n    if (this.tenantId) h['X-Tenant-Id'] = this.tenantId;\r\n    return h;\r\n  }\r\n\r\n  private async unwrap<T>(res: Response): Promise<T> {\r\n    if (res.status === 401) {\r\n      throw new WebChatAuthError('Visitor token expired or invalid');\r\n    }\r\n    if (!res.ok) {\r\n      let detail = '';\r\n      try {\r\n        const text = await res.text();\r\n        detail = text.length > 200 ? text.slice(0, 200) + '…' : text;\r\n      } catch {\r\n        // ignore body parse errors\r\n      }\r\n      throw new Error(`AgentUp request ${res.url} failed (${res.status}): ${detail}`);\r\n    }\r\n    if (res.status === 204) return undefined as T;\r\n\r\n    const json = (await res.json()) as unknown;\r\n    // Backend wraps responses as { success, result } except for a few skipped paths.\r\n    if (\r\n      json &&\r\n      typeof json === 'object' &&\r\n      'success' in (json as Record<string, unknown>) &&\r\n      'result' in (json as Record<string, unknown>)\r\n    ) {\r\n      const env = json as { success: boolean; result: T; message?: string };\r\n      if (!env.success) {\r\n        throw new Error(env.message ?? 'AgentUp request failed');\r\n      }\r\n      return env.result;\r\n    }\r\n    return json as T;\r\n  }\r\n}\r\n","import {\r\n  HubConnection,\r\n  HubConnectionBuilder,\r\n  HubConnectionState,\r\n  LogLevel\r\n} from '@microsoft/signalr';\r\n\r\nimport type { ChatMessage, ChatMessageChunk, UserTypingPayload } from './types.js';\r\n\r\n/** Connection lifecycle states surfaced to UI layers. */\r\nexport type ChatConnectionState = 'idle' | 'connecting' | 'connected' | 'disconnected' | 'reconnecting';\r\n\r\nexport interface AgentUpChatHubOptions {\r\n  /** Base URL of the AgentUp API. */\r\n  apiUrl: string;\r\n  /** Provides the latest visitor JWT (called on initial connect AND on reconnect). */\r\n  accessTokenFactory: () => string | Promise<string>;\r\n}\r\n\r\nexport interface AgentUpChatHubHandlers {\r\n  onMessage?: (message: ChatMessage) => void;\r\n  /** AI/agent streaming tokens before the final `ReceiveMessage`. */\r\n  onMessageChunk?: (chunk: ChatMessageChunk) => void;\r\n  /** Hub `UserTyping` — includes AI (`userId` `\"ai\"`) and human agents. */\r\n  onUserTyping?: (payload: UserTypingPayload) => void;\r\n  /** Hub `UserStoppedTyping` — argument is `userId` (e.g. `\"ai\"`). */\r\n  onUserStoppedTyping?: (userId: string) => void;\r\n  onConnectionStateChanged?: (state: ChatConnectionState) => void;\r\n  onError?: (error: unknown) => void;\r\n}\r\n\r\n/**\r\n * Thin SignalR client for the AgentUp ChatHub. Intentionally narrow surface — the\r\n * UI layer owns active-conversation tracking and group join/leave logic.\r\n *\r\n * Server methods used:\r\n * - `JoinConversation(conversationId)` / `LeaveConversation(conversationId)`\r\n * - `SendMessage(conversationId, content)`\r\n * - `Typing(conversationId, isTyping)`\r\n *\r\n * Server callbacks consumed:\r\n * - `ReceiveMessage`, `ReceiveMessageChunk` (streaming), `UserTyping`, `UserStoppedTyping`, `Error`.\r\n */\r\nexport class AgentUpChatHub {\r\n  private readonly options: AgentUpChatHubOptions;\r\n  private readonly handlers: AgentUpChatHubHandlers;\r\n  private connection: HubConnection | null = null;\r\n  private state: ChatConnectionState = 'idle';\r\n\r\n  constructor(options: AgentUpChatHubOptions, handlers: AgentUpChatHubHandlers = {}) {\r\n    this.options = options;\r\n    this.handlers = handlers;\r\n  }\r\n\r\n  get currentState(): ChatConnectionState {\r\n    return this.state;\r\n  }\r\n\r\n  async start(): Promise<void> {\r\n    if (this.connection && this.connection.state === HubConnectionState.Connected) {\r\n      return;\r\n    }\r\n    this.setState('connecting');\r\n\r\n    const base = this.options.apiUrl.replace(/\\/$/, '');\r\n    /** Must match ASP.NET `MapHub<ChatHub>(\"/api/chatHub\")` (same path as legacy widget). */\r\n    const url = `${base}/api/chatHub`;\r\n    this.connection = new HubConnectionBuilder()\r\n      .withUrl(url, {\r\n        accessTokenFactory: () => Promise.resolve(this.options.accessTokenFactory())\r\n      })\r\n      .withAutomaticReconnect()\r\n      .configureLogging(LogLevel.Warning)\r\n      .build();\r\n\r\n    this.connection.on('ReceiveMessage', (msg: ChatMessage) => this.handlers.onMessage?.(msg));\r\n    this.connection.on('ReceiveMessageChunk', (chunk: ChatMessageChunk) =>\r\n      this.handlers.onMessageChunk?.(chunk)\r\n    );\r\n    this.connection.on('UserTyping', (payload: UserTypingPayload) =>\r\n      this.handlers.onUserTyping?.(payload)\r\n    );\r\n    this.connection.on('UserStoppedTyping', (userId: string) =>\r\n      this.handlers.onUserStoppedTyping?.(userId)\r\n    );\r\n    this.connection.on('Error', (msg: string) => this.handlers.onError?.(new Error(msg)));\r\n\r\n    this.connection.onreconnecting(() => this.setState('reconnecting'));\r\n    this.connection.onreconnected(() => this.setState('connected'));\r\n    this.connection.onclose(() => this.setState('disconnected'));\r\n\r\n    await this.connection.start();\r\n    this.setState('connected');\r\n  }\r\n\r\n  async stop(): Promise<void> {\r\n    if (this.connection) {\r\n      await this.connection.stop();\r\n      this.connection = null;\r\n    }\r\n    this.setState('idle');\r\n  }\r\n\r\n  async joinConversation(conversationId: string): Promise<void> {\r\n    await this.ensureConnected();\r\n    await this.connection!.invoke('JoinConversation', conversationId);\r\n  }\r\n\r\n  async leaveConversation(conversationId: string): Promise<void> {\r\n    if (this.connection?.state !== HubConnectionState.Connected) return;\r\n    await this.connection.invoke('LeaveConversation', conversationId);\r\n  }\r\n\r\n  async sendMessage(conversationId: string, content: string): Promise<void> {\r\n    await this.ensureConnected();\r\n    await this.connection!.invoke('SendMessage', conversationId, content);\r\n  }\r\n\r\n  async sendTyping(conversationId: string, isTyping: boolean): Promise<void> {\r\n    if (this.connection?.state !== HubConnectionState.Connected) return;\r\n    await this.connection.invoke('Typing', conversationId, isTyping);\r\n  }\r\n\r\n  private async ensureConnected(): Promise<void> {\r\n    if (!this.connection) {\r\n      await this.start();\r\n      return;\r\n    }\r\n    if (this.connection.state !== HubConnectionState.Connected) {\r\n      await this.connection.start();\r\n      this.setState('connected');\r\n    }\r\n  }\r\n\r\n  private setState(next: ChatConnectionState): void {\r\n    if (this.state === next) return;\r\n    this.state = next;\r\n    this.handlers.onConnectionStateChanged?.(next);\r\n  }\r\n}\r\n","/**\r\n * Local storage helper for the embedded chat app. Keeps ephemeral UI state\r\n * (selected conversation id, sidebar collapsed, etc.) outside React-style\r\n * components so the choice of UI framework stays flexible.\r\n *\r\n * Storage is **not** used for the visitor token by default — tokens are short\r\n * lived and should be re-minted from the host backend on demand. Hosts can\r\n * still call {@link saveToken} if they want browser refresh persistence.\r\n */\r\nconst PREFIX = 'agentup.webchat:';\r\n\r\nexport function getItem(key: string): string | null {\r\n  try {\r\n    return localStorage.getItem(PREFIX + key);\r\n  } catch {\r\n    return null;\r\n  }\r\n}\r\n\r\nexport function setItem(key: string, value: string): void {\r\n  try {\r\n    localStorage.setItem(PREFIX + key, value);\r\n  } catch {\r\n    // Storage may be disabled (private mode); silently degrade.\r\n  }\r\n}\r\n\r\nexport function removeItem(key: string): void {\r\n  try {\r\n    localStorage.removeItem(PREFIX + key);\r\n  } catch {\r\n    // ignore\r\n  }\r\n}\r\n\r\n/** Convenience wrapper for the visitor token (host-controlled persistence). */\r\nexport function saveToken(token: string): void {\r\n  setItem('visitor_token', token);\r\n}\r\n\r\nexport function loadToken(): string | null {\r\n  return getItem('visitor_token');\r\n}\r\n\r\nexport function clearToken(): void {\r\n  removeItem('visitor_token');\r\n}\r\n"],"mappings":"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","names":[]}

package/dist/index.d.cts

@@ -0,0 +1,200 @@
+/**
+ * Shared types for the AgentUp web chat clients (mirrors the .NET DTOs).
+ *
+ * Keep this file in sync with `src/Inksen.AI.AgentUp.Api.Models/DTOs/WebChatDtos.cs`.
+ */
+interface PublicAgent {
+    /** AiAgent.Id (UUID v7). */
+    id: string;
+    /** Stable code referenced by `WebChatSession.Metadata.agentCode`. */
+    code: string;
+    name: string;
+    description?: string | null;
+    avatarUrl?: string | null;
+    welcomeMessage?: string | null;
+    displayOrder: number;
+}
+/** Mirrors `Domain.Entities.ConversationStatus`. */
+type ConversationStatus = 0 | 1 | 2 | 3;
+interface VisitorConversationSummary {
+    id: string;
+    agentCode?: string | null;
+    agentName?: string | null;
+    /** AI-provided short label when available (OpenAI Responses metadata, etc.). */
+    title?: string | null;
+    lastMessageSnippet?: string | null;
+    lastMessageAt?: string | null;
+    status: ConversationStatus;
+    createdAt: string;
+}
+interface VisitorTokenResponse {
+    visitorToken: string;
+    expiresAt: string;
+    visitorId: string;
+}
+/** Mirrors `Domain.Entities.SenderType`. */
+type SenderType = 'Customer' | 'Agent' | 'AI' | 'System';
+interface ChatMessage {
+    id: string;
+    conversationId: string;
+    content: string;
+    senderType: SenderType;
+    senderName?: string | null;
+    createdAt: string;
+    /** Optional: AI tool calls / structured payload (passthrough). */
+    metadata?: Record<string, unknown> | null;
+}
+/** Matches `TypingIndicatorDto` on hub event `UserTyping` (camelCase JSON). */
+interface UserTypingPayload {
+    conversationId: string;
+    userId: string;
+    userName?: string | null;
+    isTyping?: boolean;
+}
+/** Matches ChatHub / WebChatAiResponseService `ReceiveMessageChunk` payload (camelCase JSON). */
+interface ChatMessageChunk {
+    id: string;
+    conversationId: string;
+    delta: string;
+    /** API may send numeric enum (Customer=0, AI=1, Agent=2). */
+    senderType?: SenderType | number;
+    senderName?: string | null;
+    createdAt?: string;
+}
+interface ConversationDetails {
+    id: string;
+    status: ConversationStatus;
+    customerName?: string | null;
+    customerEmail?: string | null;
+    createdAt: string;
+    lastMessageAt?: string | null;
+    isHumanTakeover: boolean;
+    /** Present on `GET /api/webchat/conversations/{id}` (embedded app history). */
+    messages?: ChatMessage[];
+}
+/** Configuration accepted by `AgentUpChatClient`. */
+interface AgentUpChatClientConfig {
+    /** Base URL of the AgentUp API (no trailing slash, e.g. `https://api.example.com`). */
+    apiUrl: string;
+    /** Visitor JWT minted by the host backend via `POST /api/webchat/visitor-tokens`. */
+    visitorToken: string;
+    /** Optional `X-Tenant-Id` header. Required when the API runs without subdomain-based routing. */
+    tenantId?: string;
+    /** Optional fetch implementation (defaults to global `fetch`). */
+    fetch?: typeof fetch;
+}
+
+/** Thrown when the visitor token is expired/invalid; UIs should surface a re-auth flow. */
+declare class WebChatAuthError extends Error {
+    constructor(message: string);
+}
+/**
+ * Minimal REST client for the embedded web chat app endpoints. Wraps fetch with
+ * the visitor JWT and unwraps the AgentUp `ApiResponse<T>` envelope automatically.
+ *
+ * Endpoints used:
+ * - `GET    /api/webchat/agents`
+ * - `GET    /api/webchat/conversations`
+ * - `POST   /api/webchat/conversations`
+ * - `GET    /api/webchat/conversations/{id}` (includes `messages` history)
+ * - `POST   /api/webchat/messages/{conversationId}` (send)
+ * - `POST   /api/webchat/conversations/{id}/close`
+ */
+declare class AgentUpChatClient {
+    private readonly baseUrl;
+    private readonly tenantId?;
+    private readonly fetchImpl;
+    private visitorToken;
+    constructor(config: AgentUpChatClientConfig);
+    /** Refresh the visitor token in place (e.g. after a silent re-auth round-trip). */
+    setVisitorToken(token: string): void;
+    listAgents(signal?: AbortSignal): Promise<PublicAgent[]>;
+    listConversations(signal?: AbortSignal): Promise<VisitorConversationSummary[]>;
+    createConversation(agentCode: string): Promise<VisitorConversationSummary>;
+    getConversation(conversationId: string, signal?: AbortSignal): Promise<ConversationDetails>;
+    /**
+     * Message history is returned on `GET /api/webchat/conversations/{id}` (there is no GET on
+     * `/api/webchat/messages/{id}` — that route is POST-only for sending).
+     */
+    getMessages(conversationId: string, signal?: AbortSignal): Promise<ChatMessage[]>;
+    /**
+     * REST fallback for sending. The API binds `[FromForm] content` (see `WebChatController`),
+     * not JSON — multipart/form-data is required.
+     */
+    sendMessage(conversationId: string, content: string): Promise<ChatMessage>;
+    closeConversation(conversationId: string): Promise<void>;
+    private get;
+    private post;
+    /** POST multipart/form-data (do not set Content-Type — boundary is set by the runtime). */
+    private postForm;
+    private headers;
+    private unwrap;
+}
+
+/** Connection lifecycle states surfaced to UI layers. */
+type ChatConnectionState = 'idle' | 'connecting' | 'connected' | 'disconnected' | 'reconnecting';
+interface AgentUpChatHubOptions {
+    /** Base URL of the AgentUp API. */
+    apiUrl: string;
+    /** Provides the latest visitor JWT (called on initial connect AND on reconnect). */
+    accessTokenFactory: () => string | Promise<string>;
+}
+interface AgentUpChatHubHandlers {
+    onMessage?: (message: ChatMessage) => void;
+    /** AI/agent streaming tokens before the final `ReceiveMessage`. */
+    onMessageChunk?: (chunk: ChatMessageChunk) => void;
+    /** Hub `UserTyping` — includes AI (`userId` `"ai"`) and human agents. */
+    onUserTyping?: (payload: UserTypingPayload) => void;
+    /** Hub `UserStoppedTyping` — argument is `userId` (e.g. `"ai"`). */
+    onUserStoppedTyping?: (userId: string) => void;
+    onConnectionStateChanged?: (state: ChatConnectionState) => void;
+    onError?: (error: unknown) => void;
+}
+/**
+ * Thin SignalR client for the AgentUp ChatHub. Intentionally narrow surface — the
+ * UI layer owns active-conversation tracking and group join/leave logic.
+ *
+ * Server methods used:
+ * - `JoinConversation(conversationId)` / `LeaveConversation(conversationId)`
+ * - `SendMessage(conversationId, content)`
+ * - `Typing(conversationId, isTyping)`
+ *
+ * Server callbacks consumed:
+ * - `ReceiveMessage`, `ReceiveMessageChunk` (streaming), `UserTyping`, `UserStoppedTyping`, `Error`.
+ */
+declare class AgentUpChatHub {
+    private readonly options;
+    private readonly handlers;
+    private connection;
+    private state;
+    constructor(options: AgentUpChatHubOptions, handlers?: AgentUpChatHubHandlers);
+    get currentState(): ChatConnectionState;
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    joinConversation(conversationId: string): Promise<void>;
+    leaveConversation(conversationId: string): Promise<void>;
+    sendMessage(conversationId: string, content: string): Promise<void>;
+    sendTyping(conversationId: string, isTyping: boolean): Promise<void>;
+    private ensureConnected;
+    private setState;
+}
+
+declare function getItem(key: string): string | null;
+declare function setItem(key: string, value: string): void;
+declare function removeItem(key: string): void;
+/** Convenience wrapper for the visitor token (host-controlled persistence). */
+declare function saveToken(token: string): void;
+declare function loadToken(): string | null;
+declare function clearToken(): void;
+
+declare const storage_clearToken: typeof clearToken;
+declare const storage_getItem: typeof getItem;
+declare const storage_loadToken: typeof loadToken;
+declare const storage_removeItem: typeof removeItem;
+declare const storage_saveToken: typeof saveToken;
+declare const storage_setItem: typeof setItem;
+declare namespace storage {
+  export { storage_clearToken as clearToken, storage_getItem as getItem, storage_loadToken as loadToken, storage_removeItem as removeItem, storage_saveToken as saveToken, storage_setItem as setItem };
+}
+
+export { AgentUpChatClient, type AgentUpChatClientConfig, AgentUpChatHub, type AgentUpChatHubHandlers, type AgentUpChatHubOptions, type ChatConnectionState, type ChatMessage, type ChatMessageChunk, type ConversationDetails, type ConversationStatus, type PublicAgent, type SenderType, type UserTypingPayload, type VisitorConversationSummary, type VisitorTokenResponse, WebChatAuthError, storage };

package/dist/index.d.ts

@@ -0,0 +1,200 @@
+/**
+ * Shared types for the AgentUp web chat clients (mirrors the .NET DTOs).
+ *
+ * Keep this file in sync with `src/Inksen.AI.AgentUp.Api.Models/DTOs/WebChatDtos.cs`.
+ */
+interface PublicAgent {
+    /** AiAgent.Id (UUID v7). */
+    id: string;
+    /** Stable code referenced by `WebChatSession.Metadata.agentCode`. */
+    code: string;
+    name: string;
+    description?: string | null;
+    avatarUrl?: string | null;
+    welcomeMessage?: string | null;
+    displayOrder: number;
+}
+/** Mirrors `Domain.Entities.ConversationStatus`. */
+type ConversationStatus = 0 | 1 | 2 | 3;
+interface VisitorConversationSummary {
+    id: string;
+    agentCode?: string | null;
+    agentName?: string | null;
+    /** AI-provided short label when available (OpenAI Responses metadata, etc.). */
+    title?: string | null;
+    lastMessageSnippet?: string | null;
+    lastMessageAt?: string | null;
+    status: ConversationStatus;
+    createdAt: string;
+}
+interface VisitorTokenResponse {
+    visitorToken: string;
+    expiresAt: string;
+    visitorId: string;
+}
+/** Mirrors `Domain.Entities.SenderType`. */
+type SenderType = 'Customer' | 'Agent' | 'AI' | 'System';
+interface ChatMessage {
+    id: string;
+    conversationId: string;
+    content: string;
+    senderType: SenderType;
+    senderName?: string | null;
+    createdAt: string;
+    /** Optional: AI tool calls / structured payload (passthrough). */
+    metadata?: Record<string, unknown> | null;
+}
+/** Matches `TypingIndicatorDto` on hub event `UserTyping` (camelCase JSON). */
+interface UserTypingPayload {
+    conversationId: string;
+    userId: string;
+    userName?: string | null;
+    isTyping?: boolean;
+}
+/** Matches ChatHub / WebChatAiResponseService `ReceiveMessageChunk` payload (camelCase JSON). */
+interface ChatMessageChunk {
+    id: string;
+    conversationId: string;
+    delta: string;
+    /** API may send numeric enum (Customer=0, AI=1, Agent=2). */
+    senderType?: SenderType | number;
+    senderName?: string | null;
+    createdAt?: string;
+}
+interface ConversationDetails {
+    id: string;
+    status: ConversationStatus;
+    customerName?: string | null;
+    customerEmail?: string | null;
+    createdAt: string;
+    lastMessageAt?: string | null;
+    isHumanTakeover: boolean;
+    /** Present on `GET /api/webchat/conversations/{id}` (embedded app history). */
+    messages?: ChatMessage[];
+}
+/** Configuration accepted by `AgentUpChatClient`. */
+interface AgentUpChatClientConfig {
+    /** Base URL of the AgentUp API (no trailing slash, e.g. `https://api.example.com`). */
+    apiUrl: string;
+    /** Visitor JWT minted by the host backend via `POST /api/webchat/visitor-tokens`. */
+    visitorToken: string;
+    /** Optional `X-Tenant-Id` header. Required when the API runs without subdomain-based routing. */
+    tenantId?: string;
+    /** Optional fetch implementation (defaults to global `fetch`). */
+    fetch?: typeof fetch;
+}
+
+/** Thrown when the visitor token is expired/invalid; UIs should surface a re-auth flow. */
+declare class WebChatAuthError extends Error {
+    constructor(message: string);
+}
+/**
+ * Minimal REST client for the embedded web chat app endpoints. Wraps fetch with
+ * the visitor JWT and unwraps the AgentUp `ApiResponse<T>` envelope automatically.
+ *
+ * Endpoints used:
+ * - `GET    /api/webchat/agents`
+ * - `GET    /api/webchat/conversations`
+ * - `POST   /api/webchat/conversations`
+ * - `GET    /api/webchat/conversations/{id}` (includes `messages` history)
+ * - `POST   /api/webchat/messages/{conversationId}` (send)
+ * - `POST   /api/webchat/conversations/{id}/close`
+ */
+declare class AgentUpChatClient {
+    private readonly baseUrl;
+    private readonly tenantId?;
+    private readonly fetchImpl;
+    private visitorToken;
+    constructor(config: AgentUpChatClientConfig);
+    /** Refresh the visitor token in place (e.g. after a silent re-auth round-trip). */
+    setVisitorToken(token: string): void;
+    listAgents(signal?: AbortSignal): Promise<PublicAgent[]>;
+    listConversations(signal?: AbortSignal): Promise<VisitorConversationSummary[]>;
+    createConversation(agentCode: string): Promise<VisitorConversationSummary>;
+    getConversation(conversationId: string, signal?: AbortSignal): Promise<ConversationDetails>;
+    /**
+     * Message history is returned on `GET /api/webchat/conversations/{id}` (there is no GET on
+     * `/api/webchat/messages/{id}` — that route is POST-only for sending).
+     */
+    getMessages(conversationId: string, signal?: AbortSignal): Promise<ChatMessage[]>;
+    /**
+     * REST fallback for sending. The API binds `[FromForm] content` (see `WebChatController`),
+     * not JSON — multipart/form-data is required.
+     */
+    sendMessage(conversationId: string, content: string): Promise<ChatMessage>;
+    closeConversation(conversationId: string): Promise<void>;
+    private get;
+    private post;
+    /** POST multipart/form-data (do not set Content-Type — boundary is set by the runtime). */
+    private postForm;
+    private headers;
+    private unwrap;
+}
+
+/** Connection lifecycle states surfaced to UI layers. */
+type ChatConnectionState = 'idle' | 'connecting' | 'connected' | 'disconnected' | 'reconnecting';
+interface AgentUpChatHubOptions {
+    /** Base URL of the AgentUp API. */
+    apiUrl: string;
+    /** Provides the latest visitor JWT (called on initial connect AND on reconnect). */
+    accessTokenFactory: () => string | Promise<string>;
+}
+interface AgentUpChatHubHandlers {
+    onMessage?: (message: ChatMessage) => void;
+    /** AI/agent streaming tokens before the final `ReceiveMessage`. */
+    onMessageChunk?: (chunk: ChatMessageChunk) => void;
+    /** Hub `UserTyping` — includes AI (`userId` `"ai"`) and human agents. */
+    onUserTyping?: (payload: UserTypingPayload) => void;
+    /** Hub `UserStoppedTyping` — argument is `userId` (e.g. `"ai"`). */
+    onUserStoppedTyping?: (userId: string) => void;
+    onConnectionStateChanged?: (state: ChatConnectionState) => void;
+    onError?: (error: unknown) => void;
+}
+/**
+ * Thin SignalR client for the AgentUp ChatHub. Intentionally narrow surface — the
+ * UI layer owns active-conversation tracking and group join/leave logic.
+ *
+ * Server methods used:
+ * - `JoinConversation(conversationId)` / `LeaveConversation(conversationId)`
+ * - `SendMessage(conversationId, content)`
+ * - `Typing(conversationId, isTyping)`
+ *
+ * Server callbacks consumed:
+ * - `ReceiveMessage`, `ReceiveMessageChunk` (streaming), `UserTyping`, `UserStoppedTyping`, `Error`.
+ */
+declare class AgentUpChatHub {
+    private readonly options;
+    private readonly handlers;
+    private connection;
+    private state;
+    constructor(options: AgentUpChatHubOptions, handlers?: AgentUpChatHubHandlers);
+    get currentState(): ChatConnectionState;
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    joinConversation(conversationId: string): Promise<void>;
+    leaveConversation(conversationId: string): Promise<void>;
+    sendMessage(conversationId: string, content: string): Promise<void>;
+    sendTyping(conversationId: string, isTyping: boolean): Promise<void>;
+    private ensureConnected;
+    private setState;
+}
+
+declare function getItem(key: string): string | null;
+declare function setItem(key: string, value: string): void;
+declare function removeItem(key: string): void;
+/** Convenience wrapper for the visitor token (host-controlled persistence). */
+declare function saveToken(token: string): void;
+declare function loadToken(): string | null;
+declare function clearToken(): void;
+
+declare const storage_clearToken: typeof clearToken;
+declare const storage_getItem: typeof getItem;
+declare const storage_loadToken: typeof loadToken;
+declare const storage_removeItem: typeof removeItem;
+declare const storage_saveToken: typeof saveToken;
+declare const storage_setItem: typeof setItem;
+declare namespace storage {
+  export { storage_clearToken as clearToken, storage_getItem as getItem, storage_loadToken as loadToken, storage_removeItem as removeItem, storage_saveToken as saveToken, storage_setItem as setItem };
+}
+
+export { AgentUpChatClient, type AgentUpChatClientConfig, AgentUpChatHub, type AgentUpChatHubHandlers, type AgentUpChatHubOptions, type ChatConnectionState, type ChatMessage, type ChatMessageChunk, type ConversationDetails, type ConversationStatus, type PublicAgent, type SenderType, type UserTypingPayload, type VisitorConversationSummary, type VisitorTokenResponse, WebChatAuthError, storage };

package/dist/index.js

@@ -0,0 +1,264 @@
+var __defProp = Object.defineProperty;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
+
+// src/api-client.ts
+var WebChatAuthError = class extends Error {
+  constructor(message) {
+    super(message);
+    this.name = "WebChatAuthError";
+  }
+};
+var AgentUpChatClient = class {
+  constructor(config) {
+    __publicField(this, "baseUrl");
+    __publicField(this, "tenantId");
+    __publicField(this, "fetchImpl");
+    __publicField(this, "visitorToken");
+    if (!config.apiUrl) throw new Error("AgentUpChatClient: apiUrl is required");
+    if (!config.visitorToken) throw new Error("AgentUpChatClient: visitorToken is required");
+    this.baseUrl = config.apiUrl.replace(/\/$/, "");
+    this.visitorToken = config.visitorToken;
+    this.tenantId = config.tenantId;
+    this.fetchImpl = config.fetch ?? fetch.bind(globalThis);
+  }
+  /** Refresh the visitor token in place (e.g. after a silent re-auth round-trip). */
+  setVisitorToken(token) {
+    if (!token) throw new Error("AgentUpChatClient.setVisitorToken: empty token");
+    this.visitorToken = token;
+  }
+  listAgents(signal) {
+    return this.get("/api/webchat/agents", signal);
+  }
+  listConversations(signal) {
+    return this.get("/api/webchat/conversations", signal);
+  }
+  createConversation(agentCode) {
+    return this.post("/api/webchat/conversations", { agentCode });
+  }
+  getConversation(conversationId, signal) {
+    return this.get(`/api/webchat/conversations/${conversationId}`, signal);
+  }
+  /**
+   * Message history is returned on `GET /api/webchat/conversations/{id}` (there is no GET on
+   * `/api/webchat/messages/{id}` — that route is POST-only for sending).
+   */
+  async getMessages(conversationId, signal) {
+    const conv = await this.get(`/api/webchat/conversations/${conversationId}`, signal);
+    const raw = conv.messages;
+    if (!raw?.length) return [];
+    return raw.map((m) => ({
+      ...m,
+      conversationId: m.conversationId || conversationId
+    }));
+  }
+  /**
+   * REST fallback for sending. The API binds `[FromForm] content` (see `WebChatController`),
+   * not JSON — multipart/form-data is required.
+   */
+  sendMessage(conversationId, content) {
+    const form = new FormData();
+    form.append("content", content);
+    return this.postForm(`/api/webchat/messages/${conversationId}`, form);
+  }
+  closeConversation(conversationId) {
+    return this.post(`/api/webchat/conversations/${conversationId}/close`, {});
+  }
+  // ---------------- internals ----------------
+  async get(path, signal) {
+    const res = await this.fetchImpl(`${this.baseUrl}${path}`, {
+      method: "GET",
+      headers: this.headers(),
+      signal
+    });
+    return this.unwrap(res);
+  }
+  async post(path, body) {
+    const res = await this.fetchImpl(`${this.baseUrl}${path}`, {
+      method: "POST",
+      headers: { ...this.headers(), "Content-Type": "application/json" },
+      body: JSON.stringify(body ?? {})
+    });
+    return this.unwrap(res);
+  }
+  /** POST multipart/form-data (do not set Content-Type — boundary is set by the runtime). */
+  async postForm(path, formData) {
+    const res = await this.fetchImpl(`${this.baseUrl}${path}`, {
+      method: "POST",
+      headers: this.headers(),
+      body: formData
+    });
+    return this.unwrap(res);
+  }
+  headers() {
+    const h = {
+      Authorization: `Bearer ${this.visitorToken}`,
+      Accept: "application/json"
+    };
+    if (this.tenantId) h["X-Tenant-Id"] = this.tenantId;
+    return h;
+  }
+  async unwrap(res) {
+    if (res.status === 401) {
+      throw new WebChatAuthError("Visitor token expired or invalid");
+    }
+    if (!res.ok) {
+      let detail = "";
+      try {
+        const text = await res.text();
+        detail = text.length > 200 ? text.slice(0, 200) + "\u2026" : text;
+      } catch {
+      }
+      throw new Error(`AgentUp request ${res.url} failed (${res.status}): ${detail}`);
+    }
+    if (res.status === 204) return void 0;
+    const json = await res.json();
+    if (json && typeof json === "object" && "success" in json && "result" in json) {
+      const env = json;
+      if (!env.success) {
+        throw new Error(env.message ?? "AgentUp request failed");
+      }
+      return env.result;
+    }
+    return json;
+  }
+};
+
+// src/signalr-client.ts
+import {
+  HubConnectionBuilder,
+  HubConnectionState,
+  LogLevel
+} from "@microsoft/signalr";
+var AgentUpChatHub = class {
+  constructor(options, handlers = {}) {
+    __publicField(this, "options");
+    __publicField(this, "handlers");
+    __publicField(this, "connection", null);
+    __publicField(this, "state", "idle");
+    this.options = options;
+    this.handlers = handlers;
+  }
+  get currentState() {
+    return this.state;
+  }
+  async start() {
+    if (this.connection && this.connection.state === HubConnectionState.Connected) {
+      return;
+    }
+    this.setState("connecting");
+    const base = this.options.apiUrl.replace(/\/$/, "");
+    const url = `${base}/api/chatHub`;
+    this.connection = new HubConnectionBuilder().withUrl(url, {
+      accessTokenFactory: () => Promise.resolve(this.options.accessTokenFactory())
+    }).withAutomaticReconnect().configureLogging(LogLevel.Warning).build();
+    this.connection.on("ReceiveMessage", (msg) => this.handlers.onMessage?.(msg));
+    this.connection.on(
+      "ReceiveMessageChunk",
+      (chunk) => this.handlers.onMessageChunk?.(chunk)
+    );
+    this.connection.on(
+      "UserTyping",
+      (payload) => this.handlers.onUserTyping?.(payload)
+    );
+    this.connection.on(
+      "UserStoppedTyping",
+      (userId) => this.handlers.onUserStoppedTyping?.(userId)
+    );
+    this.connection.on("Error", (msg) => this.handlers.onError?.(new Error(msg)));
+    this.connection.onreconnecting(() => this.setState("reconnecting"));
+    this.connection.onreconnected(() => this.setState("connected"));
+    this.connection.onclose(() => this.setState("disconnected"));
+    await this.connection.start();
+    this.setState("connected");
+  }
+  async stop() {
+    if (this.connection) {
+      await this.connection.stop();
+      this.connection = null;
+    }
+    this.setState("idle");
+  }
+  async joinConversation(conversationId) {
+    await this.ensureConnected();
+    await this.connection.invoke("JoinConversation", conversationId);
+  }
+  async leaveConversation(conversationId) {
+    if (this.connection?.state !== HubConnectionState.Connected) return;
+    await this.connection.invoke("LeaveConversation", conversationId);
+  }
+  async sendMessage(conversationId, content) {
+    await this.ensureConnected();
+    await this.connection.invoke("SendMessage", conversationId, content);
+  }
+  async sendTyping(conversationId, isTyping) {
+    if (this.connection?.state !== HubConnectionState.Connected) return;
+    await this.connection.invoke("Typing", conversationId, isTyping);
+  }
+  async ensureConnected() {
+    if (!this.connection) {
+      await this.start();
+      return;
+    }
+    if (this.connection.state !== HubConnectionState.Connected) {
+      await this.connection.start();
+      this.setState("connected");
+    }
+  }
+  setState(next) {
+    if (this.state === next) return;
+    this.state = next;
+    this.handlers.onConnectionStateChanged?.(next);
+  }
+};
+
+// src/storage.ts
+var storage_exports = {};
+__export(storage_exports, {
+  clearToken: () => clearToken,
+  getItem: () => getItem,
+  loadToken: () => loadToken,
+  removeItem: () => removeItem,
+  saveToken: () => saveToken,
+  setItem: () => setItem
+});
+var PREFIX = "agentup.webchat:";
+function getItem(key) {
+  try {
+    return localStorage.getItem(PREFIX + key);
+  } catch {
+    return null;
+  }
+}
+function setItem(key, value) {
+  try {
+    localStorage.setItem(PREFIX + key, value);
+  } catch {
+  }
+}
+function removeItem(key) {
+  try {
+    localStorage.removeItem(PREFIX + key);
+  } catch {
+  }
+}
+function saveToken(token) {
+  setItem("visitor_token", token);
+}
+function loadToken() {
+  return getItem("visitor_token");
+}
+function clearToken() {
+  removeItem("visitor_token");
+}
+export {
+  AgentUpChatClient,
+  AgentUpChatHub,
+  WebChatAuthError,
+  storage_exports as storage
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/api-client.ts","../src/signalr-client.ts","../src/storage.ts"],"sourcesContent":["import type {\r\n  AgentUpChatClientConfig,\r\n  ChatMessage,\r\n  ConversationDetails,\r\n  PublicAgent,\r\n  VisitorConversationSummary\r\n} from './types.js';\r\n\r\n/** Thrown when the visitor token is expired/invalid; UIs should surface a re-auth flow. */\r\nexport class WebChatAuthError extends Error {\r\n  constructor(message: string) {\r\n    super(message);\r\n    this.name = 'WebChatAuthError';\r\n  }\r\n}\r\n\r\n/**\r\n * Minimal REST client for the embedded web chat app endpoints. Wraps fetch with\r\n * the visitor JWT and unwraps the AgentUp `ApiResponse<T>` envelope automatically.\r\n *\r\n * Endpoints used:\r\n * - `GET    /api/webchat/agents`\r\n * - `GET    /api/webchat/conversations`\r\n * - `POST   /api/webchat/conversations`\r\n * - `GET    /api/webchat/conversations/{id}` (includes `messages` history)\r\n * - `POST   /api/webchat/messages/{conversationId}` (send)\r\n * - `POST   /api/webchat/conversations/{id}/close`\r\n */\r\nexport class AgentUpChatClient {\r\n  private readonly baseUrl: string;\r\n  private readonly tenantId?: string;\r\n  private readonly fetchImpl: typeof fetch;\r\n  private visitorToken: string;\r\n\r\n  constructor(config: AgentUpChatClientConfig) {\r\n    if (!config.apiUrl) throw new Error('AgentUpChatClient: apiUrl is required');\r\n    if (!config.visitorToken) throw new Error('AgentUpChatClient: visitorToken is required');\r\n    this.baseUrl = config.apiUrl.replace(/\\/$/, '');\r\n    this.visitorToken = config.visitorToken;\r\n    this.tenantId = config.tenantId;\r\n    this.fetchImpl = config.fetch ?? fetch.bind(globalThis);\r\n  }\r\n\r\n  /** Refresh the visitor token in place (e.g. after a silent re-auth round-trip). */\r\n  setVisitorToken(token: string): void {\r\n    if (!token) throw new Error('AgentUpChatClient.setVisitorToken: empty token');\r\n    this.visitorToken = token;\r\n  }\r\n\r\n  listAgents(signal?: AbortSignal): Promise<PublicAgent[]> {\r\n    return this.get<PublicAgent[]>('/api/webchat/agents', signal);\r\n  }\r\n\r\n  listConversations(signal?: AbortSignal): Promise<VisitorConversationSummary[]> {\r\n    return this.get<VisitorConversationSummary[]>('/api/webchat/conversations', signal);\r\n  }\r\n\r\n  createConversation(agentCode: string): Promise<VisitorConversationSummary> {\r\n    return this.post<VisitorConversationSummary>('/api/webchat/conversations', { agentCode });\r\n  }\r\n\r\n  getConversation(conversationId: string, signal?: AbortSignal): Promise<ConversationDetails> {\r\n    return this.get<ConversationDetails>(`/api/webchat/conversations/${conversationId}`, signal);\r\n  }\r\n\r\n  /**\r\n   * Message history is returned on `GET /api/webchat/conversations/{id}` (there is no GET on\r\n   * `/api/webchat/messages/{id}` — that route is POST-only for sending).\r\n   */\r\n  async getMessages(conversationId: string, signal?: AbortSignal): Promise<ChatMessage[]> {\r\n    const conv = await this.get<ConversationDetails>(`/api/webchat/conversations/${conversationId}`, signal);\r\n    const raw = conv.messages;\r\n    if (!raw?.length) return [];\r\n    return raw.map((m) => ({\r\n      ...m,\r\n      conversationId: m.conversationId || conversationId\r\n    }));\r\n  }\r\n\r\n  /**\r\n   * REST fallback for sending. The API binds `[FromForm] content` (see `WebChatController`),\r\n   * not JSON — multipart/form-data is required.\r\n   */\r\n  sendMessage(conversationId: string, content: string): Promise<ChatMessage> {\r\n    const form = new FormData();\r\n    form.append('content', content);\r\n    return this.postForm<ChatMessage>(`/api/webchat/messages/${conversationId}`, form);\r\n  }\r\n\r\n  closeConversation(conversationId: string): Promise<void> {\r\n    return this.post<void>(`/api/webchat/conversations/${conversationId}/close`, {});\r\n  }\r\n\r\n  // ---------------- internals ----------------\r\n\r\n  private async get<T>(path: string, signal?: AbortSignal): Promise<T> {\r\n    const res = await this.fetchImpl(`${this.baseUrl}${path}`, {\r\n      method: 'GET',\r\n      headers: this.headers(),\r\n      signal\r\n    });\r\n    return this.unwrap<T>(res);\r\n  }\r\n\r\n  private async post<T>(path: string, body: unknown): Promise<T> {\r\n    const res = await this.fetchImpl(`${this.baseUrl}${path}`, {\r\n      method: 'POST',\r\n      headers: { ...this.headers(), 'Content-Type': 'application/json' },\r\n      body: JSON.stringify(body ?? {})\r\n    });\r\n    return this.unwrap<T>(res);\r\n  }\r\n\r\n  /** POST multipart/form-data (do not set Content-Type — boundary is set by the runtime). */\r\n  private async postForm<T>(path: string, formData: FormData): Promise<T> {\r\n    const res = await this.fetchImpl(`${this.baseUrl}${path}`, {\r\n      method: 'POST',\r\n      headers: this.headers(),\r\n      body: formData\r\n    });\r\n    return this.unwrap<T>(res);\r\n  }\r\n\r\n  private headers(): Record<string, string> {\r\n    const h: Record<string, string> = {\r\n      Authorization: `Bearer ${this.visitorToken}`,\r\n      Accept: 'application/json'\r\n    };\r\n    if (this.tenantId) h['X-Tenant-Id'] = this.tenantId;\r\n    return h;\r\n  }\r\n\r\n  private async unwrap<T>(res: Response): Promise<T> {\r\n    if (res.status === 401) {\r\n      throw new WebChatAuthError('Visitor token expired or invalid');\r\n    }\r\n    if (!res.ok) {\r\n      let detail = '';\r\n      try {\r\n        const text = await res.text();\r\n        detail = text.length > 200 ? text.slice(0, 200) + '…' : text;\r\n      } catch {\r\n        // ignore body parse errors\r\n      }\r\n      throw new Error(`AgentUp request ${res.url} failed (${res.status}): ${detail}`);\r\n    }\r\n    if (res.status === 204) return undefined as T;\r\n\r\n    const json = (await res.json()) as unknown;\r\n    // Backend wraps responses as { success, result } except for a few skipped paths.\r\n    if (\r\n      json &&\r\n      typeof json === 'object' &&\r\n      'success' in (json as Record<string, unknown>) &&\r\n      'result' in (json as Record<string, unknown>)\r\n    ) {\r\n      const env = json as { success: boolean; result: T; message?: string };\r\n      if (!env.success) {\r\n        throw new Error(env.message ?? 'AgentUp request failed');\r\n      }\r\n      return env.result;\r\n    }\r\n    return json as T;\r\n  }\r\n}\r\n","import {\r\n  HubConnection,\r\n  HubConnectionBuilder,\r\n  HubConnectionState,\r\n  LogLevel\r\n} from '@microsoft/signalr';\r\n\r\nimport type { ChatMessage, ChatMessageChunk, UserTypingPayload } from './types.js';\r\n\r\n/** Connection lifecycle states surfaced to UI layers. */\r\nexport type ChatConnectionState = 'idle' | 'connecting' | 'connected' | 'disconnected' | 'reconnecting';\r\n\r\nexport interface AgentUpChatHubOptions {\r\n  /** Base URL of the AgentUp API. */\r\n  apiUrl: string;\r\n  /** Provides the latest visitor JWT (called on initial connect AND on reconnect). */\r\n  accessTokenFactory: () => string | Promise<string>;\r\n}\r\n\r\nexport interface AgentUpChatHubHandlers {\r\n  onMessage?: (message: ChatMessage) => void;\r\n  /** AI/agent streaming tokens before the final `ReceiveMessage`. */\r\n  onMessageChunk?: (chunk: ChatMessageChunk) => void;\r\n  /** Hub `UserTyping` — includes AI (`userId` `\"ai\"`) and human agents. */\r\n  onUserTyping?: (payload: UserTypingPayload) => void;\r\n  /** Hub `UserStoppedTyping` — argument is `userId` (e.g. `\"ai\"`). */\r\n  onUserStoppedTyping?: (userId: string) => void;\r\n  onConnectionStateChanged?: (state: ChatConnectionState) => void;\r\n  onError?: (error: unknown) => void;\r\n}\r\n\r\n/**\r\n * Thin SignalR client for the AgentUp ChatHub. Intentionally narrow surface — the\r\n * UI layer owns active-conversation tracking and group join/leave logic.\r\n *\r\n * Server methods used:\r\n * - `JoinConversation(conversationId)` / `LeaveConversation(conversationId)`\r\n * - `SendMessage(conversationId, content)`\r\n * - `Typing(conversationId, isTyping)`\r\n *\r\n * Server callbacks consumed:\r\n * - `ReceiveMessage`, `ReceiveMessageChunk` (streaming), `UserTyping`, `UserStoppedTyping`, `Error`.\r\n */\r\nexport class AgentUpChatHub {\r\n  private readonly options: AgentUpChatHubOptions;\r\n  private readonly handlers: AgentUpChatHubHandlers;\r\n  private connection: HubConnection | null = null;\r\n  private state: ChatConnectionState = 'idle';\r\n\r\n  constructor(options: AgentUpChatHubOptions, handlers: AgentUpChatHubHandlers = {}) {\r\n    this.options = options;\r\n    this.handlers = handlers;\r\n  }\r\n\r\n  get currentState(): ChatConnectionState {\r\n    return this.state;\r\n  }\r\n\r\n  async start(): Promise<void> {\r\n    if (this.connection && this.connection.state === HubConnectionState.Connected) {\r\n      return;\r\n    }\r\n    this.setState('connecting');\r\n\r\n    const base = this.options.apiUrl.replace(/\\/$/, '');\r\n    /** Must match ASP.NET `MapHub<ChatHub>(\"/api/chatHub\")` (same path as legacy widget). */\r\n    const url = `${base}/api/chatHub`;\r\n    this.connection = new HubConnectionBuilder()\r\n      .withUrl(url, {\r\n        accessTokenFactory: () => Promise.resolve(this.options.accessTokenFactory())\r\n      })\r\n      .withAutomaticReconnect()\r\n      .configureLogging(LogLevel.Warning)\r\n      .build();\r\n\r\n    this.connection.on('ReceiveMessage', (msg: ChatMessage) => this.handlers.onMessage?.(msg));\r\n    this.connection.on('ReceiveMessageChunk', (chunk: ChatMessageChunk) =>\r\n      this.handlers.onMessageChunk?.(chunk)\r\n    );\r\n    this.connection.on('UserTyping', (payload: UserTypingPayload) =>\r\n      this.handlers.onUserTyping?.(payload)\r\n    );\r\n    this.connection.on('UserStoppedTyping', (userId: string) =>\r\n      this.handlers.onUserStoppedTyping?.(userId)\r\n    );\r\n    this.connection.on('Error', (msg: string) => this.handlers.onError?.(new Error(msg)));\r\n\r\n    this.connection.onreconnecting(() => this.setState('reconnecting'));\r\n    this.connection.onreconnected(() => this.setState('connected'));\r\n    this.connection.onclose(() => this.setState('disconnected'));\r\n\r\n    await this.connection.start();\r\n    this.setState('connected');\r\n  }\r\n\r\n  async stop(): Promise<void> {\r\n    if (this.connection) {\r\n      await this.connection.stop();\r\n      this.connection = null;\r\n    }\r\n    this.setState('idle');\r\n  }\r\n\r\n  async joinConversation(conversationId: string): Promise<void> {\r\n    await this.ensureConnected();\r\n    await this.connection!.invoke('JoinConversation', conversationId);\r\n  }\r\n\r\n  async leaveConversation(conversationId: string): Promise<void> {\r\n    if (this.connection?.state !== HubConnectionState.Connected) return;\r\n    await this.connection.invoke('LeaveConversation', conversationId);\r\n  }\r\n\r\n  async sendMessage(conversationId: string, content: string): Promise<void> {\r\n    await this.ensureConnected();\r\n    await this.connection!.invoke('SendMessage', conversationId, content);\r\n  }\r\n\r\n  async sendTyping(conversationId: string, isTyping: boolean): Promise<void> {\r\n    if (this.connection?.state !== HubConnectionState.Connected) return;\r\n    await this.connection.invoke('Typing', conversationId, isTyping);\r\n  }\r\n\r\n  private async ensureConnected(): Promise<void> {\r\n    if (!this.connection) {\r\n      await this.start();\r\n      return;\r\n    }\r\n    if (this.connection.state !== HubConnectionState.Connected) {\r\n      await this.connection.start();\r\n      this.setState('connected');\r\n    }\r\n  }\r\n\r\n  private setState(next: ChatConnectionState): void {\r\n    if (this.state === next) return;\r\n    this.state = next;\r\n    this.handlers.onConnectionStateChanged?.(next);\r\n  }\r\n}\r\n","/**\r\n * Local storage helper for the embedded chat app. Keeps ephemeral UI state\r\n * (selected conversation id, sidebar collapsed, etc.) outside React-style\r\n * components so the choice of UI framework stays flexible.\r\n *\r\n * Storage is **not** used for the visitor token by default — tokens are short\r\n * lived and should be re-minted from the host backend on demand. Hosts can\r\n * still call {@link saveToken} if they want browser refresh persistence.\r\n */\r\nconst PREFIX = 'agentup.webchat:';\r\n\r\nexport function getItem(key: string): string | null {\r\n  try {\r\n    return localStorage.getItem(PREFIX + key);\r\n  } catch {\r\n    return null;\r\n  }\r\n}\r\n\r\nexport function setItem(key: string, value: string): void {\r\n  try {\r\n    localStorage.setItem(PREFIX + key, value);\r\n  } catch {\r\n    // Storage may be disabled (private mode); silently degrade.\r\n  }\r\n}\r\n\r\nexport function removeItem(key: string): void {\r\n  try {\r\n    localStorage.removeItem(PREFIX + key);\r\n  } catch {\r\n    // ignore\r\n  }\r\n}\r\n\r\n/** Convenience wrapper for the visitor token (host-controlled persistence). */\r\nexport function saveToken(token: string): void {\r\n  setItem('visitor_token', token);\r\n}\r\n\r\nexport function loadToken(): string | null {\r\n  return getItem('visitor_token');\r\n}\r\n\r\nexport function clearToken(): void {\r\n  removeItem('visitor_token');\r\n}\r\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@agentup-inksen/web-chat-core",
+  "version": "0.0.1",
+  "description": "Shared SDK for AgentUp web chat clients (REST + SignalR + types)",
+  "license": "PROPRIETARY",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsup src/index.ts --format esm,cjs --dts --clean --sourcemap",
+    "dev": "tsup src/index.ts --format esm,cjs --dts --watch --sourcemap",
+    "clean": "rimraf dist",
+    "lint": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@microsoft/signalr": "^8.0.0"
+  },
+  "devDependencies": {
+    "rimraf": "^5.0.5",
+    "tsup": "^8.0.0",
+    "typescript": "^5.3.0"
+  },
+  "publishConfig": {
+    "access": "restricted"
+  }
+}