@dotdo/postgres 0.1.0

package/dist/observability/exporters.js

@@ -0,0 +1,479 @@
+/**
+ * Span Exporters
+ *
+ * Export spans to various destinations (console, structured logs, etc.)
+ * Designed for Cloudflare Workers where console output becomes structured logs.
+ *
+ * ## Available Exporters
+ *
+ * | Exporter | Use Case | Features |
+ * |----------|----------|----------|
+ * | `ConsoleExporter` | Development/debugging | Colored output, log level control |
+ * | `StructuredExporter` | Production | JSON lines for log aggregation |
+ * | `BatchExporter` | Any | Buffers spans, flushes periodically |
+ * | `MultiExporter` | Multi-destination | Sends to multiple exporters |
+ * | `ResilientExporter` | Production | Circuit breaker, retries, metrics |
+ * | `NoOpExporter` | Testing/disabled | Does nothing |
+ *
+ * @module
+ */
+import { SpanStatusCode } from './types';
+import { createLogger, LogLevel } from '@dotdo/postgres-shared';
+// Re-export SpanKind for external use
+export { SpanKind } from './types';
+// Module-level logger for exporter errors
+const exporterLogger = createLogger({
+    level: LogLevel.ERROR,
+    prefix: '[Exporter]',
+});
+/**
+ * Format span for console output
+ */
+function formatSpan(span, prettyPrint) {
+    const duration = span.endTime
+        ? (span.endTime - span.startTime).toFixed(2)
+        : 'N/A';
+    const statusText = span.status.code === SpanStatusCode.OK
+        ? 'OK'
+        : span.status.code === SpanStatusCode.ERROR
+            ? 'ERROR'
+            : 'UNSET';
+    const kindText = ['INTERNAL', 'SERVER', 'CLIENT', 'PRODUCER', 'CONSUMER'][span.kind];
+    const data = {
+        name: span.name,
+        traceId: span.context.traceId,
+        spanId: span.context.spanId,
+        parentSpanId: span.context.parentSpanId,
+        kind: kindText,
+        status: statusText,
+        statusMessage: span.status.message,
+        durationMs: duration,
+        attributes: span.attributes,
+        events: span.events.length > 0 ? span.events : undefined,
+        resource: span.resource,
+    };
+    // Remove undefined fields
+    Object.keys(data).forEach((key) => {
+        if (data[key] === undefined) {
+            delete data[key];
+        }
+    });
+    return prettyPrint ? JSON.stringify(data, null, 2) : JSON.stringify(data);
+}
+/**
+ * Console exporter - outputs spans to console
+ *
+ * In Cloudflare Workers, console output is captured and can be exported
+ * as structured logs to your observability backend.
+ */
+export class ConsoleExporter {
+    config;
+    constructor(config) {
+        this.config = {
+            logLevel: config?.logLevel ?? 'info',
+            prettyPrint: config?.prettyPrint ?? false,
+        };
+    }
+    async export(spans) {
+        for (const span of spans) {
+            const formatted = formatSpan(span, this.config.prettyPrint ?? false);
+            const hasError = span.status.code === SpanStatusCode.ERROR;
+            switch (this.config.logLevel) {
+                case 'debug':
+                    console.debug('[TRACE]', formatted);
+                    break;
+                case 'info':
+                    console.info('[TRACE]', formatted);
+                    break;
+                case 'warn':
+                    console.warn('[TRACE]', formatted);
+                    break;
+                case 'error':
+                    if (hasError) {
+                        console.error('[TRACE]', formatted);
+                    }
+                    break;
+            }
+        }
+    }
+    async shutdown() {
+        // Console exporter doesn't need cleanup
+    }
+}
+/**
+ * Create a console exporter
+ */
+export function createConsoleExporter(config) {
+    return new ConsoleExporter(config);
+}
+/**
+ * Structured exporter - outputs spans as structured JSON logs
+ *
+ * This is the recommended exporter for Cloudflare Workers as it integrates
+ * well with Cloudflare's log export to OpenTelemetry backends.
+ */
+export class StructuredExporter {
+    async export(spans) {
+        for (const span of spans) {
+            const log = {
+                level: 'trace',
+                timestamp: new Date(span.startTime).toISOString(),
+                name: span.name,
+                traceId: span.context.traceId,
+                spanId: span.context.spanId,
+                durationMs: span.endTime ? span.endTime - span.startTime : 0,
+                statusCode: span.status.code === SpanStatusCode.OK
+                    ? 'ok'
+                    : span.status.code === SpanStatusCode.ERROR
+                        ? 'error'
+                        : 'unset',
+                kind: ['INTERNAL', 'SERVER', 'CLIENT', 'PRODUCER', 'CONSUMER'][span.kind] ?? 'INTERNAL',
+                attributes: span.attributes,
+                service: {
+                    name: span.resource['service.name'] ?? 'unknown',
+                    ...(span.resource['service.version'] !== undefined && {
+                        version: span.resource['service.version'],
+                    }),
+                },
+            };
+            // Add optional fields only if defined
+            if (span.context.parentSpanId !== undefined) {
+                log.parentSpanId = span.context.parentSpanId;
+            }
+            if (span.status.message !== undefined) {
+                log.statusMessage = span.status.message;
+            }
+            // Output as JSON line for log export
+            console.log(JSON.stringify(log));
+        }
+    }
+    async shutdown() {
+        // Structured exporter doesn't need cleanup
+    }
+}
+/**
+ * Create a structured exporter
+ */
+export function createStructuredExporter() {
+    return new StructuredExporter();
+}
+/**
+ * Batch exporter - buffers spans and exports in batches
+ */
+export class BatchExporter {
+    delegate;
+    buffer = [];
+    batchSize;
+    flushInterval;
+    timer;
+    constructor(delegate, options) {
+        this.delegate = delegate;
+        this.batchSize = options?.batchSize ?? 100;
+        this.flushInterval = options?.flushIntervalMs ?? 5000;
+    }
+    async export(spans) {
+        this.buffer.push(...spans);
+        if (this.buffer.length >= this.batchSize) {
+            await this.flush();
+        }
+        else if (!this.timer) {
+            // Schedule a flush
+            this.timer = setTimeout(() => {
+                void this.flush().catch((err) => exporterLogger.error('Flush failed', { error: err instanceof Error ? err.message : String(err) }));
+            }, this.flushInterval);
+        }
+    }
+    async flush() {
+        if (this.timer) {
+            clearTimeout(this.timer);
+            delete this.timer;
+        }
+        if (this.buffer.length === 0) {
+            return;
+        }
+        const spans = this.buffer;
+        this.buffer = [];
+        await this.delegate.export(spans);
+    }
+    async shutdown() {
+        await this.flush();
+        await this.delegate.shutdown();
+    }
+}
+/**
+ * Create a batch exporter
+ */
+export function createBatchExporter(delegate, options) {
+    return new BatchExporter(delegate, options);
+}
+/**
+ * Multi-exporter - exports to multiple destinations
+ *
+ * Uses Promise.allSettled to ensure all exporters are attempted even if some fail.
+ * Failed exports are logged but do not cause the overall export to fail.
+ */
+export class MultiExporter {
+    exporters;
+    constructor(exporters) {
+        this.exporters = exporters;
+    }
+    async export(spans) {
+        const results = await Promise.allSettled(this.exporters.map((e) => e.export(spans)));
+        // Log any failures but don't throw
+        for (let i = 0; i < results.length; i++) {
+            const result = results[i];
+            if (result && result.status === 'rejected') {
+                const reason = result.reason;
+                exporterLogger.error('Exporter failed', {
+                    exporterIndex: i,
+                    error: reason instanceof Error ? reason.message : String(reason),
+                });
+            }
+        }
+    }
+    async shutdown() {
+        const results = await Promise.allSettled(this.exporters.map((e) => e.shutdown()));
+        // Log any shutdown failures
+        for (let i = 0; i < results.length; i++) {
+            const result = results[i];
+            if (result && result.status === 'rejected') {
+                const reason = result.reason;
+                exporterLogger.error('Exporter shutdown failed', {
+                    exporterIndex: i,
+                    error: reason instanceof Error ? reason.message : String(reason),
+                });
+            }
+        }
+    }
+}
+/**
+ * Create a multi-exporter
+ */
+export function createMultiExporter(exporters) {
+    return new MultiExporter(exporters);
+}
+/**
+ * No-op exporter for when exporting is disabled
+ */
+export class NoOpExporter {
+    async export() {
+        // No-op
+    }
+    async shutdown() {
+        // No-op
+    }
+}
+/**
+ * Create a no-op exporter
+ */
+export function createNoOpExporter() {
+    return new NoOpExporter();
+}
+/**
+ * Resilient exporter with circuit breaker, retries, and metrics
+ *
+ * This exporter wraps any SpanExporter to add:
+ * - Circuit breaker pattern to prevent cascading failures
+ * - Automatic retries with exponential backoff
+ * - Span buffering during failures
+ * - Comprehensive metrics for observability overhead tracking
+ */
+export class ResilientExporter {
+    delegate;
+    config;
+    circuitState = 'closed';
+    consecutiveFailures = 0;
+    lastFailureTime = 0;
+    buffer = [];
+    stats = {
+        totalExports: 0,
+        successfulExports: 0,
+        failedExports: 0,
+        spansExported: 0,
+        spansDropped: 0,
+        spansBuffered: 0,
+        totalExportTimeMs: 0,
+        avgExportTimeMs: 0,
+        circuitState: 'closed',
+        circuitOpenCount: 0,
+    };
+    constructor(delegate, config) {
+        this.delegate = delegate;
+        this.config = {
+            failureThreshold: config?.failureThreshold ?? 5,
+            resetTimeoutMs: config?.resetTimeoutMs ?? 30000,
+            maxRetries: config?.maxRetries ?? 2,
+            retryDelayMs: config?.retryDelayMs ?? 100,
+            exponentialBackoff: config?.exponentialBackoff ?? true,
+            maxBufferSize: config?.maxBufferSize ?? 1000,
+        };
+    }
+    async export(spans) {
+        this.stats.totalExports++;
+        // Check circuit state
+        if (this.circuitState === 'open') {
+            const timeSinceFailure = Date.now() - this.lastFailureTime;
+            if (timeSinceFailure >= this.config.resetTimeoutMs) {
+                // Transition to half-open
+                this.circuitState = 'half-open';
+                this.stats.circuitState = 'half-open';
+            }
+            else {
+                // Circuit is open, buffer spans
+                this.bufferSpans(spans);
+                return;
+            }
+        }
+        const startTime = performance.now();
+        let lastError;
+        // Try to export with retries
+        for (let attempt = 0; attempt <= this.config.maxRetries; attempt++) {
+            try {
+                // Include buffered spans on retry or when circuit is half-open
+                const spansToExport = this.circuitState === 'half-open' || attempt > 0
+                    ? [...this.buffer, ...spans]
+                    : spans;
+                await this.delegate.export(spansToExport);
+                // Success
+                const exportTime = performance.now() - startTime;
+                this.recordSuccess(spansToExport.length, exportTime);
+                // Clear buffer on success
+                if (this.buffer.length > 0) {
+                    this.buffer = [];
+                    this.stats.spansBuffered = 0;
+                }
+                return;
+            }
+            catch (err) {
+                lastError = err instanceof Error ? err : new Error(String(err));
+                // Delay before retry
+                if (attempt < this.config.maxRetries) {
+                    const delay = this.config.exponentialBackoff
+                        ? this.config.retryDelayMs * Math.pow(2, attempt)
+                        : this.config.retryDelayMs;
+                    await this.sleep(delay);
+                }
+            }
+        }
+        // All retries failed
+        const exportTime = performance.now() - startTime;
+        this.recordFailure(spans.length, exportTime, lastError?.message ?? 'Unknown error');
+        // Buffer spans for later retry
+        this.bufferSpans(spans);
+    }
+    async shutdown() {
+        // Try to flush buffer before shutdown
+        if (this.buffer.length > 0 && this.circuitState !== 'open') {
+            try {
+                await this.delegate.export(this.buffer);
+                this.buffer = [];
+                this.stats.spansBuffered = 0;
+            }
+            catch (err) {
+                exporterLogger.error('Failed to flush buffer on shutdown', {
+                    error: err instanceof Error ? err.message : String(err),
+                    spansDropped: this.buffer.length,
+                });
+                this.stats.spansDropped += this.buffer.length;
+            }
+        }
+        await this.delegate.shutdown();
+    }
+    /**
+     * Get current exporter statistics
+     */
+    getStats() {
+        return { ...this.stats };
+    }
+    /**
+     * Reset statistics
+     */
+    resetStats() {
+        this.stats = {
+            totalExports: 0,
+            successfulExports: 0,
+            failedExports: 0,
+            spansExported: 0,
+            spansDropped: 0,
+            spansBuffered: this.buffer.length,
+            totalExportTimeMs: 0,
+            avgExportTimeMs: 0,
+            circuitState: this.circuitState,
+            circuitOpenCount: this.stats.circuitOpenCount,
+        };
+    }
+    /**
+     * Manually reset circuit breaker (for recovery scenarios)
+     */
+    resetCircuit() {
+        this.circuitState = 'closed';
+        this.consecutiveFailures = 0;
+        this.stats.circuitState = 'closed';
+    }
+    recordSuccess(spanCount, exportTimeMs) {
+        this.stats.successfulExports++;
+        this.stats.spansExported += spanCount;
+        this.stats.totalExportTimeMs += exportTimeMs;
+        this.stats.avgExportTimeMs = this.stats.totalExportTimeMs / this.stats.successfulExports;
+        this.stats.lastExportTimestamp = Date.now();
+        // Reset circuit breaker on success
+        this.consecutiveFailures = 0;
+        if (this.circuitState === 'half-open') {
+            this.circuitState = 'closed';
+            this.stats.circuitState = 'closed';
+        }
+    }
+    recordFailure(spanCount, exportTimeMs, error) {
+        this.stats.failedExports++;
+        this.stats.totalExportTimeMs += exportTimeMs;
+        this.stats.lastError = error;
+        this.consecutiveFailures++;
+        this.lastFailureTime = Date.now();
+        exporterLogger.error('Export failed after retries', {
+            error,
+            consecutiveFailures: this.consecutiveFailures,
+            spanCount,
+        });
+        // Check if circuit should open
+        if (this.consecutiveFailures >= this.config.failureThreshold) {
+            this.circuitState = 'open';
+            this.stats.circuitState = 'open';
+            this.stats.circuitOpenCount++;
+            exporterLogger.error('Circuit breaker opened', {
+                consecutiveFailures: this.consecutiveFailures,
+                resetTimeoutMs: this.config.resetTimeoutMs,
+            });
+        }
+    }
+    bufferSpans(spans) {
+        const spaceAvailable = this.config.maxBufferSize - this.buffer.length;
+        if (spaceAvailable <= 0) {
+            // Buffer full, drop oldest spans
+            const toDrop = spans.length - spaceAvailable;
+            this.buffer.splice(0, toDrop);
+            this.stats.spansDropped += toDrop;
+        }
+        const spansToBuffer = spans.slice(0, this.config.maxBufferSize - this.buffer.length);
+        this.buffer.push(...spansToBuffer);
+        this.stats.spansBuffered = this.buffer.length;
+        // Track dropped spans
+        const dropped = spans.length - spansToBuffer.length;
+        if (dropped > 0) {
+            this.stats.spansDropped += dropped;
+        }
+    }
+    sleep(ms) {
+        return new Promise((resolve) => setTimeout(resolve, ms));
+    }
+}
+/**
+ * Create a resilient exporter with circuit breaker and metrics
+ *
+ * @param delegate - The underlying exporter to wrap
+ * @param config - Configuration options
+ * @returns A resilient exporter instance
+ */
+export function createResilientExporter(delegate, config) {
+    return new ResilientExporter(delegate, config);
+}
+//# sourceMappingURL=exporters.js.map

