@geekmidas/telescope 10.0.0-alpha.98 → 10.0.0

package/dist/middleware-BTDncHwm.mjs

@@ -0,0 +1,160 @@
+import { createHttpServerSpan, endHttpSpan, extractTraceContext } from "./http-DQzgLczm.mjs";
+import { context, trace } from "@opentelemetry/api";
+
+//#region src/instrumentation/middleware.ts
+const SPAN_SYMBOL = Symbol("telemetry.span");
+const CONTEXT_SYMBOL = Symbol("telemetry.context");
+/**
+* Get the current span from the Lambda event
+*/
+function getSpanFromEvent(event) {
+	return event?.[SPAN_SYMBOL];
+}
+/**
+* Get the current trace context from the Lambda event
+*/
+function getContextFromEvent(event) {
+	return event?.[CONTEXT_SYMBOL];
+}
+/**
+* Create a telemetry middleware for Lambda handlers
+*
+* @example
+* ```typescript
+* import { telemetryMiddleware } from '@geekmidas/telescope/instrumentation';
+*
+* const adaptor = new AmazonApiGatewayV2Endpoint(envParser, endpoint, {
+*   telemetry: { middleware: telemetryMiddleware() },
+* });
+* ```
+*/
+function telemetryMiddleware(options = {}) {
+	return {
+		before: async (request) => {
+			if (options.shouldSkip?.(request.event)) return;
+			const event = request.event;
+			const lambdaContext = request.context;
+			const headers = normalizeHeaders(event.headers || {});
+			const parentContext = extractTraceContext(headers);
+			const attrs = buildSpanAttributes(event, lambdaContext, options);
+			const span = createHttpServerSpan(attrs, parentContext);
+			event[SPAN_SYMBOL] = span;
+			event[CONTEXT_SYMBOL] = trace.setSpan(parentContext, span);
+			span.setAttribute("faas.invocation_id", lambdaContext.awsRequestId);
+			span.setAttribute("faas.name", lambdaContext.functionName);
+			if (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);
+			}
+		},
+		after: async (request) => {
+			const span = getSpanFromEvent(request.event);
+			if (!span) return;
+			const response = request.response;
+			const statusCode = typeof response?.statusCode === "number" ? response.statusCode : 200;
+			if (options.recordResponseBody && response?.body) {
+				const bodyStr = typeof response.body === "string" ? response.body : JSON.stringify(response.body);
+				span.setAttribute("http.response.body", bodyStr.length > 4096 ? `${bodyStr.slice(0, 4096)}...` : bodyStr);
+			}
+			endHttpSpan(span, { statusCode });
+		},
+		onError: async (request) => {
+			const span = getSpanFromEvent(request.event);
+			if (!span) return;
+			const error = request.error;
+			const response = request.response;
+			let statusCode = 500;
+			if (response?.statusCode) statusCode = response.statusCode;
+			else if (error && "statusCode" in error) statusCode = error.statusCode;
+			endHttpSpan(span, { statusCode }, error instanceof Error ? error : new Error(String(error)));
+		}
+	};
+}
+/**
+* Build span attributes from Lambda event
+*/
+function buildSpanAttributes(event, lambdaContext, options) {
+	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 (options.getEndpointName || options.getOperationId) attrs.endpoint = {
+		name: options.getEndpointName?.(event),
+		operationId: options.getOperationId?.(event)
+	};
+	if (options.getUserId) {
+		const userId = 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;
+}
+/**
+* Run a function within the span context from a Lambda event
+*
+* @example
+* ```typescript
+* await withEventContext(event, async () => {
+*   // Any spans created here will be children of the request span
+*   await doSomething();
+* });
+* ```
+*/
+async function withEventContext(event, fn) {
+	const ctx = getContextFromEvent(event);
+	if (!ctx) return fn();
+	return context.with(ctx, fn);
+}
+
+//#endregion
+export { getContextFromEvent, getSpanFromEvent, telemetryMiddleware, withEventContext };
+//# sourceMappingURL=middleware-BTDncHwm.mjs.map

package/dist/middleware-BTDncHwm.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"middleware-BTDncHwm.mjs","names":["event: any","options: TelemetryMiddlewareOptions","lambdaContext: LambdaContext","route: string | undefined","host: string | undefined","scheme: 'http' | 'https' | undefined","userAgent: string | undefined","clientIp: string | undefined","requestId: string | undefined","attrs: HttpSpanAttributes","headers: Record<string, string | string[] | undefined>","normalized: Record<string, string | string[] | undefined>","fn: () => Promise<T>"],"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\textractTraceContext,\n\ttype HttpSpanAttributes,\n} from './http';\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\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(envParser, 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 parentContext = extractTraceContext(headers);\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);\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/middleware-CA84nsNN.d.cts

@@ -0,0 +1,74 @@
+import { Context } from "aws-lambda";
+import { MiddlewareObj } from "@middy/core";
+import { Span } from "@opentelemetry/api";
+
+//#region src/instrumentation/middleware.d.ts
+
+/**
+ * Options for the telemetry middleware
+ */
+interface TelemetryMiddlewareOptions {
+  /**
+   * 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 endpoint name from event
+   */
+  getEndpointName?: (event: any) => string | undefined;
+  /**
+   * Custom function to extract operation ID from event
+   */
+  getOperationId?: (event: any) => string | undefined;
+  /**
+   * Custom function to extract user ID from event
+   */
+  getUserId?: (event: any) => string | undefined;
+  /**
+   * Whether to skip tracing for this request
+   */
+  shouldSkip?: (event: any) => boolean;
+}
+/**
+ * Get the current span from the Lambda event
+ */
+declare function getSpanFromEvent(event: any): Span | undefined;
+/**
+ * Get the current trace context from the Lambda event
+ */
+declare function getContextFromEvent(event: any): any;
+/**
+ * Create a telemetry middleware for Lambda handlers
+ *
+ * @example
+ * ```typescript
+ * import { telemetryMiddleware } from '@geekmidas/telescope/instrumentation';
+ *
+ * const adaptor = new AmazonApiGatewayV2Endpoint(envParser, endpoint, {
+ *   telemetry: { middleware: telemetryMiddleware() },
+ * });
+ * ```
+ */
+declare function telemetryMiddleware(options?: TelemetryMiddlewareOptions): MiddlewareObj<any, any, Error, Context>;
+/**
+ * Run a function within the span context from a Lambda event
+ *
+ * @example
+ * ```typescript
+ * await withEventContext(event, async () => {
+ *   // Any spans created here will be children of the request span
+ *   await doSomething();
+ * });
+ * ```
+ */
+declare function withEventContext<T>(event: any, fn: () => Promise<T>): Promise<T>;
+//# sourceMappingURL=middleware.d.ts.map
+//#endregion
+export { TelemetryMiddlewareOptions, getContextFromEvent, getSpanFromEvent, telemetryMiddleware, withEventContext };
+//# sourceMappingURL=middleware-CA84nsNN.d.cts.map

package/dist/middleware-CA84nsNN.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"middleware-CA84nsNN.d.cts","names":[],"sources":["../src/instrumentation/middleware.ts"],"sourcesContent":[],"mappings":";;;;;;;;;AAsFG,UAlEc,0BAAA,CAkEd;EAAa;AAyMhB;;;EAEoB,UAAT,CAAA,EAAA,OAAA;EAAO;;AACR;;;;;;;;;;;;;;;;;;;;;;;iBArOM,gBAAA,cAA8B;;;;iBAO9B,mBAAA;;;;;;;;;;;;;iBAgBA,mBAAA,WACN,6BACP,wBAAwB,OAAO;;;;;;;;;;;;iBAyMZ,0CAEX,QAAQ,KAChB,QAAQ"}

