@dotdo/postgres 0.1.0

package/dist/observability/query-performance.d.ts

@@ -0,0 +1,169 @@
+/**
+ * Query Performance Tracking
+ *
+ * Tracks query performance with:
+ * - P50/P95/P99 percentile calculations
+ * - Slow query detection
+ * - Query pattern analysis
+ * - Sample SQL collection per pattern
+ */
+import type { MetricsCollector } from './types';
+/**
+ * Query execution record
+ */
+export interface QueryExecution {
+    /** Normalized query pattern */
+    pattern: string;
+    /** Original SQL statement */
+    sql: string;
+    /** Execution duration in milliseconds */
+    durationMs: number;
+    /** Number of rows returned */
+    rowsReturned: number;
+    /** Timestamp of execution */
+    timestamp: number;
+    /** SQL operation type */
+    operation: string;
+    /** Error message if query failed */
+    error?: string;
+}
+/**
+ * Statistics for a query pattern
+ */
+export interface QueryPatternStats {
+    /** Normalized query pattern */
+    pattern: string;
+    /** SQL operation type */
+    operation: string;
+    /** Total execution count */
+    count: number;
+    /** Total duration across all executions */
+    totalDurationMs: number;
+    /** Average duration */
+    avgDurationMs: number;
+    /** Minimum duration */
+    minDurationMs: number;
+    /** Maximum duration */
+    maxDurationMs: number;
+    /** P50 (median) duration */
+    p50DurationMs: number;
+    /** P95 duration */
+    p95DurationMs: number;
+    /** P99 duration */
+    p99DurationMs: number;
+    /** Total rows returned */
+    totalRowsReturned: number;
+    /** Average rows returned */
+    avgRowsReturned: number;
+    /** Error count */
+    errorCount: number;
+    /** Sample SQL statements */
+    samples: string[];
+    /** First seen timestamp */
+    firstSeen: number;
+    /** Last seen timestamp */
+    lastSeen: number;
+}
+/**
+ * Overall percentiles across all queries
+ */
+export interface OverallPercentiles {
+    p50: number;
+    p90: number;
+    p95: number;
+    p99: number;
+}
+/**
+ * Summary statistics
+ */
+export interface QueryPerformanceSummary {
+    totalQueries: number;
+    totalPatterns: number;
+    totalDurationMs: number;
+    avgDurationMs: number;
+    totalErrors: number;
+    slowQueryCount: number;
+}
+/**
+ * Query performance tracker configuration
+ */
+export interface QueryPerformanceConfig {
+    /** Threshold for slow queries in milliseconds */
+    slowQueryThresholdMs?: number;
+    /** Maximum samples to keep per pattern */
+    maxSamplesPerPattern?: number;
+    /** Maximum slow queries to keep */
+    maxSlowQueries?: number;
+    /** Maximum durations to keep for percentile calculation */
+    maxDurationsPerPattern?: number;
+    /** Callback when slow query is detected */
+    onSlowQuery?: (execution: QueryExecution) => void;
+    /** Metrics collector for integration */
+    metricsCollector?: MetricsCollector;
+}
+/**
+ * Query performance tracker interface
+ */
+export interface QueryPerformanceTracker {
+    record(execution: QueryExecution): void;
+    getPatternStats(): QueryPatternStats[];
+    getPatternStat(pattern: string): QueryPatternStats | undefined;
+    getSlowQueries(): QueryExecution[];
+    getTopSlowPatterns(limit?: number): QueryPatternStats[];
+    getTopFrequentPatterns(limit?: number): QueryPatternStats[];
+    getOverallPercentiles(): OverallPercentiles;
+    getSummary(): QueryPerformanceSummary;
+    reset(): void;
+}
+/**
+ * Normalize SQL statement for pattern matching
+ * - Replaces string literals with placeholders
+ * - Replaces numeric literals with placeholders
+ * - Replaces parameter placeholders ($1, $2, :param) with ?
+ * - Normalizes whitespace
+ * - Uppercases SQL keywords
+ */
+export declare function normalizeSQL(sql: string): string;
+/**
+ * Detect SQL operation type from statement
+ */
+export declare function detectOperation(sql: string): string;
+/**
+ * Query performance tracker implementation
+ */
+export declare class QueryPerformanceTrackerImpl implements QueryPerformanceTracker {
+    private config;
+    private patterns;
+    private slowQueries;
+    private allDurations;
+    constructor(config?: QueryPerformanceConfig);
+    record(execution: QueryExecution): void;
+    getPatternStats(): QueryPatternStats[];
+    getPatternStat(pattern: string): QueryPatternStats | undefined;
+    getSlowQueries(): QueryExecution[];
+    getTopSlowPatterns(limit?: number): QueryPatternStats[];
+    getTopFrequentPatterns(limit?: number): QueryPatternStats[];
+    getOverallPercentiles(): OverallPercentiles;
+    getSummary(): QueryPerformanceSummary;
+    reset(): void;
+    private computeStats;
+}
+/**
+ * Create a query performance tracker
+ */
+export declare function createQueryPerformanceTracker(config?: QueryPerformanceConfig): QueryPerformanceTracker;
+/**
+ * Query executor function type
+ */
+export type QueryExecutor<T> = (sql: string, params?: unknown[]) => Promise<{
+    rows: T[];
+    rowCount: number;
+}>;
+/**
+ * Create a tracked query executor wrapper
+ */
+export declare function createTrackedQueryExecutor(tracker: QueryPerformanceTracker): <T>(sql: string, params: unknown[] | undefined, executor: QueryExecutor<T>) => Promise<{
+    rows: T[];
+    rowCount: number;
+}>;
+//# sourceMappingURL=query-performance.d.ts.map

