@geekmidas/telescope 10.0.0-alpha.2 → 10.0.0-alpha.21

package/dist/metrics/storage/MetricsStorage.d.cts

@@ -1,3 +1,56 @@
-import "../../types-BS3Rx8Sk.cjs";
-import { MetricsStorage } from "../../MetricsStorage-B86e4131.cjs";
-export { MetricsStorage };
+import { MetricBucket, MetricPoint, MetricQuery, MetricResult, MetricsStorageConfig, PartitionInfo, RollupOptions } from "./types.cjs";
+//#region src/metrics/storage/MetricsStorage.d.ts
+/**
+ * Interface for metrics storage backends.
+ *
+ * Implementations can use different storage technologies:
+ * - In-memory (development/testing)
+ * - PostgreSQL with TimescaleDB
+ * - ClickHouse
+ * - InfluxDB
+ */
+export interface MetricsStorage {
+  /**
+   * Write raw metric points to storage.
+   * Points are typically buffered and flushed in batches.
+   */
+  write(points: MetricPoint[]): Promise<void>;
+  /**
+   * Query metrics with aggregation.
+   * Returns time series data with statistics.
+   */
+  query(query: MetricQuery): Promise<MetricResult[]>;
+  /**
+   * Get a single aggregated bucket for a specific time range.
+   * Useful for dashboards showing current values.
+   */
+  getBucket(projectId: string, name: string, bucket: Date): Promise<MetricBucket | null>;
+  /**
+   * Roll up data from one tier to another.
+   * Aggregates fine-grained data into coarser buckets.
+   */
+  rollup(options: RollupOptions): Promise<number>;
+  /**
+   * Prune old data based on retention policies.
+   * Returns the number of records deleted.
+   */
+  prune(): Promise<number>;
+  /**
+   * List partitions for management and monitoring.
+   */
+  listPartitions(tier?: string): Promise<PartitionInfo[]>;
+  /**
+   * Get storage configuration.
+   */
+  getConfig(): MetricsStorageConfig;
+  /**
+   * Flush any buffered data to storage.
+   */
+  flush(): Promise<void>;
+  /**
+   * Close the storage connection and clean up resources.
+   */
+  close(): Promise<void>;
+}
+//#endregion
+//# sourceMappingURL=MetricsStorage.d.cts.map

package/dist/metrics/storage/MetricsStorage.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MetricsStorage.d.cts","names":[],"sources":["../../../src/metrics/storage/MetricsStorage.ts"],"mappings":";;;;;;;;;;;iBAmBiB;;;;;EAKhB,MAAM,QAAQ,gBAAgB;;;;;EAM9B,MAAM,OAAO,cAAc,QAAQ;;;;;EAMnC,UACC,mBACA,cACA,QAAQ,OACN,QAAQ;;;;;EAMX,OAAO,SAAS,gBAAgB;;;;;EAMhC,SAAS;;;;EAKT,eAAe,gBAAgB,QAAQ;;;;EAKvC,aAAa;;;;EAKb,SAAS;;;;EAKT,SAAS"}

package/dist/metrics/storage/MetricsStorage.d.mts

@@ -1,3 +1,56 @@
-import "../../types-CbNGXnJE.mjs";
-import { MetricsStorage } from "../../MetricsStorage-BWyP2_12.mjs";
-export { MetricsStorage };
+import { MetricBucket, MetricPoint, MetricQuery, MetricResult, MetricsStorageConfig, PartitionInfo, RollupOptions } from "./types.mjs";
+//#region src/metrics/storage/MetricsStorage.d.ts
+/**
+ * Interface for metrics storage backends.
+ *
+ * Implementations can use different storage technologies:
+ * - In-memory (development/testing)
+ * - PostgreSQL with TimescaleDB
+ * - ClickHouse
+ * - InfluxDB
+ */
+export interface MetricsStorage {
+  /**
+   * Write raw metric points to storage.
+   * Points are typically buffered and flushed in batches.
+   */
+  write(points: MetricPoint[]): Promise<void>;
+  /**
+   * Query metrics with aggregation.
+   * Returns time series data with statistics.
+   */
+  query(query: MetricQuery): Promise<MetricResult[]>;
+  /**
+   * Get a single aggregated bucket for a specific time range.
+   * Useful for dashboards showing current values.
+   */
+  getBucket(projectId: string, name: string, bucket: Date): Promise<MetricBucket | null>;
+  /**
+   * Roll up data from one tier to another.
+   * Aggregates fine-grained data into coarser buckets.
+   */
+  rollup(options: RollupOptions): Promise<number>;
+  /**
+   * Prune old data based on retention policies.
+   * Returns the number of records deleted.
+   */
+  prune(): Promise<number>;
+  /**
+   * List partitions for management and monitoring.
+   */
+  listPartitions(tier?: string): Promise<PartitionInfo[]>;
+  /**
+   * Get storage configuration.
+   */
+  getConfig(): MetricsStorageConfig;
+  /**
+   * Flush any buffered data to storage.
+   */
+  flush(): Promise<void>;
+  /**
+   * Close the storage connection and clean up resources.
+   */
+  close(): Promise<void>;
+}
+//#endregion
+//# sourceMappingURL=MetricsStorage.d.mts.map

