@geekmidas/telescope 10.0.0-alpha.99 → 10.0.0

package/dist/Telescope-BVfDvVvY.d.mts.map

@@ -1 +0,0 @@
-{"version":3,"file":"Telescope-BVfDvVvY.d.mts","names":["_$__types0.TelescopeStats"],"sources":["../src/Telescope.ts"],"mappings":";;;;;;;cA4Ba;UACJ;UACA;UACA;UACA;UACA;UACA;UACA;EAER,YACC,SAAS;IAAqB,UAAU;;;;;EAuBnC,cACL,OAAO,KAAK,oCACV;;;;UA+BW;;;;;;;;;;;EAsBR,IACL,SAAS;IACR;IACA;IACA,UAAU;IACV;OAEC;;;;EAsBG,MACL,iBACA,UAAU,yBACV,qBACE;;;;EAOG,KACL,iBACA,UAAU,yBACV,qBACE;;;;EAOG,KACL,iBACA,UAAU,yBACV,qBACE;;;;EAOG,MACL,iBACA,UAAU,yBACV,qBACE;UAIW;;;;EA4BR,UAAU,OAAO,OAAO,qBAAqB;;;;EA8B7C,YAAY,UAAU,eAAe,QAAQ;;;;EAO7C,WAAW,aAAa,QAAQ;;;;EAOhC,cAAc,UAAU,eAAe,QAAQ;;;;EAO/C,aAAa,aAAa,QAAQ;;;;EAOlC,QAAQ,UAAU,eAAe,QAAQ;;;;EAOzC,YAAQ,QAPyBA;;;;EAkBvC,WAAW,UAAU,sBAAsB;;;;EAO3C,mBAAmB,UAAU,sBAAsB;;;;EAOnD,mBACC,gBACA,cACA,UAAU,sBACR;;;;EAOH,sBAAsB,UAAU,sBAAsB;;;;EAOtD;;;;EAOA,sBAAsB;;;;;;;EAuBtB,sBAAsB;;;;EAoBtB;;;;EAcA,YAAY,IAAI;;;;EAYhB,eAAe,IAAI;;;;EAOnB,UAAU,OAAO;;;;EAkBX,MAAM,WAAW,OAAO;;;;EAO9B;;;;MAeI;;;;MAOA;;;;MAOA;;;;MAOA;;;;EAOJ,aAAa;UAqBL;UAeA;UA2CM"}

package/dist/Telescope-DeqSHfuB.d.cts.map

@@ -1 +0,0 @@
-{"version":3,"file":"Telescope-DeqSHfuB.d.cts","names":["_$__types0.TelescopeStats"],"sources":["../src/Telescope.ts"],"mappings":";;;;;;;cA4Ba;UACJ;UACA;UACA;UACA;UACA;UACA;UACA;EAER,YACC,SAAS;IAAqB,UAAU;;;;;EAuBnC,cACL,OAAO,KAAK,oCACV;;;;UA+BW;;;;;;;;;;;EAsBR,IACL,SAAS;IACR;IACA;IACA,UAAU;IACV;OAEC;;;;EAsBG,MACL,iBACA,UAAU,yBACV,qBACE;;;;EAOG,KACL,iBACA,UAAU,yBACV,qBACE;;;;EAOG,KACL,iBACA,UAAU,yBACV,qBACE;;;;EAOG,MACL,iBACA,UAAU,yBACV,qBACE;UAIW;;;;EA4BR,UAAU,OAAO,OAAO,qBAAqB;;;;EA8B7C,YAAY,UAAU,eAAe,QAAQ;;;;EAO7C,WAAW,aAAa,QAAQ;;;;EAOhC,cAAc,UAAU,eAAe,QAAQ;;;;EAO/C,aAAa,aAAa,QAAQ;;;;EAOlC,QAAQ,UAAU,eAAe,QAAQ;;;;EAOzC,YAAQ,QAPyBA;;;;EAkBvC,WAAW,UAAU,sBAAsB;;;;EAO3C,mBAAmB,UAAU,sBAAsB;;;;EAOnD,mBACC,gBACA,cACA,UAAU,sBACR;;;;EAOH,sBAAsB,UAAU,sBAAsB;;;;EAOtD;;;;EAOA,sBAAsB;;;;;;;EAuBtB,sBAAsB;;;;EAoBtB;;;;EAcA,YAAY,IAAI;;;;EAYhB,eAAe,IAAI;;;;EAOnB,UAAU,OAAO;;;;EAkBX,MAAM,WAAW,OAAO;;;;EAO9B;;;;MAeI;;;;MAOA;;;;MAOA;;;;MAOA;;;;EAOJ,aAAa;UAqBL;UAeA;UA2CM"}

package/dist/Telescope.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"Telescope.cjs","names":["createRedactor","MetricsAggregator"],"sources":["../src/Telescope.ts"],"sourcesContent":["import { nanoid } from 'nanoid';\nimport {\n\tMetricsAggregator,\n\ttype MetricsAggregatorOptions,\n} from './metrics/MetricsAggregator';\nimport { createRedactor, type Redactor } from './redact';\nimport type {\n\tEndpointDetails,\n\tEndpointMetrics,\n\tExceptionEntry,\n\tLogEntry,\n\tMetricsQueryOptions,\n\tMetricsSnapshot,\n\tNormalizedTelescopeOptions,\n\tQueryOptions,\n\tRequestEntry,\n\tRequestMetrics,\n\tStackFrame,\n\tStatusDistribution,\n\tTelescopeEvent,\n\tTelescopeOptions,\n\tTelescopeStorage,\n} from './types';\n\n/**\n * Framework-agnostic Telescope class for debugging and monitoring applications.\n * Use framework-specific adapters (e.g., @geekmidas/telescope/hono) for integration.\n */\nexport class Telescope {\n\tprivate storage: TelescopeStorage;\n\tprivate options: NormalizedTelescopeOptions;\n\tprivate wsClients = new Set<WebSocket>();\n\tprivate pruneInterval?: ReturnType<typeof setInterval>;\n\tprivate metricsBroadcastInterval?: ReturnType<typeof setInterval>;\n\tprivate redactor?: Redactor;\n\tprivate metricsAggregator: MetricsAggregator;\n\n\tconstructor(\n\t\toptions: TelescopeOptions & { metrics?: MetricsAggregatorOptions },\n\t) {\n\t\tthis.storage = options.storage;\n\t\tthis.options = this.normalizeOptions(options);\n\t\tthis.redactor = createRedactor(options.redact);\n\t\tthis.metricsAggregator = new MetricsAggregator(options.metrics);\n\n\t\t// Set up auto-pruning if configured\n\t\tif (this.options.pruneAfterHours) {\n\t\t\tconst intervalMs = 60 * 60 * 1000; // 1 hour\n\t\t\tthis.pruneInterval = setInterval(() => {\n\t\t\t\tthis.autoPrune().catch(console.error);\n\t\t\t}, intervalMs);\n\t\t}\n\t}\n\n\t// ============================================\n\t// Public API - Recording\n\t// ============================================\n\n\t/**\n\t * Record a request entry\n\t */\n\tasync recordRequest(\n\t\tentry: Omit<RequestEntry, 'id' | 'timestamp'>,\n\t): Promise<string> {\n\t\tif (!this.options.enabled) return '';\n\n\t\t// Use injected request ID from context if available, otherwise generate one\n\t\tconst id = this.options.getRequestId?.() ?? nanoid();\n\t\tlet fullEntry: RequestEntry = {\n\t\t\t...entry,\n\t\t\tid,\n\t\t\ttimestamp: new Date(),\n\t\t};\n\n\t\t// Apply redaction if configured\n\t\tif (this.redactor) {\n\t\t\tfullEntry = this.redactor(fullEntry);\n\t\t}\n\n\t\t// Record metrics (before storage for real-time aggregation)\n\t\tthis.metricsAggregator.record(fullEntry);\n\n\t\tawait this.storage.saveRequest(fullEntry);\n\t\tthis.broadcast({\n\t\t\ttype: 'request',\n\t\t\tpayload: fullEntry,\n\t\t\ttimestamp: Date.now(),\n\t\t});\n\t\treturn id;\n\t}\n\n\t/**\n\t * Log entry input for batch operations\n\t */\n\tprivate async saveLogEntries(entries: LogEntry[]): Promise<void> {\n\t\tif (this.storage.saveLogs) {\n\t\t\tawait this.storage.saveLogs(entries);\n\t\t} else {\n\t\t\tawait Promise.all(entries.map((entry) => this.storage.saveLog(entry)));\n\t\t}\n\n\t\tfor (const entry of entries) {\n\t\t\tthis.broadcast({ type: 'log', payload: entry, timestamp: Date.now() });\n\t\t}\n\t}\n\n\t/**\n\t * Record log entries in batch.\n\t * More efficient than individual calls for database storage.\n\t *\n\t * @example\n\t * await telescope.log([\n\t *   { level: 'info', message: 'Request started' },\n\t *   { level: 'debug', message: 'Processing...', context: { step: 1 } },\n\t * ]);\n\t */\n\tasync log(\n\t\tentries: Array<{\n\t\t\tlevel: 'debug' | 'info' | 'warn' | 'error';\n\t\t\tmessage: string;\n\t\t\tcontext?: Record<string, unknown>;\n\t\t\trequestId?: string;\n\t\t}>,\n\t): Promise<void> {\n\t\tif (!this.options.enabled || entries.length === 0) return;\n\n\t\tconst timestamp = new Date();\n\t\tconst logEntries: LogEntry[] = entries.map((e) => {\n\t\t\tconst entry: LogEntry = {\n\t\t\t\tid: nanoid(),\n\t\t\t\tlevel: e.level,\n\t\t\t\tmessage: e.message,\n\t\t\t\tcontext: e.context,\n\t\t\t\trequestId: e.requestId,\n\t\t\t\ttimestamp,\n\t\t\t};\n\t\t\treturn this.redactor ? this.redactor(entry) : entry;\n\t\t});\n\n\t\tawait this.saveLogEntries(logEntries);\n\t}\n\n\t/**\n\t * Log a debug message\n\t */\n\tasync debug(\n\t\tmessage: string,\n\t\tcontext?: Record<string, unknown>,\n\t\trequestId?: string,\n\t): Promise<void> {\n\t\treturn this.logSingle('debug', message, context, requestId);\n\t}\n\n\t/**\n\t * Log an info message\n\t */\n\tasync info(\n\t\tmessage: string,\n\t\tcontext?: Record<string, unknown>,\n\t\trequestId?: string,\n\t): Promise<void> {\n\t\treturn this.logSingle('info', message, context, requestId);\n\t}\n\n\t/**\n\t * Log a warning message\n\t */\n\tasync warn(\n\t\tmessage: string,\n\t\tcontext?: Record<string, unknown>,\n\t\trequestId?: string,\n\t): Promise<void> {\n\t\treturn this.logSingle('warn', message, context, requestId);\n\t}\n\n\t/**\n\t * Log an error message\n\t */\n\tasync error(\n\t\tmessage: string,\n\t\tcontext?: Record<string, unknown>,\n\t\trequestId?: string,\n\t): Promise<void> {\n\t\treturn this.logSingle('error', message, context, requestId);\n\t}\n\n\tprivate async logSingle(\n\t\tlevel: LogEntry['level'],\n\t\tmessage: string,\n\t\tcontext?: Record<string, unknown>,\n\t\trequestId?: string,\n\t): Promise<void> {\n\t\tif (!this.options.enabled) return;\n\n\t\tlet entry: LogEntry = {\n\t\t\tid: nanoid(),\n\t\t\tlevel,\n\t\t\tmessage,\n\t\t\tcontext,\n\t\t\trequestId,\n\t\t\ttimestamp: new Date(),\n\t\t};\n\n\t\tif (this.redactor) {\n\t\t\tentry = this.redactor(entry);\n\t\t}\n\n\t\tawait this.storage.saveLog(entry);\n\t\tthis.broadcast({ type: 'log', payload: entry, timestamp: Date.now() });\n\t}\n\n\t/**\n\t * Record an exception\n\t */\n\tasync exception(error: Error, requestId?: string): Promise<void> {\n\t\tif (!this.options.enabled) return;\n\n\t\tconst stack = this.parseStack(error.stack || '');\n\n\t\tconst entry: ExceptionEntry = {\n\t\t\tid: nanoid(),\n\t\t\tname: error.name,\n\t\t\tmessage: error.message,\n\t\t\tstack,\n\t\t\trequestId,\n\t\t\ttimestamp: new Date(),\n\t\t\thandled: false,\n\t\t};\n\n\t\tawait this.storage.saveException(entry);\n\t\tthis.broadcast({\n\t\t\ttype: 'exception',\n\t\t\tpayload: entry,\n\t\t\ttimestamp: Date.now(),\n\t\t});\n\t}\n\n\t// ============================================\n\t// Public API - Data Access\n\t// ============================================\n\n\t/**\n\t * Get requests from storage\n\t */\n\tasync getRequests(options?: QueryOptions): Promise<RequestEntry[]> {\n\t\treturn this.storage.getRequests(options);\n\t}\n\n\t/**\n\t * Get a single request by ID\n\t */\n\tasync getRequest(id: string): Promise<RequestEntry | null> {\n\t\treturn this.storage.getRequest(id);\n\t}\n\n\t/**\n\t * Get exceptions from storage\n\t */\n\tasync getExceptions(options?: QueryOptions): Promise<ExceptionEntry[]> {\n\t\treturn this.storage.getExceptions(options);\n\t}\n\n\t/**\n\t * Get a single exception by ID\n\t */\n\tasync getException(id: string): Promise<ExceptionEntry | null> {\n\t\treturn this.storage.getException(id);\n\t}\n\n\t/**\n\t * Get logs from storage\n\t */\n\tasync getLogs(options?: QueryOptions): Promise<LogEntry[]> {\n\t\treturn this.storage.getLogs(options);\n\t}\n\n\t/**\n\t * Get storage statistics\n\t */\n\tasync getStats() {\n\t\treturn this.storage.getStats();\n\t}\n\n\t// ============================================\n\t// Public API - Metrics\n\t// ============================================\n\n\t/**\n\t * Get aggregated request metrics\n\t */\n\tgetMetrics(options?: MetricsQueryOptions): RequestMetrics {\n\t\treturn this.metricsAggregator.getMetrics(options);\n\t}\n\n\t/**\n\t * Get metrics for individual endpoints\n\t */\n\tgetEndpointMetrics(options?: MetricsQueryOptions): EndpointMetrics[] {\n\t\treturn this.metricsAggregator.getEndpointMetrics(options);\n\t}\n\n\t/**\n\t * Get detailed metrics for a specific endpoint\n\t */\n\tgetEndpointDetails(\n\t\tmethod: string,\n\t\tpath: string,\n\t\toptions?: MetricsQueryOptions,\n\t): EndpointDetails | null {\n\t\treturn this.metricsAggregator.getEndpointDetails(method, path, options);\n\t}\n\n\t/**\n\t * Get status code distribution\n\t */\n\tgetStatusDistribution(options?: MetricsQueryOptions): StatusDistribution {\n\t\treturn this.metricsAggregator.getStatusDistribution(options);\n\t}\n\n\t/**\n\t * Reset metrics data\n\t */\n\tresetMetrics(): void {\n\t\tthis.metricsAggregator.reset();\n\t}\n\n\t/**\n\t * Get a real-time metrics snapshot for broadcasting\n\t */\n\tgetMetricsSnapshot(): MetricsSnapshot {\n\t\tconst metrics = this.metricsAggregator.getMetrics();\n\t\tconst statusDist = this.metricsAggregator.getStatusDistribution();\n\n\t\treturn {\n\t\t\ttimestamp: Date.now(),\n\t\t\ttotalRequests: metrics.totalRequests,\n\t\t\trequestsPerSecond: metrics.requestsPerSecond,\n\t\t\tavgDuration: metrics.avgDuration,\n\t\t\terrorRate: metrics.errorRate,\n\t\t\tp50: metrics.p50Duration,\n\t\t\tp95: metrics.p95Duration,\n\t\t\tp99: metrics.p99Duration,\n\t\t\tstatusDistribution: statusDist,\n\t\t};\n\t}\n\n\t/**\n\t * Start broadcasting metrics to WebSocket clients at a given interval.\n\t * Call this after setting up WebSocket to enable real-time metrics updates.\n\t *\n\t * @param intervalMs - Broadcast interval in milliseconds (default: 5000)\n\t */\n\tstartMetricsBroadcast(intervalMs = 5000): void {\n\t\tif (this.metricsBroadcastInterval) {\n\t\t\treturn; // Already running\n\t\t}\n\n\t\tthis.metricsBroadcastInterval = setInterval(() => {\n\t\t\tif (this.wsClients.size > 0) {\n\t\t\t\tconst snapshot = this.getMetricsSnapshot();\n\t\t\t\tthis.broadcast({\n\t\t\t\t\ttype: 'metrics',\n\t\t\t\t\tpayload: snapshot,\n\t\t\t\t\ttimestamp: Date.now(),\n\t\t\t\t});\n\t\t\t}\n\t\t}, intervalMs);\n\t}\n\n\t/**\n\t * Stop broadcasting metrics to WebSocket clients\n\t */\n\tstopMetricsBroadcast(): void {\n\t\tif (this.metricsBroadcastInterval) {\n\t\t\tclearInterval(this.metricsBroadcastInterval);\n\t\t\tthis.metricsBroadcastInterval = undefined;\n\t\t}\n\t}\n\n\t// ============================================\n\t// Public API - WebSocket\n\t// ============================================\n\n\t/**\n\t * Add a WebSocket client for real-time updates\n\t */\n\taddWsClient(ws: WebSocket): void {\n\t\tthis.wsClients.add(ws);\n\t\tthis.broadcast({\n\t\t\ttype: 'connected',\n\t\t\tpayload: { clientCount: this.wsClients.size },\n\t\t\ttimestamp: Date.now(),\n\t\t});\n\t}\n\n\t/**\n\t * Remove a WebSocket client\n\t */\n\tremoveWsClient(ws: WebSocket): void {\n\t\tthis.wsClients.delete(ws);\n\t}\n\n\t/**\n\t * Broadcast an event to all connected WebSocket clients\n\t */\n\tbroadcast(event: TelescopeEvent): void {\n\t\tconst data = JSON.stringify(event);\n\t\tfor (const client of this.wsClients) {\n\t\t\ttry {\n\t\t\t\tclient.send(data);\n\t\t\t} catch {\n\t\t\t\tthis.wsClients.delete(client);\n\t\t\t}\n\t\t}\n\t}\n\n\t// ============================================\n\t// Public API - Lifecycle\n\t// ============================================\n\n\t/**\n\t * Manually prune old entries\n\t */\n\tasync prune(olderThan: Date): Promise<number> {\n\t\treturn this.storage.prune(olderThan);\n\t}\n\n\t/**\n\t * Clean up resources\n\t */\n\tdestroy(): void {\n\t\tif (this.pruneInterval) {\n\t\t\tclearInterval(this.pruneInterval);\n\t\t}\n\t\tthis.stopMetricsBroadcast();\n\t\tthis.wsClients.clear();\n\t}\n\n\t// ============================================\n\t// Public API - Configuration\n\t// ============================================\n\n\t/**\n\t * Get the telescope path\n\t */\n\tget path(): string {\n\t\treturn this.options.path;\n\t}\n\n\t/**\n\t * Check if telescope is enabled\n\t */\n\tget enabled(): boolean {\n\t\treturn this.options.enabled;\n\t}\n\n\t/**\n\t * Check if body recording is enabled\n\t */\n\tget recordBody(): boolean {\n\t\treturn this.options.recordBody;\n\t}\n\n\t/**\n\t * Get max body size\n\t */\n\tget maxBodySize(): number {\n\t\treturn this.options.maxBodySize;\n\t}\n\n\t/**\n\t * Check if a path should be ignored\n\t */\n\tshouldIgnore(path: string): boolean {\n\t\t// Always ignore telescope's own routes\n\t\tif (path.startsWith(this.options.path)) {\n\t\t\treturn true;\n\t\t}\n\n\t\treturn this.options.ignorePatterns.some((pattern) => {\n\t\t\tif (pattern.includes('*')) {\n\t\t\t\tconst regex = new RegExp(\n\t\t\t\t\t`^${pattern.replace(/\\*/g, '.*').replace(/\\?/g, '.')}$`,\n\t\t\t\t);\n\t\t\t\treturn regex.test(path);\n\t\t\t}\n\t\t\treturn path.startsWith(pattern);\n\t\t});\n\t}\n\n\t// ============================================\n\t// Private Methods\n\t// ============================================\n\n\tprivate normalizeOptions(\n\t\toptions: TelescopeOptions,\n\t): NormalizedTelescopeOptions {\n\t\treturn {\n\t\t\tstorage: options.storage,\n\t\t\tenabled: options.enabled ?? true,\n\t\t\tpath: options.path ?? '/__telescope',\n\t\t\trecordBody: options.recordBody ?? true,\n\t\t\tmaxBodySize: options.maxBodySize ?? 64 * 1024, // 64KB\n\t\t\tignorePatterns: options.ignorePatterns ?? [],\n\t\t\tpruneAfterHours: options.pruneAfterHours,\n\t\t\tgetRequestId: options.getRequestId,\n\t\t};\n\t}\n\n\tprivate parseStack(stack: string): StackFrame[] {\n\t\tconst lines = stack.split('\\n').slice(1);\n\t\tconst frames: StackFrame[] = [];\n\n\t\tfor (const line of lines) {\n\t\t\t// Match: \"    at functionName (file:line:column)\"\n\t\t\t// or: \"    at file:line:column\"\n\t\t\tconst match =\n\t\t\t\tline.match(/at\\s+(.+?)\\s+\\((.+):(\\d+):(\\d+)\\)/) ||\n\t\t\t\tline.match(/at\\s+(.+):(\\d+):(\\d+)/);\n\n\t\t\tif (match) {\n\t\t\t\tif (\n\t\t\t\t\tmatch.length === 5 &&\n\t\t\t\t\tmatch[1] &&\n\t\t\t\t\tmatch[2] &&\n\t\t\t\t\tmatch[3] &&\n\t\t\t\t\tmatch[4]\n\t\t\t\t) {\n\t\t\t\t\t// Has function name\n\t\t\t\t\tframes.push({\n\t\t\t\t\t\tfunction: match[1],\n\t\t\t\t\t\tfile: match[2],\n\t\t\t\t\t\tline: parseInt(match[3], 10),\n\t\t\t\t\t\tcolumn: parseInt(match[4], 10),\n\t\t\t\t\t\tisApp: !match[2].includes('node_modules'),\n\t\t\t\t\t});\n\t\t\t\t} else if (match.length === 4 && match[1] && match[2] && match[3]) {\n\t\t\t\t\t// No function name\n\t\t\t\t\tframes.push({\n\t\t\t\t\t\tfunction: '<anonymous>',\n\t\t\t\t\t\tfile: match[1],\n\t\t\t\t\t\tline: parseInt(match[2], 10),\n\t\t\t\t\t\tcolumn: parseInt(match[3], 10),\n\t\t\t\t\t\tisApp: !match[1].includes('node_modules'),\n\t\t\t\t\t});\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\n\t\treturn frames;\n\t}\n\n\tprivate async autoPrune(): Promise<void> {\n\t\tif (!this.options.pruneAfterHours) return;\n\n\t\tconst olderThan = new Date(\n\t\t\tDate.now() - this.options.pruneAfterHours * 60 * 60 * 1000,\n\t\t);\n\t\tawait this.storage.prune(olderThan);\n\t}\n}\n"],"mappings":"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"}

