autotel-devtools 6.1.1 → 6.2.0

package/dist/error-aggregator-Cs3n0f2s.d.ts

@@ -0,0 +1,147 @@
+import { c as ErrorOccurrence, E as ErrorGroup, T as TraceData } from './exporter-C2XmGnBS.js';
+
+/**
+ * Error Aggregator
+ *
+ * Groups similar errors together based on stack trace fingerprinting.
+ * Tracks error frequency, first/last occurrence, and affected traces.
+ *
+ * @example
+ * ```typescript
+ * const aggregator = new ErrorAggregator({ maxGroups: 100 });
+ *
+ * // Add errors from spans
+ * aggregator.addError({
+ *   traceId: '123',
+ *   spanId: '456',
+ *   spanName: 'api.createUser',
+ *   service: 'user-service',
+ *   timestamp: Date.now(),
+ *   error: {
+ *     type: 'ValidationError',
+ *     message: 'Invalid email format',
+ *     stackTrace: 'Error: Invalid email...'
+ *   }
+ * });
+ *
+ * // Get aggregated error groups
+ * const groups = aggregator.getErrorGroups();
+ * ```
+ */
+
+interface ErrorAggregatorOptions {
+    /**
+     * Maximum number of error groups to track (default: 100)
+     * Oldest groups are evicted when limit is reached
+     */
+    maxGroups?: number;
+    /**
+     * Maximum number of affected traces to keep per group (default: 10)
+     */
+    maxAffectedTraces?: number;
+    /**
+     * Maximum number of affected span names to keep per group (default: 5)
+     */
+    maxAffectedSpans?: number;
+    /**
+     * Number of stack frames to use for fingerprinting (default: 5)
+     */
+    stackFramesForFingerprint?: number;
+}
+declare class ErrorAggregator {
+    private errorGroups;
+    private options;
+    constructor(options?: ErrorAggregatorOptions);
+    /**
+     * Add an error occurrence to the aggregator
+     */
+    addError(occurrence: ErrorOccurrence): ErrorGroup;
+    /**
+     * Extract errors from a trace and add them to the aggregator
+     */
+    addErrorsFromTrace(trace: TraceData): ErrorGroup[];
+    /**
+     * Extract error occurrence from a span
+     */
+    private extractErrorFromSpan;
+    /**
+     * Extract stack trace from span events (exception events)
+     */
+    private extractStackFromEvents;
+    /**
+     * Extract relevant attributes for error context
+     */
+    private extractRelevantAttributes;
+    /**
+     * Generate a fingerprint for error grouping
+     *
+     * Uses error type + first N stack frames (normalized)
+     */
+    private generateFingerprint;
+    /**
+     * Extract and normalize stack frames from a stack trace
+     */
+    private extractStackFrames;
+    /**
+     * Normalize file path by removing absolute path prefixes and node_modules paths
+     */
+    private normalizeFilePath;
+    /**
+     * Normalize error message by removing dynamic parts
+     */
+    private normalizeMessage;
+    /**
+     * Normalize stack trace for display
+     */
+    private normalizeStackTrace;
+    /**
+     * Simple hash function for fingerprinting
+     */
+    private simpleHash;
+    /**
+     * Evict the oldest error group
+     */
+    private evictOldestGroup;
+    /**
+     * Get all error groups, sorted by most recent
+     */
+    getErrorGroups(): ErrorGroup[];
+    /**
+     * Get error groups sorted by count (most frequent first)
+     */
+    getErrorGroupsByFrequency(): ErrorGroup[];
+    /**
+     * Get a specific error group by fingerprint
+     */
+    getErrorGroup(fingerprint: string): ErrorGroup | undefined;
+    /**
+     * Get error groups for a specific service
+     */
+    getErrorGroupsByService(service: string): ErrorGroup[];
+    /**
+     * Get total error count across all groups
+     */
+    getTotalErrorCount(): number;
+    /**
+     * Get error statistics
+     */
+    getStats(): {
+        totalGroups: number;
+        totalErrors: number;
+        recentErrors: number;
+        topErrorTypes: Array<{
+            type: string;
+            count: number;
+        }>;
+    };
+    /**
+     * Clear all error groups
+     */
+    clear(): void;
+    /**
+     * Clear old error groups (not seen in given time window)
+     */
+    clearOlderThan(maxAgeMs: number): number;
+}
+
+export { ErrorAggregator as E };