package/dist/observability/exporters.js.map

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

package/dist/observability/health-check.d.ts

@@ -0,0 +1,106 @@
+/**
+ * Health Check System
+ *
+ * Provides liveness and readiness probes for Kubernetes-style health checking.
+ */
+import type { MetricsCollector } from './types';
+/** Health status levels */
+export declare enum HealthStatus {
+    HEALTHY = "healthy",
+    DEGRADED = "degraded",
+    UNHEALTHY = "unhealthy"
+}
+/** Component health check result */
+export interface ComponentHealth {
+    name: string;
+    status: HealthStatus;
+    error?: string;
+    responseTimeMs?: number;
+    details?: Record<string, unknown>;
+}
+/** Overall health check response */
+export interface HealthResponse {
+    status: HealthStatus;
+    service: string;
+    uptimeMs: number;
+    components: ComponentHealth[];
+    metrics?: {
+        totalRequests?: number;
+        errorCount?: number;
+        [key: string]: unknown;
+    };
+    timestamp: number;
+}
+/** Health checker function */
+export type HealthChecker = () => Promise<ComponentHealth>;
+/** Health check manager configuration */
+export interface HealthCheckConfig {
+    serviceName: string;
+    timeout?: number;
+    checkers?: Record<string, HealthChecker>;
+    metricsCollector?: MetricsCollector;
+}
+/** Health handler configuration */
+export interface HealthHandlerConfig {
+    basePath?: string;
+    corsOrigin?: string;
+}
+/** Health check manager interface */
+export interface HealthCheckManager {
+    liveness(): HealthResponse;
+    check(): Promise<HealthResponse>;
+    addChecker(name: string, checker: HealthChecker): void;
+    removeChecker(name: string): void;
+    getUptime(): number;
+}
+export declare class HealthCheckManagerImpl implements HealthCheckManager {
+    private readonly serviceName;
+    private readonly timeout;
+    private readonly metricsCollector?;
+    private checkers;
+    private readonly startTime;
+    constructor(config: HealthCheckConfig);
+    liveness(): HealthResponse;
+    check(): Promise<HealthResponse>;
+    addChecker(name: string, checker: HealthChecker): void;
+    removeChecker(name: string): void;
+    getUptime(): number;
+}
+/**
+ * Create a health check manager
+ */
+export declare function createHealthCheckManager(config: HealthCheckConfig): HealthCheckManager;
+/**
+ * Create a PGLite health checker
+ */
+export declare function createPGLiteChecker(getPGLite: () => {
+    query: (sql: string) => Promise<unknown>;
+} | null): HealthChecker;
+/**
+ * Create a memory health checker
+ */
+export declare function createMemoryChecker(options: {
+    warningThreshold: number;
+    criticalThreshold: number;
+    getMemoryUsage: () => number;
+    memoryLimitBytes: number;
+}): HealthChecker;
+/**
+ * Create a storage tier health checker
+ */
+export declare function createStorageTierChecker(tiers: {
+    hot?: {
+        check: () => Promise<boolean>;
+    };
+    warm?: {
+        check: () => Promise<boolean>;
+    };
+    cold?: {
+        check: () => Promise<boolean>;
+    };
+}): HealthChecker;
+/**
+ * Create an HTTP handler for health endpoints
+ */
+export declare function createHealthHandler(manager: HealthCheckManager, config?: HealthHandlerConfig): (request: Request) => Promise<Response | null>;
+//# sourceMappingURL=health-check.d.ts.map

package/dist/observability/health-check.d.ts.map

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