@bernierllc/onboarding-chat-ui 0.0.1 → 0.1.0

package/dist/hooks/useOnboardingChat.js

@@ -0,0 +1,172 @@
+/*
+Copyright (c) 2025 Bernier LLC
+
+This file is licensed to the client under a limited-use license.
+The client may use and modify this code *only within the scope of the project it was delivered for*.
+Redistribution or use in other products or commercial offerings is not permitted without written consent from Bernier LLC.
+*/
+import { useState, useCallback, useRef } from 'react';
+import { logger } from '@bernierllc/logger';
+import { OnboardingUIError } from '../errors';
+/** Generate a simple unique ID. */
+function generateId() {
+    return `${Date.now()}-${Math.random().toString(36).slice(2, 9)}`;
+}
+/**
+ * Parse complete SSE frames from a text buffer.
+ * Returns parsed events and any incomplete trailing content.
+ */
+export function parseSSEFrames(buffer) {
+    const parts = buffer.split('\n\n');
+    const remaining = parts.pop() ?? '';
+    const events = [];
+    for (const part of parts) {
+        for (const line of part.split('\n')) {
+            if (line.startsWith('data: ')) {
+                const data = line.slice(6);
+                if (data === '[DONE]') {
+                    continue;
+                }
+                try {
+                    const parsed = JSON.parse(data);
+                    events.push(parsed);
+                }
+                catch {
+                    // Ignore malformed JSON lines — keep streaming.
+                }
+            }
+        }
+    }
+    return { events, remaining };
+}
+/**
+ * Hook that manages the onboarding chat session: sends user messages to
+ * a backend SSE endpoint and updates messages, tool-call events, setup
+ * status, and completion state as events arrive.
+ */
+export function useOnboardingChat(options) {
+    const { chatEndpoint, sessionId, userId, fetchFn } = options;
+    const resolvedFetch = fetchFn ?? fetch;
+    const [messages, setMessages] = useState([]);
+    const [isStreaming, setIsStreaming] = useState(false);
+    const [toolCallEvents, setToolCallEvents] = useState([]);
+    const [lastToolCall, setLastToolCall] = useState(null);
+    const [setupStatus, setSetupStatus] = useState(null);
+    const [isComplete, setIsComplete] = useState(false);
+    const [error, setError] = useState(null);
+    // Track the active assistant message id so we can append deltas to it.
+    const assistantMsgIdRef = useRef(null);
+    const send = useCallback((text, attachments) => {
+        const userMsg = {
+            id: generateId(),
+            role: 'user',
+            content: text,
+            attachments,
+            timestamp: new Date().toISOString(),
+        };
+        const assistantId = generateId();
+        assistantMsgIdRef.current = assistantId;
+        const assistantMsg = {
+            id: assistantId,
+            role: 'assistant',
+            content: '',
+            timestamp: new Date().toISOString(),
+        };
+        setMessages(prev => [...prev, userMsg, assistantMsg]);
+        setIsStreaming(true);
+        setError(null);
+        const streamResponse = async () => {
+            try {
+                const response = await resolvedFetch(chatEndpoint, {
+                    method: 'POST',
+                    headers: { 'Content-Type': 'application/json' },
+                    body: JSON.stringify({
+                        message: text,
+                        attachments: attachments ?? [],
+                        sessionId,
+                        userId,
+                    }),
+                });
+                if (!response.ok) {
+                    throw new OnboardingUIError(`Chat request failed with status ${response.status}`, { code: 'CHAT_REQUEST_FAILED', context: { status: response.status } });
+                }
+                if (response.body === null) {
+                    throw new OnboardingUIError('No response body for SSE stream', {
+                        code: 'NO_RESPONSE_BODY',
+                    });
+                }
+                const reader = response.body.getReader();
+                const decoder = new TextDecoder();
+                let buffer = '';
+                try {
+                    let streamDone = false;
+                    while (!streamDone) {
+                        const { done, value } = await reader.read();
+                        streamDone = done;
+                        if (!done) {
+                            buffer += decoder.decode(value, { stream: true });
+                            const { events, remaining } = parseSSEFrames(buffer);
+                            buffer = remaining;
+                            for (const sseEvent of events) {
+                                // Process inline to avoid stale-closure issues with
+                                // a separately-memoised processSSEEvent callback.
+                                if (sseEvent.type === 'delta') {
+                                    const targetId = assistantMsgIdRef.current;
+                                    setMessages(prev => prev.map(msg => msg.id === targetId
+                                        ? { ...msg, content: msg.content + sseEvent.delta }
+                                        : msg));
+                                }
+                                else if (sseEvent.type === 'tool_call') {
+                                    const toolCall = {
+                                        toolName: sseEvent.toolName,
+                                        args: sseEvent.args,
+                                    };
+                                    setToolCallEvents(prev => [...prev, toolCall]);
+                                    setLastToolCall(toolCall);
+                                }
+                                else if (sseEvent.type === 'status') {
+                                    setSetupStatus(sseEvent.status);
+                                }
+                                else if (sseEvent.type === 'complete') {
+                                    setIsComplete(true);
+                                }
+                            }
+                        }
+                    }
+                }
+                finally {
+                    reader.releaseLock();
+                }
+            }
+            catch (err) {
+                if (err instanceof OnboardingUIError) {
+                    logger.error('OnboardingUIError during chat stream', err);
+                    setError(err);
+                }
+                else if (err instanceof Error) {
+                    const wrapped = new OnboardingUIError('Chat stream failed', {
+                        cause: err,
+                        code: 'STREAM_ERROR',
+                    });
+                    logger.error('Chat stream failed', wrapped);
+                    setError(wrapped);
+                }
+            }
+            finally {
+                setIsStreaming(false);
+            }
+        };
+        void streamResponse();
+    }, [chatEndpoint, sessionId, userId, resolvedFetch]);
+    return {
+        messages,
+        send,
+        isStreaming,
+        toolCallEvents,
+        lastToolCall,
+        setupStatus,
+        isComplete,
+        error,
+    };
+}
+//# sourceMappingURL=useOnboardingChat.js.map

