@namiruai/chat 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Namiru.ai
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,71 @@
+# @namiru/chat
+
+Core chat widget for [Namiru.ai](https://namiru.ai) -- embeddable AI customer support chat for any website.
+
+## Installation
+
+```bash
+npm install @namiru/chat
+```
+
+## Usage
+
+### Script Tag
+
+Add the widget to any website with a single script tag:
+
+```html
+<script
+  src="https://cdn.jsdelivr.net/npm/@namiru/chat/dist/namiru-chat.umd.js"
+  data-agent-id="your-agent-id"
+  data-position="bottom-right"
+></script>
+```
+
+### ESM Import
+
+```js
+import { init } from '@namiru/chat';
+
+const widget = init({
+  agentId: 'your-agent-id',
+  position: 'bottom-right',
+  mode: 'button',
+});
+
+// Control programmatically
+widget.open();
+widget.close();
+widget.toggle();
+widget.destroy();
+```
+
+### Inline Mode
+
+Embed the chat directly into a container element:
+
+```js
+import { init } from '@namiru/chat';
+
+const widget = init({
+  agentId: 'your-agent-id',
+  mode: 'inline',
+  container: document.getElementById('chat-container'),
+  width: '100%',
+  height: '500px',
+});
+```
+
+## Framework Wrappers
+
+- **React**: [@namiru/react](https://www.npmjs.com/package/@namiru/react)
+- **Vue**: [@namiru/vue](https://www.npmjs.com/package/@namiru/vue)
+- **Angular**: [@namiru/angular](https://www.npmjs.com/package/@namiru/angular)
+
+## Documentation
+
+For full documentation, visit [namiru.ai](https://namiru.ai).
+
+## License
+
+MIT

package/dist/core/api-client.d.ts

@@ -0,0 +1,54 @@
+import type { AgentBrandingData } from "./types";
+export interface ApiClientConfig {
+    baseUrl: string;
+}
+export interface FeedbackPayload {
+    sessionId: string;
+    rating: "up" | "down";
+    comment?: string;
+}
+export interface EscalationPayload {
+    sessionId: string;
+    userEmail: string;
+}
+export interface TranscriptPayload {
+    email: string;
+}
+export interface TranscriptResponse {
+    success: boolean;
+}
+export interface LimitMessagePayload {
+    agentId: string;
+    message: string;
+    visitorEmail?: string;
+}
+export interface LeadSubmitPayload {
+    agentId: string;
+    name?: string;
+    email: string;
+    message: string;
+    visitorId?: string;
+    fallbackReason?: "handoff_accepted" | "message_limit" | "conversation_limit";
+    conversationId?: string;
+}
+export declare class ApiClient {
+    private baseUrl;
+    constructor(config: ApiClientConfig);
+    fetchBranding(agentId: string): Promise<AgentBrandingData>;
+    submitFeedback(agentId: string, payload: FeedbackPayload): Promise<void>;
+    submitEscalation(agentId: string, payload: EscalationPayload): Promise<void>;
+    requestTranscript(agentId: string, sessionId: string, payload: TranscriptPayload): Promise<TranscriptResponse>;
+    submitLimitMessage(payload: LimitMessagePayload): Promise<{
+        success: boolean;
+    }>;
+    submitContactMessage(agentId: string, payload: {
+        email: string;
+        message: string;
+        visitorId?: string;
+    }): Promise<{
+        success: boolean;
+    }>;
+    submitLead(payload: LeadSubmitPayload): Promise<{
+        success: boolean;
+    }>;
+}

package/dist/core/env.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Shared runtime flag indicating whether the widget is rendered inside Shadow DOM.
+ * When false the widget falls back to direct DOM injection and needs !important
+ * declarations to resist host-page CSS bleed-through.
+ */
+export declare let hasShadowDom: boolean;
+export declare function setHasShadowDom(value: boolean): void;

package/dist/core/inactivity-timer.d.ts

@@ -0,0 +1,9 @@
+export declare class InactivityTimer {
+    private timerId;
+    private minutes;
+    private callback;
+    constructor(minutes: number, callback: () => void);
+    reset(): void;
+    stop(): void;
+    updateMinutes(minutes: number): void;
+}

package/dist/core/markdown.d.ts

@@ -0,0 +1 @@
+export declare function renderMarkdown(raw: string): string;

package/dist/core/pre-chat-templates.d.ts

@@ -0,0 +1,3 @@
+import type { PreChatTemplate } from "./types";
+export declare const preChatTemplates: Record<string, PreChatTemplate>;
+export declare function getPreChatTemplate(templateId: string): PreChatTemplate | null;

package/dist/core/state-machine.d.ts

@@ -0,0 +1,54 @@
+import type { ChatMessage } from "./types";
+export type ChatState = "idle" | "pre_chat" | "connecting" | "chatting" | "feedback" | "escalation" | "email_fallback" | "conversation_limit" | "domain_error" | "error";
+export interface ChatStoreState {
+    state: ChatState;
+    messages: ChatMessage[];
+    isOpen: boolean;
+    isLoading: boolean;
+    streamingContent: string;
+    qualification: string | null;
+    feedbackGiven: boolean;
+    sessionId: string | null;
+    error: string | null;
+}
+export type ChatAction = {
+    type: "SET_STATE";
+    state: ChatState;
+} | {
+    type: "SET_OPEN";
+    isOpen: boolean;
+} | {
+    type: "SET_LOADING";
+    isLoading: boolean;
+} | {
+    type: "ADD_MESSAGE";
+    message: ChatMessage;
+} | {
+    type: "APPEND_STREAMING";
+    token: string;
+} | {
+    type: "CLEAR_STREAMING";
+} | {
+    type: "SET_QUALIFICATION";
+    qualification: string;
+} | {
+    type: "SET_FEEDBACK_GIVEN";
+} | {
+    type: "SET_SESSION_ID";
+    sessionId: string;
+} | {
+    type: "SET_ERROR";
+    error: string | null;
+} | {
+    type: "RESET";
+};
+export type StoreSubscriber = (state: ChatStoreState) => void;
+export declare class ChatStore {
+    private state;
+    private subscribers;
+    constructor();
+    getState(): ChatStoreState;
+    dispatch(action: ChatAction): void;
+    subscribe(subscriber: StoreSubscriber): () => void;
+    private notify;
+}

package/dist/core/types.d.ts

@@ -0,0 +1,92 @@
+export interface NamiruChatConfig {
+    agentId: string;
+    serverUrl?: string;
+    wsUrl?: string;
+    mode?: "button" | "inline";
+    position?: "bottom-left" | "bottom-right";
+    container?: HTMLElement;
+    preChatEnabled?: boolean;
+    preChatTemplate?: "ecommerce" | "saas" | "services" | "custom" | null;
+    preChatCustom?: PreChatCustomConfig;
+    greetingDelay?: number;
+    width?: string;
+    height?: string;
+    onLeadCapture?: (lead: LeadCaptureData) => void;
+    onFeedback?: (rating: "up" | "down") => void;
+    onSessionStart?: (sessionId: string) => void;
+    onSessionEnd?: (sessionId: string) => void;
+}
+export interface PreChatCustomConfig {
+    question: string;
+    options: PreChatOption[];
+}
+export interface PreChatOption {
+    label: string;
+    icon: string;
+}
+export interface PreChatTemplate {
+    id: "ecommerce" | "saas" | "services" | "custom";
+    question: string;
+    options: PreChatOption[];
+}
+export interface NamiruChatInstance {
+    open: () => void;
+    close: () => void;
+    toggle: () => void;
+    destroy: () => void;
+    updateConfig: (config: Partial<NamiruChatConfig>) => void;
+}
+export interface AgentBrandingData {
+    agentId: string;
+    name: string;
+    primaryColor: string;
+    accentColor?: string;
+    logoUrl?: string;
+    agentAvatar?: string;
+    welcomeMessage?: string;
+    showPoweredBy?: boolean;
+    showHeader?: boolean;
+    headerColor?: string;
+    headerTitle?: string;
+    headerSubtitle?: string;
+    presetTheme?: "light" | "dark" | "custom";
+    backgroundColor?: string;
+    textColor?: string;
+    bubbleStyle?: "modern" | "rounded" | "square" | "classic";
+    fontFamily?: string;
+    fontSize?: "small" | "medium" | "large";
+    userMessageColor?: string;
+    agentMessageColor?: string;
+    bubbleGreeting?: string;
+    suggestedQuestions?: string[];
+    preChatConfig?: {
+        enabled: boolean;
+        template: "ecommerce" | "saas" | "services" | "custom" | null;
+        custom?: PreChatCustomConfig;
+    };
+    feedbackConfig?: {
+        enabled: boolean;
+        inactivityMinutes: number;
+    };
+    escalationConfig?: {
+        enabled: boolean;
+        emailFallbackEnabled: boolean;
+        ownerEmail?: string;
+        customReplyMessage?: string;
+        liveChatEnabled: boolean;
+    };
+    allowedDomains?: string[];
+}
+export interface ChatMessage {
+    id: string;
+    role: "user" | "assistant" | "system";
+    content: string;
+    timestamp: number;
+    metadata?: Record<string, unknown>;
+}
+export interface LeadCaptureData {
+    email: string;
+    sessionId: string;
+    source: "email_fallback" | "pre_chat" | "transcript_request";
+    qualification?: string;
+}

package/dist/core/websocket-client.d.ts

@@ -0,0 +1,40 @@
+export type WebSocketEventType = "connected" | "disconnected" | "agent_initialized" | "stream_token" | "final_response" | "stream_end" | "tool_start" | "tool_end" | "kit_trigger" | "usage_limit" | "show_handoff_form" | "handoff_active" | "error" | "status";
+export interface WebSocketEvent {
+    type: WebSocketEventType;
+    data: any;
+}
+export type WebSocketEventHandler = (event: WebSocketEvent) => void;
+export interface WebSocketClientConfig {
+    url: string;
+    agentId: string;
+    token?: string;
+    visitorId?: string;
+    maxReconnectAttempts?: number;
+}
+export declare class WebSocketClient {
+    private ws;
+    private config;
+    private listeners;
+    private reconnectAttempts;
+    private maxReconnectAttempts;
+    private isDestroyed;
+    private isInitialized;
+    constructor(config: WebSocketClientConfig);
+    connect(): void;
+    disconnect(): void;
+    sendMessage(content: string): void;
+    sendHandoffComplete(data: {
+        email: string;
+        name?: string;
+        reason: string;
+    }): void;
+    sendEscalationEmail(email: string): void;
+    on(type: WebSocketEventType, handler: WebSocketEventHandler): () => void;
+    private send;
+    private emit;
+    private handleOpen;
+    private handleMessage;
+    private handleToolEnd;
+    private handleClose;
+    private handleError;
+}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export type { NamiruChatConfig, NamiruChatInstance, AgentBrandingData, ChatMessage, PreChatTemplate, PreChatCustomConfig, PreChatOption, LeadCaptureData, } from "./core/types";
+import type { NamiruChatConfig, NamiruChatInstance } from "./core/types";
+export declare function init(config: NamiruChatConfig): NamiruChatInstance;