package/dist/Telescope.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"Telescope.mjs","names":[],"sources":["../src/Telescope.ts"],"sourcesContent":["import { nanoid } from 'nanoid';\nimport {\n\tMetricsAggregator,\n\ttype MetricsAggregatorOptions,\n} from './metrics/MetricsAggregator';\nimport { createRedactor, type Redactor } from './redact';\nimport type {\n\tEndpointDetails,\n\tEndpointMetrics,\n\tExceptionEntry,\n\tLogEntry,\n\tMetricsQueryOptions,\n\tMetricsSnapshot,\n\tNormalizedTelescopeOptions,\n\tQueryOptions,\n\tRequestEntry,\n\tRequestMetrics,\n\tStackFrame,\n\tStatusDistribution,\n\tTelescopeEvent,\n\tTelescopeOptions,\n\tTelescopeStorage,\n} from './types';\n\n/**\n * Framework-agnostic Telescope class for debugging and monitoring applications.\n * Use framework-specific adapters (e.g., @geekmidas/telescope/hono) for integration.\n */\nexport class Telescope {\n\tprivate storage: TelescopeStorage;\n\tprivate options: NormalizedTelescopeOptions;\n\tprivate wsClients = new Set<WebSocket>();\n\tprivate pruneInterval?: ReturnType<typeof setInterval>;\n\tprivate metricsBroadcastInterval?: ReturnType<typeof setInterval>;\n\tprivate redactor?: Redactor;\n\tprivate metricsAggregator: MetricsAggregator;\n\n\tconstructor(\n\t\toptions: TelescopeOptions & { metrics?: MetricsAggregatorOptions },\n\t) {\n\t\tthis.storage = options.storage;\n\t\tthis.options = this.normalizeOptions(options);\n\t\tthis.redactor = createRedactor(options.redact);\n\t\tthis.metricsAggregator = new MetricsAggregator(options.metrics);\n\n\t\t// Set up auto-pruning if configured\n\t\tif (this.options.pruneAfterHours) {\n\t\t\tconst intervalMs = 60 * 60 * 1000; // 1 hour\n\t\t\tthis.pruneInterval = setInterval(() => {\n\t\t\t\tthis.autoPrune().catch(console.error);\n\t\t\t}, intervalMs);\n\t\t}\n\t}\n\n\t// ============================================\n\t// Public API - Recording\n\t// ============================================\n\n\t/**\n\t * Record a request entry\n\t */\n\tasync recordRequest(\n\t\tentry: Omit<RequestEntry, 'id' | 'timestamp'>,\n\t): Promise<string> {\n\t\tif (!this.options.enabled) return '';\n\n\t\t// Use injected request ID from context if available, otherwise generate one\n\t\tconst id = this.options.getRequestId?.() ?? nanoid();\n\t\tlet fullEntry: RequestEntry = {\n\t\t\t...entry,\n\t\t\tid,\n\t\t\ttimestamp: new Date(),\n\t\t};\n\n\t\t// Apply redaction if configured\n\t\tif (this.redactor) {\n\t\t\tfullEntry = this.redactor(fullEntry);\n\t\t}\n\n\t\t// Record metrics (before storage for real-time aggregation)\n\t\tthis.metricsAggregator.record(fullEntry);\n\n\t\tawait this.storage.saveRequest(fullEntry);\n\t\tthis.broadcast({\n\t\t\ttype: 'request',\n\t\t\tpayload: fullEntry,\n\t\t\ttimestamp: Date.now(),\n\t\t});\n\t\treturn id;\n\t}\n\n\t/**\n\t * Log entry input for batch operations\n\t */\n\tprivate async saveLogEntries(entries: LogEntry[]): Promise<void> {\n\t\tif (this.storage.saveLogs) {\n\t\t\tawait this.storage.saveLogs(entries);\n\t\t} else {\n\t\t\tawait Promise.all(entries.map((entry) => this.storage.saveLog(entry)));\n\t\t}\n\n\t\tfor (const entry of entries) {\n\t\t\tthis.broadcast({ type: 'log', payload: entry, timestamp: Date.now() });\n\t\t}\n\t}\n\n\t/**\n\t * Record log entries in batch.\n\t * More efficient than individual calls for database storage.\n\t *\n\t * @example\n\t * await telescope.log([\n\t *   { level: 'info', message: 'Request started' },\n\t *   { level: 'debug', message: 'Processing...', context: { step: 1 } },\n\t * ]);\n\t */\n\tasync log(\n\t\tentries: Array<{\n\t\t\tlevel: 'debug' | 'info' | 'warn' | 'error';\n\t\t\tmessage: string;\n\t\t\tcontext?: Record<string, unknown>;\n\t\t\trequestId?: string;\n\t\t}>,\n\t): Promise<void> {\n\t\tif (!this.options.enabled || entries.length === 0) return;\n\n\t\tconst timestamp = new Date();\n\t\tconst logEntries: LogEntry[] = entries.map((e) => {\n\t\t\tconst entry: LogEntry = {\n\t\t\t\tid: nanoid(),\n\t\t\t\tlevel: e.level,\n\t\t\t\tmessage: e.message,\n\t\t\t\tcontext: e.context,\n\t\t\t\trequestId: e.requestId,\n\t\t\t\ttimestamp,\n\t\t\t};\n\t\t\treturn this.redactor ? this.redactor(entry) : entry;\n\t\t});\n\n\t\tawait this.saveLogEntries(logEntries);\n\t}\n\n\t/**\n\t * Log a debug message\n\t */\n\tasync debug(\n\t\tmessage: string,\n\t\tcontext?: Record<string, unknown>,\n\t\trequestId?: string,\n\t): Promise<void> {\n\t\treturn this.logSingle('debug', message, context, requestId);\n\t}\n\n\t/**\n\t * Log an info message\n\t */\n\tasync info(\n\t\tmessage: string,\n\t\tcontext?: Record<string, unknown>,\n\t\trequestId?: string,\n\t): Promise<void> {\n\t\treturn this.logSingle('info', message, context, requestId);\n\t}\n\n\t/**\n\t * Log a warning message\n\t */\n\tasync warn(\n\t\tmessage: string,\n\t\tcontext?: Record<string, unknown>,\n\t\trequestId?: string,\n\t): Promise<void> {\n\t\treturn this.logSingle('warn', message, context, requestId);\n\t}\n\n\t/**\n\t * Log an error message\n\t */\n\tasync error(\n\t\tmessage: string,\n\t\tcontext?: Record<string, unknown>,\n\t\trequestId?: string,\n\t): Promise<void> {\n\t\treturn this.logSingle('error', message, context, requestId);\n\t}\n\n\tprivate async logSingle(\n\t\tlevel: LogEntry['level'],\n\t\tmessage: string,\n\t\tcontext?: Record<string, unknown>,\n\t\trequestId?: string,\n\t): Promise<void> {\n\t\tif (!this.options.enabled) return;\n\n\t\tlet entry: LogEntry = {\n\t\t\tid: nanoid(),\n\t\t\tlevel,\n\t\t\tmessage,\n\t\t\tcontext,\n\t\t\trequestId,\n\t\t\ttimestamp: new Date(),\n\t\t};\n\n\t\tif (this.redactor) {\n\t\t\tentry = this.redactor(entry);\n\t\t}\n\n\t\tawait this.storage.saveLog(entry);\n\t\tthis.broadcast({ type: 'log', payload: entry, timestamp: Date.now() });\n\t}\n\n\t/**\n\t * Record an exception\n\t */\n\tasync exception(error: Error, requestId?: string): Promise<void> {\n\t\tif (!this.options.enabled) return;\n\n\t\tconst stack = this.parseStack(error.stack || '');\n\n\t\tconst entry: ExceptionEntry = {\n\t\t\tid: nanoid(),\n\t\t\tname: error.name,\n\t\t\tmessage: error.message,\n\t\t\tstack,\n\t\t\trequestId,\n\t\t\ttimestamp: new Date(),\n\t\t\thandled: false,\n\t\t};\n\n\t\tawait this.storage.saveException(entry);\n\t\tthis.broadcast({\n\t\t\ttype: 'exception',\n\t\t\tpayload: entry,\n\t\t\ttimestamp: Date.now(),\n\t\t});\n\t}\n\n\t// ============================================\n\t// Public API - Data Access\n\t// ============================================\n\n\t/**\n\t * Get requests from storage\n\t */\n\tasync getRequests(options?: QueryOptions): Promise<RequestEntry[]> {\n\t\treturn this.storage.getRequests(options);\n\t}\n\n\t/**\n\t * Get a single request by ID\n\t */\n\tasync getRequest(id: string): Promise<RequestEntry | null> {\n\t\treturn this.storage.getRequest(id);\n\t}\n\n\t/**\n\t * Get exceptions from storage\n\t */\n\tasync getExceptions(options?: QueryOptions): Promise<ExceptionEntry[]> {\n\t\treturn this.storage.getExceptions(options);\n\t}\n\n\t/**\n\t * Get a single exception by ID\n\t */\n\tasync getException(id: string): Promise<ExceptionEntry | null> {\n\t\treturn this.storage.getException(id);\n\t}\n\n\t/**\n\t * Get logs from storage\n\t */\n\tasync getLogs(options?: QueryOptions): Promise<LogEntry[]> {\n\t\treturn this.storage.getLogs(options);\n\t}\n\n\t/**\n\t * Get storage statistics\n\t */\n\tasync getStats() {\n\t\treturn this.storage.getStats();\n\t}\n\n\t// ============================================\n\t// Public API - Metrics\n\t// ============================================\n\n\t/**\n\t * Get aggregated request metrics\n\t */\n\tgetMetrics(options?: MetricsQueryOptions): RequestMetrics {\n\t\treturn this.metricsAggregator.getMetrics(options);\n\t}\n\n\t/**\n\t * Get metrics for individual endpoints\n\t */\n\tgetEndpointMetrics(options?: MetricsQueryOptions): EndpointMetrics[] {\n\t\treturn this.metricsAggregator.getEndpointMetrics(options);\n\t}\n\n\t/**\n\t * Get detailed metrics for a specific endpoint\n\t */\n\tgetEndpointDetails(\n\t\tmethod: string,\n\t\tpath: string,\n\t\toptions?: MetricsQueryOptions,\n\t): EndpointDetails | null {\n\t\treturn this.metricsAggregator.getEndpointDetails(method, path, options);\n\t}\n\n\t/**\n\t * Get status code distribution\n\t */\n\tgetStatusDistribution(options?: MetricsQueryOptions): StatusDistribution {\n\t\treturn this.metricsAggregator.getStatusDistribution(options);\n\t}\n\n\t/**\n\t * Reset metrics data\n\t */\n\tresetMetrics(): void {\n\t\tthis.metricsAggregator.reset();\n\t}\n\n\t/**\n\t * Get a real-time metrics snapshot for broadcasting\n\t */\n\tgetMetricsSnapshot(): MetricsSnapshot {\n\t\tconst metrics = this.metricsAggregator.getMetrics();\n\t\tconst statusDist = this.metricsAggregator.getStatusDistribution();\n\n\t\treturn {\n\t\t\ttimestamp: Date.now(),\n\t\t\ttotalRequests: metrics.totalRequests,\n\t\t\trequestsPerSecond: metrics.requestsPerSecond,\n\t\t\tavgDuration: metrics.avgDuration,\n\t\t\terrorRate: metrics.errorRate,\n\t\t\tp50: metrics.p50Duration,\n\t\t\tp95: metrics.p95Duration,\n\t\t\tp99: metrics.p99Duration,\n\t\t\tstatusDistribution: statusDist,\n\t\t};\n\t}\n\n\t/**\n\t * Start broadcasting metrics to WebSocket clients at a given interval.\n\t * Call this after setting up WebSocket to enable real-time metrics updates.\n\t *\n\t * @param intervalMs - Broadcast interval in milliseconds (default: 5000)\n\t */\n\tstartMetricsBroadcast(intervalMs = 5000): void {\n\t\tif (this.metricsBroadcastInterval) {\n\t\t\treturn; // Already running\n\t\t}\n\n\t\tthis.metricsBroadcastInterval = setInterval(() => {\n\t\t\tif (this.wsClients.size > 0) {\n\t\t\t\tconst snapshot = this.getMetricsSnapshot();\n\t\t\t\tthis.broadcast({\n\t\t\t\t\ttype: 'metrics',\n\t\t\t\t\tpayload: snapshot,\n\t\t\t\t\ttimestamp: Date.now(),\n\t\t\t\t});\n\t\t\t}\n\t\t}, intervalMs);\n\t}\n\n\t/**\n\t * Stop broadcasting metrics to WebSocket clients\n\t */\n\tstopMetricsBroadcast(): void {\n\t\tif (this.metricsBroadcastInterval) {\n\t\t\tclearInterval(this.metricsBroadcastInterval);\n\t\t\tthis.metricsBroadcastInterval = undefined;\n\t\t}\n\t}\n\n\t// ============================================\n\t// Public API - WebSocket\n\t// ============================================\n\n\t/**\n\t * Add a WebSocket client for real-time updates\n\t */\n\taddWsClient(ws: WebSocket): void {\n\t\tthis.wsClients.add(ws);\n\t\tthis.broadcast({\n\t\t\ttype: 'connected',\n\t\t\tpayload: { clientCount: this.wsClients.size },\n\t\t\ttimestamp: Date.now(),\n\t\t});\n\t}\n\n\t/**\n\t * Remove a WebSocket client\n\t */\n\tremoveWsClient(ws: WebSocket): void {\n\t\tthis.wsClients.delete(ws);\n\t}\n\n\t/**\n\t * Broadcast an event to all connected WebSocket clients\n\t */\n\tbroadcast(event: TelescopeEvent): void {\n\t\tconst data = JSON.stringify(event);\n\t\tfor (const client of this.wsClients) {\n\t\t\ttry {\n\t\t\t\tclient.send(data);\n\t\t\t} catch {\n\t\t\t\tthis.wsClients.delete(client);\n\t\t\t}\n\t\t}\n\t}\n\n\t// ============================================\n\t// Public API - Lifecycle\n\t// ============================================\n\n\t/**\n\t * Manually prune old entries\n\t */\n\tasync prune(olderThan: Date): Promise<number> {\n\t\treturn this.storage.prune(olderThan);\n\t}\n\n\t/**\n\t * Clean up resources\n\t */\n\tdestroy(): void {\n\t\tif (this.pruneInterval) {\n\t\t\tclearInterval(this.pruneInterval);\n\t\t}\n\t\tthis.stopMetricsBroadcast();\n\t\tthis.wsClients.clear();\n\t}\n\n\t// ============================================\n\t// Public API - Configuration\n\t// ============================================\n\n\t/**\n\t * Get the telescope path\n\t */\n\tget path(): string {\n\t\treturn this.options.path;\n\t}\n\n\t/**\n\t * Check if telescope is enabled\n\t */\n\tget enabled(): boolean {\n\t\treturn this.options.enabled;\n\t}\n\n\t/**\n\t * Check if body recording is enabled\n\t */\n\tget recordBody(): boolean {\n\t\treturn this.options.recordBody;\n\t}\n\n\t/**\n\t * Get max body size\n\t */\n\tget maxBodySize(): number {\n\t\treturn this.options.maxBodySize;\n\t}\n\n\t/**\n\t * Check if a path should be ignored\n\t */\n\tshouldIgnore(path: string): boolean {\n\t\t// Always ignore telescope's own routes\n\t\tif (path.startsWith(this.options.path)) {\n\t\t\treturn true;\n\t\t}\n\n\t\treturn this.options.ignorePatterns.some((pattern) => {\n\t\t\tif (pattern.includes('*')) {\n\t\t\t\tconst regex = new RegExp(\n\t\t\t\t\t`^${pattern.replace(/\\*/g, '.*').replace(/\\?/g, '.')}$`,\n\t\t\t\t);\n\t\t\t\treturn regex.test(path);\n\t\t\t}\n\t\t\treturn path.startsWith(pattern);\n\t\t});\n\t}\n\n\t// ============================================\n\t// Private Methods\n\t// ============================================\n\n\tprivate normalizeOptions(\n\t\toptions: TelescopeOptions,\n\t): NormalizedTelescopeOptions {\n\t\treturn {\n\t\t\tstorage: options.storage,\n\t\t\tenabled: options.enabled ?? true,\n\t\t\tpath: options.path ?? '/__telescope',\n\t\t\trecordBody: options.recordBody ?? true,\n\t\t\tmaxBodySize: options.maxBodySize ?? 64 * 1024, // 64KB\n\t\t\tignorePatterns: options.ignorePatterns ?? [],\n\t\t\tpruneAfterHours: options.pruneAfterHours,\n\t\t\tgetRequestId: options.getRequestId,\n\t\t};\n\t}\n\n\tprivate parseStack(stack: string): StackFrame[] {\n\t\tconst lines = stack.split('\\n').slice(1);\n\t\tconst frames: StackFrame[] = [];\n\n\t\tfor (const line of lines) {\n\t\t\t// Match: \"    at functionName (file:line:column)\"\n\t\t\t// or: \"    at file:line:column\"\n\t\t\tconst match =\n\t\t\t\tline.match(/at\\s+(.+?)\\s+\\((.+):(\\d+):(\\d+)\\)/) ||\n\t\t\t\tline.match(/at\\s+(.+):(\\d+):(\\d+)/);\n\n\t\t\tif (match) {\n\t\t\t\tif (\n\t\t\t\t\tmatch.length === 5 &&\n\t\t\t\t\tmatch[1] &&\n\t\t\t\t\tmatch[2] &&\n\t\t\t\t\tmatch[3] &&\n\t\t\t\t\tmatch[4]\n\t\t\t\t) {\n\t\t\t\t\t// Has function name\n\t\t\t\t\tframes.push({\n\t\t\t\t\t\tfunction: match[1],\n\t\t\t\t\t\tfile: match[2],\n\t\t\t\t\t\tline: parseInt(match[3], 10),\n\t\t\t\t\t\tcolumn: parseInt(match[4], 10),\n\t\t\t\t\t\tisApp: !match[2].includes('node_modules'),\n\t\t\t\t\t});\n\t\t\t\t} else if (match.length === 4 && match[1] && match[2] && match[3]) {\n\t\t\t\t\t// No function name\n\t\t\t\t\tframes.push({\n\t\t\t\t\t\tfunction: '<anonymous>',\n\t\t\t\t\t\tfile: match[1],\n\t\t\t\t\t\tline: parseInt(match[2], 10),\n\t\t\t\t\t\tcolumn: parseInt(match[3], 10),\n\t\t\t\t\t\tisApp: !match[1].includes('node_modules'),\n\t\t\t\t\t});\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\n\t\treturn frames;\n\t}\n\n\tprivate async autoPrune(): Promise<void> {\n\t\tif (!this.options.pruneAfterHours) return;\n\n\t\tconst olderThan = new Date(\n\t\t\tDate.now() - this.options.pruneAfterHours * 60 * 60 * 1000,\n\t\t);\n\t\tawait this.storage.prune(olderThan);\n\t}\n}\n"],"mappings":"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"}

package/dist/adapters/middy.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"middy.cjs","names":["flushTelemetry"],"sources":["../../src/adapters/middy.ts"],"sourcesContent":["import type { MiddlewareObj } from '@middy/core';\nimport type {\n\tAPIGatewayProxyEvent,\n\tAPIGatewayProxyEventV2,\n\tContext,\n} from 'aws-lambda';\nimport { flushTelemetry } from '../instrumentation/core';\nimport type { Telescope } from '../Telescope';\n\n/**\n * Options for the Telescope Middy middleware\n */\nexport interface TelescopeMiddlewareOptions {\n\t/**\n\t * Minimum remaining time (ms) before forcing a flush.\n\t * If remaining time drops below this, flush immediately.\n\t * @default 1000 (1 second)\n\t */\n\tflushThresholdMs?: number;\n\n\t/**\n\t * Whether to record request/response bodies\n\t * @default true\n\t */\n\trecordBody?: boolean;\n\n\t/**\n\t * Timeout for flush operation in ms\n\t * @default 5000\n\t */\n\tflushTimeoutMs?: number;\n}\n\n// Track if we've registered the process hooks\nlet processHooksRegistered = false;\n\n/**\n * Register process-level hooks for telemetry flush.\n * Called once per Lambda cold start.\n */\nfunction registerProcessHooks(): void {\n\tif (processHooksRegistered) return;\n\tprocessHooksRegistered = true;\n\n\t// Flush on SIGTERM (Lambda shutdown)\n\tprocess.on('SIGTERM', async () => {\n\t\tawait flushTelemetry(5000).catch(() => {});\n\t});\n\n\t// Note: beforeExit doesn't work reliably in Lambda\n\t// because Lambda freezes rather than exits\n}\n\n/**\n * Extract request data from API Gateway event (v1 or v2)\n */\nfunction extractRequestData(\n\tevent: APIGatewayProxyEvent | APIGatewayProxyEventV2,\n): {\n\tmethod: string;\n\tpath: string;\n\turl: string;\n\theaders: Record<string, string>;\n\tquery: Record<string, string>;\n\tbody: unknown;\n\tip?: string;\n\trequestId?: string;\n\trequestSize?: number;\n} {\n\tconst headers: Record<string, string> = {};\n\tif (event.headers) {\n\t\tfor (const [key, value] of Object.entries(event.headers)) {\n\t\t\tif (value) headers[key.toLowerCase()] = value;\n\t\t}\n\t}\n\n\t// Get request size from Content-Length header\n\tconst contentLength = headers['content-length'];\n\tconst requestSize = contentLength ? parseInt(contentLength, 10) : undefined;\n\n\t// API Gateway v2 (HTTP API)\n\tif ('rawPath' in event && event.requestContext?.http) {\n\t\tconst v2Event = event as APIGatewayProxyEventV2;\n\t\t// Filter out undefined values from query parameters\n\t\tconst query: Record<string, string> = {};\n\t\tif (v2Event.queryStringParameters) {\n\t\t\tfor (const [key, value] of Object.entries(\n\t\t\t\tv2Event.queryStringParameters,\n\t\t\t)) {\n\t\t\t\tif (value !== undefined) {\n\t\t\t\t\tquery[key] = value;\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\t\treturn {\n\t\t\tmethod: v2Event.requestContext.http.method,\n\t\t\tpath: v2Event.rawPath,\n\t\t\turl:\n\t\t\t\tv2Event.rawPath +\n\t\t\t\t(v2Event.rawQueryString ? `?${v2Event.rawQueryString}` : ''),\n\t\t\theaders,\n\t\t\tquery,\n\t\t\tbody: parseBody(v2Event.body, v2Event.isBase64Encoded),\n\t\t\tip: v2Event.requestContext.http.sourceIp,\n\t\t\trequestId: v2Event.requestContext.requestId,\n\t\t\trequestSize,\n\t\t};\n\t}\n\n\t// API Gateway v1 (REST API)\n\tconst v1Event = event as APIGatewayProxyEvent;\n\tconst queryString = v1Event.queryStringParameters\n\t\t? new URLSearchParams(\n\t\t\t\tv1Event.queryStringParameters as Record<string, string>,\n\t\t\t).toString()\n\t\t: '';\n\n\treturn {\n\t\tmethod: v1Event.httpMethod,\n\t\tpath: v1Event.path,\n\t\turl: v1Event.path + (queryString ? `?${queryString}` : ''),\n\t\theaders,\n\t\tquery: (v1Event.queryStringParameters as Record<string, string>) || {},\n\t\tbody: parseBody(v1Event.body, v1Event.isBase64Encoded),\n\t\tip: v1Event.requestContext?.identity?.sourceIp,\n\t\trequestId: v1Event.requestContext?.requestId,\n\t\trequestSize,\n\t};\n}\n\n/**\n * Parse request body\n */\nfunction parseBody(\n\tbody: string | null | undefined,\n\tisBase64Encoded?: boolean,\n): unknown {\n\tif (!body) return undefined;\n\n\ttry {\n\t\tconst decoded = isBase64Encoded\n\t\t\t? Buffer.from(body, 'base64').toString('utf-8')\n\t\t\t: body;\n\t\treturn JSON.parse(decoded);\n\t} catch {\n\t\treturn body;\n\t}\n}\n\n/**\n * Extract response data from Lambda response\n */\nfunction extractResponseData(response: unknown): {\n\tstatus: number;\n\theaders: Record<string, string>;\n\tbody: unknown;\n\tresponseSize?: number;\n} {\n\tif (response && typeof response === 'object' && 'statusCode' in response) {\n\t\tconst res = response as {\n\t\t\tstatusCode?: number;\n\t\t\theaders?: Record<string, string>;\n\t\t\tbody?: string;\n\t\t};\n\t\tconst headers = res.headers || {};\n\t\t// Get response size from Content-Length header (case-insensitive)\n\t\tconst contentLengthKey = Object.keys(headers).find(\n\t\t\t(k) => k.toLowerCase() === 'content-length',\n\t\t);\n\t\tconst contentLengthValue = contentLengthKey\n\t\t\t? headers[contentLengthKey]\n\t\t\t: undefined;\n\t\t// Prefer Content-Length header, fallback to body size\n\t\tconst responseSize = contentLengthValue\n\t\t\t? parseInt(contentLengthValue, 10)\n\t\t\t: res.body\n\t\t\t\t? Buffer.byteLength(res.body, 'utf8')\n\t\t\t\t: undefined;\n\t\treturn {\n\t\t\tstatus: res.statusCode || 200,\n\t\t\theaders,\n\t\t\tbody: res.body ? tryParseJson(res.body) : undefined,\n\t\t\tresponseSize,\n\t\t};\n\t}\n\n\treturn { status: 200, headers: {}, body: response };\n}\n\nfunction tryParseJson(str: string): unknown {\n\ttry {\n\t\treturn JSON.parse(str);\n\t} catch {\n\t\treturn str;\n\t}\n}\n\n/**\n * Middy middleware that integrates Telescope with Lambda handlers.\n *\n * Features:\n * - Records all requests and responses to Telescope\n * - Captures exceptions automatically\n * - Flushes telemetry before Lambda freezes\n * - Uses Lambda context for smart flush timing\n *\n * @example\n * ```typescript\n * import middy from '@middy/core';\n * import { telescopeMiddleware } from '@geekmidas/telescope/lambda';\n *\n * const handler = middy(baseHandler)\n *   .use(telescopeMiddleware(telescope));\n * ```\n */\nexport function telescopeMiddleware(\n\ttelescope: Telescope,\n\toptions: TelescopeMiddlewareOptions = {},\n): MiddlewareObj<\n\tAPIGatewayProxyEvent | APIGatewayProxyEventV2,\n\tany,\n\tError,\n\tContext\n> {\n\tconst {\n\t\tflushThresholdMs = 1000,\n\t\trecordBody = true,\n\t\tflushTimeoutMs = 5000,\n\t} = options;\n\n\t// Register process hooks on first use\n\tregisterProcessHooks();\n\n\treturn {\n\t\tbefore: async (request) => {\n\t\t\t// Store start time for duration calculation\n\t\t\t(request as any).__telescopeStartTime = Date.now();\n\n\t\t\t// Don't wait for empty event loop - we'll flush manually\n\t\t\trequest.context.callbackWaitsForEmptyEventLoop = false;\n\t\t},\n\n\t\tafter: async (request) => {\n\t\t\tconst startTime = (request as any).__telescopeStartTime || Date.now();\n\t\t\tconst duration = Date.now() - startTime;\n\n\t\t\ttry {\n\t\t\t\tconst reqData = extractRequestData(request.event);\n\t\t\t\tconst resData = extractResponseData(request.response);\n\n\t\t\t\tawait telescope.recordRequest({\n\t\t\t\t\tmethod: reqData.method,\n\t\t\t\t\tpath: reqData.path,\n\t\t\t\t\turl: reqData.url,\n\t\t\t\t\theaders: reqData.headers,\n\t\t\t\t\tquery: reqData.query,\n\t\t\t\t\tbody: recordBody ? reqData.body : undefined,\n\t\t\t\t\tip: reqData.ip,\n\t\t\t\t\tstatus: resData.status,\n\t\t\t\t\tresponseHeaders: resData.headers,\n\t\t\t\t\tresponseBody: recordBody ? resData.body : undefined,\n\t\t\t\t\tduration,\n\t\t\t\t\trequestSize: reqData.requestSize,\n\t\t\t\t\tresponseSize: resData.responseSize,\n\t\t\t\t});\n\t\t\t} catch {\n\t\t\t\t// Don't let telescope errors break the response\n\t\t\t}\n\n\t\t\t// Smart flush: check remaining time\n\t\t\tawait smartFlush(request.context, flushThresholdMs, flushTimeoutMs);\n\t\t},\n\n\t\tonError: async (request) => {\n\t\t\tconst startTime = (request as any).__telescopeStartTime || Date.now();\n\t\t\tconst duration = Date.now() - startTime;\n\n\t\t\ttry {\n\t\t\t\t// Record the exception\n\t\t\t\tif (request.error) {\n\t\t\t\t\tawait telescope.exception(request.error);\n\t\t\t\t}\n\n\t\t\t\t// Also record the failed request\n\t\t\t\tconst reqData = extractRequestData(request.event);\n\t\t\t\tawait telescope.recordRequest({\n\t\t\t\t\tmethod: reqData.method,\n\t\t\t\t\tpath: reqData.path,\n\t\t\t\t\turl: reqData.url,\n\t\t\t\t\theaders: reqData.headers,\n\t\t\t\t\tquery: reqData.query,\n\t\t\t\t\tbody: recordBody ? reqData.body : undefined,\n\t\t\t\t\tip: reqData.ip,\n\t\t\t\t\tstatus: 500,\n\t\t\t\t\tresponseHeaders: {},\n\t\t\t\t\tresponseBody: { error: request.error?.message },\n\t\t\t\t\tduration,\n\t\t\t\t\trequestSize: reqData.requestSize,\n\t\t\t\t});\n\t\t\t} catch {\n\t\t\t\t// Don't let telescope errors mask the original error\n\t\t\t}\n\n\t\t\t// Always flush on error\n\t\t\tawait smartFlush(request.context, flushThresholdMs, flushTimeoutMs);\n\t\t},\n\t};\n}\n\n/**\n * Smart flush that respects Lambda's remaining execution time\n */\nasync function smartFlush(\n\tcontext: Context,\n\tthresholdMs: number,\n\ttimeoutMs: number,\n): Promise<void> {\n\tconst remaining = context.getRemainingTimeInMillis();\n\n\t// If we have plenty of time, use normal timeout\n\t// If time is running low, use a shorter timeout\n\tconst effectiveTimeout = Math.min(\n\t\ttimeoutMs,\n\t\tMath.max(remaining - thresholdMs, 100), // Leave at least threshold ms for response\n\t);\n\n\tif (effectiveTimeout > 0) {\n\t\tawait flushTelemetry(effectiveTimeout).catch(() => {});\n\t}\n}\n\n/**\n * Create a wrapped Lambda handler with Telescope integration.\n * Alternative to using Middy middleware directly.\n *\n * @example\n * ```typescript\n * import { createTelescopeHandler } from '@geekmidas/telescope/lambda';\n *\n * export const handler = createTelescopeHandler(telescope, async (event, context) => {\n *   return { statusCode: 200, body: 'OK' };\n * });\n * ```\n */\nexport function createTelescopeHandler<TEvent, TResult>(\n\ttelescope: Telescope,\n\thandler: (event: TEvent, context: Context) => Promise<TResult>,\n\toptions: TelescopeMiddlewareOptions = {},\n): (event: TEvent, context: Context) => Promise<TResult> {\n\tconst {\n\t\tflushThresholdMs = 1000,\n\t\trecordBody = true,\n\t\tflushTimeoutMs = 5000,\n\t} = options;\n\n\tregisterProcessHooks();\n\n\treturn async (event: TEvent, context: Context): Promise<TResult> => {\n\t\tconst startTime = Date.now();\n\t\tcontext.callbackWaitsForEmptyEventLoop = false;\n\n\t\ttry {\n\t\t\tconst result = await handler(event, context);\n\t\t\tconst duration = Date.now() - startTime;\n\n\t\t\t// Record successful request\n\t\t\ttry {\n\t\t\t\tconst reqData = extractRequestData(event as any);\n\t\t\t\tconst resData = extractResponseData(result);\n\n\t\t\t\tawait telescope.recordRequest({\n\t\t\t\t\tmethod: reqData.method,\n\t\t\t\t\tpath: reqData.path,\n\t\t\t\t\turl: reqData.url,\n\t\t\t\t\theaders: reqData.headers,\n\t\t\t\t\tquery: reqData.query,\n\t\t\t\t\tbody: recordBody ? reqData.body : undefined,\n\t\t\t\t\tip: reqData.ip,\n\t\t\t\t\tstatus: resData.status,\n\t\t\t\t\tresponseHeaders: resData.headers,\n\t\t\t\t\tresponseBody: recordBody ? resData.body : undefined,\n\t\t\t\t\tduration,\n\t\t\t\t\trequestSize: reqData.requestSize,\n\t\t\t\t\tresponseSize: resData.responseSize,\n\t\t\t\t});\n\t\t\t} catch {\n\t\t\t\t// Ignore telescope errors\n\t\t\t}\n\n\t\t\tawait smartFlush(context, flushThresholdMs, flushTimeoutMs);\n\t\t\treturn result;\n\t\t} catch (error) {\n\t\t\t// Record exception\n\t\t\tif (error instanceof Error) {\n\t\t\t\tawait telescope.exception(error).catch(() => {});\n\t\t\t}\n\n\t\t\tawait smartFlush(context, flushThresholdMs, flushTimeoutMs);\n\t\t\tthrow error;\n\t\t}\n\t};\n}\n"],"mappings":"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"}

