@widgetic/chat 0.1.4

package/dist/types/conversation.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Conversation shape exchanged with the conversations API
+ * (camelCase wire contract of the co-editor chat).
+ */
+export interface ChatConversation {
+    id: string;
+    title: string;
+    completed: boolean;
+    createdAt: Date;
+    updatedAt: Date;
+    _unreadCount?: number;
+    _lastActivity?: Date;
+    _isActive?: boolean;
+}
+/**
+ * Conversation input for creating new conversations
+ */
+export interface ConversationInput {
+    componentId: string;
+    title?: string;
+    completed?: boolean;
+}
+/**
+ * Conversation status options
+ */
+export type ConversationStatus = 'active' | 'completed' | 'archived';
+/**
+ * Conversation filters for listing
+ */
+export interface ConversationFilters {
+    status?: ConversationStatus;
+    completed?: boolean;
+    search?: string;
+    contextId?: string;
+}
+/**
+ * Conversation summary for display
+ */
+export interface ConversationSummary {
+    id: string;
+    title: string;
+    messageCount: number;
+    lastMessage?: string;
+    updatedAt: string;
+}

package/dist/types/conversation.js

@@ -0,0 +1 @@
+export {};

package/dist/types/events.d.ts

@@ -0,0 +1,141 @@
+import type { ChatMessage } from './message.js';
+import type { ChatConversation } from './conversation.js';
+import type { ChatContext } from './context.js';
+/**
+ * Chat event types for internal communication
+ */
+export type ChatEventType = 'message:sent' | 'message:received' | 'message:updated' | 'message:deleted' | 'conversation:created' | 'conversation:updated' | 'conversation:deleted' | 'context:selected' | 'context:deselected' | 'context:updated' | 'attachment:uploaded' | 'attachment:failed' | 'upload:progress' | 'recording:started' | 'recording:stopped' | 'screenshot:captured' | 'typing:start' | 'typing:stop' | 'error:occurred' | 'connection:established' | 'connection:lost';
+/**
+ * Base chat event interface
+ */
+export interface ChatEvent {
+    type: ChatEventType;
+    timestamp: Date;
+    contextId?: string;
+    conversationId?: string;
+    userId?: string;
+    data?: any;
+}
+/**
+ * Message-related events
+ */
+export interface MessageEvent extends ChatEvent {
+    type: 'message:sent' | 'message:received' | 'message:updated' | 'message:deleted';
+    data: {
+        message: ChatMessage;
+        messageId?: string;
+        updates?: Partial<ChatMessage>;
+    };
+}
+/**
+ * Conversation-related events
+ */
+export interface ConversationEvent extends ChatEvent {
+    type: 'conversation:created' | 'conversation:updated' | 'conversation:deleted';
+    data: {
+        conversation: ChatConversation;
+        conversationId?: string;
+        updates?: Partial<ChatConversation>;
+    };
+}
+/**
+ * Context-related events
+ */
+export interface ContextEvent extends ChatEvent {
+    type: 'context:selected' | 'context:deselected' | 'context:updated';
+    data: {
+        context: ChatContext;
+        previousContext?: ChatContext;
+    };
+}
+/**
+ * Upload-related events
+ */
+export interface UploadEvent extends ChatEvent {
+    type: 'attachment:uploaded' | 'attachment:failed' | 'upload:progress';
+    data: {
+        attachmentId: string;
+        fileName: string;
+        progress?: number;
+        url?: string;
+        error?: string;
+    };
+}
+/**
+ * Media capture events
+ */
+export interface MediaEvent extends ChatEvent {
+    type: 'recording:started' | 'recording:stopped' | 'screenshot:captured';
+    data: {
+        mediaType: 'video' | 'audio' | 'image';
+        mediaUrl?: string;
+        duration?: number;
+        error?: string;
+    };
+}
+/**
+ * Typing indicator events
+ */
+export interface TypingEvent extends ChatEvent {
+    type: 'typing:start' | 'typing:stop';
+    data: {
+        isTyping: boolean;
+    };
+}
+/**
+ * Error events
+ */
+export interface ErrorEvent extends ChatEvent {
+    type: 'error:occurred';
+    data: {
+        error: Error;
+        code?: string;
+        details?: any;
+    };
+}
+/**
+ * Connection events
+ */
+export interface ConnectionEvent extends ChatEvent {
+    type: 'connection:established' | 'connection:lost';
+    data: {
+        connected: boolean;
+        reason?: string;
+    };
+}
+/**
+ * WebSocket message types for real-time updates
+ */
+export type WebSocketEventType = 'chat:message:new' | 'chat:message:update' | 'chat:conversation:update' | 'chat:typing:start' | 'chat:typing:stop' | 'canvas:frame:selected' | 'canvas:frame:updated';
+/**
+ * WebSocket message structure
+ */
+export interface WebSocketMessage {
+    type: WebSocketEventType;
+    payload: any;
+    timestamp: string;
+    userId?: string;
+    contextId?: string;
+    conversationId?: string;
+}
+/**
+ * Event listener type
+ */
+export type ChatEventListener<T extends ChatEvent = ChatEvent> = (event: T) => void | Promise<void>;
+/**
+ * Event emitter interface
+ */
+export interface ChatEventEmitter {
+    on<T extends ChatEvent>(eventType: T['type'], listener: ChatEventListener<T>): () => void;
+    off<T extends ChatEvent>(eventType: T['type'], listener: ChatEventListener<T>): void;
+    emit<T extends ChatEvent>(event: T): void;
+    once<T extends ChatEvent>(eventType: T['type'], listener: ChatEventListener<T>): () => void;
+}
+/**
+ * Event bus configuration
+ */
+export interface EventBusConfig {
+    maxListeners?: number;
+    enableLogging?: boolean;
+    queueSize?: number;
+}

