@buenojs/bueno 0.8.10 → 0.8.11

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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"}