@nicomatt69/streamtty 0.0.1

package/dist/errors.js

@@ -0,0 +1,346 @@
+"use strict";
+/**
+ * Comprehensive Error Handling
+ *
+ * This module provides enterprise-level error handling for streamtty,
+ * including custom error classes, graceful degradation, and safe rendering.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ErrorRecovery = exports.SafeOperation = exports.DefaultErrorHandler = exports.StreamttyPerformanceError = exports.StreamttyTTYError = exports.StreamttyConfigError = exports.StreamttyAISDKError = exports.StreamttyRenderError = exports.StreamttyParseError = exports.StreamttyError = void 0;
+exports.setupGlobalErrorHandling = setupGlobalErrorHandling;
+/**
+ * Base error class for all streamtty errors
+ */
+class StreamttyError extends Error {
+    code;
+    timestamp;
+    context;
+    constructor(message, code = 'STREAMTTY_ERROR', context) {
+        super(message);
+        this.name = 'StreamttyError';
+        this.code = code;
+        this.timestamp = Date.now();
+        this.context = context;
+        // Maintain proper stack trace
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, StreamttyError);
+        }
+    }
+}
+exports.StreamttyError = StreamttyError;
+/**
+ * Parser-related errors
+ */
+class StreamttyParseError extends StreamttyError {
+    chunk;
+    position;
+    constructor(message, chunk, position, context) {
+        super(message, 'PARSE_ERROR', { chunk, position, ...context });
+        this.name = 'StreamttyParseError';
+        this.chunk = chunk;
+        this.position = position;
+    }
+}
+exports.StreamttyParseError = StreamttyParseError;
+/**
+ * Renderer-related errors
+ */
+class StreamttyRenderError extends StreamttyError {
+    tokens;
+    renderContext;
+    constructor(message, tokens, renderContext, context) {
+        super(message, 'RENDER_ERROR', { tokens, renderContext, ...context });
+        this.name = 'StreamttyRenderError';
+        this.tokens = tokens;
+        this.renderContext = renderContext;
+    }
+}
+exports.StreamttyRenderError = StreamttyRenderError;
+/**
+ * AI SDK adapter errors
+ */
+class StreamttyAISDKError extends StreamttyError {
+    event;
+    adapterContext;
+    constructor(message, event, adapterContext, context) {
+        super(message, 'AI_SDK_ERROR', { event, adapterContext, ...context });
+        this.name = 'StreamttyAISDKError';
+        this.event = event;
+        this.adapterContext = adapterContext;
+    }
+}
+exports.StreamttyAISDKError = StreamttyAISDKError;
+/**
+ * Configuration errors
+ */
+class StreamttyConfigError extends StreamttyError {
+    option;
+    value;
+    constructor(message, option, value, context) {
+        super(message, 'CONFIG_ERROR', { option, value, ...context });
+        this.name = 'StreamttyConfigError';
+        this.option = option;
+        this.value = value;
+    }
+}
+exports.StreamttyConfigError = StreamttyConfigError;
+/**
+ * Blessed/TTY related errors
+ */
+class StreamttyTTYError extends StreamttyError {
+    ttyOperation;
+    blessedContext;
+    constructor(message, ttyOperation, blessedContext, context) {
+        super(message, 'TTY_ERROR', { ttyOperation, blessedContext, ...context });
+        this.name = 'StreamttyTTYError';
+        this.ttyOperation = ttyOperation;
+        this.blessedContext = blessedContext;
+    }
+}
+exports.StreamttyTTYError = StreamttyTTYError;
+/**
+ * Performance-related errors
+ */
+class StreamttyPerformanceError extends StreamttyError {
+    operation;
+    duration;
+    threshold;
+    constructor(message, operation, duration, threshold, context) {
+        super(message, 'PERFORMANCE_ERROR', { operation, duration, threshold, ...context });
+        this.name = 'StreamttyPerformanceError';
+        this.operation = operation;
+        this.duration = duration;
+        this.threshold = threshold;
+    }
+}
+exports.StreamttyPerformanceError = StreamttyPerformanceError;
+/**
+ * Default error handler implementation
+ */
+class DefaultErrorHandler {
+    maxRetries = 3;
+    fallbackEnabled = true;
+    constructor(options = {}) {
+        this.maxRetries = options.maxRetries ?? 3;
+        this.fallbackEnabled = options.fallbackEnabled ?? true;
+    }
+    handle(error, context) {
+        const errorInfo = this.formatErrorInfo(error, context);
+        // Log error based on severity
+        if (this.isCriticalError(error)) {
+            console.error('🚨 Streamtty Critical Error:', errorInfo);
+        }
+        else if (this.isWarning(error)) {
+            console.warn('⚠️ Streamtty Warning:', errorInfo);
+        }
+        else {
+            console.log('ℹ️ Streamtty Info:', errorInfo);
+        }
+    }
+    shouldRetry(error, attempt) {
+        if (attempt >= this.maxRetries) {
+            return false;
+        }
+        // Don't retry critical errors
+        if (this.isCriticalError(error)) {
+            return false;
+        }
+        // Retry transient errors
+        if (error instanceof StreamttyParseError ||
+            error instanceof StreamttyRenderError) {
+            return true;
+        }
+        return false;
+    }
+    shouldFallback(error) {
+        if (!this.fallbackEnabled) {
+            return false;
+        }
+        // Fallback for rendering errors
+        if (error instanceof StreamttyRenderError) {
+            return true;
+        }
+        // Fallback for AI SDK errors
+        if (error instanceof StreamttyAISDKError) {
+            return true;
+        }
+        return false;
+    }
+    formatErrorInfo(error, context) {
+        const baseInfo = {
+            name: error.name,
+            message: error.message,
+            timestamp: new Date().toISOString()
+        };
+        if (error instanceof StreamttyError) {
+            return JSON.stringify({
+                ...baseInfo,
+                code: error.code,
+                context: error.context,
+                additionalContext: context
+            }, null, 2);
+        }
+        return JSON.stringify({
+            ...baseInfo,
+            additionalContext: context
+        }, null, 2);
+    }
+    isCriticalError(error) {
+        if (error instanceof StreamttyTTYError) {
+            return true;
+        }
+        if (error instanceof StreamttyConfigError) {
+            return true;
+        }
+        return false;
+    }
+    isWarning(error) {
+        if (error instanceof StreamttyPerformanceError) {
+            return true;
+        }
+        return false;
+    }
+}
+exports.DefaultErrorHandler = DefaultErrorHandler;
+/**
+ * Safe operation wrapper
+ */
+class SafeOperation {
+    errorHandler;
+    retryCount = 0;
+    constructor(errorHandler = new DefaultErrorHandler()) {
+        this.errorHandler = errorHandler;
+    }
+    /**
+     * Execute an operation with error handling and retry logic
+     */
+    async execute(operation, context) {
+        const maxAttempts = 3;
+        for (let attempt = 0; attempt < maxAttempts; attempt++) {
+            try {
+                const result = await operation();
+                this.retryCount = 0; // Reset on success
+                return result;
+            }
+            catch (error) {
+                const err = error instanceof Error ? error : new Error(String(error));
+                this.errorHandler.handle(err, { attempt, ...context });
+                if (this.errorHandler.shouldRetry(err, attempt) && attempt < maxAttempts - 1) {
+                    // Exponential backoff
+                    await this.delay(Math.pow(2, attempt) * 100);
+                    continue;
+                }
+                if (this.errorHandler.shouldFallback(err)) {
+                    return this.executeFallback(operation, err, context);
+                }
+                return null;
+            }
+        }
+        return null;
+    }
+    /**
+     * Execute with fallback
+     */
+    async executeFallback(operation, originalError, context) {
+        try {
+            // Implement fallback logic based on error type
+            if (originalError instanceof StreamttyRenderError) {
+                return this.fallbackRender(originalError, context);
+            }
+            if (originalError instanceof StreamttyAISDKError) {
+                return this.fallbackAISDK(originalError, context);
+            }
+            return null;
+        }
+        catch (fallbackError) {
+            const err = fallbackError instanceof Error ? fallbackError : new Error(String(fallbackError));
+            this.errorHandler.handle(err, {
+                type: 'fallback_failed',
+                originalError: originalError.message,
+                ...context
+            });
+            return null;
+        }
+    }
+    async fallbackRender(error, context) {
+        // Simple text fallback for render errors
+        if (error.tokens && Array.isArray(error.tokens)) {
+            return error.tokens
+                .filter(token => token && token.raw)
+                .map(token => token.raw)
+                .join(' ');
+        }
+        return null;
+    }
+    async fallbackAISDK(error, context) {
+        // Simple text fallback for AI SDK errors
+        if (error.event && error.event.content) {
+            return error.event.content;
+        }
+        return null;
+    }
+    delay(ms) {
+        return new Promise(resolve => setTimeout(resolve, ms));
+    }
+}
+exports.SafeOperation = SafeOperation;
+/**
+ * Error recovery utilities
+ */
+class ErrorRecovery {
+    /**
+     * Attempt to recover from a parsing error
+     */
+    static recoverFromParseError(error, content) {
+        if (!error.chunk) {
+            return content;
+        }
+        // Try to remove the problematic chunk
+        const recovered = content.replace(error.chunk, '[PARSE_ERROR]');
+        return recovered;
+    }
+    /**
+     * Attempt to recover from a render error
+     */
+    static recoverFromRenderError(error, content) {
+        // Simple text recovery
+        return content.replace(/[^\x20-\x7E\n\r\t]/g, '?');
+    }
+    /**
+     * Attempt to recover from an AI SDK error
+     */
+    static recoverFromAISDKError(error) {
+        if (error.event) {
+            switch (error.event.type) {
+                case 'text_delta':
+                    return error.event.content || '';
+                case 'tool_call':
+                    return `Tool: ${error.event.toolName}`;
+                case 'tool_result':
+                    return 'Tool result received';
+                case 'thinking':
+                case 'reasoning':
+                    return `Thinking: ${error.event.content || ''}`;
+                default:
+                    return `Event: ${error.event.type}`;
+            }
+        }
+        return 'AI SDK error occurred';
+    }
+}
+exports.ErrorRecovery = ErrorRecovery;
+/**
+ * Global error handler setup
+ */
+function setupGlobalErrorHandling() {
+    process.on('uncaughtException', (error) => {
+        const handler = new DefaultErrorHandler();
+        handler.handle(error, { type: 'uncaughtException' });
+    });
+    process.on('unhandledRejection', (reason) => {
+        const handler = new DefaultErrorHandler();
+        const error = reason instanceof Error ? reason : new Error(String(reason));
+        handler.handle(error, { type: 'unhandledRejection' });
+    });
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

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

package/dist/events.d.ts

@@ -0,0 +1,185 @@
+/**
+ * Event-Driven Architecture
+ *
+ * This module provides a comprehensive event system for streamtty,
+ * enabling lifecycle hooks, custom event handling, and inter-component communication.
+ */
+import { EventEmitter } from 'events';
+import { StreamEvent } from './types/stream-events';
+/**
+ * Streamtty event types
+ */
+export type StreamttyEventType = 'streamtty:init' | 'streamtty:destroy' | 'streamtty:clear' | 'streamtty:render' | 'streamtty:error' | 'parser:chunk' | 'parser:complete' | 'parser:error' | 'renderer:start' | 'renderer:complete' | 'renderer:error' | 'ai:event' | 'ai:stream_start' | 'ai:stream_complete' | 'ai:stream_error' | 'ui:keypress' | 'ui:scroll' | 'ui:resize' | 'performance:slow' | 'performance:memory' | 'custom';
+/**
+ * Event data interfaces
+ */
+export interface StreamttyEventData {
+    timestamp: number;
+    source: string;
+    context?: Record<string, any>;
+}
+export interface ParserEventData extends StreamttyEventData {
+    chunk?: string;
+    tokens?: any[];
+    error?: Error;
+}
+export interface RendererEventData extends StreamttyEventData {
+    tokens?: any[];
+    duration?: number;
+    error?: Error;
+}
+export interface AIEventData extends StreamttyEventData {
+    event?: StreamEvent;
+    streamId?: string;
+    error?: Error;
+}
+export interface UIEventData extends StreamttyEventData {
+    key?: string;
+    direction?: 'up' | 'down' | 'left' | 'right';
+    delta?: number;
+    dimensions?: {
+        width: number;
+        height: number;
+    };
+}
+export interface PerformanceEventData extends StreamttyEventData {
+    operation: string;
+    duration: number;
+    threshold: number;
+    memoryUsage?: NodeJS.MemoryUsage;
+}
+/**
+ * Event handler types
+ */
+export type StreamttyEventHandler<T = any> = (data: T) => void | Promise<void>;
+export type StreamttyEventFilter<T = any> = (data: T) => boolean;
+/**
+ * Enhanced EventEmitter for Streamtty
+ */
+export declare class StreamttyEventEmitter extends EventEmitter {
+    private eventHistory;
+    private maxHistorySize;
+    private filters;
+    constructor(maxHistorySize?: number);
+    /**
+     * Emit an event with automatic timestamp and history tracking
+     */
+    emit(event: string, data?: any): boolean;
+    /**
+     * Add event listener with optional filter
+     */
+    on<T = any>(event: string, handler: StreamttyEventHandler<T>, filter?: StreamttyEventFilter<T>): this;
+    /**
+     * Add one-time event listener
+     */
+    once<T = any>(event: string, handler: StreamttyEventHandler<T>, filter?: StreamttyEventFilter<T>): this;
+    /**
+     * Add event filter
+     */
+    addFilter<T = any>(event: string, filter: StreamttyEventFilter<T>): this;
+    /**
+     * Remove event filter
+     */
+    removeFilter(event: string, filter?: StreamttyEventFilter): this;
+    /**
+     * Get event history
+     */
+    getHistory(event?: string, limit?: number): Array<{
+        type: string;
+        data: any;
+        timestamp: number;
+    }>;
+    /**
+     * Clear event history
+     */
+    clearHistory(): this;
+    /**
+     * Get event statistics
+     */
+    getEventStats(): Record<string, number>;
+    private shouldFilterEvent;
+    private addToHistory;
+}
+/**
+ * Event Bus for inter-component communication
+ */
+export declare class StreamttyEventBus extends StreamttyEventEmitter {
+    private components;
+    /**
+     * Register a component
+     */
+    registerComponent(name: string, component: EventEmitter): this;
+    /**
+     * Unregister a component
+     */
+    unregisterComponent(name: string): this;
+    /**
+     * Get a registered component
+     */
+    getComponent<T extends EventEmitter = EventEmitter>(name: string): T | undefined;
+    /**
+     * Broadcast event to all components
+     */
+    broadcast(event: string, data?: any): this;
+}
+/**
+ * Lifecycle event manager
+ */
+export declare class StreamttyLifecycle {
+    private eventBus;
+    private hooks;
+    constructor(eventBus: StreamttyEventBus);
+    /**
+     * Register a lifecycle hook
+     */
+    on(event: StreamttyEventType, handler: StreamttyEventHandler): this;
+    /**
+     * Remove a lifecycle hook
+     */
+    off(event: StreamttyEventType, handler: StreamttyEventHandler): this;
+    /**
+     * Trigger a lifecycle event
+     */
+    trigger(event: StreamttyEventType, data?: any): Promise<void>;
+    /**
+     * Trigger multiple lifecycle events
+     */
+    triggerMultiple(events: Array<{
+        event: StreamttyEventType;
+        data?: any;
+    }>): Promise<void>;
+}
+/**
+ * Event utilities
+ */
+export declare class EventUtils {
+    /**
+     * Create a debounced event handler
+     */
+    static debounce<T>(handler: StreamttyEventHandler<T>, delay: number): StreamttyEventHandler<T>;
+    /**
+     * Create a throttled event handler
+     */
+    static throttle<T>(handler: StreamttyEventHandler<T>, delay: number): StreamttyEventHandler<T>;
+    /**
+     * Create a retry event handler
+     */
+    static retry<T>(handler: StreamttyEventHandler<T>, maxRetries?: number, delay?: number): StreamttyEventHandler<T>;
+    /**
+     * Create a conditional event handler
+     */
+    static conditional<T>(condition: (data: T) => boolean, handler: StreamttyEventHandler<T>): StreamttyEventHandler<T>;
+    /**
+     * Create a chain of event handlers
+     */
+    static chain<T>(...handlers: StreamttyEventHandler<T>[]): StreamttyEventHandler<T>;
+}
+/**
+ * Global event bus instance
+ */
+export declare const globalEventBus: StreamttyEventBus;
+/**
+ * Setup global error handling for events
+ */
+export declare function setupEventErrorHandling(): void;
+//# sourceMappingURL=events.d.ts.map

package/dist/events.d.ts.map

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