package/dist/middleware-DAceVpfw.d.mts

@@ -0,0 +1,74 @@
+import { Span } from "@opentelemetry/api";
+import { Context as Context$1 } from "aws-lambda";
+import { MiddlewareObj } from "@middy/core";
+
+//#region src/instrumentation/middleware.d.ts
+
+/**
+ * Options for the telemetry middleware
+ */
+interface TelemetryMiddlewareOptions {
+  /**
+   * 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 endpoint name from event
+   */
+  getEndpointName?: (event: any) => string | undefined;
+  /**
+   * Custom function to extract operation ID from event
+   */
+  getOperationId?: (event: any) => string | undefined;
+  /**
+   * Custom function to extract user ID from event
+   */
+  getUserId?: (event: any) => string | undefined;
+  /**
+   * Whether to skip tracing for this request
+   */
+  shouldSkip?: (event: any) => boolean;
+}
+/**
+ * Get the current span from the Lambda event
+ */
+declare function getSpanFromEvent(event: any): Span | undefined;
+/**
+ * Get the current trace context from the Lambda event
+ */
+declare function getContextFromEvent(event: any): any;
+/**
+ * Create a telemetry middleware for Lambda handlers
+ *
+ * @example
+ * ```typescript
+ * import { telemetryMiddleware } from '@geekmidas/telescope/instrumentation';
+ *
+ * const adaptor = new AmazonApiGatewayV2Endpoint(envParser, endpoint, {
+ *   telemetry: { middleware: telemetryMiddleware() },
+ * });
+ * ```
+ */
+declare function telemetryMiddleware(options?: TelemetryMiddlewareOptions): MiddlewareObj<any, any, Error, Context$1>;
+/**
+ * Run a function within the span context from a Lambda event
+ *
+ * @example
+ * ```typescript
+ * await withEventContext(event, async () => {
+ *   // Any spans created here will be children of the request span
+ *   await doSomething();
+ * });
+ * ```
+ */
+declare function withEventContext<T>(event: any, fn: () => Promise<T>): Promise<T>;
+//# sourceMappingURL=middleware.d.ts.map
+//#endregion
+export { TelemetryMiddlewareOptions, getContextFromEvent, getSpanFromEvent, telemetryMiddleware, withEventContext };
+//# sourceMappingURL=middleware-DAceVpfw.d.mts.map

