@tachui/core 0.7.0-alpha1

package/dist/runtime/error-reporting.d.ts

@@ -0,0 +1,287 @@
+/**
+ * Error Reporting and Logging System (Phase 3.2.3)
+ *
+ * Advanced error reporting, logging, and analytics for TachUI.
+ * Provides structured logging, error aggregation, and reporting pipelines.
+ */
+import { type ErrorCategory, type ErrorSeverity, type TachUIError } from './error-boundary';
+/**
+ * Log levels
+ */
+export type LogLevel = 'debug' | 'info' | 'warn' | 'error' | 'fatal';
+/**
+ * Log entry structure
+ */
+export interface LogEntry {
+    id: string;
+    timestamp: number;
+    level: LogLevel;
+    message: string;
+    category?: string;
+    componentId?: string;
+    componentName?: string;
+    context?: Record<string, any>;
+    stack?: string;
+    userAgent?: string;
+    url?: string;
+    userId?: string;
+    sessionId?: string;
+    tags?: string[];
+}
+/**
+ * Error aggregation data
+ */
+export interface ErrorAggregation {
+    id: string;
+    message: string;
+    category: ErrorCategory;
+    severity: ErrorSeverity;
+    count: number;
+    firstSeen: number;
+    lastSeen: number;
+    affectedComponents: string[];
+    samples: TachUIError[];
+    fingerprint: string;
+}
+/**
+ * Logger interface
+ */
+export interface Logger {
+    debug(message: string, context?: Record<string, any>): void;
+    info(message: string, context?: Record<string, any>): void;
+    warn(message: string, context?: Record<string, any>): void;
+    error(message: string, context?: Record<string, any>): void;
+    fatal(message: string, context?: Record<string, any>): void;
+    log(level: LogLevel, message: string, context?: Record<string, any>): void;
+}
+/**
+ * Report destination interface
+ */
+export interface ReportDestination {
+    name: string;
+    send(data: LogEntry[] | ErrorAggregation[]): Promise<void>;
+    isEnabled(): boolean;
+}
+/**
+ * Reporting configuration
+ */
+export interface ReportingConfig {
+    enabled: boolean;
+    logLevel: LogLevel;
+    batchSize: number;
+    batchTimeout: number;
+    aggregationWindow: number;
+    maxRetries: number;
+    destinations: ReportDestination[];
+    enableContextCapture: boolean;
+    enableStackTrace: boolean;
+    enableUserTracking: boolean;
+    enableSessionTracking: boolean;
+    sensitiveKeys: string[];
+    enableCompression: boolean;
+}
+/**
+ * Structured logger implementation
+ */
+export declare class StructuredLogger implements Logger {
+    private entries;
+    private config;
+    private sessionId;
+    private userId?;
+    private entriesSignal;
+    private setEntries;
+    constructor(config?: Partial<ReportingConfig>);
+    /**
+     * Debug level logging
+     */
+    debug(message: string, context?: Record<string, any>): void;
+    /**
+     * Info level logging
+     */
+    info(message: string, context?: Record<string, any>): void;
+    /**
+     * Warning level logging
+     */
+    warn(message: string, context?: Record<string, any>): void;
+    /**
+     * Error level logging
+     */
+    error(message: string, context?: Record<string, any>): void;
+    /**
+     * Fatal level logging
+     */
+    fatal(message: string, context?: Record<string, any>): void;
+    /**
+     * Generic logging method
+     */
+    log(level: LogLevel, message: string, context?: Record<string, any>): void;
+    /**
+     * Check if should log at given level
+     */
+    private shouldLog;
+    /**
+     * Add log entry
+     */
+    private addEntry;
+    /**
+     * Sanitize context to remove sensitive data
+     */
+    private sanitizeContext;
+    /**
+     * Setup batch processing
+     */
+    private setupBatchProcessing;
+    /**
+     * Flush current batch of log entries
+     */
+    private flushBatch;
+    /**
+     * Send data with retry logic
+     */
+    private sendWithRetry;
+    /**
+     * Sleep for specified duration
+     */
+    private sleep;
+    /**
+     * Generate unique ID
+     */
+    private generateId;
+    /**
+     * Generate session ID
+     */
+    private generateSessionId;
+    /**
+     * Set user ID for tracking
+     */
+    setUserId(userId: string): void;
+    /**
+     * Get log entries
+     */
+    getEntries(): LogEntry[];
+    /**
+     * Get entries signal
+     */
+    getEntriesSignal(): () => LogEntry[];
+    /**
+     * Add destination
+     */
+    addDestination(destination: ReportDestination): void;
+    /**
+     * Remove destination
+     */
+    removeDestination(name: string): void;
+    /**
+     * Clear all log entries
+     */
+    clear(): void;
+}
+/**
+ * Error aggregator
+ */
+export declare class ErrorAggregator {
+    private aggregations;
+    private config;
+    private aggregationsSignal;
+    private setAggregations;
+    constructor(config?: Partial<ReportingConfig>);
+    /**
+     * Aggregate error
+     */
+    aggregateError(error: TachUIError): void;
+    /**
+     * Generate error fingerprint for grouping
+     */
+    private generateFingerprint;
+    /**
+     * Setup cleanup of old aggregations
+     */
+    private setupCleanup;
+    /**
+     * Cleanup old aggregations
+     */
+    private cleanupOldAggregations;
+    /**
+     * Get aggregations
+     */
+    getAggregations(): ErrorAggregation[];
+    /**
+     * Get aggregations signal
+     */
+    getAggregationsSignal(): () => ErrorAggregation[];
+    /**
+     * Get top errors by count
+     */
+    getTopErrors(limit?: number): ErrorAggregation[];
+    /**
+     * Clear aggregations
+     */
+    clear(): void;
+}
+/**
+ * Built-in report destinations
+ */
+export declare const reportDestinations: {
+    /**
+     * Console destination
+     */
+    console: ReportDestination;
+    /**
+     * Local storage destination
+     */
+    localStorage: ReportDestination;
+    /**
+     * Create HTTP destination
+     */
+    createHttpDestination(endpoint: string, apiKey?: string): ReportDestination;
+    /**
+     * Create webhook destination
+     */
+    createWebhookDestination(webhookUrl: string, options?: {
+        format?: "slack" | "discord" | "teams" | "generic";
+        onlyErrors?: boolean;
+    }): ReportDestination;
+};
+/**
+ * Global logger instance
+ */
+export declare const globalLogger: StructuredLogger;
+/**
+ * Global error aggregator
+ */
+export declare const globalErrorAggregator: ErrorAggregator;
+/**
+ * Setup error reporting integration
+ */
+export declare function setupErrorReporting(config?: Partial<ReportingConfig>): void;
+/**
+ * Reporting utilities
+ */
+export declare const reportingUtils: {
+    /**
+     * Setup development reporting
+     */
+    setupDevelopment(): void;
+    /**
+     * Setup production reporting
+     */
+    setupProduction(config: {
+        endpoint?: string;
+        apiKey?: string;
+        webhookUrl?: string;
+        logLevel?: LogLevel;
+    }): void;
+    /**
+     * Create custom logger
+     */
+    createLogger(name: string, config?: Partial<ReportingConfig>): Logger;
+    /**
+     * Get error report
+     */
+    getErrorReport(): {
+        logs: LogEntry[];
+        aggregations: ErrorAggregation[];
+        statistics: any;
+    };
+};
+//# sourceMappingURL=error-reporting.d.ts.map

package/dist/runtime/error-reporting.d.ts.map

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