@geekmidas/telescope 10.0.0-alpha.98 → 10.0.0

package/dist/types-BRzW1NM8.d.cts

@@ -0,0 +1,166 @@
+import { Context } from "hono";
+
+//#region src/adapters/types.d.ts
+
+/**
+ * Environment types for adapter configuration
+ */
+type TelescopeEnvironment = 'server' | 'lambda' | 'edge' | 'custom';
+/**
+ * Request context passed to adapters
+ */
+interface AdapterRequestContext {
+  /** Unique request ID */
+  id: string;
+  /** HTTP method */
+  method: string;
+  /** Request path */
+  path: string;
+  /** Full URL */
+  url: string;
+  /** Request headers */
+  headers: Record<string, string>;
+  /** Query parameters */
+  query: Record<string, string>;
+  /** Request body (if recorded) */
+  body?: unknown;
+  /** Client IP address */
+  ip?: string;
+  /** Request start time */
+  startTime: number;
+  /** Request body size in bytes */
+  requestSize?: number;
+}
+/**
+ * Response context passed to adapters
+ */
+interface AdapterResponseContext {
+  /** HTTP status code */
+  status: number;
+  /** Response headers */
+  headers: Record<string, string>;
+  /** Response body (if recorded) */
+  body?: unknown;
+  /** Request duration in milliseconds */
+  duration: number;
+  /** Response body size in bytes */
+  responseSize?: number;
+}
+/**
+ * Error context for exception handling
+ */
+interface AdapterErrorContext {
+  /** The error that occurred */
+  error: Error;
+  /** Associated request ID */
+  requestId?: string;
+  /** Whether the error was handled */
+  handled: boolean;
+}
+/**
+ * Span processor strategy for telemetry export
+ */
+type SpanProcessorStrategy = 'batch' | 'simple';
+/**
+ * Options for span processor configuration
+ */
+interface SpanProcessorOptions {
+  /** Processor strategy (batch for servers, simple for Lambda) */
+  strategy: SpanProcessorStrategy;
+  /** Maximum queue size for batch processor (default: 2048) */
+  maxQueueSize?: number;
+  /** Scheduled delay for batch processor in ms (default: 5000) */
+  scheduledDelayMillis?: number;
+  /** Export timeout in ms (default: 30000) */
+  exportTimeoutMillis?: number;
+  /** Maximum export batch size (default: 512) */
+  maxExportBatchSize?: number;
+}
+/**
+ * Adapter lifecycle hooks
+ */
+interface AdapterLifecycle {
+  /**
+   * Called when the adapter is initialized
+   */
+  onSetup?(): Promise<void> | void;
+  /**
+   * Called before the adapter is destroyed
+   */
+  onDestroy?(): Promise<void> | void;
+}
+/**
+ * Base adapter configuration
+ */
+interface AdapterConfig {
+  /** Environment type */
+  environment: TelescopeEnvironment;
+  /** Span processor options */
+  spanProcessor?: SpanProcessorOptions;
+  /** Whether to auto-flush on response */
+  autoFlush?: boolean;
+}
+/**
+ * Interface for environment-specific adapters.
+ * Adapters handle the integration between Telescope core and the runtime environment.
+ */
+interface TelescopeAdapter<TConfig extends AdapterConfig = AdapterConfig> extends AdapterLifecycle {
+  /** Adapter configuration */
+  readonly config: TConfig;
+  /**
+   * Extract request context from the runtime's request object.
+   * This is called at the start of request processing.
+   */
+  extractRequestContext(request: unknown): AdapterRequestContext;
+  /**
+   * Extract response context from the runtime's response object.
+   * This is called after the response is generated.
+   */
+  extractResponseContext(response: unknown, startTime: number): AdapterResponseContext;
+  /**
+   * Flush any pending telemetry data.
+   * Critical for serverless environments where the process may be frozen.
+   */
+  flush(): Promise<void>;
+}
+/**
+ * Hono-specific adapter configuration
+ */
+interface HonoAdapterConfig extends AdapterConfig {
+  environment: 'server' | 'lambda' | 'edge';
+}
+/**
+ * Lambda-specific adapter configuration
+ */
+interface LambdaAdapterConfig extends AdapterConfig {
+  environment: 'lambda';
+  /** Whether to detect Lambda resource attributes */
+  detectResource?: boolean;
+  /** Custom resource attributes */
+  resourceAttributes?: Record<string, string>;
+}
+/**
+ * Type helper for Hono context with Telescope
+ */
+interface TelescopeHonoContext {
+  /** Request ID for correlation */
+  requestId: string;
+  /** Request start time */
+  startTime: number;
+}
+/**
+ * Hono context variables type
+ */
+interface TelescopeHonoVariables {
+  telescope: TelescopeHonoContext;
+}
+/**
+ * Extended Hono context with Telescope variables
+ */
+type HonoContextWithTelescope = Context<{
+  Variables: TelescopeHonoVariables;
+}>;
+//# sourceMappingURL=types.d.ts.map
+//#endregion
+export { AdapterConfig, AdapterErrorContext, AdapterLifecycle, AdapterRequestContext, AdapterResponseContext, HonoAdapterConfig, HonoContextWithTelescope, LambdaAdapterConfig, SpanProcessorOptions, SpanProcessorStrategy, TelescopeAdapter, TelescopeEnvironment, TelescopeHonoContext, TelescopeHonoVariables };
+//# sourceMappingURL=types-BRzW1NM8.d.cts.map