package/dist/adapters/middy.d.cts.map

@@ -1 +0,0 @@
-{"version":3,"file":"middy.d.cts","names":[],"sources":["../../src/adapters/middy.ts"],"mappings":";;;;;;;iBAYiB;;;;;;EAMhB;;;;;EAMA;;;;;EAMA;;;;;;;;;;;;;;;;;;;;wBAyLe,oBACf,WAAW,WACX,UAAS,6BACP,cACF,uBAAuB,6BAEvB,OACA;;;;;;;;;;;;;;wBA0He,uBAAuB,QAAQ,SAC9C,WAAW,WACX,UAAU,OAAO,QAAQ,SAAS,YAAY,QAAQ,UACtD,UAAS,8BACN,OAAO,QAAQ,SAAS,YAAY,QAAQ"}

package/dist/adapters/middy.d.mts.map

@@ -1 +0,0 @@
-{"version":3,"file":"middy.d.mts","names":[],"sources":["../../src/adapters/middy.ts"],"mappings":";;;;;;;iBAYiB;;;;;;EAMhB;;;;;EAMA;;;;;EAMA;;;;;;;;;;;;;;;;;;;;wBAyLe,oBACf,WAAW,WACX,UAAS,6BACP,cACF,uBAAuB,6BAEvB,OACA;;;;;;;;;;;;;;wBA0He,uBAAuB,QAAQ,SAC9C,WAAW,WACX,UAAU,OAAO,QAAQ,SAAS,YAAY,QAAQ,UACtD,UAAS,8BACN,OAAO,QAAQ,SAAS,YAAY,QAAQ"}

package/dist/adapters/middy.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"middy.mjs","names":[],"sources":["../../src/adapters/middy.ts"],"sourcesContent":["import type { MiddlewareObj } from '@middy/core';\nimport type {\n\tAPIGatewayProxyEvent,\n\tAPIGatewayProxyEventV2,\n\tContext,\n} from 'aws-lambda';\nimport { flushTelemetry } from '../instrumentation/core';\nimport type { Telescope } from '../Telescope';\n\n/**\n * Options for the Telescope Middy middleware\n */\nexport interface TelescopeMiddlewareOptions {\n\t/**\n\t * Minimum remaining time (ms) before forcing a flush.\n\t * If remaining time drops below this, flush immediately.\n\t * @default 1000 (1 second)\n\t */\n\tflushThresholdMs?: number;\n\n\t/**\n\t * Whether to record request/response bodies\n\t * @default true\n\t */\n\trecordBody?: boolean;\n\n\t/**\n\t * Timeout for flush operation in ms\n\t * @default 5000\n\t */\n\tflushTimeoutMs?: number;\n}\n\n// Track if we've registered the process hooks\nlet processHooksRegistered = false;\n\n/**\n * Register process-level hooks for telemetry flush.\n * Called once per Lambda cold start.\n */\nfunction registerProcessHooks(): void {\n\tif (processHooksRegistered) return;\n\tprocessHooksRegistered = true;\n\n\t// Flush on SIGTERM (Lambda shutdown)\n\tprocess.on('SIGTERM', async () => {\n\t\tawait flushTelemetry(5000).catch(() => {});\n\t});\n\n\t// Note: beforeExit doesn't work reliably in Lambda\n\t// because Lambda freezes rather than exits\n}\n\n/**\n * Extract request data from API Gateway event (v1 or v2)\n */\nfunction extractRequestData(\n\tevent: APIGatewayProxyEvent | APIGatewayProxyEventV2,\n): {\n\tmethod: string;\n\tpath: string;\n\turl: string;\n\theaders: Record<string, string>;\n\tquery: Record<string, string>;\n\tbody: unknown;\n\tip?: string;\n\trequestId?: string;\n\trequestSize?: number;\n} {\n\tconst headers: Record<string, string> = {};\n\tif (event.headers) {\n\t\tfor (const [key, value] of Object.entries(event.headers)) {\n\t\t\tif (value) headers[key.toLowerCase()] = value;\n\t\t}\n\t}\n\n\t// Get request size from Content-Length header\n\tconst contentLength = headers['content-length'];\n\tconst requestSize = contentLength ? parseInt(contentLength, 10) : undefined;\n\n\t// API Gateway v2 (HTTP API)\n\tif ('rawPath' in event && event.requestContext?.http) {\n\t\tconst v2Event = event as APIGatewayProxyEventV2;\n\t\t// Filter out undefined values from query parameters\n\t\tconst query: Record<string, string> = {};\n\t\tif (v2Event.queryStringParameters) {\n\t\t\tfor (const [key, value] of Object.entries(\n\t\t\t\tv2Event.queryStringParameters,\n\t\t\t)) {\n\t\t\t\tif (value !== undefined) {\n\t\t\t\t\tquery[key] = value;\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\t\treturn {\n\t\t\tmethod: v2Event.requestContext.http.method,\n\t\t\tpath: v2Event.rawPath,\n\t\t\turl:\n\t\t\t\tv2Event.rawPath +\n\t\t\t\t(v2Event.rawQueryString ? `?${v2Event.rawQueryString}` : ''),\n\t\t\theaders,\n\t\t\tquery,\n\t\t\tbody: parseBody(v2Event.body, v2Event.isBase64Encoded),\n\t\t\tip: v2Event.requestContext.http.sourceIp,\n\t\t\trequestId: v2Event.requestContext.requestId,\n\t\t\trequestSize,\n\t\t};\n\t}\n\n\t// API Gateway v1 (REST API)\n\tconst v1Event = event as APIGatewayProxyEvent;\n\tconst queryString = v1Event.queryStringParameters\n\t\t? new URLSearchParams(\n\t\t\t\tv1Event.queryStringParameters as Record<string, string>,\n\t\t\t).toString()\n\t\t: '';\n\n\treturn {\n\t\tmethod: v1Event.httpMethod,\n\t\tpath: v1Event.path,\n\t\turl: v1Event.path + (queryString ? `?${queryString}` : ''),\n\t\theaders,\n\t\tquery: (v1Event.queryStringParameters as Record<string, string>) || {},\n\t\tbody: parseBody(v1Event.body, v1Event.isBase64Encoded),\n\t\tip: v1Event.requestContext?.identity?.sourceIp,\n\t\trequestId: v1Event.requestContext?.requestId,\n\t\trequestSize,\n\t};\n}\n\n/**\n * Parse request body\n */\nfunction parseBody(\n\tbody: string | null | undefined,\n\tisBase64Encoded?: boolean,\n): unknown {\n\tif (!body) return undefined;\n\n\ttry {\n\t\tconst decoded = isBase64Encoded\n\t\t\t? Buffer.from(body, 'base64').toString('utf-8')\n\t\t\t: body;\n\t\treturn JSON.parse(decoded);\n\t} catch {\n\t\treturn body;\n\t}\n}\n\n/**\n * Extract response data from Lambda response\n */\nfunction extractResponseData(response: unknown): {\n\tstatus: number;\n\theaders: Record<string, string>;\n\tbody: unknown;\n\tresponseSize?: number;\n} {\n\tif (response && typeof response === 'object' && 'statusCode' in response) {\n\t\tconst res = response as {\n\t\t\tstatusCode?: number;\n\t\t\theaders?: Record<string, string>;\n\t\t\tbody?: string;\n\t\t};\n\t\tconst headers = res.headers || {};\n\t\t// Get response size from Content-Length header (case-insensitive)\n\t\tconst contentLengthKey = Object.keys(headers).find(\n\t\t\t(k) => k.toLowerCase() === 'content-length',\n\t\t);\n\t\tconst contentLengthValue = contentLengthKey\n\t\t\t? headers[contentLengthKey]\n\t\t\t: undefined;\n\t\t// Prefer Content-Length header, fallback to body size\n\t\tconst responseSize = contentLengthValue\n\t\t\t? parseInt(contentLengthValue, 10)\n\t\t\t: res.body\n\t\t\t\t? Buffer.byteLength(res.body, 'utf8')\n\t\t\t\t: undefined;\n\t\treturn {\n\t\t\tstatus: res.statusCode || 200,\n\t\t\theaders,\n\t\t\tbody: res.body ? tryParseJson(res.body) : undefined,\n\t\t\tresponseSize,\n\t\t};\n\t}\n\n\treturn { status: 200, headers: {}, body: response };\n}\n\nfunction tryParseJson(str: string): unknown {\n\ttry {\n\t\treturn JSON.parse(str);\n\t} catch {\n\t\treturn str;\n\t}\n}\n\n/**\n * Middy middleware that integrates Telescope with Lambda handlers.\n *\n * Features:\n * - Records all requests and responses to Telescope\n * - Captures exceptions automatically\n * - Flushes telemetry before Lambda freezes\n * - Uses Lambda context for smart flush timing\n *\n * @example\n * ```typescript\n * import middy from '@middy/core';\n * import { telescopeMiddleware } from '@geekmidas/telescope/lambda';\n *\n * const handler = middy(baseHandler)\n *   .use(telescopeMiddleware(telescope));\n * ```\n */\nexport function telescopeMiddleware(\n\ttelescope: Telescope,\n\toptions: TelescopeMiddlewareOptions = {},\n): MiddlewareObj<\n\tAPIGatewayProxyEvent | APIGatewayProxyEventV2,\n\tany,\n\tError,\n\tContext\n> {\n\tconst {\n\t\tflushThresholdMs = 1000,\n\t\trecordBody = true,\n\t\tflushTimeoutMs = 5000,\n\t} = options;\n\n\t// Register process hooks on first use\n\tregisterProcessHooks();\n\n\treturn {\n\t\tbefore: async (request) => {\n\t\t\t// Store start time for duration calculation\n\t\t\t(request as any).__telescopeStartTime = Date.now();\n\n\t\t\t// Don't wait for empty event loop - we'll flush manually\n\t\t\trequest.context.callbackWaitsForEmptyEventLoop = false;\n\t\t},\n\n\t\tafter: async (request) => {\n\t\t\tconst startTime = (request as any).__telescopeStartTime || Date.now();\n\t\t\tconst duration = Date.now() - startTime;\n\n\t\t\ttry {\n\t\t\t\tconst reqData = extractRequestData(request.event);\n\t\t\t\tconst resData = extractResponseData(request.response);\n\n\t\t\t\tawait telescope.recordRequest({\n\t\t\t\t\tmethod: reqData.method,\n\t\t\t\t\tpath: reqData.path,\n\t\t\t\t\turl: reqData.url,\n\t\t\t\t\theaders: reqData.headers,\n\t\t\t\t\tquery: reqData.query,\n\t\t\t\t\tbody: recordBody ? reqData.body : undefined,\n\t\t\t\t\tip: reqData.ip,\n\t\t\t\t\tstatus: resData.status,\n\t\t\t\t\tresponseHeaders: resData.headers,\n\t\t\t\t\tresponseBody: recordBody ? resData.body : undefined,\n\t\t\t\t\tduration,\n\t\t\t\t\trequestSize: reqData.requestSize,\n\t\t\t\t\tresponseSize: resData.responseSize,\n\t\t\t\t});\n\t\t\t} catch {\n\t\t\t\t// Don't let telescope errors break the response\n\t\t\t}\n\n\t\t\t// Smart flush: check remaining time\n\t\t\tawait smartFlush(request.context, flushThresholdMs, flushTimeoutMs);\n\t\t},\n\n\t\tonError: async (request) => {\n\t\t\tconst startTime = (request as any).__telescopeStartTime || Date.now();\n\t\t\tconst duration = Date.now() - startTime;\n\n\t\t\ttry {\n\t\t\t\t// Record the exception\n\t\t\t\tif (request.error) {\n\t\t\t\t\tawait telescope.exception(request.error);\n\t\t\t\t}\n\n\t\t\t\t// Also record the failed request\n\t\t\t\tconst reqData = extractRequestData(request.event);\n\t\t\t\tawait telescope.recordRequest({\n\t\t\t\t\tmethod: reqData.method,\n\t\t\t\t\tpath: reqData.path,\n\t\t\t\t\turl: reqData.url,\n\t\t\t\t\theaders: reqData.headers,\n\t\t\t\t\tquery: reqData.query,\n\t\t\t\t\tbody: recordBody ? reqData.body : undefined,\n\t\t\t\t\tip: reqData.ip,\n\t\t\t\t\tstatus: 500,\n\t\t\t\t\tresponseHeaders: {},\n\t\t\t\t\tresponseBody: { error: request.error?.message },\n\t\t\t\t\tduration,\n\t\t\t\t\trequestSize: reqData.requestSize,\n\t\t\t\t});\n\t\t\t} catch {\n\t\t\t\t// Don't let telescope errors mask the original error\n\t\t\t}\n\n\t\t\t// Always flush on error\n\t\t\tawait smartFlush(request.context, flushThresholdMs, flushTimeoutMs);\n\t\t},\n\t};\n}\n\n/**\n * Smart flush that respects Lambda's remaining execution time\n */\nasync function smartFlush(\n\tcontext: Context,\n\tthresholdMs: number,\n\ttimeoutMs: number,\n): Promise<void> {\n\tconst remaining = context.getRemainingTimeInMillis();\n\n\t// If we have plenty of time, use normal timeout\n\t// If time is running low, use a shorter timeout\n\tconst effectiveTimeout = Math.min(\n\t\ttimeoutMs,\n\t\tMath.max(remaining - thresholdMs, 100), // Leave at least threshold ms for response\n\t);\n\n\tif (effectiveTimeout > 0) {\n\t\tawait flushTelemetry(effectiveTimeout).catch(() => {});\n\t}\n}\n\n/**\n * Create a wrapped Lambda handler with Telescope integration.\n * Alternative to using Middy middleware directly.\n *\n * @example\n * ```typescript\n * import { createTelescopeHandler } from '@geekmidas/telescope/lambda';\n *\n * export const handler = createTelescopeHandler(telescope, async (event, context) => {\n *   return { statusCode: 200, body: 'OK' };\n * });\n * ```\n */\nexport function createTelescopeHandler<TEvent, TResult>(\n\ttelescope: Telescope,\n\thandler: (event: TEvent, context: Context) => Promise<TResult>,\n\toptions: TelescopeMiddlewareOptions = {},\n): (event: TEvent, context: Context) => Promise<TResult> {\n\tconst {\n\t\tflushThresholdMs = 1000,\n\t\trecordBody = true,\n\t\tflushTimeoutMs = 5000,\n\t} = options;\n\n\tregisterProcessHooks();\n\n\treturn async (event: TEvent, context: Context): Promise<TResult> => {\n\t\tconst startTime = Date.now();\n\t\tcontext.callbackWaitsForEmptyEventLoop = false;\n\n\t\ttry {\n\t\t\tconst result = await handler(event, context);\n\t\t\tconst duration = Date.now() - startTime;\n\n\t\t\t// Record successful request\n\t\t\ttry {\n\t\t\t\tconst reqData = extractRequestData(event as any);\n\t\t\t\tconst resData = extractResponseData(result);\n\n\t\t\t\tawait telescope.recordRequest({\n\t\t\t\t\tmethod: reqData.method,\n\t\t\t\t\tpath: reqData.path,\n\t\t\t\t\turl: reqData.url,\n\t\t\t\t\theaders: reqData.headers,\n\t\t\t\t\tquery: reqData.query,\n\t\t\t\t\tbody: recordBody ? reqData.body : undefined,\n\t\t\t\t\tip: reqData.ip,\n\t\t\t\t\tstatus: resData.status,\n\t\t\t\t\tresponseHeaders: resData.headers,\n\t\t\t\t\tresponseBody: recordBody ? resData.body : undefined,\n\t\t\t\t\tduration,\n\t\t\t\t\trequestSize: reqData.requestSize,\n\t\t\t\t\tresponseSize: resData.responseSize,\n\t\t\t\t});\n\t\t\t} catch {\n\t\t\t\t// Ignore telescope errors\n\t\t\t}\n\n\t\t\tawait smartFlush(context, flushThresholdMs, flushTimeoutMs);\n\t\t\treturn result;\n\t\t} catch (error) {\n\t\t\t// Record exception\n\t\t\tif (error instanceof Error) {\n\t\t\t\tawait telescope.exception(error).catch(() => {});\n\t\t\t}\n\n\t\t\tawait smartFlush(context, flushThresholdMs, flushTimeoutMs);\n\t\t\tthrow error;\n\t\t}\n\t};\n}\n"],"mappings":"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"}

package/dist/adapters/types.d.cts.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.d.cts","names":["HonoContext"],"sources":["../../src/adapters/types.ts"],"mappings":";;;;;YAKY;;;;iBAKK;;EAEhB;;EAEA;;EAEA;;EAEA;;EAEA,SAAS;;EAET,OAAO;;EAEP;;EAEA;;EAEA;;EAEA;;;;;iBAMgB;;EAEhB;;EAEA,SAAS;;EAET;;EAEA;;EAEA;;;;;iBAMgB;;EAEhB,OAAO;;EAEP;;EAEA;;;;;YAMW;;;;iBAKK;;EAEhB,UAAU;;EAEV;;EAEA;;EAEA;;EAEA;;;;;iBAMgB;;;;EAIhB,YAAY;;;;EAKZ,cAAc;;;;;iBAME;;EAEhB,aAAa;;EAEb,gBAAgB;;EAEhB;;;;;;iBAOgB,iBAAiB,gBAAgB,gBAAgB,uBACzD;;WAEC,QAAQ;;;;;EAMjB,sBAAsB,mBAAmB;;;;;EAMzC,uBACC,mBACA,oBACE;;;;;EAMH,SAAS;;;;;iBAMO,0BAA0B;EAC1C;;;;;iBAMgB,4BAA4B;EAC5C;;EAEA;;EAEA,qBAAqB;;;;;iBAML;;EAEhB;;EAEA;;;;;iBAMgB;EAChB,WAAW;;;;;YAMA,2BAA2BA;EACtC,WAAW"}