package/dist/error-aggregator-CtZmjm-k.d.cts

@@ -0,0 +1,147 @@
+import { c as ErrorOccurrence, E as ErrorGroup, T as TraceData } from './exporter-qIQPDw29.cjs';
+
+/**
+ * Error Aggregator
+ *
+ * Groups similar errors together based on stack trace fingerprinting.
+ * Tracks error frequency, first/last occurrence, and affected traces.
+ *
+ * @example
+ * ```typescript
+ * const aggregator = new ErrorAggregator({ maxGroups: 100 });
+ *
+ * // Add errors from spans
+ * aggregator.addError({
+ *   traceId: '123',
+ *   spanId: '456',
+ *   spanName: 'api.createUser',
+ *   service: 'user-service',
+ *   timestamp: Date.now(),
+ *   error: {
+ *     type: 'ValidationError',
+ *     message: 'Invalid email format',
+ *     stackTrace: 'Error: Invalid email...'
+ *   }
+ * });
+ *
+ * // Get aggregated error groups
+ * const groups = aggregator.getErrorGroups();
+ * ```
+ */
+
+interface ErrorAggregatorOptions {
+    /**
+     * Maximum number of error groups to track (default: 100)
+     * Oldest groups are evicted when limit is reached
+     */
+    maxGroups?: number;
+    /**
+     * Maximum number of affected traces to keep per group (default: 10)
+     */
+    maxAffectedTraces?: number;
+    /**
+     * Maximum number of affected span names to keep per group (default: 5)
+     */
+    maxAffectedSpans?: number;
+    /**
+     * Number of stack frames to use for fingerprinting (default: 5)
+     */
+    stackFramesForFingerprint?: number;
+}
+declare class ErrorAggregator {
+    private errorGroups;
+    private options;
+    constructor(options?: ErrorAggregatorOptions);
+    /**
+     * Add an error occurrence to the aggregator
+     */
+    addError(occurrence: ErrorOccurrence): ErrorGroup;
+    /**
+     * Extract errors from a trace and add them to the aggregator
+     */
+    addErrorsFromTrace(trace: TraceData): ErrorGroup[];
+    /**
+     * Extract error occurrence from a span
+     */
+    private extractErrorFromSpan;
+    /**
+     * Extract stack trace from span events (exception events)
+     */
+    private extractStackFromEvents;
+    /**
+     * Extract relevant attributes for error context
+     */
+    private extractRelevantAttributes;
+    /**
+     * Generate a fingerprint for error grouping
+     *
+     * Uses error type + first N stack frames (normalized)
+     */
+    private generateFingerprint;
+    /**
+     * Extract and normalize stack frames from a stack trace
+     */
+    private extractStackFrames;
+    /**
+     * Normalize file path by removing absolute path prefixes and node_modules paths
+     */
+    private normalizeFilePath;
+    /**
+     * Normalize error message by removing dynamic parts
+     */
+    private normalizeMessage;
+    /**
+     * Normalize stack trace for display
+     */
+    private normalizeStackTrace;
+    /**
+     * Simple hash function for fingerprinting
+     */
+    private simpleHash;
+    /**
+     * Evict the oldest error group
+     */
+    private evictOldestGroup;
+    /**
+     * Get all error groups, sorted by most recent
+     */
+    getErrorGroups(): ErrorGroup[];
+    /**
+     * Get error groups sorted by count (most frequent first)
+     */
+    getErrorGroupsByFrequency(): ErrorGroup[];
+    /**
+     * Get a specific error group by fingerprint
+     */
+    getErrorGroup(fingerprint: string): ErrorGroup | undefined;
+    /**
+     * Get error groups for a specific service
+     */
+    getErrorGroupsByService(service: string): ErrorGroup[];
+    /**
+     * Get total error count across all groups
+     */
+    getTotalErrorCount(): number;
+    /**
+     * Get error statistics
+     */
+    getStats(): {
+        totalGroups: number;
+        totalErrors: number;
+        recentErrors: number;
+        topErrorTypes: Array<{
+            type: string;
+            count: number;
+        }>;
+    };
+    /**
+     * Clear all error groups
+     */
+    clear(): void;
+    /**
+     * Clear old error groups (not seen in given time window)
+     */
+    clearOlderThan(maxAgeMs: number): number;
+}
+
+export { ErrorAggregator as E };