package/dist/types-BRzW1NM8.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types-BRzW1NM8.d.cts","names":[],"sources":["../src/adapters/types.ts"],"sourcesContent":[],"mappings":";;;;;;AAKA;AAKiB,KALL,oBAAA,GAK0B,QAAA,GAAA,QAAA,GAAA,MAAA,GAAA,QAAA;;;;AAYxB,UAZG,qBAAA,CAYH;EAcG;EAgBA,EAAA,EAAA,MAAA;EAYL;EAKK,MAAA,EAAA,MAAA;EAgBA;EAAgB,IAAA,EAAA,MAAA;EAAA;EAIb,GAKL,EAAA,MAAA;EAAO;EAML,OAAA,EAhFP,MAgFO,CAAa,MAAA,EAAA,MAAA,CAAA;EAAA;EAAA,KAEhB,EAhFN,MAgFM,CAAA,MAAA,EAAA,MAAA,CAAA;EAAoB;EAEG,IAAA,CAAA,EAAA,OAAA;EASpB;EAAgB,EAAA,CAAA,EAAA,MAAA;EAAA;EAA8B,SAAG,EAAA,MAAA;EAAa;EAGtD,WAMiB,CAAA,EAAA,MAAA;;;;AARjB;AA6BR,UA3GA,sBAAA,CA2G0B;EAO1B;EAAoB,MAAA,EAAA,MAAA;EAAA;EAKT,OALiB,EA9GnC,MA8GmC,CAAA,MAAA,EAAA,MAAA,CAAA;EAAa;EAWzC,IAAA,CAAA,EAAA,OAAA;EAUA;EAOL,QAAA,EAAA,MAAA;EAAwB;EAAA,YACxB,CAAA,EAAA,MAAA;;AADsC;;;UA9HjC,mBAAA;;SAET;;;;;;;;;KAUI,qBAAA;;;;UAKK,oBAAA;;YAEN;;;;;;;;;;;;;UAcM,gBAAA;;;;cAIJ;;;;gBAKE;;;;;UAME,aAAA;;eAEH;;kBAEG;;;;;;;;UASA,iCAAiC,gBAAgB,uBACzD;;mBAES;;;;;2CAMwB;;;;;gEAStC;;;;;WAMM;;;;;UAMO,iBAAA,SAA0B;;;;;;UAO1B,mBAAA,SAA4B;;;;;uBAKvB;;;;;UAML,oBAAA;;;;;;;;;UAUA,sBAAA;aACL;;;;;KAMA,wBAAA,GAA2B;aAC3B"}

package/dist/types-BS3Rx8Sk.d.cts

@@ -0,0 +1,209 @@
+//#region src/metrics/storage/types.d.ts
+/**
+ * Metric types supported by the storage system
+ */
+type MetricType = 'counter' | 'gauge' | 'histogram';
+/**
+ * Labels/dimensions for metric filtering and grouping
+ */
+type MetricLabels = Record<string, string>;
+/**
+ * A single metric data point
+ */
+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)
+ */
+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
+ */
+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
+ */
+interface TimeRange {
+  start: Date;
+  end: Date;
+}
+/**
+ * Aggregation granularity
+ */
+type AggregationInterval = '1m' | '5m' | '15m' | '1h' | '6h' | '1d';
+/**
+ * Query parameters for retrieving metrics
+ */
+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
+ */
+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
+ */
+interface MetricTimeSeriesPoint {
+  timestamp: Date;
+  count: number;
+  sum: number;
+  avg: number;
+  min: number;
+  max: number;
+  p50?: number;
+  p95?: number;
+  p99?: number;
+}
+/**
+ * Storage tier configuration
+ */
+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
+ */
+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
+ */
+declare const DEFAULT_METRICS_CONFIG: MetricsStorageConfig;
+/**
+ * Rollup options for aggregating data between tiers
+ */
+interface RollupOptions {
+  /** Source tier */
+  from: string;
+  /** Target tier */
+  to: string;
+  /** Only rollup data older than this */
+  olderThan: Date;
+}
+/**
+ * Partition info for management
+ */
+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;
+}
+//# sourceMappingURL=types.d.ts.map
+//#endregion
+export { AggregationInterval, DEFAULT_METRICS_CONFIG, MetricBucket, MetricLabels, MetricPoint, MetricQuery, MetricResult, MetricTimeSeriesPoint, MetricType, MetricsStorageConfig, PartitionInfo, RollupOptions, StorageTier, TDigestData, TimeRange };
+//# sourceMappingURL=types-BS3Rx8Sk.d.cts.map

