@dotdo/postgres 0.1.0

package/dist/observability/error-rate-collector.js

@@ -0,0 +1,306 @@
+/**
+ * Error Rate Collector
+ *
+ * Tracks error rates with time-windowed sliding window calculations,
+ * error categorization, and trend analysis.
+ */
+export class ErrorRateCollectorImpl {
+    config;
+    errors = [];
+    constructor(config) {
+        this.config = {
+            defaultWindowMs: config?.defaultWindowMs ?? 60_000,
+            retentionMs: config?.retentionMs ?? 86400_000,
+            ...(config?.metricsCollector !== undefined && { metricsCollector: config.metricsCollector }),
+        };
+    }
+    recordError(event) {
+        const record = {
+            category: event.category,
+            message: event.message,
+            timestamp: event.timestamp ?? Date.now(),
+            code: event.code ?? 'unknown',
+            severity: event.severity ?? 'error',
+            tags: event.tags ?? {},
+        };
+        this.errors.push(record);
+        if (this.config.metricsCollector) {
+            this.config.metricsCollector.increment('postgres.errors.count', 1, {
+                category: event.category,
+                severity: record.severity,
+            });
+        }
+    }
+    getErrorRate(filter) {
+        const windowMs = filter?.windowMs ?? this.config.defaultWindowMs;
+        const now = Date.now();
+        const windowStart = now - windowMs;
+        const windowEnd = now;
+        const filteredErrors = this.filterErrors(filter, windowStart, windowEnd);
+        const count = filteredErrors.length;
+        const windowSeconds = windowMs / 1000;
+        const windowMinutes = windowMs / 60_000;
+        const windowHours = windowMs / 3600_000;
+        return {
+            count,
+            windowMs,
+            ratePerSecond: count / windowSeconds,
+            ratePerMinute: count / windowMinutes,
+            ratePerHour: count / windowHours,
+            windowStart,
+            windowEnd,
+        };
+    }
+    getErrorBuckets(options) {
+        const { windowMs, bucketSizeMs } = options;
+        const now = Date.now();
+        const numBuckets = Math.ceil(windowMs / bucketSizeMs);
+        const buckets = [];
+        for (let i = 0; i < numBuckets; i++) {
+            const bucketStart = now - (i + 1) * bucketSizeMs;
+            const bucketEnd = now - i * bucketSizeMs;
+            const count = this.errors.filter((e) => e.timestamp >= bucketStart && e.timestamp < bucketEnd).length;
+            buckets.push({ startTimestamp: bucketStart, endTimestamp: bucketEnd, count });
+        }
+        return buckets;
+    }
+    getErrorsByCategory(filter) {
+        const windowMs = filter?.windowMs ?? this.config.defaultWindowMs;
+        const now = Date.now();
+        const windowStart = now - windowMs;
+        const result = {};
+        const categories = [
+            'query', 'connection', 'cache', 'storage', 'timeout', 'validation',
+            'authentication', 'authorization', 'rate_limit', 'internal', 'unknown',
+        ];
+        for (const category of categories) {
+            const count = this.errors.filter((e) => e.category === category && e.timestamp >= windowStart).length;
+            const windowMinutes = windowMs / 60_000;
+            result[category] = { count, ratePerMinute: count / windowMinutes };
+        }
+        return result;
+    }
+    getErrorsByCode() {
+        const result = {};
+        const windowMs = this.config.defaultWindowMs;
+        const now = Date.now();
+        const windowStart = now - windowMs;
+        const windowMinutes = windowMs / 60_000;
+        for (const error of this.errors) {
+            if (error.timestamp < windowStart)
+                continue;
+            if (!result[error.code]) {
+                result[error.code] = { count: 0, ratePerMinute: 0 };
+            }
+            result[error.code].count++;
+        }
+        for (const code of Object.keys(result)) {
+            result[code].ratePerMinute = result[code].count / windowMinutes;
+        }
+        return result;
+    }
+    getErrorsBySeverity() {
+        const result = {};
+        const severities = ['debug', 'info', 'warning', 'error', 'critical'];
+        const windowMs = this.config.defaultWindowMs;
+        const now = Date.now();
+        const windowStart = now - windowMs;
+        const windowMinutes = windowMs / 60_000;
+        for (const severity of severities) {
+            const count = this.errors.filter((e) => e.severity === severity && e.timestamp >= windowStart).length;
+            result[severity] = { count, ratePerMinute: count / windowMinutes };
+        }
+        return result;
+    }
+    getTopErrorCodes(options) {
+        const limit = options?.limit ?? 10;
+        const byCode = this.getErrorsByCode();
+        return Object.entries(byCode)
+            .map(([code, stats]) => ({ code, count: stats.count }))
+            .sort((a, b) => b.count - a.count)
+            .slice(0, limit);
+    }
+    analyzeTrend(options) {
+        const { windowMs, periods } = options;
+        const now = Date.now();
+        const periodRates = [];
+        for (let i = 0; i < periods; i++) {
+            const periodStart = now - (periods - i) * windowMs;
+            const periodEnd = now - (periods - i - 1) * windowMs;
+            const count = this.errors.filter((e) => e.timestamp >= periodStart && e.timestamp < periodEnd).length;
+            periodRates.push(count);
+        }
+        const avgRate = periodRates.reduce((sum, r) => sum + r, 0) / periods;
+        let direction = 'stable';
+        let changePercent = 0;
+        // Find first non-zero period for comparison
+        let firstNonZeroIdx = 0;
+        for (let i = 0; i < periodRates.length; i++) {
+            if (periodRates[i] > 0) {
+                firstNonZeroIdx = i;
+                break;
+            }
+        }
+        if (periodRates.length >= 2) {
+            const first = periodRates[firstNonZeroIdx];
+            const last = periodRates[periodRates.length - 1];
+            if (first > 0) {
+                changePercent = ((last - first) / first) * 100;
+            }
+            else if (last > 0) {
+                changePercent = Infinity;
+            }
+            // Use a wide threshold to handle boundary effects
+            if (changePercent > 50) {
+                direction = 'increasing';
+            }
+            else if (changePercent < -50) {
+                direction = 'decreasing';
+            }
+        }
+        return { direction, changePercent, avgRate, periodRates };
+    }
+    detectSpikes(options) {
+        const { windowMs, threshold } = options;
+        const now = Date.now();
+        const numBuckets = 10;
+        const buckets = [];
+        for (let i = 0; i < numBuckets; i++) {
+            const bucketEnd = now - i * windowMs;
+            const bucketStart = bucketEnd - windowMs;
+            const count = this.errors.filter((e) => e.timestamp >= bucketStart && e.timestamp < bucketEnd).length;
+            buckets.push({ timestamp: bucketStart, count });
+        }
+        if (buckets.length < 2)
+            return [];
+        const baselineBuckets = buckets.slice(1);
+        const baselineCounts = baselineBuckets.map((b) => b.count);
+        const mean = baselineCounts.reduce((sum, c) => sum + c, 0) / baselineCounts.length;
+        if (mean < 1) {
+            const mostRecentCount = buckets[0].count;
+            if (mostRecentCount > threshold * 3) {
+                return [{ timestamp: buckets[0].timestamp, count: mostRecentCount, multiplier: mostRecentCount / (mean || 1) }];
+            }
+            return [];
+        }
+        const variance = baselineCounts.reduce((sum, c) => sum + Math.pow(c - mean, 2), 0) / baselineCounts.length;
+        const stdDev = Math.sqrt(variance);
+        const spikes = [];
+        for (const bucket of buckets) {
+            const deviation = stdDev > 0 ? (bucket.count - mean) / stdDev : (bucket.count - mean) / (mean || 1);
+            const multiplier = bucket.count / (mean || 1);
+            if (deviation >= threshold || multiplier >= threshold) {
+                spikes.push({ timestamp: bucket.timestamp, count: bucket.count, multiplier });
+            }
+        }
+        return spikes;
+    }
+    detectAnomalies(options) {
+        const { windowMs, baselineWindowMs, sensitivity } = options;
+        const now = Date.now();
+        const anomalies = [];
+        const categories = [
+            'query', 'connection', 'cache', 'storage', 'timeout', 'validation',
+            'authentication', 'authorization', 'rate_limit', 'internal', 'unknown',
+        ];
+        for (const category of categories) {
+            const currentCount = this.errors.filter((e) => e.category === category && e.timestamp >= now - windowMs).length;
+            const currentRate = currentCount / (windowMs / 60_000);
+            const baselineCount = this.errors.filter((e) => e.category === category && e.timestamp >= now - baselineWindowMs && e.timestamp < now - windowMs).length;
+            const baselineWindowMinutes = (baselineWindowMs - windowMs) / 60_000;
+            const baselineRate = baselineWindowMinutes > 0 ? baselineCount / baselineWindowMinutes : 0;
+            if (baselineRate > 0) {
+                const deviationFactor = currentRate / baselineRate;
+                if (deviationFactor >= sensitivity) {
+                    let severity = 'low';
+                    if (deviationFactor >= sensitivity * 3)
+                        severity = 'high';
+                    else if (deviationFactor >= sensitivity * 2)
+                        severity = 'medium';
+                    anomalies.push({ category, severity, expectedRate: baselineRate, actualRate: currentRate, deviationFactor });
+                }
+            }
+        }
+        return anomalies;
+    }
+    getRateChange(options) {
+        const { currentWindowMs, previousWindowMs } = options;
+        const now = Date.now();
+        const currentCount = this.errors.filter((e) => e.timestamp >= now - currentWindowMs).length;
+        const previousStart = now - currentWindowMs - previousWindowMs;
+        const previousEnd = now - currentWindowMs;
+        const previousCount = this.errors.filter((e) => e.timestamp >= previousStart && e.timestamp < previousEnd).length;
+        let percentChange = 0;
+        if (previousCount > 0) {
+            percentChange = ((currentCount - previousCount) / previousCount) * 100;
+        }
+        else if (currentCount > 0) {
+            percentChange = Infinity;
+        }
+        return { currentRate: currentCount, previousRate: previousCount, percentChange };
+    }
+    getMovingAverage(options) {
+        const { windowMs, periods } = options;
+        const now = Date.now();
+        let totalCount = 0;
+        for (let i = 0; i < periods; i++) {
+            const periodEnd = now - i * windowMs;
+            const periodStart = periodEnd - windowMs;
+            const count = this.errors.filter((e) => e.timestamp >= periodStart && e.timestamp < periodEnd).length;
+            totalCount += count;
+        }
+        return totalCount / periods;
+    }
+    compareToHistorical(options) {
+        const { currentWindowMs, historicalWindowMs } = options;
+        const now = Date.now();
+        const currentCount = this.errors.filter((e) => e.timestamp >= now - currentWindowMs).length;
+        const currentRate = currentCount;
+        const historicalStart = now - historicalWindowMs;
+        const historicalEnd = now - currentWindowMs;
+        const historicalCount = this.errors.filter((e) => e.timestamp >= historicalStart && e.timestamp < historicalEnd).length;
+        const historicalRange = historicalEnd - historicalStart;
+        const numPeriods = historicalRange / currentWindowMs;
+        const historicalAverage = numPeriods > 0 ? historicalCount / numPeriods : 0;
+        const ratio = historicalAverage > 0 ? currentRate / historicalAverage : 0;
+        return { currentRate, historicalAverage, ratio };
+    }
+    getSnapshot() {
+        return {
+            totalErrors: this.errors.length,
+            byCategory: this.getErrorsByCategory(),
+            bySeverity: this.getErrorsBySeverity(),
+            recentRate: this.getErrorRate(),
+            timestamp: Date.now(),
+        };
+    }
+    cleanup() {
+        const now = Date.now();
+        const cutoff = now - this.config.retentionMs;
+        this.errors = this.errors.filter((e) => e.timestamp >= cutoff);
+    }
+    reset() {
+        this.errors = [];
+    }
+    filterErrors(filter, windowStart, windowEnd) {
+        return this.errors.filter((e) => {
+            if (e.timestamp < windowStart || e.timestamp > windowEnd)
+                return false;
+            if (filter?.category && e.category !== filter.category)
+                return false;
+            if (filter?.severity && e.severity !== filter.severity)
+                return false;
+            if (filter?.tags) {
+                for (const [key, value] of Object.entries(filter.tags)) {
+                    if (e.tags[key] !== value)
+                        return false;
+                }
+            }
+            return true;
+        });
+    }
+}
+export function createErrorRateCollector(config) {
+    return new ErrorRateCollectorImpl(config);
+}
+//# sourceMappingURL=error-rate-collector.js.map