package/dist/error-aggregator-DqB90tTq.d.cts

@@ -0,0 +1,147 @@
+import { c as ErrorOccurrence, E as ErrorGroup, T as TraceData } from './exporter-Cui3gZsI.cjs';
+
+/**
+ * Error Aggregator
+ *
+ * Groups similar errors together based on stack trace fingerprinting.
+ * Tracks error frequency, first/last occurrence, and affected traces.
+ *
+ * @example
+ * ```typescript
+ * const aggregator = new ErrorAggregator({ maxGroups: 100 });
+ *
+ * // Add errors from spans
+ * aggregator.addError({
+ *   traceId: '123',
+ *   spanId: '456',
+ *   spanName: 'api.createUser',
+ *   service: 'user-service',
+ *   timestamp: Date.now(),
+ *   error: {
+ *     type: 'ValidationError',
+ *     message: 'Invalid email format',
+ *     stackTrace: 'Error: Invalid email...'
+ *   }
+ * });
+ *
+ * // Get aggregated error groups
+ * const groups = aggregator.getErrorGroups();
+ * ```
+ */
+
+interface ErrorAggregatorOptions {
+    /**
+     * Maximum number of error groups to track (default: 100)
+     * Oldest groups are evicted when limit is reached
+     */
+    maxGroups?: number;
+    /**
+     * Maximum number of affected traces to keep per group (default: 10)
+     */
+    maxAffectedTraces?: number;
+    /**
+     * Maximum number of affected span names to keep per group (default: 5)
+     */
+    maxAffectedSpans?: number;
+    /**
+     * Number of stack frames to use for fingerprinting (default: 5)
+     */
+    stackFramesForFingerprint?: number;
+}
+declare class ErrorAggregator {
+    private errorGroups;
+    private options;
+    constructor(options?: ErrorAggregatorOptions);
+    /**
+     * Add an error occurrence to the aggregator
+     */
+    addError(occurrence: ErrorOccurrence): ErrorGroup;
+    /**
+     * Extract errors from a trace and add them to the aggregator
+     */
+    addErrorsFromTrace(trace: TraceData): ErrorGroup[];
+    /**
+     * Extract error occurrence from a span
+     */
+    private extractErrorFromSpan;
+    /**
+     * Extract stack trace from span events (exception events)
+     */
+    private extractStackFromEvents;
+    /**
+     * Extract relevant attributes for error context
+     */
+    private extractRelevantAttributes;
+    /**
+     * Generate a fingerprint for error grouping
+     *
+     * Uses error type + first N stack frames (normalized)
+     */
+    private generateFingerprint;
+    /**
+     * Extract and normalize stack frames from a stack trace
+     */
+    private extractStackFrames;
+    /**
+     * Normalize file path by removing absolute path prefixes and node_modules paths
+     */
+    private normalizeFilePath;
+    /**
+     * Normalize error message by removing dynamic parts
+     */
+    private normalizeMessage;
+    /**
+     * Normalize stack trace for display
+     */
+    private normalizeStackTrace;
+    /**
+     * Simple hash function for fingerprinting
+     */
+    private simpleHash;
+    /**
+     * Evict the oldest error group
+     */
+    private evictOldestGroup;
+    /**
+     * Get all error groups, sorted by most recent
+     */
+    getErrorGroups(): ErrorGroup[];
+    /**
+     * Get error groups sorted by count (most frequent first)
+     */
+    getErrorGroupsByFrequency(): ErrorGroup[];
+    /**
+     * Get a specific error group by fingerprint
+     */
+    getErrorGroup(fingerprint: string): ErrorGroup | undefined;
+    /**
+     * Get error groups for a specific service
+     */
+    getErrorGroupsByService(service: string): ErrorGroup[];
+    /**
+     * Get total error count across all groups
+     */
+    getTotalErrorCount(): number;
+    /**
+     * Get error statistics
+     */
+    getStats(): {
+        totalGroups: number;
+        totalErrors: number;
+        recentErrors: number;
+        topErrorTypes: Array<{
+            type: string;
+            count: number;
+        }>;
+    };
+    /**
+     * Clear all error groups
+     */
+    clear(): void;
+    /**
+     * Clear old error groups (not seen in given time window)
+     */
+    clearOlderThan(maxAgeMs: number): number;
+}
+
+export { ErrorAggregator as E };