package/dist/types-BS3Rx8Sk.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types-BS3Rx8Sk.d.cts","names":[],"sources":["../src/metrics/storage/types.ts"],"sourcesContent":[],"mappings":";;AAGA;AAKA;AAKiB,KAVL,UAAA,GAUgB,SAAA,GAAA,OAAA,GAAA,WAAA;;;;AAgBnB,KArBG,YAAA,GAAe,MAqBlB,CAAA,MAAA,EAAA,MAAA,CAAA;AAAY;AAMrB;;AAES,UAxBQ,WAAA,CAwBR;EAAI;EAYQ,SAUX,EA5CE,IA4CF;EAAW;EAOJ,SAAA,EAAA,MAAW;EAgBX;EAAS,OAAA,EAAA,MAAA;EAAA;EACd,WACN,EAAA,MAAA;EAAI;EAME,IAAA,EAAA,MAAA;EAKK;EAAW,IAAA,EAtErB,UAsEqB;EAAA;EAUN,KAEd,EAAA,MAAA;EAAS;EAEc,MAAA,EAhFtB,YAgFsB;AAU/B;;;;AAMkC,UA1FjB,YAAA,CA0FiB;EAiBjB;EAeA,MAAA,EAxHR,IAwHQ;EAcA;EAgBJ,SAAA,EAAA,MAAA;EA8BI;EAYA,OAAA,EAAA,MAAA;EAAa;EAAA,WAMtB,EAAA,MAAA;EAAI;EAEF,IAAA,EAAA,MAAA;;;;UA5LD;;;;;;;;;;WAUC;;;;;;UAOO,WAAA;;;;;;;;;;;;;;;UAgBA,SAAA;SACT;OACF;;;;;KAMM,mBAAA;;;;UAKK,WAAA;;;;;;;;;;WAUP;;SAEF;;aAEI;;;;;;;;;UAUK,YAAA;;;;UAIR;;cAEI;;;;;;;;;;;;;;;;UAiBI,qBAAA;aACL;;;;;;;;;;;;;UAcK,WAAA;;;;YAIN;;;;;;;;;UAUM,oBAAA;;SAET;;;;;;;;;;;;;cAcK,wBAAwB;;;;UA8BpB,aAAA;;;;;;aAML;;;;;UAMK,aAAA;;;;;;SAMT;;OAEF"}

package/dist/types-Bwm_jNU7.mjs