package/dist/adapters/types.d.mts.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.d.mts","names":["HonoContext"],"sources":["../../src/adapters/types.ts"],"mappings":";;;;;YAKY;;;;iBAKK;;EAEhB;;EAEA;;EAEA;;EAEA;;EAEA,SAAS;;EAET,OAAO;;EAEP;;EAEA;;EAEA;;EAEA;;;;;iBAMgB;;EAEhB;;EAEA,SAAS;;EAET;;EAEA;;EAEA;;;;;iBAMgB;;EAEhB,OAAO;;EAEP;;EAEA;;;;;YAMW;;;;iBAKK;;EAEhB,UAAU;;EAEV;;EAEA;;EAEA;;EAEA;;;;;iBAMgB;;;;EAIhB,YAAY;;;;EAKZ,cAAc;;;;;iBAME;;EAEhB,aAAa;;EAEb,gBAAgB;;EAEhB;;;;;;iBAOgB,iBAAiB,gBAAgB,gBAAgB,uBACzD;;WAEC,QAAQ;;;;;EAMjB,sBAAsB,mBAAmB;;;;;EAMzC,uBACC,mBACA,oBACE;;;;;EAMH,SAAS;;;;;iBAMO,0BAA0B;EAC1C;;;;;iBAMgB,4BAA4B;EAC5C;;EAEA;;EAEA,qBAAqB;;;;;iBAML;;EAEhB;;EAEA;;;;;iBAMgB;EAChB,WAAW;;;;;YAMA,2BAA2BA;EACtC,WAAW"}

package/dist/instrumentation/core.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"core.cjs","names":["SimpleSpanProcessor","BatchSpanProcessor","diag","DiagConsoleLogger","DiagLogLevel"],"sources":["../../src/instrumentation/core.ts"],"sourcesContent":["import { DiagConsoleLogger, DiagLogLevel, diag } from '@opentelemetry/api';\nimport {\n\tBatchSpanProcessor,\n\ttype ReadableSpan,\n\tSimpleSpanProcessor,\n\ttype Span,\n\ttype SpanExporter,\n\ttype SpanProcessor,\n} from '@opentelemetry/sdk-trace-base';\nimport type {\n\tSpanProcessorOptions,\n\tSpanProcessorStrategy,\n} from '../adapters/types';\n\n/**\n * Global telemetry state for flush operations\n */\ninterface TelemetryState {\n\tspanProcessor: SpanProcessor | null;\n\tlogProcessor: unknown | null;\n\tinitialized: boolean;\n}\n\nconst state: TelemetryState = {\n\tspanProcessor: null,\n\tlogProcessor: null,\n\tinitialized: false,\n};\n\n/**\n * Create a span processor based on the strategy\n */\nexport function createSpanProcessor(\n\texporter: SpanExporter,\n\toptions: SpanProcessorOptions,\n): SpanProcessor {\n\tconst { strategy, ...config } = options;\n\n\tif (strategy === 'simple') {\n\t\treturn new SimpleSpanProcessor(exporter);\n\t}\n\n\treturn new BatchSpanProcessor(exporter, {\n\t\tmaxQueueSize: config.maxQueueSize ?? 2048,\n\t\tscheduledDelayMillis: config.scheduledDelayMillis ?? 5000,\n\t\texportTimeoutMillis: config.exportTimeoutMillis ?? 30000,\n\t\tmaxExportBatchSize: config.maxExportBatchSize ?? 512,\n\t});\n}\n\n/**\n * Get the recommended span processor strategy for an environment\n */\nexport function getRecommendedStrategy(\n\tenvironment: 'server' | 'lambda' | 'edge' | 'custom',\n): SpanProcessorStrategy {\n\tswitch (environment) {\n\t\tcase 'lambda':\n\t\tcase 'edge':\n\t\t\t// Use simple processor for serverless - immediate export\n\t\t\treturn 'simple';\n\t\tdefault:\n\t\t\t// Use batch processor for long-running servers - efficient batching\n\t\t\treturn 'batch';\n\t}\n}\n\n/**\n * Set the global span processor for flush operations\n */\nexport function setGlobalSpanProcessor(processor: SpanProcessor): void {\n\tstate.spanProcessor = processor;\n\tstate.initialized = true;\n}\n\n/**\n * Set the global log processor for flush operations\n */\nexport function setGlobalLogProcessor(processor: unknown): void {\n\tstate.logProcessor = processor;\n}\n\n/**\n * Check if telemetry is initialized\n */\nexport function isTelemetryInitialized(): boolean {\n\treturn state.initialized;\n}\n\n/**\n * Flush all pending telemetry data.\n * This is critical for serverless environments where the process may freeze.\n *\n * @example\n * ```typescript\n * // In a Lambda handler\n * export const handler = async (event, context) => {\n *   try {\n *     const result = await processRequest(event);\n *     return result;\n *   } finally {\n *     // Flush before Lambda freezes\n *     await flushTelemetry();\n *   }\n * };\n * ```\n */\nexport async function flushTelemetry(timeoutMs = 30000): Promise<void> {\n\tconst promises: Promise<void>[] = [];\n\n\t// Flush span processor\n\tif (state.spanProcessor) {\n\t\tpromises.push(\n\t\t\tPromise.race([\n\t\t\t\tstate.spanProcessor.forceFlush(),\n\t\t\t\tnew Promise<void>((_, reject) =>\n\t\t\t\t\tsetTimeout(() => reject(new Error('Span flush timeout')), timeoutMs),\n\t\t\t\t),\n\t\t\t]).catch((error) => {\n\t\t\t\tif (diag.debug) {\n\t\t\t\t\tdiag.debug(`Span flush error: ${error.message}`);\n\t\t\t\t}\n\t\t\t}),\n\t\t);\n\t}\n\n\t// Flush log processor if it has forceFlush method\n\tif (\n\t\tstate.logProcessor &&\n\t\ttypeof (state.logProcessor as { forceFlush?: () => Promise<void> })\n\t\t\t.forceFlush === 'function'\n\t) {\n\t\tpromises.push(\n\t\t\tPromise.race([\n\t\t\t\t(\n\t\t\t\t\tstate.logProcessor as { forceFlush: () => Promise<void> }\n\t\t\t\t).forceFlush(),\n\t\t\t\tnew Promise<void>((_, reject) =>\n\t\t\t\t\tsetTimeout(() => reject(new Error('Log flush timeout')), timeoutMs),\n\t\t\t\t),\n\t\t\t]).catch((error) => {\n\t\t\t\tif (diag.debug) {\n\t\t\t\t\tdiag.debug(`Log flush error: ${error.message}`);\n\t\t\t\t}\n\t\t\t}),\n\t\t);\n\t}\n\n\tawait Promise.all(promises);\n}\n\n/**\n * Shutdown all telemetry processors\n */\nexport async function shutdownTelemetry(): Promise<void> {\n\tconst promises: Promise<void>[] = [];\n\n\tif (state.spanProcessor) {\n\t\tpromises.push(state.spanProcessor.shutdown());\n\t\tstate.spanProcessor = null;\n\t}\n\n\tif (\n\t\tstate.logProcessor &&\n\t\ttypeof (state.logProcessor as { shutdown?: () => Promise<void> })\n\t\t\t.shutdown === 'function'\n\t) {\n\t\tpromises.push(\n\t\t\t(state.logProcessor as { shutdown: () => Promise<void> }).shutdown(),\n\t\t);\n\t\tstate.logProcessor = null;\n\t}\n\n\tstate.initialized = false;\n\tawait Promise.all(promises);\n}\n\n/**\n * Enable debug logging for telemetry\n */\nexport function enableTelemetryDebug(): void {\n\tdiag.setLogger(new DiagConsoleLogger(), DiagLogLevel.DEBUG);\n}\n\n/**\n * Wraps a handler function to ensure telemetry is flushed before returning.\n * Useful for Lambda handlers.\n *\n * @example\n * ```typescript\n * export const handler = withTelemetryFlush(async (event, context) => {\n *   // Your Lambda logic here\n *   return { statusCode: 200, body: 'OK' };\n * });\n * ```\n */\nexport function withTelemetryFlush<TEvent, TResult>(\n\thandler: (event: TEvent, context: unknown) => Promise<TResult>,\n): (event: TEvent, context: unknown) => Promise<TResult> {\n\treturn async (event: TEvent, context: unknown): Promise<TResult> => {\n\t\ttry {\n\t\t\treturn await handler(event, context);\n\t\t} finally {\n\t\t\tawait flushTelemetry();\n\t\t}\n\t};\n}\n\n/**\n * Noop span processor for testing or when telemetry is disabled\n */\nexport class NoopSpanProcessor implements SpanProcessor {\n\tforceFlush(): Promise<void> {\n\t\treturn Promise.resolve();\n\t}\n\n\tonStart(_span: Span): void {\n\t\t// noop\n\t}\n\n\tonEnd(_span: ReadableSpan): void {\n\t\t// noop\n\t}\n\n\tshutdown(): Promise<void> {\n\t\treturn Promise.resolve();\n\t}\n}\n"],"mappings":";;;;AAuBA,MAAM,QAAwB;CAC7B,eAAe;CACf,cAAc;CACd,aAAa;AACd;;;;AAKA,SAAgB,oBACf,UACA,SACgB;CAChB,MAAM,EAAE,UAAU,GAAG,WAAW;CAEhC,IAAI,aAAa,UAChB,OAAO,IAAIA,8BAAAA,oBAAoB,QAAQ;CAGxC,OAAO,IAAIC,8BAAAA,mBAAmB,UAAU;EACvC,cAAc,OAAO,gBAAgB;EACrC,sBAAsB,OAAO,wBAAwB;EACrD,qBAAqB,OAAO,uBAAuB;EACnD,oBAAoB,OAAO,sBAAsB;CAClD,CAAC;AACF;;;;AAKA,SAAgB,uBACf,aACwB;CACxB,QAAQ,aAAR;EACC,KAAK;EACL,KAAK,QAEJ,OAAO;EACR,SAEC,OAAO;CACT;AACD;;;;AAKA,SAAgB,uBAAuB,WAAgC;CACtE,MAAM,gBAAgB;CACtB,MAAM,cAAc;AACrB;;;;AAKA,SAAgB,sBAAsB,WAA0B;CAC/D,MAAM,eAAe;AACtB;;;;AAKA,SAAgB,yBAAkC;CACjD,OAAO,MAAM;AACd;;;;;;;;;;;;;;;;;;;AAoBA,eAAsB,eAAe,YAAY,KAAsB;CACtE,MAAM,WAA4B,CAAC;CAGnC,IAAI,MAAM,eACT,SAAS,KACR,QAAQ,KAAK,CACZ,MAAM,cAAc,WAAW,GAC/B,IAAI,SAAe,GAAG,WACrB,iBAAiB,uBAAO,IAAI,MAAM,oBAAoB,CAAC,GAAG,SAAS,CACpE,CACD,CAAC,CAAC,CAAC,OAAO,UAAU;EACnB,IAAIC,mBAAAA,KAAK,OACR,mBAAA,KAAK,MAAM,qBAAqB,MAAM,SAAS;CAEjD,CAAC,CACF;CAID,IACC,MAAM,gBACN,OAAQ,MAAM,aACZ,eAAe,YAEjB,SAAS,KACR,QAAQ,KAAK,CAEX,MAAM,aACL,WAAW,GACb,IAAI,SAAe,GAAG,WACrB,iBAAiB,uBAAO,IAAI,MAAM,mBAAmB,CAAC,GAAG,SAAS,CACnE,CACD,CAAC,CAAC,CAAC,OAAO,UAAU;EACnB,IAAIA,mBAAAA,KAAK,OACR,mBAAA,KAAK,MAAM,oBAAoB,MAAM,SAAS;CAEhD,CAAC,CACF;CAGD,MAAM,QAAQ,IAAI,QAAQ;AAC3B;;;;AAKA,eAAsB,oBAAmC;CACxD,MAAM,WAA4B,CAAC;CAEnC,IAAI,MAAM,eAAe;EACxB,SAAS,KAAK,MAAM,cAAc,SAAS,CAAC;EAC5C,MAAM,gBAAgB;CACvB;CAEA,IACC,MAAM,gBACN,OAAQ,MAAM,aACZ,aAAa,YACd;EACD,SAAS,KACP,MAAM,aAAmD,SAAS,CACpE;EACA,MAAM,eAAe;CACtB;CAEA,MAAM,cAAc;CACpB,MAAM,QAAQ,IAAI,QAAQ;AAC3B;;;;AAKA,SAAgB,uBAA6B;CAC5C,mBAAA,KAAK,UAAU,IAAIC,mBAAAA,kBAAkB,GAAGC,mBAAAA,aAAa,KAAK;AAC3D;;;;;;;;;;;;;AAcA,SAAgB,mBACf,SACwD;CACxD,OAAO,OAAO,OAAe,YAAuC;EACnE,IAAI;GACH,OAAO,MAAM,QAAQ,OAAO,OAAO;EACpC,UAAU;GACT,MAAM,eAAe;EACtB;CACD;AACD;;;;AAKA,IAAa,oBAAb,MAAwD;CACvD,aAA4B;EAC3B,OAAO,QAAQ,QAAQ;CACxB;CAEA,QAAQ,OAAmB,CAE3B;CAEA,MAAM,OAA2B,CAEjC;CAEA,WAA0B;EACzB,OAAO,QAAQ,QAAQ;CACxB;AACD"}

package/dist/instrumentation/core.d.cts.map

@@ -1 +0,0 @@
-{"version":3,"file":"core.d.cts","names":[],"sources":["../../src/instrumentation/core.ts"],"mappings":";;;;;;wBAgCgB,oBACf,UAAU,cACV,SAAS,uBACP;;;;wBAkBa,uBACf,uDACE;;;;wBAea,uBAAuB,WAAW;;;;wBAQlC,sBAAsB;;;;wBAOtB;;;;;;;;;;;;;;;;;;;wBAsBM,eAAe,qBAAoB;;;;wBA+CnC,qBAAqB;;;;wBA0B3B;;;;;;;;;;;;;wBAgBA,mBAAmB,QAAQ,SAC1C,UAAU,OAAO,QAAQ,qBAAqB,QAAQ,YACnD,OAAO,QAAQ,qBAAqB,QAAQ;;;;qBAanC,6BAA6B;EACzC,cAAc;EAId,QAAQ,OAAO;EAIf,MAAM,OAAO;EAIb,YAAY"}

package/dist/instrumentation/core.d.mts.map

@@ -1 +0,0 @@
-{"version":3,"file":"core.d.mts","names":[],"sources":["../../src/instrumentation/core.ts"],"mappings":";;;;;;wBAgCgB,oBACf,UAAU,cACV,SAAS,uBACP;;;;wBAkBa,uBACf,uDACE;;;;wBAea,uBAAuB,WAAW;;;;wBAQlC,sBAAsB;;;;wBAOtB;;;;;;;;;;;;;;;;;;;wBAsBM,eAAe,qBAAoB;;;;wBA+CnC,qBAAqB;;;;wBA0B3B;;;;;;;;;;;;;wBAgBA,mBAAmB,QAAQ,SAC1C,UAAU,OAAO,QAAQ,qBAAqB,QAAQ,YACnD,OAAO,QAAQ,qBAAqB,QAAQ;;;;qBAanC,6BAA6B;EACzC,cAAc;EAId,QAAQ,OAAO;EAIf,MAAM,OAAO;EAIb,YAAY"}

package/dist/instrumentation/core.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"core.mjs","names":[],"sources":["../../src/instrumentation/core.ts"],"sourcesContent":["import { DiagConsoleLogger, DiagLogLevel, diag } from '@opentelemetry/api';\nimport {\n\tBatchSpanProcessor,\n\ttype ReadableSpan,\n\tSimpleSpanProcessor,\n\ttype Span,\n\ttype SpanExporter,\n\ttype SpanProcessor,\n} from '@opentelemetry/sdk-trace-base';\nimport type {\n\tSpanProcessorOptions,\n\tSpanProcessorStrategy,\n} from '../adapters/types';\n\n/**\n * Global telemetry state for flush operations\n */\ninterface TelemetryState {\n\tspanProcessor: SpanProcessor | null;\n\tlogProcessor: unknown | null;\n\tinitialized: boolean;\n}\n\nconst state: TelemetryState = {\n\tspanProcessor: null,\n\tlogProcessor: null,\n\tinitialized: false,\n};\n\n/**\n * Create a span processor based on the strategy\n */\nexport function createSpanProcessor(\n\texporter: SpanExporter,\n\toptions: SpanProcessorOptions,\n): SpanProcessor {\n\tconst { strategy, ...config } = options;\n\n\tif (strategy === 'simple') {\n\t\treturn new SimpleSpanProcessor(exporter);\n\t}\n\n\treturn new BatchSpanProcessor(exporter, {\n\t\tmaxQueueSize: config.maxQueueSize ?? 2048,\n\t\tscheduledDelayMillis: config.scheduledDelayMillis ?? 5000,\n\t\texportTimeoutMillis: config.exportTimeoutMillis ?? 30000,\n\t\tmaxExportBatchSize: config.maxExportBatchSize ?? 512,\n\t});\n}\n\n/**\n * Get the recommended span processor strategy for an environment\n */\nexport function getRecommendedStrategy(\n\tenvironment: 'server' | 'lambda' | 'edge' | 'custom',\n): SpanProcessorStrategy {\n\tswitch (environment) {\n\t\tcase 'lambda':\n\t\tcase 'edge':\n\t\t\t// Use simple processor for serverless - immediate export\n\t\t\treturn 'simple';\n\t\tdefault:\n\t\t\t// Use batch processor for long-running servers - efficient batching\n\t\t\treturn 'batch';\n\t}\n}\n\n/**\n * Set the global span processor for flush operations\n */\nexport function setGlobalSpanProcessor(processor: SpanProcessor): void {\n\tstate.spanProcessor = processor;\n\tstate.initialized = true;\n}\n\n/**\n * Set the global log processor for flush operations\n */\nexport function setGlobalLogProcessor(processor: unknown): void {\n\tstate.logProcessor = processor;\n}\n\n/**\n * Check if telemetry is initialized\n */\nexport function isTelemetryInitialized(): boolean {\n\treturn state.initialized;\n}\n\n/**\n * Flush all pending telemetry data.\n * This is critical for serverless environments where the process may freeze.\n *\n * @example\n * ```typescript\n * // In a Lambda handler\n * export const handler = async (event, context) => {\n *   try {\n *     const result = await processRequest(event);\n *     return result;\n *   } finally {\n *     // Flush before Lambda freezes\n *     await flushTelemetry();\n *   }\n * };\n * ```\n */\nexport async function flushTelemetry(timeoutMs = 30000): Promise<void> {\n\tconst promises: Promise<void>[] = [];\n\n\t// Flush span processor\n\tif (state.spanProcessor) {\n\t\tpromises.push(\n\t\t\tPromise.race([\n\t\t\t\tstate.spanProcessor.forceFlush(),\n\t\t\t\tnew Promise<void>((_, reject) =>\n\t\t\t\t\tsetTimeout(() => reject(new Error('Span flush timeout')), timeoutMs),\n\t\t\t\t),\n\t\t\t]).catch((error) => {\n\t\t\t\tif (diag.debug) {\n\t\t\t\t\tdiag.debug(`Span flush error: ${error.message}`);\n\t\t\t\t}\n\t\t\t}),\n\t\t);\n\t}\n\n\t// Flush log processor if it has forceFlush method\n\tif (\n\t\tstate.logProcessor &&\n\t\ttypeof (state.logProcessor as { forceFlush?: () => Promise<void> })\n\t\t\t.forceFlush === 'function'\n\t) {\n\t\tpromises.push(\n\t\t\tPromise.race([\n\t\t\t\t(\n\t\t\t\t\tstate.logProcessor as { forceFlush: () => Promise<void> }\n\t\t\t\t).forceFlush(),\n\t\t\t\tnew Promise<void>((_, reject) =>\n\t\t\t\t\tsetTimeout(() => reject(new Error('Log flush timeout')), timeoutMs),\n\t\t\t\t),\n\t\t\t]).catch((error) => {\n\t\t\t\tif (diag.debug) {\n\t\t\t\t\tdiag.debug(`Log flush error: ${error.message}`);\n\t\t\t\t}\n\t\t\t}),\n\t\t);\n\t}\n\n\tawait Promise.all(promises);\n}\n\n/**\n * Shutdown all telemetry processors\n */\nexport async function shutdownTelemetry(): Promise<void> {\n\tconst promises: Promise<void>[] = [];\n\n\tif (state.spanProcessor) {\n\t\tpromises.push(state.spanProcessor.shutdown());\n\t\tstate.spanProcessor = null;\n\t}\n\n\tif (\n\t\tstate.logProcessor &&\n\t\ttypeof (state.logProcessor as { shutdown?: () => Promise<void> })\n\t\t\t.shutdown === 'function'\n\t) {\n\t\tpromises.push(\n\t\t\t(state.logProcessor as { shutdown: () => Promise<void> }).shutdown(),\n\t\t);\n\t\tstate.logProcessor = null;\n\t}\n\n\tstate.initialized = false;\n\tawait Promise.all(promises);\n}\n\n/**\n * Enable debug logging for telemetry\n */\nexport function enableTelemetryDebug(): void {\n\tdiag.setLogger(new DiagConsoleLogger(), DiagLogLevel.DEBUG);\n}\n\n/**\n * Wraps a handler function to ensure telemetry is flushed before returning.\n * Useful for Lambda handlers.\n *\n * @example\n * ```typescript\n * export const handler = withTelemetryFlush(async (event, context) => {\n *   // Your Lambda logic here\n *   return { statusCode: 200, body: 'OK' };\n * });\n * ```\n */\nexport function withTelemetryFlush<TEvent, TResult>(\n\thandler: (event: TEvent, context: unknown) => Promise<TResult>,\n): (event: TEvent, context: unknown) => Promise<TResult> {\n\treturn async (event: TEvent, context: unknown): Promise<TResult> => {\n\t\ttry {\n\t\t\treturn await handler(event, context);\n\t\t} finally {\n\t\t\tawait flushTelemetry();\n\t\t}\n\t};\n}\n\n/**\n * Noop span processor for testing or when telemetry is disabled\n */\nexport class NoopSpanProcessor implements SpanProcessor {\n\tforceFlush(): Promise<void> {\n\t\treturn Promise.resolve();\n\t}\n\n\tonStart(_span: Span): void {\n\t\t// noop\n\t}\n\n\tonEnd(_span: ReadableSpan): void {\n\t\t// noop\n\t}\n\n\tshutdown(): Promise<void> {\n\t\treturn Promise.resolve();\n\t}\n}\n"],"mappings":";;;AAuBA,MAAM,QAAwB;CAC7B,eAAe;CACf,cAAc;CACd,aAAa;AACd;;;;AAKA,SAAgB,oBACf,UACA,SACgB;CAChB,MAAM,EAAE,UAAU,GAAG,WAAW;CAEhC,IAAI,aAAa,UAChB,OAAO,IAAI,oBAAoB,QAAQ;CAGxC,OAAO,IAAI,mBAAmB,UAAU;EACvC,cAAc,OAAO,gBAAgB;EACrC,sBAAsB,OAAO,wBAAwB;EACrD,qBAAqB,OAAO,uBAAuB;EACnD,oBAAoB,OAAO,sBAAsB;CAClD,CAAC;AACF;;;;AAKA,SAAgB,uBACf,aACwB;CACxB,QAAQ,aAAR;EACC,KAAK;EACL,KAAK,QAEJ,OAAO;EACR,SAEC,OAAO;CACT;AACD;;;;AAKA,SAAgB,uBAAuB,WAAgC;CACtE,MAAM,gBAAgB;CACtB,MAAM,cAAc;AACrB;;;;AAKA,SAAgB,sBAAsB,WAA0B;CAC/D,MAAM,eAAe;AACtB;;;;AAKA,SAAgB,yBAAkC;CACjD,OAAO,MAAM;AACd;;;;;;;;;;;;;;;;;;;AAoBA,eAAsB,eAAe,YAAY,KAAsB;CACtE,MAAM,WAA4B,CAAC;CAGnC,IAAI,MAAM,eACT,SAAS,KACR,QAAQ,KAAK,CACZ,MAAM,cAAc,WAAW,GAC/B,IAAI,SAAe,GAAG,WACrB,iBAAiB,uBAAO,IAAI,MAAM,oBAAoB,CAAC,GAAG,SAAS,CACpE,CACD,CAAC,CAAC,CAAC,OAAO,UAAU;EACnB,IAAI,KAAK,OACR,KAAK,MAAM,qBAAqB,MAAM,SAAS;CAEjD,CAAC,CACF;CAID,IACC,MAAM,gBACN,OAAQ,MAAM,aACZ,eAAe,YAEjB,SAAS,KACR,QAAQ,KAAK,CAEX,MAAM,aACL,WAAW,GACb,IAAI,SAAe,GAAG,WACrB,iBAAiB,uBAAO,IAAI,MAAM,mBAAmB,CAAC,GAAG,SAAS,CACnE,CACD,CAAC,CAAC,CAAC,OAAO,UAAU;EACnB,IAAI,KAAK,OACR,KAAK,MAAM,oBAAoB,MAAM,SAAS;CAEhD,CAAC,CACF;CAGD,MAAM,QAAQ,IAAI,QAAQ;AAC3B;;;;AAKA,eAAsB,oBAAmC;CACxD,MAAM,WAA4B,CAAC;CAEnC,IAAI,MAAM,eAAe;EACxB,SAAS,KAAK,MAAM,cAAc,SAAS,CAAC;EAC5C,MAAM,gBAAgB;CACvB;CAEA,IACC,MAAM,gBACN,OAAQ,MAAM,aACZ,aAAa,YACd;EACD,SAAS,KACP,MAAM,aAAmD,SAAS,CACpE;EACA,MAAM,eAAe;CACtB;CAEA,MAAM,cAAc;CACpB,MAAM,QAAQ,IAAI,QAAQ;AAC3B;;;;AAKA,SAAgB,uBAA6B;CAC5C,KAAK,UAAU,IAAI,kBAAkB,GAAG,aAAa,KAAK;AAC3D;;;;;;;;;;;;;AAcA,SAAgB,mBACf,SACwD;CACxD,OAAO,OAAO,OAAe,YAAuC;EACnE,IAAI;GACH,OAAO,MAAM,QAAQ,OAAO,OAAO;EACpC,UAAU;GACT,MAAM,eAAe;EACtB;CACD;AACD;;;;AAKA,IAAa,oBAAb,MAAwD;CACvD,aAA4B;EAC3B,OAAO,QAAQ,QAAQ;CACxB;CAEA,QAAQ,OAAmB,CAE3B;CAEA,MAAM,OAA2B,CAEjC;CAEA,WAA0B;EACzB,OAAO,QAAQ,QAAQ;CACxB;AACD"}