package/dist/metrics/storage/MetricsStorage.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MetricsStorage.d.mts","names":[],"sources":["../../../src/metrics/storage/MetricsStorage.ts"],"mappings":";;;;;;;;;;;iBAmBiB;;;;;EAKhB,MAAM,QAAQ,gBAAgB;;;;;EAM9B,MAAM,OAAO,cAAc,QAAQ;;;;;EAMnC,UACC,mBACA,cACA,QAAQ,OACN,QAAQ;;;;;EAMX,OAAO,SAAS,gBAAgB;;;;;EAMhC,SAAS;;;;EAKT,eAAe,gBAAgB,QAAQ;;;;EAKvC,aAAa;;;;EAKb,SAAS;;;;EAKT,SAAS"}

package/dist/metrics/storage/MetricsStorage.mjs

@@ -1 +1 @@
-import "../../MetricsStorage-BypQXWiv.mjs";
+export {};

package/dist/metrics/storage/index.cjs

@@ -1,6 +1,6 @@
-const require_types = require('../../types-ZW-nfWf6.cjs');
-const require_InMemoryMetricsStorage = require('../../InMemoryMetricsStorage-D0njWUSi.cjs');
-require('../../MetricsStorage-Or8pVCe4.cjs');
-
-exports.DEFAULT_METRICS_CONFIG = require_types.DEFAULT_METRICS_CONFIG;
-exports.InMemoryMetricsStorage = require_InMemoryMetricsStorage.InMemoryMetricsStorage;
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_metrics_storage_types = require("./types.cjs");
+const require_metrics_storage_InMemoryMetricsStorage = require("./InMemoryMetricsStorage.cjs");
+require("./MetricsStorage.cjs");
+exports.DEFAULT_METRICS_CONFIG = require_metrics_storage_types.DEFAULT_METRICS_CONFIG;
+exports.InMemoryMetricsStorage = require_metrics_storage_InMemoryMetricsStorage.InMemoryMetricsStorage;

package/dist/metrics/storage/index.d.cts

@@ -1,4 +1,4 @@
-import { AggregationInterval, DEFAULT_METRICS_CONFIG, MetricBucket, MetricLabels, MetricPoint, MetricQuery, MetricResult, MetricTimeSeriesPoint, MetricType, MetricsStorageConfig, PartitionInfo, RollupOptions, StorageTier, TDigestData, TimeRange } from "../../types-BS3Rx8Sk.cjs";
-import { MetricsStorage } from "../../MetricsStorage-B86e4131.cjs";
-import { InMemoryMetricsStorage } from "../../InMemoryMetricsStorage-TvPdZjL0.cjs";
+import { AggregationInterval, DEFAULT_METRICS_CONFIG, MetricBucket, MetricLabels, MetricPoint, MetricQuery, MetricResult, MetricTimeSeriesPoint, MetricType, MetricsStorageConfig, PartitionInfo, RollupOptions, StorageTier, TDigestData, TimeRange } from "./types.cjs";
+import { MetricsStorage } from "./MetricsStorage.cjs";
+import { InMemoryMetricsStorage } from "./InMemoryMetricsStorage.cjs";
 export { AggregationInterval, DEFAULT_METRICS_CONFIG, InMemoryMetricsStorage, MetricBucket, MetricLabels, MetricPoint, MetricQuery, MetricResult, MetricTimeSeriesPoint, MetricType, MetricsStorage, MetricsStorageConfig, PartitionInfo, RollupOptions, StorageTier, TDigestData, TimeRange };

package/dist/metrics/storage/index.d.mts