@@ -0,0 +1,54 @@
+//#region src/otlp/types.ts
+let SpanKind = /* @__PURE__ */ function(SpanKind$1) {
+	SpanKind$1[SpanKind$1["SPAN_KIND_UNSPECIFIED"] = 0] = "SPAN_KIND_UNSPECIFIED";
+	SpanKind$1[SpanKind$1["SPAN_KIND_INTERNAL"] = 1] = "SPAN_KIND_INTERNAL";
+	SpanKind$1[SpanKind$1["SPAN_KIND_SERVER"] = 2] = "SPAN_KIND_SERVER";
+	SpanKind$1[SpanKind$1["SPAN_KIND_CLIENT"] = 3] = "SPAN_KIND_CLIENT";
+	SpanKind$1[SpanKind$1["SPAN_KIND_PRODUCER"] = 4] = "SPAN_KIND_PRODUCER";
+	SpanKind$1[SpanKind$1["SPAN_KIND_CONSUMER"] = 5] = "SPAN_KIND_CONSUMER";
+	return SpanKind$1;
+}({});
+let SpanStatusCode = /* @__PURE__ */ function(SpanStatusCode$1) {
+	SpanStatusCode$1[SpanStatusCode$1["STATUS_CODE_UNSET"] = 0] = "STATUS_CODE_UNSET";
+	SpanStatusCode$1[SpanStatusCode$1["STATUS_CODE_OK"] = 1] = "STATUS_CODE_OK";
+	SpanStatusCode$1[SpanStatusCode$1["STATUS_CODE_ERROR"] = 2] = "STATUS_CODE_ERROR";
+	return SpanStatusCode$1;
+}({});
+let SeverityNumber = /* @__PURE__ */ function(SeverityNumber$1) {
+	SeverityNumber$1[SeverityNumber$1["SEVERITY_NUMBER_UNSPECIFIED"] = 0] = "SEVERITY_NUMBER_UNSPECIFIED";
+	SeverityNumber$1[SeverityNumber$1["SEVERITY_NUMBER_TRACE"] = 1] = "SEVERITY_NUMBER_TRACE";
+	SeverityNumber$1[SeverityNumber$1["SEVERITY_NUMBER_TRACE2"] = 2] = "SEVERITY_NUMBER_TRACE2";
+	SeverityNumber$1[SeverityNumber$1["SEVERITY_NUMBER_TRACE3"] = 3] = "SEVERITY_NUMBER_TRACE3";
+	SeverityNumber$1[SeverityNumber$1["SEVERITY_NUMBER_TRACE4"] = 4] = "SEVERITY_NUMBER_TRACE4";
+	SeverityNumber$1[SeverityNumber$1["SEVERITY_NUMBER_DEBUG"] = 5] = "SEVERITY_NUMBER_DEBUG";
+	SeverityNumber$1[SeverityNumber$1["SEVERITY_NUMBER_DEBUG2"] = 6] = "SEVERITY_NUMBER_DEBUG2";
+	SeverityNumber$1[SeverityNumber$1["SEVERITY_NUMBER_DEBUG3"] = 7] = "SEVERITY_NUMBER_DEBUG3";
+	SeverityNumber$1[SeverityNumber$1["SEVERITY_NUMBER_DEBUG4"] = 8] = "SEVERITY_NUMBER_DEBUG4";
+	SeverityNumber$1[SeverityNumber$1["SEVERITY_NUMBER_INFO"] = 9] = "SEVERITY_NUMBER_INFO";
+	SeverityNumber$1[SeverityNumber$1["SEVERITY_NUMBER_INFO2"] = 10] = "SEVERITY_NUMBER_INFO2";
+	SeverityNumber$1[SeverityNumber$1["SEVERITY_NUMBER_INFO3"] = 11] = "SEVERITY_NUMBER_INFO3";
+	SeverityNumber$1[SeverityNumber$1["SEVERITY_NUMBER_INFO4"] = 12] = "SEVERITY_NUMBER_INFO4";
+	SeverityNumber$1[SeverityNumber$1["SEVERITY_NUMBER_WARN"] = 13] = "SEVERITY_NUMBER_WARN";
+	SeverityNumber$1[SeverityNumber$1["SEVERITY_NUMBER_WARN2"] = 14] = "SEVERITY_NUMBER_WARN2";
+	SeverityNumber$1[SeverityNumber$1["SEVERITY_NUMBER_WARN3"] = 15] = "SEVERITY_NUMBER_WARN3";
+	SeverityNumber$1[SeverityNumber$1["SEVERITY_NUMBER_WARN4"] = 16] = "SEVERITY_NUMBER_WARN4";
+	SeverityNumber$1[SeverityNumber$1["SEVERITY_NUMBER_ERROR"] = 17] = "SEVERITY_NUMBER_ERROR";
+	SeverityNumber$1[SeverityNumber$1["SEVERITY_NUMBER_ERROR2"] = 18] = "SEVERITY_NUMBER_ERROR2";
+	SeverityNumber$1[SeverityNumber$1["SEVERITY_NUMBER_ERROR3"] = 19] = "SEVERITY_NUMBER_ERROR3";
+	SeverityNumber$1[SeverityNumber$1["SEVERITY_NUMBER_ERROR4"] = 20] = "SEVERITY_NUMBER_ERROR4";
+	SeverityNumber$1[SeverityNumber$1["SEVERITY_NUMBER_FATAL"] = 21] = "SEVERITY_NUMBER_FATAL";
+	SeverityNumber$1[SeverityNumber$1["SEVERITY_NUMBER_FATAL2"] = 22] = "SEVERITY_NUMBER_FATAL2";
+	SeverityNumber$1[SeverityNumber$1["SEVERITY_NUMBER_FATAL3"] = 23] = "SEVERITY_NUMBER_FATAL3";
+	SeverityNumber$1[SeverityNumber$1["SEVERITY_NUMBER_FATAL4"] = 24] = "SEVERITY_NUMBER_FATAL4";
+	return SeverityNumber$1;
+}({});
+let AggregationTemporality = /* @__PURE__ */ function(AggregationTemporality$1) {
+	AggregationTemporality$1[AggregationTemporality$1["AGGREGATION_TEMPORALITY_UNSPECIFIED"] = 0] = "AGGREGATION_TEMPORALITY_UNSPECIFIED";
+	AggregationTemporality$1[AggregationTemporality$1["AGGREGATION_TEMPORALITY_DELTA"] = 1] = "AGGREGATION_TEMPORALITY_DELTA";
+	AggregationTemporality$1[AggregationTemporality$1["AGGREGATION_TEMPORALITY_CUMULATIVE"] = 2] = "AGGREGATION_TEMPORALITY_CUMULATIVE";
+	return AggregationTemporality$1;
+}({});
+
+//#endregion
+export { AggregationTemporality, SeverityNumber, SpanKind, SpanStatusCode };
+//# sourceMappingURL=types-Bwm_jNU7.mjs.map

