autotel-devtools 8.1.1 → 10.0.0

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

@@ -1,147 +0,0 @@
-import { c as ErrorOccurrence, E as ErrorGroup, T as TraceData } from './exporter-De6p4iAD.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-D1Mr221Y.d.cts

@@ -1,147 +0,0 @@
-import { c as ErrorOccurrence, E as ErrorGroup, T as TraceData } from './exporter-De6p4iAD.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/exporter-De6p4iAD.d.cts

@@ -1,182 +0,0 @@
-import { SpanExporter, ReadableSpan } from '@opentelemetry/sdk-trace-base';
-import { ExportResult } from '@opentelemetry/core';
-import { Server } from 'node:http';
-
-interface SpanData {
-    traceId: string;
-    spanId: string;
-    parentSpanId?: string;
-    name: string;
-    kind: 'INTERNAL' | 'SERVER' | 'CLIENT' | 'PRODUCER' | 'CONSUMER';
-    startTime: number;
-    endTime: number;
-    duration: number;
-    attributes: Record<string, any>;
-    status: {
-        code: 'OK' | 'ERROR' | 'UNSET';
-        message?: string;
-    };
-    events?: Array<{
-        name: string;
-        timestamp: number;
-        attributes?: Record<string, any>;
-    }>;
-    links?: Array<{
-        traceId: string;
-        spanId: string;
-        attributes?: Record<string, any>;
-    }>;
-    scope?: {
-        name?: string;
-        version?: string;
-    };
-}
-interface TraceData {
-    traceId: string;
-    correlationId: string;
-    rootSpan: SpanData;
-    spans: SpanData[];
-    startTime: number;
-    endTime: number;
-    duration: number;
-    status: 'OK' | 'ERROR' | 'UNSET';
-    service: string;
-}
-interface LogData {
-    id: string;
-    traceId?: string;
-    spanId?: string;
-    resourceName?: string;
-    severityText?: string;
-    severityNumber?: number;
-    body: string | Record<string, unknown>;
-    timestamp: number;
-    attributes?: Record<string, unknown>;
-    resource?: Record<string, unknown>;
-}
-interface MetricData {
-    type: 'event' | 'funnel' | 'outcome' | 'value';
-    name: string;
-    value?: number;
-    attributes: Record<string, any>;
-    timestamp: number;
-    traceId?: string;
-}
-interface ErrorGroup {
-    fingerprint: string;
-    type: string;
-    message: string;
-    stackTrace?: string;
-    count: number;
-    firstSeen: number;
-    lastSeen: number;
-    affectedTraces: string[];
-    affectedSpans: string[];
-    service?: string;
-    attributes?: Record<string, unknown>;
-}
-interface ErrorOccurrence {
-    traceId: string;
-    spanId: string;
-    spanName: string;
-    service: string;
-    timestamp: number;
-    error: {
-        type: string;
-        message: string;
-        stackTrace?: string;
-    };
-    attributes?: Record<string, unknown>;
-}
-interface DevtoolsData {
-    traces: TraceData[];
-    metrics: MetricData[];
-    logs: LogData[];
-    errors: ErrorGroup[];
-}
-
-interface DevtoolsServerOptions {
-    port?: number;
-    server?: Server;
-    path?: string;
-    verbose?: boolean;
-    maxHistory?: number;
-    maxTraceCount?: number;
-    maxLogCount?: number;
-    maxMetricCount?: number;
-    /**
-     * Bind host, used only to decide the WebSocket origin policy. A loopback host
-     * (the default) enables the DNS-rebinding `Host` check on the live stream; an
-     * explicit non-loopback bind opts out, leaving just the cross-origin check.
-     */
-    host?: string;
-    /**
-     * Called after each ingest, with the incremental data just broadcast to WS
-     * clients. Lets an embedder (e.g. the VS Code extension) react to new
-     * telemetry — refresh its own tree views — while the server owns the buffer.
-     */
-    onData?: (incremental: DevtoolsData) => void;
-}
-declare class DevtoolsServer {
-    private wss;
-    private clients;
-    private httpServer;
-    private traces;
-    private logs;
-    private metrics;
-    private errorAggregator;
-    private limits;
-    private verbose;
-    private _port;
-    private onData?;
-    constructor(options?: DevtoolsServerOptions);
-    get port(): number;
-    get clientCount(): number;
-    addTrace(trace: TraceData): void;
-    addTraces(traces: TraceData[]): void;
-    addLog(log: LogData): void;
-    addLogs(logs: LogData[]): void;
-    addMetric(metric: MetricData): void;
-    getCurrentData(): DevtoolsData;
-    clearData(): void;
-    private broadcast;
-    private log;
-    close(): Promise<void>;
-}
-
-/**
- * OpenTelemetry SpanExporter that streams spans to DevtoolsServer
- */
-
-declare class DevtoolsSpanExporter implements SpanExporter {
-    private server;
-    private serviceName;
-    constructor(server: DevtoolsServer, serviceName?: string);
-    /**
-     * Export spans to the WebSocket server
-     */
-    export(spans: ReadableSpan[], resultCallback: (result: ExportResult) => void): Promise<void>;
-    /**
-     * Shutdown the exporter
-     */
-    shutdown(): Promise<void>;
-    /**
-     * Force flush any buffered spans
-     */
-    forceFlush(): Promise<void>;
-    /**
-     * Convert OpenTelemetry spans to TraceData
-     */
-    private convertToTraceData;
-    /**
-     * Convert OpenTelemetry span to SpanData
-     */
-    private convertSpan;
-    private convertScope;
-    /**
-     * Convert OpenTelemetry SpanKind to string
-     */
-    private convertSpanKind;
-}
-
-export { DevtoolsServer as D, type ErrorGroup as E, type LogData as L, type MetricData as M, type SpanData as S, type TraceData as T, DevtoolsSpanExporter as a, type DevtoolsData as b, type ErrorOccurrence as c, type DevtoolsServerOptions as d };

