@buenojs/bueno 0.8.5 → 0.8.7

package/dist/logger/index.d.ts

@@ -0,0 +1,156 @@
+/**
+ * Structured Logging System
+ *
+ * Provides structured logging with JSON output, log levels,
+ * context-aware logging, and performance metrics.
+ */
+export type LogLevel = "debug" | "info" | "warn" | "error" | "fatal";
+export interface LogEntry {
+    level: LogLevel;
+    message: string;
+    timestamp: string;
+    context?: Record<string, unknown>;
+    error?: {
+        name: string;
+        message: string;
+        stack?: string;
+    };
+    duration?: number;
+    [key: string]: unknown;
+}
+export interface LoggerConfig {
+    level?: LogLevel;
+    pretty?: boolean;
+    timestamp?: boolean;
+    context?: Record<string, unknown>;
+    output?: "console" | "stdout" | ((entry: LogEntry) => void);
+}
+export interface LoggerContext {
+    requestId?: string;
+    userId?: string;
+    method?: string;
+    path?: string;
+    [key: string]: unknown;
+}
+export declare class Logger {
+    private level;
+    private pretty;
+    private timestamp;
+    private context;
+    private output;
+    constructor(config?: LoggerConfig);
+    /**
+     * Check if a log level should be logged
+     */
+    private shouldLog;
+    /**
+     * Serialize log entry to JSON
+     */
+    private serialize;
+    /**
+     * Pretty print log entry
+     */
+    private prettyPrint;
+    /**
+     * Create a log entry
+     */
+    private createEntry;
+    /**
+     * Log a debug message
+     */
+    debug(message: string, context?: Record<string, unknown>): void;
+    /**
+     * Log an info message
+     */
+    info(message: string, context?: Record<string, unknown>): void;
+    /**
+     * Log a warning message
+     */
+    warn(message: string, context?: Record<string, unknown>): void;
+    /**
+     * Log an error message
+     */
+    error(message: string, error?: Error | unknown, context?: Record<string, unknown>): void;
+    /**
+     * Log a fatal message
+     */
+    fatal(message: string, error?: Error | unknown, context?: Record<string, unknown>): void;
+    /**
+     * Create a child logger with additional context
+     */
+    child(context: Record<string, unknown>): Logger;
+    /**
+     * Set log level
+     */
+    setLevel(level: LogLevel): void;
+    /**
+     * Add context to the logger
+     */
+    addContext(context: Record<string, unknown>): void;
+    /**
+     * Time a function
+     */
+    time<T>(label: string, fn: () => T | Promise<T>): Promise<T>;
+    /**
+     * Create a timer
+     */
+    startTimer(label: string): () => number;
+}
+export interface RequestLogContext {
+    requestId?: string;
+    method: string;
+    path: string;
+    query?: string;
+    ip?: string;
+    userAgent?: string;
+    userId?: string;
+}
+export interface ResponseLogContext extends RequestLogContext {
+    statusCode: number;
+    duration: number;
+    contentLength?: number;
+}
+/**
+ * Create a request logger middleware
+ */
+export declare function createRequestLogger(logger: Logger): (ctx: unknown, next: () => Promise<unknown>) => Promise<unknown>;
+export declare class PerformanceLogger {
+    private logger;
+    private metrics;
+    constructor(logger: Logger);
+    /**
+     * Record a metric
+     */
+    record(name: string, value: number): void;
+    /**
+     * Get metric statistics
+     */
+    stats(name: string): {
+        count: number;
+        min: number;
+        max: number;
+        avg: number;
+        p99: number;
+    } | null;
+    /**
+     * Log all metrics
+     */
+    logMetrics(): void;
+    /**
+     * Clear all metrics
+     */
+    clear(): void;
+}
+/**
+ * Get the default logger instance
+ */
+export declare function getLogger(): Logger;
+/**
+ * Set the default logger instance
+ */
+export declare function setLogger(logger: Logger): void;
+/**
+ * Create a new logger
+ */
+export declare function createLogger(config?: LoggerConfig): Logger;
+//# sourceMappingURL=index.d.ts.map

package/dist/logger/index.d.ts.map

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

package/dist/logger/transports/index.d.ts

