@qualithm/arrow-flight-sql-js 0.0.1

package/dist/metrics.d.ts

@@ -0,0 +1,217 @@
+/**
+ * Metrics and observability hooks for Arrow Flight SQL client.
+ *
+ * This module provides a flexible metrics interface that can be integrated
+ * with various observability backends (OpenTelemetry, Prometheus, StatsD, etc.).
+ *
+ * @example
+ * ```typescript
+ * import { FlightSqlClient, ConsoleMetricsHandler } from "@qualithm/arrow-flight-sql-js"
+ *
+ * const client = new FlightSqlClient({
+ *   host: "localhost",
+ *   port: 50051,
+ *   metrics: new ConsoleMetricsHandler()
+ * })
+ * ```
+ */
+/**
+ * Types of operations that can be measured
+ */
+export type OperationType = "connect" | "close" | "handshake" | "query" | "execute" | "executeUpdate" | "prepare" | "getFlightInfo" | "getSchema" | "doGet" | "doPut" | "doAction" | "getCatalogs" | "getSchemas" | "getTables" | "getTableTypes" | "getPrimaryKeys" | "getExportedKeys" | "getImportedKeys" | "poolAcquire" | "poolRelease" | "healthCheck" | "retry";
+/**
+ * Status of an operation
+ */
+export type OperationStatus = "success" | "error" | "timeout" | "cancelled";
+/**
+ * Metric event emitted when an operation completes
+ */
+export interface MetricEvent {
+    /** Type of operation */
+    operation: OperationType;
+    /** Final status of the operation */
+    status: OperationStatus;
+    /** Duration in milliseconds */
+    durationMs: number;
+    /** Start timestamp (ms since epoch) */
+    startTime: number;
+    /** End timestamp (ms since epoch) */
+    endTime: number;
+    /** Error if status is not 'success' */
+    error?: Error;
+    /** Additional metadata about the operation */
+    metadata?: Record<string, string | number | boolean>;
+}
+/**
+ * Gauge metric for current values (like pool size)
+ */
+export interface GaugeEvent {
+    /** Name of the gauge */
+    name: string;
+    /** Current value */
+    value: number;
+    /** Optional labels */
+    labels?: Record<string, string>;
+}
+/**
+ * Counter metric for incrementing values
+ */
+export interface CounterEvent {
+    /** Name of the counter */
+    name: string;
+    /** Increment amount (default: 1) */
+    increment: number;
+    /** Optional labels */
+    labels?: Record<string, string>;
+}
+/**
+ * Interface for handling metrics events.
+ *
+ * Implement this interface to integrate with your observability backend.
+ */
+export interface MetricsHandler {
+    /**
+     * Record a timed operation metric
+     */
+    recordOperation(event: MetricEvent): void;
+    /**
+     * Record a gauge value
+     */
+    recordGauge(event: GaugeEvent): void;
+    /**
+     * Record a counter increment
+     */
+    recordCounter(event: CounterEvent): void;
+    /**
+     * Called when the client is closed, allowing cleanup
+     */
+    close?(): void | Promise<void>;
+}
+/**
+ * No-op metrics handler that discards all metrics.
+ * Used when no metrics handler is configured.
+ */
+export declare class NoopMetricsHandler implements MetricsHandler {
+    recordOperation(_event: MetricEvent): void;
+    recordGauge(_event: GaugeEvent): void;
+    recordCounter(_event: CounterEvent): void;
+}
+/**
+ * Console-based metrics handler for development and debugging.
+ * Logs all metrics to console with formatted output.
+ */
+export declare class ConsoleMetricsHandler implements MetricsHandler {
+    private readonly prefix;
+    constructor(prefix?: string);
+    recordOperation(event: MetricEvent): void;
+    recordGauge(event: GaugeEvent): void;
+    recordCounter(event: CounterEvent): void;
+}
+/**
+ * In-memory metrics collector for testing and simple monitoring.
+ * Stores metrics in memory and provides query methods.
+ */
+export declare class InMemoryMetricsHandler implements MetricsHandler {
+    private readonly operations;
+    private readonly gauges;
+    private readonly counters;
+    private readonly maxOperations;
+    constructor(options?: {
+        maxOperations?: number;
+    });
+    recordOperation(event: MetricEvent): void;
+    recordGauge(event: GaugeEvent): void;
+    recordCounter(event: CounterEvent): void;
+    /**
+     * Get all recorded operations
+     */
+    getOperations(): readonly MetricEvent[];
+    /**
+     * Get operations filtered by type
+     */
+    getOperationsByType(operation: OperationType): MetricEvent[];
+    /**
+     * Get average duration for an operation type
+     */
+    getAverageDuration(operation: OperationType): number;
+    /**
+     * Get error rate for an operation type
+     */
+    getErrorRate(operation: OperationType): number;
+    /**
+     * Get current gauge value
+     */
+    getGauge(name: string, labels?: Record<string, string>): number | undefined;
+    /**
+     * Get current counter value
+     */
+    getCounter(name: string, labels?: Record<string, string>): number;
+    /**
+     * Get summary statistics
+     */
+    getSummary(): {
+        totalOperations: number;
+        successCount: number;
+        errorCount: number;
+        operationCounts: Record<string, number>;
+        averageDurations: Record<string, number>;
+    };
+    /**
+     * Clear all stored metrics
+     */
+    clear(): void;
+    private makeKey;
+}
+/**
+ * Helper class for timing operations and recording metrics
+ */
+export declare class MetricsTimer {
+    private readonly handler;
+    private readonly operation;
+    private readonly startTime;
+    private readonly metadata;
+    constructor(handler: MetricsHandler, operation: OperationType, metadata?: Record<string, string | number | boolean>);
+    /**
+     * Record success and return duration
+     */
+    success(additionalMetadata?: Record<string, string | number | boolean>): number;
+    /**
+     * Record error and return duration
+     */
+    error(err: Error, additionalMetadata?: Record<string, string | number | boolean>): number;
+    /**
+     * Record timeout and return duration
+     */
+    timeout(err?: Error, additionalMetadata?: Record<string, string | number | boolean>): number;
+    /**
+     * Record cancellation and return duration
+     */
+    cancelled(err?: Error, additionalMetadata?: Record<string, string | number | boolean>): number;
+    private record;
+}
+/**
+ * Create a metrics timer for an operation
+ */
+export declare function startTimer(handler: MetricsHandler, operation: OperationType, metadata?: Record<string, string | number | boolean>): MetricsTimer;
+/**
+ * Wrap an async function with metrics timing
+ */
+export declare function withMetrics<T>(handler: MetricsHandler, operation: OperationType, fn: () => Promise<T>, metadata?: Record<string, string | number | boolean>): Promise<T>;
+/**
+ * Standard metric names for consistency
+ */
+export declare const MetricNames: {
+    readonly poolTotalConnections: "flight_sql.pool.total_connections";
+    readonly poolActiveConnections: "flight_sql.pool.active_connections";
+    readonly poolIdleConnections: "flight_sql.pool.idle_connections";
+    readonly poolPendingRequests: "flight_sql.pool.pending_requests";
+    readonly queriesExecuted: "flight_sql.queries.executed";
+    readonly queriesSucceeded: "flight_sql.queries.succeeded";
+    readonly queriesFailed: "flight_sql.queries.failed";
+    readonly bytesReceived: "flight_sql.bytes.received";
+    readonly bytesSent: "flight_sql.bytes.sent";
+    readonly retriesAttempted: "flight_sql.retries.attempted";
+    readonly connectionsCreated: "flight_sql.connections.created";
+    readonly connectionsClosed: "flight_sql.connections.closed";
+};
+//# sourceMappingURL=metrics.d.ts.map

