vestig 0.2.0

package/dist/transports/http.js

@@ -0,0 +1,106 @@
+import { BatchTransport } from './batch';
+/**
+ * Default HTTP transport configuration
+ */
+const DEFAULTS = {
+    method: 'POST',
+    timeout: 30000,
+    headers: {
+        'Content-Type': 'application/json',
+    },
+};
+/**
+ * HTTP transport for sending logs to external services
+ *
+ * Supports any runtime with native fetch (Node 18+, Bun, Deno, Edge, Browser).
+ * Features batching, retry logic, custom headers, and payload transformation.
+ *
+ * @example
+ * ```typescript
+ * const transport = new HTTPTransport({
+ *   name: 'my-http',
+ *   url: 'https://logs.example.com/ingest',
+ *   headers: {
+ *     'Authorization': 'Bearer my-token',
+ *   },
+ *   transform: (entries) => ({
+ *     logs: entries,
+ *     timestamp: Date.now(),
+ *   }),
+ * })
+ * ```
+ */
+export class HTTPTransport extends BatchTransport {
+    name;
+    url;
+    method;
+    headers;
+    timeout;
+    transform;
+    constructor(config) {
+        super({
+            ...config,
+            name: config.name ?? 'http',
+        });
+        this.name = config.name ?? 'http';
+        this.url = config.url;
+        this.method = config.method ?? DEFAULTS.method;
+        this.headers = { ...DEFAULTS.headers, ...config.headers };
+        this.timeout = config.timeout ?? DEFAULTS.timeout;
+        this.transform = config.transform;
+    }
+    /**
+     * Send entries to the configured URL
+     */
+    async send(entries) {
+        const payload = this.transform ? this.transform(entries) : entries;
+        const body = JSON.stringify(payload);
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), this.timeout);
+        try {
+            const response = await fetch(this.url, {
+                method: this.method,
+                headers: this.headers,
+                body,
+                signal: controller.signal,
+            });
+            if (!response.ok) {
+                throw new HTTPTransportError(`HTTP ${response.status}: ${response.statusText}`, response.status, await this.safeReadBody(response));
+            }
+        }
+        catch (err) {
+            if (err instanceof Error && err.name === 'AbortError') {
+                throw new HTTPTransportError(`Request timeout after ${this.timeout}ms`, 408);
+            }
+            throw err;
+        }
+        finally {
+            clearTimeout(timeoutId);
+        }
+    }
+    /**
+     * Safely read response body for error messages
+     */
+    async safeReadBody(response) {
+        try {
+            return await response.text();
+        }
+        catch {
+            return undefined;
+        }
+    }
+}
+/**
+ * Custom error for HTTP transport failures
+ */
+export class HTTPTransportError extends Error {
+    statusCode;
+    responseBody;
+    constructor(message, statusCode, responseBody) {
+        super(message);
+        this.statusCode = statusCode;
+        this.responseBody = responseBody;
+        this.name = 'HTTPTransportError';
+    }
+}
+//# sourceMappingURL=http.js.map

