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

package/dist/middleware-PeyS-9Ny.d.cts

@@ -1,74 +0,0 @@
-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(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-PeyS-9Ny.d.cts.map

package/dist/middleware-PeyS-9Ny.d.cts.map

@@ -1 +0,0 @@
-{"version":3,"file":"middleware-PeyS-9Ny.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-oHvo_ZgU.d.mts

@@ -1,74 +0,0 @@
-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(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-oHvo_ZgU.d.mts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"middleware-oHvo_ZgU.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

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

@@ -1 +0,0 @@
-{"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-Bq0defVg.d.cts

@@ -1,64 +0,0 @@
-import { Telescope } from "./Telescope-D4nmwDRA.cjs";
-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-Bq0defVg.d.cts.map

package/dist/middy-Bq0defVg.d.cts.map

@@ -1 +0,0 @@
-{"version":3,"file":"middy-Bq0defVg.d.cts","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-DHWLmUAD.mjs

@@ -1,236 +0,0 @@
-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-DHWLmUAD.mjs.map

package/dist/middy-DHWLmUAD.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"middy-DHWLmUAD.mjs","names":["event: APIGatewayProxyEvent | APIGatewayProxyEventV2","headers: Record<string, string>","query: Record<string, string>","body: string | null | undefined","isBase64Encoded?: boolean","response: unknown","str: string","telescope: Telescope","options: TelescopeMiddlewareOptions","context: Context","thresholdMs: number","timeoutMs: number","handler: (event: TEvent, context: Context) => Promise<TResult>","event: TEvent"],"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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"}