package/dist/metrics.d.ts.map

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

package/dist/metrics.js

@@ -0,0 +1,304 @@
+/**
+ * Metrics and observability hooks for Arrow Flight SQL client.
+ *
+ * This module provides a flexible metrics interface that can be integrated
+ * with various observability backends (OpenTelemetry, Prometheus, StatsD, etc.).
+ *
+ * @example
+ * ```typescript
+ * import { FlightSqlClient, ConsoleMetricsHandler } from "@qualithm/arrow-flight-sql-js"
+ *
+ * const client = new FlightSqlClient({
+ *   host: "localhost",
+ *   port: 50051,
+ *   metrics: new ConsoleMetricsHandler()
+ * })
+ * ```
+ */
+// ============================================================================
+// Built-in Metrics Handlers
+// ============================================================================
+/**
+ * No-op metrics handler that discards all metrics.
+ * Used when no metrics handler is configured.
+ */
+export class NoopMetricsHandler {
+    recordOperation(_event) {
+        // Intentionally empty
+    }
+    recordGauge(_event) {
+        // Intentionally empty
+    }
+    recordCounter(_event) {
+        // Intentionally empty
+    }
+}
+/**
+ * Console-based metrics handler for development and debugging.
+ * Logs all metrics to console with formatted output.
+ */
+export class ConsoleMetricsHandler {
+    prefix;
+    constructor(prefix = "[FlightSQL Metrics]") {
+        this.prefix = prefix;
+    }
+    recordOperation(event) {
+        const statusEmoji = event.status === "success" ? "✓" : "✗";
+        const message = `${this.prefix} ${statusEmoji} ${event.operation} ${event.status} (${String(event.durationMs)}ms)`;
+        if (event.status === "success") {
+            console.log(message);
+        }
+        else {
+            console.error(message, event.error?.message ?? "");
+        }
+    }
+    recordGauge(event) {
+        const labels = event.labels ? ` ${JSON.stringify(event.labels)}` : "";
+        console.log(`${this.prefix} [gauge] ${event.name}=${String(event.value)}${labels}`);
+    }
+    recordCounter(event) {
+        const labels = event.labels ? ` ${JSON.stringify(event.labels)}` : "";
+        console.log(`${this.prefix} [counter] ${event.name}+=${String(event.increment)}${labels}`);
+    }
+}
+/**
+ * In-memory metrics collector for testing and simple monitoring.
+ * Stores metrics in memory and provides query methods.
+ */
+export class InMemoryMetricsHandler {
+    operations = [];
+    gauges = new Map();
+    counters = new Map();
+    maxOperations;
+    constructor(options) {
+        this.maxOperations = options?.maxOperations ?? 1000;
+    }
+    recordOperation(event) {
+        this.operations.push(event);
+        // Keep memory bounded
+        if (this.operations.length > this.maxOperations) {
+            this.operations.shift();
+        }
+    }
+    recordGauge(event) {
+        const key = this.makeKey(event.name, event.labels);
+        this.gauges.set(key, event);
+    }
+    recordCounter(event) {
+        const key = this.makeKey(event.name, event.labels);
+        const current = this.counters.get(key) ?? 0;
+        this.counters.set(key, current + event.increment);
+    }
+    // =========================================================================
+    // Query Methods
+    // =========================================================================
+    /**
+     * Get all recorded operations
+     */
+    getOperations() {
+        return this.operations;
+    }
+    /**
+     * Get operations filtered by type
+     */
+    getOperationsByType(operation) {
+        return this.operations.filter((e) => e.operation === operation);
+    }
+    /**
+     * Get average duration for an operation type
+     */
+    getAverageDuration(operation) {
+        const ops = this.getOperationsByType(operation);
+        if (ops.length === 0) {
+            return 0;
+        }
+        return ops.reduce((sum, e) => sum + e.durationMs, 0) / ops.length;
+    }
+    /**
+     * Get error rate for an operation type
+     */
+    getErrorRate(operation) {
+        const ops = this.getOperationsByType(operation);
+        if (ops.length === 0) {
+            return 0;
+        }
+        const errors = ops.filter((e) => e.status !== "success").length;
+        return errors / ops.length;
+    }
+    /**
+     * Get current gauge value
+     */
+    getGauge(name, labels) {
+        const key = this.makeKey(name, labels);
+        return this.gauges.get(key)?.value;
+    }
+    /**
+     * Get current counter value
+     */
+    getCounter(name, labels) {
+        const key = this.makeKey(name, labels);
+        return this.counters.get(key) ?? 0;
+    }
+    /**
+     * Get summary statistics
+     */
+    getSummary() {
+        const operationCounts = {};
+        const operationDurations = {};
+        let successCount = 0;
+        let errorCount = 0;
+        for (const op of this.operations) {
+            operationCounts[op.operation] = (operationCounts[op.operation] ?? 0) + 1;
+            operationDurations[op.operation] ??= [];
+            operationDurations[op.operation].push(op.durationMs);
+            if (op.status === "success") {
+                successCount++;
+            }
+            else {
+                errorCount++;
+            }
+        }
+        const averageDurations = {};
+        for (const [op, durations] of Object.entries(operationDurations)) {
+            averageDurations[op] = durations.reduce((a, b) => a + b, 0) / durations.length;
+        }
+        return {
+            totalOperations: this.operations.length,
+            successCount,
+            errorCount,
+            operationCounts,
+            averageDurations
+        };
+    }
+    /**
+     * Clear all stored metrics
+     */
+    clear() {
+        this.operations.length = 0;
+        this.gauges.clear();
+        this.counters.clear();
+    }
+    makeKey(name, labels) {
+        if (!labels || Object.keys(labels).length === 0) {
+            return name;
+        }
+        const sortedLabels = Object.entries(labels)
+            .sort(([a], [b]) => a.localeCompare(b))
+            .map(([k, v]) => `${k}=${v}`)
+            .join(",");
+        return `${name}{${sortedLabels}}`;
+    }
+}
+// ============================================================================
+// Metrics Helper
+// ============================================================================
+/**
+ * Helper class for timing operations and recording metrics
+ */
+export class MetricsTimer {
+    handler;
+    operation;
+    startTime;
+    metadata;
+    constructor(handler, operation, metadata) {
+        this.handler = handler;
+        this.operation = operation;
+        this.startTime = Date.now();
+        this.metadata = metadata ?? {};
+    }
+    /**
+     * Record success and return duration
+     */
+    success(additionalMetadata) {
+        return this.record("success", undefined, additionalMetadata);
+    }
+    /**
+     * Record error and return duration
+     */
+    error(err, additionalMetadata) {
+        return this.record("error", err, additionalMetadata);
+    }
+    /**
+     * Record timeout and return duration
+     */
+    timeout(err, additionalMetadata) {
+        return this.record("timeout", err, additionalMetadata);
+    }
+    /**
+     * Record cancellation and return duration
+     */
+    cancelled(err, additionalMetadata) {
+        return this.record("cancelled", err, additionalMetadata);
+    }
+    record(status, error, additionalMetadata) {
+        const endTime = Date.now();
+        const durationMs = endTime - this.startTime;
+        this.handler.recordOperation({
+            operation: this.operation,
+            status,
+            durationMs,
+            startTime: this.startTime,
+            endTime,
+            error,
+            metadata: { ...this.metadata, ...additionalMetadata }
+        });
+        return durationMs;
+    }
+}
+/**
+ * Create a metrics timer for an operation
+ */
+export function startTimer(handler, operation, metadata) {
+    return new MetricsTimer(handler, operation, metadata);
+}
+/**
+ * Wrap an async function with metrics timing
+ */
+export async function withMetrics(handler, operation, fn, metadata) {
+    const timer = startTimer(handler, operation, metadata);
+    try {
+        const result = await fn();
+        timer.success();
+        return result;
+    }
+    catch (error) {
+        if (error instanceof Error) {
+            if (error.name === "TimeoutError") {
+                timer.timeout(error);
+            }
+            else if (error.name === "CancelledError") {
+                timer.cancelled(error);
+            }
+            else {
+                timer.error(error);
+            }
+        }
+        else {
+            timer.error(new Error(String(error)));
+        }
+        throw error;
+    }
+}
+// ============================================================================
+// Standard Metric Names
+// ============================================================================
+/**
+ * Standard metric names for consistency
+ */
+export const MetricNames = {
+    // Pool gauges
+    poolTotalConnections: "flight_sql.pool.total_connections",
+    poolActiveConnections: "flight_sql.pool.active_connections",
+    poolIdleConnections: "flight_sql.pool.idle_connections",
+    poolPendingRequests: "flight_sql.pool.pending_requests",
+    // Counters
+    queriesExecuted: "flight_sql.queries.executed",
+    queriesSucceeded: "flight_sql.queries.succeeded",
+    queriesFailed: "flight_sql.queries.failed",
+    bytesReceived: "flight_sql.bytes.received",
+    bytesSent: "flight_sql.bytes.sent",
+    retriesAttempted: "flight_sql.retries.attempted",
+    connectionsCreated: "flight_sql.connections.created",
+    connectionsClosed: "flight_sql.connections.closed"
+};
+//# sourceMappingURL=metrics.js.map

package/dist/metrics.js.map

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