@@ -1,4 +1,4 @@
-import { AggregationInterval, DEFAULT_METRICS_CONFIG, MetricBucket, MetricLabels, MetricPoint, MetricQuery, MetricResult, MetricTimeSeriesPoint, MetricType, MetricsStorageConfig, PartitionInfo, RollupOptions, StorageTier, TDigestData, TimeRange } from "../../types-CbNGXnJE.mjs";
-import { MetricsStorage } from "../../MetricsStorage-BWyP2_12.mjs";
-import { InMemoryMetricsStorage } from "../../InMemoryMetricsStorage-BbKCL3YL.mjs";
+import { AggregationInterval, DEFAULT_METRICS_CONFIG, MetricBucket, MetricLabels, MetricPoint, MetricQuery, MetricResult, MetricTimeSeriesPoint, MetricType, MetricsStorageConfig, PartitionInfo, RollupOptions, StorageTier, TDigestData, TimeRange } from "./types.mjs";
+import { MetricsStorage } from "./MetricsStorage.mjs";
+import { InMemoryMetricsStorage } from "./InMemoryMetricsStorage.mjs";
 export { AggregationInterval, DEFAULT_METRICS_CONFIG, InMemoryMetricsStorage, MetricBucket, MetricLabels, MetricPoint, MetricQuery, MetricResult, MetricTimeSeriesPoint, MetricType, MetricsStorage, MetricsStorageConfig, PartitionInfo, RollupOptions, StorageTier, TDigestData, TimeRange };

package/dist/metrics/storage/index.mjs

@@ -1,5 +1,4 @@
-import { DEFAULT_METRICS_CONFIG } from "../../types-ojhnLdwz.mjs";
-import { InMemoryMetricsStorage } from "../../InMemoryMetricsStorage-C4drxT7G.mjs";
-import "../../MetricsStorage-BypQXWiv.mjs";
-
-export { DEFAULT_METRICS_CONFIG, InMemoryMetricsStorage };
+import { DEFAULT_METRICS_CONFIG } from "./types.mjs";
+import { InMemoryMetricsStorage } from "./InMemoryMetricsStorage.mjs";
+import "./MetricsStorage.mjs";
+export { DEFAULT_METRICS_CONFIG, InMemoryMetricsStorage };

package/dist/metrics/storage/types.cjs

@@ -1,3 +1,35 @@
-const require_types = require('../../types-ZW-nfWf6.cjs');
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region src/metrics/storage/types.ts
+/**
+* Default configuration with hybrid storage strategy
+*/
+const DEFAULT_METRICS_CONFIG = {
+	tiers: [
+		{
+			name: "raw",
+			interval: "1m",
+			retention: 36e5,
+			partitionInterval: "hourly"
+		},
+		{
+			name: "1m",
+			interval: "1m",
+			retention: 6048e5,
+			partitionInterval: "daily"
+		},
+		{
+			name: "1h",
+			interval: "1h",
+			retention: 0,
+			partitionInterval: "monthly"
+		}
+	],
+	flushInterval: 1e4,
+	maxBatchSize: 1e3,
+	autoRollup: true,
+	tdigestCompression: 100
+};
+//#endregion
+exports.DEFAULT_METRICS_CONFIG = DEFAULT_METRICS_CONFIG;
 
-exports.DEFAULT_METRICS_CONFIG = require_types.DEFAULT_METRICS_CONFIG;
+//# sourceMappingURL=types.cjs.map