package/dist/instrumentation/hono.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"hono.cjs","names":["incomingTraceContext","createHttpServerSpan","trace","context","isTrustedOrigin","isInternalCaller","routePath"],"sources":["../../src/instrumentation/hono.ts"],"sourcesContent":["import { context, type Span, trace } from '@opentelemetry/api';\n/**\n * OpenTelemetry instrumentation middleware for Hono\n *\n * This middleware automatically creates spans for HTTP requests,\n * extracts trace context from incoming headers, and records\n * request/response metadata as span attributes.\n */\nimport type { Context, MiddlewareHandler } from 'hono';\nimport { routePath } from 'hono/route';\nimport {\n\tcreateHttpServerSpan,\n\tendHttpSpan,\n\ttype HttpSpanAttributes,\n\tincomingTraceContext,\n} from './http';\nimport { isInternalCaller, isTrustedOrigin } from './trust';\n\n/**\n * Options for the Hono telemetry middleware\n */\nexport interface HonoTelemetryMiddlewareOptions {\n\t/**\n\t * Whether to record request body as span attribute\n\t * @default false\n\t */\n\trecordBody?: boolean;\n\n\t/**\n\t * Whether to record response body as span attribute\n\t * @default false\n\t */\n\trecordResponseBody?: boolean;\n\n\t/**\n\t * Custom function to extract user ID from context\n\t */\n\tgetUserId?: (c: Context) => string | undefined;\n\n\t/**\n\t * Paths to skip tracing (supports wildcards)\n\t */\n\tignorePaths?: string[];\n\n\t/**\n\t * Whether to skip tracing for this request\n\t */\n\tshouldSkip?: (c: Context) => boolean;\n\n\t/**\n\t * The origins whose `traceparent` is continued: the API's own sites, the\n\t * same list its CORS allows. A request from any other origin starts a new\n\t * trace linked to the one it claimed.\n\t *\n\t * A function is read on each request, for a server that learns its origins\n\t * only once the app has loaded its configuration.\n\t */\n\ttrustedOrigins?: readonly string[] | (() => readonly string[] | undefined);\n\n\t/**\n\t * Whether a request with no `Origin` from an internal caller continues its\n\t * `traceparent` — another service on the private network (see `./trust`):\n\t * no `Origin`, no proxy's forwarding header, and a loopback or private\n\t * peer address, read from `@hono/node-server`'s socket.\n\t *\n\t * `false` trusts no caller without an origin; a function decides itself.\n\t * @default true\n\t */\n\tinternalCallers?: boolean | ((c: Context) => boolean);\n}\n\n// Key for storing span on context\nconst SPAN_KEY = 'telemetry.span';\nconst CONTEXT_KEY = 'telemetry.context';\n\n/**\n * Get the current span from Hono context\n */\nexport function getSpanFromContext(c: Context): Span | undefined {\n\treturn c.get(SPAN_KEY);\n}\n\n/**\n * Get the current trace context from Hono context\n */\nexport function getTraceContextFromHono(c: Context): any {\n\treturn c.get(CONTEXT_KEY);\n}\n\n/**\n * Create a telemetry middleware for Hono applications\n *\n * @example\n * ```typescript\n * import { honoTelemetryMiddleware } from '@geekmidas/telescope/instrumentation';\n *\n * const app = new Hono();\n * app.use('*', honoTelemetryMiddleware());\n * ```\n */\nexport function honoTelemetryMiddleware(\n\toptions: HonoTelemetryMiddlewareOptions = {},\n): MiddlewareHandler {\n\treturn async (c, next) => {\n\t\t// Check if path should be ignored\n\t\tif (\n\t\t\toptions.ignorePaths &&\n\t\t\tshouldIgnorePath(c.req.path, options.ignorePaths)\n\t\t) {\n\t\t\treturn next();\n\t\t}\n\n\t\t// Skip if custom skip function returns true\n\t\tif (options.shouldSkip?.(c)) {\n\t\t\treturn next();\n\t\t}\n\n\t\t// Extract trace context from headers\n\t\tconst headers: Record<string, string | string[] | undefined> = {};\n\t\tc.req.raw.headers.forEach((value, key) => {\n\t\t\theaders[key] = value;\n\t\t});\n\t\t// Continued only from a trusted caller; anyone else gets a new trace\n\t\t// that links to the one they claimed.\n\t\tconst { parent: parentContext, links } = incomingTraceContext(\n\t\t\theaders,\n\t\t\tisTrustedCaller(c, options),\n\t\t);\n\n\t\t// Build span attributes from request\n\t\tconst attrs = buildHonoSpanAttributes(c, options);\n\n\t\t// Create the span\n\t\tconst span = createHttpServerSpan(attrs, parentContext, links);\n\t\tconst spanContext = trace.setSpan(parentContext, span);\n\n\t\t// Store span and context on Hono context\n\t\tc.set(SPAN_KEY, span);\n\t\tc.set(CONTEXT_KEY, spanContext);\n\n\t\t// Record body if requested\n\t\tif (options.recordBody) {\n\t\t\ttry {\n\t\t\t\tconst body = await c.req.text();\n\t\t\t\tif (body) {\n\t\t\t\t\tspan.setAttribute(\n\t\t\t\t\t\t'http.request.body',\n\t\t\t\t\t\tbody.length > 4096 ? `${body.slice(0, 4096)}...` : body,\n\t\t\t\t\t);\n\t\t\t\t}\n\t\t\t} catch {\n\t\t\t\t// Body may have already been consumed\n\t\t\t}\n\t\t}\n\n\t\ttry {\n\t\t\t// Execute the rest of the middleware chain within span context, so\n\t\t\t// the handler's logs and outbound spans nest under this one.\n\t\t\tawait context.with(spanContext, async () => {\n\t\t\t\tawait next();\n\t\t\t});\n\n\t\t\tnameAfterRoute(c, span);\n\n\t\t\t// Record response\n\t\t\tconst statusCode = c.res.status;\n\n\t\t\tif (options.recordResponseBody) {\n\t\t\t\ttry {\n\t\t\t\t\tconst body = await c.res.clone().text();\n\t\t\t\t\tif (body) {\n\t\t\t\t\t\tspan.setAttribute(\n\t\t\t\t\t\t\t'http.response.body',\n\t\t\t\t\t\t\tbody.length > 4096 ? `${body.slice(0, 4096)}...` : body,\n\t\t\t\t\t\t);\n\t\t\t\t\t}\n\t\t\t\t} catch {\n\t\t\t\t\t// Response body may not be available\n\t\t\t\t}\n\t\t\t}\n\n\t\t\t// Hono hands a thrown error to `onError` and sets `c.error`\n\t\t\t// rather than rethrowing, so that is where it is found.\n\t\t\tendHttpSpan(span, { statusCode }, c.error);\n\t\t} catch (error) {\n\t\t\tnameAfterRoute(c, span);\n\t\t\tendHttpSpan(\n\t\t\t\tspan,\n\t\t\t\t{ statusCode: 500 },\n\t\t\t\terror instanceof Error ? error : new Error(String(error)),\n\t\t\t);\n\t\t\tthrow error;\n\t\t}\n\t};\n}\n\n/**\n * Whether this request's `traceparent` is continued: from one of the API's\n * own origins, or from an internal caller.\n */\nfunction isTrustedCaller(\n\tc: Context,\n\toptions: HonoTelemetryMiddlewareOptions,\n): boolean {\n\tconst origin = c.req.header('origin');\n\tif (origin) {\n\t\tconst trusted =\n\t\t\ttypeof options.trustedOrigins === 'function'\n\t\t\t\t? options.trustedOrigins()\n\t\t\t\t: options.trustedOrigins;\n\t\treturn isTrustedOrigin(origin, trusted);\n\t}\n\n\tconst internal = options.internalCallers ?? true;\n\tif (typeof internal === 'function') return internal(c);\n\tif (!internal) return false;\n\treturn isInternalCaller({\n\t\theaders: c.req.raw.headers,\n\t\tremoteAddress: remoteAddressOf(c),\n\t});\n}\n\n/** The TCP peer's address under `@hono/node-server`, or undefined. */\nfunction remoteAddressOf(c: Context): string | undefined {\n\tconst env = c.env as\n\t\t| { incoming?: { socket?: { remoteAddress?: string } } }\n\t\t| undefined;\n\treturn env?.incoming?.socket?.remoteAddress;\n}\n\n/**\n * The route the request matched, once the handler has run — `/users/:id`,\n * never `/users/42` — or undefined when only middleware ran (a 404).\n *\n * Read after `next()`: before it, the route is this middleware's own `*`.\n */\nfunction matchedRoute(c: Context): string | undefined {\n\tconst path = routePath(c);\n\treturn path && !path.includes('*') ? path : undefined;\n}\n\n/** `GET /users/:id`, or the bare method when no route matched. */\nfunction nameAfterRoute(c: Context, span: Span): void {\n\tconst route = matchedRoute(c);\n\tif (route) {\n\t\tspan.setAttribute('http.route', route);\n\t\tspan.updateName(`${c.req.method} ${route}`);\n\t} else {\n\t\tspan.updateName(c.req.method);\n\t}\n}\n\n/**\n * Build span attributes from Hono context\n */\nfunction buildHonoSpanAttributes(\n\tc: Context,\n\toptions: HonoTelemetryMiddlewareOptions,\n): HttpSpanAttributes {\n\tconst req = c.req;\n\tconst url = new URL(req.url);\n\n\t// No `url.full`: a query string can carry a token, and the span would\n\t// keep it. The route is named once the handler has run.\n\tconst attrs: HttpSpanAttributes = {\n\t\tmethod: req.method,\n\t\tpath: url.pathname,\n\t\thost: url.host,\n\t\tscheme: url.protocol.replace(':', '') as 'http' | 'https',\n\t\tuserAgent: req.header('user-agent'),\n\t\tclientIp: getClientIp(c),\n\t\trequestId: req.header('x-request-id') || req.header('x-amzn-requestid'),\n\t};\n\n\t// Add user metadata if extractor provided\n\tif (options.getUserId) {\n\t\tconst userId = options.getUserId(c);\n\t\tif (userId) {\n\t\t\tattrs.user = { userId };\n\t\t}\n\t}\n\n\treturn attrs;\n}\n\n/**\n * Extract client IP from Hono context\n */\nfunction getClientIp(c: Context): string | undefined {\n\t// Try various headers in order of preference\n\tconst xForwardedFor = c.req.header('x-forwarded-for');\n\tif (xForwardedFor) {\n\t\tconst first = xForwardedFor.split(',')[0];\n\t\treturn first?.trim();\n\t}\n\n\tconst xRealIp = c.req.header('x-real-ip');\n\tif (xRealIp) {\n\t\treturn xRealIp;\n\t}\n\n\t// Try CF-Connecting-IP (Cloudflare)\n\tconst cfConnectingIp = c.req.header('cf-connecting-ip');\n\tif (cfConnectingIp) {\n\t\treturn cfConnectingIp;\n\t}\n\n\treturn undefined;\n}\n\n/**\n * Check if path should be ignored\n */\nfunction shouldIgnorePath(path: string, ignorePaths: string[]): boolean {\n\tfor (const pattern of ignorePaths) {\n\t\tif (pattern.endsWith('*')) {\n\t\t\t// Wildcard match\n\t\t\tconst prefix = pattern.slice(0, -1);\n\t\t\tif (path.startsWith(prefix)) {\n\t\t\t\treturn true;\n\t\t\t}\n\t\t} else if (path === pattern) {\n\t\t\t// Exact match\n\t\t\treturn true;\n\t\t}\n\t}\n\treturn false;\n}\n\n/**\n * Run a function within the span context from Hono context\n *\n * @example\n * ```typescript\n * app.get('/api/users', async (c) => {\n *   return withHonoSpanContext(c, async () => {\n *     // Any spans created here will be children of the request span\n *     const users = await fetchUsers();\n *     return c.json(users);\n *   });\n * });\n * ```\n */\nexport async function withHonoSpanContext<T>(\n\tc: Context,\n\tfn: () => Promise<T>,\n): Promise<T> {\n\tconst ctx = getTraceContextFromHono(c);\n\tif (!ctx) {\n\t\treturn fn();\n\t}\n\treturn context.with(ctx, fn);\n}\n"],"mappings":"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"}

package/dist/instrumentation/hono.d.cts.map

@@ -1 +0,0 @@
-{"version":3,"file":"hono.d.cts","names":[],"sources":["../../src/instrumentation/hono.ts"],"mappings":";;;;;;iBAqBiB;;;;;EAKhB;;;;;EAMA;;;;EAKA,aAAa,GAAG;;;;EAKhB;;;;EAKA,cAAc,GAAG;;;;;;;;;EAUjB;;;;;;;;;;EAWA,8BAA8B,GAAG;;;;;wBAUlB,mBAAmB,GAAG,UAAU;;;;wBAOhC,wBAAwB,GAAG;;;;;;;;;;;;wBAe3B,wBACf,UAAS,iCACP;;;;;;;;;;;;;;;wBAiPmB,oBAAoB,GACzC,GAAG,SACH,UAAU,QAAQ,KAChB,QAAQ"}

package/dist/instrumentation/hono.d.mts.map

@@ -1 +0,0 @@
-{"version":3,"file":"hono.d.mts","names":["Context"],"sources":["../../src/instrumentation/hono.ts"],"mappings":";;;;;;iBAqBiB;;;;;EAKhB;;;;;EAMA;;;;EAKA,aAAa,GAAGA;;;;EAKhB;;;;EAKA,cAAc,GAAGA;;;;;;;;;EAUjB;;;;;;;;;;EAWA,8BAA8B,GAAGA;;;;;wBAUlB,mBAAmB,GAAGA,YAAU;;;;wBAOhC,wBAAwB,GAAGA;;;;;;;;;;;;wBAe3B,wBACf,UAAS,iCACP;;;;;;;;;;;;;;;wBAiPmB,oBAAoB,GACzC,GAAGA,WACH,UAAU,QAAQ,KAChB,QAAQ"}

package/dist/instrumentation/hono.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"hono.mjs","names":[],"sources":["../../src/instrumentation/hono.ts"],"sourcesContent":["import { context, type Span, trace } from '@opentelemetry/api';\n/**\n * OpenTelemetry instrumentation middleware for Hono\n *\n * This middleware automatically creates spans for HTTP requests,\n * extracts trace context from incoming headers, and records\n * request/response metadata as span attributes.\n */\nimport type { Context, MiddlewareHandler } from 'hono';\nimport { routePath } from 'hono/route';\nimport {\n\tcreateHttpServerSpan,\n\tendHttpSpan,\n\ttype HttpSpanAttributes,\n\tincomingTraceContext,\n} from './http';\nimport { isInternalCaller, isTrustedOrigin } from './trust';\n\n/**\n * Options for the Hono telemetry middleware\n */\nexport interface HonoTelemetryMiddlewareOptions {\n\t/**\n\t * Whether to record request body as span attribute\n\t * @default false\n\t */\n\trecordBody?: boolean;\n\n\t/**\n\t * Whether to record response body as span attribute\n\t * @default false\n\t */\n\trecordResponseBody?: boolean;\n\n\t/**\n\t * Custom function to extract user ID from context\n\t */\n\tgetUserId?: (c: Context) => string | undefined;\n\n\t/**\n\t * Paths to skip tracing (supports wildcards)\n\t */\n\tignorePaths?: string[];\n\n\t/**\n\t * Whether to skip tracing for this request\n\t */\n\tshouldSkip?: (c: Context) => boolean;\n\n\t/**\n\t * The origins whose `traceparent` is continued: the API's own sites, the\n\t * same list its CORS allows. A request from any other origin starts a new\n\t * trace linked to the one it claimed.\n\t *\n\t * A function is read on each request, for a server that learns its origins\n\t * only once the app has loaded its configuration.\n\t */\n\ttrustedOrigins?: readonly string[] | (() => readonly string[] | undefined);\n\n\t/**\n\t * Whether a request with no `Origin` from an internal caller continues its\n\t * `traceparent` — another service on the private network (see `./trust`):\n\t * no `Origin`, no proxy's forwarding header, and a loopback or private\n\t * peer address, read from `@hono/node-server`'s socket.\n\t *\n\t * `false` trusts no caller without an origin; a function decides itself.\n\t * @default true\n\t */\n\tinternalCallers?: boolean | ((c: Context) => boolean);\n}\n\n// Key for storing span on context\nconst SPAN_KEY = 'telemetry.span';\nconst CONTEXT_KEY = 'telemetry.context';\n\n/**\n * Get the current span from Hono context\n */\nexport function getSpanFromContext(c: Context): Span | undefined {\n\treturn c.get(SPAN_KEY);\n}\n\n/**\n * Get the current trace context from Hono context\n */\nexport function getTraceContextFromHono(c: Context): any {\n\treturn c.get(CONTEXT_KEY);\n}\n\n/**\n * Create a telemetry middleware for Hono applications\n *\n * @example\n * ```typescript\n * import { honoTelemetryMiddleware } from '@geekmidas/telescope/instrumentation';\n *\n * const app = new Hono();\n * app.use('*', honoTelemetryMiddleware());\n * ```\n */\nexport function honoTelemetryMiddleware(\n\toptions: HonoTelemetryMiddlewareOptions = {},\n): MiddlewareHandler {\n\treturn async (c, next) => {\n\t\t// Check if path should be ignored\n\t\tif (\n\t\t\toptions.ignorePaths &&\n\t\t\tshouldIgnorePath(c.req.path, options.ignorePaths)\n\t\t) {\n\t\t\treturn next();\n\t\t}\n\n\t\t// Skip if custom skip function returns true\n\t\tif (options.shouldSkip?.(c)) {\n\t\t\treturn next();\n\t\t}\n\n\t\t// Extract trace context from headers\n\t\tconst headers: Record<string, string | string[] | undefined> = {};\n\t\tc.req.raw.headers.forEach((value, key) => {\n\t\t\theaders[key] = value;\n\t\t});\n\t\t// Continued only from a trusted caller; anyone else gets a new trace\n\t\t// that links to the one they claimed.\n\t\tconst { parent: parentContext, links } = incomingTraceContext(\n\t\t\theaders,\n\t\t\tisTrustedCaller(c, options),\n\t\t);\n\n\t\t// Build span attributes from request\n\t\tconst attrs = buildHonoSpanAttributes(c, options);\n\n\t\t// Create the span\n\t\tconst span = createHttpServerSpan(attrs, parentContext, links);\n\t\tconst spanContext = trace.setSpan(parentContext, span);\n\n\t\t// Store span and context on Hono context\n\t\tc.set(SPAN_KEY, span);\n\t\tc.set(CONTEXT_KEY, spanContext);\n\n\t\t// Record body if requested\n\t\tif (options.recordBody) {\n\t\t\ttry {\n\t\t\t\tconst body = await c.req.text();\n\t\t\t\tif (body) {\n\t\t\t\t\tspan.setAttribute(\n\t\t\t\t\t\t'http.request.body',\n\t\t\t\t\t\tbody.length > 4096 ? `${body.slice(0, 4096)}...` : body,\n\t\t\t\t\t);\n\t\t\t\t}\n\t\t\t} catch {\n\t\t\t\t// Body may have already been consumed\n\t\t\t}\n\t\t}\n\n\t\ttry {\n\t\t\t// Execute the rest of the middleware chain within span context, so\n\t\t\t// the handler's logs and outbound spans nest under this one.\n\t\t\tawait context.with(spanContext, async () => {\n\t\t\t\tawait next();\n\t\t\t});\n\n\t\t\tnameAfterRoute(c, span);\n\n\t\t\t// Record response\n\t\t\tconst statusCode = c.res.status;\n\n\t\t\tif (options.recordResponseBody) {\n\t\t\t\ttry {\n\t\t\t\t\tconst body = await c.res.clone().text();\n\t\t\t\t\tif (body) {\n\t\t\t\t\t\tspan.setAttribute(\n\t\t\t\t\t\t\t'http.response.body',\n\t\t\t\t\t\t\tbody.length > 4096 ? `${body.slice(0, 4096)}...` : body,\n\t\t\t\t\t\t);\n\t\t\t\t\t}\n\t\t\t\t} catch {\n\t\t\t\t\t// Response body may not be available\n\t\t\t\t}\n\t\t\t}\n\n\t\t\t// Hono hands a thrown error to `onError` and sets `c.error`\n\t\t\t// rather than rethrowing, so that is where it is found.\n\t\t\tendHttpSpan(span, { statusCode }, c.error);\n\t\t} catch (error) {\n\t\t\tnameAfterRoute(c, span);\n\t\t\tendHttpSpan(\n\t\t\t\tspan,\n\t\t\t\t{ statusCode: 500 },\n\t\t\t\terror instanceof Error ? error : new Error(String(error)),\n\t\t\t);\n\t\t\tthrow error;\n\t\t}\n\t};\n}\n\n/**\n * Whether this request's `traceparent` is continued: from one of the API's\n * own origins, or from an internal caller.\n */\nfunction isTrustedCaller(\n\tc: Context,\n\toptions: HonoTelemetryMiddlewareOptions,\n): boolean {\n\tconst origin = c.req.header('origin');\n\tif (origin) {\n\t\tconst trusted =\n\t\t\ttypeof options.trustedOrigins === 'function'\n\t\t\t\t? options.trustedOrigins()\n\t\t\t\t: options.trustedOrigins;\n\t\treturn isTrustedOrigin(origin, trusted);\n\t}\n\n\tconst internal = options.internalCallers ?? true;\n\tif (typeof internal === 'function') return internal(c);\n\tif (!internal) return false;\n\treturn isInternalCaller({\n\t\theaders: c.req.raw.headers,\n\t\tremoteAddress: remoteAddressOf(c),\n\t});\n}\n\n/** The TCP peer's address under `@hono/node-server`, or undefined. */\nfunction remoteAddressOf(c: Context): string | undefined {\n\tconst env = c.env as\n\t\t| { incoming?: { socket?: { remoteAddress?: string } } }\n\t\t| undefined;\n\treturn env?.incoming?.socket?.remoteAddress;\n}\n\n/**\n * The route the request matched, once the handler has run — `/users/:id`,\n * never `/users/42` — or undefined when only middleware ran (a 404).\n *\n * Read after `next()`: before it, the route is this middleware's own `*`.\n */\nfunction matchedRoute(c: Context): string | undefined {\n\tconst path = routePath(c);\n\treturn path && !path.includes('*') ? path : undefined;\n}\n\n/** `GET /users/:id`, or the bare method when no route matched. */\nfunction nameAfterRoute(c: Context, span: Span): void {\n\tconst route = matchedRoute(c);\n\tif (route) {\n\t\tspan.setAttribute('http.route', route);\n\t\tspan.updateName(`${c.req.method} ${route}`);\n\t} else {\n\t\tspan.updateName(c.req.method);\n\t}\n}\n\n/**\n * Build span attributes from Hono context\n */\nfunction buildHonoSpanAttributes(\n\tc: Context,\n\toptions: HonoTelemetryMiddlewareOptions,\n): HttpSpanAttributes {\n\tconst req = c.req;\n\tconst url = new URL(req.url);\n\n\t// No `url.full`: a query string can carry a token, and the span would\n\t// keep it. The route is named once the handler has run.\n\tconst attrs: HttpSpanAttributes = {\n\t\tmethod: req.method,\n\t\tpath: url.pathname,\n\t\thost: url.host,\n\t\tscheme: url.protocol.replace(':', '') as 'http' | 'https',\n\t\tuserAgent: req.header('user-agent'),\n\t\tclientIp: getClientIp(c),\n\t\trequestId: req.header('x-request-id') || req.header('x-amzn-requestid'),\n\t};\n\n\t// Add user metadata if extractor provided\n\tif (options.getUserId) {\n\t\tconst userId = options.getUserId(c);\n\t\tif (userId) {\n\t\t\tattrs.user = { userId };\n\t\t}\n\t}\n\n\treturn attrs;\n}\n\n/**\n * Extract client IP from Hono context\n */\nfunction getClientIp(c: Context): string | undefined {\n\t// Try various headers in order of preference\n\tconst xForwardedFor = c.req.header('x-forwarded-for');\n\tif (xForwardedFor) {\n\t\tconst first = xForwardedFor.split(',')[0];\n\t\treturn first?.trim();\n\t}\n\n\tconst xRealIp = c.req.header('x-real-ip');\n\tif (xRealIp) {\n\t\treturn xRealIp;\n\t}\n\n\t// Try CF-Connecting-IP (Cloudflare)\n\tconst cfConnectingIp = c.req.header('cf-connecting-ip');\n\tif (cfConnectingIp) {\n\t\treturn cfConnectingIp;\n\t}\n\n\treturn undefined;\n}\n\n/**\n * Check if path should be ignored\n */\nfunction shouldIgnorePath(path: string, ignorePaths: string[]): boolean {\n\tfor (const pattern of ignorePaths) {\n\t\tif (pattern.endsWith('*')) {\n\t\t\t// Wildcard match\n\t\t\tconst prefix = pattern.slice(0, -1);\n\t\t\tif (path.startsWith(prefix)) {\n\t\t\t\treturn true;\n\t\t\t}\n\t\t} else if (path === pattern) {\n\t\t\t// Exact match\n\t\t\treturn true;\n\t\t}\n\t}\n\treturn false;\n}\n\n/**\n * Run a function within the span context from Hono context\n *\n * @example\n * ```typescript\n * app.get('/api/users', async (c) => {\n *   return withHonoSpanContext(c, async () => {\n *     // Any spans created here will be children of the request span\n *     const users = await fetchUsers();\n *     return c.json(users);\n *   });\n * });\n * ```\n */\nexport async function withHonoSpanContext<T>(\n\tc: Context,\n\tfn: () => Promise<T>,\n): Promise<T> {\n\tconst ctx = getTraceContextFromHono(c);\n\tif (!ctx) {\n\t\treturn fn();\n\t}\n\treturn context.with(ctx, fn);\n}\n"],"mappings":"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"}

