blueeyebot-widget 0.1.0

package/dist/react.d.ts

@@ -0,0 +1,7 @@
+import { ChatWidgetOptions } from './types';
+import * as React from "react";
+export declare function BlueEyeBot(props: ChatWidgetOptions): React.ReactElement;
+/** @deprecated Use `BlueEyeBot`. */
+export declare const ChatWidget: typeof BlueEyeBot;
+export default BlueEyeBot;
+export type { ChatWidgetOptions, ChatWidgetConfig } from './types';

package/dist/react.js

@@ -0,0 +1,24 @@
+import * as o from "react";
+import { d as i, A as s, T as a } from "./web-component-DZRPaCAI.js";
+i();
+const u = Object.fromEntries(
+  Object.entries(s).map(([n, e]) => [e.key, n])
+);
+function l(n) {
+  const e = o.useRef(null);
+  o.useEffect(() => {
+    e.current && (e.current.config = n);
+  });
+  const r = {};
+  for (const [f, t] of Object.entries(n)) {
+    const c = u[f];
+    !c || t == null || typeof t == "object" || typeof t == "function" || (r[c] = String(t));
+  }
+  return o.createElement(a, { ref: e, ...r });
+}
+const m = l;
+export {
+  l as BlueEyeBot,
+  m as ChatWidget,
+  l as default
+};

package/dist/storage.d.ts

@@ -0,0 +1,5 @@
+export declare const storage: {
+    get(key: string): string | null;
+    set(key: string, value: string): void;
+    remove(key: string): void;
+};

package/dist/toast.d.ts

@@ -0,0 +1,17 @@
+export interface ToastItem {
+    id: number;
+    message: string;
+    type: "info" | "success" | "error";
+}
+/**
+ * Minimal toast system rendered *inside* the shadow root, so notifications stay
+ * style-isolated (react-hot-toast would inject into the host document.body).
+ */
+export declare function useToasts(): {
+    toasts: ToastItem[];
+    show: (message: string, type?: ToastItem["type"], duration?: number) => number;
+    dismiss: (id: number) => void;
+};
+export declare function ToastContainer({ toasts }: {
+    toasts: ToastItem[];
+}): import("preact").JSX.Element | null;

package/dist/types.d.ts

@@ -0,0 +1,80 @@
+export interface ChatMessage {
+    role: "user" | "assistant";
+    content: string;
+    sources?: ChatSource[];
+}
+export interface ChatSource {
+    title: string;
+    url?: string;
+}
+export interface ChatSessionMeta {
+    id: string;
+    title: string;
+    timestamp: string;
+}
+/**
+ * Full configuration for the chat widget. Every field except `apiUrl` is optional
+ * and falls back to a sensible default (see DEFAULT_CONFIG in config.ts).
+ *
+ * The same shape is accepted three ways:
+ *  - HTML attributes on <chat-widget> (kebab-case, e.g. api-url)
+ *  - the JS `config` setter / `ChatWidget.init(config)` (camelCase, this type)
+ *  - React <ChatWidget {...props} /> (camelCase, this type)
+ */
+export interface ChatWidgetConfig {
+    /** Backend base URL. Endpoints used: `/chat`, `/history`, `/sync`. Required. */
+    apiUrl: string;
+    /** Header label shown next to the bot icon. */
+    title: string;
+    /** First assistant message shown in an empty conversation. */
+    welcomeMessage: string;
+    /** Placeholder text for the input box. */
+    placeholder: string;
+    /**
+     * Static fallback role sent in the `/chat` body as `user_role` for server-side
+     * doc filtering. Each host app defines its own role vocabulary. Use this when
+     * the role is known at embed time and never changes; for a role that depends on
+     * the logged-in user (and can change at runtime), prefer `getUserRole`.
+     */
+    userRole: string;
+    /**
+     * Resolver for the current user's role, called right before every `/chat`
+     * request so it always reflects the host app's live auth state (login/logout,
+     * role switch) — no need to push updates. May be sync or async. Takes precedence
+     * over `userRole`; if it throws/rejects, the widget falls back to `userRole`.
+     * JS/React only (cannot be an HTML attribute).
+     *
+     * Note: a client-supplied role can be tampered with. For tamper-proof access
+     * control, send an auth token via `headers` and have the backend derive the
+     * role server-side instead of trusting `user_role`.
+     */
+    getUserRole?: () => string | Promise<string>;
+    /** Docked corner of the floating button / panel. */
+    position: "bottom-right" | "bottom-left";
+    /** Open the panel automatically on load. */
+    defaultOpen: boolean;
+    /** Show the history panel and persist a per-browser session list. */
+    enableHistory: boolean;
+    /** Show the "Sync Docs" button and run a background sync on init. */
+    enableSync: boolean;
+    /** Show the maximize button that expands the panel to widescreen. */
+    allowFullscreen: boolean;
+    /** Max characters accepted by the input box. */
+    maxMessageLength: number;
+    /** Show the microphone button for voice-to-text input. Default true. */
+    enableVoiceInput?: boolean;
+    /** BCP-47 language for voice recognition (AWS Transcribe). Default "en-US". */
+    voiceLanguage?: string;
+    /** Extra headers merged into every request (e.g. an Authorization token). */
+    headers: Record<string, string>;
+    /** CSS stacking order of the widget root. */
+    zIndex: number;
+    /** Primary brand color (start of the header/FAB gradient). */
+    primaryColor?: string;
+    /** Secondary brand color (end of the gradient). */
+    secondaryColor?: string;
+    /** Font family for the widget. */
+    fontFamily?: string;
+}
+/** Partial config as accepted from consumers before defaults are applied. */
+export type ChatWidgetOptions = Partial<ChatWidgetConfig> & Pick<ChatWidgetConfig, "apiUrl">;