package/dist/observability/query-performance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-performance.d.ts","sourceRoot":"","sources":["../../src/observability/query-performance.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAA;AAM/C;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,+BAA+B;IAC/B,OAAO,EAAE,MAAM,CAAA;IACf,6BAA6B;IAC7B,GAAG,EAAE,MAAM,CAAA;IACX,yCAAyC;IACzC,UAAU,EAAE,MAAM,CAAA;IAClB,8BAA8B;IAC9B,YAAY,EAAE,MAAM,CAAA;IACpB,6BAA6B;IAC7B,SAAS,EAAE,MAAM,CAAA;IACjB,yBAAyB;IACzB,SAAS,EAAE,MAAM,CAAA;IACjB,oCAAoC;IACpC,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,+BAA+B;IAC/B,OAAO,EAAE,MAAM,CAAA;IACf,yBAAyB;IACzB,SAAS,EAAE,MAAM,CAAA;IACjB,4BAA4B;IAC5B,KAAK,EAAE,MAAM,CAAA;IACb,2CAA2C;IAC3C,eAAe,EAAE,MAAM,CAAA;IACvB,uBAAuB;IACvB,aAAa,EAAE,MAAM,CAAA;IACrB,uBAAuB;IACvB,aAAa,EAAE,MAAM,CAAA;IACrB,uBAAuB;IACvB,aAAa,EAAE,MAAM,CAAA;IACrB,4BAA4B;IAC5B,aAAa,EAAE,MAAM,CAAA;IACrB,mBAAmB;IACnB,aAAa,EAAE,MAAM,CAAA;IACrB,mBAAmB;IACnB,aAAa,EAAE,MAAM,CAAA;IACrB,0BAA0B;IAC1B,iBAAiB,EAAE,MAAM,CAAA;IACzB,4BAA4B;IAC5B,eAAe,EAAE,MAAM,CAAA;IACvB,kBAAkB;IAClB,UAAU,EAAE,MAAM,CAAA;IAClB,4BAA4B;IAC5B,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB,2BAA2B;IAC3B,SAAS,EAAE,MAAM,CAAA;IACjB,0BAA0B;IAC1B,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,GAAG,EAAE,MAAM,CAAA;IACX,GAAG,EAAE,MAAM,CAAA;IACX,GAAG,EAAE,MAAM,CAAA;IACX,GAAG,EAAE,MAAM,CAAA;CACZ;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,YAAY,EAAE,MAAM,CAAA;IACpB,aAAa,EAAE,MAAM,CAAA;IACrB,eAAe,EAAE,MAAM,CAAA;IACvB,aAAa,EAAE,MAAM,CAAA;IACrB,WAAW,EAAE,MAAM,CAAA;IACnB,cAAc,EAAE,MAAM,CAAA;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,iDAAiD;IACjD,oBAAoB,CAAC,EAAE,MAAM,CAAA;IAC7B,0CAA0C;IAC1C,oBAAoB,CAAC,EAAE,MAAM,CAAA;IAC7B,mCAAmC;IACnC,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,2DAA2D;IAC3D,sBAAsB,CAAC,EAAE,MAAM,CAAA;IAC/B,2CAA2C;IAC3C,WAAW,CAAC,EAAE,CAAC,SAAS,EAAE,cAAc,KAAK,IAAI,CAAA;IACjD,wCAAwC;IACxC,gBAAgB,CAAC,EAAE,gBAAgB,CAAA;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,MAAM,CAAC,SAAS,EAAE,cAAc,GAAG,IAAI,CAAA;IACvC,eAAe,IAAI,iBAAiB,EAAE,CAAA;IACtC,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS,CAAA;IAC9D,cAAc,IAAI,cAAc,EAAE,CAAA;IAClC,kBAAkB,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,iBAAiB,EAAE,CAAA;IACvD,sBAAsB,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,iBAAiB,EAAE,CAAA;IAC3D,qBAAqB,IAAI,kBAAkB,CAAA;IAC3C,UAAU,IAAI,uBAAuB,CAAA;IACrC,KAAK,IAAI,IAAI,CAAA;CACd;AAMD;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAmChD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAenD;AAiCD;;GAEG;AACH,qBAAa,2BAA4B,YAAW,uBAAuB;IACzE,OAAO,CAAC,MAAM,CAGb;IACD,OAAO,CAAC,QAAQ,CAAsC;IACtD,OAAO,CAAC,WAAW,CAAuB;IAC1C,OAAO,CAAC,YAAY,CAAe;gBAEvB,MAAM,CAAC,EAAE,sBAAsB;IAW3C,MAAM,CAAC,SAAS,EAAE,cAAc,GAAG,IAAI;IA0EvC,eAAe,IAAI,iBAAiB,EAAE;IAItC,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS;IAM9D,cAAc,IAAI,cAAc,EAAE;IAIlC,kBAAkB,CAAC,KAAK,SAAK,GAAG,iBAAiB,EAAE;IAMnD,sBAAsB,CAAC,KAAK,SAAK,GAAG,iBAAiB,EAAE;IAMvD,qBAAqB,IAAI,kBAAkB;IAe3C,UAAU,IAAI,uBAAuB;IAqBrC,KAAK,IAAI,IAAI;IAMb,OAAO,CAAC,YAAY;CAsBrB;AAED;;GAEG;AACH,wBAAgB,6BAA6B,CAC3C,MAAM,CAAC,EAAE,sBAAsB,GAC9B,uBAAuB,CAEzB;AAMD;;GAEG;AACH,MAAM,MAAM,aAAa,CAAC,CAAC,IAAI,CAC7B,GAAG,EAAE,MAAM,EACX,MAAM,CAAC,EAAE,OAAO,EAAE,KACf,OAAO,CAAC;IAAE,IAAI,EAAE,CAAC,EAAE,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,CAAA;AAE7C;;GAEG;AACH,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,uBAAuB,GAC/B,CAAC,CAAC,EACH,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,OAAO,EAAE,GAAG,SAAS,EAC7B,QAAQ,EAAE,aAAa,CAAC,CAAC,CAAC,KACvB,OAAO,CAAC;IAAE,IAAI,EAAE,CAAC,EAAE,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,CA0C5C"}

