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

package/dist/adapters/lambda.d.mts

@@ -1,15 +1,12 @@
-import "../types-B1EIa_cQ.mjs";
-import "../MetricsAggregator-DZrW8ls6.mjs";
-import { Telescope } from "../Telescope-Dl6VSfxd.mjs";
-import { AdapterRequestContext, AdapterResponseContext, LambdaAdapterConfig, TelescopeAdapter } from "../types-BzQ78Efw.mjs";
-import { TelescopeMiddlewareOptions, createTelescopeHandler, telescopeMiddleware } from "../middy-B6Btl8XE.mjs";
+import { t as Telescope } from "../Telescope-BcrWTaar.mjs";
+import { AdapterRequestContext, AdapterResponseContext, LambdaAdapterConfig, TelescopeAdapter } from "./types.mjs";
+import { TelescopeMiddlewareOptions, createTelescopeHandler, telescopeMiddleware } from "./middy.mjs";
 import { Context } from "aws-lambda";
-
 //#region src/adapters/lambda.d.ts
 /**
  * Lambda resource attributes detected from environment
  */
-interface LambdaResourceAttributes {
+export interface LambdaResourceAttributes {
   'cloud.provider': 'aws';
   'cloud.region': string;
   'faas.name': string;
@@ -21,11 +18,11 @@ interface LambdaResourceAttributes {
 /**
  * Detect Lambda resource attributes from environment
  */
-declare function detectLambdaResources(): LambdaResourceAttributes;
+export declare function detectLambdaResources(): LambdaResourceAttributes;
 /**
  * Extract invocation context from Lambda event
  */
-declare function extractLambdaInvocationContext(_event: unknown, context: Context): {
+export declare function extractLambdaInvocationContext(_event: unknown, context: Context): {
   requestId: string;
   coldStart: boolean;
   remainingTimeMs: number;
@@ -37,7 +34,7 @@ declare function extractLambdaInvocationContext(_event: unknown, context: Contex
  * Lambda adapter for Telescope.
  * Provides Lambda-specific request/response handling with auto-flush.
  */
-declare class LambdaAdapter implements TelescopeAdapter<LambdaAdapterConfig> {
+export declare class LambdaAdapter implements TelescopeAdapter<LambdaAdapterConfig> {
   readonly config: LambdaAdapterConfig;
   readonly telescope: Telescope;
   private resourceAttributes;
@@ -76,8 +73,7 @@ declare class LambdaAdapter implements TelescopeAdapter<LambdaAdapterConfig> {
  * });
  * ```
  */
-declare function wrapLambdaHandler<TEvent, TResult>(telescope: Telescope, handler: (event: TEvent, context: Context) => Promise<TResult>, options?: Partial<LambdaAdapterConfig>): (event: TEvent, context: Context) => Promise<TResult>;
-//# sourceMappingURL=lambda.d.ts.map
+export declare function wrapLambdaHandler<TEvent, TResult>(telescope: Telescope, handler: (event: TEvent, context: Context) => Promise<TResult>, options?: Partial<LambdaAdapterConfig>): (event: TEvent, context: Context) => Promise<TResult>;
 //#endregion
-export { LambdaAdapter, LambdaResourceAttributes, TelescopeMiddlewareOptions, createTelescopeHandler, detectLambdaResources, extractLambdaInvocationContext, telescopeMiddleware, wrapLambdaHandler };
+export { type TelescopeMiddlewareOptions, createTelescopeHandler, telescopeMiddleware };
 //# sourceMappingURL=lambda.d.mts.map

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

@@ -1 +1 @@
-{"version":3,"file":"lambda.d.mts","names":[],"sources":["../../src/adapters/lambda.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;;UAqBiB,wBAAA;EAAA,gBAAA,EAAA,KAAA;EAaD,cAAA,EAAA,MAAA;EAiBA,WAAA,EAAA,MAAA;EA4CH,cAAA,EAAc,MAAA;EAAA,eAAA,EAAA,MAAA;EAAA,iBAA4B,EAAA,MAAA;EAAmB,CAAA,GACxD,EAAA,MAAA,CAAA,EAAA,MAAA,GAAA,MAAA;;;;;AASA,iBAvEF,qBAAA,CAAA,CAuEE,EAvEuB,wBAuEvB;;;;AAmIF,iBAzLA,8BAAA,CAyLA,MAAA,EAAA,OAAA,EAAA,OAAA,EAvLN,OAuLM,CAAA,EAAA;EAAO,SAOG,EAAA,MAAA;EAAwB,SApJZ,EAAA,OAAA;EAAgB,eAAA,EAAA,MAAA;EAwKtC,aAAA,EAAA,MAAiB;EAAA,YAAA,EAAA,MAAA;EAAA,eACrB,EAAA,MAAA;CAAS;;;;;AAEX,cA3KG,aAAA,YAAyB,gBA2K5B,CA3K6C,mBA2K7C,CAAA,CAAA;EAAO,SACN,MAAA,EA3KO,mBA2KP;EAAM,SAAW,SAAA,EA1KP,SA0KO;EAAa,QAAa,kBAAA;EAAO,WAAf,CAAA,SAAA,EAvKtB,SAuKsB,EAAA,MAAA,CAAA,EAvKH,OAuKG,CAvKK,mBAuKL,CAAA;EAAO,OAAA,CAAA,CAAA,EAlKnC,OAkKmC,CAAA,IAAA,CAAA;eA3JjC;;;;yCAOoB;;;;gEAoFpC;;;;WAiCY;;;;2BAOU;;;;;;;;;;;;;;;;;iBAoBV,8CACJ,4BACM,iBAAiB,YAAkB,QAAQ,oBACnD,QAAQ,+BACP,iBAAiB,YAAkB,QAAQ"}
+{"version":3,"file":"lambda.d.mts","names":["LambdaContext"],"sources":["../../src/adapters/lambda.ts"],"mappings":";;;;;;;;iBAqBiB;EAChB;EACA;EACA;EACA;EACA;EACA;GACC;;;;;wBAMc,yBAAyB;;;;wBAiBzB,+BACf,iBACA,SAASA;EAET;EACA;EACA;EACA;EACA;EACA;;;;;;qBAmCY,yBAAyB,iBAAiB;WAC7C,QAAQ;WACR,WAAW;UACZ;EAER,YAAY,WAAW,WAAW,SAAQ,QAAQ;EAK5C,WAAW;EAOX,aAAa;;;;EAOnB,sBAAsB,iBAAiB;;;;EAiFvC,uBACC,mBACA,oBACE;;;;EAiCG,SAAS;;;;EAOf,yBAAyB;;;;;;;;;;;;;;;;;wBAoBV,kBAAkB,QAAQ,SACzC,WAAW,WACX,UAAU,OAAO,QAAQ,SAASA,YAAkB,QAAQ,UAC5D,UAAS,QAAQ,wBACd,OAAO,QAAQ,SAASA,YAAkB,QAAQ"}

package/dist/adapters/lambda.mjs

@@ -1,7 +1,6 @@
-import { flushTelemetry } from "../core-D6hJ6exL.mjs";
-import { createTelescopeHandler, telescopeMiddleware } from "../middy-DHWLmUAD.mjs";
+import { flushTelemetry } from "../instrumentation/core.mjs";
+import { createTelescopeHandler, telescopeMiddleware } from "./middy.mjs";
 import { nanoid } from "nanoid";
-
 //#region src/adapters/lambda.ts
 /**
 * Detect Lambda resource attributes from environment
@@ -235,7 +234,7 @@ function parseBody(body, isBase64Encoded) {
 		return body;
 	}
 }
-
 //#endregion
 export { LambdaAdapter, createTelescopeHandler, detectLambdaResources, extractLambdaInvocationContext, telescopeMiddleware, wrapLambdaHandler };
+
 //# sourceMappingURL=lambda.mjs.map

package/dist/adapters/lambda.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"lambda.mjs","names":["_event: unknown","context: LambdaContext","DEFAULT_LAMBDA_CONFIG: LambdaAdapterConfig","telescope: Telescope","config: Partial<LambdaAdapterConfig>","event: unknown","response: unknown","startTime: number","handler: (event: TEvent, context: LambdaContext) => Promise<TResult>","options: Partial<LambdaAdapterConfig>","event: TEvent","headers: Record<string, string | undefined>","normalized: Record<string, string>","body: string | null | undefined","isBase64Encoded?: boolean"],"sources":["../../src/adapters/lambda.ts"],"sourcesContent":["import type { Context as LambdaContext } from 'aws-lambda';\nimport { nanoid } from 'nanoid';\nimport { flushTelemetry } from '../instrumentation/core';\nimport type { Telescope } from '../Telescope';\nimport type {\n\tAdapterRequestContext,\n\tAdapterResponseContext,\n\tLambdaAdapterConfig,\n\tTelescopeAdapter,\n} from './types';\n\n// Re-export Middy middleware for convenience\nexport {\n\tcreateTelescopeHandler,\n\ttype TelescopeMiddlewareOptions,\n\ttelescopeMiddleware,\n} from './middy';\n\n/**\n * Lambda resource attributes detected from environment\n */\nexport interface LambdaResourceAttributes {\n\t'cloud.provider': 'aws';\n\t'cloud.region': string;\n\t'faas.name': string;\n\t'faas.version': string;\n\t'faas.instance': string;\n\t'faas.max_memory': number;\n\t[key: string]: string | number;\n}\n\n/**\n * Detect Lambda resource attributes from environment\n */\nexport function detectLambdaResources(): LambdaResourceAttributes {\n\treturn {\n\t\t'cloud.provider': 'aws',\n\t\t'cloud.region': process.env.AWS_REGION || 'unknown',\n\t\t'faas.name': process.env.AWS_LAMBDA_FUNCTION_NAME || 'unknown',\n\t\t'faas.version': process.env.AWS_LAMBDA_FUNCTION_VERSION || 'unknown',\n\t\t'faas.instance': process.env.AWS_LAMBDA_LOG_STREAM_NAME || 'unknown',\n\t\t'faas.max_memory': parseInt(\n\t\t\tprocess.env.AWS_LAMBDA_FUNCTION_MEMORY_SIZE || '128',\n\t\t\t10,\n\t\t),\n\t};\n}\n\n/**\n * Extract invocation context from Lambda event\n */\nexport function extractLambdaInvocationContext(\n\t_event: unknown,\n\tcontext: LambdaContext,\n): {\n\trequestId: string;\n\tcoldStart: boolean;\n\tremainingTimeMs: number;\n\tmemoryLimitMB: number;\n\tfunctionName: string;\n\tfunctionVersion: string;\n} {\n\treturn {\n\t\trequestId: context.awsRequestId,\n\t\tcoldStart: !globalLambdaState.initialized,\n\t\tremainingTimeMs: context.getRemainingTimeInMillis(),\n\t\tmemoryLimitMB: parseInt(String(context.memoryLimitInMB), 10),\n\t\tfunctionName: context.functionName,\n\t\tfunctionVersion: context.functionVersion,\n\t};\n}\n\n/**\n * Global state to track Lambda cold starts\n */\nconst globalLambdaState = {\n\tinitialized: false,\n};\n\n/**\n * Default Lambda adapter configuration\n */\nconst DEFAULT_LAMBDA_CONFIG: LambdaAdapterConfig = {\n\tenvironment: 'lambda',\n\tspanProcessor: {\n\t\tstrategy: 'simple', // Always use simple for Lambda\n\t},\n\tautoFlush: true,\n\tdetectResource: true,\n};\n\n/**\n * Lambda adapter for Telescope.\n * Provides Lambda-specific request/response handling with auto-flush.\n */\nexport class LambdaAdapter implements TelescopeAdapter<LambdaAdapterConfig> {\n\treadonly config: LambdaAdapterConfig;\n\treadonly telescope: Telescope;\n\tprivate resourceAttributes: LambdaResourceAttributes | null = null;\n\n\tconstructor(telescope: Telescope, config: Partial<LambdaAdapterConfig> = {}) {\n\t\tthis.telescope = telescope;\n\t\tthis.config = { ...DEFAULT_LAMBDA_CONFIG, ...config };\n\t}\n\n\tasync onSetup(): Promise<void> {\n\t\tif (this.config.detectResource) {\n\t\t\tthis.resourceAttributes = detectLambdaResources();\n\t\t}\n\t\tglobalLambdaState.initialized = true;\n\t}\n\n\tasync onDestroy(): Promise<void> {\n\t\tawait flushTelemetry();\n\t}\n\n\t/**\n\t * Extract request context from API Gateway event\n\t */\n\textractRequestContext(event: unknown): AdapterRequestContext {\n\t\t// Handle API Gateway v1 (REST API)\n\t\tif (isApiGatewayV1Event(event)) {\n\t\t\tconst headers = normalizeHeaders(event.headers || {});\n\t\t\tconst requestSize = headers['content-length']\n\t\t\t\t? parseInt(headers['content-length'], 10)\n\t\t\t\t: undefined;\n\t\t\treturn {\n\t\t\t\tid: event.requestContext?.requestId || nanoid(),\n\t\t\t\tmethod: event.httpMethod || 'UNKNOWN',\n\t\t\t\tpath: event.path || '/',\n\t\t\t\turl: event.path || '/',\n\t\t\t\theaders,\n\t\t\t\tquery: event.queryStringParameters || {},\n\t\t\t\tbody: parseBody(event.body, event.isBase64Encoded),\n\t\t\t\tip:\n\t\t\t\t\tevent.requestContext?.identity?.sourceIp ||\n\t\t\t\t\tevent.headers?.['X-Forwarded-For']?.split(',')[0],\n\t\t\t\tstartTime: Date.now(),\n\t\t\t\trequestSize,\n\t\t\t};\n\t\t}\n\n\t\t// Handle API Gateway v2 (HTTP API)\n\t\tif (isApiGatewayV2Event(event)) {\n\t\t\tconst headers = normalizeHeaders(event.headers || {});\n\t\t\tconst requestSize = headers['content-length']\n\t\t\t\t? parseInt(headers['content-length'], 10)\n\t\t\t\t: undefined;\n\t\t\treturn {\n\t\t\t\tid: event.requestContext?.requestId || nanoid(),\n\t\t\t\tmethod: event.requestContext?.http?.method || 'UNKNOWN',\n\t\t\t\tpath: event.rawPath || '/',\n\t\t\t\turl: event.rawPath || '/',\n\t\t\t\theaders,\n\t\t\t\tquery: event.queryStringParameters || {},\n\t\t\t\tbody: parseBody(event.body, event.isBase64Encoded),\n\t\t\t\tip:\n\t\t\t\t\tevent.requestContext?.http?.sourceIp ||\n\t\t\t\t\tevent.headers?.['x-forwarded-for']?.split(',')[0],\n\t\t\t\tstartTime: Date.now(),\n\t\t\t\trequestSize,\n\t\t\t};\n\t\t}\n\n\t\t// Handle ALB event\n\t\tif (isAlbEvent(event)) {\n\t\t\tconst headers = normalizeHeaders(event.headers || {});\n\t\t\tconst requestSize = headers['content-length']\n\t\t\t\t? parseInt(headers['content-length'], 10)\n\t\t\t\t: undefined;\n\t\t\treturn {\n\t\t\t\tid: nanoid(),\n\t\t\t\tmethod: event.httpMethod || 'UNKNOWN',\n\t\t\t\tpath: event.path || '/',\n\t\t\t\turl: event.path || '/',\n\t\t\t\theaders,\n\t\t\t\tquery: event.queryStringParameters || {},\n\t\t\t\tbody: parseBody(event.body, event.isBase64Encoded),\n\t\t\t\tip: event.headers?.['x-forwarded-for']?.split(',')[0],\n\t\t\t\tstartTime: Date.now(),\n\t\t\t\trequestSize,\n\t\t\t};\n\t\t}\n\n\t\t// Generic Lambda invocation (not HTTP)\n\t\treturn {\n\t\t\tid: nanoid(),\n\t\t\tmethod: 'INVOKE',\n\t\t\tpath: '/',\n\t\t\turl: '/',\n\t\t\theaders: {},\n\t\t\tquery: {},\n\t\t\tbody: event,\n\t\t\tstartTime: Date.now(),\n\t\t};\n\t}\n\n\t/**\n\t * Extract response context from Lambda response\n\t */\n\textractResponseContext(\n\t\tresponse: unknown,\n\t\tstartTime: number,\n\t): AdapterResponseContext {\n\t\tconst duration = Date.now() - startTime;\n\n\t\t// API Gateway response format\n\t\tif (isApiGatewayResponse(response)) {\n\t\t\tconst headers = normalizeHeaders(response.headers || {});\n\t\t\t// Prefer Content-Length header, fallback to body size\n\t\t\tconst responseSize = headers['content-length']\n\t\t\t\t? parseInt(headers['content-length'], 10)\n\t\t\t\t: typeof response.body === 'string'\n\t\t\t\t\t? Buffer.byteLength(response.body, 'utf8')\n\t\t\t\t\t: undefined;\n\t\t\treturn {\n\t\t\t\tstatus: response.statusCode || 200,\n\t\t\t\theaders,\n\t\t\t\tbody: response.body,\n\t\t\t\tduration,\n\t\t\t\tresponseSize,\n\t\t\t};\n\t\t}\n\n\t\t// Generic response\n\t\treturn {\n\t\t\tstatus: 200,\n\t\t\theaders: {},\n\t\t\tbody: response,\n\t\t\tduration,\n\t\t};\n\t}\n\n\t/**\n\t * Flush telemetry data before Lambda context freezes\n\t */\n\tasync flush(): Promise<void> {\n\t\tawait flushTelemetry();\n\t}\n\n\t/**\n\t * Get resource attributes for the Lambda function\n\t */\n\tgetResourceAttributes(): LambdaResourceAttributes | null {\n\t\treturn this.resourceAttributes;\n\t}\n}\n\n/**\n * Wrap a Lambda handler to automatically record requests and flush telemetry.\n *\n * @example\n * ```typescript\n * import { wrapLambdaHandler } from '@geekmidas/telescope/adapters/lambda';\n *\n * const telescope = new Telescope({ storage: new InMemoryStorage() });\n *\n * export const handler = wrapLambdaHandler(telescope, async (event, context) => {\n *   // Your Lambda logic here\n *   return { statusCode: 200, body: JSON.stringify({ success: true }) };\n * });\n * ```\n */\nexport function wrapLambdaHandler<TEvent, TResult>(\n\ttelescope: Telescope,\n\thandler: (event: TEvent, context: LambdaContext) => Promise<TResult>,\n\toptions: Partial<LambdaAdapterConfig> = {},\n): (event: TEvent, context: LambdaContext) => Promise<TResult> {\n\tconst adapter = new LambdaAdapter(telescope, options);\n\n\treturn async (event: TEvent, context: LambdaContext): Promise<TResult> => {\n\t\tconst requestContext = adapter.extractRequestContext(event);\n\n\t\ttry {\n\t\t\tconst result = await handler(event, context);\n\n\t\t\t// Record the request\n\t\t\tconst responseContext = adapter.extractResponseContext(\n\t\t\t\tresult,\n\t\t\t\trequestContext.startTime,\n\t\t\t);\n\n\t\t\tawait telescope.recordRequest({\n\t\t\t\tmethod: requestContext.method,\n\t\t\t\tpath: requestContext.path,\n\t\t\t\turl: requestContext.url,\n\t\t\t\theaders: requestContext.headers,\n\t\t\t\tquery: requestContext.query,\n\t\t\t\tbody: requestContext.body,\n\t\t\t\tip: requestContext.ip,\n\t\t\t\tstatus: responseContext.status,\n\t\t\t\tresponseHeaders: responseContext.headers,\n\t\t\t\tresponseBody: responseContext.body,\n\t\t\t\tduration: responseContext.duration,\n\t\t\t\trequestSize: requestContext.requestSize,\n\t\t\t\tresponseSize: responseContext.responseSize,\n\t\t\t});\n\n\t\t\treturn result;\n\t\t} catch (error) {\n\t\t\t// Record the exception\n\t\t\tif (error instanceof Error) {\n\t\t\t\tawait telescope.exception(error, requestContext.id);\n\t\t\t}\n\t\t\tthrow error;\n\t\t} finally {\n\t\t\t// Always flush before Lambda freezes\n\t\t\tif (options.autoFlush !== false) {\n\t\t\t\tawait adapter.flush();\n\t\t\t}\n\t\t}\n\t};\n}\n\n// ============================================\n// Type Guards and Helpers\n// ============================================\n\ninterface ApiGatewayV1Event {\n\thttpMethod?: string;\n\tpath?: string;\n\theaders?: Record<string, string | undefined>;\n\tqueryStringParameters?: Record<string, string>;\n\tbody?: string | null;\n\tisBase64Encoded?: boolean;\n\trequestContext?: {\n\t\trequestId?: string;\n\t\tidentity?: {\n\t\t\tsourceIp?: string;\n\t\t};\n\t};\n}\n\ninterface ApiGatewayV2Event {\n\trawPath?: string;\n\theaders?: Record<string, string | undefined>;\n\tqueryStringParameters?: Record<string, string>;\n\tbody?: string | null;\n\tisBase64Encoded?: boolean;\n\trequestContext?: {\n\t\trequestId?: string;\n\t\thttp?: {\n\t\t\tmethod?: string;\n\t\t\tsourceIp?: string;\n\t\t};\n\t};\n}\n\ninterface AlbEvent {\n\thttpMethod?: string;\n\tpath?: string;\n\theaders?: Record<string, string | undefined>;\n\tqueryStringParameters?: Record<string, string>;\n\tbody?: string | null;\n\tisBase64Encoded?: boolean;\n}\n\ninterface ApiGatewayResponse {\n\tstatusCode?: number;\n\theaders?: Record<string, string | undefined>;\n\tbody?: unknown;\n}\n\nfunction isApiGatewayV1Event(event: unknown): event is ApiGatewayV1Event {\n\treturn (\n\t\ttypeof event === 'object' &&\n\t\tevent !== null &&\n\t\t'httpMethod' in event &&\n\t\t'path' in event\n\t);\n}\n\nfunction isApiGatewayV2Event(event: unknown): event is ApiGatewayV2Event {\n\treturn (\n\t\ttypeof event === 'object' &&\n\t\tevent !== null &&\n\t\t'rawPath' in event &&\n\t\t'requestContext' in event &&\n\t\ttypeof (event as ApiGatewayV2Event).requestContext === 'object' &&\n\t\t'http' in ((event as ApiGatewayV2Event).requestContext || {})\n\t);\n}\n\nfunction isAlbEvent(event: unknown): event is AlbEvent {\n\treturn (\n\t\ttypeof event === 'object' &&\n\t\tevent !== null &&\n\t\t'httpMethod' in event &&\n\t\t!('requestContext' in event)\n\t);\n}\n\nfunction isApiGatewayResponse(\n\tresponse: unknown,\n): response is ApiGatewayResponse {\n\treturn (\n\t\ttypeof response === 'object' &&\n\t\tresponse !== null &&\n\t\t'statusCode' in response\n\t);\n}\n\nfunction normalizeHeaders(\n\theaders: Record<string, string | undefined>,\n): Record<string, string> {\n\tconst normalized: Record<string, string> = {};\n\tfor (const [key, value] of Object.entries(headers)) {\n\t\tif (value !== undefined) {\n\t\t\tnormalized[key.toLowerCase()] = value;\n\t\t}\n\t}\n\treturn normalized;\n}\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\n\t\t// Try to parse as JSON\n\t\treturn JSON.parse(decoded);\n\t} catch {\n\t\t// Return raw string if not JSON\n\t\treturn body;\n\t}\n}\n"],"mappings":"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"}
+{"version":3,"file":"lambda.mjs","names":[],"sources":["../../src/adapters/lambda.ts"],"sourcesContent":["import type { Context as LambdaContext } from 'aws-lambda';\nimport { nanoid } from 'nanoid';\nimport { flushTelemetry } from '../instrumentation/core';\nimport type { Telescope } from '../Telescope';\nimport type {\n\tAdapterRequestContext,\n\tAdapterResponseContext,\n\tLambdaAdapterConfig,\n\tTelescopeAdapter,\n} from './types';\n\n// Re-export Middy middleware for convenience\nexport {\n\tcreateTelescopeHandler,\n\ttype TelescopeMiddlewareOptions,\n\ttelescopeMiddleware,\n} from './middy';\n\n/**\n * Lambda resource attributes detected from environment\n */\nexport interface LambdaResourceAttributes {\n\t'cloud.provider': 'aws';\n\t'cloud.region': string;\n\t'faas.name': string;\n\t'faas.version': string;\n\t'faas.instance': string;\n\t'faas.max_memory': number;\n\t[key: string]: string | number;\n}\n\n/**\n * Detect Lambda resource attributes from environment\n */\nexport function detectLambdaResources(): LambdaResourceAttributes {\n\treturn {\n\t\t'cloud.provider': 'aws',\n\t\t'cloud.region': process.env.AWS_REGION || 'unknown',\n\t\t'faas.name': process.env.AWS_LAMBDA_FUNCTION_NAME || 'unknown',\n\t\t'faas.version': process.env.AWS_LAMBDA_FUNCTION_VERSION || 'unknown',\n\t\t'faas.instance': process.env.AWS_LAMBDA_LOG_STREAM_NAME || 'unknown',\n\t\t'faas.max_memory': parseInt(\n\t\t\tprocess.env.AWS_LAMBDA_FUNCTION_MEMORY_SIZE || '128',\n\t\t\t10,\n\t\t),\n\t};\n}\n\n/**\n * Extract invocation context from Lambda event\n */\nexport function extractLambdaInvocationContext(\n\t_event: unknown,\n\tcontext: LambdaContext,\n): {\n\trequestId: string;\n\tcoldStart: boolean;\n\tremainingTimeMs: number;\n\tmemoryLimitMB: number;\n\tfunctionName: string;\n\tfunctionVersion: string;\n} {\n\treturn {\n\t\trequestId: context.awsRequestId,\n\t\tcoldStart: !globalLambdaState.initialized,\n\t\tremainingTimeMs: context.getRemainingTimeInMillis(),\n\t\tmemoryLimitMB: parseInt(String(context.memoryLimitInMB), 10),\n\t\tfunctionName: context.functionName,\n\t\tfunctionVersion: context.functionVersion,\n\t};\n}\n\n/**\n * Global state to track Lambda cold starts\n */\nconst globalLambdaState = {\n\tinitialized: false,\n};\n\n/**\n * Default Lambda adapter configuration\n */\nconst DEFAULT_LAMBDA_CONFIG: LambdaAdapterConfig = {\n\tenvironment: 'lambda',\n\tspanProcessor: {\n\t\tstrategy: 'simple', // Always use simple for Lambda\n\t},\n\tautoFlush: true,\n\tdetectResource: true,\n};\n\n/**\n * Lambda adapter for Telescope.\n * Provides Lambda-specific request/response handling with auto-flush.\n */\nexport class LambdaAdapter implements TelescopeAdapter<LambdaAdapterConfig> {\n\treadonly config: LambdaAdapterConfig;\n\treadonly telescope: Telescope;\n\tprivate resourceAttributes: LambdaResourceAttributes | null = null;\n\n\tconstructor(telescope: Telescope, config: Partial<LambdaAdapterConfig> = {}) {\n\t\tthis.telescope = telescope;\n\t\tthis.config = { ...DEFAULT_LAMBDA_CONFIG, ...config };\n\t}\n\n\tasync onSetup(): Promise<void> {\n\t\tif (this.config.detectResource) {\n\t\t\tthis.resourceAttributes = detectLambdaResources();\n\t\t}\n\t\tglobalLambdaState.initialized = true;\n\t}\n\n\tasync onDestroy(): Promise<void> {\n\t\tawait flushTelemetry();\n\t}\n\n\t/**\n\t * Extract request context from API Gateway event\n\t */\n\textractRequestContext(event: unknown): AdapterRequestContext {\n\t\t// Handle API Gateway v1 (REST API)\n\t\tif (isApiGatewayV1Event(event)) {\n\t\t\tconst headers = normalizeHeaders(event.headers || {});\n\t\t\tconst requestSize = headers['content-length']\n\t\t\t\t? parseInt(headers['content-length'], 10)\n\t\t\t\t: undefined;\n\t\t\treturn {\n\t\t\t\tid: event.requestContext?.requestId || nanoid(),\n\t\t\t\tmethod: event.httpMethod || 'UNKNOWN',\n\t\t\t\tpath: event.path || '/',\n\t\t\t\turl: event.path || '/',\n\t\t\t\theaders,\n\t\t\t\tquery: event.queryStringParameters || {},\n\t\t\t\tbody: parseBody(event.body, event.isBase64Encoded),\n\t\t\t\tip:\n\t\t\t\t\tevent.requestContext?.identity?.sourceIp ||\n\t\t\t\t\tevent.headers?.['X-Forwarded-For']?.split(',')[0],\n\t\t\t\tstartTime: Date.now(),\n\t\t\t\trequestSize,\n\t\t\t};\n\t\t}\n\n\t\t// Handle API Gateway v2 (HTTP API)\n\t\tif (isApiGatewayV2Event(event)) {\n\t\t\tconst headers = normalizeHeaders(event.headers || {});\n\t\t\tconst requestSize = headers['content-length']\n\t\t\t\t? parseInt(headers['content-length'], 10)\n\t\t\t\t: undefined;\n\t\t\treturn {\n\t\t\t\tid: event.requestContext?.requestId || nanoid(),\n\t\t\t\tmethod: event.requestContext?.http?.method || 'UNKNOWN',\n\t\t\t\tpath: event.rawPath || '/',\n\t\t\t\turl: event.rawPath || '/',\n\t\t\t\theaders,\n\t\t\t\tquery: event.queryStringParameters || {},\n\t\t\t\tbody: parseBody(event.body, event.isBase64Encoded),\n\t\t\t\tip:\n\t\t\t\t\tevent.requestContext?.http?.sourceIp ||\n\t\t\t\t\tevent.headers?.['x-forwarded-for']?.split(',')[0],\n\t\t\t\tstartTime: Date.now(),\n\t\t\t\trequestSize,\n\t\t\t};\n\t\t}\n\n\t\t// Handle ALB event\n\t\tif (isAlbEvent(event)) {\n\t\t\tconst headers = normalizeHeaders(event.headers || {});\n\t\t\tconst requestSize = headers['content-length']\n\t\t\t\t? parseInt(headers['content-length'], 10)\n\t\t\t\t: undefined;\n\t\t\treturn {\n\t\t\t\tid: nanoid(),\n\t\t\t\tmethod: event.httpMethod || 'UNKNOWN',\n\t\t\t\tpath: event.path || '/',\n\t\t\t\turl: event.path || '/',\n\t\t\t\theaders,\n\t\t\t\tquery: event.queryStringParameters || {},\n\t\t\t\tbody: parseBody(event.body, event.isBase64Encoded),\n\t\t\t\tip: event.headers?.['x-forwarded-for']?.split(',')[0],\n\t\t\t\tstartTime: Date.now(),\n\t\t\t\trequestSize,\n\t\t\t};\n\t\t}\n\n\t\t// Generic Lambda invocation (not HTTP)\n\t\treturn {\n\t\t\tid: nanoid(),\n\t\t\tmethod: 'INVOKE',\n\t\t\tpath: '/',\n\t\t\turl: '/',\n\t\t\theaders: {},\n\t\t\tquery: {},\n\t\t\tbody: event,\n\t\t\tstartTime: Date.now(),\n\t\t};\n\t}\n\n\t/**\n\t * Extract response context from Lambda response\n\t */\n\textractResponseContext(\n\t\tresponse: unknown,\n\t\tstartTime: number,\n\t): AdapterResponseContext {\n\t\tconst duration = Date.now() - startTime;\n\n\t\t// API Gateway response format\n\t\tif (isApiGatewayResponse(response)) {\n\t\t\tconst headers = normalizeHeaders(response.headers || {});\n\t\t\t// Prefer Content-Length header, fallback to body size\n\t\t\tconst responseSize = headers['content-length']\n\t\t\t\t? parseInt(headers['content-length'], 10)\n\t\t\t\t: typeof response.body === 'string'\n\t\t\t\t\t? Buffer.byteLength(response.body, 'utf8')\n\t\t\t\t\t: undefined;\n\t\t\treturn {\n\t\t\t\tstatus: response.statusCode || 200,\n\t\t\t\theaders,\n\t\t\t\tbody: response.body,\n\t\t\t\tduration,\n\t\t\t\tresponseSize,\n\t\t\t};\n\t\t}\n\n\t\t// Generic response\n\t\treturn {\n\t\t\tstatus: 200,\n\t\t\theaders: {},\n\t\t\tbody: response,\n\t\t\tduration,\n\t\t};\n\t}\n\n\t/**\n\t * Flush telemetry data before Lambda context freezes\n\t */\n\tasync flush(): Promise<void> {\n\t\tawait flushTelemetry();\n\t}\n\n\t/**\n\t * Get resource attributes for the Lambda function\n\t */\n\tgetResourceAttributes(): LambdaResourceAttributes | null {\n\t\treturn this.resourceAttributes;\n\t}\n}\n\n/**\n * Wrap a Lambda handler to automatically record requests and flush telemetry.\n *\n * @example\n * ```typescript\n * import { wrapLambdaHandler } from '@geekmidas/telescope/adapters/lambda';\n *\n * const telescope = new Telescope({ storage: new InMemoryStorage() });\n *\n * export const handler = wrapLambdaHandler(telescope, async (event, context) => {\n *   // Your Lambda logic here\n *   return { statusCode: 200, body: JSON.stringify({ success: true }) };\n * });\n * ```\n */\nexport function wrapLambdaHandler<TEvent, TResult>(\n\ttelescope: Telescope,\n\thandler: (event: TEvent, context: LambdaContext) => Promise<TResult>,\n\toptions: Partial<LambdaAdapterConfig> = {},\n): (event: TEvent, context: LambdaContext) => Promise<TResult> {\n\tconst adapter = new LambdaAdapter(telescope, options);\n\n\treturn async (event: TEvent, context: LambdaContext): Promise<TResult> => {\n\t\tconst requestContext = adapter.extractRequestContext(event);\n\n\t\ttry {\n\t\t\tconst result = await handler(event, context);\n\n\t\t\t// Record the request\n\t\t\tconst responseContext = adapter.extractResponseContext(\n\t\t\t\tresult,\n\t\t\t\trequestContext.startTime,\n\t\t\t);\n\n\t\t\tawait telescope.recordRequest({\n\t\t\t\tmethod: requestContext.method,\n\t\t\t\tpath: requestContext.path,\n\t\t\t\turl: requestContext.url,\n\t\t\t\theaders: requestContext.headers,\n\t\t\t\tquery: requestContext.query,\n\t\t\t\tbody: requestContext.body,\n\t\t\t\tip: requestContext.ip,\n\t\t\t\tstatus: responseContext.status,\n\t\t\t\tresponseHeaders: responseContext.headers,\n\t\t\t\tresponseBody: responseContext.body,\n\t\t\t\tduration: responseContext.duration,\n\t\t\t\trequestSize: requestContext.requestSize,\n\t\t\t\tresponseSize: responseContext.responseSize,\n\t\t\t});\n\n\t\t\treturn result;\n\t\t} catch (error) {\n\t\t\t// Record the exception\n\t\t\tif (error instanceof Error) {\n\t\t\t\tawait telescope.exception(error, requestContext.id);\n\t\t\t}\n\t\t\tthrow error;\n\t\t} finally {\n\t\t\t// Always flush before Lambda freezes\n\t\t\tif (options.autoFlush !== false) {\n\t\t\t\tawait adapter.flush();\n\t\t\t}\n\t\t}\n\t};\n}\n\n// ============================================\n// Type Guards and Helpers\n// ============================================\n\ninterface ApiGatewayV1Event {\n\thttpMethod?: string;\n\tpath?: string;\n\theaders?: Record<string, string | undefined>;\n\tqueryStringParameters?: Record<string, string>;\n\tbody?: string | null;\n\tisBase64Encoded?: boolean;\n\trequestContext?: {\n\t\trequestId?: string;\n\t\tidentity?: {\n\t\t\tsourceIp?: string;\n\t\t};\n\t};\n}\n\ninterface ApiGatewayV2Event {\n\trawPath?: string;\n\theaders?: Record<string, string | undefined>;\n\tqueryStringParameters?: Record<string, string>;\n\tbody?: string | null;\n\tisBase64Encoded?: boolean;\n\trequestContext?: {\n\t\trequestId?: string;\n\t\thttp?: {\n\t\t\tmethod?: string;\n\t\t\tsourceIp?: string;\n\t\t};\n\t};\n}\n\ninterface AlbEvent {\n\thttpMethod?: string;\n\tpath?: string;\n\theaders?: Record<string, string | undefined>;\n\tqueryStringParameters?: Record<string, string>;\n\tbody?: string | null;\n\tisBase64Encoded?: boolean;\n}\n\ninterface ApiGatewayResponse {\n\tstatusCode?: number;\n\theaders?: Record<string, string | undefined>;\n\tbody?: unknown;\n}\n\nfunction isApiGatewayV1Event(event: unknown): event is ApiGatewayV1Event {\n\treturn (\n\t\ttypeof event === 'object' &&\n\t\tevent !== null &&\n\t\t'httpMethod' in event &&\n\t\t'path' in event\n\t);\n}\n\nfunction isApiGatewayV2Event(event: unknown): event is ApiGatewayV2Event {\n\treturn (\n\t\ttypeof event === 'object' &&\n\t\tevent !== null &&\n\t\t'rawPath' in event &&\n\t\t'requestContext' in event &&\n\t\ttypeof (event as ApiGatewayV2Event).requestContext === 'object' &&\n\t\t'http' in ((event as ApiGatewayV2Event).requestContext || {})\n\t);\n}\n\nfunction isAlbEvent(event: unknown): event is AlbEvent {\n\treturn (\n\t\ttypeof event === 'object' &&\n\t\tevent !== null &&\n\t\t'httpMethod' in event &&\n\t\t!('requestContext' in event)\n\t);\n}\n\nfunction isApiGatewayResponse(\n\tresponse: unknown,\n): response is ApiGatewayResponse {\n\treturn (\n\t\ttypeof response === 'object' &&\n\t\tresponse !== null &&\n\t\t'statusCode' in response\n\t);\n}\n\nfunction normalizeHeaders(\n\theaders: Record<string, string | undefined>,\n): Record<string, string> {\n\tconst normalized: Record<string, string> = {};\n\tfor (const [key, value] of Object.entries(headers)) {\n\t\tif (value !== undefined) {\n\t\t\tnormalized[key.toLowerCase()] = value;\n\t\t}\n\t}\n\treturn normalized;\n}\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\n\t\t// Try to parse as JSON\n\t\treturn JSON.parse(decoded);\n\t} catch {\n\t\t// Return raw string if not JSON\n\t\treturn body;\n\t}\n}\n"],"mappings":"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"}

package/dist/adapters/middy.cjs

@@ -1,5 +1,237 @@
-require('../core-CtVHRJGv.cjs');
-const require_middy = require('../middy-DlWnZilH.cjs');
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_instrumentation_core = require("../instrumentation/core.cjs");
+//#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 require_instrumentation_core.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 require_instrumentation_core.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
+exports.createTelescopeHandler = createTelescopeHandler;
+exports.telescopeMiddleware = telescopeMiddleware;
 
-exports.createTelescopeHandler = require_middy.createTelescopeHandler;
-exports.telescopeMiddleware = require_middy.telescopeMiddleware;
+//# sourceMappingURL=middy.cjs.map

package/dist/adapters/middy.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"middy.cjs","names":["flushTelemetry"],"sources":["../../src/adapters/middy.ts"],"sourcesContent":["import type { MiddlewareObj } from '@middy/core';\nimport type {\n\tAPIGatewayProxyEvent,\n\tAPIGatewayProxyEventV2,\n\tContext,\n} from 'aws-lambda';\nimport { flushTelemetry } from '../instrumentation/core';\nimport type { Telescope } from '../Telescope';\n\n/**\n * Options for the Telescope Middy middleware\n */\nexport interface TelescopeMiddlewareOptions {\n\t/**\n\t * Minimum remaining time (ms) before forcing a flush.\n\t * If remaining time drops below this, flush immediately.\n\t * @default 1000 (1 second)\n\t */\n\tflushThresholdMs?: number;\n\n\t/**\n\t * Whether to record request/response bodies\n\t * @default true\n\t */\n\trecordBody?: boolean;\n\n\t/**\n\t * Timeout for flush operation in ms\n\t * @default 5000\n\t */\n\tflushTimeoutMs?: number;\n}\n\n// Track if we've registered the process hooks\nlet processHooksRegistered = false;\n\n/**\n * Register process-level hooks for telemetry flush.\n * Called once per Lambda cold start.\n */\nfunction registerProcessHooks(): void {\n\tif (processHooksRegistered) return;\n\tprocessHooksRegistered = true;\n\n\t// Flush on SIGTERM (Lambda shutdown)\n\tprocess.on('SIGTERM', async () => {\n\t\tawait flushTelemetry(5000).catch(() => {});\n\t});\n\n\t// Note: beforeExit doesn't work reliably in Lambda\n\t// because Lambda freezes rather than exits\n}\n\n/**\n * Extract request data from API Gateway event (v1 or v2)\n */\nfunction extractRequestData(\n\tevent: APIGatewayProxyEvent | APIGatewayProxyEventV2,\n): {\n\tmethod: string;\n\tpath: string;\n\turl: string;\n\theaders: Record<string, string>;\n\tquery: Record<string, string>;\n\tbody: unknown;\n\tip?: string;\n\trequestId?: string;\n\trequestSize?: number;\n} {\n\tconst headers: Record<string, string> = {};\n\tif (event.headers) {\n\t\tfor (const [key, value] of Object.entries(event.headers)) {\n\t\t\tif (value) headers[key.toLowerCase()] = value;\n\t\t}\n\t}\n\n\t// Get request size from Content-Length header\n\tconst contentLength = headers['content-length'];\n\tconst requestSize = contentLength ? parseInt(contentLength, 10) : undefined;\n\n\t// API Gateway v2 (HTTP API)\n\tif ('rawPath' in event && event.requestContext?.http) {\n\t\tconst v2Event = event as APIGatewayProxyEventV2;\n\t\t// Filter out undefined values from query parameters\n\t\tconst query: Record<string, string> = {};\n\t\tif (v2Event.queryStringParameters) {\n\t\t\tfor (const [key, value] of Object.entries(\n\t\t\t\tv2Event.queryStringParameters,\n\t\t\t)) {\n\t\t\t\tif (value !== undefined) {\n\t\t\t\t\tquery[key] = value;\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\t\treturn {\n\t\t\tmethod: v2Event.requestContext.http.method,\n\t\t\tpath: v2Event.rawPath,\n\t\t\turl:\n\t\t\t\tv2Event.rawPath +\n\t\t\t\t(v2Event.rawQueryString ? `?${v2Event.rawQueryString}` : ''),\n\t\t\theaders,\n\t\t\tquery,\n\t\t\tbody: parseBody(v2Event.body, v2Event.isBase64Encoded),\n\t\t\tip: v2Event.requestContext.http.sourceIp,\n\t\t\trequestId: v2Event.requestContext.requestId,\n\t\t\trequestSize,\n\t\t};\n\t}\n\n\t// API Gateway v1 (REST API)\n\tconst v1Event = event as APIGatewayProxyEvent;\n\tconst queryString = v1Event.queryStringParameters\n\t\t? new URLSearchParams(\n\t\t\t\tv1Event.queryStringParameters as Record<string, string>,\n\t\t\t).toString()\n\t\t: '';\n\n\treturn {\n\t\tmethod: v1Event.httpMethod,\n\t\tpath: v1Event.path,\n\t\turl: v1Event.path + (queryString ? `?${queryString}` : ''),\n\t\theaders,\n\t\tquery: (v1Event.queryStringParameters as Record<string, string>) || {},\n\t\tbody: parseBody(v1Event.body, v1Event.isBase64Encoded),\n\t\tip: v1Event.requestContext?.identity?.sourceIp,\n\t\trequestId: v1Event.requestContext?.requestId,\n\t\trequestSize,\n\t};\n}\n\n/**\n * Parse request body\n */\nfunction parseBody(\n\tbody: string | null | undefined,\n\tisBase64Encoded?: boolean,\n): unknown {\n\tif (!body) return undefined;\n\n\ttry {\n\t\tconst decoded = isBase64Encoded\n\t\t\t? Buffer.from(body, 'base64').toString('utf-8')\n\t\t\t: body;\n\t\treturn JSON.parse(decoded);\n\t} catch {\n\t\treturn body;\n\t}\n}\n\n/**\n * Extract response data from Lambda response\n */\nfunction extractResponseData(response: unknown): {\n\tstatus: number;\n\theaders: Record<string, string>;\n\tbody: unknown;\n\tresponseSize?: number;\n} {\n\tif (response && typeof response === 'object' && 'statusCode' in response) {\n\t\tconst res = response as {\n\t\t\tstatusCode?: number;\n\t\t\theaders?: Record<string, string>;\n\t\t\tbody?: string;\n\t\t};\n\t\tconst headers = res.headers || {};\n\t\t// Get response size from Content-Length header (case-insensitive)\n\t\tconst contentLengthKey = Object.keys(headers).find(\n\t\t\t(k) => k.toLowerCase() === 'content-length',\n\t\t);\n\t\tconst contentLengthValue = contentLengthKey\n\t\t\t? headers[contentLengthKey]\n\t\t\t: undefined;\n\t\t// Prefer Content-Length header, fallback to body size\n\t\tconst responseSize = contentLengthValue\n\t\t\t? parseInt(contentLengthValue, 10)\n\t\t\t: res.body\n\t\t\t\t? Buffer.byteLength(res.body, 'utf8')\n\t\t\t\t: undefined;\n\t\treturn {\n\t\t\tstatus: res.statusCode || 200,\n\t\t\theaders,\n\t\t\tbody: res.body ? tryParseJson(res.body) : undefined,\n\t\t\tresponseSize,\n\t\t};\n\t}\n\n\treturn { status: 200, headers: {}, body: response };\n}\n\nfunction tryParseJson(str: string): unknown {\n\ttry {\n\t\treturn JSON.parse(str);\n\t} catch {\n\t\treturn str;\n\t}\n}\n\n/**\n * Middy middleware that integrates Telescope with Lambda handlers.\n *\n * Features:\n * - Records all requests and responses to Telescope\n * - Captures exceptions automatically\n * - Flushes telemetry before Lambda freezes\n * - Uses Lambda context for smart flush timing\n *\n * @example\n * ```typescript\n * import middy from '@middy/core';\n * import { telescopeMiddleware } from '@geekmidas/telescope/lambda';\n *\n * const handler = middy(baseHandler)\n *   .use(telescopeMiddleware(telescope));\n * ```\n */\nexport function telescopeMiddleware(\n\ttelescope: Telescope,\n\toptions: TelescopeMiddlewareOptions = {},\n): MiddlewareObj<\n\tAPIGatewayProxyEvent | APIGatewayProxyEventV2,\n\tany,\n\tError,\n\tContext\n> {\n\tconst {\n\t\tflushThresholdMs = 1000,\n\t\trecordBody = true,\n\t\tflushTimeoutMs = 5000,\n\t} = options;\n\n\t// Register process hooks on first use\n\tregisterProcessHooks();\n\n\treturn {\n\t\tbefore: async (request) => {\n\t\t\t// Store start time for duration calculation\n\t\t\t(request as any).__telescopeStartTime = Date.now();\n\n\t\t\t// Don't wait for empty event loop - we'll flush manually\n\t\t\trequest.context.callbackWaitsForEmptyEventLoop = false;\n\t\t},\n\n\t\tafter: async (request) => {\n\t\t\tconst startTime = (request as any).__telescopeStartTime || Date.now();\n\t\t\tconst duration = Date.now() - startTime;\n\n\t\t\ttry {\n\t\t\t\tconst reqData = extractRequestData(request.event);\n\t\t\t\tconst resData = extractResponseData(request.response);\n\n\t\t\t\tawait telescope.recordRequest({\n\t\t\t\t\tmethod: reqData.method,\n\t\t\t\t\tpath: reqData.path,\n\t\t\t\t\turl: reqData.url,\n\t\t\t\t\theaders: reqData.headers,\n\t\t\t\t\tquery: reqData.query,\n\t\t\t\t\tbody: recordBody ? reqData.body : undefined,\n\t\t\t\t\tip: reqData.ip,\n\t\t\t\t\tstatus: resData.status,\n\t\t\t\t\tresponseHeaders: resData.headers,\n\t\t\t\t\tresponseBody: recordBody ? resData.body : undefined,\n\t\t\t\t\tduration,\n\t\t\t\t\trequestSize: reqData.requestSize,\n\t\t\t\t\tresponseSize: resData.responseSize,\n\t\t\t\t});\n\t\t\t} catch {\n\t\t\t\t// Don't let telescope errors break the response\n\t\t\t}\n\n\t\t\t// Smart flush: check remaining time\n\t\t\tawait smartFlush(request.context, flushThresholdMs, flushTimeoutMs);\n\t\t},\n\n\t\tonError: async (request) => {\n\t\t\tconst startTime = (request as any).__telescopeStartTime || Date.now();\n\t\t\tconst duration = Date.now() - startTime;\n\n\t\t\ttry {\n\t\t\t\t// Record the exception\n\t\t\t\tif (request.error) {\n\t\t\t\t\tawait telescope.exception(request.error);\n\t\t\t\t}\n\n\t\t\t\t// Also record the failed request\n\t\t\t\tconst reqData = extractRequestData(request.event);\n\t\t\t\tawait telescope.recordRequest({\n\t\t\t\t\tmethod: reqData.method,\n\t\t\t\t\tpath: reqData.path,\n\t\t\t\t\turl: reqData.url,\n\t\t\t\t\theaders: reqData.headers,\n\t\t\t\t\tquery: reqData.query,\n\t\t\t\t\tbody: recordBody ? reqData.body : undefined,\n\t\t\t\t\tip: reqData.ip,\n\t\t\t\t\tstatus: 500,\n\t\t\t\t\tresponseHeaders: {},\n\t\t\t\t\tresponseBody: { error: request.error?.message },\n\t\t\t\t\tduration,\n\t\t\t\t\trequestSize: reqData.requestSize,\n\t\t\t\t});\n\t\t\t} catch {\n\t\t\t\t// Don't let telescope errors mask the original error\n\t\t\t}\n\n\t\t\t// Always flush on error\n\t\t\tawait smartFlush(request.context, flushThresholdMs, flushTimeoutMs);\n\t\t},\n\t};\n}\n\n/**\n * Smart flush that respects Lambda's remaining execution time\n */\nasync function smartFlush(\n\tcontext: Context,\n\tthresholdMs: number,\n\ttimeoutMs: number,\n): Promise<void> {\n\tconst remaining = context.getRemainingTimeInMillis();\n\n\t// If we have plenty of time, use normal timeout\n\t// If time is running low, use a shorter timeout\n\tconst effectiveTimeout = Math.min(\n\t\ttimeoutMs,\n\t\tMath.max(remaining - thresholdMs, 100), // Leave at least threshold ms for response\n\t);\n\n\tif (effectiveTimeout > 0) {\n\t\tawait flushTelemetry(effectiveTimeout).catch(() => {});\n\t}\n}\n\n/**\n * Create a wrapped Lambda handler with Telescope integration.\n * Alternative to using Middy middleware directly.\n *\n * @example\n * ```typescript\n * import { createTelescopeHandler } from '@geekmidas/telescope/lambda';\n *\n * export const handler = createTelescopeHandler(telescope, async (event, context) => {\n *   return { statusCode: 200, body: 'OK' };\n * });\n * ```\n */\nexport function createTelescopeHandler<TEvent, TResult>(\n\ttelescope: Telescope,\n\thandler: (event: TEvent, context: Context) => Promise<TResult>,\n\toptions: TelescopeMiddlewareOptions = {},\n): (event: TEvent, context: Context) => Promise<TResult> {\n\tconst {\n\t\tflushThresholdMs = 1000,\n\t\trecordBody = true,\n\t\tflushTimeoutMs = 5000,\n\t} = options;\n\n\tregisterProcessHooks();\n\n\treturn async (event: TEvent, context: Context): Promise<TResult> => {\n\t\tconst startTime = Date.now();\n\t\tcontext.callbackWaitsForEmptyEventLoop = false;\n\n\t\ttry {\n\t\t\tconst result = await handler(event, context);\n\t\t\tconst duration = Date.now() - startTime;\n\n\t\t\t// Record successful request\n\t\t\ttry {\n\t\t\t\tconst reqData = extractRequestData(event as any);\n\t\t\t\tconst resData = extractResponseData(result);\n\n\t\t\t\tawait telescope.recordRequest({\n\t\t\t\t\tmethod: reqData.method,\n\t\t\t\t\tpath: reqData.path,\n\t\t\t\t\turl: reqData.url,\n\t\t\t\t\theaders: reqData.headers,\n\t\t\t\t\tquery: reqData.query,\n\t\t\t\t\tbody: recordBody ? reqData.body : undefined,\n\t\t\t\t\tip: reqData.ip,\n\t\t\t\t\tstatus: resData.status,\n\t\t\t\t\tresponseHeaders: resData.headers,\n\t\t\t\t\tresponseBody: recordBody ? resData.body : undefined,\n\t\t\t\t\tduration,\n\t\t\t\t\trequestSize: reqData.requestSize,\n\t\t\t\t\tresponseSize: resData.responseSize,\n\t\t\t\t});\n\t\t\t} catch {\n\t\t\t\t// Ignore telescope errors\n\t\t\t}\n\n\t\t\tawait smartFlush(context, flushThresholdMs, flushTimeoutMs);\n\t\t\treturn result;\n\t\t} catch (error) {\n\t\t\t// Record exception\n\t\t\tif (error instanceof Error) {\n\t\t\t\tawait telescope.exception(error).catch(() => {});\n\t\t\t}\n\n\t\t\tawait smartFlush(context, flushThresholdMs, flushTimeoutMs);\n\t\t\tthrow error;\n\t\t}\n\t};\n}\n"],"mappings":";;;AAkCA,IAAI,yBAAyB;;;;;AAM7B,SAAS,uBAA6B;CACrC,IAAI,wBAAwB;CAC5B,yBAAyB;CAGzB,QAAQ,GAAG,WAAW,YAAY;EACjC,MAAMA,6BAAAA,eAAe,GAAI,CAAC,CAAC,YAAY,CAAC,CAAC;CAC1C,CAAC;AAIF;;;;AAKA,SAAS,mBACR,OAWC;CACD,MAAM,UAAkC,CAAC;CACzC,IAAI,MAAM,SACJ;OAAA,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,MAAM,OAAO,GACtD,IAAI,OAAO,QAAQ,IAAI,YAAY,KAAK;CAAA;CAK1C,MAAM,gBAAgB,QAAQ;CAC9B,MAAM,cAAc,gBAAgB,SAAS,eAAe,EAAE,IAAI,KAAA;CAGlE,IAAI,aAAa,SAAS,MAAM,gBAAgB,MAAM;EACrD,MAAM,UAAU;EAEhB,MAAM,QAAgC,CAAC;EACvC,IAAI,QAAQ,uBACN;QAAA,MAAM,CAAC,KAAK,UAAU,OAAO,QACjC,QAAQ,qBACT,GACC,IAAI,UAAU,KAAA,GACb,MAAM,OAAO;EAAA;EAIhB,OAAO;GACN,QAAQ,QAAQ,eAAe,KAAK;GACpC,MAAM,QAAQ;GACd,KACC,QAAQ,WACP,QAAQ,iBAAiB,IAAI,QAAQ,mBAAmB;GAC1D;GACA;GACA,MAAM,UAAU,QAAQ,MAAM,QAAQ,eAAe;GACrD,IAAI,QAAQ,eAAe,KAAK;GAChC,WAAW,QAAQ,eAAe;GAClC;EACD;CACD;CAGA,MAAM,UAAU;CAChB,MAAM,cAAc,QAAQ,wBACzB,IAAI,gBACJ,QAAQ,qBACT,CAAC,CAAC,SAAS,IACV;CAEH,OAAO;EACN,QAAQ,QAAQ;EAChB,MAAM,QAAQ;EACd,KAAK,QAAQ,QAAQ,cAAc,IAAI,gBAAgB;EACvD;EACA,OAAQ,QAAQ,yBAAoD,CAAC;EACrE,MAAM,UAAU,QAAQ,MAAM,QAAQ,eAAe;EACrD,IAAI,QAAQ,gBAAgB,UAAU;EACtC,WAAW,QAAQ,gBAAgB;EACnC;CACD;AACD;;;;AAKA,SAAS,UACR,MACA,iBACU;CACV,IAAI,CAAC,MAAM,OAAO,KAAA;CAElB,IAAI;EACH,MAAM,UAAU,kBACb,OAAO,KAAK,MAAM,QAAQ,CAAC,CAAC,SAAS,OAAO,IAC5C;EACH,OAAO,KAAK,MAAM,OAAO;CAC1B,QAAQ;EACP,OAAO;CACR;AACD;;;;AAKA,SAAS,oBAAoB,UAK3B;CACD,IAAI,YAAY,OAAO,aAAa,YAAY,gBAAgB,UAAU;EACzE,MAAM,MAAM;EAKZ,MAAM,UAAU,IAAI,WAAW,CAAC;EAEhC,MAAM,mBAAmB,OAAO,KAAK,OAAO,CAAC,CAAC,MAC5C,MAAM,EAAE,YAAY,MAAM,gBAC5B;EACA,MAAM,qBAAqB,mBACxB,QAAQ,oBACR,KAAA;EAEH,MAAM,eAAe,qBAClB,SAAS,oBAAoB,EAAE,IAC/B,IAAI,OACH,OAAO,WAAW,IAAI,MAAM,MAAM,IAClC,KAAA;EACJ,OAAO;GACN,QAAQ,IAAI,cAAc;GAC1B;GACA,MAAM,IAAI,OAAO,aAAa,IAAI,IAAI,IAAI,KAAA;GAC1C;EACD;CACD;CAEA,OAAO;EAAE,QAAQ;EAAK,SAAS,CAAC;EAAG,MAAM;CAAS;AACnD;AAEA,SAAS,aAAa,KAAsB;CAC3C,IAAI;EACH,OAAO,KAAK,MAAM,GAAG;CACtB,QAAQ;EACP,OAAO;CACR;AACD;;;;;;;;;;;;;;;;;;;AAoBA,SAAgB,oBACf,WACA,UAAsC,CAAC,GAMtC;CACD,MAAM,EACL,mBAAmB,KACnB,aAAa,MACb,iBAAiB,QACd;CAGJ,qBAAqB;CAErB,OAAO;EACN,QAAQ,OAAO,YAAY;GAE1B,QAAiB,uBAAuB,KAAK,IAAI;GAGjD,QAAQ,QAAQ,iCAAiC;EAClD;EAEA,OAAO,OAAO,YAAY;GACzB,MAAM,YAAa,QAAgB,wBAAwB,KAAK,IAAI;GACpE,MAAM,WAAW,KAAK,IAAI,IAAI;GAE9B,IAAI;IACH,MAAM,UAAU,mBAAmB,QAAQ,KAAK;IAChD,MAAM,UAAU,oBAAoB,QAAQ,QAAQ;IAEpD,MAAM,UAAU,cAAc;KAC7B,QAAQ,QAAQ;KAChB,MAAM,QAAQ;KACd,KAAK,QAAQ;KACb,SAAS,QAAQ;KACjB,OAAO,QAAQ;KACf,MAAM,aAAa,QAAQ,OAAO,KAAA;KAClC,IAAI,QAAQ;KACZ,QAAQ,QAAQ;KAChB,iBAAiB,QAAQ;KACzB,cAAc,aAAa,QAAQ,OAAO,KAAA;KAC1C;KACA,aAAa,QAAQ;KACrB,cAAc,QAAQ;IACvB,CAAC;GACF,QAAQ,CAER;GAGA,MAAM,WAAW,QAAQ,SAAS,kBAAkB,cAAc;EACnE;EAEA,SAAS,OAAO,YAAY;GAC3B,MAAM,YAAa,QAAgB,wBAAwB,KAAK,IAAI;GACpE,MAAM,WAAW,KAAK,IAAI,IAAI;GAE9B,IAAI;IAEH,IAAI,QAAQ,OACX,MAAM,UAAU,UAAU,QAAQ,KAAK;IAIxC,MAAM,UAAU,mBAAmB,QAAQ,KAAK;IAChD,MAAM,UAAU,cAAc;KAC7B,QAAQ,QAAQ;KAChB,MAAM,QAAQ;KACd,KAAK,QAAQ;KACb,SAAS,QAAQ;KACjB,OAAO,QAAQ;KACf,MAAM,aAAa,QAAQ,OAAO,KAAA;KAClC,IAAI,QAAQ;KACZ,QAAQ;KACR,iBAAiB,CAAC;KAClB,cAAc,EAAE,OAAO,QAAQ,OAAO,QAAQ;KAC9C;KACA,aAAa,QAAQ;IACtB,CAAC;GACF,QAAQ,CAER;GAGA,MAAM,WAAW,QAAQ,SAAS,kBAAkB,cAAc;EACnE;CACD;AACD;;;;AAKA,eAAe,WACd,SACA,aACA,WACgB;CAChB,MAAM,YAAY,QAAQ,yBAAyB;CAInD,MAAM,mBAAmB,KAAK,IAC7B,WACA,KAAK,IAAI,YAAY,aAAa,GAAG,CACtC;CAEA,IAAI,mBAAmB,GACtB,MAAMA,6BAAAA,eAAe,gBAAgB,CAAC,CAAC,YAAY,CAAC,CAAC;AAEvD;;;;;;;;;;;;;;AAeA,SAAgB,uBACf,WACA,SACA,UAAsC,CAAC,GACiB;CACxD,MAAM,EACL,mBAAmB,KACnB,aAAa,MACb,iBAAiB,QACd;CAEJ,qBAAqB;CAErB,OAAO,OAAO,OAAe,YAAuC;EACnE,MAAM,YAAY,KAAK,IAAI;EAC3B,QAAQ,iCAAiC;EAEzC,IAAI;GACH,MAAM,SAAS,MAAM,QAAQ,OAAO,OAAO;GAC3C,MAAM,WAAW,KAAK,IAAI,IAAI;GAG9B,IAAI;IACH,MAAM,UAAU,mBAAmB,KAAY;IAC/C,MAAM,UAAU,oBAAoB,MAAM;IAE1C,MAAM,UAAU,cAAc;KAC7B,QAAQ,QAAQ;KAChB,MAAM,QAAQ;KACd,KAAK,QAAQ;KACb,SAAS,QAAQ;KACjB,OAAO,QAAQ;KACf,MAAM,aAAa,QAAQ,OAAO,KAAA;KAClC,IAAI,QAAQ;KACZ,QAAQ,QAAQ;KAChB,iBAAiB,QAAQ;KACzB,cAAc,aAAa,QAAQ,OAAO,KAAA;KAC1C;KACA,aAAa,QAAQ;KACrB,cAAc,QAAQ;IACvB,CAAC;GACF,QAAQ,CAER;GAEA,MAAM,WAAW,SAAS,kBAAkB,cAAc;GAC1D,OAAO;EACR,SAAS,OAAO;GAEf,IAAI,iBAAiB,OACpB,MAAM,UAAU,UAAU,KAAK,CAAC,CAAC,YAAY,CAAC,CAAC;GAGhD,MAAM,WAAW,SAAS,kBAAkB,cAAc;GAC1D,MAAM;EACP;CACD;AACD"}

package/dist/adapters/middy.d.cts

@@ -1,5 +1,60 @@
-import "../types-l7Rlb5Mg.cjs";
-import "../MetricsAggregator-4SqelGcG.cjs";
-import "../Telescope-D4nmwDRA.cjs";
-import { TelescopeMiddlewareOptions, createTelescopeHandler, telescopeMiddleware } from "../middy-Bq0defVg.cjs";
-export { TelescopeMiddlewareOptions, createTelescopeHandler, telescopeMiddleware };
+import { t as Telescope } from "../Telescope-DnCMZT7V.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
+ */
+export 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));
+ * ```
+ */
+export 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' };
+ * });
+ * ```
+ */
+export declare function createTelescopeHandler<TEvent, TResult>(telescope: Telescope, handler: (event: TEvent, context: Context) => Promise<TResult>, options?: TelescopeMiddlewareOptions): (event: TEvent, context: Context) => Promise<TResult>;
+//#endregion
+//# sourceMappingURL=middy.d.cts.map

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

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

package/dist/adapters/middy.d.mts

@@ -1,5 +1,60 @@
-import "../types-B1EIa_cQ.mjs";
-import "../MetricsAggregator-DZrW8ls6.mjs";
-import "../Telescope-Dl6VSfxd.mjs";
-import { TelescopeMiddlewareOptions, createTelescopeHandler, telescopeMiddleware } from "../middy-B6Btl8XE.mjs";
-export { TelescopeMiddlewareOptions, createTelescopeHandler, telescopeMiddleware };
+import { t as Telescope } from "../Telescope-BcrWTaar.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
+ */
+export 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));
+ * ```
+ */
+export 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' };
+ * });
+ * ```
+ */
+export declare function createTelescopeHandler<TEvent, TResult>(telescope: Telescope, handler: (event: TEvent, context: Context) => Promise<TResult>, options?: TelescopeMiddlewareOptions): (event: TEvent, context: Context) => Promise<TResult>;
+//#endregion
+//# sourceMappingURL=middy.d.mts.map

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

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