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

package/dist/instrumentation/otel.cjs

@@ -1,4 +1,138 @@
-require('../http-BsqmhurZ.cjs');
-const require_otel = require('../otel-BzjOtVxZ.cjs');
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_instrumentation_http = require("./http.cjs");
+let _opentelemetry_api = require("@opentelemetry/api");
+//#region src/instrumentation/otel.ts
+/**
+* OpenTelemetry implementation of the Telemetry interface
+*
+* This provides automatic span creation for Lambda handlers using
+* OpenTelemetry. Works with any OTel-compatible backend (Jaeger, Zipkin,
+* Datadog, Honeycomb, etc.)
+*/
+/**
+* OpenTelemetry implementation of the Telemetry interface
+*
+* @example
+* ```typescript
+* import { OTelTelemetry } from '@geekmidas/telescope/instrumentation';
+*
+* const adaptor = new AmazonApiGatewayV2Endpoint(endpoint, {
+*   telemetry: new OTelTelemetry(),
+* });
+* ```
+*
+* @example With options
+* ```typescript
+* const adaptor = new AmazonApiGatewayV2Endpoint(endpoint, {
+*   telemetry: new OTelTelemetry({
+*     recordBody: true,
+*     getUserId: (event) => event.requestContext?.authorizer?.userId,
+*   }),
+* });
+* ```
+*/
+var OTelTelemetry = class {
+	options;
+	constructor(options = {}) {
+		this.options = options;
+	}
+	onRequestStart(request) {
+		const { event, context: lambdaContext } = request;
+		const headers = normalizeHeaders(event.headers || {});
+		const parentContext = require_instrumentation_http.extractTraceContext(headers);
+		const attrs = this.buildSpanAttributes(event, lambdaContext);
+		const span = require_instrumentation_http.createHttpServerSpan(attrs, parentContext);
+		const otelContext = _opentelemetry_api.trace.setSpan(parentContext, span);
+		span.setAttribute("faas.invocation_id", lambdaContext.awsRequestId);
+		span.setAttribute("faas.name", lambdaContext.functionName);
+		if (this.options.recordBody && event.body) {
+			const bodyStr = typeof event.body === "string" ? event.body : JSON.stringify(event.body);
+			span.setAttribute("http.request.body", bodyStr.length > 4096 ? `${bodyStr.slice(0, 4096)}...` : bodyStr);
+		}
+		return {
+			span,
+			otelContext
+		};
+	}
+	onRequestEnd(ctx, response) {
+		const { span } = ctx;
+		if (this.options.recordResponseBody && response.body) span.setAttribute("http.response.body", response.body.length > 4096 ? `${response.body.slice(0, 4096)}...` : response.body);
+		require_instrumentation_http.endHttpSpan(span, { statusCode: response.statusCode });
+	}
+	onRequestError(ctx, error) {
+		const { span } = ctx;
+		require_instrumentation_http.endHttpSpan(span, { statusCode: 500 }, error);
+	}
+	/**
+	* Build span attributes from Lambda event
+	*/
+	buildSpanAttributes(event, lambdaContext) {
+		const isV2 = "requestContext" in event && "http" in (event.requestContext || {});
+		const isV1 = "requestContext" in event && "httpMethod" in event && !("http" in (event.requestContext || {}));
+		let method = "INVOKE";
+		let path = "/";
+		let route;
+		let host;
+		let scheme;
+		let userAgent;
+		let clientIp;
+		let requestId;
+		if (isV2) {
+			const http = event.requestContext.http;
+			method = http.method;
+			path = event.rawPath || http.path;
+			route = event.routeKey?.replace(/^[A-Z]+\s+/, "");
+			host = event.headers?.host;
+			scheme = "https";
+			userAgent = http.userAgent;
+			clientIp = http.sourceIp;
+			requestId = event.requestContext.requestId;
+		} else if (isV1) {
+			method = event.httpMethod;
+			path = event.path;
+			route = event.resource;
+			host = event.headers?.Host || event.headers?.host;
+			scheme = "https";
+			userAgent = event.headers?.["User-Agent"] || event.headers?.["user-agent"];
+			clientIp = event.requestContext?.identity?.sourceIp;
+			requestId = event.requestContext?.requestId;
+		} else if ("httpMethod" in event) {
+			method = event.httpMethod;
+			path = event.path;
+			host = event.headers?.host;
+			userAgent = event.headers?.["user-agent"] || event.headers?.["User-Agent"];
+			clientIp = event.headers?.["x-forwarded-for"]?.split(",")[0]?.trim();
+		}
+		const attrs = {
+			method,
+			path,
+			route,
+			host,
+			scheme,
+			userAgent,
+			clientIp,
+			requestId: requestId || lambdaContext.awsRequestId
+		};
+		if (this.options.getEndpointName || this.options.getOperationId) attrs.endpoint = {
+			name: this.options.getEndpointName?.(event),
+			operationId: this.options.getOperationId?.(event)
+		};
+		if (this.options.getUserId) {
+			const userId = this.options.getUserId(event);
+			if (userId) attrs.user = { userId };
+		}
+		return attrs;
+	}
+};
+/**
+* Normalize headers to lowercase keys
+*/
+function normalizeHeaders(headers) {
+	const normalized = {};
+	for (const [key, value] of Object.entries(headers)) normalized[key.toLowerCase()] = value;
+	return normalized;
+}
+//#endregion
+exports.OTelTelemetry = OTelTelemetry;
 