package/dist/error-aggregator-zhZGcmno.d.ts

@@ -0,0 +1,147 @@
+import { c as ErrorOccurrence, E as ErrorGroup, T as TraceData } from './exporter-CyzRMJ6C.js';
+
+/**
+ * Error Aggregator
+ *
+ * Groups similar errors together based on stack trace fingerprinting.
+ * Tracks error frequency, first/last occurrence, and affected traces.
+ *
+ * @example
+ * ```typescript
+ * const aggregator = new ErrorAggregator({ maxGroups: 100 });
+ *
+ * // Add errors from spans
+ * aggregator.addError({
+ *   traceId: '123',
+ *   spanId: '456',
+ *   spanName: 'api.createUser',
+ *   service: 'user-service',
+ *   timestamp: Date.now(),
+ *   error: {
+ *     type: 'ValidationError',
+ *     message: 'Invalid email format',
+ *     stackTrace: 'Error: Invalid email...'
+ *   }
+ * });
+ *
+ * // Get aggregated error groups
+ * const groups = aggregator.getErrorGroups();
+ * ```
+ */
+
+interface ErrorAggregatorOptions {
+    /**
+     * Maximum number of error groups to track (default: 100)
+     * Oldest groups are evicted when limit is reached
+     */
+    maxGroups?: number;
+    /**
+     * Maximum number of affected traces to keep per group (default: 10)
+     */
+    maxAffectedTraces?: number;
+    /**
+     * Maximum number of affected span names to keep per group (default: 5)
+     */
+    maxAffectedSpans?: number;
+    /**
+     * Number of stack frames to use for fingerprinting (default: 5)
+     */
+    stackFramesForFingerprint?: number;
+}
+declare class ErrorAggregator {
+    private errorGroups;
+    private options;
+    constructor(options?: ErrorAggregatorOptions);
+    /**
+     * Add an error occurrence to the aggregator
+     */
+    addError(occurrence: ErrorOccurrence): ErrorGroup;
+    /**
+     * Extract errors from a trace and add them to the aggregator
+     */
+    addErrorsFromTrace(trace: TraceData): ErrorGroup[];
+    /**
+     * Extract error occurrence from a span
+     */
+    private extractErrorFromSpan;
+    /**
+     * Extract stack trace from span events (exception events)
+     */
+    private extractStackFromEvents;
+    /**
+     * Extract relevant attributes for error context
+     */
+    private extractRelevantAttributes;
+    /**
+     * Generate a fingerprint for error grouping
+     *
+     * Uses error type + first N stack frames (normalized)
+     */
+    private generateFingerprint;
+    /**
+     * Extract and normalize stack frames from a stack trace
+     */
+    private extractStackFrames;
+    /**
+     * Normalize file path by removing absolute path prefixes and node_modules paths
+     */
+    private normalizeFilePath;
+    /**
+     * Normalize error message by removing dynamic parts
+     */
+    private normalizeMessage;
+    /**
+     * Normalize stack trace for display
+     */
+    private normalizeStackTrace;
+    /**
+     * Simple hash function for fingerprinting
+     */
+    private simpleHash;
+    /**
+     * Evict the oldest error group
+     */
+    private evictOldestGroup;
+    /**
+     * Get all error groups, sorted by most recent
+     */
+    getErrorGroups(): ErrorGroup[];
+    /**
+     * Get error groups sorted by count (most frequent first)
+     */
+    getErrorGroupsByFrequency(): ErrorGroup[];
+    /**
+     * Get a specific error group by fingerprint
+     */
+    getErrorGroup(fingerprint: string): ErrorGroup | undefined;
+    /**
+     * Get error groups for a specific service
+     */
+    getErrorGroupsByService(service: string): ErrorGroup[];
+    /**
+     * Get total error count across all groups
+     */
+    getTotalErrorCount(): number;
+    /**
+     * Get error statistics
+     */
+    getStats(): {
+        totalGroups: number;
+        totalErrors: number;
+        recentErrors: number;
+        topErrorTypes: Array<{
+            type: string;
+            count: number;
+        }>;
+    };
+    /**
+     * Clear all error groups
+     */
+    clear(): void;
+    /**
+     * Clear old error groups (not seen in given time window)
+     */
+    clearOlderThan(maxAgeMs: number): number;
+}
+
+export { ErrorAggregator as E };