package/dist/instrumentation/http.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"http.cjs","names":["trace","propagation","context","isSpanContextValid","SpanKind","SpanStatusCode"],"sources":["../../src/instrumentation/http.ts"],"sourcesContent":["import {\n\ttype Attributes,\n\ttype Context,\n\tcontext,\n\tisSpanContextValid,\n\ttype Link,\n\tpropagation,\n\ttype Span,\n\tSpanKind,\n\tSpanStatusCode,\n\ttrace,\n} from '@opentelemetry/api';\n\n/**\n * HTTP request attributes following OpenTelemetry semantic conventions\n */\nexport interface HttpRequestAttributes {\n\tmethod: string;\n\turl?: string;\n\tpath?: string;\n\troute?: string;\n\thost?: string;\n\tscheme?: 'http' | 'https';\n\tuserAgent?: string;\n\tclientIp?: string;\n\trequestId?: string;\n}\n\n/**\n * HTTP response attributes\n */\nexport interface HttpResponseAttributes {\n\tstatusCode: number;\n\tresponseSize?: number;\n}\n\n/**\n * Endpoint-specific attributes\n */\nexport interface EndpointAttributes {\n\tname?: string;\n\toperationId?: string;\n\ttags?: string[];\n}\n\n/**\n * User/session attributes\n */\nexport interface UserAttributes {\n\tuserId?: string;\n\tsessionId?: string;\n\troles?: string[];\n}\n\n/**\n * Full span attributes for HTTP requests\n */\nexport interface HttpSpanAttributes extends HttpRequestAttributes {\n\tresponse?: HttpResponseAttributes;\n\tendpoint?: EndpointAttributes;\n\tuser?: UserAttributes;\n\tcustom?: Attributes;\n}\n\nconst TRACER_NAME = '@geekmidas/constructs';\n\n/**\n * Get or create a tracer for constructs instrumentation\n */\nexport function getConstructsTracer() {\n\treturn trace.getTracer(TRACER_NAME);\n}\n\n/**\n * Convert HTTP attributes to OpenTelemetry semantic conventions\n */\nexport function toOtelAttributes(attrs: HttpSpanAttributes): Attributes {\n\tconst otelAttrs: Attributes = {};\n\n\t// HTTP request attributes (OpenTelemetry semantic conventions)\n\tif (attrs.method) otelAttrs['http.request.method'] = attrs.method;\n\tif (attrs.url) otelAttrs['url.full'] = attrs.url;\n\tif (attrs.path) otelAttrs['url.path'] = attrs.path;\n\tif (attrs.route) otelAttrs['http.route'] = attrs.route;\n\tif (attrs.host) otelAttrs['server.address'] = attrs.host;\n\tif (attrs.scheme) otelAttrs['url.scheme'] = attrs.scheme;\n\tif (attrs.userAgent) otelAttrs['user_agent.original'] = attrs.userAgent;\n\tif (attrs.clientIp) otelAttrs['client.address'] = attrs.clientIp;\n\tif (attrs.requestId) otelAttrs['http.request.id'] = attrs.requestId;\n\n\t// HTTP response attributes\n\tif (attrs.response?.statusCode) {\n\t\totelAttrs['http.response.status_code'] = attrs.response.statusCode;\n\t}\n\tif (attrs.response?.responseSize) {\n\t\totelAttrs['http.response.body.size'] = attrs.response.responseSize;\n\t}\n\n\t// Endpoint attributes\n\tif (attrs.endpoint?.name) otelAttrs['endpoint.name'] = attrs.endpoint.name;\n\tif (attrs.endpoint?.operationId) {\n\t\totelAttrs['endpoint.operation_id'] = attrs.endpoint.operationId;\n\t}\n\tif (attrs.endpoint?.tags?.length) {\n\t\totelAttrs['endpoint.tags'] = attrs.endpoint.tags;\n\t}\n\n\t// User attributes\n\tif (attrs.user?.userId) otelAttrs['enduser.id'] = attrs.user.userId;\n\tif (attrs.user?.sessionId) otelAttrs['session.id'] = attrs.user.sessionId;\n\tif (attrs.user?.roles?.length)\n\t\totelAttrs['enduser.role'] = attrs.user.roles.join(',');\n\n\t// Custom attributes\n\tif (attrs.custom) {\n\t\tObject.assign(otelAttrs, attrs.custom);\n\t}\n\n\treturn otelAttrs;\n}\n\n/**\n * Extract trace context from HTTP headers\n */\nexport function extractTraceContext(\n\theaders: Record<string, string | string[] | undefined>,\n): Context {\n\t// Normalize headers to Record<string, string>\n\tconst normalizedHeaders: Record<string, string> = {};\n\tfor (const [key, value] of Object.entries(headers)) {\n\t\tif (value) {\n\t\t\tconst stringValue = Array.isArray(value) ? value[0] : value;\n\t\t\tif (stringValue) {\n\t\t\t\tnormalizedHeaders[key.toLowerCase()] = stringValue;\n\t\t\t}\n\t\t}\n\t}\n\n\treturn propagation.extract(context.active(), normalizedHeaders);\n}\n\n/** Where a request's span goes: under a parent, or a new root with links. */\nexport interface IncomingTraceContext {\n\t/** The context the request span starts in. */\n\tparent: Context;\n\t/** The untrusted caller's context, linked rather than continued. */\n\tlinks: Link[];\n}\n\n/**\n * The trace a request's span belongs to.\n *\n * From a trusted caller (see `./trust`) its `traceparent` is continued, and\n * the span is its child. From anyone else the span starts a new trace — no\n * parent, no baggage — with a link to the context the caller claimed, so the\n * hop can still be followed without the caller choosing this trace.\n */\nexport function incomingTraceContext(\n\theaders: Record<string, string | string[] | undefined>,\n\ttrusted: boolean,\n): IncomingTraceContext {\n\tconst extracted = extractTraceContext(headers);\n\tif (trusted) return { parent: extracted, links: [] };\n\n\tconst claimed = trace.getSpanContext(extracted);\n\treturn {\n\t\tparent: trace.deleteSpan(context.active()),\n\t\tlinks:\n\t\t\tclaimed && isSpanContextValid(claimed)\n\t\t\t\t? [\n\t\t\t\t\t\t{\n\t\t\t\t\t\t\tcontext: claimed,\n\t\t\t\t\t\t\tattributes: { 'gkm.trace.untrusted_parent': true },\n\t\t\t\t\t\t},\n\t\t\t\t\t]\n\t\t\t\t: [],\n\t};\n}\n\n/**\n * Inject trace context into HTTP headers\n */\nexport function injectTraceContext(\n\theaders: Record<string, string>,\n\tctx?: Context,\n): Record<string, string> {\n\tconst result = { ...headers };\n\tpropagation.inject(ctx ?? context.active(), result);\n\treturn result;\n}\n\n/**\n * Create an HTTP server span for an incoming request\n */\nexport function createHttpServerSpan(\n\tattrs: HttpSpanAttributes,\n\tparentContext?: Context,\n\tlinks?: Link[],\n): Span {\n\tconst tracer = getConstructsTracer();\n\tconst spanName = attrs.route\n\t\t? `${attrs.method} ${attrs.route}`\n\t\t: `${attrs.method} ${attrs.path || '/'}`;\n\n\tconst ctx = parentContext ?? context.active();\n\n\treturn tracer.startSpan(\n\t\tspanName,\n\t\t{\n\t\t\tkind: SpanKind.SERVER,\n\t\t\tattributes: toOtelAttributes(attrs),\n\t\t\t...(links?.length ? { links } : {}),\n\t\t},\n\t\tctx,\n\t);\n}\n\n/**\n * End an HTTP span with response data\n */\nexport function endHttpSpan(\n\tspan: Span,\n\tresponse: HttpResponseAttributes,\n\terror?: Error,\n): void {\n\tspan.setAttribute('http.response.status_code', response.statusCode);\n\n\tif (response.responseSize) {\n\t\tspan.setAttribute('http.response.body.size', response.responseSize);\n\t}\n\n\tif (error) {\n\t\tspan.recordException(error);\n\t\tspan.setStatus({\n\t\t\tcode: SpanStatusCode.ERROR,\n\t\t\tmessage: error.message,\n\t\t});\n\t} else if (response.statusCode >= 500) {\n\t\tspan.setStatus({\n\t\t\tcode: SpanStatusCode.ERROR,\n\t\t\tmessage: `HTTP ${response.statusCode}`,\n\t\t});\n\t} else if (response.statusCode < 400) {\n\t\tspan.setStatus({ code: SpanStatusCode.OK });\n\t}\n\t// A 4xx leaves the status unset: on a server span it is the client's\n\t// mistake, not the server's failure (HTTP semantic conventions).\n\n\tspan.end();\n}\n\n/**\n * Execute a function within an HTTP server span context\n *\n * @example\n * ```typescript\n * const result = await withHttpSpan(\n *   { method: 'GET', path: '/users', route: '/users' },\n *   async (span) => {\n *     const users = await getUsers();\n *     return { statusCode: 200, body: users };\n *   }\n * );\n * ```\n */\nexport async function withHttpSpan<T>(\n\tattrs: HttpSpanAttributes,\n\tfn: (span: Span) => Promise<T & { statusCode?: number }>,\n\tparentContext?: Context,\n): Promise<T> {\n\tconst span = createHttpServerSpan(attrs, parentContext);\n\n\ttry {\n\t\tconst result = await context.with(\n\t\t\ttrace.setSpan(parentContext ?? context.active(), span),\n\t\t\t() => fn(span),\n\t\t);\n\n\t\tconst statusCode = (result as { statusCode?: number }).statusCode ?? 200;\n\t\tendHttpSpan(span, { statusCode });\n\n\t\treturn result;\n\t} catch (error) {\n\t\tendHttpSpan(\n\t\t\tspan,\n\t\t\t{ statusCode: 500 },\n\t\t\terror instanceof Error ? error : new Error(String(error)),\n\t\t);\n\t\tthrow error;\n\t}\n}\n\n/**\n * Create a child span for internal operations (middleware, handlers, etc.)\n */\nexport function createChildSpan(name: string, attributes?: Attributes): Span {\n\tconst tracer = getConstructsTracer();\n\treturn tracer.startSpan(name, {\n\t\tkind: SpanKind.INTERNAL,\n\t\tattributes,\n\t});\n}\n\n/**\n * Execute a function within a child span\n */\nexport async function withChildSpan<T>(\n\tname: string,\n\tfn: (span: Span) => Promise<T>,\n\tattributes?: Attributes,\n): Promise<T> {\n\tconst span = createChildSpan(name, attributes);\n\n\ttry {\n\t\tconst result = await context.with(\n\t\t\ttrace.setSpan(context.active(), span),\n\t\t\t() => fn(span),\n\t\t);\n\t\tspan.setStatus({ code: SpanStatusCode.OK });\n\t\treturn result;\n\t} catch (error) {\n\t\tspan.setStatus({\n\t\t\tcode: SpanStatusCode.ERROR,\n\t\t\tmessage: error instanceof Error ? error.message : 'Unknown error',\n\t\t});\n\t\tspan.recordException(\n\t\t\terror instanceof Error ? error : new Error(String(error)),\n\t\t);\n\t\tthrow error;\n\t} finally {\n\t\tspan.end();\n\t}\n}\n\n/**\n * Check if tracing is enabled (OpenTelemetry API is available and configured)\n */\nexport function isTracingEnabled(): boolean {\n\ttry {\n\t\tconst tracer = trace.getTracer(TRACER_NAME);\n\t\t// Check if we have a real tracer (not a no-op)\n\t\tconst span = tracer.startSpan('test');\n\t\tconst isReal =\n\t\t\tspan.spanContext().traceId !== '00000000000000000000000000000000';\n\t\tspan.end();\n\t\treturn isReal;\n\t} catch {\n\t\treturn false;\n\t}\n}\n"],"mappings":"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"}

package/dist/instrumentation/http.d.cts.map

@@ -1 +0,0 @@
-{"version":3,"file":"http.d.cts","names":[],"sources":["../../src/instrumentation/http.ts"],"mappings":";;;;;iBAgBiB;EAChB;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;;;;;iBAMgB;EAChB;EACA;;;;;iBAMgB;EAChB;EACA;EACA;;;;;iBAMgB;EAChB;EACA;EACA;;;;;iBAMgB,2BAA2B;EAC3C,WAAW;EACX,WAAW;EACX,OAAO;EACP,SAAS;;;;;wBAQM,oDAAmB;;;;wBAOnB,iBAAiB,OAAO,qBAAqB;;;;wBAgD7C,oBACf,SAAS,gDACP;;iBAgBc;;EAEhB,QAAQ;;EAER,OAAO;;;;;;;;;;wBAWQ,qBACf,SAAS,+CACT,mBACE;;;;wBAsBa,mBACf,SAAS,wBACT,MAAM,UACJ;;;;wBASa,qBACf,OAAO,oBACP,gBAAgB,SAChB,QAAQ,SACN;;;;wBAsBa,YACf,MAAM,MACN,UAAU,wBACV,QAAQ;;;;;;;;;;;;;;;wBA0Ca,aAAa,GAClC,OAAO,oBACP,KAAK,MAAM,SAAS,QAAQ;EAAM;IAClC,gBAAgB,UACd,QAAQ;;;;wBA0BK,gBAAgB,cAAc,aAAa,aAAa;;;;wBAWlD,cAAc,GACnC,cACA,KAAK,MAAM,SAAS,QAAQ,IAC5B,aAAa,aACX,QAAQ;;;;wBA2BK"}

package/dist/instrumentation/http.d.mts.map

@@ -1 +0,0 @@
-{"version":3,"file":"http.d.mts","names":[],"sources":["../../src/instrumentation/http.ts"],"mappings":";;;;;iBAgBiB;EAChB;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;;;;;iBAMgB;EAChB;EACA;;;;;iBAMgB;EAChB;EACA;EACA;;;;;iBAMgB;EAChB;EACA;EACA;;;;;iBAMgB,2BAA2B;EAC3C,WAAW;EACX,WAAW;EACX,OAAO;EACP,SAAS;;;;;wBAQM,oDAAmB;;;;wBAOnB,iBAAiB,OAAO,qBAAqB;;;;wBAgD7C,oBACf,SAAS,gDACP;;iBAgBc;;EAEhB,QAAQ;;EAER,OAAO;;;;;;;;;;wBAWQ,qBACf,SAAS,+CACT,mBACE;;;;wBAsBa,mBACf,SAAS,wBACT,MAAM,UACJ;;;;wBASa,qBACf,OAAO,oBACP,gBAAgB,SAChB,QAAQ,SACN;;;;wBAsBa,YACf,MAAM,MACN,UAAU,wBACV,QAAQ;;;;;;;;;;;;;;;wBA0Ca,aAAa,GAClC,OAAO,oBACP,KAAK,MAAM,SAAS,QAAQ;EAAM;IAClC,gBAAgB,UACd,QAAQ;;;;wBA0BK,gBAAgB,cAAc,aAAa,aAAa;;;;wBAWlD,cAAc,GACnC,cACA,KAAK,MAAM,SAAS,QAAQ,IAC5B,aAAa,aACX,QAAQ;;;;wBA2BK"}

package/dist/instrumentation/http.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"http.mjs","names":[],"sources":["../../src/instrumentation/http.ts"],"sourcesContent":["import {\n\ttype Attributes,\n\ttype Context,\n\tcontext,\n\tisSpanContextValid,\n\ttype Link,\n\tpropagation,\n\ttype Span,\n\tSpanKind,\n\tSpanStatusCode,\n\ttrace,\n} from '@opentelemetry/api';\n\n/**\n * HTTP request attributes following OpenTelemetry semantic conventions\n */\nexport interface HttpRequestAttributes {\n\tmethod: string;\n\turl?: string;\n\tpath?: string;\n\troute?: string;\n\thost?: string;\n\tscheme?: 'http' | 'https';\n\tuserAgent?: string;\n\tclientIp?: string;\n\trequestId?: string;\n}\n\n/**\n * HTTP response attributes\n */\nexport interface HttpResponseAttributes {\n\tstatusCode: number;\n\tresponseSize?: number;\n}\n\n/**\n * Endpoint-specific attributes\n */\nexport interface EndpointAttributes {\n\tname?: string;\n\toperationId?: string;\n\ttags?: string[];\n}\n\n/**\n * User/session attributes\n */\nexport interface UserAttributes {\n\tuserId?: string;\n\tsessionId?: string;\n\troles?: string[];\n}\n\n/**\n * Full span attributes for HTTP requests\n */\nexport interface HttpSpanAttributes extends HttpRequestAttributes {\n\tresponse?: HttpResponseAttributes;\n\tendpoint?: EndpointAttributes;\n\tuser?: UserAttributes;\n\tcustom?: Attributes;\n}\n\nconst TRACER_NAME = '@geekmidas/constructs';\n\n/**\n * Get or create a tracer for constructs instrumentation\n */\nexport function getConstructsTracer() {\n\treturn trace.getTracer(TRACER_NAME);\n}\n\n/**\n * Convert HTTP attributes to OpenTelemetry semantic conventions\n */\nexport function toOtelAttributes(attrs: HttpSpanAttributes): Attributes {\n\tconst otelAttrs: Attributes = {};\n\n\t// HTTP request attributes (OpenTelemetry semantic conventions)\n\tif (attrs.method) otelAttrs['http.request.method'] = attrs.method;\n\tif (attrs.url) otelAttrs['url.full'] = attrs.url;\n\tif (attrs.path) otelAttrs['url.path'] = attrs.path;\n\tif (attrs.route) otelAttrs['http.route'] = attrs.route;\n\tif (attrs.host) otelAttrs['server.address'] = attrs.host;\n\tif (attrs.scheme) otelAttrs['url.scheme'] = attrs.scheme;\n\tif (attrs.userAgent) otelAttrs['user_agent.original'] = attrs.userAgent;\n\tif (attrs.clientIp) otelAttrs['client.address'] = attrs.clientIp;\n\tif (attrs.requestId) otelAttrs['http.request.id'] = attrs.requestId;\n\n\t// HTTP response attributes\n\tif (attrs.response?.statusCode) {\n\t\totelAttrs['http.response.status_code'] = attrs.response.statusCode;\n\t}\n\tif (attrs.response?.responseSize) {\n\t\totelAttrs['http.response.body.size'] = attrs.response.responseSize;\n\t}\n\n\t// Endpoint attributes\n\tif (attrs.endpoint?.name) otelAttrs['endpoint.name'] = attrs.endpoint.name;\n\tif (attrs.endpoint?.operationId) {\n\t\totelAttrs['endpoint.operation_id'] = attrs.endpoint.operationId;\n\t}\n\tif (attrs.endpoint?.tags?.length) {\n\t\totelAttrs['endpoint.tags'] = attrs.endpoint.tags;\n\t}\n\n\t// User attributes\n\tif (attrs.user?.userId) otelAttrs['enduser.id'] = attrs.user.userId;\n\tif (attrs.user?.sessionId) otelAttrs['session.id'] = attrs.user.sessionId;\n\tif (attrs.user?.roles?.length)\n\t\totelAttrs['enduser.role'] = attrs.user.roles.join(',');\n\n\t// Custom attributes\n\tif (attrs.custom) {\n\t\tObject.assign(otelAttrs, attrs.custom);\n\t}\n\n\treturn otelAttrs;\n}\n\n/**\n * Extract trace context from HTTP headers\n */\nexport function extractTraceContext(\n\theaders: Record<string, string | string[] | undefined>,\n): Context {\n\t// Normalize headers to Record<string, string>\n\tconst normalizedHeaders: Record<string, string> = {};\n\tfor (const [key, value] of Object.entries(headers)) {\n\t\tif (value) {\n\t\t\tconst stringValue = Array.isArray(value) ? value[0] : value;\n\t\t\tif (stringValue) {\n\t\t\t\tnormalizedHeaders[key.toLowerCase()] = stringValue;\n\t\t\t}\n\t\t}\n\t}\n\n\treturn propagation.extract(context.active(), normalizedHeaders);\n}\n\n/** Where a request's span goes: under a parent, or a new root with links. */\nexport interface IncomingTraceContext {\n\t/** The context the request span starts in. */\n\tparent: Context;\n\t/** The untrusted caller's context, linked rather than continued. */\n\tlinks: Link[];\n}\n\n/**\n * The trace a request's span belongs to.\n *\n * From a trusted caller (see `./trust`) its `traceparent` is continued, and\n * the span is its child. From anyone else the span starts a new trace — no\n * parent, no baggage — with a link to the context the caller claimed, so the\n * hop can still be followed without the caller choosing this trace.\n */\nexport function incomingTraceContext(\n\theaders: Record<string, string | string[] | undefined>,\n\ttrusted: boolean,\n): IncomingTraceContext {\n\tconst extracted = extractTraceContext(headers);\n\tif (trusted) return { parent: extracted, links: [] };\n\n\tconst claimed = trace.getSpanContext(extracted);\n\treturn {\n\t\tparent: trace.deleteSpan(context.active()),\n\t\tlinks:\n\t\t\tclaimed && isSpanContextValid(claimed)\n\t\t\t\t? [\n\t\t\t\t\t\t{\n\t\t\t\t\t\t\tcontext: claimed,\n\t\t\t\t\t\t\tattributes: { 'gkm.trace.untrusted_parent': true },\n\t\t\t\t\t\t},\n\t\t\t\t\t]\n\t\t\t\t: [],\n\t};\n}\n\n/**\n * Inject trace context into HTTP headers\n */\nexport function injectTraceContext(\n\theaders: Record<string, string>,\n\tctx?: Context,\n): Record<string, string> {\n\tconst result = { ...headers };\n\tpropagation.inject(ctx ?? context.active(), result);\n\treturn result;\n}\n\n/**\n * Create an HTTP server span for an incoming request\n */\nexport function createHttpServerSpan(\n\tattrs: HttpSpanAttributes,\n\tparentContext?: Context,\n\tlinks?: Link[],\n): Span {\n\tconst tracer = getConstructsTracer();\n\tconst spanName = attrs.route\n\t\t? `${attrs.method} ${attrs.route}`\n\t\t: `${attrs.method} ${attrs.path || '/'}`;\n\n\tconst ctx = parentContext ?? context.active();\n\n\treturn tracer.startSpan(\n\t\tspanName,\n\t\t{\n\t\t\tkind: SpanKind.SERVER,\n\t\t\tattributes: toOtelAttributes(attrs),\n\t\t\t...(links?.length ? { links } : {}),\n\t\t},\n\t\tctx,\n\t);\n}\n\n/**\n * End an HTTP span with response data\n */\nexport function endHttpSpan(\n\tspan: Span,\n\tresponse: HttpResponseAttributes,\n\terror?: Error,\n): void {\n\tspan.setAttribute('http.response.status_code', response.statusCode);\n\n\tif (response.responseSize) {\n\t\tspan.setAttribute('http.response.body.size', response.responseSize);\n\t}\n\n\tif (error) {\n\t\tspan.recordException(error);\n\t\tspan.setStatus({\n\t\t\tcode: SpanStatusCode.ERROR,\n\t\t\tmessage: error.message,\n\t\t});\n\t} else if (response.statusCode >= 500) {\n\t\tspan.setStatus({\n\t\t\tcode: SpanStatusCode.ERROR,\n\t\t\tmessage: `HTTP ${response.statusCode}`,\n\t\t});\n\t} else if (response.statusCode < 400) {\n\t\tspan.setStatus({ code: SpanStatusCode.OK });\n\t}\n\t// A 4xx leaves the status unset: on a server span it is the client's\n\t// mistake, not the server's failure (HTTP semantic conventions).\n\n\tspan.end();\n}\n\n/**\n * Execute a function within an HTTP server span context\n *\n * @example\n * ```typescript\n * const result = await withHttpSpan(\n *   { method: 'GET', path: '/users', route: '/users' },\n *   async (span) => {\n *     const users = await getUsers();\n *     return { statusCode: 200, body: users };\n *   }\n * );\n * ```\n */\nexport async function withHttpSpan<T>(\n\tattrs: HttpSpanAttributes,\n\tfn: (span: Span) => Promise<T & { statusCode?: number }>,\n\tparentContext?: Context,\n): Promise<T> {\n\tconst span = createHttpServerSpan(attrs, parentContext);\n\n\ttry {\n\t\tconst result = await context.with(\n\t\t\ttrace.setSpan(parentContext ?? context.active(), span),\n\t\t\t() => fn(span),\n\t\t);\n\n\t\tconst statusCode = (result as { statusCode?: number }).statusCode ?? 200;\n\t\tendHttpSpan(span, { statusCode });\n\n\t\treturn result;\n\t} catch (error) {\n\t\tendHttpSpan(\n\t\t\tspan,\n\t\t\t{ statusCode: 500 },\n\t\t\terror instanceof Error ? error : new Error(String(error)),\n\t\t);\n\t\tthrow error;\n\t}\n}\n\n/**\n * Create a child span for internal operations (middleware, handlers, etc.)\n */\nexport function createChildSpan(name: string, attributes?: Attributes): Span {\n\tconst tracer = getConstructsTracer();\n\treturn tracer.startSpan(name, {\n\t\tkind: SpanKind.INTERNAL,\n\t\tattributes,\n\t});\n}\n\n/**\n * Execute a function within a child span\n */\nexport async function withChildSpan<T>(\n\tname: string,\n\tfn: (span: Span) => Promise<T>,\n\tattributes?: Attributes,\n): Promise<T> {\n\tconst span = createChildSpan(name, attributes);\n\n\ttry {\n\t\tconst result = await context.with(\n\t\t\ttrace.setSpan(context.active(), span),\n\t\t\t() => fn(span),\n\t\t);\n\t\tspan.setStatus({ code: SpanStatusCode.OK });\n\t\treturn result;\n\t} catch (error) {\n\t\tspan.setStatus({\n\t\t\tcode: SpanStatusCode.ERROR,\n\t\t\tmessage: error instanceof Error ? error.message : 'Unknown error',\n\t\t});\n\t\tspan.recordException(\n\t\t\terror instanceof Error ? error : new Error(String(error)),\n\t\t);\n\t\tthrow error;\n\t} finally {\n\t\tspan.end();\n\t}\n}\n\n/**\n * Check if tracing is enabled (OpenTelemetry API is available and configured)\n */\nexport function isTracingEnabled(): boolean {\n\ttry {\n\t\tconst tracer = trace.getTracer(TRACER_NAME);\n\t\t// Check if we have a real tracer (not a no-op)\n\t\tconst span = tracer.startSpan('test');\n\t\tconst isReal =\n\t\t\tspan.spanContext().traceId !== '00000000000000000000000000000000';\n\t\tspan.end();\n\t\treturn isReal;\n\t} catch {\n\t\treturn false;\n\t}\n}\n"],"mappings":"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"}