package/dist/middleware-DAceVpfw.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"middleware-DAceVpfw.d.mts","names":[],"sources":["../src/instrumentation/middleware.ts"],"sourcesContent":[],"mappings":";;;;;;;;;AAsFG,UAlEc,0BAAA,CAkEd;EAAa;AAyMhB;;;EAEoB,UAAT,CAAA,EAAA,OAAA;EAAO;;AACR;;;;;;;;;;;;;;;;;;;;;;;iBArOM,gBAAA,cAA8B;;;;iBAO9B,mBAAA;;;;;;;;;;;;;iBAgBA,mBAAA,WACN,6BACP,wBAAwB,OAAO;;;;;;;;;;;;iBAyMZ,0CAEX,QAAQ,KAChB,QAAQ"}

package/dist/middy-B6Btl8XE.d.mts

@@ -0,0 +1,64 @@
+import { Telescope } from "./Telescope-Dl6VSfxd.mjs";
+import { APIGatewayProxyEvent, APIGatewayProxyEventV2, Context } from "aws-lambda";
+import { MiddlewareObj } from "@middy/core";
+
+//#region src/adapters/middy.d.ts
+
+/**
+ * Options for the Telescope Middy middleware
+ */
+interface TelescopeMiddlewareOptions {
+  /**
+   * Minimum remaining time (ms) before forcing a flush.
+   * If remaining time drops below this, flush immediately.
+   * @default 1000 (1 second)
+   */
+  flushThresholdMs?: number;
+  /**
+   * Whether to record request/response bodies
+   * @default true
+   */
+  recordBody?: boolean;
+  /**
+   * Timeout for flush operation in ms
+   * @default 5000
+   */
+  flushTimeoutMs?: number;
+}
+/**
+ * Middy middleware that integrates Telescope with Lambda handlers.
+ *
+ * Features:
+ * - Records all requests and responses to Telescope
+ * - Captures exceptions automatically
+ * - Flushes telemetry before Lambda freezes
+ * - Uses Lambda context for smart flush timing
+ *
+ * @example
+ * ```typescript
+ * import middy from '@middy/core';
+ * import { telescopeMiddleware } from '@geekmidas/telescope/lambda';
+ *
+ * const handler = middy(baseHandler)
+ *   .use(telescopeMiddleware(telescope));
+ * ```
+ */
+declare function telescopeMiddleware(telescope: Telescope, options?: TelescopeMiddlewareOptions): MiddlewareObj<APIGatewayProxyEvent | APIGatewayProxyEventV2, any, Error, Context>;
+/**
+ * Create a wrapped Lambda handler with Telescope integration.
+ * Alternative to using Middy middleware directly.
+ *
+ * @example
+ * ```typescript
+ * import { createTelescopeHandler } from '@geekmidas/telescope/lambda';
+ *
+ * export const handler = createTelescopeHandler(telescope, async (event, context) => {
+ *   return { statusCode: 200, body: 'OK' };
+ * });
+ * ```
+ */
+declare function createTelescopeHandler<TEvent, TResult>(telescope: Telescope, handler: (event: TEvent, context: Context) => Promise<TResult>, options?: TelescopeMiddlewareOptions): (event: TEvent, context: Context) => Promise<TResult>;
+//# sourceMappingURL=middy.d.ts.map
+//#endregion
+export { TelescopeMiddlewareOptions, createTelescopeHandler, telescopeMiddleware };
+//# sourceMappingURL=middy-B6Btl8XE.d.mts.map