package/dist/observability/query-performance.js

@@ -0,0 +1,290 @@
+/**
+ * Query Performance Tracking
+ *
+ * Tracks query performance with:
+ * - P50/P95/P99 percentile calculations
+ * - Slow query detection
+ * - Query pattern analysis
+ * - Sample SQL collection per pattern
+ */
+// ============================================================================
+// Helper Functions
+// ============================================================================
+/**
+ * Normalize SQL statement for pattern matching
+ * - Replaces string literals with placeholders
+ * - Replaces numeric literals with placeholders
+ * - Replaces parameter placeholders ($1, $2, :param) with ?
+ * - Normalizes whitespace
+ * - Uppercases SQL keywords
+ */
+export function normalizeSQL(sql) {
+    let normalized = sql;
+    // Replace string literals (single and double quotes)
+    normalized = normalized.replace(/'[^']*'/g, '?');
+    normalized = normalized.replace(/"[^"]*"/g, '?');
+    // Replace $1, $2, etc. parameter placeholders (before numeric replacement)
+    normalized = normalized.replace(/\$\d+/g, '?');
+    // Replace numeric literals (integers and floats)
+    normalized = normalized.replace(/\b\d+\.?\d*\b/g, '?');
+    // Replace :param style placeholders
+    normalized = normalized.replace(/:\w+/g, '?');
+    // Normalize whitespace
+    normalized = normalized.replace(/\s+/g, ' ').trim();
+    // Uppercase SQL keywords
+    const keywords = [
+        'SELECT', 'FROM', 'WHERE', 'AND', 'OR', 'INSERT', 'INTO', 'VALUES',
+        'UPDATE', 'SET', 'DELETE', 'CREATE', 'TABLE', 'ALTER', 'DROP', 'INDEX',
+        'JOIN', 'LEFT', 'RIGHT', 'INNER', 'OUTER', 'ON', 'AS', 'ORDER', 'BY',
+        'GROUP', 'HAVING', 'LIMIT', 'OFFSET', 'BEGIN', 'COMMIT', 'ROLLBACK',
+        'TRANSACTION', 'WITH', 'UNION', 'ALL', 'DISTINCT', 'IN', 'NOT', 'NULL',
+        'IS', 'LIKE', 'BETWEEN', 'EXISTS', 'CASE', 'WHEN', 'THEN', 'ELSE', 'END',
+    ];
+    for (const keyword of keywords) {
+        const regex = new RegExp(`\\b${keyword}\\b`, 'gi');
+        normalized = normalized.replace(regex, keyword);
+    }
+    return normalized;
+}
+/**
+ * Detect SQL operation type from statement
+ */
+export function detectOperation(sql) {
+    const normalized = sql.trim().toUpperCase();
+    if (normalized.startsWith('SELECT'))
+        return 'SELECT';
+    if (normalized.startsWith('INSERT'))
+        return 'INSERT';
+    if (normalized.startsWith('UPDATE'))
+        return 'UPDATE';
+    if (normalized.startsWith('DELETE'))
+        return 'DELETE';
+    if (normalized.startsWith('CREATE'))
+        return 'CREATE';
+    if (normalized.startsWith('ALTER'))
+        return 'ALTER';
+    if (normalized.startsWith('DROP'))
+        return 'DROP';
+    if (normalized.startsWith('BEGIN'))
+        return 'BEGIN';
+    if (normalized.startsWith('COMMIT'))
+        return 'COMMIT';
+    if (normalized.startsWith('ROLLBACK'))
+        return 'ROLLBACK';
+    return 'OTHER';
+}
+/**
+ * Calculate percentile from sorted array
+ */
+function calculatePercentile(sortedValues, percentile) {
+    if (sortedValues.length === 0)
+        return 0;
+    const index = Math.ceil((percentile / 100) * sortedValues.length) - 1;
+    return sortedValues[Math.max(0, index)] ?? 0;
+}
+/**
+ * Query performance tracker implementation
+ */
+export class QueryPerformanceTrackerImpl {
+    config;
+    patterns = new Map();
+    slowQueries = [];
+    allDurations = [];
+    constructor(config) {
+        this.config = {
+            slowQueryThresholdMs: config?.slowQueryThresholdMs ?? 1000,
+            maxSamplesPerPattern: config?.maxSamplesPerPattern ?? 5,
+            maxSlowQueries: config?.maxSlowQueries ?? 100,
+            maxDurationsPerPattern: config?.maxDurationsPerPattern ?? 1000,
+            ...(config?.onSlowQuery !== undefined && { onSlowQuery: config.onSlowQuery }),
+            ...(config?.metricsCollector !== undefined && { metricsCollector: config.metricsCollector }),
+        };
+    }
+    record(execution) {
+        const { pattern, sql, durationMs, rowsReturned, timestamp, operation, error } = execution;
+        // Get or create pattern data
+        let data = this.patterns.get(pattern);
+        if (!data) {
+            data = {
+                pattern,
+                operation,
+                count: 0,
+                totalDurationMs: 0,
+                minDurationMs: Infinity,
+                maxDurationMs: 0,
+                durations: [],
+                totalRowsReturned: 0,
+                errorCount: 0,
+                samples: [],
+                firstSeen: timestamp,
+                lastSeen: timestamp,
+            };
+            this.patterns.set(pattern, data);
+        }
+        // Update statistics
+        data.count++;
+        data.totalDurationMs += durationMs;
+        data.minDurationMs = Math.min(data.minDurationMs, durationMs);
+        data.maxDurationMs = Math.max(data.maxDurationMs, durationMs);
+        data.totalRowsReturned += rowsReturned;
+        data.lastSeen = timestamp;
+        if (error) {
+            data.errorCount++;
+        }
+        // Store duration for percentile calculation
+        data.durations.push(durationMs);
+        if (data.durations.length > this.config.maxDurationsPerPattern) {
+            data.durations.shift();
+        }
+        // Collect samples
+        if (data.samples.length < this.config.maxSamplesPerPattern) {
+            data.samples.push(sql);
+        }
+        // Track all durations for overall percentiles
+        this.allDurations.push(durationMs);
+        if (this.allDurations.length > 10000) {
+            this.allDurations.shift();
+        }
+        // Check for slow query
+        if (durationMs >= this.config.slowQueryThresholdMs) {
+            this.slowQueries.push(execution);
+            if (this.slowQueries.length > this.config.maxSlowQueries) {
+                this.slowQueries.shift();
+            }
+            if (this.config.onSlowQuery) {
+                this.config.onSlowQuery(execution);
+            }
+        }
+        // Record metrics if collector available
+        if (this.config.metricsCollector) {
+            this.config.metricsCollector.histogram('postgres.query.duration_ms', durationMs, { operation });
+            this.config.metricsCollector.increment('postgres.query.count', 1, { operation });
+            if (error) {
+                this.config.metricsCollector.increment('postgres.query.errors', 1, { operation });
+            }
+        }
+    }
+    getPatternStats() {
+        return Array.from(this.patterns.values()).map(data => this.computeStats(data));
+    }
+    getPatternStat(pattern) {
+        const data = this.patterns.get(pattern);
+        if (!data)
+            return undefined;
+        return this.computeStats(data);
+    }
+    getSlowQueries() {
+        return [...this.slowQueries];
+    }
+    getTopSlowPatterns(limit = 10) {
+        return this.getPatternStats()
+            .sort((a, b) => b.avgDurationMs - a.avgDurationMs)
+            .slice(0, limit);
+    }
+    getTopFrequentPatterns(limit = 10) {
+        return this.getPatternStats()
+            .sort((a, b) => b.count - a.count)
+            .slice(0, limit);
+    }
+    getOverallPercentiles() {
+        if (this.allDurations.length === 0) {
+            return { p50: 0, p90: 0, p95: 0, p99: 0 };
+        }
+        const sorted = [...this.allDurations].sort((a, b) => a - b);
+        return {
+            p50: calculatePercentile(sorted, 50),
+            p90: calculatePercentile(sorted, 90),
+            p95: calculatePercentile(sorted, 95),
+            p99: calculatePercentile(sorted, 99),
+        };
+    }
+    getSummary() {
+        let totalQueries = 0;
+        let totalDurationMs = 0;
+        let totalErrors = 0;
+        for (const data of this.patterns.values()) {
+            totalQueries += data.count;
+            totalDurationMs += data.totalDurationMs;
+            totalErrors += data.errorCount;
+        }
+        return {
+            totalQueries,
+            totalPatterns: this.patterns.size,
+            totalDurationMs,
+            avgDurationMs: totalQueries > 0 ? totalDurationMs / totalQueries : 0,
+            totalErrors,
+            slowQueryCount: this.slowQueries.length,
+        };
+    }
+    reset() {
+        this.patterns.clear();
+        this.slowQueries = [];
+        this.allDurations = [];
+    }
+    computeStats(data) {
+        const sortedDurations = [...data.durations].sort((a, b) => a - b);
+        return {
+            pattern: data.pattern,
+            operation: data.operation,
+            count: data.count,
+            totalDurationMs: data.totalDurationMs,
+            avgDurationMs: data.count > 0 ? data.totalDurationMs / data.count : 0,
+            minDurationMs: data.minDurationMs === Infinity ? 0 : data.minDurationMs,
+            maxDurationMs: data.maxDurationMs,
+            p50DurationMs: calculatePercentile(sortedDurations, 50),
+            p95DurationMs: calculatePercentile(sortedDurations, 95),
+            p99DurationMs: calculatePercentile(sortedDurations, 99),
+            totalRowsReturned: data.totalRowsReturned,
+            avgRowsReturned: data.count > 0 ? data.totalRowsReturned / data.count : 0,
+            errorCount: data.errorCount,
+            samples: [...data.samples],
+            firstSeen: data.firstSeen,
+            lastSeen: data.lastSeen,
+        };
+    }
+}
+/**
+ * Create a query performance tracker
+ */
+export function createQueryPerformanceTracker(config) {
+    return new QueryPerformanceTrackerImpl(config);
+}
+/**
+ * Create a tracked query executor wrapper
+ */
+export function createTrackedQueryExecutor(tracker) {
+    return async function trackedQuery(sql, params, executor) {
+        const pattern = normalizeSQL(sql);
+        const operation = detectOperation(sql);
+        const startTime = performance.now();
+        let error;
+        try {
+            const result = await executor(sql, params);
+            const durationMs = performance.now() - startTime;
+            tracker.record({
+                pattern,
+                sql,
+                durationMs,
+                rowsReturned: result.rowCount,
+                timestamp: Date.now(),
+                operation,
+            });
+            return result;
+        }
+        catch (err) {
+            const durationMs = performance.now() - startTime;
+            error = err instanceof Error ? err.message : String(err);
+            tracker.record({
+                pattern,
+                sql,
+                durationMs,
+                rowsReturned: 0,
+                timestamp: Date.now(),
+                operation,
+                error,
+            });
+            throw err;
+        }
+    };
+}
+//# sourceMappingURL=query-performance.js.map