-exports.OTelTelemetry = require_otel.OTelTelemetry;
+//# sourceMappingURL=otel.cjs.map

package/dist/instrumentation/otel.cjs.map

@@ -0,0 +1 @@
+{"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

@@ -1,2 +1,97 @@
-import { OTelTelemetry, OTelTelemetryOptions, Telemetry, TelemetryContext, TelemetryRequest, TelemetryResponse } from "../otel-Bk89b1lX.cjs";
-export { OTelTelemetry, OTelTelemetryOptions, Telemetry, TelemetryContext, TelemetryRequest, TelemetryResponse };
+import { Context } from "aws-lambda";
+//#region src/instrumentation/otel.d.ts
+/**
+ * Context object returned by onRequestStart, passed to subsequent hooks.
+ * This matches the Telemetry interface from @geekmidas/constructs.
+ */
+export interface TelemetryContext {
+  [key: string]: unknown;
+}
+/**
+ * Request information passed to telemetry hooks.
+ * This matches the Telemetry interface from @geekmidas/constructs.
+ */
+export interface TelemetryRequest {
+  event: any;
+  context: Context;
+}
+/**
+ * Response information passed to onRequestEnd.
+ * This matches the Telemetry interface from @geekmidas/constructs.
+ */
+export interface TelemetryResponse {
+  statusCode: number;
+  body?: string;
+  headers?: Record<string, string>;
+}
+/**
+ * Telemetry interface for instrumenting endpoint requests.
+ * This matches the Telemetry interface from @geekmidas/constructs.
+ */
+export interface Telemetry {
+  onRequestStart(request: TelemetryRequest): TelemetryContext;
+  onRequestEnd(ctx: TelemetryContext, response: TelemetryResponse): void;
+  onRequestError(ctx: TelemetryContext, error: Error): void;
+}
+/**
+ * Options for OTelTelemetry
+ */
+export interface OTelTelemetryOptions {
+  /**
+   * Whether to record request body as span attribute
+   * @default false
+   */
+  recordBody?: boolean;
+  /**
+   * Whether to record response body as span attribute
+   * @default false
+   */
+  recordResponseBody?: boolean;
+  /**
+   * Custom function to extract user ID from event
+   */
+  getUserId?: (event: any) => string | undefined;
+  /**
+   * Custom function to extract endpoint name from event
+   */
+  getEndpointName?: (event: any) => string | undefined;
+  /**
+   * Custom function to extract operation ID from event
+   */
+  getOperationId?: (event: any) => string | undefined;
+}
+/**
+ * OpenTelemetry implementation of the Telemetry interface
+ *
+ * @example
+ * ```typescript
+ * import { OTelTelemetry } from '@geekmidas/telescope/instrumentation';
+ *
+ * const adaptor = new AmazonApiGatewayV2Endpoint(endpoint, {
+ *   telemetry: new OTelTelemetry(),
+ * });
+ * ```
+ *
+ * @example With options
+ * ```typescript
+ * const adaptor = new AmazonApiGatewayV2Endpoint(endpoint, {
+ *   telemetry: new OTelTelemetry({
+ *     recordBody: true,
+ *     getUserId: (event) => event.requestContext?.authorizer?.userId,
+ *   }),
+ * });
+ * ```
+ */
+export declare class OTelTelemetry implements Telemetry {
+  private options;
+  constructor(options?: OTelTelemetryOptions);
+  onRequestStart(request: TelemetryRequest): TelemetryContext;
+  onRequestEnd(ctx: TelemetryContext, response: TelemetryResponse): void;
+  onRequestError(ctx: TelemetryContext, error: Error): void;
+  /**
+   * Build span attributes from Lambda event
+   */
+  private buildSpanAttributes;
+}
+//#endregion
+//# sourceMappingURL=otel.d.cts.map

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

@@ -0,0 +1 @@
+{"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

@@ -1,2 +1,97 @@
-import { OTelTelemetry, OTelTelemetryOptions, Telemetry, TelemetryContext, TelemetryRequest, TelemetryResponse } from "../otel-lPMsM26e.mjs";
-export { OTelTelemetry, OTelTelemetryOptions, Telemetry, TelemetryContext, TelemetryRequest, TelemetryResponse };
+import { Context } from "aws-lambda";
+//#region src/instrumentation/otel.d.ts
+/**
+ * Context object returned by onRequestStart, passed to subsequent hooks.
+ * This matches the Telemetry interface from @geekmidas/constructs.
+ */
+export interface TelemetryContext {
+  [key: string]: unknown;
+}
+/**
+ * Request information passed to telemetry hooks.
+ * This matches the Telemetry interface from @geekmidas/constructs.
+ */
+export interface TelemetryRequest {
+  event: any;
+  context: Context;
+}
+/**
+ * Response information passed to onRequestEnd.
+ * This matches the Telemetry interface from @geekmidas/constructs.
+ */
+export interface TelemetryResponse {
+  statusCode: number;
+  body?: string;
+  headers?: Record<string, string>;
+}
+/**
+ * Telemetry interface for instrumenting endpoint requests.
+ * This matches the Telemetry interface from @geekmidas/constructs.
+ */
+export interface Telemetry {
+  onRequestStart(request: TelemetryRequest): TelemetryContext;
+  onRequestEnd(ctx: TelemetryContext, response: TelemetryResponse): void;
+  onRequestError(ctx: TelemetryContext, error: Error): void;
+}
+/**
+ * Options for OTelTelemetry
+ */
+export interface OTelTelemetryOptions {
+  /**
+   * Whether to record request body as span attribute
+   * @default false
+   */
+  recordBody?: boolean;
+  /**
+   * Whether to record response body as span attribute
+   * @default false
+   */
+  recordResponseBody?: boolean;
+  /**
+   * Custom function to extract user ID from event
+   */
+  getUserId?: (event: any) => string | undefined;
+  /**
+   * Custom function to extract endpoint name from event
+   */
+  getEndpointName?: (event: any) => string | undefined;
+  /**
+   * Custom function to extract operation ID from event
+   */
+  getOperationId?: (event: any) => string | undefined;
+}
+/**
+ * OpenTelemetry implementation of the Telemetry interface
+ *
+ * @example
+ * ```typescript
+ * import { OTelTelemetry } from '@geekmidas/telescope/instrumentation';
+ *
+ * const adaptor = new AmazonApiGatewayV2Endpoint(endpoint, {
+ *   telemetry: new OTelTelemetry(),
+ * });
+ * ```
+ *
+ * @example With options
+ * ```typescript
+ * const adaptor = new AmazonApiGatewayV2Endpoint(endpoint, {
+ *   telemetry: new OTelTelemetry({
+ *     recordBody: true,
+ *     getUserId: (event) => event.requestContext?.authorizer?.userId,
+ *   }),
+ * });
+ * ```
+ */
+export declare class OTelTelemetry implements Telemetry {
+  private options;
+  constructor(options?: OTelTelemetryOptions);
+  onRequestStart(request: TelemetryRequest): TelemetryContext;
+  onRequestEnd(ctx: TelemetryContext, response: TelemetryResponse): void;
+  onRequestError(ctx: TelemetryContext, error: Error): void;
+  /**
+   * Build span attributes from Lambda event
+   */
+  private buildSpanAttributes;
+}
+//#endregion
+//# sourceMappingURL=otel.d.mts.map

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

@@ -0,0 +1 @@
+{"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

@@ -1,4 +1,137 @@
-import "../http-BIvr0YdI.mjs";
-import { OTelTelemetry } from "../otel-B9bNoeZ2.mjs";
+import { createHttpServerSpan, endHttpSpan, extractTraceContext } from "./http.mjs";
+import { trace } from "@opentelemetry/api";
+//#region src/instrumentation/otel.ts
+/**
+* OpenTelemetry implementation of the Telemetry interface
+*
+* This provides automatic span creation for Lambda handlers using
+* OpenTelemetry. Works with any OTel-compatible backend (Jaeger, Zipkin,
+* Datadog, Honeycomb, etc.)
+*/
+/**
+* OpenTelemetry implementation of the Telemetry interface
+*
+* @example
+* ```typescript
+* import { OTelTelemetry } from '@geekmidas/telescope/instrumentation';
+*
+* const adaptor = new AmazonApiGatewayV2Endpoint(endpoint, {
+*   telemetry: new OTelTelemetry(),
+* });
+* ```
+*
+* @example With options
+* ```typescript
+* const adaptor = new AmazonApiGatewayV2Endpoint(endpoint, {
+*   telemetry: new OTelTelemetry({
+*     recordBody: true,
+*     getUserId: (event) => event.requestContext?.authorizer?.userId,
+*   }),
+* });
+* ```
+*/
+var OTelTelemetry = class {
+	options;
+	constructor(options = {}) {
+		this.options = options;
+	}
+	onRequestStart(request) {
+		const { event, context: lambdaContext } = request;
+		const headers = normalizeHeaders(event.headers || {});
+		const parentContext = extractTraceContext(headers);
+		const attrs = this.buildSpanAttributes(event, lambdaContext);
+		const span = createHttpServerSpan(attrs, parentContext);
+		const otelContext = trace.setSpan(parentContext, span);
+		span.setAttribute("faas.invocation_id", lambdaContext.awsRequestId);
+		span.setAttribute("faas.name", lambdaContext.functionName);
+		if (this.options.recordBody && event.body) {
+			const bodyStr = typeof event.body === "string" ? event.body : JSON.stringify(event.body);
+			span.setAttribute("http.request.body", bodyStr.length > 4096 ? `${bodyStr.slice(0, 4096)}...` : bodyStr);
+		}
+		return {
+			span,
+			otelContext
+		};
+	}
+	onRequestEnd(ctx, response) {
+		const { span } = ctx;
+		if (this.options.recordResponseBody && response.body) span.setAttribute("http.response.body", response.body.length > 4096 ? `${response.body.slice(0, 4096)}...` : response.body);
+		endHttpSpan(span, { statusCode: response.statusCode });
+	}
+	onRequestError(ctx, error) {
+		const { span } = ctx;
+		endHttpSpan(span, { statusCode: 500 }, error);
+	}
+	/**
+	* Build span attributes from Lambda event
+	*/
+	buildSpanAttributes(event, lambdaContext) {
+		const isV2 = "requestContext" in event && "http" in (event.requestContext || {});
+		const isV1 = "requestContext" in event && "httpMethod" in event && !("http" in (event.requestContext || {}));
+		let method = "INVOKE";
+		let path = "/";
+		let route;
+		let host;
+		let scheme;
+		let userAgent;
+		let clientIp;
+		let requestId;
+		if (isV2) {
+			const http = event.requestContext.http;
+			method = http.method;
+			path = event.rawPath || http.path;
+			route = event.routeKey?.replace(/^[A-Z]+\s+/, "");
+			host = event.headers?.host;
+			scheme = "https";
+			userAgent = http.userAgent;
+			clientIp = http.sourceIp;
+			requestId = event.requestContext.requestId;
+		} else if (isV1) {
+			method = event.httpMethod;
+			path = event.path;
+			route = event.resource;
+			host = event.headers?.Host || event.headers?.host;
+			scheme = "https";
+			userAgent = event.headers?.["User-Agent"] || event.headers?.["user-agent"];
+			clientIp = event.requestContext?.identity?.sourceIp;
+			requestId = event.requestContext?.requestId;
+		} else if ("httpMethod" in event) {
+			method = event.httpMethod;
+			path = event.path;
+			host = event.headers?.host;
+			userAgent = event.headers?.["user-agent"] || event.headers?.["User-Agent"];
+			clientIp = event.headers?.["x-forwarded-for"]?.split(",")[0]?.trim();
+		}
+		const attrs = {
+			method,
+			path,
+			route,
+			host,
+			scheme,
+			userAgent,
+			clientIp,
+			requestId: requestId || lambdaContext.awsRequestId
+		};
+		if (this.options.getEndpointName || this.options.getOperationId) attrs.endpoint = {
+			name: this.options.getEndpointName?.(event),
+			operationId: this.options.getOperationId?.(event)
+		};
+		if (this.options.getUserId) {
+			const userId = this.options.getUserId(event);
+			if (userId) attrs.user = { userId };
+		}
+		return attrs;
+	}
+};
+/**
+* Normalize headers to lowercase keys
+*/
+function normalizeHeaders(headers) {
+	const normalized = {};
+	for (const [key, value] of Object.entries(headers)) normalized[key.toLowerCase()] = value;
+	return normalized;
+}
+//#endregion
+export { OTelTelemetry };
 
-export { OTelTelemetry };
+//# sourceMappingURL=otel.mjs.map

package/dist/instrumentation/otel.mjs.map

@@ -0,0 +1 @@
+{"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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"}

package/dist/instrumentation/setup.cjs

@@ -1,5 +1,101 @@
-require('../core-CtVHRJGv.cjs');
-const require_setup = require('../setup-DufxQpi9.cjs');
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_instrumentation_core = require("./core.cjs");
+let _opentelemetry_api = require("@opentelemetry/api");
+let _opentelemetry_auto_instrumentations_node = require("@opentelemetry/auto-instrumentations-node");
+let _opentelemetry_exporter_logs_otlp_http = require("@opentelemetry/exporter-logs-otlp-http");
+let _opentelemetry_exporter_trace_otlp_http = require("@opentelemetry/exporter-trace-otlp-http");
+let _opentelemetry_instrumentation_pino = require("@opentelemetry/instrumentation-pino");
+let _opentelemetry_resources = require("@opentelemetry/resources");
+let _opentelemetry_sdk_logs = require("@opentelemetry/sdk-logs");
+let _opentelemetry_sdk_node = require("@opentelemetry/sdk-node");
+let _opentelemetry_sdk_trace_node = require("@opentelemetry/sdk-trace-node");
+let _opentelemetry_semantic_conventions = require("@opentelemetry/semantic-conventions");
+//#region src/instrumentation/setup.ts
+let sdk = null;
+/**
+* Set up OpenTelemetry instrumentation.
+* Call this BEFORE importing your application code.
+*
+* @example
+* ```typescript
+* // instrumentation.ts (create this file)
+* import { setupTelemetry } from '@geekmidas/telescope/instrumentation';
+*
+* setupTelemetry({
+*   serviceName: 'my-api',
+*   endpoint: 'http://localhost:3000/__telescope/v1',
+* });
+*
+* // Then in your entry point:
+* // import './instrumentation';
+* // import { app } from './app';
+* ```
+*/
+function setupTelemetry(options) {
+	if (sdk) return;
+	const { serviceName, serviceVersion = "1.0.0", endpoint, instrumentPino = true, autoInstrument = true, debug = false, resourceAttributes = {}, headers = {}, spanProcessorStrategy, environment = "server" } = options;
+	if (debug) _opentelemetry_api.diag.setLogger(new _opentelemetry_api.DiagConsoleLogger(), _opentelemetry_api.DiagLogLevel.DEBUG);
+	const resource = (0, _opentelemetry_resources.resourceFromAttributes)({
+		[_opentelemetry_semantic_conventions.ATTR_SERVICE_NAME]: serviceName,
+		[_opentelemetry_semantic_conventions.ATTR_SERVICE_VERSION]: serviceVersion,
+		...resourceAttributes
+	});
+	const instrumentations = [];
+	if (instrumentPino) instrumentations.push(new _opentelemetry_instrumentation_pino.PinoInstrumentation({ logHook: (span, record) => {
+		record.trace_id = span.spanContext().traceId;
+		record.span_id = span.spanContext().spanId;
+		record.trace_flags = span.spanContext().traceFlags;
+	} }));
+	if (autoInstrument) instrumentations.push((0, _opentelemetry_auto_instrumentations_node.getNodeAutoInstrumentations)({
+		"@opentelemetry/instrumentation-fs": { enabled: false },
+		"@opentelemetry/instrumentation-http": { ignoreIncomingRequestHook: (request) => {
+			const path = request.url || "";
+			return path.includes("/__health") || path.includes("/__telescope") || path.includes("/favicon");
+		} }
+	}));
+	let traceExporter;
+	if (endpoint) traceExporter = new _opentelemetry_exporter_trace_otlp_http.OTLPTraceExporter({
+		url: `${endpoint}/traces`,
+		headers
+	});
+	else traceExporter = new _opentelemetry_sdk_trace_node.ConsoleSpanExporter();
+	const strategy = spanProcessorStrategy ?? require_instrumentation_core.getRecommendedStrategy(environment);
+	const spanProcessor = require_instrumentation_core.createSpanProcessor(traceExporter, { strategy });
+	require_instrumentation_core.setGlobalSpanProcessor(spanProcessor);
+	sdk = new _opentelemetry_sdk_node.NodeSDK({
+		resource,
+		traceExporter,
+		spanProcessors: [spanProcessor],
+		instrumentations
+	});
+	if (endpoint) {
+		const logExporter = new _opentelemetry_exporter_logs_otlp_http.OTLPLogExporter({
+			url: `${endpoint}/logs`,
+			headers
+		});
+		const logProcessor = new _opentelemetry_sdk_logs.BatchLogRecordProcessor({ exporter: logExporter });
+		new _opentelemetry_sdk_logs.LoggerProvider({
+			resource,
+			processors: [logProcessor]
+		});
+		require_instrumentation_core.setGlobalLogProcessor(logProcessor);
+	}
+	sdk.start();
+	process.on("SIGTERM", () => {
+		sdk?.shutdown().then(() => {}).catch((_error) => {}).finally(() => process.exit(0));
+	});
+}
+/**
+* Shut down telemetry (for testing or graceful shutdown)
+*/
+async function shutdownTelemetry() {
+	if (sdk) {
+		await sdk.shutdown();
+		sdk = null;
+	}
+}
+//#endregion
+exports.setupTelemetry = setupTelemetry;
+exports.shutdownTelemetry = shutdownTelemetry;
 
-exports.setupTelemetry = require_setup.setupTelemetry;
-exports.shutdownTelemetry = require_setup.shutdownTelemetry;
+//# sourceMappingURL=setup.cjs.map

package/dist/instrumentation/setup.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.cjs","names":["DiagConsoleLogger","DiagLogLevel","resourceFromAttributes","ATTR_SERVICE_NAME","ATTR_SERVICE_VERSION","PinoInstrumentation","getNodeAutoInstrumentations","OTLPTraceExporter","ConsoleSpanExporter","getRecommendedStrategy","createSpanProcessor","NodeSDK","OTLPLogExporter","BatchLogRecordProcessor","LoggerProvider"],"sources":["../../src/instrumentation/setup.ts"],"sourcesContent":["import { DiagConsoleLogger, DiagLogLevel, diag } from '@opentelemetry/api';\nimport { getNodeAutoInstrumentations } from '@opentelemetry/auto-instrumentations-node';\nimport { OTLPLogExporter } from '@opentelemetry/exporter-logs-otlp-http';\nimport { OTLPTraceExporter } from '@opentelemetry/exporter-trace-otlp-http';\nimport { PinoInstrumentation } from '@opentelemetry/instrumentation-pino';\nimport { resourceFromAttributes } from '@opentelemetry/resources';\nimport {\n\tBatchLogRecordProcessor,\n\tLoggerProvider,\n} from '@opentelemetry/sdk-logs';\nimport { NodeSDK } from '@opentelemetry/sdk-node';\nimport {\n\tConsoleSpanExporter,\n\ttype SpanExporter,\n} from '@opentelemetry/sdk-trace-node';\nimport {\n\tATTR_SERVICE_NAME,\n\tATTR_SERVICE_VERSION,\n} from '@opentelemetry/semantic-conventions';\nimport type { SpanProcessorStrategy } from '../adapters/types';\nimport {\n\tcreateSpanProcessor,\n\tgetRecommendedStrategy,\n\tsetGlobalLogProcessor,\n\tsetGlobalSpanProcessor,\n} from './core';\n\n/**\n * Options for configuring telemetry\n */\nexport interface TelemetryOptions {\n\t/**\n\t * Service name for resource identification\n\t */\n\tserviceName: string;\n\n\t/**\n\t * Service version\n\t */\n\tserviceVersion?: string;\n\n\t/**\n\t * OTLP endpoint URL (e.g., 'http://localhost:3000/__telescope/v1')\n\t * If not provided, traces will be logged to console\n\t */\n\tendpoint?: string;\n\n\t/**\n\t * Whether to instrument Pino for log correlation\n\t * @default true\n\t */\n\tinstrumentPino?: boolean;\n\n\t/**\n\t * Whether to enable auto-instrumentation for common libraries\n\t * (http, fetch, express, etc.)\n\t * @default true\n\t */\n\tautoInstrument?: boolean;\n\n\t/**\n\t * Enable debug logging for OTel SDK\n\t * @default false\n\t */\n\tdebug?: boolean;\n\n\t/**\n\t * Additional resource attributes\n\t */\n\tresourceAttributes?: Record<string, string>;\n\n\t/**\n\t * Headers to send with OTLP requests\n\t */\n\theaders?: Record<string, string>;\n\n\t/**\n\t * Span processor strategy.\n\t * - 'batch': Efficient batching for long-running servers (default)\n\t * - 'simple': Immediate export for serverless environments (Lambda, Edge)\n\t *\n\t * If not specified, automatically selected based on environment detection.\n\t */\n\tspanProcessorStrategy?: SpanProcessorStrategy;\n\n\t/**\n\t * Environment type for automatic configuration\n\t * @default 'server'\n\t */\n\tenvironment?: 'server' | 'lambda' | 'edge' | 'custom';\n}\n\nlet sdk: NodeSDK | null = null;\n\n/**\n * Set up OpenTelemetry instrumentation.\n * Call this BEFORE importing your application code.\n *\n * @example\n * ```typescript\n * // instrumentation.ts (create this file)\n * import { setupTelemetry } from '@geekmidas/telescope/instrumentation';\n *\n * setupTelemetry({\n *   serviceName: 'my-api',\n *   endpoint: 'http://localhost:3000/__telescope/v1',\n * });\n *\n * // Then in your entry point:\n * // import './instrumentation';\n * // import { app } from './app';\n * ```\n */\nexport function setupTelemetry(options: TelemetryOptions): void {\n\tif (sdk) {\n\t\treturn;\n\t}\n\n\tconst {\n\t\tserviceName,\n\t\tserviceVersion = '1.0.0',\n\t\tendpoint,\n\t\tinstrumentPino = true,\n\t\tautoInstrument = true,\n\t\tdebug = false,\n\t\tresourceAttributes = {},\n\t\theaders = {},\n\t\tspanProcessorStrategy,\n\t\tenvironment = 'server',\n\t} = options;\n\n\t// Enable debug logging if requested\n\tif (debug) {\n\t\tdiag.setLogger(new DiagConsoleLogger(), DiagLogLevel.DEBUG);\n\t}\n\n\t// Create resource\n\t// `new Resource(...)` went in resources 2.x — a resource is now made from\n\t// attributes by a function, so a detector and a literal produce the same\n\t// thing rather than two shapes that had to be merged.\n\tconst resource = resourceFromAttributes({\n\t\t[ATTR_SERVICE_NAME]: serviceName,\n\t\t[ATTR_SERVICE_VERSION]: serviceVersion,\n\t\t...resourceAttributes,\n\t});\n\n\t// Build instrumentations list\n\tconst instrumentations = [];\n\n\t// Add Pino instrumentation for log correlation\n\tif (instrumentPino) {\n\t\tinstrumentations.push(\n\t\t\tnew PinoInstrumentation({\n\t\t\t\t// Inject trace context into log records\n\t\t\t\tlogHook: (span, record) => {\n\t\t\t\t\trecord.trace_id = span.spanContext().traceId;\n\t\t\t\t\trecord.span_id = span.spanContext().spanId;\n\t\t\t\t\trecord.trace_flags = span.spanContext().traceFlags;\n\t\t\t\t},\n\t\t\t}),\n\t\t);\n\t}\n\n\t// Add auto-instrumentations for common libraries\n\tif (autoInstrument) {\n\t\tinstrumentations.push(\n\t\t\tgetNodeAutoInstrumentations({\n\t\t\t\t// Disable file system instrumentation (too noisy)\n\t\t\t\t'@opentelemetry/instrumentation-fs': { enabled: false },\n\t\t\t\t// Configure HTTP instrumentation\n\t\t\t\t'@opentelemetry/instrumentation-http': {\n\t\t\t\t\tignoreIncomingRequestHook: (request) => {\n\t\t\t\t\t\t// Ignore health checks and internal routes\n\t\t\t\t\t\tconst path = request.url || '';\n\t\t\t\t\t\treturn (\n\t\t\t\t\t\t\tpath.includes('/__health') ||\n\t\t\t\t\t\t\tpath.includes('/__telescope') ||\n\t\t\t\t\t\t\tpath.includes('/favicon')\n\t\t\t\t\t\t);\n\t\t\t\t\t},\n\t\t\t\t},\n\t\t\t}),\n\t\t);\n\t}\n\n\t// Create exporters\n\tlet traceExporter: SpanExporter;\n\tif (endpoint) {\n\t\ttraceExporter = new OTLPTraceExporter({\n\t\t\turl: `${endpoint}/traces`,\n\t\t\theaders,\n\t\t});\n\t} else {\n\t\t// Fall back to console exporter for debugging\n\t\ttraceExporter = new ConsoleSpanExporter();\n\t}\n\n\t// Determine span processor strategy\n\tconst strategy = spanProcessorStrategy ?? getRecommendedStrategy(environment);\n\tconst spanProcessor = createSpanProcessor(traceExporter, { strategy });\n\n\t// Register globally for flush operations\n\tsetGlobalSpanProcessor(spanProcessor);\n\n\t// Create and configure SDK\n\tsdk = new NodeSDK({\n\t\tresource,\n\t\ttraceExporter,\n\t\tspanProcessors: [spanProcessor],\n\t\tinstrumentations,\n\t});\n\n\t// Set up log exporter if endpoint is provided\n\tif (endpoint) {\n\t\tconst logExporter = new OTLPLogExporter({\n\t\t\turl: `${endpoint}/logs`,\n\t\t\theaders,\n\t\t});\n\n\t\t// Both changed in sdk-logs 2.x, and for the same reason the trace SDK\n\t\t// changed: a provider whose processors could be swapped after it had begun\n\t\t// emitting was never safe, so processors are constructor-only and the\n\t\t// exporter is named rather than positional.\n\t\tconst logProcessor = new BatchLogRecordProcessor({\n\t\t\texporter: logExporter,\n\t\t});\n\t\tconst loggerProvider = new LoggerProvider({\n\t\t\tresource,\n\t\t\tprocessors: [logProcessor],\n\t\t});\n\n\t\t// Register for flush operations\n\t\tsetGlobalLogProcessor(logProcessor);\n\t}\n\n\t// Start the SDK\n\tsdk.start();\n\n\t// Graceful shutdown\n\tprocess.on('SIGTERM', () => {\n\t\tsdk\n\t\t\t?.shutdown()\n\t\t\t.then(() => {})\n\t\t\t.catch((_error) => {})\n\t\t\t.finally(() => process.exit(0));\n\t});\n}\n\n/**\n * Shut down telemetry (for testing or graceful shutdown)\n */\nexport async function shutdownTelemetry(): Promise<void> {\n\tif (sdk) {\n\t\tawait sdk.shutdown();\n\t\tsdk = null;\n\t}\n}\n"],"mappings":";;;;;;;;;;;;;AA4FA,IAAI,MAAsB;;;;;;;;;;;;;;;;;;;;AAqB1B,SAAgB,eAAe,SAAiC;CAC/D,IAAI,KACH;CAGD,MAAM,EACL,aACA,iBAAiB,SACjB,UACA,iBAAiB,MACjB,iBAAiB,MACjB,QAAQ,OACR,qBAAqB,CAAC,GACtB,UAAU,CAAC,GACX,uBACA,cAAc,aACX;CAGJ,IAAI,OACH,mBAAA,KAAK,UAAU,IAAIA,mBAAAA,kBAAkB,GAAGC,mBAAAA,aAAa,KAAK;CAO3D,MAAM,YAAA,GAAWC,yBAAAA,uBAAAA,CAAuB;GACtCC,oCAAAA,oBAAoB;GACpBC,oCAAAA,uBAAuB;EACxB,GAAG;CACJ,CAAC;CAGD,MAAM,mBAAmB,CAAC;CAG1B,IAAI,gBACH,iBAAiB,KAChB,IAAIC,oCAAAA,oBAAoB,EAEvB,UAAU,MAAM,WAAW;EAC1B,OAAO,WAAW,KAAK,YAAY,CAAC,CAAC;EACrC,OAAO,UAAU,KAAK,YAAY,CAAC,CAAC;EACpC,OAAO,cAAc,KAAK,YAAY,CAAC,CAAC;CACzC,EACD,CAAC,CACF;CAID,IAAI,gBACH,iBAAiB,MAAA,GAChBC,0CAAAA,4BAAAA,CAA4B;EAE3B,qCAAqC,EAAE,SAAS,MAAM;EAEtD,uCAAuC,EACtC,4BAA4B,YAAY;GAEvC,MAAM,OAAO,QAAQ,OAAO;GAC5B,OACC,KAAK,SAAS,WAAW,KACzB,KAAK,SAAS,cAAc,KAC5B,KAAK,SAAS,UAAU;EAE1B,EACD;CACD,CAAC,CACF;CAID,IAAI;CACJ,IAAI,UACH,gBAAgB,IAAIC,wCAAAA,kBAAkB;EACrC,KAAK,GAAG,SAAS;EACjB;CACD,CAAC;MAGD,gBAAgB,IAAIC,8BAAAA,oBAAoB;CAIzC,MAAM,WAAW,yBAAyBC,6BAAAA,uBAAuB,WAAW;CAC5E,MAAM,gBAAgBC,6BAAAA,oBAAoB,eAAe,EAAE,SAAS,CAAC;CAGrE,6BAAA,uBAAuB,aAAa;CAGpC,MAAM,IAAIC,wBAAAA,QAAQ;EACjB;EACA;EACA,gBAAgB,CAAC,aAAa;EAC9B;CACD,CAAC;CAGD,IAAI,UAAU;EACb,MAAM,cAAc,IAAIC,uCAAAA,gBAAgB;GACvC,KAAK,GAAG,SAAS;GACjB;EACD,CAAC;EAMD,MAAM,eAAe,IAAIC,wBAAAA,wBAAwB,EAChD,UAAU,YACX,CAAC;EACsB,IAAIC,wBAAAA,eAAe;GACzC;GACA,YAAY,CAAC,YAAY;EAC1B,CAAC;EAGD,6BAAA,sBAAsB,YAAY;CACnC;CAGA,IAAI,MAAM;CAGV,QAAQ,GAAG,iBAAiB;EAC3B,KACG,SAAS,CAAC,CACX,WAAW,CAAC,CAAC,CAAC,CACd,OAAO,WAAW,CAAC,CAAC,CAAC,CACrB,cAAc,QAAQ,KAAK,CAAC,CAAC;CAChC,CAAC;AACF;;;;AAKA,eAAsB,oBAAmC;CACxD,IAAI,KAAK;EACR,MAAM,IAAI,SAAS;EACnB,MAAM;CACP;AACD"}