package/dist/types-Bwm_jNU7.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"types-Bwm_jNU7.mjs","names":[],"sources":["../src/otlp/types.ts"],"sourcesContent":["/**\n * OTLP JSON types based on OpenTelemetry Protocol specification.\n * These types represent the JSON encoding of OTLP protobuf messages.\n * @see https://opentelemetry.io/docs/specs/otlp/\n */\n\n// ============================================\n// Common Types\n// ============================================\n\n/**\n * Key-value pair for attributes\n */\nexport interface KeyValue {\n\tkey: string;\n\tvalue: AnyValue;\n}\n\n/**\n * Any value type (string, bool, int, double, array, kvlist, bytes)\n */\nexport interface AnyValue {\n\tstringValue?: string;\n\tboolValue?: boolean;\n\tintValue?: string; // int64 as string\n\tdoubleValue?: number;\n\tarrayValue?: ArrayValue;\n\tkvlistValue?: KeyValueList;\n\tbytesValue?: string; // base64 encoded\n}\n\nexport interface ArrayValue {\n\tvalues: AnyValue[];\n}\n\nexport interface KeyValueList {\n\tvalues: KeyValue[];\n}\n\n/**\n * Resource represents the entity producing telemetry\n */\nexport interface Resource {\n\tattributes?: KeyValue[];\n\tdroppedAttributesCount?: number;\n}\n\n/**\n * InstrumentationScope represents the instrumentation library\n */\nexport interface InstrumentationScope {\n\tname: string;\n\tversion?: string;\n\tattributes?: KeyValue[];\n\tdroppedAttributesCount?: number;\n}\n\n// ============================================\n// Trace Types\n// ============================================\n\n/**\n * Root message for trace export\n */\nexport interface ExportTraceServiceRequest {\n\tresourceSpans?: ResourceSpans[];\n}\n\nexport interface ResourceSpans {\n\tresource?: Resource;\n\tscopeSpans?: ScopeSpans[];\n\tschemaUrl?: string;\n}\n\nexport interface ScopeSpans {\n\tscope?: InstrumentationScope;\n\tspans?: Span[];\n\tschemaUrl?: string;\n}\n\nexport interface Span {\n\ttraceId: string; // hex encoded 16 bytes\n\tspanId: string; // hex encoded 8 bytes\n\ttraceState?: string;\n\tparentSpanId?: string; // hex encoded 8 bytes\n\tflags?: number;\n\tname: string;\n\tkind?: SpanKind;\n\tstartTimeUnixNano: string; // uint64 as string\n\tendTimeUnixNano: string; // uint64 as string\n\tattributes?: KeyValue[];\n\tdroppedAttributesCount?: number;\n\tevents?: SpanEvent[];\n\tdroppedEventsCount?: number;\n\tlinks?: SpanLink[];\n\tdroppedLinksCount?: number;\n\tstatus?: SpanStatus;\n}\n\nexport enum SpanKind {\n\tSPAN_KIND_UNSPECIFIED = 0,\n\tSPAN_KIND_INTERNAL = 1,\n\tSPAN_KIND_SERVER = 2,\n\tSPAN_KIND_CLIENT = 3,\n\tSPAN_KIND_PRODUCER = 4,\n\tSPAN_KIND_CONSUMER = 5,\n}\n\nexport interface SpanEvent {\n\ttimeUnixNano: string;\n\tname: string;\n\tattributes?: KeyValue[];\n\tdroppedAttributesCount?: number;\n}\n\nexport interface SpanLink {\n\ttraceId: string;\n\tspanId: string;\n\ttraceState?: string;\n\tattributes?: KeyValue[];\n\tdroppedAttributesCount?: number;\n\tflags?: number;\n}\n\nexport interface SpanStatus {\n\tmessage?: string;\n\tcode?: SpanStatusCode;\n}\n\nexport enum SpanStatusCode {\n\tSTATUS_CODE_UNSET = 0,\n\tSTATUS_CODE_OK = 1,\n\tSTATUS_CODE_ERROR = 2,\n}\n\n// ============================================\n// Log Types\n// ============================================\n\n/**\n * Root message for log export\n */\nexport interface ExportLogsServiceRequest {\n\tresourceLogs?: ResourceLogs[];\n}\n\nexport interface ResourceLogs {\n\tresource?: Resource;\n\tscopeLogs?: ScopeLogs[];\n\tschemaUrl?: string;\n}\n\nexport interface ScopeLogs {\n\tscope?: InstrumentationScope;\n\tlogRecords?: LogRecord[];\n\tschemaUrl?: string;\n}\n\nexport interface LogRecord {\n\ttimeUnixNano?: string;\n\tobservedTimeUnixNano: string;\n\tseverityNumber?: SeverityNumber;\n\tseverityText?: string;\n\tbody?: AnyValue;\n\tattributes?: KeyValue[];\n\tdroppedAttributesCount?: number;\n\tflags?: number;\n\ttraceId?: string;\n\tspanId?: string;\n}\n\nexport enum SeverityNumber {\n\tSEVERITY_NUMBER_UNSPECIFIED = 0,\n\tSEVERITY_NUMBER_TRACE = 1,\n\tSEVERITY_NUMBER_TRACE2 = 2,\n\tSEVERITY_NUMBER_TRACE3 = 3,\n\tSEVERITY_NUMBER_TRACE4 = 4,\n\tSEVERITY_NUMBER_DEBUG = 5,\n\tSEVERITY_NUMBER_DEBUG2 = 6,\n\tSEVERITY_NUMBER_DEBUG3 = 7,\n\tSEVERITY_NUMBER_DEBUG4 = 8,\n\tSEVERITY_NUMBER_INFO = 9,\n\tSEVERITY_NUMBER_INFO2 = 10,\n\tSEVERITY_NUMBER_INFO3 = 11,\n\tSEVERITY_NUMBER_INFO4 = 12,\n\tSEVERITY_NUMBER_WARN = 13,\n\tSEVERITY_NUMBER_WARN2 = 14,\n\tSEVERITY_NUMBER_WARN3 = 15,\n\tSEVERITY_NUMBER_WARN4 = 16,\n\tSEVERITY_NUMBER_ERROR = 17,\n\tSEVERITY_NUMBER_ERROR2 = 18,\n\tSEVERITY_NUMBER_ERROR3 = 19,\n\tSEVERITY_NUMBER_ERROR4 = 20,\n\tSEVERITY_NUMBER_FATAL = 21,\n\tSEVERITY_NUMBER_FATAL2 = 22,\n\tSEVERITY_NUMBER_FATAL3 = 23,\n\tSEVERITY_NUMBER_FATAL4 = 24,\n}\n\n// ============================================\n// Metrics Types\n// ============================================\n\n/**\n * Root message for metrics export\n */\nexport interface ExportMetricsServiceRequest {\n\tresourceMetrics?: ResourceMetrics[];\n}\n\nexport interface ResourceMetrics {\n\tresource?: Resource;\n\tscopeMetrics?: ScopeMetrics[];\n\tschemaUrl?: string;\n}\n\nexport interface ScopeMetrics {\n\tscope?: InstrumentationScope;\n\tmetrics?: Metric[];\n\tschemaUrl?: string;\n}\n\nexport interface Metric {\n\tname: string;\n\tdescription?: string;\n\tunit?: string;\n\tmetadata?: KeyValue[];\n\tgauge?: Gauge;\n\tsum?: Sum;\n\thistogram?: Histogram;\n\texponentialHistogram?: ExponentialHistogram;\n\tsummary?: Summary;\n}\n\nexport interface Gauge {\n\tdataPoints: NumberDataPoint[];\n}\n\nexport interface Sum {\n\tdataPoints: NumberDataPoint[];\n\taggregationTemporality: AggregationTemporality;\n\tisMonotonic?: boolean;\n}\n\nexport interface Histogram {\n\tdataPoints: HistogramDataPoint[];\n\taggregationTemporality: AggregationTemporality;\n}\n\nexport interface ExponentialHistogram {\n\tdataPoints: ExponentialHistogramDataPoint[];\n\taggregationTemporality: AggregationTemporality;\n}\n\nexport interface Summary {\n\tdataPoints: SummaryDataPoint[];\n}\n\nexport enum AggregationTemporality {\n\tAGGREGATION_TEMPORALITY_UNSPECIFIED = 0,\n\tAGGREGATION_TEMPORALITY_DELTA = 1,\n\tAGGREGATION_TEMPORALITY_CUMULATIVE = 2,\n}\n\nexport interface NumberDataPoint {\n\tattributes?: KeyValue[];\n\tstartTimeUnixNano?: string;\n\ttimeUnixNano: string;\n\tasDouble?: number;\n\tasInt?: string;\n\texemplars?: Exemplar[];\n\tflags?: number;\n}\n\nexport interface HistogramDataPoint {\n\tattributes?: KeyValue[];\n\tstartTimeUnixNano?: string;\n\ttimeUnixNano: string;\n\tcount: string;\n\tsum?: number;\n\tbucketCounts?: string[];\n\texplicitBounds?: number[];\n\texemplars?: Exemplar[];\n\tflags?: number;\n\tmin?: number;\n\tmax?: number;\n}\n\nexport interface ExponentialHistogramDataPoint {\n\tattributes?: KeyValue[];\n\tstartTimeUnixNano?: string;\n\ttimeUnixNano: string;\n\tcount: string;\n\tsum?: number;\n\tscale?: number;\n\tzeroCount?: string;\n\tpositive?: Buckets;\n\tnegative?: Buckets;\n\tflags?: number;\n\texemplars?: Exemplar[];\n\tmin?: number;\n\tmax?: number;\n\tzeroThreshold?: number;\n}\n\nexport interface Buckets {\n\toffset?: number;\n\tbucketCounts?: string[];\n}\n\nexport interface SummaryDataPoint {\n\tattributes?: KeyValue[];\n\tstartTimeUnixNano?: string;\n\ttimeUnixNano: string;\n\tcount: string;\n\tsum?: number;\n\tquantileValues?: ValueAtQuantile[];\n\tflags?: number;\n}\n\nexport interface ValueAtQuantile {\n\tquantile: number;\n\tvalue: number;\n}\n\nexport interface Exemplar {\n\tfilteredAttributes?: KeyValue[];\n\ttimeUnixNano: string;\n\tasDouble?: number;\n\tasInt?: string;\n\tspanId?: string;\n\ttraceId?: string;\n}\n\n// ============================================\n// Response Types\n// ============================================\n\nexport interface ExportTraceServiceResponse {\n\tpartialSuccess?: ExportTracePartialSuccess;\n}\n\nexport interface ExportTracePartialSuccess {\n\trejectedSpans?: string;\n\terrorMessage?: string;\n}\n\nexport interface ExportLogsServiceResponse {\n\tpartialSuccess?: ExportLogsPartialSuccess;\n}\n\nexport interface ExportLogsPartialSuccess {\n\trejectedLogRecords?: string;\n\terrorMessage?: string;\n}\n\nexport interface ExportMetricsServiceResponse {\n\tpartialSuccess?: ExportMetricsPartialSuccess;\n}\n\nexport interface ExportMetricsPartialSuccess {\n\trejectedDataPoints?: string;\n\terrorMessage?: string;\n}\n"],"mappings":";AAmGA,IAAY,gDAAL;AACN;AACA;AACA;AACA;AACA;AACA;;AACA;AAuBD,IAAY,4DAAL;AACN;AACA;AACA;;AACA;AAsCD,IAAY,4DAAL;AACN;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AACA;AA6DD,IAAY,4EAAL;AACN;AACA;AACA;;AACA"}