@@ -0,0 +1,371 @@
+/**
+ * Log Transport System
+ *
+ * Provides transport implementations for external log aggregation services
+ * like Datadog, generic HTTP webhooks, and console output.
+ */
+import type { LogEntry, LoggerConfig } from "../index";
+/**
+ * Error callback for transport errors
+ */
+export type TransportErrorCallback = (error: Error, transport: LogTransport) => void;
+/**
+ * Base interface for log transports
+ */
+export interface LogTransport {
+    /** Transport name for identification */
+    readonly name: string;
+    /** Send a single log entry */
+    send(entry: LogEntry): Promise<void>;
+    /** Send multiple log entries (batch) */
+    sendBatch(entries: LogEntry[]): Promise<void>;
+    /** Flush any pending logs */
+    flush?(): Promise<void>;
+    /** Close the transport and cleanup resources */
+    close?(): Promise<void>;
+}
+/**
+ * Options for retry behavior
+ */
+export interface RetryOptions {
+    /** Maximum number of retry attempts */
+    maxRetries: number;
+    /** Initial delay in milliseconds */
+    initialDelay: number;
+    /** Maximum delay in milliseconds */
+    maxDelay: number;
+    /** Backoff multiplier */
+    backoffMultiplier: number;
+}
+/**
+ * Options for batching behavior
+ */
+export interface BatchOptions {
+    /** Maximum batch size before auto-flush */
+    batchSize: number;
+    /** Flush interval in milliseconds */
+    flushInterval: number;
+}
+/**
+ * Options for HTTPWebhookTransport
+ */
+export interface HTTPWebhookTransportOptions {
+    /** Webhook URL */
+    url: string;
+    /** Additional headers */
+    headers?: Record<string, string>;
+    /** Batch options */
+    batchSize?: number;
+    /** Flush interval in milliseconds */
+    flushInterval?: number;
+    /** Retry options */
+    retries?: Partial<RetryOptions>;
+    /** Error callback */
+    onError?: TransportErrorCallback;
+    /** Request timeout in milliseconds */
+    timeout?: number;
+}
+/**
+ * Generic HTTP webhook transport for sending logs to any HTTP endpoint
+ */
+export declare class HTTPWebhookTransport implements LogTransport {
+    readonly name = "HTTPWebhookTransport";
+    private url;
+    private headers;
+    private batchSize;
+    private flushInterval;
+    private retryOptions;
+    private onError?;
+    private timeout;
+    private queue;
+    private flushTimer;
+    private isFlushing;
+    private isClosed;
+    constructor(options: HTTPWebhookTransportOptions);
+    /**
+     * Start the flush timer
+     */
+    private startFlushTimer;
+    /**
+     * Send a single log entry
+     */
+    send(entry: LogEntry): Promise<void>;
+    /**
+     * Send multiple log entries
+     */
+    sendBatch(entries: LogEntry[]): Promise<void>;
+    /**
+     * Flush pending logs
+     */
+    flush(): Promise<void>;
+    /**
+     * Send entries with retry logic
+     */
+    private sendWithRetry;
+    /**
+     * Make HTTP request
+     */
+    private makeRequest;
+    /**
+     * Sleep utility
+     */
+    private sleep;
+    /**
+     * Handle errors
+     */
+    private handleError;
+    /**
+     * Close the transport
+     */
+    close(): Promise<void>;
+}
+/**
+ * Options for DatadogTransport
+ */
+export interface DatadogTransportOptions {
+    /** Datadog API key */
+    apiKey: string;
+    /** Service name */
+    service: string;
+    /** Environment (e.g., production, staging) */
+    env?: string;
+    /** Hostname */
+    hostname?: string;
+    /** Default tags */
+    tags?: string[];
+    /** Batch options */
+    batchSize?: number;
+    /** Flush interval in milliseconds */
+    flushInterval?: number;
+    /** Retry options */
+    retries?: Partial<RetryOptions>;
+    /** Error callback */
+    onError?: TransportErrorCallback;
+    /** Custom Datadog API endpoint */
+    endpoint?: string;
+    /** Request timeout in milliseconds */
+    timeout?: number;
+}
+/**
+ * Datadog Logs API transport
+ */
+export declare class DatadogTransport implements LogTransport {
+    readonly name = "DatadogTransport";
+    private apiKey;
+    private service;
+    private env;
+    private hostname;
+    private tags;
+    private endpoint;
+    private batchSize;
+    private flushInterval;
+    private retryOptions;
+    private onError?;
+    private timeout;
+    private queue;
+    private flushTimer;
+    private isFlushing;
+    private isClosed;
+    constructor(options: DatadogTransportOptions);
+    /**
+     * Get default hostname
+     */
+    private getDefaultHostname;
+    /**
+     * Start the flush timer
+     */
+    private startFlushTimer;
+    /**
+     * Convert log level to Datadog status
+     */
+    private toDatadogStatus;
+    /**
+     * Convert LogEntry to Datadog format
+     */
+    private toDatadogFormat;
+    /**
+     * Send a single log entry
+     */
+    send(entry: LogEntry): Promise<void>;
+    /**
+     * Send multiple log entries
+     */
+    sendBatch(entries: LogEntry[]): Promise<void>;
+    /**
+     * Flush pending logs
+     */
+    flush(): Promise<void>;
+    /**
+     * Send entries with retry logic
+     */
+    private sendWithRetry;
+    /**
+     * Make HTTP request to Datadog
+     */
+    private makeRequest;
+    /**
+     * Sleep utility
+     */
+    private sleep;
+    /**
+     * Handle errors
+     */
+    private handleError;
+    /**
+     * Close the transport
+     */
+    close(): Promise<void>;
+}
+/**
+ * Options for ConsoleTransport
+ */
+export interface ConsoleTransportOptions {
+    /** Use pretty printing */
+    pretty?: boolean;
+    /** Output stream for logs */
+    stream?: "stdout" | "stderr";
+    /** Error callback */
+    onError?: TransportErrorCallback;
+}
+/**
+ * Enhanced console transport for local development
+ */
+export declare class ConsoleTransport implements LogTransport {
+    readonly name = "ConsoleTransport";
+    private pretty;
+    private stream;
+    private onError?;
+    constructor(options?: ConsoleTransportOptions);
+    /**
+     * Get level color for pretty printing
+     */
+    private getLevelColor;
+    /**
+     * Format log entry for console output
+     */
+    private formatEntry;
+    /**
+     * Output to console
+     */
+    private output;
+    /**
+     * Send a single log entry
+     */
+    send(entry: LogEntry): Promise<void>;
+    /**
+     * Send multiple log entries
+     */
+    sendBatch(entries: LogEntry[]): Promise<void>;
+    /**
+     * Flush (no-op for console)
+     */
+    flush(): Promise<void>;
+    /**
+     * Close (no-op for console)
+     */
+    close(): Promise<void>;
+}
+/**
+ * Manages multiple log transports
+ */
+export declare class TransportManager {
+    private transports;
+    private onError?;
+    constructor(options?: {
+        onError?: TransportErrorCallback;
+    });
+    /**
+     * Add a transport
+     */
+    addTransport(transport: LogTransport): void;
+    /**
+     * Remove a transport
+     */
+    removeTransport(transport: LogTransport): boolean;
+    /**
+     * Get all transports
+     */
+    getTransports(): LogTransport[];
+    /**
+     * Check if a transport is registered
+     */
+    hasTransport(transport: LogTransport): boolean;
+    /**
+     * Clear all transports
+     */
+    clearTransports(): void;
+    /**
+     * Broadcast a log entry to all transports
+     */
+    broadcast(entry: LogEntry): Promise<void>;
+    /**
+     * Broadcast multiple entries to all transports
+     */
+    broadcastBatch(entries: LogEntry[]): Promise<void>;
+    /**
+     * Flush all transports
+     */
+    flushAll(): Promise<void>;
+    /**
+     * Close all transports
+     */
+    closeAll(): Promise<void>;
+}
+import { Logger } from "../index";
+/**
+ * Configuration for logger with transports
+ */
+export interface LoggerWithTransportsConfig extends LoggerConfig {
+    /** Transports to add to the logger */
+    transports?: LogTransport[];
+    /** Error callback for transport errors */
+    onTransportError?: TransportErrorCallback;
+}
+/**
+ * Logger with transport support
+ */
+export declare class LoggerWithTransports extends Logger {
+    private transportManager;
+    constructor(config?: LoggerWithTransportsConfig);
+    /**
+     * Add a transport
+     */
+    addTransport(transport: LogTransport): void;
+    /**
+     * Remove a transport
+     */
+    removeTransport(transport: LogTransport): boolean;
+    /**
+     * Get all transports
+     */
+    getTransports(): LogTransport[];
+    /**
+     * Flush all transports
+     */
+    flushTransports(): Promise<void>;
+    /**
+     * Close all transports
+     */
+    closeTransports(): Promise<void>;
+}
+/**
+ * Create a logger with transports
+ */
+export declare function createLoggerWithTransports(config?: LoggerWithTransportsConfig): LoggerWithTransports;
+/**
+ * Create a transport output function for use with existing Logger
+ */
+export declare function createTransportOutput(transports: LogTransport[], options?: {
+    onError?: TransportErrorCallback;
+}): (entry: LogEntry) => void;
+declare const _default: {
+    HTTPWebhookTransport: typeof HTTPWebhookTransport;
+    DatadogTransport: typeof DatadogTransport;
+    ConsoleTransport: typeof ConsoleTransport;
+    TransportManager: typeof TransportManager;
+    LoggerWithTransports: typeof LoggerWithTransports;
+    createLoggerWithTransports: typeof createLoggerWithTransports;
+    createTransportOutput: typeof createTransportOutput;
+};
+export default _default;
+//# sourceMappingURL=index.d.ts.map