package/dist/metrics/storage/types.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.cjs","names":[],"sources":["../../../src/metrics/storage/types.ts"],"sourcesContent":["/**\n * Metric types supported by the storage system\n */\nexport type MetricType = 'counter' | 'gauge' | 'histogram';\n\n/**\n * Labels/dimensions for metric filtering and grouping\n */\nexport type MetricLabels = Record<string, string>;\n\n/**\n * A single metric data point\n */\nexport interface MetricPoint {\n\t/** Timestamp of the metric */\n\ttimestamp: Date;\n\t/** Project/app identifier for multi-tenant isolation */\n\tprojectId: string;\n\t/** Service name (e.g., 'api', 'worker', 'cron') */\n\tservice: string;\n\t/** Environment (e.g., 'development', 'staging', 'production') */\n\tenvironment: string;\n\t/** Metric name (e.g., 'http.request.duration', 'orders.created') */\n\tname: string;\n\t/** Metric type */\n\ttype: MetricType;\n\t/** Numeric value */\n\tvalue: number;\n\t/** Dimensions for filtering/grouping */\n\tlabels: MetricLabels;\n}\n\n/**\n * Aggregated metric bucket (pre-computed for efficient queries)\n */\nexport interface MetricBucket {\n\t/** Bucket start timestamp */\n\tbucket: Date;\n\t/** Project identifier */\n\tprojectId: string;\n\t/** Service name */\n\tservice: string;\n\t/** Environment */\n\tenvironment: string;\n\t/** Metric name */\n\tname: string;\n\t/** Hash of labels for grouping */\n\tlabelsHash: string;\n\t/** Original labels */\n\tlabels: MetricLabels;\n\t/** Number of data points in bucket */\n\tcount: number;\n\t/** Sum of values */\n\tsum: number;\n\t/** Minimum value */\n\tmin: number;\n\t/** Maximum value */\n\tmax: number;\n\t/** T-Digest sketch for percentile calculations (serialized) */\n\tsketch?: TDigestData;\n}\n\n/**\n * Serialized T-Digest data structure for percentile calculations\n * Stores centroids (mean, weight) that can be merged across buckets\n */\nexport interface TDigestData {\n\t/** Centroids: [mean, weight][] */\n\tcentroids: [number, number][];\n\t/** Compression factor (higher = more accuracy, more memory) */\n\tcompression: number;\n\t/** Total count of values */\n\tcount: number;\n\t/** Minimum value seen */\n\tmin: number;\n\t/** Maximum value seen */\n\tmax: number;\n}\n\n/**\n * Time range for queries\n */\nexport interface TimeRange {\n\tstart: Date;\n\tend: Date;\n}\n\n/**\n * Aggregation granularity\n */\nexport type AggregationInterval = '1m' | '5m' | '15m' | '1h' | '6h' | '1d';\n\n/**\n * Query parameters for retrieving metrics\n */\nexport interface MetricQuery {\n\t/** Project filter (required for multi-tenant) */\n\tprojectId: string;\n\t/** Optional service filter */\n\tservice?: string;\n\t/** Optional environment filter */\n\tenvironment?: string;\n\t/** Metric name pattern (supports wildcards like 'http.*') */\n\tname?: string;\n\t/** Label filters */\n\tlabels?: MetricLabels;\n\t/** Time range */\n\trange: TimeRange;\n\t/** Aggregation interval */\n\tinterval?: AggregationInterval;\n\t/** Group by these label keys */\n\tgroupBy?: string[];\n\t/** Maximum number of results */\n\tlimit?: number;\n}\n\n/**\n * Query result with aggregated values\n */\nexport interface MetricResult {\n\t/** Metric name */\n\tname: string;\n\t/** Labels (grouped by keys if specified) */\n\tlabels: MetricLabels;\n\t/** Time series data points */\n\ttimeSeries: MetricTimeSeriesPoint[];\n\t/** Overall statistics for the query range */\n\tstats: {\n\t\tcount: number;\n\t\tsum: number;\n\t\tavg: number;\n\t\tmin: number;\n\t\tmax: number;\n\t\tp50: number;\n\t\tp95: number;\n\t\tp99: number;\n\t};\n}\n\n/**\n * Single point in a time series result\n */\nexport interface MetricTimeSeriesPoint {\n\ttimestamp: Date;\n\tcount: number;\n\tsum: number;\n\tavg: number;\n\tmin: number;\n\tmax: number;\n\tp50?: number;\n\tp95?: number;\n\tp99?: number;\n}\n\n/**\n * Storage tier configuration\n */\nexport interface StorageTier {\n\t/** Table/collection name for this tier */\n\tname: string;\n\t/** Bucket interval for aggregation */\n\tinterval: AggregationInterval;\n\t/** Retention duration in milliseconds (0 = forever) */\n\tretention: number;\n\t/** Partition interval for efficient pruning */\n\tpartitionInterval: 'hourly' | 'daily' | 'weekly' | 'monthly';\n}\n\n/**\n * Metrics storage configuration\n */\nexport interface MetricsStorageConfig {\n\t/** Storage tiers (raw, minute, hourly, etc.) */\n\ttiers: StorageTier[];\n\t/** Flush interval in milliseconds */\n\tflushInterval: number;\n\t/** Maximum batch size for writes */\n\tmaxBatchSize: number;\n\t/** Enable automatic rollup between tiers */\n\tautoRollup: boolean;\n\t/** T-Digest compression factor (default: 100) */\n\ttdigestCompression: number;\n}\n\n/**\n * Default configuration with hybrid storage strategy\n */\nexport const DEFAULT_METRICS_CONFIG: MetricsStorageConfig = {\n\ttiers: [\n\t\t{\n\t\t\tname: 'raw',\n\t\t\tinterval: '1m',\n\t\t\tretention: 60 * 60 * 1000, // 1 hour\n\t\t\tpartitionInterval: 'hourly',\n\t\t},\n\t\t{\n\t\t\tname: '1m',\n\t\t\tinterval: '1m',\n\t\t\tretention: 7 * 24 * 60 * 60 * 1000, // 7 days\n\t\t\tpartitionInterval: 'daily',\n\t\t},\n\t\t{\n\t\t\tname: '1h',\n\t\t\tinterval: '1h',\n\t\t\tretention: 0, // Forever\n\t\t\tpartitionInterval: 'monthly',\n\t\t},\n\t],\n\tflushInterval: 10_000, // 10 seconds\n\tmaxBatchSize: 1000,\n\tautoRollup: true,\n\ttdigestCompression: 100,\n};\n\n/**\n * Rollup options for aggregating data between tiers\n */\nexport interface RollupOptions {\n\t/** Source tier */\n\tfrom: string;\n\t/** Target tier */\n\tto: string;\n\t/** Only rollup data older than this */\n\tolderThan: Date;\n}\n\n/**\n * Partition info for management\n */\nexport interface PartitionInfo {\n\t/** Partition name */\n\tname: string;\n\t/** Tier this partition belongs to */\n\ttier: string;\n\t/** Partition start time */\n\tstart: Date;\n\t/** Partition end time */\n\tend: Date;\n\t/** Approximate row count */\n\trowCount?: number;\n\t/** Size in bytes */\n\tsizeBytes?: number;\n}\n"],"mappings":";;;;;AA2LA,MAAa,yBAA+C;CAC3D,OAAO;EACN;GACC,MAAM;GACN,UAAU;GACV,WAAW;GACX,mBAAmB;EACpB;EACA;GACC,MAAM;GACN,UAAU;GACV,WAAW;GACX,mBAAmB;EACpB;EACA;GACC,MAAM;GACN,UAAU;GACV,WAAW;GACX,mBAAmB;EACpB;CACD;CACA,eAAe;CACf,cAAc;CACd,YAAY;CACZ,oBAAoB;AACrB"}

package/dist/metrics/storage/types.d.cts

@@ -1,2 +1,207 @@
-import { AggregationInterval, DEFAULT_METRICS_CONFIG, MetricBucket, MetricLabels, MetricPoint, MetricQuery, MetricResult, MetricTimeSeriesPoint, MetricType, MetricsStorageConfig, PartitionInfo, RollupOptions, StorageTier, TDigestData, TimeRange } from "../../types-BS3Rx8Sk.cjs";
-export { AggregationInterval, DEFAULT_METRICS_CONFIG, MetricBucket, MetricLabels, MetricPoint, MetricQuery, MetricResult, MetricTimeSeriesPoint, MetricType, MetricsStorageConfig, PartitionInfo, RollupOptions, StorageTier, TDigestData, TimeRange };
+//#region src/metrics/storage/types.d.ts
+/**
+ * Metric types supported by the storage system
+ */
+export type MetricType = 'counter' | 'gauge' | 'histogram';
+/**
+ * Labels/dimensions for metric filtering and grouping
+ */
+export type MetricLabels = Record<string, string>;
+/**
+ * A single metric data point
+ */
+export interface MetricPoint {
+  /** Timestamp of the metric */
+  timestamp: Date;
+  /** Project/app identifier for multi-tenant isolation */
+  projectId: string;
+  /** Service name (e.g., 'api', 'worker', 'cron') */
+  service: string;
+  /** Environment (e.g., 'development', 'staging', 'production') */
+  environment: string;
+  /** Metric name (e.g., 'http.request.duration', 'orders.created') */
+  name: string;
+  /** Metric type */
+  type: MetricType;
+  /** Numeric value */
+  value: number;
+  /** Dimensions for filtering/grouping */
+  labels: MetricLabels;
+}
+/**
+ * Aggregated metric bucket (pre-computed for efficient queries)
+ */
+export interface MetricBucket {
+  /** Bucket start timestamp */
+  bucket: Date;
+  /** Project identifier */
+  projectId: string;
+  /** Service name */
+  service: string;
+  /** Environment */
+  environment: string;
+  /** Metric name */
+  name: string;
+  /** Hash of labels for grouping */
+  labelsHash: string;
+  /** Original labels */
+  labels: MetricLabels;
+  /** Number of data points in bucket */
+  count: number;
+  /** Sum of values */
+  sum: number;
+  /** Minimum value */
+  min: number;
+  /** Maximum value */
+  max: number;
+  /** T-Digest sketch for percentile calculations (serialized) */
+  sketch?: TDigestData;
+}
+/**
+ * Serialized T-Digest data structure for percentile calculations
+ * Stores centroids (mean, weight) that can be merged across buckets
+ */
+export interface TDigestData {
+  /** Centroids: [mean, weight][] */
+  centroids: [number, number][];
+  /** Compression factor (higher = more accuracy, more memory) */
+  compression: number;
+  /** Total count of values */
+  count: number;
+  /** Minimum value seen */
+  min: number;
+  /** Maximum value seen */
+  max: number;
+}
+/**
+ * Time range for queries
+ */
+export interface TimeRange {
+  start: Date;
+  end: Date;
+}
+/**
+ * Aggregation granularity
+ */
+export type AggregationInterval = '1m' | '5m' | '15m' | '1h' | '6h' | '1d';
+/**
+ * Query parameters for retrieving metrics
+ */
+export interface MetricQuery {
+  /** Project filter (required for multi-tenant) */
+  projectId: string;
+  /** Optional service filter */
+  service?: string;
+  /** Optional environment filter */
+  environment?: string;
+  /** Metric name pattern (supports wildcards like 'http.*') */
+  name?: string;
+  /** Label filters */
+  labels?: MetricLabels;
+  /** Time range */
+  range: TimeRange;
+  /** Aggregation interval */
+  interval?: AggregationInterval;
+  /** Group by these label keys */
+  groupBy?: string[];
+  /** Maximum number of results */
+  limit?: number;
+}
+/**
+ * Query result with aggregated values
+ */
+export interface MetricResult {
+  /** Metric name */
+  name: string;
+  /** Labels (grouped by keys if specified) */
+  labels: MetricLabels;
+  /** Time series data points */
+  timeSeries: MetricTimeSeriesPoint[];
+  /** Overall statistics for the query range */
+  stats: {
+    count: number;
+    sum: number;
+    avg: number;
+    min: number;
+    max: number;
+    p50: number;
+    p95: number;
+    p99: number;
+  };
+}
+/**
+ * Single point in a time series result
+ */
+export interface MetricTimeSeriesPoint {
+  timestamp: Date;
+  count: number;
+  sum: number;
+  avg: number;
+  min: number;
+  max: number;
+  p50?: number;
+  p95?: number;
+  p99?: number;
+}
+/**
+ * Storage tier configuration
+ */
+export interface StorageTier {
+  /** Table/collection name for this tier */
+  name: string;
+  /** Bucket interval for aggregation */
+  interval: AggregationInterval;
+  /** Retention duration in milliseconds (0 = forever) */
+  retention: number;
+  /** Partition interval for efficient pruning */
+  partitionInterval: 'hourly' | 'daily' | 'weekly' | 'monthly';
+}
+/**
+ * Metrics storage configuration
+ */
+export interface MetricsStorageConfig {
+  /** Storage tiers (raw, minute, hourly, etc.) */
+  tiers: StorageTier[];
+  /** Flush interval in milliseconds */
+  flushInterval: number;
+  /** Maximum batch size for writes */
+  maxBatchSize: number;
+  /** Enable automatic rollup between tiers */
+  autoRollup: boolean;
+  /** T-Digest compression factor (default: 100) */
+  tdigestCompression: number;
+}
+/**
+ * Default configuration with hybrid storage strategy
+ */
+export declare const DEFAULT_METRICS_CONFIG: MetricsStorageConfig;
+/**
+ * Rollup options for aggregating data between tiers
+ */
+export interface RollupOptions {
+  /** Source tier */
+  from: string;
+  /** Target tier */
+  to: string;
+  /** Only rollup data older than this */
+  olderThan: Date;
+}
+/**
+ * Partition info for management
+ */
+export interface PartitionInfo {
+  /** Partition name */
+  name: string;
+  /** Tier this partition belongs to */
+  tier: string;
+  /** Partition start time */
+  start: Date;
+  /** Partition end time */
+  end: Date;
+  /** Approximate row count */
+  rowCount?: number;
+  /** Size in bytes */
+  sizeBytes?: number;
+}
+//#endregion
+//# sourceMappingURL=types.d.cts.map

package/dist/metrics/storage/types.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.cts","names":[],"sources":["../../../src/metrics/storage/types.ts"],"mappings":";;;;YAGY;;;;YAKA,eAAe;;;;iBAKV;;EAEhB,WAAW;;EAEX;;EAEA;;EAEA;;EAEA;;EAEA,MAAM;;EAEN;;EAEA,QAAQ;;;;;iBAMQ;;EAEhB,QAAQ;;EAER;;EAEA;;EAEA;;EAEA;;EAEA;;EAEA,QAAQ;;EAER;;EAEA;;EAEA;;EAEA;;EAEA,SAAS;;;;;;iBAOO;;EAEhB;;EAEA;;EAEA;;EAEA;;EAEA;;;;;iBAMgB;EAChB,OAAO;EACP,KAAK;;;;;YAMM;;;;iBAKK;;EAEhB;;EAEA;;EAEA;;EAEA;;EAEA,SAAS;;EAET,OAAO;;EAEP,WAAW;;EAEX;;EAEA;;;;;iBAMgB;;EAEhB;;EAEA,QAAQ;;EAER,YAAY;;EAEZ;IACC;IACA;IACA;IACA;IACA;IACA;IACA;IACA;;;;;;iBAOe;EAChB,WAAW;EACX;EACA;EACA;EACA;EACA;EACA;EACA;EACA;;;;;iBAMgB;;EAEhB;;EAEA,UAAU;;EAEV;;EAEA;;;;;iBAMgB;;EAEhB,OAAO;;EAEP;;EAEA;;EAEA;;EAEA;;;;;qBAMY,wBAAwB;;;;iBA8BpB;;EAEhB;;EAEA;;EAEA,WAAW;;;;;iBAMK;;EAEhB;;EAEA;;EAEA,OAAO;;EAEP,KAAK;;EAEL;;EAEA"}

package/dist/metrics/storage/types.d.mts

@@ -1,2 +1,207 @@
-import { AggregationInterval, DEFAULT_METRICS_CONFIG, MetricBucket, MetricLabels, MetricPoint, MetricQuery, MetricResult, MetricTimeSeriesPoint, MetricType, MetricsStorageConfig, PartitionInfo, RollupOptions, StorageTier, TDigestData, TimeRange } from "../../types-CbNGXnJE.mjs";
-export { AggregationInterval, DEFAULT_METRICS_CONFIG, MetricBucket, MetricLabels, MetricPoint, MetricQuery, MetricResult, MetricTimeSeriesPoint, MetricType, MetricsStorageConfig, PartitionInfo, RollupOptions, StorageTier, TDigestData, TimeRange };
+//#region src/metrics/storage/types.d.ts
+/**
+ * Metric types supported by the storage system
+ */
+export type MetricType = 'counter' | 'gauge' | 'histogram';
+/**
+ * Labels/dimensions for metric filtering and grouping
+ */
+export type MetricLabels = Record<string, string>;
+/**
+ * A single metric data point
+ */
+export interface MetricPoint {
+  /** Timestamp of the metric */
+  timestamp: Date;
+  /** Project/app identifier for multi-tenant isolation */
+  projectId: string;
+  /** Service name (e.g., 'api', 'worker', 'cron') */
+  service: string;
+  /** Environment (e.g., 'development', 'staging', 'production') */
+  environment: string;
+  /** Metric name (e.g., 'http.request.duration', 'orders.created') */
+  name: string;
+  /** Metric type */
+  type: MetricType;
+  /** Numeric value */
+  value: number;
+  /** Dimensions for filtering/grouping */
+  labels: MetricLabels;
+}
+/**
+ * Aggregated metric bucket (pre-computed for efficient queries)
+ */
+export interface MetricBucket {
+  /** Bucket start timestamp */
+  bucket: Date;
+  /** Project identifier */
+  projectId: string;
+  /** Service name */
+  service: string;
+  /** Environment */
+  environment: string;
+  /** Metric name */
+  name: string;
+  /** Hash of labels for grouping */
+  labelsHash: string;
+  /** Original labels */
+  labels: MetricLabels;
+  /** Number of data points in bucket */
+  count: number;
+  /** Sum of values */
+  sum: number;
+  /** Minimum value */
+  min: number;
+  /** Maximum value */
+  max: number;
+  /** T-Digest sketch for percentile calculations (serialized) */
+  sketch?: TDigestData;
+}
+/**
+ * Serialized T-Digest data structure for percentile calculations
+ * Stores centroids (mean, weight) that can be merged across buckets
+ */
+export interface TDigestData {
+  /** Centroids: [mean, weight][] */
+  centroids: [number, number][];
+  /** Compression factor (higher = more accuracy, more memory) */
+  compression: number;
+  /** Total count of values */
+  count: number;
+  /** Minimum value seen */
+  min: number;
+  /** Maximum value seen */
+  max: number;
+}
+/**
+ * Time range for queries
+ */
+export interface TimeRange {
+  start: Date;
+  end: Date;
+}
+/**
+ * Aggregation granularity
+ */
+export type AggregationInterval = '1m' | '5m' | '15m' | '1h' | '6h' | '1d';
+/**
+ * Query parameters for retrieving metrics
+ */
+export interface MetricQuery {
+  /** Project filter (required for multi-tenant) */
+  projectId: string;
+  /** Optional service filter */
+  service?: string;
+  /** Optional environment filter */
+  environment?: string;
+  /** Metric name pattern (supports wildcards like 'http.*') */
+  name?: string;
+  /** Label filters */
+  labels?: MetricLabels;
+  /** Time range */
+  range: TimeRange;
+  /** Aggregation interval */
+  interval?: AggregationInterval;
+  /** Group by these label keys */
+  groupBy?: string[];
+  /** Maximum number of results */
+  limit?: number;
+}
+/**
+ * Query result with aggregated values
+ */
+export interface MetricResult {
+  /** Metric name */
+  name: string;
+  /** Labels (grouped by keys if specified) */
+  labels: MetricLabels;
+  /** Time series data points */
+  timeSeries: MetricTimeSeriesPoint[];
+  /** Overall statistics for the query range */
+  stats: {
+    count: number;
+    sum: number;
+    avg: number;
+    min: number;
+    max: number;
+    p50: number;
+    p95: number;
+    p99: number;
+  };
+}
+/**
+ * Single point in a time series result
+ */
+export interface MetricTimeSeriesPoint {
+  timestamp: Date;
+  count: number;
+  sum: number;
+  avg: number;
+  min: number;
+  max: number;
+  p50?: number;
+  p95?: number;
+  p99?: number;
+}
+/**
+ * Storage tier configuration
+ */
+export interface StorageTier {
+  /** Table/collection name for this tier */
+  name: string;
+  /** Bucket interval for aggregation */
+  interval: AggregationInterval;
+  /** Retention duration in milliseconds (0 = forever) */
+  retention: number;
+  /** Partition interval for efficient pruning */
+  partitionInterval: 'hourly' | 'daily' | 'weekly' | 'monthly';
+}
+/**
+ * Metrics storage configuration
+ */
+export interface MetricsStorageConfig {
+  /** Storage tiers (raw, minute, hourly, etc.) */
+  tiers: StorageTier[];
+  /** Flush interval in milliseconds */
+  flushInterval: number;
+  /** Maximum batch size for writes */
+  maxBatchSize: number;
+  /** Enable automatic rollup between tiers */
+  autoRollup: boolean;
+  /** T-Digest compression factor (default: 100) */
+  tdigestCompression: number;
+}
+/**
+ * Default configuration with hybrid storage strategy
+ */
+export declare const DEFAULT_METRICS_CONFIG: MetricsStorageConfig;
+/**
+ * Rollup options for aggregating data between tiers
+ */
+export interface RollupOptions {
+  /** Source tier */
+  from: string;
+  /** Target tier */
+  to: string;
+  /** Only rollup data older than this */
+  olderThan: Date;
+}
+/**
+ * Partition info for management
+ */
+export interface PartitionInfo {
+  /** Partition name */
+  name: string;
+  /** Tier this partition belongs to */
+  tier: string;
+  /** Partition start time */
+  start: Date;
+  /** Partition end time */
+  end: Date;
+  /** Approximate row count */
+  rowCount?: number;
+  /** Size in bytes */
+  sizeBytes?: number;
+}
+//#endregion
+//# sourceMappingURL=types.d.mts.map

package/dist/metrics/storage/types.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.mts","names":[],"sources":["../../../src/metrics/storage/types.ts"],"mappings":";;;;YAGY;;;;YAKA,eAAe;;;;iBAKV;;EAEhB,WAAW;;EAEX;;EAEA;;EAEA;;EAEA;;EAEA,MAAM;;EAEN;;EAEA,QAAQ;;;;;iBAMQ;;EAEhB,QAAQ;;EAER;;EAEA;;EAEA;;EAEA;;EAEA;;EAEA,QAAQ;;EAER;;EAEA;;EAEA;;EAEA;;EAEA,SAAS;;;;;;iBAOO;;EAEhB;;EAEA;;EAEA;;EAEA;;EAEA;;;;;iBAMgB;EAChB,OAAO;EACP,KAAK;;;;;YAMM;;;;iBAKK;;EAEhB;;EAEA;;EAEA;;EAEA;;EAEA,SAAS;;EAET,OAAO;;EAEP,WAAW;;EAEX;;EAEA;;;;;iBAMgB;;EAEhB;;EAEA,QAAQ;;EAER,YAAY;;EAEZ;IACC;IACA;IACA;IACA;IACA;IACA;IACA;IACA;;;;;;iBAOe;EAChB,WAAW;EACX;EACA;EACA;EACA;EACA;EACA;EACA;EACA;;;;;iBAMgB;;EAEhB;;EAEA,UAAU;;EAEV;;EAEA;;;;;iBAMgB;;EAEhB,OAAO;;EAEP;;EAEA;;EAEA;;EAEA;;;;;qBAMY,wBAAwB;;;;iBA8BpB;;EAEhB;;EAEA;;EAEA,WAAW;;;;;iBAMK;;EAEhB;;EAEA;;EAEA,OAAO;;EAEP,KAAK;;EAEL;;EAEA"}