package/dist/observability/query-performance.js.map

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

package/dist/observability/storage-tier-metrics.d.ts

@@ -0,0 +1,174 @@
+/**
+ * Storage Tier Metrics
+ *
+ * Tracks metrics for the tiered storage architecture:
+ * - HOT: In-DO SQLite Blobs (synchronous, fastest)
+ * - WARM: Cloudflare Cache (free caching layer)
+ * - COLD: R2 object storage (archived/bulk data)
+ */
+import type { MetricsCollector } from './types';
+/**
+ * Storage tier names
+ */
+export type StorageTier = 'hot' | 'warm' | 'cold';
+/**
+ * Storage operation types
+ */
+export type StorageOperation = 'read' | 'write' | 'delete' | 'list' | 'promote' | 'demote';
+/**
+ * Tier transition direction
+ */
+export type TierTransition = 'promote' | 'demote';
+/**
+ * Storage operation result
+ */
+export interface StorageOperationResult {
+    /** Which tier served the request */
+    tier: StorageTier;
+    /** Whether the operation was a hit (for reads) */
+    hit: boolean;
+    /** Operation duration in milliseconds */
+    durationMs: number;
+    /** Data size in bytes */
+    bytes?: number;
+    /** Whether data was promoted to a faster tier */
+    promoted?: boolean;
+}
+/**
+ * Tier statistics
+ */
+export interface TierStats {
+    /** Tier name */
+    tier: StorageTier;
+    /** Total operations */
+    totalOperations: number;
+    /** Read hits */
+    readHits: number;
+    /** Read misses */
+    readMisses: number;
+    /** Hit ratio (0-1) */
+    hitRatio: number;
+    /** Total bytes read */
+    bytesRead: number;
+    /** Total bytes written */
+    bytesWritten: number;
+    /** Average read latency */
+    avgReadLatencyMs: number;
+    /** Average write latency */
+    avgWriteLatencyMs: number;
+    /** P95 read latency */
+    p95ReadLatencyMs: number;
+    /** Current storage usage in bytes */
+    storageUsageBytes: number;
+}
+/**
+ * Tier transition statistics
+ */
+export interface TierTransitionStats {
+    /** Promotions from this tier */
+    promotions: number;
+    /** Demotions to this tier */
+    demotions: number;
+    /** Total bytes promoted */
+    bytesPromoted: number;
+    /** Total bytes demoted */
+    bytesDemoted: number;
+    /** Average promotion latency */
+    avgPromotionLatencyMs: number;
+    /** Average demotion latency */
+    avgDemotionLatencyMs: number;
+}
+/**
+ * Overall tiering efficiency
+ */
+export interface TieringEfficiency {
+    /** Overall hit ratio across all tiers */
+    overallHitRatio: number;
+    /** Percentage of requests served from HOT tier */
+    hotTierPercentage: number;
+    /** Percentage of requests served from WARM tier */
+    warmTierPercentage: number;
+    /** Percentage of requests served from COLD tier */
+    coldTierPercentage: number;
+    /** Estimated cost savings from tiering */
+    estimatedCostSavings: number;
+    /** Efficiency score (0-100) */
+    efficiencyScore: number;
+}
+/**
+ * Storage tier metrics configuration
+ */
+export interface StorageTierMetricsConfig {
+    /** Metrics collector for integration */
+    metricsCollector?: MetricsCollector;
+    /** Maximum latency samples to keep per tier */
+    maxLatencySamples?: number;
+    /** Cost per GB for HOT tier (DO storage) */
+    hotCostPerGB?: number;
+    /** Cost per GB for WARM tier (free) */
+    warmCostPerGB?: number;
+    /** Cost per GB for COLD tier (R2) */
+    coldCostPerGB?: number;
+}
+/**
+ * Storage tier metrics collector interface
+ */
+export interface StorageTierMetricsCollector {
+    /** Record a storage operation */
+    recordOperation(tier: StorageTier, operation: StorageOperation, result: Omit<StorageOperationResult, 'tier'>): void;
+    /** Record a tier transition */
+    recordTransition(fromTier: StorageTier, toTier: StorageTier, bytes: number, durationMs: number): void;
+    /** Update storage usage for a tier */
+    setStorageUsage(tier: StorageTier, bytes: number): void;
+    /** Get statistics for a specific tier */
+    getTierStats(tier: StorageTier): TierStats;
+    /** Get statistics for all tiers */
+    getAllTierStats(): Record<StorageTier, TierStats>;
+    /** Get tier transition statistics */
+    getTransitionStats(): Record<StorageTier, TierTransitionStats>;
+    /** Calculate tiering efficiency */
+    getEfficiency(): TieringEfficiency;
+    /** Get recommendation for tier configuration */
+    getRecommendation(): TierRecommendation;
+    /** Reset all statistics */
+    reset(): void;
+}
+/**
+ * Tier configuration recommendation
+ */
+export interface TierRecommendation {
+    /** Recommended action */
+    action: 'none' | 'increase_hot' | 'increase_warm' | 'adjust_promotion_policy';
+    /** Reason for recommendation */
+    reason: string;
+    /** Current efficiency score */
+    currentEfficiency: number;
+    /** Potential efficiency improvement */
+    potentialImprovement: number;
+}
+/**
+ * Storage tier metrics collector implementation
+ */
+export declare class StorageTierMetricsCollectorImpl implements StorageTierMetricsCollector {
+    private config;
+    private tierData;
+    private transitionData;
+    constructor(config?: StorageTierMetricsConfig);
+    private createEmptyTierData;
+    private createEmptyTransitionData;
+    recordOperation(tier: StorageTier, operation: StorageOperation, result: Omit<StorageOperationResult, 'tier'>): void;
+    recordTransition(fromTier: StorageTier, toTier: StorageTier, bytes: number, durationMs: number): void;
+    setStorageUsage(tier: StorageTier, bytes: number): void;
+    getTierStats(tier: StorageTier): TierStats;
+    getAllTierStats(): Record<StorageTier, TierStats>;
+    getTransitionStats(): Record<StorageTier, TierTransitionStats>;
+    getEfficiency(): TieringEfficiency;
+    getRecommendation(): TierRecommendation;
+    reset(): void;
+    private getTierPriority;
+}
+/**
+ * Create a storage tier metrics collector
+ */
+export declare function createStorageTierMetricsCollector(config?: StorageTierMetricsConfig): StorageTierMetricsCollector;
+//# sourceMappingURL=storage-tier-metrics.d.ts.map

package/dist/observability/storage-tier-metrics.d.ts.map

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