package/dist/hooks/useOnboardingChat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useOnboardingChat.js","sourceRoot":"","sources":["../../src/hooks/useOnboardingChat.ts"],"names":[],"mappings":"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"}

package/dist/hooks/usePanelRegistry.d.ts

@@ -0,0 +1,11 @@
+import type { UsePanelRegistryOptions, UsePanelRegistryResult } from '../types/ui-types';
+/**
+ * Maps incoming tool-call events to side-panel slot IDs.
+ *
+ * When a tool call arrives whose name appears in a descriptor's
+ * `triggerToolNames`, `activePanel` updates to the corresponding `slotId`.
+ * This is the generalisation of nevarPro's SiteCard / calendar-connect /
+ * live-site-iframe swap logic.
+ */
+export declare function usePanelRegistry(options: UsePanelRegistryOptions): UsePanelRegistryResult;
+//# sourceMappingURL=usePanelRegistry.d.ts.map

package/dist/hooks/usePanelRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usePanelRegistry.d.ts","sourceRoot":"","sources":["../../src/hooks/usePanelRegistry.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAiB,uBAAuB,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAExG;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,uBAAuB,GAAG,sBAAsB,CAsBzF"}

package/dist/hooks/usePanelRegistry.js

@@ -0,0 +1,44 @@
+/*
+Copyright (c) 2025 Bernier LLC
+
+This file is licensed to the client under a limited-use license.
+The client may use and modify this code *only within the scope of the project it was delivered for*.
+Redistribution or use in other products or commercial offerings is not permitted without written consent from Bernier LLC.
+*/
+import { useState, useEffect } from 'react';
+/**
+ * Maps incoming tool-call events to side-panel slot IDs.
+ *
+ * When a tool call arrives whose name appears in a descriptor's
+ * `triggerToolNames`, `activePanel` updates to the corresponding `slotId`.
+ * This is the generalisation of nevarPro's SiteCard / calendar-connect /
+ * live-site-iframe swap logic.
+ */
+export function usePanelRegistry(options) {
+    const { panelDescriptors, toolCallEvents } = options;
+    const [activePanel, setActivePanel] = useState(null);
+    useEffect(() => {
+        if (toolCallEvents.length === 0) {
+            return;
+        }
+        // React to the most recently added tool call event.
+        const lastEvent = toolCallEvents[toolCallEvents.length - 1];
+        if (lastEvent === undefined) {
+            return;
+        }
+        const matchingDescriptor = findDescriptorForToolCall(panelDescriptors, lastEvent.toolName);
+        if (matchingDescriptor !== null) {
+            setActivePanel(matchingDescriptor.slotId);
+        }
+    }, [toolCallEvents, panelDescriptors]);
+    return { activePanel };
+}
+function findDescriptorForToolCall(descriptors, toolName) {
+    for (const descriptor of descriptors) {
+        if (descriptor.triggerToolNames.includes(toolName)) {
+            return descriptor;
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=usePanelRegistry.js.map

package/dist/hooks/usePanelRegistry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"usePanelRegistry.js","sourceRoot":"","sources":["../../src/hooks/usePanelRegistry.ts"],"names":[],"mappings":"AAAA;;;;;;EAME;AAEF,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAI5C;;;;;;;GAOG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAgC;IAC/D,MAAM,EAAE,gBAAgB,EAAE,cAAc,EAAE,GAAG,OAAO,CAAC;IACrD,MAAM,CAAC,WAAW,EAAE,cAAc,CAAC,GAAG,QAAQ,CAAgB,IAAI,CAAC,CAAC;IAEpE,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,cAAc,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAChC,OAAO;QACT,CAAC;QAED,oDAAoD;QACpD,MAAM,SAAS,GAA8B,cAAc,CAAC,cAAc,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QACvF,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;YAC5B,OAAO;QACT,CAAC;QAED,MAAM,kBAAkB,GAAG,yBAAyB,CAAC,gBAAgB,EAAE,SAAS,CAAC,QAAQ,CAAC,CAAC;QAC3F,IAAI,kBAAkB,KAAK,IAAI,EAAE,CAAC;YAChC,cAAc,CAAC,kBAAkB,CAAC,MAAM,CAAC,CAAC;QAC5C,CAAC;IACH,CAAC,EAAE,CAAC,cAAc,EAAE,gBAAgB,CAAC,CAAC,CAAC;IAEvC,OAAO,EAAE,WAAW,EAAE,CAAC;AACzB,CAAC;AAED,SAAS,yBAAyB,CAChC,WAAoC,EACpC,QAAgB;IAEhB,KAAK,MAAM,UAAU,IAAI,WAAW,EAAE,CAAC;QACrC,IAAI,UAAU,CAAC,gBAAgB,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;YACnD,OAAO,UAAU,CAAC;QACpB,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,16 @@
+export { OnboardingChat } from './components/OnboardingChat';
+export { ChatPane } from './components/ChatPane';
+export { SidePanel } from './components/SidePanel';
+export { ProgressChecklist } from './components/ProgressChecklist';
+export { CompletionCard } from './components/CompletionCard';
+export { RatingBar } from './components/RatingBar';
+export { AttachmentDropzone } from './components/AttachmentDropzone';
+export { useOnboardingChat } from './hooks/useOnboardingChat';
+export { useGoalProgress } from './hooks/useGoalProgress';
+export { usePanelRegistry } from './hooks/usePanelRegistry';
+export { useAutoGreeting } from './hooks/useAutoGreeting';
+export { OnboardingChatProvider, useOnboardingChatContext } from './context/OnboardingChatContext';
+export { OnboardingUIError } from './errors';
+export type { Attachment, OnboardingMessage, SSEPayload, ToolCallEvent, SetupStatus, UseOnboardingChatOptions, UseOnboardingChatResult, UseGoalProgressOptions, UseGoalProgressResult, GoalDisplayItem, UsePanelRegistryOptions, UsePanelRegistryResult, UseAutoGreetingOptions, OnboardingChatProps, ChatPaneProps, SidePanelProps, ProgressChecklistProps, CompletionCardProps, RatingBarProps, AttachmentDropzoneProps, } from './types/ui-types';
+export type { OnboardingChatContextValue, OnboardingChatProviderProps } from './context/OnboardingChatContext';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACjD,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AACnE,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AAGrE,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAG1D,OAAO,EAAE,sBAAsB,EAAE,wBAAwB,EAAE,MAAM,iCAAiC,CAAC;AAGnG,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAG7C,YAAY,EACV,UAAU,EACV,iBAAiB,EACjB,UAAU,EACV,aAAa,EACb,WAAW,EACX,wBAAwB,EACxB,uBAAuB,EACvB,sBAAsB,EACtB,qBAAqB,EACrB,eAAe,EACf,uBAAuB,EACvB,sBAAsB,EACtB,sBAAsB,EACtB,mBAAmB,EACnB,aAAa,EACb,cAAc,EACd,sBAAsB,EACtB,mBAAmB,EACnB,cAAc,EACd,uBAAuB,GACxB,MAAM,kBAAkB,CAAC;AAE1B,YAAY,EAAE,0BAA0B,EAAE,2BAA2B,EAAE,MAAM,iCAAiC,CAAC"}

package/dist/index.js

@@ -0,0 +1,25 @@
+/*
+Copyright (c) 2025 Bernier LLC
+
+This file is licensed to the client under a limited-use license.
+The client may use and modify this code *only within the scope of the project it was delivered for*.
+Redistribution or use in other products or commercial offerings is not permitted without written consent from Bernier LLC.
+*/
+// Components
+export { OnboardingChat } from './components/OnboardingChat';
+export { ChatPane } from './components/ChatPane';
+export { SidePanel } from './components/SidePanel';
+export { ProgressChecklist } from './components/ProgressChecklist';
+export { CompletionCard } from './components/CompletionCard';
+export { RatingBar } from './components/RatingBar';
+export { AttachmentDropzone } from './components/AttachmentDropzone';
+// Hooks
+export { useOnboardingChat } from './hooks/useOnboardingChat';
+export { useGoalProgress } from './hooks/useGoalProgress';
+export { usePanelRegistry } from './hooks/usePanelRegistry';
+export { useAutoGreeting } from './hooks/useAutoGreeting';
+// Context
+export { OnboardingChatProvider, useOnboardingChatContext } from './context/OnboardingChatContext';
+// Error
+export { OnboardingUIError } from './errors';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;EAME;AAEF,aAAa;AACb,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACjD,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AACnE,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AAErE,QAAQ;AACR,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAE1D,UAAU;AACV,OAAO,EAAE,sBAAsB,EAAE,wBAAwB,EAAE,MAAM,iCAAiC,CAAC;AAEnG,QAAQ;AACR,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC"}

package/dist/types/ui-types.d.ts

@@ -0,0 +1,161 @@
+import type React from 'react';
+import type { OnboardingConfig, OnboardingGoal, GoalProgress, HandoffTarget } from '@bernierllc/onboarding-config-core';
+import type { PluginPanelDescriptor } from '@bernierllc/onboarding-feature-plugin';
+/** A file attachment converted to a base64 data URL for browser use. */
+export interface Attachment {
+    /** Original file name. */
+    name: string;
+    /** MIME type, e.g. "image/png". */
+    type: string;
+    /** Base64 data URL produced by FileReader.readAsDataURL(). */
+    dataUrl: string;
+    /** File size in bytes. */
+    size: number;
+}
+/** A single message in the onboarding chat session. */
+export interface OnboardingMessage {
+    /** Unique message identifier. */
+    id: string;
+    /** Sender role. */
+    role: 'user' | 'assistant';
+    /** Text content. May grow incrementally as SSE deltas arrive. */
+    content: string;
+    /** Optional file attachments (user messages only). */
+    attachments?: Attachment[];
+    /** ISO timestamp string. */
+    timestamp: string;
+}
+/** Discriminated union of all SSE event payloads emitted by the onboarding agent. */
+export type SSEPayload = {
+    type: 'delta';
+    delta: string;
+} | {
+    type: 'tool_call';
+    toolName: string;
+    args: unknown;
+} | {
+    type: 'status';
+    status: GoalProgress;
+} | {
+    type: 'complete';
+};
+/** A tool call event surfaced from the SSE stream. */
+export interface ToolCallEvent {
+    toolName: string;
+    args: unknown;
+}
+/** Alias for GoalProgress, exposed under the SetupStatus name used in the plan. */
+export type SetupStatus = GoalProgress;
+/** Options for useOnboardingChat. */
+export interface UseOnboardingChatOptions {
+    chatEndpoint: string;
+    sessionId: string;
+    userId: string;
+    /** Injectable fetch function for testing. Defaults to window.fetch. */
+    fetchFn?: typeof fetch;
+}
+/** Return value of useOnboardingChat. */
+export interface UseOnboardingChatResult {
+    messages: OnboardingMessage[];
+    send: (text: string, attachments?: Attachment[]) => void;
+    isStreaming: boolean;
+    toolCallEvents: ToolCallEvent[];
+    lastToolCall: ToolCallEvent | null;
+    setupStatus: SetupStatus | null;
+    isComplete: boolean;
+    error: Error | null;
+}
+/** Options for useGoalProgress. */
+export interface UseGoalProgressOptions {
+    goals: OnboardingGoal[];
+    setupStatus: SetupStatus | null;
+}
+/** A single enriched goal item for display. */
+export interface GoalDisplayItem {
+    id: string;
+    description: string;
+    required: boolean;
+    phase: string;
+    completed: boolean;
+}
+/** Return value of useGoalProgress. */
+export interface UseGoalProgressResult {
+    goalItems: GoalDisplayItem[];
+    requiredMet: number;
+    requiredTotal: number;
+    isComplete: boolean;
+}
+/** Options for usePanelRegistry. */
+export interface UsePanelRegistryOptions {
+    panelDescriptors: PluginPanelDescriptor[];
+    toolCallEvents: ToolCallEvent[];
+}
+/** Return value of usePanelRegistry. */
+export interface UsePanelRegistryResult {
+    activePanel: string | null;
+}
+/** Options for useAutoGreeting. */
+export interface UseAutoGreetingOptions {
+    messages: OnboardingMessage[];
+    send: (text: string) => void;
+    greeting: string;
+    /** Delay in milliseconds before firing the greeting. Defaults to 500. */
+    delayMs?: number;
+}
+/** Props for OnboardingChat root component. */
+export interface OnboardingChatProps {
+    chatEndpoint: string;
+    statusEndpoint?: string;
+    ratingEndpoint?: string;
+    config: OnboardingConfig;
+    panelDescriptors?: PluginPanelDescriptor[];
+    panelComponents?: Record<string, React.ComponentType>;
+    onComplete?: (status: SetupStatus | null) => void;
+    sessionId: string;
+    userId: string;
+    /** Injectable fetch for testing. */
+    fetchFn?: typeof fetch;
+    className?: string;
+}
+/** Props for ChatPane. */
+export interface ChatPaneProps {
+    messages: OnboardingMessage[];
+    isStreaming: boolean;
+    onSend: (text: string, attachments?: Attachment[]) => void;
+    className?: string;
+}
+/** Props for SidePanel. */
+export interface SidePanelProps {
+    activePanel: string | null;
+    panelComponents: Record<string, React.ComponentType>;
+    fallback?: React.ReactNode;
+    className?: string;
+}
+/** Props for ProgressChecklist. */
+export interface ProgressChecklistProps {
+    goals: OnboardingGoal[];
+    status: SetupStatus | null;
+    showRequired?: boolean;
+    className?: string;
+}
+/** Props for CompletionCard. */
+export interface CompletionCardProps {
+    onboardingName: string;
+    handoffs: HandoffTarget[];
+    onHandoffClick: (target: HandoffTarget) => void;
+    children?: React.ReactNode;
+    className?: string;
+}
+/** Props for RatingBar. */
+export interface RatingBarProps {
+    onRate: (rating: 'up' | 'down') => void;
+    className?: string;
+}
+/** Props for AttachmentDropzone. */
+export interface AttachmentDropzoneProps {
+    accept?: string;
+    onAttach: (attachments: Attachment[]) => void;
+    maxSizeMB?: number;
+    className?: string;
+}
+//# sourceMappingURL=ui-types.d.ts.map

package/dist/types/ui-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui-types.d.ts","sourceRoot":"","sources":["../../src/types/ui-types.ts"],"names":[],"mappings":"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"}

package/dist/types/ui-types.js

@@ -0,0 +1,9 @@
+/*
+Copyright (c) 2025 Bernier LLC
+
+This file is licensed to the client under a limited-use license.
+The client may use and modify this code *only within the scope of the project it was delivered for*.
+Redistribution or use in other products or commercial offerings is not permitted without written consent from Bernier LLC.
+*/
+export {};
+//# sourceMappingURL=ui-types.js.map

package/dist/types/ui-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui-types.js","sourceRoot":"","sources":["../../src/types/ui-types.ts"],"names":[],"mappings":"AAAA;;;;;;EAME"}

package/package.json

@@ -1,10 +1,73 @@
 {
   "name": "@bernierllc/onboarding-chat-ui",
-  "version": "0.0.1",
-  "description": "OIDC trusted publishing setup package for @bernierllc/onboarding-chat-ui",
+  "version": "0.1.0",
+  "description": "React onboarding chat UI: split-pane chat with side panels, progress checklist, completion and rating, attachment dropzone, auto-greeting, and onboarding SSE hooks.",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
   "keywords": [
-    "oidc",
-    "trusted-publishing",
-    "setup"
-  ]
-}
+    "onboarding",
+    "chat",
+    "ui",
+    "react",
+    "components",
+    "sse",
+    "typescript"
+  ],
+  "author": "Bernier LLC",
+  "license": "SEE LICENSE IN LICENSE",
+  "files": [
+    "dist/**/*",
+    "README.md",
+    "LICENSE"
+  ],
+  "dependencies": {
+    "@bernierllc/messaging-ui": "0.4.0",
+    "@bernierllc/onboarding-config-core": "0.2.0",
+    "@bernierllc/logger": "1.7.0",
+    "@bernierllc/onboarding-feature-plugin": "0.2.0"
+  },
+  "devDependencies": {
+    "@testing-library/jest-dom": "^5.16.0",
+    "@testing-library/react": "^13.4.0",
+    "@testing-library/user-event": "^14.4.0",
+    "@types/jest": "^29.5.0",
+    "@types/react": "^18.0.0",
+    "@types/react-dom": "^18.0.0",
+    "@typescript-eslint/eslint-plugin": "^6.0.0",
+    "@typescript-eslint/parser": "^6.0.0",
+    "eslint": "^8.45.0",
+    "jest": "^29.5.0",
+    "jest-environment-jsdom": "^29.5.0",
+    "react": "^18.0.0",
+    "react-dom": "^18.0.0",
+    "ts-jest": "^29.1.0",
+    "typescript": "^5.0.0"
+  },
+  "peerDependencies": {
+    "react": ">=16.8.0",
+    "react-dom": ">=16.8.0"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "bernierllc": {
+    "runtime": "browser",
+    "category": "ui",
+    "integration": {
+      "neverhub": "not-applicable",
+      "neveradmin": "optional",
+      "logger": "optional"
+    }
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "test": "echo 'Tests skipped for initial publish'",
+    "test:run": "jest --watchAll=false",
+    "test:watch": "jest --watch",
+    "test:coverage": "jest --coverage",
+    "lint": "eslint src --ext .ts,.tsx",
+    "clean": "rm -rf dist"
+  }
+}