package/dist/exporter-De6p4iAD.d.ts

@@ -1,182 +0,0 @@
-import { SpanExporter, ReadableSpan } from '@opentelemetry/sdk-trace-base';
-import { ExportResult } from '@opentelemetry/core';
-import { Server } from 'node:http';
-
-interface SpanData {
-    traceId: string;
-    spanId: string;
-    parentSpanId?: string;
-    name: string;
-    kind: 'INTERNAL' | 'SERVER' | 'CLIENT' | 'PRODUCER' | 'CONSUMER';
-    startTime: number;
-    endTime: number;
-    duration: number;
-    attributes: Record<string, any>;
-    status: {
-        code: 'OK' | 'ERROR' | 'UNSET';
-        message?: string;
-    };
-    events?: Array<{
-        name: string;
-        timestamp: number;
-        attributes?: Record<string, any>;
-    }>;
-    links?: Array<{
-        traceId: string;
-        spanId: string;
-        attributes?: Record<string, any>;
-    }>;
-    scope?: {
-        name?: string;
-        version?: string;
-    };
-}
-interface TraceData {
-    traceId: string;
-    correlationId: string;
-    rootSpan: SpanData;
-    spans: SpanData[];
-    startTime: number;
-    endTime: number;
-    duration: number;
-    status: 'OK' | 'ERROR' | 'UNSET';
-    service: string;
-}
-interface LogData {
-    id: string;
-    traceId?: string;
-    spanId?: string;
-    resourceName?: string;
-    severityText?: string;
-    severityNumber?: number;
-    body: string | Record<string, unknown>;
-    timestamp: number;
-    attributes?: Record<string, unknown>;
-    resource?: Record<string, unknown>;
-}
-interface MetricData {
-    type: 'event' | 'funnel' | 'outcome' | 'value';
-    name: string;
-    value?: number;
-    attributes: Record<string, any>;
-    timestamp: number;
-    traceId?: string;
-}
-interface ErrorGroup {
-    fingerprint: string;
-    type: string;
-    message: string;
-    stackTrace?: string;
-    count: number;
-    firstSeen: number;
-    lastSeen: number;
-    affectedTraces: string[];
-    affectedSpans: string[];
-    service?: string;
-    attributes?: Record<string, unknown>;
-}
-interface ErrorOccurrence {
-    traceId: string;
-    spanId: string;
-    spanName: string;
-    service: string;
-    timestamp: number;
-    error: {
-        type: string;
-        message: string;
-        stackTrace?: string;
-    };
-    attributes?: Record<string, unknown>;
-}
-interface DevtoolsData {
-    traces: TraceData[];
-    metrics: MetricData[];
-    logs: LogData[];
-    errors: ErrorGroup[];
-}
-
-interface DevtoolsServerOptions {
-    port?: number;
-    server?: Server;
-    path?: string;
-    verbose?: boolean;
-    maxHistory?: number;
-    maxTraceCount?: number;
-    maxLogCount?: number;
-    maxMetricCount?: number;
-    /**
-     * Bind host, used only to decide the WebSocket origin policy. A loopback host
-     * (the default) enables the DNS-rebinding `Host` check on the live stream; an
-     * explicit non-loopback bind opts out, leaving just the cross-origin check.
-     */
-    host?: string;
-    /**
-     * Called after each ingest, with the incremental data just broadcast to WS
-     * clients. Lets an embedder (e.g. the VS Code extension) react to new
-     * telemetry — refresh its own tree views — while the server owns the buffer.
-     */
-    onData?: (incremental: DevtoolsData) => void;
-}
-declare class DevtoolsServer {
-    private wss;
-    private clients;
-    private httpServer;
-    private traces;
-    private logs;
-    private metrics;
-    private errorAggregator;
-    private limits;
-    private verbose;
-    private _port;
-    private onData?;
-    constructor(options?: DevtoolsServerOptions);
-    get port(): number;
-    get clientCount(): number;
-    addTrace(trace: TraceData): void;
-    addTraces(traces: TraceData[]): void;
-    addLog(log: LogData): void;
-    addLogs(logs: LogData[]): void;
-    addMetric(metric: MetricData): void;
-    getCurrentData(): DevtoolsData;
-    clearData(): void;
-    private broadcast;
-    private log;
-    close(): Promise<void>;
-}
-
-/**
- * OpenTelemetry SpanExporter that streams spans to DevtoolsServer
- */
-
-declare class DevtoolsSpanExporter implements SpanExporter {
-    private server;
-    private serviceName;
-    constructor(server: DevtoolsServer, serviceName?: string);
-    /**
-     * Export spans to the WebSocket server
-     */
-    export(spans: ReadableSpan[], resultCallback: (result: ExportResult) => void): Promise<void>;
-    /**
-     * Shutdown the exporter
-     */
-    shutdown(): Promise<void>;
-    /**
-     * Force flush any buffered spans
-     */
-    forceFlush(): Promise<void>;
-    /**
-     * Convert OpenTelemetry spans to TraceData
-     */
-    private convertToTraceData;
-    /**
-     * Convert OpenTelemetry span to SpanData
-     */
-    private convertSpan;
-    private convertScope;
-    /**
-     * Convert OpenTelemetry SpanKind to string
-     */
-    private convertSpanKind;
-}
-
-export { DevtoolsServer as D, type ErrorGroup as E, type LogData as L, type MetricData as M, type SpanData as S, type TraceData as T, DevtoolsSpanExporter as a, type DevtoolsData as b, type ErrorOccurrence as c, type DevtoolsServerOptions as d };