package/dist/instrumentation/middleware.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"middleware.cjs","names":["isTrustedOrigin","incomingTraceContext","createHttpServerSpan","trace","context"],"sources":["../../src/instrumentation/middleware.ts"],"sourcesContent":["/**\n * OpenTelemetry instrumentation middleware for @geekmidas/constructs\n *\n * This middleware automatically creates spans for HTTP requests,\n * extracts trace context from incoming headers, and records\n * request/response metadata as span attributes.\n */\nimport type { MiddlewareObj } from '@middy/core';\nimport { context, type Span, trace } from '@opentelemetry/api';\nimport type { Context as LambdaContext } from 'aws-lambda';\nimport {\n\tcreateHttpServerSpan,\n\tendHttpSpan,\n\ttype HttpSpanAttributes,\n\tincomingTraceContext,\n} from './http';\nimport { isTrustedOrigin } from './trust';\n\n/**\n * Options for the telemetry middleware\n */\nexport interface TelemetryMiddlewareOptions {\n\t/**\n\t * Whether to record request body as span attribute\n\t * @default false\n\t */\n\trecordBody?: boolean;\n\n\t/**\n\t * Whether to record response body as span attribute\n\t * @default false\n\t */\n\trecordResponseBody?: boolean;\n\n\t/**\n\t * Custom function to extract endpoint name from event\n\t */\n\tgetEndpointName?: (event: any) => string | undefined;\n\n\t/**\n\t * Custom function to extract operation ID from event\n\t */\n\tgetOperationId?: (event: any) => string | undefined;\n\n\t/**\n\t * Custom function to extract user ID from event\n\t */\n\tgetUserId?: (event: any) => string | undefined;\n\n\t/**\n\t * Whether to skip tracing for this request\n\t */\n\tshouldSkip?: (event: any) => boolean;\n\n\t/**\n\t * The origins whose `traceparent` is continued: the API's own sites, the\n\t * same list its CORS allows. Any other caller starts a new trace linked to\n\t * the one it claimed.\n\t */\n\ttrustedOrigins?: readonly string[];\n\n\t/**\n\t * Trust a request with no trusted origin anyway — a caller the function\n\t * can vouch for, such as one that passed IAM auth. A Lambda behind API\n\t * Gateway has no private network to tell an internal caller by, so none\n\t * is trusted unless this says so.\n\t */\n\ttrustRequest?: (event: any) => boolean;\n}\n\n// Symbol for storing span on event\nconst SPAN_SYMBOL = Symbol('telemetry.span');\nconst CONTEXT_SYMBOL = Symbol('telemetry.context');\n\n/**\n * Get the current span from the Lambda event\n */\nexport function getSpanFromEvent(event: any): Span | undefined {\n\treturn event?.[SPAN_SYMBOL];\n}\n\n/**\n * Get the current trace context from the Lambda event\n */\nexport function getContextFromEvent(event: any): any {\n\treturn event?.[CONTEXT_SYMBOL];\n}\n\n/**\n * Create a telemetry middleware for Lambda handlers\n *\n * @example\n * ```typescript\n * import { telemetryMiddleware } from '@geekmidas/telescope/instrumentation';\n *\n * const adaptor = new AmazonApiGatewayV2Endpoint(endpoint, {\n *   telemetry: { middleware: telemetryMiddleware() },\n * });\n * ```\n */\nexport function telemetryMiddleware(\n\toptions: TelemetryMiddlewareOptions = {},\n): MiddlewareObj<any, any, Error, LambdaContext> {\n\treturn {\n\t\tbefore: async (request) => {\n\t\t\t// Skip if custom skip function returns true\n\t\t\tif (options.shouldSkip?.(request.event)) {\n\t\t\t\treturn;\n\t\t\t}\n\n\t\t\tconst event = request.event;\n\t\t\tconst lambdaContext = request.context;\n\n\t\t\t// Extract trace context from headers\n\t\t\tconst headers = normalizeHeaders(event.headers || {});\n\t\t\tconst trusted =\n\t\t\t\tisTrustedOrigin(\n\t\t\t\t\ttypeof headers.origin === 'string' ? headers.origin : undefined,\n\t\t\t\t\toptions.trustedOrigins,\n\t\t\t\t) || Boolean(options.trustRequest?.(event));\n\t\t\tconst { parent: parentContext, links } = incomingTraceContext(\n\t\t\t\theaders,\n\t\t\t\ttrusted,\n\t\t\t);\n\n\t\t\t// Build span attributes from event\n\t\t\tconst attrs = buildSpanAttributes(event, lambdaContext, options);\n\n\t\t\t// Create the span\n\t\t\tconst span = createHttpServerSpan(attrs, parentContext, links);\n\n\t\t\t// Store span and context on event for access in handler\n\t\t\tevent[SPAN_SYMBOL] = span;\n\t\t\tevent[CONTEXT_SYMBOL] = trace.setSpan(parentContext, span);\n\n\t\t\t// Add Lambda-specific attributes\n\t\t\tspan.setAttribute('faas.invocation_id', lambdaContext.awsRequestId);\n\t\t\tspan.setAttribute('faas.name', lambdaContext.functionName);\n\n\t\t\tif (options.recordBody && event.body) {\n\t\t\t\tconst bodyStr =\n\t\t\t\t\ttypeof event.body === 'string'\n\t\t\t\t\t\t? event.body\n\t\t\t\t\t\t: JSON.stringify(event.body);\n\t\t\t\t// Truncate large bodies\n\t\t\t\tspan.setAttribute(\n\t\t\t\t\t'http.request.body',\n\t\t\t\t\tbodyStr.length > 4096 ? `${bodyStr.slice(0, 4096)}...` : bodyStr,\n\t\t\t\t);\n\t\t\t}\n\t\t},\n\n\t\tafter: async (request) => {\n\t\t\tconst span = getSpanFromEvent(request.event);\n\t\t\tif (!span) {\n\t\t\t\treturn;\n\t\t\t}\n\n\t\t\tconst response = request.response;\n\t\t\tconst statusCode =\n\t\t\t\ttypeof response?.statusCode === 'number' ? response.statusCode : 200;\n\n\t\t\tif (options.recordResponseBody && response?.body) {\n\t\t\t\tconst bodyStr =\n\t\t\t\t\ttypeof response.body === 'string'\n\t\t\t\t\t\t? response.body\n\t\t\t\t\t\t: JSON.stringify(response.body);\n\t\t\t\tspan.setAttribute(\n\t\t\t\t\t'http.response.body',\n\t\t\t\t\tbodyStr.length > 4096 ? `${bodyStr.slice(0, 4096)}...` : bodyStr,\n\t\t\t\t);\n\t\t\t}\n\n\t\t\tendHttpSpan(span, { statusCode });\n\t\t},\n\n\t\tonError: async (request) => {\n\t\t\tconst span = getSpanFromEvent(request.event);\n\t\t\tif (!span) {\n\t\t\t\treturn;\n\t\t\t}\n\n\t\t\tconst error = request.error;\n\t\t\tconst response = request.response;\n\n\t\t\t// Determine status code from response or error\n\t\t\tlet statusCode = 500;\n\t\t\tif (response?.statusCode) {\n\t\t\t\tstatusCode = response.statusCode;\n\t\t\t} else if (error && 'statusCode' in error) {\n\t\t\t\tstatusCode = (error as any).statusCode;\n\t\t\t}\n\n\t\t\tendHttpSpan(\n\t\t\t\tspan,\n\t\t\t\t{ statusCode },\n\t\t\t\terror instanceof Error ? error : new Error(String(error)),\n\t\t\t);\n\t\t},\n\t};\n}\n\n/**\n * Build span attributes from Lambda event\n */\nfunction buildSpanAttributes(\n\tevent: any,\n\tlambdaContext: LambdaContext,\n\toptions: TelemetryMiddlewareOptions,\n): HttpSpanAttributes {\n\t// Detect event type (API Gateway v1, v2, ALB, or direct invoke)\n\tconst isV2 =\n\t\t'requestContext' in event && 'http' in (event.requestContext || {});\n\tconst isV1 =\n\t\t'requestContext' in event &&\n\t\t'httpMethod' in event &&\n\t\t!('http' in (event.requestContext || {}));\n\n\tlet method = 'INVOKE';\n\tlet path = '/';\n\tlet route: string | undefined;\n\tlet host: string | undefined;\n\tlet scheme: 'http' | 'https' | undefined;\n\tlet userAgent: string | undefined;\n\tlet clientIp: string | undefined;\n\tlet requestId: string | undefined;\n\n\tif (isV2) {\n\t\t// API Gateway v2 (HTTP API)\n\t\tconst http = event.requestContext.http;\n\t\tmethod = http.method;\n\t\tpath = event.rawPath || http.path;\n\t\troute = event.routeKey?.replace(/^[A-Z]+\\s+/, ''); // Remove HTTP method prefix\n\t\thost = event.headers?.host;\n\t\tscheme = 'https';\n\t\tuserAgent = http.userAgent;\n\t\tclientIp = http.sourceIp;\n\t\trequestId = event.requestContext.requestId;\n\t} else if (isV1) {\n\t\t// API Gateway v1 (REST API)\n\t\tmethod = event.httpMethod;\n\t\tpath = event.path;\n\t\troute = event.resource;\n\t\thost = event.headers?.Host || event.headers?.host;\n\t\tscheme = 'https';\n\t\tuserAgent = event.headers?.['User-Agent'] || event.headers?.['user-agent'];\n\t\tclientIp = event.requestContext?.identity?.sourceIp;\n\t\trequestId = event.requestContext?.requestId;\n\t} else if ('httpMethod' in event) {\n\t\t// ALB event\n\t\tmethod = event.httpMethod;\n\t\tpath = event.path;\n\t\thost = event.headers?.host;\n\t\tuserAgent = event.headers?.['user-agent'] || event.headers?.['User-Agent'];\n\t\tclientIp = event.headers?.['x-forwarded-for']?.split(',')[0]?.trim();\n\t}\n\n\tconst attrs: HttpSpanAttributes = {\n\t\tmethod,\n\t\tpath,\n\t\troute,\n\t\thost,\n\t\tscheme,\n\t\tuserAgent,\n\t\tclientIp,\n\t\trequestId: requestId || lambdaContext.awsRequestId,\n\t};\n\n\t// Add endpoint metadata if extractors provided\n\tif (options.getEndpointName || options.getOperationId) {\n\t\tattrs.endpoint = {\n\t\t\tname: options.getEndpointName?.(event),\n\t\t\toperationId: options.getOperationId?.(event),\n\t\t};\n\t}\n\n\t// Add user metadata if extractor provided\n\tif (options.getUserId) {\n\t\tconst userId = options.getUserId(event);\n\t\tif (userId) {\n\t\t\tattrs.user = { userId };\n\t\t}\n\t}\n\n\treturn attrs;\n}\n\n/**\n * Normalize headers to lowercase keys\n */\nfunction normalizeHeaders(\n\theaders: Record<string, string | string[] | undefined>,\n): Record<string, string | string[] | undefined> {\n\tconst normalized: Record<string, string | string[] | undefined> = {};\n\tfor (const [key, value] of Object.entries(headers)) {\n\t\tnormalized[key.toLowerCase()] = value;\n\t}\n\treturn normalized;\n}\n\n/**\n * Run a function within the span context from a Lambda event\n *\n * @example\n * ```typescript\n * await withEventContext(event, async () => {\n *   // Any spans created here will be children of the request span\n *   await doSomething();\n * });\n * ```\n */\nexport async function withEventContext<T>(\n\tevent: any,\n\tfn: () => Promise<T>,\n): Promise<T> {\n\tconst ctx = getContextFromEvent(event);\n\tif (!ctx) {\n\t\treturn fn();\n\t}\n\treturn context.with(ctx, fn);\n}\n"],"mappings":"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"}

package/dist/instrumentation/middleware.d.cts.map

@@ -1 +0,0 @@
-{"version":3,"file":"middleware.d.cts","names":["LambdaContext"],"sources":["../../src/instrumentation/middleware.ts"],"mappings":";;;;;;;iBAqBiB;;;;;EAKhB;;;;;EAMA;;;;EAKA,mBAAmB;;;;EAKnB,kBAAkB;;;;EAKlB,aAAa;;;;EAKb,cAAc;;;;;;EAOd;;;;;;;EAQA,gBAAgB;;;;;wBAUD,iBAAiB,aAAa;;;;wBAO9B,oBAAoB;;;;;;;;;;;;;wBAgBpB,oBACf,UAAS,6BACP,wBAAwB,OAAOA;;;;;;;;;;;;wBAiNZ,iBAAiB,GACtC,YACA,UAAU,QAAQ,KAChB,QAAQ"}

package/dist/instrumentation/middleware.d.mts.map

@@ -1 +0,0 @@
-{"version":3,"file":"middleware.d.mts","names":["LambdaContext"],"sources":["../../src/instrumentation/middleware.ts"],"mappings":";;;;;;;iBAqBiB;;;;;EAKhB;;;;;EAMA;;;;EAKA,mBAAmB;;;;EAKnB,kBAAkB;;;;EAKlB,aAAa;;;;EAKb,cAAc;;;;;;EAOd;;;;;;;EAQA,gBAAgB;;;;;wBAUD,iBAAiB,aAAa;;;;wBAO9B,oBAAoB;;;;;;;;;;;;;wBAgBpB,oBACf,UAAS,6BACP,wBAAwB,OAAOA;;;;;;;;;;;;wBAiNZ,iBAAiB,GACtC,YACA,UAAU,QAAQ,KAChB,QAAQ"}

package/dist/instrumentation/middleware.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"middleware.mjs","names":[],"sources":["../../src/instrumentation/middleware.ts"],"sourcesContent":["/**\n * OpenTelemetry instrumentation middleware for @geekmidas/constructs\n *\n * This middleware automatically creates spans for HTTP requests,\n * extracts trace context from incoming headers, and records\n * request/response metadata as span attributes.\n */\nimport type { MiddlewareObj } from '@middy/core';\nimport { context, type Span, trace } from '@opentelemetry/api';\nimport type { Context as LambdaContext } from 'aws-lambda';\nimport {\n\tcreateHttpServerSpan,\n\tendHttpSpan,\n\ttype HttpSpanAttributes,\n\tincomingTraceContext,\n} from './http';\nimport { isTrustedOrigin } from './trust';\n\n/**\n * Options for the telemetry middleware\n */\nexport interface TelemetryMiddlewareOptions {\n\t/**\n\t * Whether to record request body as span attribute\n\t * @default false\n\t */\n\trecordBody?: boolean;\n\n\t/**\n\t * Whether to record response body as span attribute\n\t * @default false\n\t */\n\trecordResponseBody?: boolean;\n\n\t/**\n\t * Custom function to extract endpoint name from event\n\t */\n\tgetEndpointName?: (event: any) => string | undefined;\n\n\t/**\n\t * Custom function to extract operation ID from event\n\t */\n\tgetOperationId?: (event: any) => string | undefined;\n\n\t/**\n\t * Custom function to extract user ID from event\n\t */\n\tgetUserId?: (event: any) => string | undefined;\n\n\t/**\n\t * Whether to skip tracing for this request\n\t */\n\tshouldSkip?: (event: any) => boolean;\n\n\t/**\n\t * The origins whose `traceparent` is continued: the API's own sites, the\n\t * same list its CORS allows. Any other caller starts a new trace linked to\n\t * the one it claimed.\n\t */\n\ttrustedOrigins?: readonly string[];\n\n\t/**\n\t * Trust a request with no trusted origin anyway — a caller the function\n\t * can vouch for, such as one that passed IAM auth. A Lambda behind API\n\t * Gateway has no private network to tell an internal caller by, so none\n\t * is trusted unless this says so.\n\t */\n\ttrustRequest?: (event: any) => boolean;\n}\n\n// Symbol for storing span on event\nconst SPAN_SYMBOL = Symbol('telemetry.span');\nconst CONTEXT_SYMBOL = Symbol('telemetry.context');\n\n/**\n * Get the current span from the Lambda event\n */\nexport function getSpanFromEvent(event: any): Span | undefined {\n\treturn event?.[SPAN_SYMBOL];\n}\n\n/**\n * Get the current trace context from the Lambda event\n */\nexport function getContextFromEvent(event: any): any {\n\treturn event?.[CONTEXT_SYMBOL];\n}\n\n/**\n * Create a telemetry middleware for Lambda handlers\n *\n * @example\n * ```typescript\n * import { telemetryMiddleware } from '@geekmidas/telescope/instrumentation';\n *\n * const adaptor = new AmazonApiGatewayV2Endpoint(endpoint, {\n *   telemetry: { middleware: telemetryMiddleware() },\n * });\n * ```\n */\nexport function telemetryMiddleware(\n\toptions: TelemetryMiddlewareOptions = {},\n): MiddlewareObj<any, any, Error, LambdaContext> {\n\treturn {\n\t\tbefore: async (request) => {\n\t\t\t// Skip if custom skip function returns true\n\t\t\tif (options.shouldSkip?.(request.event)) {\n\t\t\t\treturn;\n\t\t\t}\n\n\t\t\tconst event = request.event;\n\t\t\tconst lambdaContext = request.context;\n\n\t\t\t// Extract trace context from headers\n\t\t\tconst headers = normalizeHeaders(event.headers || {});\n\t\t\tconst trusted =\n\t\t\t\tisTrustedOrigin(\n\t\t\t\t\ttypeof headers.origin === 'string' ? headers.origin : undefined,\n\t\t\t\t\toptions.trustedOrigins,\n\t\t\t\t) || Boolean(options.trustRequest?.(event));\n\t\t\tconst { parent: parentContext, links } = incomingTraceContext(\n\t\t\t\theaders,\n\t\t\t\ttrusted,\n\t\t\t);\n\n\t\t\t// Build span attributes from event\n\t\t\tconst attrs = buildSpanAttributes(event, lambdaContext, options);\n\n\t\t\t// Create the span\n\t\t\tconst span = createHttpServerSpan(attrs, parentContext, links);\n\n\t\t\t// Store span and context on event for access in handler\n\t\t\tevent[SPAN_SYMBOL] = span;\n\t\t\tevent[CONTEXT_SYMBOL] = trace.setSpan(parentContext, span);\n\n\t\t\t// Add Lambda-specific attributes\n\t\t\tspan.setAttribute('faas.invocation_id', lambdaContext.awsRequestId);\n\t\t\tspan.setAttribute('faas.name', lambdaContext.functionName);\n\n\t\t\tif (options.recordBody && event.body) {\n\t\t\t\tconst bodyStr =\n\t\t\t\t\ttypeof event.body === 'string'\n\t\t\t\t\t\t? event.body\n\t\t\t\t\t\t: JSON.stringify(event.body);\n\t\t\t\t// Truncate large bodies\n\t\t\t\tspan.setAttribute(\n\t\t\t\t\t'http.request.body',\n\t\t\t\t\tbodyStr.length > 4096 ? `${bodyStr.slice(0, 4096)}...` : bodyStr,\n\t\t\t\t);\n\t\t\t}\n\t\t},\n\n\t\tafter: async (request) => {\n\t\t\tconst span = getSpanFromEvent(request.event);\n\t\t\tif (!span) {\n\t\t\t\treturn;\n\t\t\t}\n\n\t\t\tconst response = request.response;\n\t\t\tconst statusCode =\n\t\t\t\ttypeof response?.statusCode === 'number' ? response.statusCode : 200;\n\n\t\t\tif (options.recordResponseBody && response?.body) {\n\t\t\t\tconst bodyStr =\n\t\t\t\t\ttypeof response.body === 'string'\n\t\t\t\t\t\t? response.body\n\t\t\t\t\t\t: JSON.stringify(response.body);\n\t\t\t\tspan.setAttribute(\n\t\t\t\t\t'http.response.body',\n\t\t\t\t\tbodyStr.length > 4096 ? `${bodyStr.slice(0, 4096)}...` : bodyStr,\n\t\t\t\t);\n\t\t\t}\n\n\t\t\tendHttpSpan(span, { statusCode });\n\t\t},\n\n\t\tonError: async (request) => {\n\t\t\tconst span = getSpanFromEvent(request.event);\n\t\t\tif (!span) {\n\t\t\t\treturn;\n\t\t\t}\n\n\t\t\tconst error = request.error;\n\t\t\tconst response = request.response;\n\n\t\t\t// Determine status code from response or error\n\t\t\tlet statusCode = 500;\n\t\t\tif (response?.statusCode) {\n\t\t\t\tstatusCode = response.statusCode;\n\t\t\t} else if (error && 'statusCode' in error) {\n\t\t\t\tstatusCode = (error as any).statusCode;\n\t\t\t}\n\n\t\t\tendHttpSpan(\n\t\t\t\tspan,\n\t\t\t\t{ statusCode },\n\t\t\t\terror instanceof Error ? error : new Error(String(error)),\n\t\t\t);\n\t\t},\n\t};\n}\n\n/**\n * Build span attributes from Lambda event\n */\nfunction buildSpanAttributes(\n\tevent: any,\n\tlambdaContext: LambdaContext,\n\toptions: TelemetryMiddlewareOptions,\n): HttpSpanAttributes {\n\t// Detect event type (API Gateway v1, v2, ALB, or direct invoke)\n\tconst isV2 =\n\t\t'requestContext' in event && 'http' in (event.requestContext || {});\n\tconst isV1 =\n\t\t'requestContext' in event &&\n\t\t'httpMethod' in event &&\n\t\t!('http' in (event.requestContext || {}));\n\n\tlet method = 'INVOKE';\n\tlet path = '/';\n\tlet route: string | undefined;\n\tlet host: string | undefined;\n\tlet scheme: 'http' | 'https' | undefined;\n\tlet userAgent: string | undefined;\n\tlet clientIp: string | undefined;\n\tlet requestId: string | undefined;\n\n\tif (isV2) {\n\t\t// API Gateway v2 (HTTP API)\n\t\tconst http = event.requestContext.http;\n\t\tmethod = http.method;\n\t\tpath = event.rawPath || http.path;\n\t\troute = event.routeKey?.replace(/^[A-Z]+\\s+/, ''); // Remove HTTP method prefix\n\t\thost = event.headers?.host;\n\t\tscheme = 'https';\n\t\tuserAgent = http.userAgent;\n\t\tclientIp = http.sourceIp;\n\t\trequestId = event.requestContext.requestId;\n\t} else if (isV1) {\n\t\t// API Gateway v1 (REST API)\n\t\tmethod = event.httpMethod;\n\t\tpath = event.path;\n\t\troute = event.resource;\n\t\thost = event.headers?.Host || event.headers?.host;\n\t\tscheme = 'https';\n\t\tuserAgent = event.headers?.['User-Agent'] || event.headers?.['user-agent'];\n\t\tclientIp = event.requestContext?.identity?.sourceIp;\n\t\trequestId = event.requestContext?.requestId;\n\t} else if ('httpMethod' in event) {\n\t\t// ALB event\n\t\tmethod = event.httpMethod;\n\t\tpath = event.path;\n\t\thost = event.headers?.host;\n\t\tuserAgent = event.headers?.['user-agent'] || event.headers?.['User-Agent'];\n\t\tclientIp = event.headers?.['x-forwarded-for']?.split(',')[0]?.trim();\n\t}\n\n\tconst attrs: HttpSpanAttributes = {\n\t\tmethod,\n\t\tpath,\n\t\troute,\n\t\thost,\n\t\tscheme,\n\t\tuserAgent,\n\t\tclientIp,\n\t\trequestId: requestId || lambdaContext.awsRequestId,\n\t};\n\n\t// Add endpoint metadata if extractors provided\n\tif (options.getEndpointName || options.getOperationId) {\n\t\tattrs.endpoint = {\n\t\t\tname: options.getEndpointName?.(event),\n\t\t\toperationId: options.getOperationId?.(event),\n\t\t};\n\t}\n\n\t// Add user metadata if extractor provided\n\tif (options.getUserId) {\n\t\tconst userId = options.getUserId(event);\n\t\tif (userId) {\n\t\t\tattrs.user = { userId };\n\t\t}\n\t}\n\n\treturn attrs;\n}\n\n/**\n * Normalize headers to lowercase keys\n */\nfunction normalizeHeaders(\n\theaders: Record<string, string | string[] | undefined>,\n): Record<string, string | string[] | undefined> {\n\tconst normalized: Record<string, string | string[] | undefined> = {};\n\tfor (const [key, value] of Object.entries(headers)) {\n\t\tnormalized[key.toLowerCase()] = value;\n\t}\n\treturn normalized;\n}\n\n/**\n * Run a function within the span context from a Lambda event\n *\n * @example\n * ```typescript\n * await withEventContext(event, async () => {\n *   // Any spans created here will be children of the request span\n *   await doSomething();\n * });\n * ```\n */\nexport async function withEventContext<T>(\n\tevent: any,\n\tfn: () => Promise<T>,\n): Promise<T> {\n\tconst ctx = getContextFromEvent(event);\n\tif (!ctx) {\n\t\treturn fn();\n\t}\n\treturn context.with(ctx, fn);\n}\n"],"mappings":"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"}

