open-ask-ai 0.1.0

package/dist/types/components/chat/ChatContainer.d.ts

@@ -0,0 +1,16 @@
+import * as React from 'react';
+import type { WidgetTexts, Message } from '@/core/types';
+interface ChatContainerProps {
+    texts?: WidgetTexts;
+    exampleQuestions?: string[];
+    onMessage?: (message: any) => void;
+    onError?: (error: Error) => void;
+    messages: Message[];
+    isStreaming: boolean;
+    error: Error | null;
+    sendMessage: (text: string) => Promise<void>;
+    input: string;
+    setInput: React.Dispatch<React.SetStateAction<string>>;
+}
+export declare function ChatContainer({ texts, exampleQuestions, onMessage, onError, messages, isStreaming, error, sendMessage, input, setInput, }: ChatContainerProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/types/components/ui/Button.d.ts

@@ -0,0 +1,10 @@
+import * as React from 'react';
+type ButtonVariant = 'default' | 'outline' | 'ghost' | 'icon';
+type ButtonSize = 'default' | 'sm' | 'lg' | 'icon';
+export interface ButtonProps extends React.ButtonHTMLAttributes<HTMLButtonElement> {
+    asChild?: boolean;
+    variant?: ButtonVariant;
+    size?: ButtonSize;
+}
+declare const Button: React.ForwardRefExoticComponent<ButtonProps & React.RefAttributes<HTMLButtonElement>>;
+export { Button };

package/dist/types/components/widget/Drawer.d.ts

@@ -0,0 +1,13 @@
+import * as React from 'react';
+interface DrawerProps {
+    isOpen: boolean;
+    onClose: () => void;
+    position?: 'right' | 'left';
+    width?: number | string;
+    title?: string;
+    closeAriaLabel?: string;
+    children?: React.ReactNode;
+    theme?: 'light' | 'dark';
+}
+export declare function Drawer({ isOpen, onClose, position, width, title, closeAriaLabel, children, theme, }: DrawerProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/types/components/widget/Trigger.d.ts

@@ -0,0 +1,8 @@
+interface TriggerProps {
+    onClick: () => void;
+    text?: string;
+    ariaLabel?: string;
+    className?: string;
+}
+export declare function Trigger({ onClick, text, ariaLabel, className, }: TriggerProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/types/components/widget/Widget.d.ts

@@ -0,0 +1,2 @@
+import type { WidgetProps } from '@/core/types';
+export declare function Widget(props: WidgetProps): import("react/jsx-runtime").JSX.Element;

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

@@ -0,0 +1,21 @@
+import type { SessionResponse } from '../types';
+/**
+ * API client for Ask AI widget
+ * Supports dynamic API URL configuration
+ */
+export declare class APIClient {
+    private baseUrl;
+    constructor(baseUrl: string);
+    /**
+     * Create a new session
+     */
+    createSession(): Promise<SessionResponse>;
+    /**
+     * Delete a session
+     */
+    deleteSession(sessionId: string): Promise<void>;
+    /**
+     * Ask a question and return the SSE stream response
+     */
+    askQuestion(sessionId: string, question: string, system?: string): Promise<Response>;
+}

package/dist/types/core/hooks/index.d.ts

@@ -0,0 +1,3 @@
+export { useChat } from './useChat';
+export { useSSE } from './useSSE';
+export { useSession } from './useSession';

package/dist/types/core/hooks/useChat.d.ts

@@ -0,0 +1,17 @@
+import type { Message } from '../types';
+import type { APIClient } from '../api/client';
+interface UseChatOptions {
+    apiClient: APIClient;
+    systemPrompt?: string;
+}
+interface UseChatReturn {
+    messages: Message[];
+    isStreaming: boolean;
+    error: Error | null;
+    sessionError: Error | null;
+    isCreatingSession: boolean;
+    sendMessage: (text: string) => Promise<void>;
+    clearMessages: () => void;
+}
+export declare function useChat({ apiClient, systemPrompt }: UseChatOptions): UseChatReturn;
+export {};

package/dist/types/core/hooks/useSSE.d.ts

@@ -0,0 +1,12 @@
+import type { SSEData } from '../types';
+interface UseSSEOptions {
+    onConnected?: () => void;
+    onMessage?: (data: SSEData) => void;
+    onDone?: () => void;
+    onError?: (error: Error) => void;
+}
+interface UseSSEReturn {
+    handleSSEStream: (response: Response) => Promise<void>;
+}
+export declare function useSSE(options?: UseSSEOptions): UseSSEReturn;
+export {};

package/dist/types/core/hooks/useSession.d.ts

@@ -0,0 +1,13 @@
+import type { APIClient } from '../api/client';
+interface UseSessionOptions {
+    apiClient: APIClient;
+}
+interface UseSessionReturn {
+    sessionId: string | null;
+    isCreating: boolean;
+    error: Error | null;
+    initializeSession: () => Promise<string>;
+    recreateSession: () => Promise<void>;
+}
+export declare function useSession({ apiClient }: UseSessionOptions): UseSessionReturn;
+export {};

package/dist/types/core/types/index.d.ts

@@ -0,0 +1,69 @@
+export interface Message {
+    id: string;
+    role: 'user' | 'assistant';
+    content: string;
+    timestamp: number;
+    isStreaming?: boolean;
+}
+export interface ChatState {
+    messages: Message[];
+    isStreaming: boolean;
+    error: Error | null;
+}
+export interface SessionResponse {
+    sessionId: string;
+    expiresIn: number;
+}
+export interface SSEEvent {
+    event: string;
+    data: any;
+}
+export interface SSEConnectedData {
+    type: 'connected';
+}
+export interface SSEAnswerData {
+    type: 'answer';
+    text: string;
+    sessionId: string;
+}
+export interface SSEDoneData {
+    type: 'done';
+}
+export interface SSEErrorData {
+    type: 'error';
+    error: string;
+}
+export type SSEData = SSEConnectedData | SSEAnswerData | SSEDoneData | SSEErrorData;
+export interface WidgetTexts {
+    triggerButtonText?: string;
+    triggerButtonAriaLabel?: string;
+    drawerTitle?: string;
+    drawerCloseAriaLabel?: string;
+    welcomeMessage?: string;
+    exampleQuestionsTitle?: string;
+    inputPlaceholder?: string;
+    sendButtonAriaLabel?: string;
+    loadingText?: string;
+    errorText?: string;
+    retryButtonText?: string;
+}
+export interface WidgetProps {
+    apiUrl: string;
+    drawerPosition?: 'right' | 'left';
+    drawerWidth?: number | string;
+    theme?: 'light' | 'dark';
+    texts?: WidgetTexts;
+    exampleQuestions?: string[];
+    systemPrompt?: string;
+    hotkey?: string;
+    enableHotkey?: boolean;
+    onOpen?: () => void;
+    onClose?: () => void;
+    onMessage?: (message: Message) => void;
+    onError?: (error: Error) => void;
+    className?: string;
+    style?: React.CSSProperties;
+    children?: React.ReactElement<{
+        onClick?: (e: React.MouseEvent) => void;
+    }>;
+}

package/dist/types/index.d.ts

@@ -0,0 +1,6 @@
+export { Widget as AskAIWidget } from './components/widget/Widget';
+export type { Message, WidgetProps, WidgetTexts, } from './core/types';
+export { APIClient } from './core/api/client';
+export { useChat, useSession, useSSE, } from './core/hooks';
+import './styles/variables.css';
+import './styles/globals.css';

package/package.json

@@ -0,0 +1,67 @@
+{
+  "name": "open-ask-ai",
+  "version": "0.1.0",
+  "description": "AI-powered Q&A widget for documentation sites",
+  "type": "module",
+  "main": "./dist/index.cjs.js",
+  "module": "./dist/index.esm.js",
+  "types": "./dist/types/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.esm.js",
+      "require": "./dist/index.cjs.js",
+      "types": "./dist/types/index.d.ts"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "npm run build:types && npm run build:rollup",
+    "build:types": "tsc --project tsconfig.build.json",
+    "build:rollup": "rollup -c rollup.config.js",
+    "typecheck": "tsc --noEmit"
+  },
+  "peerDependencies": {
+    "react": "^18.0.0 || ^19.0.0",
+    "react-dom": "^18.0.0 || ^19.0.0"
+  },
+  "dependencies": {
+    "@radix-ui/react-dialog": "^1.1.3",
+    "@radix-ui/react-scroll-area": "^1.2.2",
+    "@radix-ui/react-slot": "^1.1.1",
+    "lucide-react": "^0.563.0",
+    "react-markdown": "^10.1.0",
+    "remark-gfm": "^4.0.1"
+  },
+  "devDependencies": {
+    "@rollup/plugin-commonjs": "^28.0.2",
+    "@rollup/plugin-node-resolve": "^16.0.0",
+    "@rollup/plugin-typescript": "^12.1.2",
+    "@types/node": "^22.10.5",
+    "@types/react": "^19.0.10",
+    "@types/react-dom": "^19.0.3",
+    "autoprefixer": "^10.4.20",
+    "postcss": "^8.5.1",
+    "postcss-prefix-selector": "^1.16.1",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0",
+    "rollup": "^4.30.1",
+    "rollup-plugin-peer-deps-external": "^2.2.4",
+    "rollup-plugin-postcss": "^4.0.2",
+    "typescript": "^5.9.3"
+  },
+  "keywords": [
+    "ai",
+    "chatbot",
+    "documentation",
+    "widget",
+    "react"
+  ],
+  "author": "",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": ""
+  }
+}