package/dist/observability/error-rate-collector.js.map

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

package/dist/observability/exporters.d.ts

@@ -0,0 +1,231 @@
+/**
+ * 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 type { Span, SpanExporter, ConsoleExporterConfig, SpanAttributes } from './types';
+export { SpanKind } from './types';
+/**
+ * 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 declare class ConsoleExporter implements SpanExporter {
+    private config;
+    constructor(config?: ConsoleExporterConfig);
+    export(spans: Span[]): Promise<void>;
+    shutdown(): Promise<void>;
+}
+/**
+ * Create a console exporter
+ */
+export declare function createConsoleExporter(config?: ConsoleExporterConfig): SpanExporter;
+/**
+ * Structured log format for Cloudflare Workers
+ * This format is optimized for Cloudflare's log export to OTel backends
+ */
+export interface StructuredSpanLog {
+    /** Log level */
+    level: 'trace';
+    /** Timestamp in ISO format */
+    timestamp: string;
+    /** Span name */
+    name: string;
+    /** Trace ID for correlation */
+    traceId: string;
+    /** Span ID */
+    spanId: string;
+    /** Parent span ID */
+    parentSpanId?: string;
+    /** Duration in milliseconds */
+    durationMs: number;
+    /** Status code */
+    statusCode: 'ok' | 'error' | 'unset';
+    /** Status message (for errors) */
+    statusMessage?: string;
+    /** Span kind */
+    kind: string;
+    /** Span attributes */
+    attributes: SpanAttributes;
+    /** Service info */
+    service: {
+        name: string;
+        version?: string;
+    };
+}
+/**
+ * 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 declare class StructuredExporter implements SpanExporter {
+    export(spans: Span[]): Promise<void>;
+    shutdown(): Promise<void>;
+}
+/**
+ * Create a structured exporter
+ */
+export declare function createStructuredExporter(): SpanExporter;
+/**
+ * Batch exporter - buffers spans and exports in batches
+ */
+export declare class BatchExporter implements SpanExporter {
+    private delegate;
+    private buffer;
+    private batchSize;
+    private flushInterval;
+    private timer?;
+    constructor(delegate: SpanExporter, options?: {
+        batchSize?: number;
+        flushIntervalMs?: number;
+    });
+    export(spans: Span[]): Promise<void>;
+    flush(): Promise<void>;
+    shutdown(): Promise<void>;
+}
+/**
+ * Create a batch exporter
+ */
+export declare function createBatchExporter(delegate: SpanExporter, options?: {
+    batchSize?: number;
+    flushIntervalMs?: number;
+}): SpanExporter;
+/**
+ * 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 declare class MultiExporter implements SpanExporter {
+    private exporters;
+    constructor(exporters: SpanExporter[]);
+    export(spans: Span[]): Promise<void>;
+    shutdown(): Promise<void>;
+}
+/**
+ * Create a multi-exporter
+ */
+export declare function createMultiExporter(exporters: SpanExporter[]): SpanExporter;
+/**
+ * No-op exporter for when exporting is disabled
+ */
+export declare class NoOpExporter implements SpanExporter {
+    export(): Promise<void>;
+    shutdown(): Promise<void>;
+}
+/**
+ * Create a no-op exporter
+ */
+export declare function createNoOpExporter(): SpanExporter;
+/**
+ * Configuration for resilient exporter
+ */
+export interface ResilientExporterConfig {
+    /** Maximum number of consecutive failures before circuit opens (default: 5) */
+    failureThreshold?: number;
+    /** Time in ms before attempting to close circuit after opening (default: 30000) */
+    resetTimeoutMs?: number;
+    /** Maximum retry attempts per export (default: 2) */
+    maxRetries?: number;
+    /** Base delay between retries in ms (default: 100) */
+    retryDelayMs?: number;
+    /** Enable exponential backoff for retries (default: true) */
+    exponentialBackoff?: boolean;
+    /** Maximum buffer size for failed exports (default: 1000 spans) */
+    maxBufferSize?: number;
+}
+/**
+ * Circuit breaker state
+ */
+export type CircuitState = 'closed' | 'open' | 'half-open';
+/**
+ * Exporter statistics for observability overhead tracking
+ */
+export interface ExporterStats {
+    /** Total number of export attempts */
+    totalExports: number;
+    /** Number of successful exports */
+    successfulExports: number;
+    /** Number of failed exports */
+    failedExports: number;
+    /** Total spans exported successfully */
+    spansExported: number;
+    /** Total spans dropped due to failures */
+    spansDropped: number;
+    /** Total spans currently buffered */
+    spansBuffered: number;
+    /** Total export time in milliseconds */
+    totalExportTimeMs: number;
+    /** Average export time in milliseconds */
+    avgExportTimeMs: number;
+    /** Current circuit breaker state */
+    circuitState: CircuitState;
+    /** Number of times circuit has opened */
+    circuitOpenCount: number;
+    /** Last export timestamp */
+    lastExportTimestamp?: number;
+    /** Last error message */
+    lastError?: string;
+}
+/**
+ * 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 declare class ResilientExporter implements SpanExporter {
+    private delegate;
+    private config;
+    private circuitState;
+    private consecutiveFailures;
+    private lastFailureTime;
+    private buffer;
+    private stats;
+    constructor(delegate: SpanExporter, config?: ResilientExporterConfig);
+    export(spans: Span[]): Promise<void>;
+    shutdown(): Promise<void>;
+    /**
+     * Get current exporter statistics
+     */
+    getStats(): ExporterStats;
+    /**
+     * Reset statistics
+     */
+    resetStats(): void;
+    /**
+     * Manually reset circuit breaker (for recovery scenarios)
+     */
+    resetCircuit(): void;
+    private recordSuccess;
+    private recordFailure;
+    private bufferSpans;
+    private sleep;
+}
+/**
+ * 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 declare function createResilientExporter(delegate: SpanExporter, config?: ResilientExporterConfig): ResilientExporter;
+//# sourceMappingURL=exporters.d.ts.map

package/dist/observability/exporters.d.ts.map

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