package/dist/instrumentation/otel.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"otel.cjs","names":["extractTraceContext","createHttpServerSpan","trace"],"sources":["../../src/instrumentation/otel.ts"],"sourcesContent":["/**\n * OpenTelemetry implementation of the Telemetry interface\n *\n * This provides automatic span creation for Lambda handlers using\n * OpenTelemetry. Works with any OTel-compatible backend (Jaeger, Zipkin,\n * Datadog, Honeycomb, etc.)\n */\nimport { type Span, trace } from '@opentelemetry/api';\nimport type { Context as LambdaContext } from 'aws-lambda';\n\n/**\n * Context object returned by onRequestStart, passed to subsequent hooks.\n * This matches the Telemetry interface from @geekmidas/constructs.\n */\nexport interface TelemetryContext {\n\t[key: string]: unknown;\n}\n\n/**\n * Request information passed to telemetry hooks.\n * This matches the Telemetry interface from @geekmidas/constructs.\n */\nexport interface TelemetryRequest {\n\tevent: any;\n\tcontext: LambdaContext;\n}\n\n/**\n * Response information passed to onRequestEnd.\n * This matches the Telemetry interface from @geekmidas/constructs.\n */\nexport interface TelemetryResponse {\n\tstatusCode: number;\n\tbody?: string;\n\theaders?: Record<string, string>;\n}\n\n/**\n * Telemetry interface for instrumenting endpoint requests.\n * This matches the Telemetry interface from @geekmidas/constructs.\n */\nexport interface Telemetry {\n\tonRequestStart(request: TelemetryRequest): TelemetryContext;\n\tonRequestEnd(ctx: TelemetryContext, response: TelemetryResponse): void;\n\tonRequestError(ctx: TelemetryContext, error: Error): void;\n}\n\nimport {\n\tcreateHttpServerSpan,\n\tendHttpSpan,\n\textractTraceContext,\n\ttype HttpSpanAttributes,\n} from './http';\n\n/**\n * Options for OTelTelemetry\n */\nexport interface OTelTelemetryOptions {\n\t/**\n\t * Whether to record request body as span attribute\n\t * @default false\n\t */\n\trecordBody?: boolean;\n\n\t/**\n\t * Whether to record response body as span attribute\n\t * @default false\n\t */\n\trecordResponseBody?: boolean;\n\n\t/**\n\t * Custom function to extract user ID from event\n\t */\n\tgetUserId?: (event: any) => string | undefined;\n\n\t/**\n\t * Custom function to extract endpoint name from event\n\t */\n\tgetEndpointName?: (event: any) => string | undefined;\n\n\t/**\n\t * Custom function to extract operation ID from event\n\t */\n\tgetOperationId?: (event: any) => string | undefined;\n}\n\n/**\n * Telemetry context with span reference\n */\ninterface OTelContext extends TelemetryContext {\n\tspan: Span;\n\totelContext: any;\n}\n\n/**\n * OpenTelemetry implementation of the Telemetry interface\n *\n * @example\n * ```typescript\n * import { OTelTelemetry } from '@geekmidas/telescope/instrumentation';\n *\n * const adaptor = new AmazonApiGatewayV2Endpoint(endpoint, {\n *   telemetry: new OTelTelemetry(),\n * });\n * ```\n *\n * @example With options\n * ```typescript\n * const adaptor = new AmazonApiGatewayV2Endpoint(endpoint, {\n *   telemetry: new OTelTelemetry({\n *     recordBody: true,\n *     getUserId: (event) => event.requestContext?.authorizer?.userId,\n *   }),\n * });\n * ```\n */\nexport class OTelTelemetry implements Telemetry {\n\tconstructor(private options: OTelTelemetryOptions = {}) {}\n\n\tonRequestStart(request: TelemetryRequest): TelemetryContext {\n\t\tconst { event, context: lambdaContext } = request;\n\n\t\t// Extract trace context from headers\n\t\tconst headers = normalizeHeaders(event.headers || {});\n\t\tconst parentContext = extractTraceContext(headers);\n\n\t\t// Build span attributes from event\n\t\tconst attrs = this.buildSpanAttributes(event, lambdaContext);\n\n\t\t// Create the span\n\t\tconst span = createHttpServerSpan(attrs, parentContext);\n\t\tconst otelContext = trace.setSpan(parentContext, span);\n\n\t\t// Add Lambda-specific attributes\n\t\tspan.setAttribute('faas.invocation_id', lambdaContext.awsRequestId);\n\t\tspan.setAttribute('faas.name', lambdaContext.functionName);\n\n\t\t// Record body if requested\n\t\tif (this.options.recordBody && event.body) {\n\t\t\tconst bodyStr =\n\t\t\t\ttypeof event.body === 'string'\n\t\t\t\t\t? event.body\n\t\t\t\t\t: JSON.stringify(event.body);\n\t\t\tspan.setAttribute(\n\t\t\t\t'http.request.body',\n\t\t\t\tbodyStr.length > 4096 ? `${bodyStr.slice(0, 4096)}...` : bodyStr,\n\t\t\t);\n\t\t}\n\n\t\treturn { span, otelContext } as OTelContext;\n\t}\n\n\tonRequestEnd(ctx: TelemetryContext, response: TelemetryResponse): void {\n\t\tconst { span } = ctx as OTelContext;\n\n\t\tif (this.options.recordResponseBody && response.body) {\n\t\t\tspan.setAttribute(\n\t\t\t\t'http.response.body',\n\t\t\t\tresponse.body.length > 4096\n\t\t\t\t\t? `${response.body.slice(0, 4096)}...`\n\t\t\t\t\t: response.body,\n\t\t\t);\n\t\t}\n\n\t\tendHttpSpan(span, { statusCode: response.statusCode });\n\t}\n\n\tonRequestError(ctx: TelemetryContext, error: Error): void {\n\t\tconst { span } = ctx as OTelContext;\n\t\tendHttpSpan(span, { statusCode: 500 }, error);\n\t}\n\n\t/**\n\t * Build span attributes from Lambda event\n\t */\n\tprivate buildSpanAttributes(\n\t\tevent: any,\n\t\tlambdaContext: any,\n\t): HttpSpanAttributes {\n\t\t// Detect event type (API Gateway v1, v2, ALB, or direct invoke)\n\t\tconst isV2 =\n\t\t\t'requestContext' in event && 'http' in (event.requestContext || {});\n\t\tconst isV1 =\n\t\t\t'requestContext' in event &&\n\t\t\t'httpMethod' in event &&\n\t\t\t!('http' in (event.requestContext || {}));\n\n\t\tlet method = 'INVOKE';\n\t\tlet path = '/';\n\t\tlet route: string | undefined;\n\t\tlet host: string | undefined;\n\t\tlet scheme: 'http' | 'https' | undefined;\n\t\tlet userAgent: string | undefined;\n\t\tlet clientIp: string | undefined;\n\t\tlet requestId: string | undefined;\n\n\t\tif (isV2) {\n\t\t\t// API Gateway v2 (HTTP API)\n\t\t\tconst http = event.requestContext.http;\n\t\t\tmethod = http.method;\n\t\t\tpath = event.rawPath || http.path;\n\t\t\troute = event.routeKey?.replace(/^[A-Z]+\\s+/, ''); // Remove HTTP method prefix\n\t\t\thost = event.headers?.host;\n\t\t\tscheme = 'https';\n\t\t\tuserAgent = http.userAgent;\n\t\t\tclientIp = http.sourceIp;\n\t\t\trequestId = event.requestContext.requestId;\n\t\t} else if (isV1) {\n\t\t\t// API Gateway v1 (REST API)\n\t\t\tmethod = event.httpMethod;\n\t\t\tpath = event.path;\n\t\t\troute = event.resource;\n\t\t\thost = event.headers?.Host || event.headers?.host;\n\t\t\tscheme = 'https';\n\t\t\tuserAgent =\n\t\t\t\tevent.headers?.['User-Agent'] || event.headers?.['user-agent'];\n\t\t\tclientIp = event.requestContext?.identity?.sourceIp;\n\t\t\trequestId = event.requestContext?.requestId;\n\t\t} else if ('httpMethod' in event) {\n\t\t\t// ALB event\n\t\t\tmethod = event.httpMethod;\n\t\t\tpath = event.path;\n\t\t\thost = event.headers?.host;\n\t\t\tuserAgent =\n\t\t\t\tevent.headers?.['user-agent'] || event.headers?.['User-Agent'];\n\t\t\tclientIp = event.headers?.['x-forwarded-for']?.split(',')[0]?.trim();\n\t\t}\n\n\t\tconst attrs: HttpSpanAttributes = {\n\t\t\tmethod,\n\t\t\tpath,\n\t\t\troute,\n\t\t\thost,\n\t\t\tscheme,\n\t\t\tuserAgent,\n\t\t\tclientIp,\n\t\t\trequestId: requestId || lambdaContext.awsRequestId,\n\t\t};\n\n\t\t// Add endpoint metadata if extractors provided\n\t\tif (this.options.getEndpointName || this.options.getOperationId) {\n\t\t\tattrs.endpoint = {\n\t\t\t\tname: this.options.getEndpointName?.(event),\n\t\t\t\toperationId: this.options.getOperationId?.(event),\n\t\t\t};\n\t\t}\n\n\t\t// Add user metadata if extractor provided\n\t\tif (this.options.getUserId) {\n\t\t\tconst userId = this.options.getUserId(event);\n\t\t\tif (userId) {\n\t\t\t\tattrs.user = { userId };\n\t\t\t}\n\t\t}\n\n\t\treturn attrs;\n\t}\n}\n\n/**\n * Normalize headers to lowercase keys\n */\nfunction normalizeHeaders(\n\theaders: Record<string, string | string[] | undefined>,\n): Record<string, string | string[] | undefined> {\n\tconst normalized: Record<string, string | string[] | undefined> = {};\n\tfor (const [key, value] of Object.entries(headers)) {\n\t\tnormalized[key.toLowerCase()] = value;\n\t}\n\treturn normalized;\n}\n"],"mappings":"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"}

package/dist/instrumentation/otel.d.cts.map

@@ -1 +0,0 @@
-{"version":3,"file":"otel.d.cts","names":["LambdaContext"],"sources":["../../src/instrumentation/otel.ts"],"mappings":";;;;;;iBAciB;GACf;;;;;;iBAOe;EAChB;EACA,SAASA;;;;;;iBAOO;EAChB;EACA;EACA,UAAU;;;;;;iBAOM;EAChB,eAAe,SAAS,mBAAmB;EAC3C,aAAa,KAAK,kBAAkB,UAAU;EAC9C,eAAe,KAAK,kBAAkB,OAAO;;;;;iBAa7B;;;;;EAKhB;;;;;EAMA;;;;EAKA,aAAa;;;;EAKb,mBAAmB;;;;EAKnB,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;qBAiCN,yBAAyB;UACjB;EAApB,YAAoB,UAAS;EAE7B,eAAe,SAAS,mBAAmB;EAiC3C,aAAa,KAAK,kBAAkB,UAAU;EAe9C,eAAe,KAAK,kBAAkB,OAAO;;;;UAQrC"}

package/dist/instrumentation/otel.d.mts.map

@@ -1 +0,0 @@
-{"version":3,"file":"otel.d.mts","names":["LambdaContext"],"sources":["../../src/instrumentation/otel.ts"],"mappings":";;;;;;iBAciB;GACf;;;;;;iBAOe;EAChB;EACA,SAASA;;;;;;iBAOO;EAChB;EACA;EACA,UAAU;;;;;;iBAOM;EAChB,eAAe,SAAS,mBAAmB;EAC3C,aAAa,KAAK,kBAAkB,UAAU;EAC9C,eAAe,KAAK,kBAAkB,OAAO;;;;;iBAa7B;;;;;EAKhB;;;;;EAMA;;;;EAKA,aAAa;;;;EAKb,mBAAmB;;;;EAKnB,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;qBAiCN,yBAAyB;UACjB;EAApB,YAAoB,UAAS;EAE7B,eAAe,SAAS,mBAAmB;EAiC3C,aAAa,KAAK,kBAAkB,UAAU;EAe9C,eAAe,KAAK,kBAAkB,OAAO;;;;UAQrC"}

package/dist/instrumentation/otel.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"otel.mjs","names":[],"sources":["../../src/instrumentation/otel.ts"],"sourcesContent":["/**\n * OpenTelemetry implementation of the Telemetry interface\n *\n * This provides automatic span creation for Lambda handlers using\n * OpenTelemetry. Works with any OTel-compatible backend (Jaeger, Zipkin,\n * Datadog, Honeycomb, etc.)\n */\nimport { type Span, trace } from '@opentelemetry/api';\nimport type { Context as LambdaContext } from 'aws-lambda';\n\n/**\n * Context object returned by onRequestStart, passed to subsequent hooks.\n * This matches the Telemetry interface from @geekmidas/constructs.\n */\nexport interface TelemetryContext {\n\t[key: string]: unknown;\n}\n\n/**\n * Request information passed to telemetry hooks.\n * This matches the Telemetry interface from @geekmidas/constructs.\n */\nexport interface TelemetryRequest {\n\tevent: any;\n\tcontext: LambdaContext;\n}\n\n/**\n * Response information passed to onRequestEnd.\n * This matches the Telemetry interface from @geekmidas/constructs.\n */\nexport interface TelemetryResponse {\n\tstatusCode: number;\n\tbody?: string;\n\theaders?: Record<string, string>;\n}\n\n/**\n * Telemetry interface for instrumenting endpoint requests.\n * This matches the Telemetry interface from @geekmidas/constructs.\n */\nexport interface Telemetry {\n\tonRequestStart(request: TelemetryRequest): TelemetryContext;\n\tonRequestEnd(ctx: TelemetryContext, response: TelemetryResponse): void;\n\tonRequestError(ctx: TelemetryContext, error: Error): void;\n}\n\nimport {\n\tcreateHttpServerSpan,\n\tendHttpSpan,\n\textractTraceContext,\n\ttype HttpSpanAttributes,\n} from './http';\n\n/**\n * Options for OTelTelemetry\n */\nexport interface OTelTelemetryOptions {\n\t/**\n\t * Whether to record request body as span attribute\n\t * @default false\n\t */\n\trecordBody?: boolean;\n\n\t/**\n\t * Whether to record response body as span attribute\n\t * @default false\n\t */\n\trecordResponseBody?: boolean;\n\n\t/**\n\t * Custom function to extract user ID from event\n\t */\n\tgetUserId?: (event: any) => string | undefined;\n\n\t/**\n\t * Custom function to extract endpoint name from event\n\t */\n\tgetEndpointName?: (event: any) => string | undefined;\n\n\t/**\n\t * Custom function to extract operation ID from event\n\t */\n\tgetOperationId?: (event: any) => string | undefined;\n}\n\n/**\n * Telemetry context with span reference\n */\ninterface OTelContext extends TelemetryContext {\n\tspan: Span;\n\totelContext: any;\n}\n\n/**\n * OpenTelemetry implementation of the Telemetry interface\n *\n * @example\n * ```typescript\n * import { OTelTelemetry } from '@geekmidas/telescope/instrumentation';\n *\n * const adaptor = new AmazonApiGatewayV2Endpoint(endpoint, {\n *   telemetry: new OTelTelemetry(),\n * });\n * ```\n *\n * @example With options\n * ```typescript\n * const adaptor = new AmazonApiGatewayV2Endpoint(endpoint, {\n *   telemetry: new OTelTelemetry({\n *     recordBody: true,\n *     getUserId: (event) => event.requestContext?.authorizer?.userId,\n *   }),\n * });\n * ```\n */\nexport class OTelTelemetry implements Telemetry {\n\tconstructor(private options: OTelTelemetryOptions = {}) {}\n\n\tonRequestStart(request: TelemetryRequest): TelemetryContext {\n\t\tconst { event, context: lambdaContext } = request;\n\n\t\t// Extract trace context from headers\n\t\tconst headers = normalizeHeaders(event.headers || {});\n\t\tconst parentContext = extractTraceContext(headers);\n\n\t\t// Build span attributes from event\n\t\tconst attrs = this.buildSpanAttributes(event, lambdaContext);\n\n\t\t// Create the span\n\t\tconst span = createHttpServerSpan(attrs, parentContext);\n\t\tconst otelContext = trace.setSpan(parentContext, span);\n\n\t\t// Add Lambda-specific attributes\n\t\tspan.setAttribute('faas.invocation_id', lambdaContext.awsRequestId);\n\t\tspan.setAttribute('faas.name', lambdaContext.functionName);\n\n\t\t// Record body if requested\n\t\tif (this.options.recordBody && event.body) {\n\t\t\tconst bodyStr =\n\t\t\t\ttypeof event.body === 'string'\n\t\t\t\t\t? event.body\n\t\t\t\t\t: JSON.stringify(event.body);\n\t\t\tspan.setAttribute(\n\t\t\t\t'http.request.body',\n\t\t\t\tbodyStr.length > 4096 ? `${bodyStr.slice(0, 4096)}...` : bodyStr,\n\t\t\t);\n\t\t}\n\n\t\treturn { span, otelContext } as OTelContext;\n\t}\n\n\tonRequestEnd(ctx: TelemetryContext, response: TelemetryResponse): void {\n\t\tconst { span } = ctx as OTelContext;\n\n\t\tif (this.options.recordResponseBody && response.body) {\n\t\t\tspan.setAttribute(\n\t\t\t\t'http.response.body',\n\t\t\t\tresponse.body.length > 4096\n\t\t\t\t\t? `${response.body.slice(0, 4096)}...`\n\t\t\t\t\t: response.body,\n\t\t\t);\n\t\t}\n\n\t\tendHttpSpan(span, { statusCode: response.statusCode });\n\t}\n\n\tonRequestError(ctx: TelemetryContext, error: Error): void {\n\t\tconst { span } = ctx as OTelContext;\n\t\tendHttpSpan(span, { statusCode: 500 }, error);\n\t}\n\n\t/**\n\t * Build span attributes from Lambda event\n\t */\n\tprivate buildSpanAttributes(\n\t\tevent: any,\n\t\tlambdaContext: any,\n\t): HttpSpanAttributes {\n\t\t// Detect event type (API Gateway v1, v2, ALB, or direct invoke)\n\t\tconst isV2 =\n\t\t\t'requestContext' in event && 'http' in (event.requestContext || {});\n\t\tconst isV1 =\n\t\t\t'requestContext' in event &&\n\t\t\t'httpMethod' in event &&\n\t\t\t!('http' in (event.requestContext || {}));\n\n\t\tlet method = 'INVOKE';\n\t\tlet path = '/';\n\t\tlet route: string | undefined;\n\t\tlet host: string | undefined;\n\t\tlet scheme: 'http' | 'https' | undefined;\n\t\tlet userAgent: string | undefined;\n\t\tlet clientIp: string | undefined;\n\t\tlet requestId: string | undefined;\n\n\t\tif (isV2) {\n\t\t\t// API Gateway v2 (HTTP API)\n\t\t\tconst http = event.requestContext.http;\n\t\t\tmethod = http.method;\n\t\t\tpath = event.rawPath || http.path;\n\t\t\troute = event.routeKey?.replace(/^[A-Z]+\\s+/, ''); // Remove HTTP method prefix\n\t\t\thost = event.headers?.host;\n\t\t\tscheme = 'https';\n\t\t\tuserAgent = http.userAgent;\n\t\t\tclientIp = http.sourceIp;\n\t\t\trequestId = event.requestContext.requestId;\n\t\t} else if (isV1) {\n\t\t\t// API Gateway v1 (REST API)\n\t\t\tmethod = event.httpMethod;\n\t\t\tpath = event.path;\n\t\t\troute = event.resource;\n\t\t\thost = event.headers?.Host || event.headers?.host;\n\t\t\tscheme = 'https';\n\t\t\tuserAgent =\n\t\t\t\tevent.headers?.['User-Agent'] || event.headers?.['user-agent'];\n\t\t\tclientIp = event.requestContext?.identity?.sourceIp;\n\t\t\trequestId = event.requestContext?.requestId;\n\t\t} else if ('httpMethod' in event) {\n\t\t\t// ALB event\n\t\t\tmethod = event.httpMethod;\n\t\t\tpath = event.path;\n\t\t\thost = event.headers?.host;\n\t\t\tuserAgent =\n\t\t\t\tevent.headers?.['user-agent'] || event.headers?.['User-Agent'];\n\t\t\tclientIp = event.headers?.['x-forwarded-for']?.split(',')[0]?.trim();\n\t\t}\n\n\t\tconst attrs: HttpSpanAttributes = {\n\t\t\tmethod,\n\t\t\tpath,\n\t\t\troute,\n\t\t\thost,\n\t\t\tscheme,\n\t\t\tuserAgent,\n\t\t\tclientIp,\n\t\t\trequestId: requestId || lambdaContext.awsRequestId,\n\t\t};\n\n\t\t// Add endpoint metadata if extractors provided\n\t\tif (this.options.getEndpointName || this.options.getOperationId) {\n\t\t\tattrs.endpoint = {\n\t\t\t\tname: this.options.getEndpointName?.(event),\n\t\t\t\toperationId: this.options.getOperationId?.(event),\n\t\t\t};\n\t\t}\n\n\t\t// Add user metadata if extractor provided\n\t\tif (this.options.getUserId) {\n\t\t\tconst userId = this.options.getUserId(event);\n\t\t\tif (userId) {\n\t\t\t\tattrs.user = { userId };\n\t\t\t}\n\t\t}\n\n\t\treturn attrs;\n\t}\n}\n\n/**\n * Normalize headers to lowercase keys\n */\nfunction normalizeHeaders(\n\theaders: Record<string, string | string[] | undefined>,\n): Record<string, string | string[] | undefined> {\n\tconst normalized: Record<string, string | string[] | undefined> = {};\n\tfor (const [key, value] of Object.entries(headers)) {\n\t\tnormalized[key.toLowerCase()] = value;\n\t}\n\treturn normalized;\n}\n"],"mappings":"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"}