package/dist/types-BzQ78Efw.d.mts

@@ -0,0 +1,166 @@
+import { Context } from "hono";
+
+//#region src/adapters/types.d.ts
+
+/**
+ * Environment types for adapter configuration
+ */
+type TelescopeEnvironment = 'server' | 'lambda' | 'edge' | 'custom';
+/**
+ * Request context passed to adapters
+ */
+interface AdapterRequestContext {
+  /** Unique request ID */
+  id: string;
+  /** HTTP method */
+  method: string;
+  /** Request path */
+  path: string;
+  /** Full URL */
+  url: string;
+  /** Request headers */
+  headers: Record<string, string>;
+  /** Query parameters */
+  query: Record<string, string>;
+  /** Request body (if recorded) */
+  body?: unknown;
+  /** Client IP address */
+  ip?: string;
+  /** Request start time */
+  startTime: number;
+  /** Request body size in bytes */
+  requestSize?: number;
+}
+/**
+ * Response context passed to adapters
+ */
+interface AdapterResponseContext {
+  /** HTTP status code */
+  status: number;
+  /** Response headers */
+  headers: Record<string, string>;
+  /** Response body (if recorded) */
+  body?: unknown;
+  /** Request duration in milliseconds */
+  duration: number;
+  /** Response body size in bytes */
+  responseSize?: number;
+}
+/**
+ * Error context for exception handling
+ */
+interface AdapterErrorContext {
+  /** The error that occurred */
+  error: Error;
+  /** Associated request ID */
+  requestId?: string;
+  /** Whether the error was handled */
+  handled: boolean;
+}
+/**
+ * Span processor strategy for telemetry export
+ */
+type SpanProcessorStrategy = 'batch' | 'simple';
+/**
+ * Options for span processor configuration
+ */
+interface SpanProcessorOptions {
+  /** Processor strategy (batch for servers, simple for Lambda) */
+  strategy: SpanProcessorStrategy;
+  /** Maximum queue size for batch processor (default: 2048) */
+  maxQueueSize?: number;
+  /** Scheduled delay for batch processor in ms (default: 5000) */
+  scheduledDelayMillis?: number;
+  /** Export timeout in ms (default: 30000) */
+  exportTimeoutMillis?: number;
+  /** Maximum export batch size (default: 512) */
+  maxExportBatchSize?: number;
+}
+/**
+ * Adapter lifecycle hooks
+ */
+interface AdapterLifecycle {
+  /**
+   * Called when the adapter is initialized
+   */
+  onSetup?(): Promise<void> | void;
+  /**
+   * Called before the adapter is destroyed
+   */
+  onDestroy?(): Promise<void> | void;
+}
+/**
+ * Base adapter configuration
+ */
+interface AdapterConfig {
+  /** Environment type */
+  environment: TelescopeEnvironment;
+  /** Span processor options */
+  spanProcessor?: SpanProcessorOptions;
+  /** Whether to auto-flush on response */
+  autoFlush?: boolean;
+}
+/**
+ * Interface for environment-specific adapters.
+ * Adapters handle the integration between Telescope core and the runtime environment.
+ */
+interface TelescopeAdapter<TConfig extends AdapterConfig = AdapterConfig> extends AdapterLifecycle {
+  /** Adapter configuration */
+  readonly config: TConfig;
+  /**
+   * Extract request context from the runtime's request object.
+   * This is called at the start of request processing.
+   */
+  extractRequestContext(request: unknown): AdapterRequestContext;
+  /**
+   * Extract response context from the runtime's response object.
+   * This is called after the response is generated.
+   */
+  extractResponseContext(response: unknown, startTime: number): AdapterResponseContext;
+  /**
+   * Flush any pending telemetry data.
+   * Critical for serverless environments where the process may be frozen.
+   */
+  flush(): Promise<void>;
+}
+/**
+ * Hono-specific adapter configuration
+ */
+interface HonoAdapterConfig extends AdapterConfig {
+  environment: 'server' | 'lambda' | 'edge';
+}
+/**
+ * Lambda-specific adapter configuration
+ */
+interface LambdaAdapterConfig extends AdapterConfig {
+  environment: 'lambda';
+  /** Whether to detect Lambda resource attributes */
+  detectResource?: boolean;
+  /** Custom resource attributes */
+  resourceAttributes?: Record<string, string>;
+}
+/**
+ * Type helper for Hono context with Telescope
+ */
+interface TelescopeHonoContext {
+  /** Request ID for correlation */
+  requestId: string;
+  /** Request start time */
+  startTime: number;
+}
+/**
+ * Hono context variables type
+ */
+interface TelescopeHonoVariables {
+  telescope: TelescopeHonoContext;
+}
+/**
+ * Extended Hono context with Telescope variables
+ */
+type HonoContextWithTelescope = Context<{
+  Variables: TelescopeHonoVariables;
+}>;
+//# sourceMappingURL=types.d.ts.map
+//#endregion
+export { AdapterConfig, AdapterErrorContext, AdapterLifecycle, AdapterRequestContext, AdapterResponseContext, HonoAdapterConfig, HonoContextWithTelescope, LambdaAdapterConfig, SpanProcessorOptions, SpanProcessorStrategy, TelescopeAdapter, TelescopeEnvironment, TelescopeHonoContext, TelescopeHonoVariables };
+//# sourceMappingURL=types-BzQ78Efw.d.mts.map

