@useknest/widget-core 0.0.1-alpha.1

package/README.md

@@ -0,0 +1,26 @@
+# @useknest/widget-core
+
+Core Web Component for Knest chat widget.
+
+## Usage
+
+### Script tag (Vanilla JS)
+
+```html
+<script src="https://unpkg.com/@useknest/widget-core"></script>
+<knest-chat publishable-api-key="your-key"></knest-chat>
+```
+
+### Framework Wrappers
+
+For better framework integration, use the framework-specific wrappers:
+
+- React: `@useknest/widget-react`
+- Vue: `@useknest/widget-vue`
+- Svelte: `@useknest/widget-svelte`
+
+### Build
+
+```bash
+pnpm build
+```

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+import { default as ChatWidget } from './ChatWidget.client.svelte';
+import { default as ChatMessage } from './ChatMessage.svelte';
+export { ChatWidget, ChatMessage };
+export default ChatWidget;
+export type { ChatWidgetProps, Message, Source, MessageRole } from './types';

package/dist/internal.d.ts

@@ -0,0 +1,4 @@
+export { default as ChatWidget } from './ChatWidget.svelte';
+export { default } from './ChatWidget.svelte';
+export { default as ChatMessage } from './ChatMessage.svelte';
+export type { Message, Source, MessageRole, ChatWidgetProps } from './types';

package/dist/types.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Shared types for the chat widget.
+ * These align with the database schema and API contracts.
+ */
+export type MessageRole = 'user' | 'assistant' | 'system';
+export interface Source {
+    url: string;
+    title: string;
+    breadcrumb?: string;
+    snippet: string;
+    score?: number;
+}
+export interface Message {
+    id?: string;
+    role: MessageRole;
+    content: string;
+    sources?: Source[];
+    hasRagContext?: boolean;
+    createdAt?: string;
+    metadata?: Record<string, unknown>;
+}
+export interface ChatMessageRequest {
+    threadId?: string;
+    content: string;
+    email?: string;
+    fullName?: string;
+    metadata?: Record<string, unknown>;
+}
+export interface ChatMessageResponse {
+    messageId: string;
+    threadId: string;
+    visitorId: string;
+    isNewThread: boolean;
+    isNewVisitor: boolean;
+}
+export interface ChatApiError {
+    error: string;
+    details?: unknown;
+}
+export interface WidgetConfig {
+    avatarUrl?: string;
+    welcomeMessage?: string;
+    exampleQuestions?: string[];
+    brandColor?: string;
+}
+export interface ChatWidgetProps {
+    publishableApiKey: string;
+}