package/dist/middy-B6Btl8XE.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"middy-B6Btl8XE.d.mts","names":[],"sources":["../src/adapters/middy.ts"],"sourcesContent":[],"mappings":";;;;;;;;AAYA;AA2MgB,UA3MC,0BAAA,CA2MkB;EAAA;;;;;EAIW,gBAE7C,CAAA,EAAA,MAAA;EAAK;;AAHU;AA8HhB;EAAsC,UAAA,CAAA,EAAA,OAAA;EAAA;;;;EAEwB,cAAf,CAAA,EAAA,MAAA;;;;;;AAEA;;;;;;;;;;;;;;iBArI/B,mBAAA,YACJ,qBACF,6BACP,cACF,uBAAuB,6BAEvB,OACA;;;;;;;;;;;;;;iBA0He,mDACJ,4BACM,iBAAiB,YAAY,QAAQ,oBAC7C,qCACC,iBAAiB,YAAY,QAAQ"}

package/dist/middy-BTR3cyvk.mjs

@@ -0,0 +1,236 @@
+import { flushTelemetry } from "./core-D6hJ6exL.mjs";
+
+//#region src/adapters/middy.ts
+let processHooksRegistered = false;
+/**
+* Register process-level hooks for telemetry flush.
+* Called once per Lambda cold start.
+*/
+function registerProcessHooks() {
+	if (processHooksRegistered) return;
+	processHooksRegistered = true;
+	process.on("SIGTERM", async () => {
+		await flushTelemetry(5e3).catch(() => {});
+	});
+}
+/**
+* Extract request data from API Gateway event (v1 or v2)
+*/
+function extractRequestData(event) {
+	const headers = {};
+	if (event.headers) {
+		for (const [key, value] of Object.entries(event.headers)) if (value) headers[key.toLowerCase()] = value;
+	}
+	const contentLength = headers["content-length"];
+	const requestSize = contentLength ? parseInt(contentLength, 10) : void 0;
+	if ("rawPath" in event && event.requestContext?.http) {
+		const v2Event = event;
+		const query = {};
+		if (v2Event.queryStringParameters) {
+			for (const [key, value] of Object.entries(v2Event.queryStringParameters)) if (value !== void 0) query[key] = value;
+		}
+		return {
+			method: v2Event.requestContext.http.method,
+			path: v2Event.rawPath,
+			url: v2Event.rawPath + (v2Event.rawQueryString ? `?${v2Event.rawQueryString}` : ""),
+			headers,
+			query,
+			body: parseBody(v2Event.body, v2Event.isBase64Encoded),
+			ip: v2Event.requestContext.http.sourceIp,
+			requestId: v2Event.requestContext.requestId,
+			requestSize
+		};
+	}
+	const v1Event = event;
+	const queryString = v1Event.queryStringParameters ? new URLSearchParams(v1Event.queryStringParameters).toString() : "";
+	return {
+		method: v1Event.httpMethod,
+		path: v1Event.path,
+		url: v1Event.path + (queryString ? `?${queryString}` : ""),
+		headers,
+		query: v1Event.queryStringParameters || {},
+		body: parseBody(v1Event.body, v1Event.isBase64Encoded),
+		ip: v1Event.requestContext?.identity?.sourceIp,
+		requestId: v1Event.requestContext?.requestId,
+		requestSize
+	};
+}
+/**
+* Parse request body
+*/
+function parseBody(body, isBase64Encoded) {
+	if (!body) return void 0;
+	try {
+		const decoded = isBase64Encoded ? Buffer.from(body, "base64").toString("utf-8") : body;
+		return JSON.parse(decoded);
+	} catch {
+		return body;
+	}
+}
+/**
+* Extract response data from Lambda response
+*/
+function extractResponseData(response) {
+	if (response && typeof response === "object" && "statusCode" in response) {
+		const res = response;
+		const headers = res.headers || {};
+		const contentLengthKey = Object.keys(headers).find((k) => k.toLowerCase() === "content-length");
+		const contentLengthValue = contentLengthKey ? headers[contentLengthKey] : void 0;
+		const responseSize = contentLengthValue ? parseInt(contentLengthValue, 10) : res.body ? Buffer.byteLength(res.body, "utf8") : void 0;
+		return {
+			status: res.statusCode || 200,
+			headers,
+			body: res.body ? tryParseJson(res.body) : void 0,
+			responseSize
+		};
+	}
+	return {
+		status: 200,
+		headers: {},
+		body: response
+	};
+}
+function tryParseJson(str) {
+	try {
+		return JSON.parse(str);
+	} catch {
+		return str;
+	}
+}
+/**
+* Middy middleware that integrates Telescope with Lambda handlers.
+*
+* Features:
+* - Records all requests and responses to Telescope
+* - Captures exceptions automatically
+* - Flushes telemetry before Lambda freezes
+* - Uses Lambda context for smart flush timing
+*
+* @example
+* ```typescript
+* import middy from '@middy/core';
+* import { telescopeMiddleware } from '@geekmidas/telescope/lambda';
+*
+* const handler = middy(baseHandler)
+*   .use(telescopeMiddleware(telescope));
+* ```
+*/
+function telescopeMiddleware(telescope, options = {}) {
+	const { flushThresholdMs = 1e3, recordBody = true, flushTimeoutMs = 5e3 } = options;
+	registerProcessHooks();
+	return {
+		before: async (request) => {
+			request.__telescopeStartTime = Date.now();
+			request.context.callbackWaitsForEmptyEventLoop = false;
+		},
+		after: async (request) => {
+			const startTime = request.__telescopeStartTime || Date.now();
+			const duration = Date.now() - startTime;
+			try {
+				const reqData = extractRequestData(request.event);
+				const resData = extractResponseData(request.response);
+				await telescope.recordRequest({
+					method: reqData.method,
+					path: reqData.path,
+					url: reqData.url,
+					headers: reqData.headers,
+					query: reqData.query,
+					body: recordBody ? reqData.body : void 0,
+					ip: reqData.ip,
+					status: resData.status,
+					responseHeaders: resData.headers,
+					responseBody: recordBody ? resData.body : void 0,
+					duration,
+					requestSize: reqData.requestSize,
+					responseSize: resData.responseSize
+				});
+			} catch {}
+			await smartFlush(request.context, flushThresholdMs, flushTimeoutMs);
+		},
+		onError: async (request) => {
+			const startTime = request.__telescopeStartTime || Date.now();
+			const duration = Date.now() - startTime;
+			try {
+				if (request.error) await telescope.exception(request.error);
+				const reqData = extractRequestData(request.event);
+				await telescope.recordRequest({
+					method: reqData.method,
+					path: reqData.path,
+					url: reqData.url,
+					headers: reqData.headers,
+					query: reqData.query,
+					body: recordBody ? reqData.body : void 0,
+					ip: reqData.ip,
+					status: 500,
+					responseHeaders: {},
+					responseBody: { error: request.error?.message },
+					duration,
+					requestSize: reqData.requestSize
+				});
+			} catch {}
+			await smartFlush(request.context, flushThresholdMs, flushTimeoutMs);
+		}
+	};
+}
+/**
+* Smart flush that respects Lambda's remaining execution time
+*/
+async function smartFlush(context, thresholdMs, timeoutMs) {
+	const remaining = context.getRemainingTimeInMillis();
+	const effectiveTimeout = Math.min(timeoutMs, Math.max(remaining - thresholdMs, 100));
+	if (effectiveTimeout > 0) await flushTelemetry(effectiveTimeout).catch(() => {});
+}
+/**
+* Create a wrapped Lambda handler with Telescope integration.
+* Alternative to using Middy middleware directly.
+*
+* @example
+* ```typescript
+* import { createTelescopeHandler } from '@geekmidas/telescope/lambda';
+*
+* export const handler = createTelescopeHandler(telescope, async (event, context) => {
+*   return { statusCode: 200, body: 'OK' };
+* });
+* ```
+*/
+function createTelescopeHandler(telescope, handler, options = {}) {
+	const { flushThresholdMs = 1e3, recordBody = true, flushTimeoutMs = 5e3 } = options;
+	registerProcessHooks();
+	return async (event, context) => {
+		const startTime = Date.now();
+		context.callbackWaitsForEmptyEventLoop = false;
+		try {
+			const result = await handler(event, context);
+			const duration = Date.now() - startTime;
+			try {
+				const reqData = extractRequestData(event);
+				const resData = extractResponseData(result);
+				await telescope.recordRequest({
+					method: reqData.method,
+					path: reqData.path,
+					url: reqData.url,
+					headers: reqData.headers,
+					query: reqData.query,
+					body: recordBody ? reqData.body : void 0,
+					ip: reqData.ip,
+					status: resData.status,
+					responseHeaders: resData.headers,
+					responseBody: recordBody ? resData.body : void 0,
+					duration,
+					requestSize: reqData.requestSize,
+					responseSize: resData.responseSize
+				});
+			} catch {}
+			await smartFlush(context, flushThresholdMs, flushTimeoutMs);
+			return result;
+		} catch (error) {
+			if (error instanceof Error) await telescope.exception(error).catch(() => {});
+			await smartFlush(context, flushThresholdMs, flushTimeoutMs);
+			throw error;
+		}
+	};
+}
+
+//#endregion
+export { createTelescopeHandler, telescopeMiddleware };
+//# sourceMappingURL=middy-BTR3cyvk.mjs.map