/**
 * Copyright (c) 2025 Databricks Contributors
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *     http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */
/**
 * Event types emitted by the telemetry system
 */
export declare enum TelemetryEventType {
    CONNECTION_OPEN = "connection.open",
    STATEMENT_START = "statement.start",
    STATEMENT_COMPLETE = "statement.complete",
    CLOUDFETCH_CHUNK = "cloudfetch.chunk",
    ERROR = "error"
}
/**
 * Configuration for telemetry components
 */
export interface TelemetryConfiguration {
    /** Whether telemetry is enabled */
    enabled?: boolean;
    /** Maximum number of metrics to batch before flushing */
    batchSize?: number;
    /** Interval in milliseconds to flush metrics */
    flushIntervalMs?: number;
    /** Maximum retry attempts for export */
    maxRetries?: number;
    /** Whether to use authenticated export endpoint */
    authenticatedExport?: boolean;
    /** Circuit breaker failure threshold */
    circuitBreakerThreshold?: number;
    /** Circuit breaker timeout in milliseconds */
    circuitBreakerTimeout?: number;
}
/**
 * Default telemetry configuration values
 */
export declare const DEFAULT_TELEMETRY_CONFIG: Required<TelemetryConfiguration>;
/**
 * Runtime telemetry event emitted by the driver
 */
export interface TelemetryEvent {
    /** Type of the event */
    eventType: TelemetryEventType | string;
    /** Timestamp when the event occurred (milliseconds since epoch) */
    timestamp: number;
    /** Session ID for correlation */
    sessionId?: string;
    /** Statement ID for correlation */
    statementId?: string;
    /** Workspace ID */
    workspaceId?: string;
    /** Driver configuration */
    driverConfig?: DriverConfiguration;
    /** Type of operation (SELECT, INSERT, etc.) */
    operationType?: string;
    /** Execution latency in milliseconds */
    latencyMs?: number;
    /** Result format (inline, cloudfetch, arrow) */
    resultFormat?: string;
    /** Number of result chunks */
    chunkCount?: number;
    /** Total bytes downloaded */
    bytesDownloaded?: number;
    /** Number of poll operations */
    pollCount?: number;
    /** Chunk index in the result set */
    chunkIndex?: number;
    /** Number of bytes in this chunk */
    bytes?: number;
    /** Whether compression was used */
    compressed?: boolean;
    /** Error name/type */
    errorName?: string;
    /** Error message */
    errorMessage?: string;
    /** Whether the error is terminal (non-retryable) */
    isTerminal?: boolean;
}
/**
 * Aggregated telemetry metric for export to Databricks
 */
export interface TelemetryMetric {
    /** Type of metric */
    metricType: 'connection' | 'statement' | 'error';
    /** Timestamp when the metric was created (milliseconds since epoch) */
    timestamp: number;
    /** Session ID for correlation */
    sessionId?: string;
    /** Statement ID for correlation */
    statementId?: string;
    /** Workspace ID */
    workspaceId?: string;
    /** Driver configuration (for connection metrics) */
    driverConfig?: DriverConfiguration;
    /** Execution latency in milliseconds */
    latencyMs?: number;
    /** Result format (inline, cloudfetch, arrow) */
    resultFormat?: string;
    /** Number of result chunks */
    chunkCount?: number;
    /** Total bytes downloaded */
    bytesDownloaded?: number;
    /** Number of poll operations */
    pollCount?: number;
    /** Error name/type */
    errorName?: string;
    /** Error message */
    errorMessage?: string;
}
/**
 * Driver configuration metadata collected once per connection
 */
export interface DriverConfiguration {
    /** Driver version */
    driverVersion: string;
    /** Driver name */
    driverName: string;
    /** Node.js version */
    nodeVersion: string;
    /** Platform (linux, darwin, win32) */
    platform: string;
    /** OS version */
    osVersion: string;
    /** Whether CloudFetch is enabled */
    cloudFetchEnabled: boolean;
    /** Whether LZ4 compression is enabled */
    lz4Enabled: boolean;
    /** Whether Arrow format is enabled */
    arrowEnabled: boolean;
    /** Whether direct results are enabled */
    directResultsEnabled: boolean;
    /** Socket timeout in milliseconds */
    socketTimeout: number;
    /** Maximum retry attempts */
    retryMaxAttempts: number;
    /** Number of concurrent CloudFetch downloads */
    cloudFetchConcurrentDownloads: number;
}
/**
 * Per-statement metrics aggregated from multiple events
 */
export interface StatementMetrics {
    /** Statement ID */
    statementId: string;
    /** Session ID */
    sessionId: string;
    /** Type of operation */
    operationType?: string;
    /** Start timestamp (milliseconds since epoch) */
    startTime: number;
    /** Total execution latency in milliseconds */
    executionLatencyMs?: number;
    /** Number of poll operations */
    pollCount: number;
    /** Total poll latency in milliseconds */
    pollLatencyMs: number;
    /** Result format (inline, cloudfetch, arrow) */
    resultFormat?: string;
    /** Number of CloudFetch chunks downloaded */
    chunkCount: number;
    /** Total bytes downloaded */
    totalBytesDownloaded: number;
    /** Whether compression was used */
    compressionEnabled?: boolean;
}