package/dist/types/events.js

@@ -0,0 +1 @@
+export {};

package/dist/types/index.d.ts

@@ -0,0 +1,16 @@
+export * from './chat.js';
+export * from './context.js';
+export * from './message.js';
+export * from './conversation.js';
+export * from './attachment.js';
+export * from './state.js';
+export * from './config.js';
+export * from './adapter.js';
+export * from './events.js';
+export type { ChatService, ChatInstance, ChatFactory } from './chat.js';
+export type { ChatMessage, MessageInput } from './message.js';
+export type { ChatConversation, ConversationInput } from './conversation.js';
+export type { ChatContext, FrameContext, ContextCapabilities } from './context.js';
+export type { ChatState, ChatAction, InputState, UIState, ActiveContextState, MessageState, ConversationState } from './state.js';
+export type { PlatformAdapter, WidgeticAdapter, AdapterFactory, AdapterConfig } from './adapter.js';
+export type { AttachmentInput, PendingAttachment, AttachmentType, AttachmentValidation, UploadStatus, ProcessedAttachment, FILE_TYPE_CONFIG } from './attachment.js';

package/dist/types/index.js

@@ -0,0 +1,10 @@
+// Core Chat Types
+export * from './chat.js';
+export * from './context.js';
+export * from './message.js';
+export * from './conversation.js';
+export * from './attachment.js';
+export * from './state.js';
+export * from './config.js';
+export * from './adapter.js';
+export * from './events.js';

package/dist/types/message.d.ts

@@ -0,0 +1,82 @@
+/**
+ * Content attachment as stored on a message (mirrors the API's
+ * message_contents/contents join output).
+ */
+export interface ContentItemOutput {
+    id: string;
+    url: string;
+    file_type: string;
+    file_name?: string | null;
+    file_size?: number | null;
+    metadata?: Record<string, any> | null;
+    created_at: string;
+    display_order: number;
+}
+/**
+ * Message shape exchanged with the conversations/messages API
+ * (camelCase wire contract of the co-editor chat).
+ */
+export interface ChatMessage {
+    id: string;
+    conversationId: string;
+    messageContent?: string | null;
+    messageType: 'user' | 'assistant';
+    attachments?: ContentItemOutput[];
+    isCommit?: boolean;
+    userId: string;
+    createdAt: Date;
+    updatedAt: Date;
+    _optimistic?: boolean;
+    _failed?: boolean;
+    _retryCount?: number;
+    _localId?: string;
+    /** When set, this message was undone by a restore-checkpoint. Shown grayed-out in UI. */
+    rolledBackAt?: string | null;
+    /** Latest successful repo commit — show "Head at commit" on this assistant message. */
+    isWidgetHead?: boolean;
+}
+/**
+ * Message input type for creating new messages
+ */
+export interface MessageInput {
+    messageContent?: string | null;
+    messageType: 'user' | 'assistant';
+    attachments?: AttachmentInput[];
+    isCommit?: boolean;
+}
+/**
+ * Attachment input for creating messages
+ */
+export interface AttachmentInput {
+    file: File;
+    preview?: string;
+    uploadProgress?: number;
+    error?: string;
+}
+/**
+ * Message display configuration
+ */
+export interface MessageDisplayOptions {
+    showHeader: boolean;
+    showTimestamp: boolean;
+    showAvatar: boolean;
+    groupConsecutive: boolean;
+}
+/**
+ * Message validation result
+ */
+export interface MessageValidation {
+    hasContent: boolean;
+    hasAttachments: boolean;
+    isValid: boolean;
+    errors: string[];
+}
+/**
+ * Message group for displaying consecutive messages from same sender
+ */
+export interface MessageGroup {
+    messages: ChatMessage[];
+    sender: 'user' | 'assistant';
+    timestamp: Date;
+    showHeader: boolean;
+}

package/dist/types/message.js

@@ -0,0 +1 @@
+export {};

package/dist/types/state.d.ts