package/dist/logger/transports/index.d.ts.map

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

package/dist/metrics/index.d.ts

@@ -0,0 +1,163 @@
+/**
+ * Runtime Metrics Module
+ *
+ * Provides runtime metrics collection for memory, CPU usage, and other statistics.
+ * Part of Layer 7 (Testing & Observability) implementation.
+ */
+/**
+ * Runtime metrics snapshot
+ */
+export interface RuntimeMetrics {
+    /** Heap memory used in bytes */
+    memoryHeapUsed: number;
+    /** Total heap memory in bytes */
+    memoryHeapTotal: number;
+    /** External memory (C++ objects bound to JS) in bytes */
+    memoryExternal: number;
+    /** Resident Set Size in bytes */
+    memoryRss: number;
+    /** User CPU time in microseconds */
+    cpuUser: number;
+    /** System CPU time in microseconds */
+    cpuSystem: number;
+    /** Process uptime in seconds */
+    uptime: number;
+    /** Event loop lag in milliseconds */
+    eventLoopLag: number;
+    /** ISO 8601 timestamp */
+    timestamp: string;
+}
+/**
+ * Human-readable metrics summary
+ */
+export interface MetricsSummary {
+    memoryHeapUsed: string;
+    memoryHeapTotal: string;
+    memoryExternal: string;
+    memoryRss: string;
+    cpuUser: string;
+    cpuSystem: string;
+    uptime: string;
+    eventLoopLag: string;
+    timestamp: string;
+}
+/**
+ * Options for MetricsCollector
+ */
+export interface MetricsCollectorOptions {
+    /** Maximum number of historical snapshots to keep (default: 100) */
+    maxHistorySize?: number;
+    /** Include event loop lag measurement (default: true) */
+    measureEventLoopLag?: boolean;
+}
+/**
+ * Averaged metrics over time
+ */
+export interface AveragedMetrics {
+    avgMemoryHeapUsed: number;
+    avgMemoryHeapTotal: number;
+    avgMemoryExternal: number;
+    avgMemoryRss: number;
+    avgCpuUser: number;
+    avgCpuSystem: number;
+    avgEventLoopLag: number;
+    minMemoryHeapUsed: number;
+    maxMemoryHeapUsed: number;
+    sampleCount: number;
+    timeRange: {
+        start: string;
+        end: string;
+    };
+}
+/**
+ * Format bytes to human-readable string
+ */
+export declare function formatBytes(bytes: number): string;
+/**
+ * Format microseconds to human-readable string
+ */
+export declare function formatMicroseconds(microseconds: number): string;
+/**
+ * Format seconds to human-readable uptime string
+ */
+export declare function formatUptime(seconds: number): string;
+/**
+ * Get human-readable metrics summary
+ */
+export declare function getMetricsSummary(metrics: RuntimeMetrics): MetricsSummary;
+/**
+ * Measure event loop lag using deferred execution timing
+ * @returns Promise resolving to lag in milliseconds
+ */
+export declare function measureEventLoopLag(): Promise<number>;
+/**
+ * Measure event loop lag multiple times and return average
+ */
+export declare function measureEventLoopLagAverage(samples?: number): Promise<number>;
+/**
+ * Collects and manages runtime metrics
+ */
+export declare class MetricsCollector {
+    private history;
+    private maxHistorySize;
+    private measureEventLoopLagEnabled;
+    private periodicTimer;
+    private lastCpuUsage;
+    constructor(options?: MetricsCollectorOptions);
+    /**
+     * Collect current runtime metrics
+     */
+    collect(): Promise<RuntimeMetrics>;
+    /**
+     * Start collecting metrics at regular intervals
+     * @param intervalMs Interval in milliseconds (default: 5000)
+     */
+    startPeriodicCollection(intervalMs?: number): void;
+    /**
+     * Stop periodic collection
+     */
+    stopPeriodicCollection(): void;
+    /**
+     * Check if periodic collection is running
+     */
+    isCollecting(): boolean;
+    /**
+     * Get historical metrics snapshots
+     */
+    getHistory(): RuntimeMetrics[];
+    /**
+     * Get the most recent metrics
+     */
+    getLatest(): RuntimeMetrics | null;
+    /**
+     * Get averaged metrics over time
+     */
+    getAverage(): AveragedMetrics | null;
+    /**
+     * Clear history
+     */
+    reset(): void;
+    /**
+     * Get the number of samples in history
+     */
+    getHistorySize(): number;
+}
+/**
+ * Export metrics in Prometheus text format
+ * @param metrics Runtime metrics to export
+ * @returns Prometheus formatted string
+ */
+export declare function toPrometheusFormat(metrics: RuntimeMetrics): string;
+/**
+ * Export averaged metrics in Prometheus format
+ */
+export declare function averagedMetricsToPrometheus(averaged: AveragedMetrics): string;
+/**
+ * Create a new metrics collector
+ */
+export declare function createMetricsCollector(options?: MetricsCollectorOptions): MetricsCollector;
+/**
+ * Collect metrics once without a collector
+ */
+export declare function collectMetrics(): Promise<RuntimeMetrics>;
+//# sourceMappingURL=index.d.ts.map