package/dist/types-BzQ78Efw.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types-BzQ78Efw.d.mts","names":[],"sources":["../src/adapters/types.ts"],"sourcesContent":[],"mappings":";;;;;;AAKA;AAKiB,KALL,oBAAA,GAK0B,QAAA,GAAA,QAAA,GAAA,MAAA,GAAA,QAAA;;;;AAYxB,UAZG,qBAAA,CAYH;EAcG;EAgBA,EAAA,EAAA,MAAA;EAYL;EAKK,MAAA,EAAA,MAAA;EAgBA;EAAgB,IAAA,EAAA,MAAA;EAAA;EAIb,GAKL,EAAA,MAAA;EAAO;EAML,OAAA,EAhFP,MAgFO,CAAa,MAAA,EAAA,MAAA,CAAA;EAAA;EAAA,KAEhB,EAhFN,MAgFM,CAAA,MAAA,EAAA,MAAA,CAAA;EAAoB;EAEG,IAAA,CAAA,EAAA,OAAA;EASpB;EAAgB,EAAA,CAAA,EAAA,MAAA;EAAA;EAA8B,SAAG,EAAA,MAAA;EAAa;EAGtD,WAMiB,CAAA,EAAA,MAAA;;;;AARjB;AA6BR,UA3GA,sBAAA,CA2G0B;EAO1B;EAAoB,MAAA,EAAA,MAAA;EAAA;EAKT,OALiB,EA9GnC,MA8GmC,CAAA,MAAA,EAAA,MAAA,CAAA;EAAa;EAWzC,IAAA,CAAA,EAAA,OAAA;EAUA;EAOL,QAAA,EAAA,MAAA;EAAwB;EAAA,YACxB,CAAA,EAAA,MAAA;;AADsC;;;UA9HjC,mBAAA;;SAET;;;;;;;;;KAUI,qBAAA;;;;UAKK,oBAAA;;YAEN;;;;;;;;;;;;;UAcM,gBAAA;;;;cAIJ;;;;gBAKE;;;;;UAME,aAAA;;eAEH;;kBAEG;;;;;;;;UASA,iCAAiC,gBAAgB,uBACzD;;mBAES;;;;;2CAMwB;;;;;gEAStC;;;;;WAMM;;;;;UAMO,iBAAA,SAA0B;;;;;;UAO1B,mBAAA,SAA4B;;;;;uBAKvB;;;;;UAML,oBAAA;;;;;;;;;UAUA,sBAAA;aACL;;;;;KAMA,wBAAA,GAA2B;aAC3B"}