@@ -0,0 +1,117 @@
+import type { ChatMessage, AttachmentInput } from './message.js';
+import type { ChatConversation } from './conversation.js';
+import type { ChatContext } from './context.js';
+/**
+ * Active context state
+ */
+export interface ActiveContextState {
+    contextId: string | null;
+    isExpanded: boolean;
+    expandedAt?: Date;
+}
+/**
+ * Input state for the chat interface
+ */
+export interface InputState {
+    text: string;
+    attachments: AttachmentInput[];
+    isRecording: boolean;
+    isSending: boolean;
+    isUploading: boolean;
+    uploadProgress: Record<string, number>;
+    history: string[];
+    historyIndex: number;
+}
+/**
+ * UI state for the chat interface
+ */
+export interface UIState {
+    isExpanded: boolean;
+    isLoading: boolean;
+    activeTab: string;
+    errorMessage: string | null;
+    lastAction: string | null;
+    recordingDuration?: number;
+    recordingStartTime?: Date;
+}
+/**
+ * Message store state
+ */
+export interface MessageState {
+    byConversationId: Record<string, ChatMessage[]>;
+    isLoading: Record<string, boolean>;
+    errors: Record<string, string | null>;
+}
+/**
+ * Conversation store state
+ */
+export interface ConversationState {
+    byContextId: Record<string, ChatConversation[]>;
+    isLoading: Record<string, boolean>;
+    errors: Record<string, string | null>;
+}
+/**
+ * Chat store state combining all sub-states
+ */
+export interface ChatState {
+    activeContext: ActiveContextState;
+    input: InputState;
+    ui: UIState;
+    messages: MessageState;
+    conversations: ConversationState;
+    availableContexts: ChatContext[];
+}
+/**
+ * Store update actions
+ */
+export type ChatAction = {
+    type: 'SET_ACTIVE_CONTEXT';
+    payload: {
+        contextId: string | null;
+        isExpanded?: boolean;
+    };
+} | {
+    type: 'UPDATE_INPUT';
+    payload: Partial<InputState>;
+} | {
+    type: 'UPDATE_UI';
+    payload: Partial<UIState>;
+} | {
+    type: 'ADD_MESSAGE';
+    payload: {
+        conversationId: string;
+        message: ChatMessage;
+    };
+} | {
+    type: 'UPDATE_MESSAGE';
+    payload: {
+        conversationId: string;
+        messageId: string;
+        updates: Partial<ChatMessage>;
+    };
+} | {
+    type: 'ADD_CONVERSATION';
+    payload: {
+        contextId: string;
+        conversation: ChatConversation;
+    };
+} | {
+    type: 'UPDATE_CONVERSATION';
+    payload: {
+        contextId: string;
+        conversationId: string;
+        updates: Partial<ChatConversation>;
+    };
+} | {
+    type: 'SET_LOADING';
+    payload: {
+        key: string;
+        loading: boolean;
+    };
+} | {
+    type: 'SET_ERROR';
+    payload: {
+        key: string;
+        error: string | null;
+    };
+};

package/dist/types/state.js

@@ -0,0 +1 @@
+export {};

package/dist/utils/fileUtils.d.ts

@@ -0,0 +1,93 @@
+import type { AttachmentType, AttachmentValidation, PendingAttachment } from '../types/index.js';
+/**
+ * File type configuration mapping
+ */
+export declare const fileTypeConfig: {
+    image: {
+        type: AttachmentType;
+        icon: string;
+        preview: boolean;
+        accept: string[];
+        maxSize: number;
+    };
+    video: {
+        type: AttachmentType;
+        icon: string;
+        preview: boolean;
+        accept: string[];
+        maxSize: number;
+    };
+    document: {
+        type: AttachmentType;
+        icon: string;
+        preview: boolean;
+        accept: string[];
+        maxSize: number;
+    };
+    other: {
+        type: AttachmentType;
+        icon: string;
+        preview: boolean;
+        accept: string[];
+        maxSize: number;
+    };
+};
+/**
+ * Detect file type from MIME type and file name
+ */
+export declare function detectFileType(mimeType: string, fileName?: string): AttachmentType;
+/**
+ * Validate a file for upload
+ */
+export declare function validateFile(file: File, config?: {
+    maxSize?: number;
+    allowedTypes?: string[];
+}): AttachmentValidation;
+/**
+ * Validate multiple files
+ */
+export declare function validateFiles(files: File[], config?: {
+    maxFiles?: number;
+    maxSize?: number;
+    allowedTypes?: string[];
+}): AttachmentValidation;
+/**
+ * Format file size in human-readable format
+ */
+export declare function formatFileSize(bytes: number): string;
+/**
+ * Get file extension from filename
+ */
+export declare function getFileExtension(filename: string): string;
+/**
+ * Generate unique file ID
+ */
+export declare function generateFileId(): string;
+/**
+ * Create a preview URL for supported file types
+ */
+export declare function createFilePreview(file: File): Promise<string | null>;
+/**
+ * Create a pending attachment from a file
+ */
+export declare function createPendingAttachment(file: File): Promise<PendingAttachment>;
+/**
+ * Get MIME type accept string for file input
+ */
+export declare function getAcceptString(types: AttachmentType[]): string;
+/**
+ * Check if file supports preview
+ */
+export declare function supportsPreview(file: File): boolean;
+/**
+ * Get appropriate icon for file type
+ */
+export declare function getFileIcon(file: File): string;
+/**
+ * Compress image file if needed
+ */
+export declare function compressImage(file: File, options: {
+    maxWidth?: number;
+    maxHeight?: number;
+    quality?: number;
+}): Promise<File>;