package/dist/transports/http.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,224 @@
+/**
+ * Log levels from least to most severe
+ */
+export type LogLevel = 'trace' | 'debug' | 'info' | 'warn' | 'error';
+/**
+ * Runtime environment detection
+ */
+export type Runtime = 'node' | 'bun' | 'edge' | 'browser' | 'worker' | 'unknown';
+/**
+ * Metadata attached to log entries
+ */
+export type LogMetadata = Record<string, unknown>;
+/**
+ * Context that persists across async operations
+ */
+export interface LogContext {
+    requestId?: string;
+    traceId?: string;
+    spanId?: string;
+    userId?: string;
+    sessionId?: string;
+    [key: string]: unknown;
+}
+/**
+ * A structured log entry
+ */
+export interface LogEntry {
+    timestamp: string;
+    level: LogLevel;
+    message: string;
+    metadata?: LogMetadata;
+    context?: LogContext;
+    runtime: Runtime;
+    namespace?: string;
+    error?: SerializedError;
+}
+/**
+ * Serialized error with cause chain support
+ */
+export interface SerializedError {
+    name: string;
+    message: string;
+    stack?: string;
+    cause?: SerializedError;
+    code?: string | number;
+    [key: string]: unknown;
+}
+/**
+ * Field matcher for flexible field matching in sanitization
+ */
+export interface FieldMatcher {
+    /** Match type */
+    type: 'exact' | 'prefix' | 'suffix' | 'contains' | 'regex';
+    /** Pattern or field name to match */
+    value: string;
+    /** Case sensitive matching (default: false) */
+    caseSensitive?: boolean;
+}
+/**
+ * Pattern definition for sanitizing string content
+ */
+export interface SanitizePattern {
+    /** Pattern identifier */
+    name: string;
+    /** Regular expression to match */
+    pattern: RegExp;
+    /** Replacement string or function (default: '[REDACTED]') */
+    replacement?: string | ((match: string) => string);
+}
+/**
+ * Sanitization configuration
+ */
+export interface SanitizeConfig {
+    /** Enable/disable sanitization (default: true) */
+    enabled?: boolean;
+    /** Fields to sanitize (can be strings or FieldMatchers) */
+    fields?: (string | FieldMatcher)[];
+    /** Patterns to apply to string values */
+    patterns?: SanitizePattern[];
+    /** Default replacement string (default: '[REDACTED]') */
+    replacement?: string;
+    /** Maximum recursion depth (default: 10) */
+    depth?: number;
+}
+/**
+ * Available sanitization presets
+ */
+export type SanitizePreset = 'none' | 'minimal' | 'default' | 'gdpr' | 'hipaa' | 'pci-dss';
+/**
+ * Logger configuration options
+ */
+export interface LoggerConfig {
+    /** Minimum log level to output */
+    level?: LogLevel;
+    /** Enable/disable logging */
+    enabled?: boolean;
+    /** Output as JSON (production) or formatted (development) */
+    structured?: boolean;
+    /** Sanitization configuration: boolean, preset name, or full config */
+    sanitize?: boolean | SanitizePreset | SanitizeConfig;
+    /** @deprecated Use sanitize config instead */
+    sanitizeFields?: string[];
+    /** Static context added to all logs */
+    context?: LogContext;
+    /** Logger namespace for child loggers */
+    namespace?: string;
+}
+/**
+ * Base transport configuration
+ */
+export interface TransportConfig {
+    /** Transport name for identification */
+    name: string;
+    /** Enable/disable this transport (default: true) */
+    enabled?: boolean;
+    /** Minimum log level for this transport */
+    level?: LogLevel;
+    /** Filter function for entries */
+    filter?: (entry: LogEntry) => boolean;
+}
+/**
+ * Transport interface for log output
+ */
+export interface Transport {
+    /** Transport identifier */
+    readonly name: string;
+    /** Transport configuration */
+    readonly config: TransportConfig;
+    /** Initialize transport (called once on startup) */
+    init?(): Promise<void>;
+    /** Log a single entry */
+    log(entry: LogEntry): void | Promise<void>;
+    /** Flush any buffered entries */
+    flush?(): Promise<void>;
+    /** Cleanup resources (called on shutdown) */
+    destroy?(): Promise<void>;
+}
+/**
+ * Configuration for batch transports
+ */
+export interface BatchTransportConfig extends TransportConfig {
+    /** Maximum entries before auto-flush (default: 100) */
+    batchSize?: number;
+    /** Interval in ms between auto-flushes (default: 5000) */
+    flushInterval?: number;
+    /** Maximum retry attempts on failure (default: 3) */
+    maxRetries?: number;
+    /** Delay between retries in ms (default: 1000) */
+    retryDelay?: number;
+}
+/**
+ * HTTP transport configuration
+ */
+export interface HTTPTransportConfig extends BatchTransportConfig {
+    /** Destination URL for log entries */
+    url: string;
+    /** HTTP method (default: POST) */
+    method?: 'POST' | 'PUT';
+    /** Custom headers */
+    headers?: Record<string, string>;
+    /** Request timeout in ms (default: 30000) */
+    timeout?: number;
+    /** Transform entries before sending */
+    transform?: (entries: LogEntry[]) => unknown;
+}
+/**
+ * File transport configuration
+ */
+export interface FileTransportConfig extends BatchTransportConfig {
+    /** Log file path */
+    path: string;
+    /** Maximum file size in bytes before rotation (default: 10MB) */
+    maxSize?: number;
+    /** Maximum number of rotated files to keep (default: 5) */
+    maxFiles?: number;
+    /** Compress rotated files with gzip (default: false) */
+    compress?: boolean;
+}
+/**
+ * Datadog transport configuration
+ */
+export interface DatadogTransportConfig extends BatchTransportConfig {
+    /** Datadog API key */
+    apiKey: string;
+    /** Datadog site (default: datadoghq.com) */
+    site?: 'datadoghq.com' | 'datadoghq.eu' | 'us3.datadoghq.com' | 'us5.datadoghq.com';
+    /** Service name for logs */
+    service?: string;
+    /** Log source identifier */
+    source?: string;
+    /** Additional tags */
+    tags?: string[];
+}
+/**
+ * Logger interface
+ */
+export interface Logger {
+    trace(message: string, metadata?: LogMetadata): void;
+    trace(...args: unknown[]): void;
+    debug(message: string, metadata?: LogMetadata): void;
+    debug(...args: unknown[]): void;
+    info(message: string, metadata?: LogMetadata): void;
+    info(...args: unknown[]): void;
+    warn(message: string, metadata?: LogMetadata): void;
+    warn(...args: unknown[]): void;
+    error(message: string, metadata?: LogMetadata): void;
+    error(...args: unknown[]): void;
+    child(namespace: string, config?: Partial<LoggerConfig>): Logger;
+    setLevel(level: LogLevel): void;
+    getLevel(): LogLevel;
+    enable(): void;
+    disable(): void;
+    isEnabled(): boolean;
+    flush(): Promise<void>;
+    /** Add a transport to the logger */
+    addTransport(transport: Transport): void;
+    /** Remove a transport by name */
+    removeTransport(name: string): boolean;
+    /** Get all registered transports */
+    getTransports(): readonly Transport[];
+    /** Destroy all transports (call on shutdown) */
+    destroy(): Promise<void>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/dist/utils/buffer.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Circular buffer configuration
+ */
+export interface CircularBufferConfig {
+    maxSize: number;
+    onDrop?: (items: unknown[]) => void;
+}
+/**
+ * A memory-safe circular buffer for storing log entries
+ */
+export declare class CircularBuffer<T> {
+    private buffer;
+    private head;
+    private tail;
+    private count;
+    private dropped;
+    private readonly maxSize;
+    private readonly onDrop?;
+    constructor(config: CircularBufferConfig);
+    /**
+     * Add an item to the buffer
+     */
+    push(item: T): void;
+    /**
+     * Remove and return the oldest item
+     */
+    shift(): T | undefined;
+    /**
+     * Get the oldest item without removing
+     */
+    peek(): T | undefined;
+    /**
+     * Convert buffer to array (oldest first)
+     */
+    toArray(): T[];
+    /**
+     * Clear the buffer
+     */
+    clear(): void;
+    /**
+     * Get current size
+     */
+    get size(): number;
+    /**
+     * Get dropped count
+     */
+    get droppedCount(): number;
+    /**
+     * Check if buffer is full
+     */
+    get isFull(): boolean;
+    /**
+     * Get buffer statistics
+     */
+    getStats(): {
+        size: number;
+        maxSize: number;
+        dropped: number;
+        utilization: number;
+    };
+}
+//# sourceMappingURL=buffer.d.ts.map

package/dist/utils/buffer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"buffer.d.ts","sourceRoot":"","sources":["../../src/utils/buffer.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACpC,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,IAAI,CAAA;CACnC;AAED;;GAEG;AACH,qBAAa,cAAc,CAAC,CAAC;IAC5B,OAAO,CAAC,MAAM,CAAmB;IACjC,OAAO,CAAC,IAAI,CAAI;IAChB,OAAO,CAAC,IAAI,CAAI;IAChB,OAAO,CAAC,KAAK,CAAI;IACjB,OAAO,CAAC,OAAO,CAAI;IACnB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAQ;IAChC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAsB;gBAElC,MAAM,EAAE,oBAAoB;IAMxC;;OAEG;IACH,IAAI,CAAC,IAAI,EAAE,CAAC,GAAG,IAAI;IAiBnB;;OAEG;IACH,KAAK,IAAI,CAAC,GAAG,SAAS;IAWtB;;OAEG;IACH,IAAI,IAAI,CAAC,GAAG,SAAS;IAKrB;;OAEG;IACH,OAAO,IAAI,CAAC,EAAE;IAad;;OAEG;IACH,KAAK,IAAI,IAAI;IAOb;;OAEG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED;;OAEG;IACH,IAAI,YAAY,IAAI,MAAM,CAEzB;IAED;;OAEG;IACH,IAAI,MAAM,IAAI,OAAO,CAEpB;IAED;;OAEG;IACH,QAAQ,IAAI;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE;CAQnF"}

package/dist/utils/buffer.js

@@ -0,0 +1,110 @@
+/**
+ * A memory-safe circular buffer for storing log entries
+ */
+export class CircularBuffer {
+    buffer;
+    head = 0;
+    tail = 0;
+    count = 0;
+    dropped = 0;
+    maxSize;
+    onDrop;
+    constructor(config) {
+        this.maxSize = config.maxSize;
+        this.buffer = new Array(config.maxSize);
+        this.onDrop = config.onDrop;
+    }
+    /**
+     * Add an item to the buffer
+     */
+    push(item) {
+        if (this.count === this.maxSize) {
+            // Buffer full, drop oldest
+            const dropped = this.buffer[this.head];
+            if (dropped !== undefined && this.onDrop) {
+                this.onDrop([dropped]);
+            }
+            this.head = (this.head + 1) % this.maxSize;
+            this.dropped++;
+        }
+        else {
+            this.count++;
+        }
+        this.buffer[this.tail] = item;
+        this.tail = (this.tail + 1) % this.maxSize;
+    }
+    /**
+     * Remove and return the oldest item
+     */
+    shift() {
+        if (this.count === 0)
+            return undefined;
+        const item = this.buffer[this.head];
+        this.buffer[this.head] = undefined;
+        this.head = (this.head + 1) % this.maxSize;
+        this.count--;
+        return item;
+    }
+    /**
+     * Get the oldest item without removing
+     */
+    peek() {
+        if (this.count === 0)
+            return undefined;
+        return this.buffer[this.head];
+    }
+    /**
+     * Convert buffer to array (oldest first)
+     */
+    toArray() {
+        const result = [];
+        let index = this.head;
+        for (let i = 0; i < this.count; i++) {
+            const item = this.buffer[index];
+            if (item !== undefined) {
+                result.push(item);
+            }
+            index = (index + 1) % this.maxSize;
+        }
+        return result;
+    }
+    /**
+     * Clear the buffer
+     */
+    clear() {
+        this.buffer = new Array(this.maxSize);
+        this.head = 0;
+        this.tail = 0;
+        this.count = 0;
+    }
+    /**
+     * Get current size
+     */
+    get size() {
+        return this.count;
+    }
+    /**
+     * Get dropped count
+     */
+    get droppedCount() {
+        return this.dropped;
+    }
+    /**
+     * Check if buffer is full
+     */
+    get isFull() {
+        return this.count === this.maxSize;
+    }
+    /**
+     * Get buffer statistics
+     */
+    getStats() {
+        return {
+            size: this.count,
+            maxSize: this.maxSize,
+            dropped: this.dropped,
+            utilization: this.count / this.maxSize,
+        };
+    }
+}
+//# sourceMappingURL=buffer.js.map

package/dist/utils/buffer.js.map

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

package/dist/utils/error.d.ts

@@ -0,0 +1,14 @@
+import type { SerializedError } from '../types';
+/**
+ * Check if a value is an Error or error-like object
+ */
+export declare function isError(value: unknown): value is Error;
+/**
+ * Serialize an error object with cause chain support
+ */
+export declare function serializeError(error: unknown, depth?: number): SerializedError | undefined;
+/**
+ * Extract error message from any value
+ */
+export declare function getErrorMessage(error: unknown): string;
+//# sourceMappingURL=error.d.ts.map

package/dist/utils/error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error.d.ts","sourceRoot":"","sources":["../../src/utils/error.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAA;AAqB/C;;GAEG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,KAAK,CAQtD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,SAAI,GAAG,eAAe,GAAG,SAAS,CAkDrF;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAQtD"}

package/dist/utils/error.js

@@ -0,0 +1,92 @@
+/**
+ * Maximum depth for error cause chain traversal
+ */
+const MAX_DEPTH = 10;
+/**
+ * Properties to extract from error objects
+ */
+const ERROR_PROPERTIES = [
+    'code',
+    'statusCode',
+    'status',
+    'errno',
+    'syscall',
+    'path',
+    'address',
+    'port',
+];
+/**
+ * Check if a value is an Error or error-like object
+ */
+export function isError(value) {
+    return (value instanceof Error ||
+        (typeof value === 'object' &&
+            value !== null &&
+            'message' in value &&
+            typeof value.message === 'string'));
+}
+/**
+ * Serialize an error object with cause chain support
+ */
+export function serializeError(error, depth = 0) {
+    if (depth > MAX_DEPTH)
+        return undefined;
+    if (!error)
+        return undefined;
+    // Handle Error instances
+    if (error instanceof Error) {
+        const serialized = {
+            name: error.name,
+            message: error.message,
+            stack: error.stack,
+        };
+        // Extract additional properties
+        const errorObj = error;
+        for (const prop of ERROR_PROPERTIES) {
+            const value = errorObj[prop];
+            if (value !== undefined && (typeof value === 'string' || typeof value === 'number')) {
+                serialized[prop] = value;
+            }
+        }
+        // Handle cause chain (ES2022)
+        if ('cause' in error && error.cause) {
+            serialized.cause = serializeError(error.cause, depth + 1);
+        }
+        return serialized;
+    }
+    // Handle error-like objects
+    if (typeof error === 'object' && error !== null) {
+        const obj = error;
+        if (typeof obj.message === 'string') {
+            return {
+                name: obj.name ?? 'Error',
+                message: obj.message,
+                stack: obj.stack,
+            };
+        }
+    }
+    // Handle strings
+    if (typeof error === 'string') {
+        return {
+            name: 'Error',
+            message: error,
+        };
+    }
+    return undefined;
+}
+/**
+ * Extract error message from any value
+ */
+export function getErrorMessage(error) {
+    if (error instanceof Error)
+        return error.message;
+    if (typeof error === 'string')
+        return error;
+    if (typeof error === 'object' && error !== null) {
+        const obj = error;
+        if (typeof obj.message === 'string')
+            return obj.message;
+    }
+    return String(error);
+}
+//# sourceMappingURL=error.js.map

package/dist/utils/error.js.map

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